nvk/llm-wiki

llm‑wiki – 为 AI 代理编译的 LLM 知识库

它是什么 – llm‑wiki 是一个开源系统，允许大型语言模型代理（Claude、OpenAI Codex、OpenCode、Pi 等）构建、维护和查询个人或团队维基。该维基以结构化且兼容 Obsidian 的文件夹布局存储想法、研究、项目和工件，代理可以自动摄取来源、运行并行研究、审核内容，并将经过审查的简报推进为可交付的项目。

核心概念

• 会话 – 可选的按代理记忆，记录代理在维基会话中所做的工作；可以按用户禁用。
• 适配器 – 一个私有的、清单驱动的插件系统，将摄取和写入操作路由到特定提供商（例如：Web、CSV、media‑wiki），同时将身份验证和副作用保持在严格控制之下。
• 研究模式 – 单次查询、深度多代理研究、论文驱动的调查以及专家方法选择。
• 导出检查点 – docs/knowledge/<slug>/ 快照，包含项目知识的确定性、最小隐私交接。

支持的运行时

运行时	如何调用	只读查询大小	完整研究大小
Claude Code (原生)	/wiki:… 命令或 @wiki 技能	wiki:query (≈2.8 KB)	@wiki (≈11.7 KB)
OpenAI Codex (市场)	安装插件后使用 $wiki-query 或 @wiki	与 Claude 相同	与 Claude 相同
OpenCode (指令文件)	将 SKILL.md URL 添加到 opencode.json	wiki-query/SKILL.md	wiki-manager/SKILL.md
Pi / DS4 (本地模型)	./scripts/pi-wiki-query (只读) 或 pi --skill …/wiki-manager/SKILL.md (完整)
任何其他 LLM 代理	复制 profiles/query-lite/SKILL.md (只读) 或 AGENTS.md (完整)

安装快捷方式

• Claude Code – claude plugin install wiki@llm-wiki
• Codex – codex plugin marketplace add nvk/llm-wiki && codex plugin add wiki@llm-wiki
• OpenCode – 将远程 SKILL.md URL 添加到 opencode.json（或在本地 curl）
• Pi – pi --skill path/to/llm-wiki/plugins/llm-wiki-opencode/skills/wiki-manager/SKILL.md

典型工作流程

1. 创建 / 选择主题 – /wiki:research "nutrition" --new-topic
2. 摄取来源 – /wiki:ingest https://example.com/article 或使用 ingest‑collection 进行批量导入。
3. 运行研究 – @wiki research "gut‑brain axis" --deep --min-time 2h（生成多个代理进行阅读、总结和交叉引用）。
4. 查询编译的知识 – /wiki:query "How does fiber affect mood?" (只读) 或从任何 LLM 使用 wiki-query。
5. 推进简报 – @wiki audit --project coldcard-threat-model 将审查过的简报移至交付项目。
6. 导出检查点 – v0.24.0 添加了一个命令，可在 docs/knowledge/ 下写入可重现的快照以供交接。

架构亮点

• Claude 优先的事实来源 – 规范技能位于 claude-plugin/skills/wiki-manager/SKILL.md。特定运行时的包装器（Codex、OpenCode、Pi）通过同步脚本自动生成。
• 私有适配器协议 (llm‑wiki‑adapter/v1) – 适配器声明意图、URL 路由和读写权限。没有任何提供商凭证被硬编码到维基中；适配器强制执行确切的白名单和幂等键。
• 文件系统中心 – 维基位于用户可配置的目录中（默认为 ~/.config/llm-wiki，备用为 ~/wiki）。该系统完全兼容 Obsidian，因此用户可以根据需要手动编辑笔记。
• 沙盒友好性 – 每个运行时都记录了明确的 nono 沙盒策略，确保代理拥有所需的最小读写权限。

为何重要

• 为 LLM 代理提供持久、可搜索的知识存储，而不是无状态的提示。
• 实现可重现的研究流程：摄取 → 并行分析 → 审核 → 导出。
• 跨越主要 LLM 代理生态系统（Claude、Codex、OpenCode、本地模型）工作，并具有单一事实来源。

限制 / 注意事项

• 该系统假定主机代理可以读写维基目录；沙盒环境必须授予这些权限。
• 完整研究命令具有写入能力并会修改文件；当您只需要查找时，请使用只读的 wiki‑query 技能。
• 导出的检查点是只读的；它们永远不会自动提交或发布更改。

了解更多

• 项目网站：https://llm‑wiki.net/
• GitHub 仓库：https://github.com/nvk/llm-wiki（参见 README.md、CHANGELOG.md 和 tests/ 目录以进行同步验证）
• 快速入门示例位于 README 的 Quick Start 部分。