软件库维护规范

软件库是主动维护的目录。新增软件时，可以直接在 notes/software/ 下创建软件条目；也可以先写 notes/apps/ 下的应用笔记，再由整理流程检查关联关系。应用笔记对应的软件页不存在时，只列入待确认，不自动创建。

新增软件

推荐路径：

notes/software/<software_id>.md

示例：

---
title: Claude Code
publish: false
section: software
software_id: claude-code
status: used
category: ai-coding
platforms: [windows, macos, linux]
pricing: paid
open_source: false
official_url: https://www.anthropic.com/claude-code
download_url: https://docs.anthropic.com/en/docs/claude-code/setup
summary: 面向终端和代码库的 AI 编程助手。
related:
  wiki: [wiki/entities/claude-code.md]
  articles: []
  app_notes:
    - notes/apps/claude-code-常用命令.md
sources:
  - https://www.anthropic.com/claude-code
  - https://docs.anthropic.com/en/docs/claude-code/setup
created: 2026-07-08
updated: 2026-07-08
---

关联文章和应用笔记

关联分两层：

软件页 frontmatter 的 related 字段用于结构化关联。
正文里继续用 Obsidian 双链。跨栏目内容建议写发布路径，例如 [[wiki/entities/claude-code|Claude Code]]。如果只是示例路径，不要写成 wikilink，避免发布检查误判为断链。

文章放在 raw/，必须标记：

publish: false
section: article

应用笔记统一放在 notes/apps/，默认命名为：

notes/apps/<software_id>-<主题>.md

必须标记：

publish: false
section: app-note
related_software: <software_id>

整理流程会优先使用 related_software 关联到对应软件页；如果没有该字段，会尝试按文件名 <software_id>-<主题>.md 推断。

如果 notes/software/<software_id>.md 已存在，整理流程会把应用笔记路径追加到该软件页的 related.app_notes，保留已有条目并去重。一个软件可以对应多篇应用笔记，例如：

related:
  app_notes:
    - notes/apps/claude-code-常用命令.md
    - notes/apps/claude-code-权限配置.md
    - notes/apps/claude-code-工作流.md

如果软件页不存在，整理流程只在日报或全库报告中提示“存在应用笔记但缺少软件条目”。只有用户明确要求创建软件条目时，才使用模板并查询官方来源补齐事实。

同步脚本只负责把已有软件页和应用笔记发布并展示关联；无法关联的软件应用笔记会进入同步报告，需要补字段或改文件名。

推荐从模板创建：

templates/app-note-template.md

近期重要文件

Claude Code - 面向终端和代码库的 AI 编程助手。
Bandizip - Bandisoft 出品的压缩/解压工具，支持 40+ 格式，简洁高效。
Bandizip 快速上手 - 记录 Bandizip 的选择原因、常用设置和高频功能。

公开知识库

软件库维护规范

软件库维护规范

新增软件

关联文章和应用笔记

推荐关系

近期重要文件