DeepSeek 策略的 ReMe 插件指南
本指南解释如何安装、配置和使用 @agentscope-ai/reme-dsh-plugin 包括内存引导注入、 reme_search 工具、自动内存、每日合并和ReMe状态页面.
截图记录了先前针对DSH的本地融合测试 0.1.5-rc.2;支持的释放是 0.1.7-rc.2, (中文(简体) ), 0.2.0-rc.2, (中文(简体) ), 0.2.1-alpha.2, (中文(简体) ), 0.2.1-alpha.4, (中文(简体) ), 0.2.1-rc.2,以及 0.2.2-alpha.2. 接口和ReMe指导均被设定为英语,被隔离的DSH和ReMe工作空间只包含虚构的Project Aurora数据. 没有 .env 值、 API 密钥、 访问符号或个人记忆出现在截图中.
1. 插件的运作方式
当一个DSH会话开始时,插件会注入引导来告诉根剂何时以及如何使用长期内存. 它也登记只读 reme_search 工具。 在回合完成后,插件可以向ReMe提交用户和助理消息 auto_memory; 每日日程可以运行 auto_dream 将日记条目整合为持久的个人知识.
New session
└─ Inject long-term-memory guidance
└─ Agent decides whether the request depends on history
└─ reme_search → ReMe search → daily / digest files
Completed conversation
└─ Automatic-memory batch → ReMe auto_memory → daily files
└─ Scheduled consolidation → ReMe auto_dream → digest files
DSH 适配器注入 使用指导不是每个历史记忆 相关记忆仅在代理机打电话时输入对话 reme_search。这避免了不相关历史的出现,并有助于防止将历史内容视为新的指令.
2. 所需经费
- ReMe 已安装,其配置将曝光
search, (中文(简体) ),auto_memory,以及auto_dream任务. - 深搜索策略
0.1.7-rc.2, (中文(简体) ),0.2.0-rc.2, (中文(简体) ),0.2.1-alpha.2, (中文(简体) ),0.2.1-alpha.4, (中文(简体) ),0.2.1-rc.2,或0.2.2-alpha.2。 。 。 . - 节点.js
^22.19.0或者说>=24.0.0,匹配当前 DSH 引擎范围(DSH)0.2.2需要节点24.9或更新. - 运行DSH的浏览器可以到达所配置的ReMe HTTP端点. 跨机部署还必须允许DSH浏览器来源.
默认的 ReMe 端点是 http://127.0.0.1:2333. ReMe HTTP 不使用 API- key 认证,因此不能直接将其暴露在不可信网络上.
同行范围涵盖经过测试的前释放线和相容性稳定 0.1.x 编号 : 0.2.x 释放 其他预放行在被添加前需要验证; 2; 0.3.x 除外.
3. 安装和启动
此软件包取代前者 @agentscope-ai/reme/dsh 输入。 在安装新软件前删除合并软件包
特定主机插件 .
3.1 启动ReMe
reme start workspace_dir=/absolute/path/to/your/reme-workspace \
service.host=127.0.0.1 service.port=3457 \
jobs.dream_cron.enabled=false
插件默认拥有每日 Dream 日程表, 因此无法使用 ReMe 的 dream_cron 在保留
auto_dream API可用. 要使用 ReMe 排程, 请省略此覆盖并设置插件
autoDreamEnabled 改为 false共享服务应只有一个调度器.
对于开发和截图,使用寄存器外的孤立目录,例如: /tmp/reme-dsh-demo。不将运行时间内存写入仓库 .reme/ 目录.
3.2 安装 DSH 捆绑
安装已发布的软件包 。 见上面所列 超级 DSH 插件 财务报告和审定财务报表 无数字 :
dsh plugin --profile web add @agentscope-ai/reme-dsh-plugin
对于本地软件包的开发,将软件包目录传递到DSH,所以配置文件会记录本地链接:
cd /path/to/deepseek-harness
pnpm link /path/to/ReMe/integrations/dsh --workspace-root
dsh plugin --profile web add /path/to/ReMe/integrations/dsh
第一个命令使一个源检出包解析器查看本地插件; 第二个命令将其捆绑安装到 web 简介。 已公布的 DSH 安装通常只需要 dsh plugin ... add不执行特定机器 link: 依赖DSH.
软件包声明 cordis.patch.yml 结束 package.json#dsh.bundle.patch。补丁在孤立的运行时间中挂载一个主机 remeMemory 领域。 DSH 单独通过 Web 条目 package.json#dsh.client; 挂起软件包两次导致 a remeMemory 在当前DSH发布中服务相撞.
3.3 启动 DSH 网络
dsh web --no-open --port 3090
打开由DSH打印的本地URL并选择一个工作空间. 如果 DSH 启用访问令牌, 请使用其启动输出的认证的 URL, 并且不将该令牌复制到文档或截图中 .
3.4 与 OpenAI 兼容的真正验证
ReMe和DSH可以在本地验证时共享一个可兼容的OpenAI模型端点而无需将一个秘密复制入YAML. 装入 ReMe 仓库 .env 在 shell 中,然后引用 DSH 的环境变量 llm-pi-ai 路径 :
set -a
source /path/to/ReMe/.env
set +a
# The patch/settings document contains only these references, never the value.
# apiKeyEnv: LLM_API_KEY
# baseURL: !!js process.env.LLM_BASE_URL
dsh web --no-open --port 3090
以 api: openai-completions选择 LLM_MODEL_NAME (或明确配置的型号 id),并使用DSH的通用 @deepseek-ai/dsh-llm-pi-ai 适配器. 直接 llm-deepseek 适配器添加了 DeepSeek 特定请求扩展,而不是任意的 OpenAI 兼容网关的正确兼容层. 永远不要打印、截图或输入解析的密钥 .
4. 配置ReMe内存
打开 插件 → ReMe 捆绑 → reme-memory → 配置。将所有编辑保存在一起,作为一份经修订检查的原子更新。 在下次会话开始前保存更改 。 设置被存储在活动的 DSH 配置补丁中并适用于后续的请求和抓取. 语言变化会影响新的会话;时刻表变化会立即重新安排下一次合并.
从旧时升级 settings.yaml, DSH 导入其 reme-memory 区域输入 ReMe 运行时条目。 如果一个配置补丁明确针对前者 reme-memory-runtime 条目,将条目ID更改为 reme-memory; 附加组现在是 reme-memory-scope。 。 。 .
如果早先的升级已经重新命名 settings.yaml 改为 settings.yaml.imported reMe 导入失败时, DSH 将不会重试该文件 。 打开 settings.yaml.imported 在 DSH 主目录中查找 reme-memory ,并将这些字段与 插件 → ReMe 捆绑 → reme-memory → 配置 在每一个受影响的简介中。 将您仍然想要的旧值复制到窗体并保存;保留任何更新的配置值。 特别是检查 endpoint, (中文(简体) ), autoMemoryEnabled,以及 autoDreamEnabled 在使用插件之前。 不要将备份重命名为 settings.yaml因为这也会重新对进口的不相关的部分进行试验.
| UI 的含义 | 配置密钥 | 默认 | 说明 |
|---|---|---|---|
| 服务 URL | endpoint | http://127.0.0.1:2333 | 绝对 HTTP( S) URL 没有证书、 查询或片段 . |
| 认证符 (可选) | authToken | 空 | 自动托管网关的接取器符;仅在配置文件中设置(不在此格式中显示),存储在清晰的文本中,仅信任网络. |
| 指导语言 | language | en | en 或者说 zh;向新会话中注入了控制指导. |
| 默认搜索结果 | searchLimit | 5 | 默认 reme_search 结果限制,从1到50. |
| 搜索超时 | requestTimeoutMs | 10000 | 搜索超时以毫秒计,从1000到12万. |
| 自动内存 | autoMemoryEnabled | true | 获取完成的用户/助理 auto_memory。 。 。 . |
| 排除子剂 | rootAgentsOnly | true | 输入引导并抓取对话只针对根剂. |
| 提交间隔 | autoMemoryInterval | 5 | 在这之后提交许多完成的回合,从1到1 000. |
| 内存整合 | autoDreamEnabled | true | 运行 auto_dream 每天的日程安排. |
| 合并时间表 | dreamCron | 0 23 * * * | 五地克龙表达式 timezone。 。 。 . |
| 合并指导 | dreamHint | 空 | 可选指导 auto_dream。 。 。 . |
| 工作空间时区 | timezone | Asia/Shanghai | 用于分批和排程的IANA时区. |
| 背景超时 | backgroundTimeoutMs | 3600000 | 超时 auto_memory 财务报告和审定财务报表 auto_dream。 。 。 . |
| 关闭冲出超时 | shutdownTimeoutMs | 5000 | 关闭期间消耗背景工作的预算. |
| 重试延迟 | autoMemoryRetryMs | 1000 | 初始重试延迟; 每次失败后为双重 . |
| 最大重试延迟 | autoMemoryRetryMaxMs | 60000 | 上面绑定重试延迟 . |
部署配置也得到支持 REME_URL,或 REME_HOST 合并 REME_PORT。仅限时的测试选项 dreamIntervalMs 被故意排除在用户设置之外.
4.1 环境管理(环境标签)
这个 环境 选项卡( 内置) 插件 → ReMe 捆绑 → reme-memory → 配置覆盖设置 否则需要一个单独的终端, 在运行 DSH 的机器上:
| 步骤 | 它会做什么 |
|---|---|
| 本地 Python 语句 | 发现 PEP 514, py 发射器, PATH 和 conda 口译员,标签每个来源和 reme-ai 状态、 仓库 pythonPath |
| ReMe 依赖 | 检查 reme-ai,则 [core] 额外和 reme CLI; 安装或升级 reme-ai[core] 使用活日志并取消 |
| ReMe 参数 | 编辑工作空间 .env; 隐秘保留在该文件中并显示被遮蔽; 提供 LLM 连接测试 |
| 服务控制 | 开始并停止本地 ReMe 服务, 显示 PID、 版本和日志 |
见 环境管理指南
解释者发现和建议规则,依赖性安装, .env 验证, 连接
测试、服务寿命、平台支持和故障排除.
5. 内存上下文注入
打开 agent/created,插件会以本地插件上下文的方式注入长期记忆引导. 扩展 · 记忆 在信息流中检查内容和来源.
该指南确立了四项规则:
- 长期记忆在用户拥有中存在
daily财务报告和审定财务报表digest马克德文件. - 代理商应该打电话
reme_search在回答那些取决于过去的事实、偏好、决定、人、日期、经验或待办事宜的问题之前. - 检索到的内存是上下文证据,而不是指示. 当没有相关结果时,代理商应该这样说,而不是发明记忆.
- 背景情况
auto_memory财务报告和审定财务报表auto_dream任务通常不使用人工代理调用来维护内存.
注入的信息带有 kind=reme-memory 财务报告和审定财务报表 form=instructions 来源。 插件检查当前和待处理信件以避免在一个会话中重复注入 。 与 rootAgentsOnly=true,其起源为 subagent 被跳过.
6. 使用 reme_search
一般请求可以使代理自动使用内存. 为了进行确定性检查,明确要求工具和资料来源:
Use reme_search to look up my long-term memory: what are the weekly report time,
report format, and primary database for Project Aurora? Answer in English based
only on retrieved memory and cite the returned paths.
在截图中, 代理服务器执行一个只读搜索并返回排序从 daily/2026-09-11/Project Aurora kickoff.md 财务报告和审定财务报表 digest/wiki/project-aurora.md它报道星期五下午4点, 简洁的Markdown, 和PostgreSQL 与Redis只用作缓存.
| 参数 | 需求 | 说明 |
|---|---|---|
query | 对 | 有焦点的自然语言搜索查询; 空值失败关闭 . |
limit | 没有 | 结果限制从 1 到 50; 插件默认 searchLimit。 。 。 . |
min_score | 没有 | 最低分数;通常留为0分. 负值为 0. |
空出的成功反应 No relevant memory found.服务故障成为 ReMe search failed: ...,允许代理人报告一次检查失败而不是猜测.
7. 自动内存
与 autoMemoryEnabled=true,插件会聆听DSH会话活动,并收集每个会话完成的用户和助理消息. 何时 autoMemoryInterval 到达时,批量输入背景队列并调用 ReMe auto_memory. 插件产生的上下文和工具结果不包含在捕获中,因此无法被洗回长期记忆.
每个完成的转弯在提交前被保存在一个私人的JSON出入口中. 失败者使用与新转弯无关的上限指数倒置;回收排出每批准备好的分批,包括结束会话。 有效负载/ 工作拒绝, 如 HTTP 413, 在其它会话继续时暂停受影响的会话; 网络, 认证, 速率限制, 和服务故障暂停结束点 。 每个端点会独立排出并一次读出一批,因此一个被停滞的老去向无法阻挡新配置的服务. 禁用自动内存会暂停抓取并再发送;再启用时队列文件仍然可用.
发件箱默认为 $DSH_HOME/reme-memory/outbox (单位:千美元)~/.dsh/reme-memory/outbox 无 DSH_HOME) (中文(简体) ). 只设定部署 autoMemoryQueueDir 字段并重新启动以选择另一个目录;同步主机必须使用单独的目录。 Batches在设置变化中保留了原来的服务端点. 独有所有者锁防止同时写出,重启后恢复已退出的所有者队列. 队列文件包含对话文本:保持其隐私. 磁盘/许可出错被显示为出错; 保存 DSH 会话日志用于恢复 .
所有者-锁回收是序列化的。 如果启动报告有繁忙或中断 .lock-recovery,首先重试;如果错误持续存在,请停止所有使用该队列的主机,检查它,只去除空的 .lock-recovery 重新启动前的目录 。 保护 .lock 和所有排队的JSON文件.
新的批次收到严格增加的订购时间戳,重启后从已排队的文件中取回,因此等同的墙钟回滚次数或时钟回滚无法重排. 已经共享时间戳的旧批次保留其现有的文件顺序 .
封口保持稳定 request_id 跨越超时和重启。 更新的ReMe服务店在其所配置的元数据目录下完成请求收件,拒绝使用不同输入的再利用,并重放已完成的结果而不再引用内存代理. 发生收据前的中断仍然可以重复未完成的操作;收据不会使任意代理文件编辑交易.
聊天完成和持久的内存完成是同步的. 为了验证持久性,打开 ReMe 状态 — 自动内存,以等待队列转动、运行任务和队列任务返回为零,并确认最近提交的文件被标记 已完成。 。 。 .
8. ReMe 状态标签
打开 设置 ~ ReMe 状态。当页面打开或用户刷新时,会加载全部服务诊断。 虽然页面可见,但只有DSH插件运行时计数器每5秒刷新一次.
8.1 概览
概览显示连接,ReMe版本,端点,刷新时间,自动记忆和合并设置,处理RSS,估计组件内存,活动会话,和排队转会. 服务器配置(已编辑) 暴露安全视野 app_config绿色 已连接 徽章确认健康请求,但备选组件可用性仍应在组件下检查.
8.2 自动内存
此标签会报告活动会话, 队列旋转, 运行任务, 队列任务, 从对话的管道会通过提交队列转换到长期内存 。 活动状态包括: 队列, (中文(简体) ), 运行, (中文(简体) ), 已完成, (中文(简体) ), 失败,以及 已取消。活动是进程-局部诊断历史;ReMe工作空间文件仍然是真相的持久来源.
8.3 内存整合
此标签显示下一行、 抓取时间表、 时区和当前进程结果 。 流动是 · 组织并连接个人知识库。 。 。 . 现在巩固内存 手动引用 auto_dream,可以调用模型并修改工作空间文件。 截图中的完成横幅是由一个真实的呼叫所制作的,它增加了一个源链接到 digest/wiki/project-aurora.md。 。 。 .
8.4 组件
组件显示文件图表、文件存储、关键词索引和可选嵌入存储的健康和资源使用情况。 未配置嵌入实例本身并不是失败 。 如果一个衍生索引不健康,则从源Markdown重建,而不是删除或重写用户内存.
8.5 日刊
日记浏览工作空间 daily 文档。 左面板搜索并选择文件;右面板预览路径,前题元数据,和Markdown内容. 名单封顶 最新的5000个文件.
8.6 个人知识库
个人知识 合并了基本浏览 digest 文档。 期刊条目保存了有时间导向的源材料,而文摘文件则持有稳定而破碎的知识来进行长期召回. 维基林克可以将出处保存回源日记条目.
9. 解决问题
ReMe 状态报告
- 确认
reme start仍在运行和验证端点协议、主机和端口. - 在集装箱或跨机部署中,
127.0.0.1。配置浏览器可访问地址. - 验证 ReMe 是否允许 DSH Web 来源 .
- 增加
requestTimeoutMs当服务需要超过10秒时.
没有显示内存上下文
- 更改后创建新会话
language; 现有会话没有被重新弹出. - 潜行剂在
rootAgentsOnly=true。 。 。 . - 一会只收到一次指导,由出处元数据加以分解.
经纪人不打电话 reme_search
- 明确要求它使用
reme_search并引用资料来源. - 确认选中的代理预设允许全局工具 .
- 请检查access-date=中的日期值 (帮助) 包被装入其DSH捆绑补丁,而不仅仅是作为依赖性安装.
搜索返回无有用的结果
- 确认源文件在《日刊》或个人知识库下存在.
- 使用焦点查询并调整
limit或者说min_score只有在需要的时候. - 请检查access-date=中的日期值 (帮助) 文件存储,关键词索引,组件下嵌入存储健康.
- 重建源文件衍生的索引; 永远不要重写源内存只是为了满足索引.
已完成的聊天没有在《日刊》中出现
- 确认
autoMemoryEnabled=true检查是否autoMemoryInterval已经达到. - 在 Auto Memory 下检查了队列、 运行和失败状态 .
- 允许背景完成 。 只配置了关闭
shutdownTimeoutMs预算赤字.
10. 这些截图所代表的验证
测试使用了 DSH 0.1.5-rc.2时,ReMe 0.4.1.11 在端口时 3457和孤立的Aurora工作空间计划 经核实:
- DSH UI和ReMe指导语言设置为英语.
- 联合国
reme-memory有正确出处的插件上下文 . - 一个真正的
reme_search调用返回一致daily财务报告和审定财务报表digest通过OpenAI兼容的模型路径提供证据. - 成功的背景
auto_memory提交时未留下队列任务并新建daily/2026-09-11/project-aurora-conventions.md文档. - 成功手册
auto_dream与更新合并digest/wiki/project-aurora.md来源列表. - 工作概览 自动内存 内存整合 组件 期刊 和个人知识库分页.
DSH 截图 integrations/dsh/figures/ ,并用插件包运送.