用途:将 raw/ 中的原始文档摄取为 wiki 页面,供个人知识库(Second Brain)使用。触发场景包括用户新增文件并要求“process this source”“ingest this article”,或要求处理新来源。
主要能力与流程:
- 识别待处理来源:用户指定文件时直接使用;用户说“process new sources”时,列出 raw/(排除 raw/assets/)中的所有文件,并从 wiki/log.md 的 ingest 记录中提取已处理文件名,未出现在日志中的即为未处理;没有未处理文件则告知用户。
- 逐个处理:完整读取源文件,若含图片引用且图片含重要信息则单独读取;在写入前先与用户讨论 3-5 条关键要点,询问是否强调某些方面或跳过某些主题,等待确认后再继续。
- 创建来源摘要页:在 wiki/sources/ 下以来源名创建文件,包含指定 YAML frontmatter(tags、sources、created、updated)以及摘要、关键主张、提及的实体、涉及的概念等小节。
- 更新实体与概念页:对来源中提到的实体(人物、组织、产品、工具)与概念(想法、框架、理论、模式),已有页面则补充新信息、把来源加入 sources、更新 updated 日期,并记录与既有内容的矛盾并引用两个来源;没有页面则在 wiki/entities/ 或 wiki/concepts/ 下新建,含 frontmatter 与聚焦摘要。
- 用 [[wikilink]] 语法为相关页面添加互链,实体或概念只要有独立页面就应链接。
- 更新 wiki/index.md,在新页面所属分类标题下添加条目。
- 更新 wiki/log.md,追加 ingest 记录,包含日期、来源标题、处理文件、新建/更新页面数量及新实体、新概念。
- 向用户报告:新建页面(含链接)、更新页面及变更、新识别的实体与概念、发现的矛盾。
约定:来源摘要页只记事实,解释与综合放到概念页与综合页;单个来源通常涉及 10-15 个 wiki 页面;新信息与既有内容矛盾时更新页面并引用双方;优先更新已有页面,仅在主题足够独立时新建;内部引用一律用 [[wikilink]],不用原始文件路径。
后续:用户可用 /second-brain-query 提问,继续用 /second-brain-ingest 摄取更多来源,每 10 次摄取后用 /second-brain-lint 做健康检查。
限制:资料未提供具体安装方式、依赖环境、价格与平台支持信息,暂未提供。