# 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`，再按新约定继续维护。