用途：把 Pi 编码智能体的会话记录提炼成 Obsidian 知识库内容。会话以结构化 JSONL 树形存储，需沿活动分支提取可复用知识并编译成页面。会话文件是唯一事实来源，不得引入模型训练知识、其他工具或本地文件内容；外部信息只能标为待解决问题或跳过。
主要能力：支持追加模式（默认，仅处理清单中不存在或修改时间更新的文件）与全量模式；解析 session、message、session_info、compaction、branch_summary、bashExecution 等条目，跳过 model_change、thinking_level_change、custom、label；按主题跨会话聚类，路由到 projects/、concepts/、skills/、entities/、synthesis/；为每条事实建立证据台账（pi:<文件名>#<条目id>），添加来源注释、^[inferred]、^[ambiguous] 标记及 confidence、lifecycle 字段；更新 .manifest.json、index.md、log.md、hot.md。
使用方式：先按 llm-wiki/SKILL.md 的配置解析协议获取 OBSIDIAN_VAULT_PATH 与 PI_HISTORY_PATH（默认 ~/.pi/agent/sessions），读取 .manifest.json 与 index.md；可用 find ~/.pi/agent/sessions -name "*.jsonl" -type f 盘点文件；同步特殊文件用 obsidian-wiki memory sync PI_HISTORY_INGEST sessions=<sessions> pages_updated=<pages_updated> pages_created=<pages_created> mode=<mode> --takeaways "..."，不要手工编辑 index.md、log.md、hot.md。若设置了 QMD_WIKI_COLLECTION，写入后运行 ${QMD_CLI:-qmd} update，必要时再 embed 并验证。
适用场景：定期同步 Pi 会话、重建知识库后全量重导、从历史对话中挖掘工作流与调试经验。
限制：需先完成配置解析；隐私过滤要求移除密钥、令牌、密码等敏感信息，敏感内容需用户确认；无法验证的声明须删除或标记；QMD 刷新失败不回滚知识库改动。具体字段解析细节见 references/pi-data-format.md，资料未提供更多实现细节。