Knowledge Curator

把阅读来源整理成持续维护的 Wiki，适用于 Obsidian 桌面版。

0.2.0：新的 Wiki 整理流程

这个版本采用重新实现的 Wiki-first 流程，替代 0.1.x 的 Claim/冲突建议工作流。右侧有三个入口：

• 整理知识库：归类新来源、提炼有原文依据的知识、更新 Wiki 章节、索引、来源映射、日志与 Canvas 知识地图。
• 失败重试：查看未解决任务，展开安全错误信息，单条或串行重试。未改变的成功 Digest 会复用。
• 知识巡查：仅显示低质量、建议清理的来源，提供原因及“清理 / 保留”。不作为 Wiki 写入前的质量门禁。

点击“整理知识库”会按你的配置移动 raw 根目录中的未分类文章，并写入 Wiki 和辅助文件。模型可能判断错误，请先在测试 Vault 或少量副本上检查结果。来源正文不会被重写；归类和归档会改变文件路径。

安装与配置

在 Obsidian 社区插件中搜索 Knowledge Curator 并启用。最低版本为 Obsidian 1.14.4，当前发布仅声明桌面支持。

打开设置，填写：

1. Source Roots：每行一个来源目录，路径相对于当前 Vault。可用 raw，也可以指定多个阅读目录。
2. Wiki Root：Wiki 输出目录，例如 wiki。
3. LLM Base URL / API Key / Model：兼容 OpenAI Chat Completions 的服务配置。
4. Reasoning：按模型能力设置。部分模型只能开启思考，不能通过关闭开关改变其能力。

来源目录与 Wiki 目录不能相同或相互包含。默认阅读目录预设为 02_小红书阅读/raw、03_公众号阅读/raw，Wiki 目录为 04_wiki；请先改成适合自己 Vault 的路径。

本版仍使用 JSON Object 请求与本地 Schema 校验，不宣称所有模型都支持严格 JSON Schema。HTTP 拒绝不会自动换模型或静默降级。格式错误最多修复一次；输出截断、空响应与未确认请求有独立提示。真实服务调用会产生你所选服务商的费用，长文及后续 Wiki 处理可能包含多个请求。

从 0.1.x 升级

0.2.0 是工作流替换，不是旧 Claim 数据结构的迁移。

• 社区插件 ID 仍为 knowledge-curator，保留原来的 GitHub 仓库和历史版本。
• 旧插件设置和缓存会保留在本插件配置的 legacyV013 部分；不会被解释为新流程已完成的状态，也不会自动发送给模型。
• 旧模型密钥、目录与模式不会自动套用到新流程。首次升级会提示你重新确认配置。
• 已有 Markdown/Wiki 文件不会因升级或启用插件而自动改写。只有你主动启动整理或确认来源动作时才处理文件。
• 如需回退 0.1.3，请先备份当前 Vault 与插件数据；旧配置结构可从保留的 legacyV013 恢复。请勿把新配置直接当成旧版配置使用。

来源清理与保护

“清理”依据现有建议执行归档或进入回收站确认。归档保留原文字节并同步 Wiki 来源路径、映射和质量审查记录；删除使用 Obsidian 的回收站 API，保留 Wiki 正文。

删除保护刻意保守：当前仍被任何 Wiki 引用、无法证明由其他未变化来源覆盖、或可能有独特贡献的文章，不能一键删除。需要人工判断的清理建议只打开检查提示，不擅自选择归档或删除。没有自动删除功能。

Wiki、index、来源映射、log、质量审查和知识地图都是 Vault 文件，可以从文件列表打开。模型语义质量与多来源综合仍需要人工检查，自动测试不等于知识正确性保证。

隐私与网络

插件不包含遥测，不内置密钥，不在启动时自动请求模型。你主动启动整理后，会将相关来源文本、提炼结果及检索到的 Wiki 内容发送给你配置的服务商。API Key 以插件配置方式保存在当前 Vault 的 .obsidian/plugins/knowledge-curator/data.json 中，不是加密密钥库；注意自己的 Vault 同步与备份范围。

开发

npm ci
npm run typecheck
npm test
npm run build

测试使用合成数据与 mock HTTP，不调用真实模型。构建将 Obsidian 作为唯一外部运行时模块。安装资源为 GitHub Release 中的 main.js、manifest.json、styles.css。

许可

本项目保留现有 Knowledge Curator Proprietary License，见 LICENSE。源代码公开可见不代表采用开源许可。捆绑的第三方代码许可见 THIRD_PARTY_NOTICES.md。