obsidian-ai-second-brain

# Personal LLM Wiki

AI 知识管理员的工作手册。把这个文件放在你的 Obsidian vault 根目录。

## 目录职责

- **raw/** — 原始素材，**不可变**。AI 只读，永不修改。按主题分子目录，允许多级嵌套。PDF/视频/xlsx/图片保持原文件名。
- **wiki/** — AI 维护的消化笔记。允许多级子目录。每篇文章 md 格式，命名自由（描述性即可）。
- **assets/** — 配图资源。

## 两个特殊文件（必须维护）

- **wiki/index.md** — 全局索引。每篇 wiki 文章一行，按主题分组，带链接 + 一句话摘要 + Updated 日期。
- **wiki/log.md** — Append-only 操作日志，记录每次 ingest / query archive / lint。

## 三个触发行为

### 触发 1：Ingest（录入素材）

**触发词：** "加到 wiki"、"ingest 这个"、"把这个收进来"、给 AI 一份新素材并暗示要保存。

**动作：**
1. 把素材存进 `raw/<最合适的主题>/`。主题不存在就新建。文件名保持原样（PDF/视频/图片）或起描述性名（md 笔记）。
2. 编译成 `wiki/<对应主题>/<文章>.md`：
   - 和现有文章是**同一核心论点** → 合并进去，更新 Sources 和受影响的小节
   - **全新概念** → 新建文章，按概念命名，不按 raw 文件名
   - **跨多个主题** → 落在最相关的主题下，在文章末尾加"See Also"交叉引用
3. 检查事实冲突：新素材和已有内容矛盾时，在文章里标注分歧和来源归属。
4. **级联更新**：扫同主题下其他受影响文章，更新它们的 Updated 日期。
5. **更新 wiki/index.md**：给每篇改动过的文章补/改条目。
6. **追加 wiki/log.md**：
   ```
   ## [YYYY-MM-DD] ingest | <主文章标题>
   - Updated: <级联更新的文章标题>
   ```

### 触发 2：Query（查询）

**触发词：** "我知道啥关于 X"、"wiki 里有没有 Y"、"根据我的 wiki 总结一下 Z"、"对比 A 和 B"。

**动作：**
1. 先读 `wiki/index.md` 定位相关文章。
2. 读文章合成答案。优先引用 wiki 内容，其次才用 AI 自己的训练知识。
3. 引用时用 markdown 链接：`[文章标题](wiki/主题/文章.md)`。
4. **默认只在对话里答，不写文件**。

**例外——用户说"存下来"/"归档到 wiki"：**
1. 把答案作为新文章写进最相关的 `wiki/<主题>/`。
2. 不合并进已有文章（归档内容是合成答案，不是素材）。
3. 更新 index.md，摘要前缀加 `[Archived]`。
4. log.md 追加：
   ```
   ## [YYYY-MM-DD] query | Archived: <页面标题>
   ```

### 触发 3：Lint（体检）

**触发词：** "lint wiki"、"体检"、"wiki 有啥问题"。

**确定性检查（尽量自动修）：**
- `wiki/index.md` ↔ 实际文件一致性：文件存在但索引缺 → 补条目；索引指向死文件 → 标 `[MISSING]`
- wiki 内部 markdown 链接失效：同名文件在别处 → 改路径；找不到 → 报告
- See Also 链接：同主题明显缺的交叉引用 → 补；链接已删文件 → 删

**启发式检查（只报告，不自动改）：**
- 跨文章事实矛盾
- 新素材让旧论点过时
- 源头分歧没标注
- 孤岛页面（没人引用）
- 跨主题该链没链的概念
- 反复被提及但没独立页面的概念

**完成后追加 log.md：**
```
## [YYYY-MM-DD] lint | <N> issues found, <M> auto-fixed
```

## 约定

- 所有 wiki 内部链接用**相对当前文件的路径**。
- 对话里引用 wiki 文章用**相对 vault 根的路径**（例如 `wiki/主题/xxx.md`）。
- 日期用今天的日期。Updated 反映文章内容最后变动的时间，不是文件系统时间戳。
- **raw 绝对不能改**。如果发现 raw 里有错，在 wiki 文章里标注"source contains error"而不是改 raw。

## 放开的约束

- wiki 子目录**深度不限**。`wiki/一人企业/agent teams/xxx.md` 合法。
- md 文件**命名自由**，不强制 `YYYY-MM-DD-slug.md` 格式。
- 不强制 Sources/Raw/Updated metadata 头。想加就加，不加也行。
- raw 里的文件（PDF/视频/xlsx/图片）**永不改名**。