Obsidian-Knowledge-Base/X-Knowledge-Base

X-Knowledge-Base

这是一个基于 Markdown 的个人 LLM Wiki 仓库。目标不是只保存资料，而是把原始资料、结构化知识和协作约定分层管理，让知识可以持续积累、修订和追踪版本历史。

目录分工

raw/

raw/ 存放原始资料，是事实来源层。

• 放文章、笔记、论文、网页剪藏、截图、附件等原始内容。
• 原始资料导入后不做内容改写，尽量保持不可变。
• raw/ 下的内容在当前仓库中作为正式资产全量版本化。
• raw/assets/ 用于图片、附件、截图等资源文件。

wiki/

wiki/ 存放经过 LLM 整理和维护后的知识页，是知识层。

• 页面以 Markdown 形式组织。
• 推荐使用 [[wikilink]] 建立实体、概念、工作流、来源摘要之间的双向链接。
• wiki/index.md 是全局索引入口。
• wiki/log.md 记录导入、查询、维护和结构调整。
• 这里的内容可以持续更新、整合、修订和补充。

CLAUDE.md

CLAUDE.md 是本仓库的人机协作约定，也是 LLM Wiki 的 schema 文件。

• 定义目录结构和页面命名规范。
• 定义导入、查询、维护三类工作流。
• 约束 LLM 在更新知识库时的行为边界。
• 当协作方式发生变化时，优先更新这里。

README.md 负责给人看，CLAUDE.md 负责给人和 LLM 一起执行。

协作规则

1. 新资料先进入 raw/，不要直接把未经整理的内容写进 wiki/。
2. 导入资料时，先读取原始资料，再在 wiki/ 中创建或更新摘要页、实体页、概念页和工作流页。
3. 每次导入后都要更新 wiki/index.md 和 wiki/log.md。
4. 新资料如果与已有知识冲突，必须显式标注，不要静默覆盖。
5. 查询回答如果形成稳定、可复用的结论，可以回写到 wiki/。
6. raw/ 是来源层，wiki/ 是综合层，二者不要混写。

推荐工作流

导入资料

1. 把原始文件放进 raw/。
2. 阅读并提炼核心观点、事实、案例和数据。
3. 在 wiki/ 新建 source-{关键词}.md 摘要页。
4. 补充或更新相关实体页、概念页、工作流页。
5. 更新 wiki/index.md。
6. 在 wiki/log.md 追加本次记录。

查询知识库

1. 先看 wiki/index.md 定位相关主题。
2. 再读具体页面和必要的原始资料。
3. 输出综合回答，并注明来源页面。
4. 若回答具有长期价值，则沉淀回 wiki/。

维护知识库

1. 检查孤立页面和缺失链接。
2. 检查过时内容和冲突内容。
3. 检查是否有被频繁提及但尚未单独建页的概念或实体。
4. 修复后更新 wiki/log.md。

版本管理建议

• raw/ 和 wiki/ 都纳入 Git 版本历史。
• 导入资料后及时提交，便于追踪知识演化。
• 推荐使用清晰的提交信息，例如：
  • ingest: add source on ...
  • wiki: refine concept pages
  • lint: repair broken links

使用方式

• 用 Obsidian 打开本目录作为 Vault。
• 从 wiki/index.md 进入知识库。
• 需要调整协作方式时，先修改 CLAUDE.md，再按新约定继续维护。