Agent Plugins 记忆插件
Myrm 提供一份符合 Agent Plugins 标准的便携插件,可将长期记忆接入任何支持该标准的客户端 —— VS Code、GitHub Copilot、Kiro、Cursor、ChatGPT、Codex 等。插件仅负责传输层:它将 MCP 客户端指向 Myrm 的记忆服务,并教会接入的 agent 何时、如何使用记忆,无需逐客户端手工编辑配置文件。插件包含
生成插件
- 打开 设置 → 记忆 → 连接(连接向导)。
- 选择要对外暴露记忆的 Myrm 智能体。
- 在 Agent Plugins 卡片中,选择将 token 写入插件文件,或从
MYRM_MCP_TOKEN环境变量读取。 - 点击 生成 Agent Plugins 插件,然后点击 下载全部 (.zip) 一次性下载整个插件,或逐个复制各文件。解压压缩包 —— 其中已包含正确的目录结构 —— 放入客户端的插件目录并启用即可。
plugin.json 与 mcp.json 放在插件根目录,SKILL.md 放在 skills/myrm-memory/ 子目录下 —— zip 会自动保持该结构;若逐个复制文件,请手动重建。客户端只会从 skills/<name>/ 子目录加载技能文件,平放在根目录的 SKILL.md 会被静默忽略。
将 token 写入插件文件模式开箱即用,但会把凭据写进 mcp.json,请勿将此类插件提交到版本库。默认的环境变量模式保持插件无凭据、可安全提交:多数客户端替换 ${MYRM_MCP_TOKEN},部分客户端(VS Code、Cursor)使用 ${env:MYRM_MCP_TOKEN}。若客户端不支持插值,可在向导中开启 token 写入模式——token 随时可撤销。
管理访问
- 生成的 token 与所选 Myrm 智能体绑定,通过插件只能访问该智能体的记忆。
- 在向导中重新生成插件即可签发新 token —— 旧 token 立即失效,使用旧插件的客户端需重新配置。
- 在向导中撤销连接可立即吊销 token。
- 依赖前可先通过向导的健康检查验证连接。
运行 Doctor 检查
向导的 Doctor 按钮比在线 token 测试更进一步:它会读取你机器上 MCP 客户端的真实配置文件,从客户端侧确认插件是否正确接入。- 同时支持 JSON(
json_mcp)与 TOML(toml_mcp)两种客户端格式,路径中的~自动展开。 - Token 仅以 SHA-256 哈希存储 —— 绝不落明文。
- 诊断消息支持 6 种语言(EN / 中文 / 繁體 / 日本語 / 한국어 / DE),每个诊断码都附可执行的修复指引。
- Doctor 只读不写 —— 绝不修改你客户端的配置文件。
自托管
插件仅负责传输层,因此同样适用于自托管实例 —— 本地 Web UI、桌面端或云沙箱。将mcp.json 中的 url 指向你实例的 /mcp 端点,并到对应实例的连接向导生成 token 即可。