ReMe/docs/zh/integrations.md
jinliyl dc28e62526
feat(typescript): update DSH adapter and publish integration guides (#519)
* feat(typescript): update DSH integration guides

* docs(typescript): address DSH review feedback
2026-09-04 16:16:01 +08:00

3 KiB
Raw Blame History

title description
Agent 集成 通过 CLI、HTTP、MCP、Skill 和宿主适配器把 ReMe 接入 Agent。

Agent 集成

ReMe 把记忆能力放在独立服务和用户拥有的 workspace 中。Agent 可以通过标准接口调用同一套记忆,而不必把存储逻辑绑定到某一个模型或宿主。

选择接入方式

场景 推荐方式
本机脚本或 Hook ReMe CLI
应用后端 HTTP Client
支持工具协议的 Agent MCP
TypeScript Agent @agentscope-ai/reme
Claude Code MCP + Skill + Stop Hook
Hermes Agent Memory provider adapter
Codex 或其他 coding agent reme_memory Skill 或 MCP

通用接入循环

一个完整但可控的 Agent 记忆循环通常包含:

  1. 会话开始或回答前,用 search 找到相关记忆;
  2. 对高价值结果使用 read,必要时用 traverse 展开关系;
  3. 在回答中保留 workspace-relative 来源路径;
  4. 会话结束后,把原始消息交给 auto_memory
  5. 由后台或定时任务把 daily 内容整理到 digest。

搜索不到内容时应明确返回空结果,不应把模型推测当成历史记忆。

MCP

默认 HTTP 服务在 http://127.0.0.1:2333/mcp 提供 streamable HTTP MCP。常用工具包括

  • search
  • read
  • traverse
  • list
  • auto_memory
  • proactive

根据宿主风险模型,可以用 service.jobs 只暴露只读工具,或将写入工具放在单独配置中。

CLI 和 Skill

仓库中的 skills/reme_memory/SKILL.md 描述了一个通用 Agent 工作流,包括安装检查、服务发现、检索、读取和写入边界。它适合能够执行本地命令的 Agent。

Skill 不应:

  • 未经允许安装或升级 Python 环境;
  • 发现端口冲突后停止未知进程;
  • 把召回的工具结果再次写入对话来源;
  • 将密钥或敏感信息写入记忆。

TypeScript、OpenClaw 与 DeepSeek Harness

统一 HTTP 客户端和包能力见 TypeScript Agent 集成。宿主的完整安装、配置和运行说明见 DeepSeek HarnessOpenClaw 指南。它们包含:

  • HTTP Client
  • DeepSeek Harness adapter
  • OpenClaw adapter
  • 构建与发布检查。

Claude Code

仓库的 integrations/claude_code/ 提供:

  • streamable HTTP MCP 配置;
  • reme-memory Skill
  • 会话停止时调用 auto_memory_cc 的 Hook。

完整安装步骤以仓库中的 integrations/claude_code/README.md 为准。

Hermes Agent

integrations/hermes_agent/ 提供 memory provider模型调用前检索相关记忆每轮结束后异步调用 auto_memory。完整配置见该目录 README。

生产接入建议

  • 明确选择稳定、绝对的 workspace_dir
  • 启动前复用 reme find_reme 发现的服务;
  • reme help 为当前 Job 契约;
  • 为写入动作设置超时和失败日志;
  • 不因记忆服务暂时不可用而阻塞宿主的核心回答流程;
  • 对远程访问使用认证、TLS 和最小 Job allowlist。