跳到主要内容
印格

Common Knowledge:全平台共享常识记忆库

平台一次写入产品文档、运行手册与通用约定,所有团队默认在 search / recall / wake-up 中合并共享命中。客户只读,仅平台运营团队可写。

要解决什么问题

每个客户团队都会为项目事实建自己的记忆库。但有一部分知识是通用的:Library / Scope / Topic 怎么用、套餐限额、支持的 MCP 工具、公司对外 API 约定等。在每个库里各写一份既浪费入库配额,又容易过时。

Common Knowledge 是平台统一维护的一条记忆库,默认合并进检索,让 Agent 自动获得共享事实,而无需每个团队各自维护副本。

工作机制

memory_libraries 中一条 library_kind = platform_shared 的记录,由 platform_memory_settings.shared_common_library_id 指向。所有团队可列出与检索;仅拥有该库行的平台运营团队可写入 atom。

开启 includeSharedCommonInRetrieval(默认开启)时,对团队库的 memory_search / memory_recall 会同时查询 Common Knowledge 并按相似度合并 top 命中;memory_wake_up 在提供 augmentQuery 时可追加 ## Shared common knowledge 区块。命中可能带 source: platform_shared 标注来源。

配置级联

三级覆盖,与 MCP 唤醒/落盘策略类似: • 单库 — 继承 / 开 / 关 • 团队 — 覆盖平台默认 • 平台 — 新团队默认开启

若某库必须只检索团队自有 atom,可在库设置中关闭合并。

控制台与 MCP

平台管理员在 平台管理 一次性创建共享库,之后像普通库一样管理 atom。其他团队在 /dashboard/memory 看到「共享」徽章,写入入口对只读团队隐藏。

MCP memory_list_libraries 会列出共享库;非运营团队看到 readOnly: true。客户 API Key 若直接向共享库写入,会收到 memory_library_read_only。

部署清单

执行 D1 迁移 0046,部署应用与 memory-mcp-proxy worker 后,由平台管理员调用一次 POST /api/platform/memory/shared-library。对外说明见 Common Knowledge 文档;内部表结构与 API 见 docs/memory-libraries.md。