前言¶
使用 DSH Web 客戶端時，API 餘額、Token、成本估算、上下文狀態、推理強度和圖片轉述等信息往往分散在不同入口，需要頻繁切換界面才能查看。
widget-dock 是一個 DeepSeek Harness（dsh）客戶端插件：在對話兩側空白區提供網格對齊的卡片工作臺，把餘額、Token、成本、上下文、熱度圖、GitHub、推理強度、圖片轉述等 27 張卡片集中到對話旁邊。
這是什麼¶
MorGogh/widget-dock 當前爲 Web 客戶端插件（dsh.client，platform: web），許可證爲 MIT。
它解決的問題是：把 DSH 對話中常用但零散的指標、任務狀態和圖片處理入口，收納成可按會話定製的側邊卡片區。
核心功能¶
網格對齊的卡片工作臺¶
卡片按 S/M·L/XL 尺寸檔位跨列，任意組合的行都嚴格列對齊。
每對話獨立佈局，切換會話各自記住卡片組合、尺寸、位置。
27 張內置卡片¶
內置卡片覆蓋餘額、Token、成本估算、上下文狀態、會話統計、目標進度、推理強度、圖片轉述、快捷命令等。
添加與排序¶
添加面板支持搜索、分類標籤、拖到任意位置添加、尺寸/換側快捷操作。
隨時按住卡片頭部（⠿）拖動排序或跨側換位，無需進入排序模式。
推理強度¶
推理強度卡可拖動滑軌切換 reasoningEffort，並內置模型選擇框。
圖片轉述¶
圖片轉述卡將貼圖自動轉視覺模型，生成文字描述注入輸入框。
默認接本地 LM Studio（http://localhost:1234，qwen3.5-9b-mlx），也可配置任意 OpenAI 兼容端點。
成本估算¶
成本估算按 DeepSeek 官方峯谷價計算，支持 flash/pro 切換和手動調價。
估算值帶 ≈ 標註；默認按 deepseek-v4-flash 官方高峯價，可切 v4-pro 或手動調價。
用量熱力圖¶
用量熱力圖按 GitHub 風格展示 13 周每日用量。
持久化¶
佈局、配置按會話存入 localStorage，重啓保留；切換對話各自獨立。
安裝與啓用¶
先使用 DSH 插件命令安裝：
dsh plugin --profile web add widget-dock
然後啓動或重啓 Web 客戶端：
dsh web
重啓後，對話兩側出現工作臺；空間不足時會縮成貼邊標籤「工作臺」。
如果不想通過插件命令安裝，也可以手動鏈接倉庫目錄。在已獲取的 widget-dock 倉庫根目錄執行：
mkdir -p ~/.dsh/profiles/web/node_modules
ln -sfn "$(pwd)" ~/.dsh/profiles/web/node_modules/widget-dock
在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
- insert:
- id: widget-dock
name: "widget-dock"
最後運行：
dsh web
典型用法¶
1、點擊工作臺底部「＋ 添加」打開側欄，搜索或按分類找卡片，點擊快速添加，或拖到工作臺任意位置。
2、需要調整順序時，按住卡片頭部（⠿）拖動排序或跨側換位。
3、餘額卡首次使用時點「KEY 編輯」填入 DeepSeek API Key，然後刷新。該組件不內置密鑰；API Key 填入後存 localStorage，僅本機。
4、圖片轉述可在輸入框直接貼圖，或在卡片裏選圖；自動轉視覺模型後，描述附到輸入框下方。
5、成本估算可按 DeepSeek 官方峯谷價計算，支持 flash/pro 切換和手動調價；估算值帶 ≈ 標註。
適用場景與注意¶
適合需要在 Web 客戶端對話旁常駐查看餘額、Token、成本、上下文、目標進度、推理強度等狀態的用戶。
注意：
- 當前爲 Web 客戶端插件（
dsh.client，platform: web）。 - 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 許可證爲 MIT。
- 佈局、尺寸與配置按會話存入
localStorage，重啓保留；切換對話各自獨立。 - API 餘額組件不內置密鑰；API Key 填入後存
localStorage，僅本機。 - 成本估算爲估算值並帶
≈標註。 - 圖片轉述默認接本地 LM Studio（
http://localhost:1234，qwen3.5-9b-mlx），也可配置任意 OpenAI 兼容端點。 - 倉庫內置防密鑰泄露攔截：當
lib/client.js中EMBEDDED_KEY非空時，git push/npm publish會被拒絕。
鏈接¶
倉庫地址：https://github.com/MorGogh/widget-dock
