前言¶
使用 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
