second-brain-ingest

Second Brain — 摄入

将原始来源文档处理为结构化且相互关联的 wiki 页面。

确定要处理的来源

确定哪些文件需要摄入：

1. 如果用户指定了一个或多个文件，则使用这些文件
2. 如果用户说“处理新来源”或类似内容，则检测尚未处理的文件：
   • 列出 raw/ 中的所有文件（不包括 raw/assets/）
   • 阅读 wiki/log.md，并从 ingest 条目中提取之前摄入的所有来源文件名
   • raw/ 中任何未列在日志里的文件都尚未处理
3. 如果没有找到尚未处理的文件，请告知用户

处理每个来源

对于每个来源文件，按照以下工作流操作：

1. 完整阅读来源

完整阅读文件。如果文件包含图像引用，请记下；如果图像包含重要信息，则单独阅读图像。

2. 与用户讨论要点

在撰写任何内容之前，分享来源中最重要的 3-5 个要点。询问用户是否希望强调某些方面或跳过某些主题。等待用户确认后再继续。

3. 创建来源摘要页

在 wiki/sources/ 中创建一个以来源名称（转换为 slug 格式）命名的新文件。包含：

---
tags: [相关标签]
sources: [原始文件名.md]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

# 来源标题

**来源：** 原始文件名.md
**摄入日期：** YYYY-MM-DD
**类型：** 文章 | 论文 | 转录稿 | 笔记 | 等

## 摘要

对来源内容进行结构化摘要。

## 主要主张

- 主张 1
- 主张 2
- ...

## 提及的实体

- [[实体名称]] — 简要说明背景
- ...

## 涵盖的概念

- [[概念名称]] — 简要说明背景
- ...

4. 更新实体和概念页面

对于来源中提到的每个实体（人物、组织、产品、工具）和概念（想法、框架、理论、模式）：

如果 wiki 页面已存在：

• 阅读现有页面
• 补充来自此来源的新信息
• 将此来源添加到 sources: frontmatter 列表中
• 更新 updated: 日期
• 记录与现有内容的矛盾，并引用两个来源

如果不存在 wiki 页面：

• 在适当的子目录中创建新页面：
  • 人物、组织、产品、工具放入 wiki/entities/
  • 想法、框架、理论、模式放入 wiki/concepts/
• 添加包含标签、来源、创建日期和更新日期字段的 YAML frontmatter
• 根据此来源对该主题的描述撰写精简摘要

5. 添加 wiki 链接

确保所有相关页面都使用 [[wikilink]] 语法相互链接。每次提及拥有独立页面的实体或概念时，都应添加链接。

6. 更新 wiki/index.md

对于每个新建页面，在相应的分类标题下添加一条目：

- [[页面名称]] — 一句话摘要（少于 120 个字符）

7. 更新 wiki/log.md

追加：

## [YYYY-MM-DD] ingest | 来源标题
已处理来源文件名.md。新建 N 个页面，更新 M 个现有页面。
新实体：[[实体1]]、[[实体2]]。新概念：[[概念1]]。

8. 汇报结果

告知用户完成的工作：

• 创建的页面（附链接）
• 更新的页面（说明变更内容）
• 发现的新实体和概念
• 发现的与现有内容之间的任何矛盾

约定

• 来源摘要页必须仅陈述事实。解读和综合分析应放在概念页和综合分析页中。
• 单个来源通常涉及 10-15 个 wiki 页面。这很正常，也符合预期。
• 当新信息与 wiki 中的现有内容矛盾时，更新 wiki 页面并记录矛盾，同时引用两个来源。
• 优先更新现有页面，而不是创建新页面。只有当主题足够独特、值得拥有独立页面时，才创建新页面。
• 所有内部引用均使用 [[wikilinks]]。绝不使用原始文件路径。

接下来

摄取来源后，用户可以：

• 使用 /second-brain-query 提问，探索已摄取的内容
• 摄取更多来源 — 再剪藏一篇文章并再次运行 /second-brain-ingest
• 每摄取 10 次后，使用 /second-brain-lint 检查健康状况，及时发现遗漏