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

为 Pi（AI coding agent）提供 llm-wiki 通用知识库访问： 内嵌 vendor-core，与 DSH 插件 @sidleo3/dsh-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 插件同一份 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 单测（不触碰真实库）