知识与开放能力

知识库

知识库是 NomiFun “config one, use anywhere” 理念在内容侧的落地：一个由你策展的 markdown 目录，挂载进会话工作区后，agent 会按一份显式检索协议先查再答，而不是凭记忆作答。一座库可以绑定到会话、终端、某只伙伴或某个工作目录，也能打包成 .zip 导出 / 导入。

入口：左侧边栏 知识库（路由 /knowledge）。这里集中管理所有库，并提供建库、设置回写、绑定与挂载的全部操作。

知识库首页

三种知识来源

本地 markdown——你自己组织的目录，最直接，适合手册、规范、项目笔记。
URL 实时快照——创建时可给最多 16 条公网 URL。Snapshot（快照） 模式立即抓取并转为 markdown 落库（超大页面由 AI 压缩），Live（实时） 模式则留给 agent 在运行期实时抓取。内置 SSRF 防护，仅接受 http/https；JS 重度渲染的页面会自动走无头浏览器取回正文。
飞书 Feishu——连接器已实现（UI 内的创建入口当前关闭）。

Notion 来源 = 路线图，尚未实现。 当前可用来源为本地 markdown、URL 快照与飞书连接器三类。

操作步骤

新建本地知识库。在知识库页面点新建，给出名称，组织或选择 markdown 目录，必要时附上 URL 知识源。
添加 URL 实时快照源（可选）。粘贴最多 16 条公网链接，逐条选择 Snapshot 或 Live 模式。Snapshot 适合内容稳定的参考页，Live 适合需要每次拿最新版的页面。
AI 生成描述。点”AI 生成”调用 autogen 为库生成描述与 README.md（需已配置 AI Provider）。描述会注入到 agent 的”何时查阅”提示中，写得越清楚命中越准。
配置回写模式与设置。在库设置里决定对话中产生的知识如何回流：
- Disabled（关闭）——不回写。
- Staged（暂存）——回写先落入库的 _inbox/，由你审阅后合并入库。来自 IM 的写入永远走 Staged，绝不直写。
- Direct（直写）——跳过暂存，直接写入库正文。
查看知识库详情。建库成功后进入详情页，可以浏览目录树、已抓取的快照文件、_inbox/ 待审条目，以及库的描述与统计。
绑定 / 挂载到使用场景。把库绑定到当前会话、终端、某只伙伴或某个工作目录。绑定伙伴后，它的陪伴聊天与渠道会话都会自动挂载这只伙伴的库；挂进会话工作区后，agent 即可在该会话里按检索协议先查再答。

四种绑定类型

绑定类型	含义
workpath	绑定到某个工作目录，目录下的会话默认挂载
conversation	仅绑定到当前这段会话
terminal	绑定到终端会话
companion	绑定到某只伙伴，其陪伴聊天与渠道会话全程挂载

agent 看到什么

库挂载到 {workspace}/.nomi/knowledge/。注入上下文按库携带描述、AI 梗概、“何时查阅”提示和按预算的目录（每库 20 条 / 全局 60 条），外加一份显式检索协议，引导 agent 先检索再作答。伙伴还能自己养库——桌面网关提供建库 / 写文件 / 抓取 URL 等知识工具，它可以在对话中不经吩咐就沉淀心得。

要点与边界

任何 agent 都能用：库按会话 / 终端 / 工作目录 / 伙伴绑定后，挂进该上下文的任意 agent——内置 nomi、ACP 直连 Agent（Claude Code / Codex 等）、终端 CLI——都按同一检索协议先查再答，不限于某一种 agent。
安全回写是一条红线：任何来自 IM 渠道的写入都先进 _inbox/ 待审，永不直接落正文；你在详情页审阅后再决定是否合并。
URL 抓取受 SSRF 防护约束：仅接受 http/https，内网与回环地址会被拦截。
检索预算有上限：注入目录每库 20 条、全局 60 条，超出部分不进上下文——把最关键的内容前置组织。
来源现状：本地 markdown、URL 快照、飞书连接器已可用；Notion 为路线图。

常见问题

Q：快照和实时模式怎么选？ A：内容基本不变的参考页用 Snapshot（抓一次、稳定可控）；需要每次拿最新版的页面用 Live（运行期实时抓取，成本更高）。

Q：IM 里让伙伴记下的东西去哪了？ A：进了对应库的 _inbox/，等你在详情页审阅、合并后才进正文。这是不可绕过的安全设计。

Q：一座库能同时给多个会话用吗？ A：可以。按 workpath 或 companion 绑定即可让多段会话共享同一座库。

知识库