@sidleo3/pi-wiki — Pi 的 llm-wiki 知识库扩展

为 Pi（AI coding agent）提供 llm-wiki 通用知识库访问： 内嵌 vendor-core，与 DSH 插件 @sidleo3/dsh-wiki / Codex 插件 @sidleo3/codex-wiki / MCP 服务端 @sidleo3/mcp-wiki / skill CLI 完全相同的实现，读写同一份 OKF v0.2 bundle（默认 ~/.agents/wiki），一套数据五处共享、无重复维护。

能力

Pi 会话注入 14 个工具 + prompt 引导，并用 before_agent_start 钩子每回合现读各目录 APPEND_SYSTEM_PROMPT.md 追加进本回合 system prompt（改规则立刻生效，不依赖加载期快照）：

| 工具 | 用途 | |------|------| | wiki_list | 目录树 + 概念清单（知识工作第一步先调用） | | wiki_search | 关键词检索（frontmatter + 正文；type/tag 过滤；★ 强匹配） | | wiki_get | 读单概念全文，自动附 backlinks（引用它的坑点/概念） | | wiki_create | 新增概念（门控读 AGENTS.md 规则；确认后带 human verified） | | wiki_update | 更新概念字段/正文（只更新传入字段） | | wiki_validate | OKF v0.2 合规校验 | | wiki_lint | 体检：断链/孤儿/过期/缺 index | | wiki_ingest | 登记外部源文件进 bundle（copy 不改源） | | wiki_deprecate | 目录级批量停用（status: deprecated，零删除） | | wiki_rules | 目录生效规则：APPEND（行为规则）+ AGENTS.md 门控；不带 path = 全部 APPEND 全文 | | wiki_help | 机制文档自助查（AGENTS/APPEND 写法、frontmatter、门控） | | wiki_dirs | 查看全部 wiki 目录分支（命名 bundle）与当前激活项 | | wiki_use | 切换全局默认目录分支（写注册表 active；pi 无会话态） | | wiki_sync | 在线知识库同步（按后端分派）：本地目录→Git 远端；飞书云盘库→lark-cli（status/sync/pull/push/init）。index.md 重生成、log.md 取并集；两侧都改则停下报清单，绝不 force/覆盖 |

安装

# 本地源码目录（改代码即生效）
pi install /path/to/packages/pi

# 或发布后
pi install npm:@sidleo3/pi-wiki

配置

• 数据目录默认 ~/.agents/wiki（与 DSH / Codex 插件同一份 bundle），环境变量 PI_WIKI_DATA_DIR 覆盖。
• 多目录（命名 bundle）：注册表 ~/.agents/wiki-registry.json（env WIKI_REGISTRY_FILE 覆盖）；wiki_dirs 查看、wiki_use <name> [global:true] 切换全局默认（pi 无 DSH 的 per-agent 会话态）。
• 自包含：core 已内嵌为 vendor-core/（npm run sync-vendor 从仓库 packages/core 同步），安装即用无需额外依赖。

知识库格式

与 schema.md 一致（OKF v0.2）：概念 = frontmatter（type 必填）+ 正文 markdown； index.md/log.md/AGENTS.md 为保留文件；真实链接交叉引用；stale_after 过期、 status: deprecated 停用。详见仓库根 schema.md 与 SPEC-EXTENSIONS.md。

开发

npm install            # typebox + @earendil-works/pi-coding-agent 类型
node --experimental-strip-types --check extensions/index.ts
npm test               # mock pi 单测（不触碰真实库）