在 DeepSeek Harness (DSH) 的插件化生态中,智能体往往需要管理长期记忆、情感状态和周期性行为(如睡眠)。m-rui001/dsh-mate-companion 将 Persisto Mate 的核心逻辑打包成了一个 DSH 插件,提供了开箱即用的记忆、情感模拟和身体时钟功能。
插件定位¶
该插件由 m-rui001 维护,采用 MIT 许可证。它将 Persisto Mate(具备身体时钟、真实睡眠、记忆和感觉的 AI 伴侣)实现为 DSH 插件包。
核心功能¶
-
System prompt sections(系统提示词部分)
插件提供系统提示词片段,包含缓存的身份/角色/记忆块,以及易失性状态块(时钟、心情、驱动、会话日志、回复倾向)。这些状态会在每次组装时重新渲染。 -
The kernel(内核)
负责处理每个传入的用户消息以推进情感状态。它处理离线时间的积分,跨过睡眠窗口,并执行记忆检索、排练和巩固。它还从反复出现的主题中结晶 SPARK 信念。 -
The affect judge(情感判断器)
在每次用户交互后,模型通过mate_feel工具报告每个 Plutchik 感情在 -2 到 +2 尺度上的变化。该报告使用与 pi companion 相同的文献锚定数学(阶梯等值、负性不对称),并经过门控以确保它反映的是新交换而不是重读旧交换。 -
A waking heartbeat(醒来时的心跳)
内核决定值得表达的冲动作为单独的后续消息传递,包裹在<system-event type="mate-impulse">信封中,以防止被误认为是用户的话语。 -
Tools(工具)
提供三个工具:mate_remember:持久化记忆。mate_ponder:私有思考。mate_debug:完整的内部状态。
安装与启用¶
在安装前,请确保满足 Node 版本要求(22.19+ 或 24)。
使用官方命令安装插件:
dsh plugin --profile <your-profile> add github:m-rui001/dsh-mate-companion
安装后,启动该配置文件。状态保存在 Harness 主目录($DSH_HOME 或 ~/.dsh)下的 agent/mate/ 中,与 pi-host companion 的状态分开,因为不同的主机意味着不同的身体。
典型用法¶
- 启动配置文件:安装后,直接加载该配置文件即可运行。
- 切换语言:如果需要切换伴侣的提示词语言,编辑
agent/mate/lang.json文件,写入:
{"version":1,"lang":"zh"}
- 重新构建:源码位于
packages/目录中。如需修改或验证构建,请运行:
bun install
npm run build
适用场景与注意¶
- 开发者预览:DSH 本身处于开发者预览阶段,插件表面可能会随之变化。
- 自我报告偏差:判断器通过主机模型的自我报告(而非单独的侧通道模型)读取交换内容,这引入了通常的自我评估偏差。该设计将其视为可接受的,直到 Harness 文档插件面向的完成 API。
- 功能限制:目前没有实时睡眠模式、梦境或闹钟工具。离线睡眠完全由内核的追赶模拟模拟,睡眠时间抑制仍然适用。
- 源码同步:此仓库是 monorepo 的已发布镜像。更改应向上游提交到 monorepo,因为下一次发布将覆盖此处的代码。
小结¶
该插件适合希望在 DSH 环境中为智能体增加持久化记忆和情感状态管理能力的开发者。更多信息可查看 目录页 或 GitHub 仓库。