用途
Wiki 是一个持久化、自我维护的 Markdown 知识库,用于沉淀项目与会话知识,灵感来自 Karpathy 的 LLM Wiki 概念。它让知识能够跨会话累积,形成可复用的项目记忆。
主要能力
- Ingest(摄入):将知识处理为 wiki 页面,单次摄入可涉及多个页面。示例:
wiki_ingest({ title: "Auth Architecture", content: "...", tags: ["auth", "architecture"], category: "architecture" }) - Query(查询):按关键词与标签搜索所有 wiki 页面,返回带摘要的匹配页面,由 LLM 结合结果生成带引用的答案。示例:
wiki_query({ query: "authentication", tags: ["auth"], category: "architecture" }) - Lint(检查):对 wiki 运行健康检查,检测孤立页面、过期内容、损坏的交叉引用、超大页面和结构性矛盾。示例:
wiki_lint() - Quick Add(快速添加):快速添加单个页面,比 ingest 更简单。示例:
wiki_add({ title: "Page Title", content: "...", tags: ["tag1"], category: "decision" }) - List / Read / Delete(列出/读取/删除):
wiki_list()显示所有页面(读取 index.md);wiki_read({ page: "auth-architecture" })读取指定页面;wiki_delete({ page: "outdated-page" })删除页面。 - Log(日志):通过读取
.omc/wiki/log.md查看 wiki 操作历史。
使用方式
页面按类别组织:architecture、decision、pattern、debugging、environment、session-log。
存储结构:
- 页面:
.omc/wiki/*.md(带 YAML frontmatter 的 markdown) - 索引:
.omc/wiki/index.md(自动维护的目录) - 日志:
.omc/wiki/log.md(仅追加的操作记录)
交叉引用:使用 [[page-name]] wiki-link 语法在页面之间创建交叉引用。
自动捕获:会话结束时,重要发现会自动捕获为 session-log 页面。可通过 .omc-config.json 中的 wiki.autoCapture 配置(默认启用)。
适用场景
适合需要跨会话累积项目知识、沉淀架构决策与调试经验、维护结构化文档的场景。
限制
- 不使用向量嵌入——查询仅使用关键词与标签匹配。
- Wiki 页面默认被 git 忽略(
.omc/wiki/为项目本地)。
模型路由
- haiku——快速查找、轻量检查、窄范围文档工作
- sonnet——标准实现、调试与审查
- opus——架构、深度分析、共识规划与高风险审查
- fable——Claude Fable 5(高于 Opus);在 Task 调用中显式传入,或通过
agents.<name>.model为每个 agent 固定
使用 /model 选择的会话模型仅适用于主循环。委派的 agent 运行在其固定的层级上,除非 Task 调用显式传入 model,或通过 agents.<name>.model 覆盖该 agent。要让委派工作在 Fable 上运行,需使用这两种方式之一;仅在 /model 中选择 Fable 不会改变委派行为。