前言¶

在 DSH 插件式工作流里，很多能力可以挂载到 dsh，但使用者还需要一个稳定的入口来查看当前条目、追踪 refinement 历史、回滚已经提交的变更，并审计 auto-gate 决定。

dsh-refine 提供这样一个入口：它把 refinement 相关操作整理成 /refine 命令和设置面板。它驱动 dsh-continual-harness 引擎；引擎未挂载时，操作会退化为可执行的设置指引，而不是直接报错。

这是什么¶

dsh-refine 是 DeepSeek Harness（dsh）的一个 refinement UX layer，维护者是 dushaobindoudou，许可证为 MIT。

根据已提供资料，package.json 中：

"name": "dsh-refine",
"version": "1.0.3"

并声明：

"dsh": {
  "client": {
    "platform": "web"
  }
}

README 说明，该项目是对 prime-agent 的 /refine 思路在 dsh 生态中的移植和实际适配。

核心功能¶

下面按使用者能直接操作的部分介绍。

/refine 命令¶

/refine 支持状态查看、条目列表、历史记录、回滚和自由文本 refinement 指令。

常用形式包括：

/refine status

查看引擎与回滚状态。

/refine list [kind]

列出当前 entries，可按 prompt、memory、skill、subagent 过滤。

/refine history [n]

查看最近 refinement 历史，默认 10 条，最大 50 条。

/refine rollback <id>

回滚一个已提交的 refinement，id 来自历史记录。

/refine <any text>

用自由文本触发一次引擎 refinement。命令会立即返回，结果稍后出现在设置面板或 /refine history 中。

设置面板¶

进入设置面板中的 Refine Harness 后，可以做这些事：

• 浏览 entries
• 查看 harness timeline
• 一键 rollback
• 审计 auto-gate decisions

会话历史兼容¶

引擎写入的 harness/refinement session events 会注册到宿主 reader 中，使相关 session log 保持可加载。

引擎可选¶

dsh-continual-harness 引擎在运行时是可选的。

没有引擎时，插件会给出可执行的设置指引；不会报错，也不会污染会话。

但要真正触发 refinements，需要挂载引擎。

安装与启用¶

先检查环境。资料显示要求如下：

• Node.js ≥ 18
• dsh 0.1.0-rc.6+，并带有 @deepseek-ai/dsh-home-paths 和 @deepseek-ai/dsh-typert-protocol

然后在 dsh profile 的 plugins 配置中挂载插件：

plugins:
  - dsh-continual-harness   # 引擎，运行时可选，但触发 refinement 需要
  - dsh-refine              # 本 UX layer，必需

经过上面的步骤后，重启 dsh web 使宿主侧变更生效。

如果正在运行：

pnpm run dev:web

客户端面板变更会热加载。

典型用法¶

查看状态¶

/refine status

用于查看当前引擎和回滚状态。

列出 entries¶

/refine list prompt

按 prompt 过滤。

/refine list memory

按 memory 过滤。

/refine list skill

按 skill 过滤。

/refine list subagent

按 subagent 过滤。

也可以直接使用：

/refine list [kind]

查看历史¶

/refine history

查看最近 10 条 refinement 历史。

/refine history 20

查看最近 20 条。

最大可查 50 条：

/refine history 50

回滚¶

先通过历史记录取得 id：

/refine history

再回滚指定条目：

/refine rollback <id>

触发 refinement¶

输入一条自由文本指令：

/refine 优化当前 prompt 的边界条件说明

命令会立即返回。结果稍后出现在设置面板或：

/refine history

中。

使用设置面板¶

进入：

Settings → Refine Harness

可以浏览 entries、查看 history timeline、一键回滚，并审计 auto-gate 决定。

适用场景与注意¶

dsh-refine 适合需要在 dsh 中使用 refinement 能力的场景，尤其是需要查看当前 entries、追踪 refinement 历史、回滚已提交变更、审计 auto-gate 决定的人。

注意以下几点：

1. 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。
2. dsh-continual-harness 引擎运行时可选，但要触发 refinement 需要挂载。
3. 没有引擎时，插件给出可执行指引，不报错，不污染会话。
4. dsh-refine 是独立社区目录中的插件项目，与 DeepSeek / 幻方无官方从属关系，不应视为官方应用商店。
5. 资料中只列出了 npm 版本、npm downloads、CI 等徽章链接，未给出具体数值，本文不引用这些数值。

相关链接¶

• 目录页：https://www.skillhub.cn/plugins/dushaobindoudou/dsh-refine
• GitHub：https://github.com/dushaobindoudou/dsh-refine
• Repository：git+https://github.com/dushaobindoudou/dsh-refine.git