dsh-plugins

已归档 — 实验原型,不再维护。

这三个插件(记忆、技能创作、技能策展)是把 hermes-agent 机制移植到 DeepSeek Harness 的研究练习。它们能工作,但研究结论是它们没有实用价值:DeepSeek Harness 刻意将会话状态保留在会话日志中,并把技能视为用户手写、经审核的输入;官方仓库不接受外部 PR,并多次以 书面形式明确选择不构建这些机制。代码保留供参考,不再规划任何后续维护。

English | 中文

面向 DeepSeek Harness 的生态插件仓库,移植 NousResearch/hermes-agent 最重要的两个机制:有界跨会话记忆系统与技能生命周期策展。

包	作用
@hyls9527/dsh-memory	有界、文件持久化的 MEMORY.md / USER.md 记忆:§ 分隔条目 + 字符上限、每会话注入冻结快照、一个 memory 工具(add / replace / remove / batch)、周期性持久化提醒、带漂移防护的原子写入。
@hyls9527/dsh-skill-create	技能创作:skill_create 工具把可复用流程固化成用户技能(create / update),外加创作提醒——自我改进闭环缺失的那一半。
@hyls9527/dsh-skill-curator	skill 工具使用自动追踪 + skill_curator 工具:查看使用与过时状态、归档不用的技能、恢复技能。

三者合起来正是 hermes-agent 闻名的那条完整学习闭环:记住(memory)→ 创作(skill-create)→ 追踪与策展(skill-curator)。

两个包都是可安装的 dsh bundle,已针对 DeepSeek Harness 0.1.0-rc 验证,单包测试覆盖率 100%。

安装

dsh plugin --profile web add @hyls9527/dsh-memory
dsh plugin --profile web add @hyls9527/dsh-skill-create
dsh plugin --profile web add @hyls9527/dsh-skill-curator

或从本仓库安装:

dsh plugin --profile web add ./packages/memory
dsh plugin --profile web add ./packages/skill-create
dsh plugin --profile web add ./packages/skill-curator

dsh plugin 会把每个包加进 profile 的 dsh.profile.bundles,由各 bundle 的 patch 插入插件行。需要定制时,在 profile 自己的 cordis.patch.yml 中按 id 覆盖:

- id: memory
  config:
    memoryCharLimit: 4000
    nudgeInterval: 0

完整自包含的覆盖层示例见 examples/cordis.yml。

实现原则

两个插件都遵循 harness 自己的约定,而不是另起炉灶:

• 一切皆插件行。 每个包都是 dsh bundle,由 cordis.patch.yml 插入一行;不改动其他任何东西。
• 模型可见 ⟺ 有日志。 记忆快照以携带 memory source 的持久 user/message 传递,可从会话日志重建——不发明新会话事件词表(仓库外插件目前无法注册)。工具调用与结果由 harness 自身记录。
• 前缀稳定的提示词。 快照在会话开始时记录一次,会话中途的写入不触碰它,提供商 KV 缓存整会话有效。
• 一个能力、三种角色装在一个包里(存储服务 + 文件提供方 + 面向模型的工具),与 dsh-llm 相同。
• 防护优先于猜测。 "存在但读不出来"的文件绝不当作空文件;外部编辑的内容先快照到 .bak.<时间戳> 再拒绝写入;每次提交都是跨进程锁下的原子重命名——这些 hermes-agent 不变量正是记忆系统可信赖的来源。

开发

pnpm install
pnpm typecheck
pnpm test           # vitest,各包 100% 覆盖率
pnpm build

Node ^22.19 || >=24,与 harness 的 engines 范围一致。

License

MIT