zhuzhaoyun/molio/molio-kb

Molio 知识库（molio-kb）

当用户提到「我的知识库」「Molio」，或要求"在我积累的资料里查/总结/回答"时，使用本技能。 所有工具都通过 MCP server molio-kb 提供，全部只读，不会修改用户知识库。

可用工具（7 个）

vaultId 均可传知识库 id 或名称；不传则用 Molio 当前打开的知识库。

标准工作流

A. 查找资料（快，秒级）

1. 不确定用户有哪些库时先 kb_vaults（多库场景让用户选，单库直接用）。
2. kb_search 搜关键词 → 命中列表（路径 + 摘录）。
3. 对最相关的 1~3 个文件用 kb_read 读原文，再组织回答。
4. 想了解库的整体结构时用 kb_tree 浏览目录，挑文件再 kb_read。

B. AI 问答（慢，10 秒~2 分钟）

适合"总结/综述/对比/基于全部资料回答"类问题：

1. kb_ask_start(question) → 立即拿到 runId（不要期待这一步返回答案）。
2. 等待 ≥5 秒后调 kb_ask_poll(runId)：

• status 为 pending/running → 继续等 5~10 秒再查，重复；
• status 为 succeeded → answer 即完整答案，整理后回复用户；
• status 为 failed/canceled → 返回错误信息，向用户说明。

1. 总等待建议不超过 3 分钟；超时告知用户"问答仍在后台执行，稍后可再查"。

绝不在一次 kb_ask_poll 里期待阻塞等待——它永远单次返回，轮询节奏由你控制。

错误场景与恢复

回答规范

• 引述知识库内容时注明来源文件路径，方便用户回 Molio 查看原文。
• 搜索结果被截断（返回 truncated: true）时，可调大 limit（最大 100）或换更精确的关键词。
• 本技能只读：不要向用户承诺"写入/修改/整理知识库文件"。