前言¶

在 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