前言¶

在 DSH Web 裏，開發者經常需要確認當前普通會話能調用哪些 skill，以及每個 skill 的說明字段。已有做法不一定在 Web 設置面板中提供這樣的只讀列表。

@winterchenhuan/dsh-skills-viewer 爲 DeepSeek Harness Web 增加一個只讀的 Skills 設置頁。它通過 skill.list wire RPC 獲取當前普通會話可調用 skill 目錄，並以只讀列表渲染。該插件不提供 skill body 預覽。

DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

• 包名：@winterchenhuan/dsh-skills-viewer
• 維護者：winterhuan
• 許可證：MIT
• 定位：Read-only Skills settings page plugin for DeepSeek Harness Web

它解決的問題是：在 Web GUI 的 Settings 面板中查看當前普通會話可用的 skill 列表，並對照 description 和 whenToUse。

核心功能¶

1、在 Settings 面板註冊名爲 Skills 的設置頁。

2、通過 skill.list wire RPC 獲取當前普通會話可調用 skill 目錄。

3、以只讀列表渲染 skill 信息，列表按 skill 名稱字母排序。

4、skill 行顯示：

• name
• model: off 徽章
• description
• whenToUse

5、搜索框可按 name、description 或 whenToUse 過濾。

6、會話變化時重新獲取；無當前會話或導航指向 subagent 時顯示空狀態。

7、純 UI 插件：節點端 apply 爲空；瀏覽器端通過 dsh.client 注入 slots、locale 和 connection。

8、註冊 settings.section 列表項，id 爲 skills，order: 90。

9、聲明 dsh.bundle；dsh plugin add 會自動插入 skills-viewer 配置行。

10、聲明 dsh.client；Web host 可從 lib/client.js 提供預構建瀏覽器 bundle。

安裝與啓用¶

安裝命令要求 dsh 和 pnpm 都在 PATH 上。dsh plugin 會原樣轉發參數給 pnpm。

dsh plugin --profile web add -w @winterchenhuan/dsh-skills-viewer
dsh web --dump-config     # verify the skills-viewer layer is present
dsh web                   # boot the Web GUI

第一條把包安裝進 Web profile；第二條確認配置中存在 skills-viewer 層；第三條啓動 Web GUI。

-w / --workspace-root 是必需的，因爲 Web profile 目錄是 pnpm workspace root。包聲明瞭 dsh.bundle，所以 dsh plugin add 會自動插入 skills-viewer 行；不要手動編輯 profile 的 cordis.patch.yml。

如果是本地目錄：

dsh plugin --profile web add -w /path/to/dsh-skills-viewer

移除：

dsh plugin --profile web remove @winterchenhuan/dsh-skills-viewer

典型用法¶

開發或驗證本地構建時，可以運行：

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

這些命令分別用於安裝依賴、類型檢查、運行測試和構建。

在 Web 設置頁中使用時：

1、進入 Settings 面板。

2、打開 Skills 頁。

3、查看當前普通會話的 skill 列表。

4、用搜索框按 name、description 或 whenToUse 過濾。

適用場景與注意¶

適合：

• 想以只讀方式查看當前普通會話可調用 skill 的 DSH Web 用戶。
• 需要在 Web 設置頁中快速對照 description 和 whenToUse 的場景。
• 不依賴手動刷新按鈕、不要求 skill body 預覽的工作流。

注意：

• 該頁面不提供 skill body 預覽。
• 沒有手動刷新按鈕，也沒有 skills/change 訂閱。
• 列表按當前會話獲取；當前導航指向 subagent 時顯示空狀態。
• 分離會話會短暫重試，然後顯示 retry action，而不是原始 session-not-found 診斷。
• 安裝前應按當前 dsh 進程權限檢查源碼與 MIT 許可證。

鏈接¶

• 社區目錄：檢索 @winterchenhuan/dsh-skills-viewer
• GitHub：https://github.com/winterhuan/dsh-skills-viewer