reme-dsh-plugin 的十四个配置项,默认值都来自哪里
@agentscope-ai/reme-dsh-plugin的用户设置一共 14 项。默认值不是随手填的,每一项背后都有一个「为什么是这个数」的理由,理解了它就知道哪些该改、哪些别动。想先看同类插件清单与安装形态,见 完整插件清单与汉化避坑指南。
一、端点与超时:三件事决定「连不连得上」
| 键 | 默认 | 边界 | 为什么要改 |
|---|---|---|---|
endpoint | http://127.0.0.1:2333 | 必须是 http 或 https 绝对地址 | 服务端口不是 2333 时必改 |
requestTimeoutMs | 10000 | 1000–120000 | 检索偶尔超时再往上调 |
backgroundTimeoutMs | 3600000 | — | 采集/整合的长任务预算,一小时 |
endpoint是唯一「不改就一定错」的项——只要你起服务时用了service.port=3457这类非默认端口,插件里就必须填同一个值。它同时支持部署级覆盖:REME_URL,或REME_HOST+REME_PORT两个变量。
requestTimeoutMs默认给 10 秒,是一个偏保守的值:正常 BM25 检索是毫秒级,10 秒已经覆盖了向量检索加网络抖动。真需要调的场景只有一种——服务在跨机的远端、链路 RTT 很高。插件文档明确说「服务确实需要超过十秒」时才调。
backgroundTimeoutMs一小时,是给auto_memory与auto_dream的。整合要调模型、要写文件,一小时是兜底而不是预期耗时。
二、采集与会话范围:谁被记录、记多少
| 键 | 默认 | 边界 | 说明 |
|---|---|---|---|
autoMemoryEnabled | true | 布尔 | 关掉就完全不采集 |
autoMemoryInterval | 5 | 1–1000 轮 | 攒够几轮才提交一次 |
rootAgentsOnly | true | 布尔 | 只处理根 Agent |
shutdownTimeoutMs | 5000 | — | 退出时排空后台工作的预算 |
autoMemoryInterval是这一组里最值得理解的。它决定「批量提交」的粒度:默认 5 轮提交一次。调成 1,每轮都提交,实时性好但请求数涨五倍;调成 20,请求少但一次失败丢的上下文更多。默认 5 是在请求数与丢失面之间取的折中,个人使用没必要动。
rootAgentsOnly默认true有明确原因:子代理的对话往往是大段的工具调用与中间推理,写进长期记忆价值低、噪音大。所以默认只处理根 Agent 的会话——这也解释了为什么开了子代理之后,记忆里看不到子代理干了什么。
shutdownTimeoutMs只有 5 秒。它意味着退出时最多等 5 秒,没提交完的批次就丢了。如果你经常在长对话后立刻关进程,把autoMemoryInterval调小比调这个更有效。
三、整合日程与时区:一天只该跑一次
| 键 | 默认 | 说明 |
|---|---|---|
autoDreamEnabled | true | 是否由插件调度每日整合 |
dreamCron | 0 23 * * * | 五段 cron,按timezone解释 |
timezone | Asia/Shanghai | 批次与调度的时区 |
dreamHint | 空 | 传给auto_dream的可选指引 |
dreamCron默认 23 点,理由是「当天内容基本写完了,但人还没睡」。它不是越晚越好——如果你习惯凌晨工作,23 点跑的整合会漏掉后半段,改成0 4 * * *更合适。
timezone默认Asia/Shanghai,这一项最容易出事:人在别的时区、或者服务器是 UTC,0 23就会在你以为是深夜的时候跑。跨时区使用请先改这一项,再谈 cron。
dreamHint是唯一一个「默认空着是对的」的项。它会把额外指引传给整合流程;不填,整合就按默认规则提取最多五个可复用单元。填之前想清楚你要它偏向什么——写「只提取可复用的操作步骤」这类明确指令有效,写「认真整理」这种没有约束力。
四、语言与检索默认值:只影响新会话
| 键 | 默认 | 边界 | 说明 |
|---|---|---|---|
language | en | en/zh | 注入指引的语言 |
searchLimit | 5 | 1–50 | reme_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 自动整理,数据来源于插件详情页。