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。