ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

reme-dsh-plugin 的十四个配置项,默认值都来自哪里

reme-dsh-plugin 的十四个配置项,默认值都来自哪里

reme-dsh-plugin 的十四个配置项,默认值都来自哪里

@agentscope-ai/reme-dsh-plugin的用户设置一共 14 项。默认值不是随手填的,每一项背后都有一个「为什么是这个数」的理由,理解了它就知道哪些该改、哪些别动。想先看同类插件清单与安装形态,见 完整插件清单与汉化避坑指南。

一、端点与超时:三件事决定「连不连得上」

键默认边界为什么要改
endpointhttp://127.0.0.1:2333必须是 http 或 https 绝对地址服务端口不是 2333 时必改
requestTimeoutMs100001000–120000检索偶尔超时再往上调
backgroundTimeoutMs3600000—采集/整合的长任务预算,一小时

endpoint是唯一「不改就一定错」的项——只要你起服务时用了service.port=3457这类非默认端口,插件里就必须填同一个值。它同时支持部署级覆盖:REME_URL,或REME_HOST+REME_PORT两个变量。

requestTimeoutMs默认给 10 秒,是一个偏保守的值:正常 BM25 检索是毫秒级,10 秒已经覆盖了向量检索加网络抖动。真需要调的场景只有一种——服务在跨机的远端、链路 RTT 很高。插件文档明确说「服务确实需要超过十秒」时才调。

backgroundTimeoutMs一小时,是给auto_memory与auto_dream的。整合要调模型、要写文件,一小时是兜底而不是预期耗时。

二、采集与会话范围:谁被记录、记多少

键默认边界说明
autoMemoryEnabledtrue布尔关掉就完全不采集
autoMemoryInterval51–1000 轮攒够几轮才提交一次
rootAgentsOnlytrue布尔只处理根 Agent
shutdownTimeoutMs5000—退出时排空后台工作的预算

autoMemoryInterval是这一组里最值得理解的。它决定「批量提交」的粒度:默认 5 轮提交一次。调成 1,每轮都提交,实时性好但请求数涨五倍;调成 20,请求少但一次失败丢的上下文更多。默认 5 是在请求数与丢失面之间取的折中,个人使用没必要动。

rootAgentsOnly默认true有明确原因:子代理的对话往往是大段的工具调用与中间推理,写进长期记忆价值低、噪音大。所以默认只处理根 Agent 的会话——这也解释了为什么开了子代理之后,记忆里看不到子代理干了什么。

shutdownTimeoutMs只有 5 秒。它意味着退出时最多等 5 秒,没提交完的批次就丢了。如果你经常在长对话后立刻关进程,把autoMemoryInterval调小比调这个更有效。

三、整合日程与时区:一天只该跑一次

键默认说明
autoDreamEnabledtrue是否由插件调度每日整合
dreamCron0 23 * * *五段 cron,按timezone解释
timezoneAsia/Shanghai批次与调度的时区
dreamHint空传给auto_dream的可选指引

dreamCron默认 23 点,理由是「当天内容基本写完了,但人还没睡」。它不是越晚越好——如果你习惯凌晨工作,23 点跑的整合会漏掉后半段,改成0 4 * * *更合适。

timezone默认Asia/Shanghai,这一项最容易出事:人在别的时区、或者服务器是 UTC,0 23就会在你以为是深夜的时候跑。跨时区使用请先改这一项,再谈 cron。

dreamHint是唯一一个「默认空着是对的」的项。它会把额外指引传给整合流程;不填,整合就按默认规则提取最多五个可复用单元。填之前想清楚你要它偏向什么——写「只提取可复用的操作步骤」这类明确指令有效,写「认真整理」这种没有约束力。

四、语言与检索默认值:只影响新会话

键默认边界说明
languageenen/zh注入指引的语言
searchLimit51–50reme_search默认返回条数

language默认英文,因为插件的注入文本本身以英文维护。改成zh只影响注入给 Agent 的指引,不影响工作区里的记忆内容,也不影响检索。改完要新开会话才生效——指引在会话创建时注入一次。

searchLimit默认 5,上限 50。这个值直接影响上下文占用:5 条约几百字,50 条可能上千字。先留 5,只有在明确知道「一条命中不够、需要多来源交叉」时才往上调。

五、不在用户设置里的那一个

插件文档特别说明:dreamIntervalMs是只给定时器测试用的选项,故意不放进用户设置。这算是设计上的自律——测试用的开关不暴露给使用者,避免被当成「更精细的调度控制」。

六、按场景改哪几项

  • 换端口或跨机:只改endpoint(或部署级REME_URL)。
  • 不在东八区:改timezone,必要时调dreamCron。
  • 想让记忆更实时:改autoMemoryInterval,别去动超时。
  • 想省模型额度:autoMemoryInterval调大、dreamCron保持一天一次、searchLimit保持 5。
  • 想让子代理也进记忆:把rootAgentsOnly设为false,同时接受噪音上升。

总结

14 个配置项里真正需要动的通常不超过三个:端点、时区、采集粒度。其余默认值是为「个人知识库、一天一次整合」这个场景定的,改了多半是在给自己的用法做适配。更多 DSH 插件的中文说明见 完整插件清单与汉化避坑指南。

适合与不适合

适合:已经装好插件、想按自己作息调整整合时间的人;跨时区或跨机部署需要改端点的人;想控制模型额度消耗的人。

不适合:还没跑通「写入 → 检索」最小链路就想调参数的人;希望插件自带一个「智能模式」自动调参的人;不愿读默认值含义、只想要推荐配置的人。

标签:ReMe、DeepSeek Harness、配置、默认值、dreamCron

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进