Vault Layout

中文 | English

这个 skill 的默认知识库结构：

<vault-root>/
├── .git/
├── AGENTS.md
├── raw/
├── wiki/
│   ├── answers/
│   ├── concepts/
│   ├── entities/
│   ├── sources/
│   └── topics/
├── index.md
└── log.md

全局 skill 默认配置放在知识库之外：

~/.llm-wiki/
└── config.json

建议的全局配置形状：

{
  "root": "/absolute/path/to/your/wiki-vault",
  "raw_dir": "raw",
  "wiki_dir": "wiki",
  "index_file": "index.md",
  "log_file": "log.md",
  "schema_file": "AGENTS.md"
}

各层含义：

• git 仓库：知识库的版本化历史
• raw sources：即使路径被重组、内容实质仍保持稳定的 source-of-truth 材料
• wiki pages：由 LLM 维护的摘要、实体、概念与综合页面
• index：进入 wiki 的稳定入口
• log：按时间倒序记录的运维历史
• AGENTS.md：知识库专属的维护规则

建议的 source 到页面映射：

• 一个 raw source 文件
• 一个对应的 wiki/sources/*.md 页面
• 对 concept、entity 和 topic 页的零个或多个更新

可选的 raw 媒体约定：

• raw/screenshots/ 用于独立截图来源
• raw/assets/ 用于 markdown raw source 所引用的本地图像附件

建议分类：

• concepts/ 用于可复用想法或框架
• entities/ 用于人物、组织、工具、产品、项目
• topics/ 用于聚合多个概念的更宽主题域
• sources/ 用于逐来源笔记与引文
• answers/ 用于 query 过程中产出的耐久答案