前言¶

在使用 DeepSeek Harness (DSH) 进行开发或调试时，等待模型生成结果往往是耗时最长的环节。此时若只是盯着进度条，容易产生视觉疲劳。DSH 的设计理念是“一切皆插件”，社区成员可以在此框架下扩展功能。HDNRAY 提供的 dsh-plugin-colorguess 正是针对这一场景：不离开当前会话界面，不切换应用，在等待推理完成时进行即时娱乐。

插件定位¶

这是一个由社区成员 HDNRAY 独立开发和维护的娱乐类插件（MIT 许可证）。它不包含游戏代码，而是作为宿主端，在会话头部渲染一个“ColorGuess”按钮。点击后，通过 iframe 嵌入 GitHub Pages 上托管的游戏页面，并提供悬浮窗交互。

核心功能¶

1. 可拖动的悬浮窗：支持通过拖动标题栏移动窗口；左下角和右下角有两个缩放手柄；使用 ✕ 或 Esc 键关闭窗口。
2. 主题同步：游戏界面的配色会跟随 DSH 的亮/暗主题。插件通过 postMessage 协议向游戏页面发送 { source: 'colorguess-dsh', theme } 消息。
3. 无痕交互：悬浮窗关闭后不会在会话区域留下任何痕迹或残留元素。

安装与启用¶

安装插件需使用 web profile，通过 git 仓库安装：

dsh plugin --profile web add github:HDNRAY/dsh-plugin-colorguess

安装完成后，重启 dsh web。在会话头部（聊天页右上角操作区）会出现 ColorGuess 按钮，点击即可打开悬浮窗。

典型用法¶

在等待模型出结果时，点击 ColorGuess 按钮。此时可以玩一局“混色三选一”游戏。窗口会自动跟随 DSH 的当前亮/暗主题进行配色。

适用场景与注意事项¶

• 运行环境：插件仅支持 web 平台（浏览器端），无小程序或原生端实现。需要在 DSH 版本 0.1.2-alpha.2 上运行。
• 网络要求：游戏页面托管在 GitHub Pages，必须联网才能加载。
• 权限与隐私：插件不申请任何特殊权限，不读写本地文件、不访问会话内容、不注入或修改 prompt。
• 匿名统计：游戏页面包含匿名访问统计（Umami），仅记录页面访问与游戏内事件（开始、作答、结束等），不使用 Cookie 做跨站追踪，不采集账号或会话内容。

总结¶

该插件通过简单的悬浮窗交互，解决了等待模型输出时的枯燥问题，同时保持了极低的权限侵入性。更多细节可查阅社区目录或源码仓库。