自动化与脚本
把 raw/ 中的原始资料摄入为互链 wiki…
当用户把文件放进 raw/ 并希望将其整理进知识库时,把原始文档处理成结构化、互相链接的 wiki 页面。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 49/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
把 raw/ 中的原始资料摄入为互链 w通用
解决思路
- 确定要处理的文件:若用户指定了文件就用指定的;若用户说“处理新资料”之类,则列出 raw/ 下所有文件(排除 raw/assets/),读取 wiki/log.md 并从 ingest 条目中提取已摄入的源文件名,raw/ 中未出现在日志里的即为未处理;若没有未处理文件就告知用户。
- 对每个源文件:完整读取整个文件;若文件含图片引用,记录下来,必要时单独读取图片以获取重要信息。
- 写任何内容之前,先与用户讨论关键要点:分享源文件中最重要的 3-5 个要点,询问用户是否想强调某些方面或跳过某些主题,等待确认后再继续。
- 创建源摘要页:在 wiki/sources/ 下以源文件名为准(slug 化)新建文件,包含 YAML frontmatter(tags、sources: [original-filename.md]、created、updated)以及正文:标题、Source、Date ingested、Type(article | paper | transcript | notes 等)、Summary(结构化摘要)、Key Claims(要点列表)、Entities Mentioned([[实体名]] — 简要上下文)、Concepts Covered([[概念名]] — 简要上下文)。
- 更新实体页和概念页:对源中提到的每个实体(人物、组织、产品、工具)和概念(想法、框架、理论、模式)——若 wiki 页面已存在,则读取现有页面、补充本次来源的新信息、把该来源加入 frontmatter 的 sources: 列表、更新 updated: 日期,并标注与现有内容的矛盾之处(同时引用两个来源);若不存在,则在对应子目录新建页面(实体放 wiki/entities/,概念放 wiki/concepts/),包含 tags、sources、created、updated 的 YAML frontmatter,并基于本来源写一段聚焦的摘要。
- 添加 wikilink:确保所有相关页面用 [[wikilink]] 语法互相链接;每个有独立页面的实体或概念被提及时都应链接。
- 更新 wiki/index.md:为每个新建页面在对应分类标题下添加条目,格式为 - [[Page Name]] — 一行摘要(不超过 120 字符)。
- 更新 wiki/log.md:追加 ## [YYYY-MM-DD] ingest | Source Title,并写明 Processed source-filename.md. Created N new pages, updated M existing pages. New entities: [[Entity1]], [[Entity2]]. New concepts: [[Concept1]].
- 向用户报告结果:创建了哪些页面(带链接)、更新了哪些页面(及改动内容)、识别出的新实体和新概念、以及与现有内容发现的任何矛盾。
- 遵循约定:源摘要页只写事实,把解读和综合留给概念页和综合页;单个来源通常涉及 10-15 个 wiki 页面,这是正常且预期的;当新信息与现有 wiki 内容矛盾时,更新 wiki 页面并标注矛盾、同时引用两个来源;优先更新已有页面而非新建,只有主题足够独立时才新建页面;所有内部引用使用 [[wikilinks]],绝不用原始文件路径。
适用边界 · 注意事项
- 用户没有把文件放进 raw/ 或没有新资料需要摄入时。
- 用户只是想查询已有知识库内容(应改用 /second-brain-query)而不是摄入新资料时。