前言¶
用 DeepSeek Harness（DSH）跑任务时，主窗口往往被 IDE 或浏览器挡住。想知道「现在有几个会话在跑、每个跑到哪一步、已经烧掉多少 Token、有没有卡在等你点允许」，通常得切回 DSH 翻界面。下面介绍 Windpixy 维护的客户端插件 dsh-floating-window（DSH 状态悬浮窗）：在 Windows 桌面上浮一块磨砂玻璃小窗，把上述信息汇总成一眼能扫到的卡片或细柱，尽量不打扰手头工作。
这是什么¶
dsh-floating-window 是 DSH 的客户端类插件，displayName 为「DSH 状态悬浮窗」。插件侧用 Node.js 监听 DSH 会话事件，把状态写入 %USERPROFILE%\.dsh\desktop-card\ 下的 state.json；窗口本体在 panel/ 里，由 PowerShell + WPF 绘制，每约 500ms 读一次该文件。窗口进程刻意脱离 DSH 进程树，关掉 DSH 后卡片仍可留在桌面。
维护者：Windpixy。源码与说明：https://github.com/Windpixy/dsh-floating-window；npm 包名 dsh-floating-window（README 安装示例版本 0.10.13）。许可证 MIT。DSH 插件社区目录页：https://www.skillhub.cn/plugins/Windpixy/dsh-floating-window（独立站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
卡片态：任务与用量¶
有任务运行时，卡片按行列出任务名、已跑时长、当前在做什么，以及该任务已消耗的 Token（右下角小字，如 12.3k Token）。该数字按会话统计，含子代理用量；为 0 时不显示；与底部「今日 Token」口径不同——底部是全天合计。
无任务时卡片收成一行，在「今日 Token」与「谷时倒计时」之间轮播。谷时指 DeepSeek 低价时段：工作日 9–12 点、14–18 点之外，以及周末与法定节假日全天；插件自行判断，节假日列表从网上更新。
审批与多任务¶
有待你审批的操作（例如删除、改系统）时，状态会在悬浮窗上体现；柱态下用红色色条表示「等你审批」。任务多时卡片自动增高（最多 5 行），子智能体单独计数。
柱态（细条）¶
右键菜单选「缩成细条」后，窗口变为约 14×120 像素的细柱贴边。色条含义：蓝—有任务在跑；红—待审批；绿—刚有任务完成；灰—空闲。任务运行中色条会明暗起伏。单击展开回卡片；悬停弹出气泡显示任务明细；可拖动换边并吸附屏幕边缘。
交互与外观¶
单击卡片可跳回 DSH 主窗口（可在设置里关闭）。拖动位置会记住；可选贴边与留白。卡片会根据壁纸明暗自动切换文字黑/白。右键菜单还提供置顶、回到默认位置、重新读取设置、导出诊断包、退出等。
设置里可调磨砂浓度（24–144）、轮播间隔（5–120 秒）、卡片宽度（200–360，默认 260）、收起高度（72–160，默认 96）等；保存后约半秒内生效，无需重启 DSH。
安装与启用¶
<你的 profile> 指 DSH 侧栏「插件」页上显示的当前配置名；不确定时可填你在用的名字，DSH 会在首次使用时创建。
方式一（npm，README 推荐）——版本号须写精确，避免 pnpm 11 的 minimumReleaseAge 静默装到旧版：
dsh plugin --profile <你的 profile> add dsh-floating-window@0.10.13
方式二（GitHub）：
dsh plugin --profile <你的 profile> add github:Windpixy/dsh-floating-window
方式三：DSH 图形界面 → 插件 → 添加插件，输入 dsh-floating-window@0.10.13 或 github:Windpixy/dsh-floating-window 等。
装好后重启一次 DSH；默认卡片出现在屏幕右侧。若已装过要更新，可重跑安装命令；提示已存在时先 remove 再 add：
dsh plugin --profile <你的 profile> remove dsh-floating-window
dsh plugin --profile <你的 profile> add github:Windpixy/dsh-floating-window
卸载：
dsh plugin --profile <你的 profile> remove dsh-floating-window
卸载不会自动关闭已打开的卡片窗口；卸载后请右键卡片 → 退出，否则窗口会停在最后一帧。数据目录 %USERPROFILE%\.dsh\desktop-card\ 需手动删除才会清掉设置与日志。
典型用法¶
- 安装并重启 DSH，确认 Windows 10 / 11 下屏幕右侧出现磨砂玻璃卡片（能透出壁纸，而非纯色块）。
- 跑一个 DSH 任务，看卡片任务行与 Token 小字是否随进度更新；底部「今日 Token」与任务行用量区分查看。
- 需要省位置时：右键 → 缩成细条，用色条判断状态；悬停看明细，单击恢复卡片。
- 调外观与行为：右键 → 设置…，改磨砂、尺寸、贴边、轮播间隔；审批相关开关默认偏保守（「在悬浮窗上直接审批」默认关），按需阅读 README「审批相关的两个开关」后再开。
- 卡片不出现：先确认系统为 Windows；查插件日志
%USERPROFILE%\.dsh\desktop-card\plugin.log；或手动运行插件目录下panel\run-panel.bat看控制台报错。
适用场景与注意¶
适合：在 Windows 上长时间开 DSH、希望不切窗口就能掌握多会话进度、Token 与审批状态的开发者。
务必知晓：
- 仅支持 Windows 10 / Windows 11。在 macOS / Linux 上插件可加载但不报错，卡片不会出现；日志可能出现「两种启动策略都没成功」类提示——README 明确写先看是否在 Windows 上。
- 插件随当前 DSH 进程权限运行；安装前建议查看源码与 MIT 许可证，自行评估信任边界。
- 「在悬浮窗上直接审批」涉及高危操作确认，默认关闭；开启前应理解 README 中的安全说明。
- 包要求 Node.js
^22.19.0 || >=24.0.0（见package.json的engines）。
结尾¶
dsh-floating-window 把 DSH 会话状态落到桌面一块轻量磨砂窗上：卡片看明细，细柱看状态，Token 与谷时信息不用切回主界面。详情与截图见仓库 README；安装可走 npm 精确版本或 GitHub。
