zeyu-j/centricmem-skill

CentricMem

一个库。每个 agent。每张桌子。

面向 AI agent 的托管式图书管理员。捕获仍留在你已经在用的 agent 中。CentricMem 负责组织和检索——Cursor、Claude Code、Codex、Hermes、Pi、OpenClaw、DSH、Copilot、Kiro、Kilo、CodeBuddy、Kimi Code，以及下一个，共享同一个书架。

本仓库是一个包：Agent Skills 的 SKILL.md 加上一个 Agent Plugins 1.0 捆绑包（plugin.json + skills/ + mcp.json）。从 GitHub 安装一次；每个客户端使用自己的命令。不要把密钥或 marketplace JSON 粘贴到聊天中。

安装

把下面这段粘贴给 agent（一行）：

Install CentricMem from zeyu-j/centricmem-skill. After install, this agent (and each client you install into) sends https://centricmem.com/login?signup=1 and tries a /connect?device= URL — plugin mcp.json or mcp add with no Bearer is not a completed connect. If minting that URL fails, run centricmem doctor connect and they email zeyu@poppyg.com with that output (never a key); then MCP OAuth only if this agent will receive the browser login (Grok Bot and Manus may; a 127.0.0.1 callback does not when this agent is not listening there). If they already have a key or a finished OAuth login in this agent, ask for a new chat — do not strip Bearer, do not mint a new connect URL. Tell them the key appears only once — save a backup; never paste keys. If connect or usage still fails, they email zeyu@poppyg.com (never a key).

如果 shell 可用，项目中的终端可以运行：

npx --yes skills add zeyu-j/centricmem-skill --skill centricmem-agent -y

（省略 -g——有些 agent，包括 PromptScript，没有用户级 skills 目录。）

同一个 GitHub 仓库也可作为插件 marketplace：

| 客户端 | 添加此仓库，然后安装 |
| --- | --- |
| Cursor | Plugins → Team Marketplaces → Import from Repo zeyu-j/centricmem-skill，或使用上面的 npx skills add |
| Claude Code | /plugin marketplace add zeyu-j/centricmem-skill 然后 /plugin install centricmem-skill@centricmem |
| CodeBuddy / WorkBuddy | codebuddy plugin marketplace add zeyu-j/centricmem-skill 然后 /plugin install centricmem-skill@centricmem |
| Kimi Code | /plugins install https://github.com/zeyu-j/centricmem-skill（Custom）。目录：/plugins marketplace https://raw.githubusercontent.com/zeyu-j/centricmem-skill/main/.kimi-plugin/marketplace.json。为宿主 MCP 设置 CENTRICMEM_API_KEY。 |
| Dify | Marketplace 列表待审核。来源：zeyu-j/centricmem-dify。或者用同一个 agent 密钥挂载 MCP https://mem.centricmem.com/mcp。 |
| Codex | 每个 agent 先尝试 /connect?device=。插件：codex plugin marketplace add https://github.com/zeyu-j/centricmem-skill.git 然后安装 centricmem-skill。只有在 mint 失败之后才用 codex mcp login，并且仅当此 Codex 会收到 Loopback 回调时 |
| Hermes | hermes skills install zeyu-j/centricmem-skill/skills/centricmem-agent。先铸造 /connect?device=。只有在铸造失败且此 Hermes 将接收浏览器登录时，才执行本地 hermes mcp add --url https://mem.centricmem.com/mcp --auth oauth centricmem。 |
| Pi | pi install https://github.com/zeyu-j/centricmem-skill。然后仅用 URL 的 ~/.pi/agent/mcp.json（url + type: streamable-http）。MCP 不会由该包自动接入。 |
| OpenClaw | 兼容的 bundle（Agent Plugins / Claude / Codex / Cursor）。不是 ClawHub。openclaw plugins install git:github.com/zeyu-j/centricmem-skill 或 openclaw plugins install centricmem-skill --marketplace zeyu-j/centricmem-skill。不要添加 openclaw.plugin.json。 |
| DSH | 仅限 Cordis funnel。需要 pnpm（如果缺失，运行 npm i -g pnpm）。固定版本：dsh plugin --profile web add github:zeyu-j/centricmem-skill#v0.21.72。然后从 profile 目录运行 node node_modules/centricmem-skill/dsh/copy-skill.mjs，以便 $DSH_HOME/skills/centricmem-agent 存在（funnel MCP 不会从 node_modules 加载 Skill）。在 $DSH_HOME/profiles//cordis.patch.yml 中，对同一个 id 叠加 Bearer（重述整个配置）。新建聊天。工具为 mcp__centricmem__cm_。Skill 保持 PolyForm；dsh/ 是 MIT 胶水代码。GitHub 主题 dsh-plugin。 |
| Copilot CLI | copilot plugin marketplace add zeyu-j/centricmem-skill，然后 copilot plugin install centricmem-skill |
| Kiro | Powers → Add Custom Power → GitHub https://github.com/zeyu-j/centricmem-skill |
| Grok Bot | 粘贴这一行命令。Shell 被阻止，因此只发送注册信息；在该 bot 的 MCP 设置中添加 https://mem.centricmem.com/mcp（密钥来自 Keys，绝不要放在聊天中）。 |
| SkillKit | skillkit add https://centricmem.com 或 skillkit add zeyu-j/centricmem-skill |
| 任何其他 Agent Skills 宿主 | 复制 skills/centricmem-agent/，使文件位于 /centricmem-agent/SKILL.md。宿主 MCP 是位于 https://mem.centricmem.com/mcp 的 streamable-HTTP。设备认领后：centricmem connect --claim --target （或 CENTRICMEM_MCP_TARGETS）。用 centricmem connect --verify 确认。不要从另一个客户端的 mcp.json 复制密钥。 |
| skills.sh / SkillMD | 上面的 npx skills add，或 skillmd add zeyu-j/centricmem-skill |

