前言¶
在 DeepSeek Harness（DSH）里跑智能体时，窗口往往被其他应用盖住：智能体进入等待提问或审批，你未必能立刻看到；切回 DSH 再处理，会打断当前手头的事。社区插件 dsh-sumika-widget（维护者 pucco-OD，分类为客户端）把 DSH 的状态、真实提问与审批接到一块 Windows 桌面挂件上，角色动画随 harness 事件切换，提问可以写在桌面卡片里，不必先找主窗口。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
Sumika 是面向 Windows 版 DeepSeek Harness 的桌面挂件：窗口置顶，根据智能体工作状态切换动画；并把 harness 里的提问、审批显示在像素风小卡片上，可在卡片上直接回答，或通过按钮切回 DSH——README 将其类比为类似 Codex 的「虚拟宠物」。
角色美术来自《CIRCLEMATE サークルメイト》（CIRCLEMATE: Her Secret）中的澄华（Sumika），原作者为 STEEL NYANKO；本项目仅将精灵图用作桌面挂件皮肤，详见 README 中的致谢与链接。
核心功能¶
桌面上的智能体状态¶
挂件不通过轮询 UI 猜状态，而是跟随 harness 的 agent/status 与 turn/end 等事件，在桌面上呈现 idle / working / waiting / finished 四类状态。角色在闲置、工作、等待提问、本轮完成时各有对应动画，状态切换带有入场与退场过渡。
真实提问与审批¶
插件包装 harness 的 user-questions/request 与 approval/request 瀑布流：主窗口里会出现的同一道提问，也会出现在桌面卡片上；在卡片或 DSH 任一侧作答，两侧都会结算。
卡片复用 harness 的提问载荷：选项保留原编号，长标签选中后可在行内滚动，文本框支持自由回答；「去 DSH 查看」会把 DeepSeek Harness 窗口调到前台，并保持同一道提问打开。
提示音与设置¶
提供等待音与完成音，可在设置面板替换为自定义 WAV / MP3 / WMA / M4A 文件。
设置页可调整尺寸、屏幕边距、音量：支持滑块，也支持直接输入整数。
回到 DSH 主窗口¶
双击桌面角色，可将 DeepSeek Harness 窗口置于最前。
环境与依赖¶
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 1903+ 或 Windows 11，仅 x64 |
| 运行时 | .NET Framework 4.8（Win10 1903+ / Win11 已自带） |
| Harness | DeepSeek Harness 0.2.1-rc.3（README 标注为已测试版本） |
C++ 运行时（runtime/vcruntime140.dll）与 WebP 解码库随插件附带，安装过程不会额外下载依赖。
安装与启用¶
在 DSH 内：Settings → Plugins，选择本插件目录安装；或在命令行执行 README 给出的命令：
dsh plugin add https://github.com/pucco-OD/dsh-sumika-widget
安装后重启 harness，打开 Settings → Sumika 进行配置。
卸载时在 Settings → Plugins 中移除插件，挂件窗口会一并关闭。%LOCALAPPDATA%\Sumika 下的设置与日志会保留，可手动删除。
插件将设置、日志与解码资源缓存写入 %LOCALAPPDATA%\Sumika。挂件通过本机 loopback HTTP 与 harness 通信，每次运行使用随机 bearer token；README 说明不会向外部发送数据。
典型用法¶
- 按上文安装并重启 DSH，在 Settings → Sumika 调整大小、边距与音量，按需替换提示音文件。
- 正常使用 DSH 跑智能体：角色会在 idle / working / waiting / finished 之间切换动画。
- 当 harness 弹出提问或审批时，在桌面卡片选择选项、填写文本，或点击「去 DSH 查看」到主窗口处理；任一处回答即可。
- 需要聚焦主界面时，双击桌面角色将 DSH 窗口调到最前。
适用场景与注意¶
适合谁： 主要在 Windows 上使用 DSH、希望在不频繁切换窗口的情况下感知智能体状态，并在桌面快速处理提问与审批的用户。
平台： package.json 中 os 为 win32，cpu 为 x64，非 Windows 环境不适用。
权限与安全： DSH 插件以当前 DSH 进程权限运行。安装前建议在 GitHub 仓库阅读源码与 MIT 许可证，自行判断是否满足你的安全与合规要求。
生态说明： DSH 采用「一切皆插件」的扩展方式；社区目录站点（如 SkillHub）与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的客户端插件，而非官方应用商店条目。
结尾¶
dsh-sumika-widget 把 harness 的状态事件与提问/审批流接到 Windows 桌面：动画反映智能体阶段，卡片承接真实交互，并支持提示音与双击回主窗口。当前 package.json 版本为 1.0.0，GitHub 仓库星标数为 1（以目录页信息为准）。
- 目录页：https://www.skillhub.cn/plugins/pucco-OD/dsh-sumika-widget
- 仓库：https://github.com/pucco-OD/dsh-sumika-widget
