前言¶
DeepSeek Harness (DSH) 提供了基础的智能体循环、工具调用和模型路由,但在自适应智能层(如持久化记忆、可复用技能、RL 轨迹收集)上仍显不足。传统的实现方式往往依赖 Python 或额外的 Hermes 安装,增加了环境复杂度和进程开销。
dsh-hermes-bridge 插件将 Hermes 的自适应智能层直接以原生 JavaScript 实现集成到 DSH 中。它不需要 Python 依赖,也不通过子进程通信,而是通过共享内存和文件系统直接与 DSH 交互。
核心功能¶
插件提供了以下能力:
* 持久化记忆:通过 hermes_memory 生成 MEMORY.md 和 USER.md,配合冻结的系统提示词快照。
* 可复用技能:提供 SKILL.md 目录管理,支持技能列表查看、详情查看和管理。
* 技能编写:通过 /hermes-learn 命令进行技能的编写和更新。
* 轨迹采集与压缩:通过 hermes_trajectory_save 捕获对话轨迹,并通过 hermes_trajectory_compress 在 Token 预算内压缩轨迹(保护首尾回合),用于生成 SFT/DPO 数据。
* 诊断工具:通过 hermes_status 检查能力状态。
* 可选增强:支持后台记忆/技能审查(backgroundReview)和策展人(curator)功能。
安装与配置¶
在终端执行以下命令安装插件:
dsh plugin --profile web add github:aalvsz/dsh-hermes-bridge
安装后,需要在 profile 的 cordis.patch.yml 中覆盖该包的配置。默认配置如下:
- id: dsh/hermes-bridge
config:
enabled: true
namespace: hermes
backgroundReview: false
curator: false
memoryCharLimit: 2200
userCharLimit: 1375
memoryNudgeInterval: 10
skillNudgeInterval: 10
saveTrajectories: false
model: null
trajectoryTargetMaxTokens: 15250
trajectorySummaryTargetTokens: 750
典型用法¶
- 轨迹压缩:当开启
saveTrajectories: true后,对话结束时会自动生成 ShareGPT 格式的轨迹文件。使用hermes_trajectory_compress可以在保持对话首尾回合(System、Human、Assistant 工具调用对)完整性的前提下,压缩中间回合以节省 Token。 - 技能管理:使用
hermes_skills_list查看技能库,使用hermes_skill_view查看具体技能内容,使用hermes_skill_manage进行管理操作。 - 开发验证:插件包含标准的 Node.js 测试脚本,可在本地运行
npm test或npm run verify进行验证。
注意事项¶
- 版本要求:需要 Node.js 版本
^22.19.0或>=24.0.0。 - 默认状态:
backgroundReview、curator和saveTrajectories默认关闭,需在配置中显式开启。 - 文件权限:生成的记忆和技能文件权限为
0600,目录权限为0700。 - 命名空间:所有工具均以
hermes_为前缀命名,以避免与 DSH 原生工具冲突。 - 无 Python 依赖:这是一个 v0.2.0 的纯 JavaScript 原生重写版本,不再依赖 Python 或 Hermes。
总结¶
该插件填补了 DSH 在自适应智能和 RL 数据生成上的空白。对于需要构建高复杂度 Agent、管理长期记忆或需要生成微调数据的开发者,这是一个无需引入额外 Python 环境的轻量级解决方案。