然后继续对话。安装后，如果 cm_ 工具缺失，此 agent（以及你安装到的每个客户端）会发送注册信息 并且 尝试一个 /connect?device= 链接。插件 mcp.json 并不等于完成连接。如果铸造该 URL 失败，运行 centricmem doctor connect，并将该输出通过电子邮件发送到 zeyu@poppyg.com；然后仅在此 agent 将接收浏览器登录时（Grok Bot / Manus 可能会）才使用 OAuth。不要因为存在 OAuth 就跳过 connect URL。WorkBuddy/CodeBuddy 也尝试 connect URL。不要下载包含密钥的设置文件。agent 会告诉你保存密钥备份（它只出现一次）。你不要粘贴聊天、令牌或 CLI。
托管式图书管理员：centricmem.com。注册开放。托管 MCP：https://mem.centricmem.com/mcp。切勿在聊天中粘贴密钥。

如何使用

1. 继续在你原本工作的地方对话。智能体自身的记忆保持开启。它会一次性说明本次聊天使用的是哪个密钥。额外授权：在 Keys 上勾选书架。默认打开所有书架。
2. 如果库看起来是空的，智能体会一次性提议把你已有的笔记归档为卡片。捕获保持开启。你可以跳过。它不会转储每一次聊天。
3. 当工作确有其事时，智能体会归档一张 Markdown 卡片，并把本次聊天的记录保存在对象存储中——你不必说“收尾”。关闭标签页不会归档；它会在停止前归档。让它保留文件并写一张卡片；一个原始文件文件夹就是一次导入。如果你已经打包好了，网站上的归档 zip 是可选的。如果你的 Skill 落后于这个仓库，智能体会用 npx skills add 刷新它（当前聊天仍使用旧副本）。插件安装通过该客户端的插件 UI 更新。
4. 之后，询问智能体——或登录以搜索并下载原始文件。没有收件箱：归档到具名书架。遗留书架（包括遗留的 unclassified）：智能体会复制到另一个书架（cm_copy），然后删除旧书架（cm_delete）——它不会把原始文件下载到这台电脑，也没有恢复仓库。要移动卡片的子集，智能体使用 cm_move（默认密钥）。要删除或重命名单张卡片，使用 cm_delete / cm_rename {file, shelf}。额外密钥不能这样做。

你不需要在这台机器上运行图书管理员。你不需要 setup --bootstrap。

这个仓库是什么

这个仓库是 Skill：智能体如何与托管式图书管理员对话。

- skills/centricmem-agent/SKILL.md — 会话循环（Agent Skills frontmatter）
- skills/centricmem-agent/REFERENCE.md — 搜索、显示、清扫、复制、移动选中的卡片、重命名卡片标题、删除遗留书架或某张卡片
- plugin.json + mcp.json — 可移植的 Agent Plugins 1.0 包
- .cursor-plugin/marketplace.json — Cursor 团队市场
- .claude-plugin/marketplace.json — Claude Code 市场
- .codebuddy-plugin/marketplace.json — CodeBuddy / WorkBuddy 市场（codebuddy plugin marketplace add zeyu-j/centricmem-skill）
- .kimi-plugin/plugin.json — 从此 GitHub URL 进行 Kimi Code 自定义安装
- Dify 是一个单独的工具插件：zeyu-j/centricmem-dify（不是这个 Skill 仓库）
- .agents/plugins/marketplace.json — Codex 市场
- .github/plugin/marketplace.json — Copilot CLI 市场
- .kiro/plugins/marketplace.json — Kiro 固定同步目录
- dsh/cordis.patch.yml — DSH Cordis 漏斗（MIT 胶水，仅 URL 的 MCP，failOnStartupError: true）。dsh/copy-skill.mjs 将 Skill 复制到 $DSH_HOME/skills/。Skill 仍为 PolyForm。不是 ClawHub。

它不是 librarian，不是 CLI 源码，也不是自托管套件。一个公开 skill：centricmem-agent。

许可证

PolyForm Noncommercial 1.0.0 — 要求署名；禁止商业使用。dsh/ 中的 Cordis 补丁单独采用 MIT，以便 DSH 可以挂载托管的 MCP 客户端。这并不重新许可 SKILL.md。