Common Knowledge 共享常识库
全平台共用的只读记忆库。平台运营写入产品文档、API 约定与通用 runbook；各团队在检索自己的记忆库时，默认合并共享库命中（可关闭）。
是什么
Common Knowledge 是 Engra 上唯一一条 library_kind = platform_shared 的记忆库。它出现在每个团队的 memory_list_libraries 列表中，但除平台运营团队外，其他团队只能读、不能写。适合存放：术语定义、公开 API 行为、套餐与配额说明、MCP 工具用法、公司级编码规范等跨租户事实。
读写边界
- 读取
- 所有团队的 memory:read 可 list / search / recall / wake-up / list_atoms
- 写入
- 仅拥有该库行的平台运营团队（memory:write + 库归属 team_id 一致）
- 配额
- 不计入团队「可创建记忆库」数量上限
- 删除
- 不可删除 platform_shared 库
检索如何合并
当 includeSharedCommonInRetrieval 为 true（默认）时，对团队自有库发起的检索会同时查询 Common Knowledge，按相似度去重合并 top-k。对共享库本身检索时不会再次合并自身。
- memory_search / memory_recall — 合并双方命中；响应可含 sharedCommonIncluded: true
- memory_wake_up — 有 augmentQuery 时，在组合上下文末尾追加 ## Shared common knowledge 区块
- 命中标注 — 可能含 memoryLibraryId、source: team | platform_shared
开关级联
| Level | Console | Setting |
|---|---|---|
| 单库 | /dashboard/memory/[libraryId]/settings | includeSharedCommonInRetrieval — inherit | on | off |
| 团队 | /dashboard/memory/settings | includeSharedCommonInRetrieval — boolean |
| 平台 | /dashboard/platform | 默认：检索时合并共享常识记忆 |
null / inherit 表示使用上一级默认。关闭后仅返回该团队库自有 atom。
API 与 MCP
- REST /api/v1/memory/* — 传团队库 memoryLibraryId 时自动合并；也可直接传共享库 id 只读浏览
- 固定标签 `common`（`library_label`）；wikilink 示例：[[common:scope/topic]] 或 [[common:scope/topic/title: 字段]]
- MCP memory_list_libraries — 含 label、libraryKind、readOnly、linkedLibraryScope
- MCP 写工具 — 非运营团队对共享库 id 返回 memory_library_read_only
- 平台创建 — POST /api/platform/memory/shared-library（平台管理员 Session，仅需一次）
控制台路径
| Role | Path | Action |
|---|---|---|
| 平台管理员 | /dashboard/platform | 创建 Common Knowledge 库、平台默认开关、跳转管理 atom |
| 任意团队 | /dashboard/memory | 列表中查看「共享」库（只读团队无删除、无写入） |
| 团队管理员 | /dashboard/memory/settings | 团队级合并开关 |
| 库管理员 | /dashboard/memory/[id]/settings | 单库继承 / 开 / 关 |
推荐 Agent 用法
- 仍先 memory_list_libraries，选择团队项目库作为 memoryLibraryId 主库
- 无需单独传共享库 id — 合并开启时 search / recall / wake-up 自动带上常识
- 若命中 source 为 platform_shared，纠正过时事实应联系平台运营，而非 memory_correct_atom
- 平台运营写入共享事实前，用团队库 search 避免与共享库重复
运维（平台侧）
- npm run db:d1:migrate:remote（迁移 0046_platform_shared_common_library.sql）
- 部署 Next.js 应用与 memory-mcp-proxy worker
- 平台管理员登录 → /dashboard/platform → 创建 Common Knowledge 库
- 在同一库页面或通过 MCP 批量写入常识 atom
记忆库 MCP · 概念指引（Library / Scope / Topic） · 工程博客：Common Knowledge · 记忆库控制台