前言¶
在 DeepSeek Harness (DSH) 中，智能体通常使用内置的 todo_write 工具记录任务计划。官方界面将计划渲染为输入框上方的细条，但这条细条容易错过，且在智能体持续工作时会自动折叠，导致进度不可见。
这就带来一个问题：当智能体运行十分钟不结束时，用户往往需要翻阅对话记录才能回答“进度如何”。dsh-todo-float-ball 将这份清单移至屏幕上常驻的悬浮球中，解决进度可见性问题。
这是什么¶
这是一个 DeepSeek Harness (DSH) 的客户端插件，由开发者 loyalchiiina 维护。它将智能体的任务清单转化为一个常驻屏幕的、可拖拽的悬浮球，实时显示完成进度和当前任务状态。
插件采用 MIT 许可证，无任何数据上传或遥测行为。
核心功能¶
- 常驻悬浮球：球体默认位于屏幕右下角，支持拖拽，位置保存至
localStorage，关闭重启后自动恢复。 - 实时进度显示：球面直接显示
done/total比例及环形进度条，下方显示当前正在进行的任务名称。 - 双路数据同步：通过 DOM 观察者监听官方 todo 面板，并结合会话投影帧解析，确保即使官方面板折叠，清单依然完整。
- 历史归档：当新计划覆盖旧计划时，旧任务不会消失，而是进入“历史归档”区域。
- 固定会话：支持固定多个会话，并在面板中并排显示，便于并行工作的状态监控。
- 胶囊模式：在悬浮球上右键点击，可切换为仅显示当前任务和计数的胶囊形态。
- 皮肤系统：与
dsh-skill-browser和dsh-font-enhancer共享 120+ 款皮肤目录。 - 纪律注入：默认开启，强制每轮对话的第一个工具调用必须是
todo_write，防止智能体遗漏计划。
典型用法¶
- 展开/折叠：点击悬浮球展开完整任务面板，再次点击或按
Esc键折叠。 - 胶囊模式：在悬浮球上右键点击，切换为仅显示当前任务和进度的胶囊形态。
- 拖拽定位：按住球体拖动到任意位置，位置信息会按配置文件独立保存。
- 状态识别：根据球体颜色判断状态：橙色脉动表示进行中，绿色表示全部完成，蓝色表示仅待办，灰色表示暂无清单。
- 历史管理：在面板历史区，可以对旧任务进行隐藏、批量清理或一键恢复。
- 布局切换：支持将固定会话的列表在“上下堆叠”和“左右并排”两种布局间切换。
适用场景与注意¶
- 零侵入：插件基于 Shadow DOM 和
all:initial实现样式隔离，不修改官方面板、对话或其它插件，不产生遥测数据。 - 零配置：安装后即可使用，无需配置文件。
- 双端支持：同一份代码库同时支持 Electron 桌面端和 Web 网页端。
- 纪律注入说明：插件默认开启“纪律注入”，要求每轮对话的第一个工具调用必须是
todo_write。如需关闭，需在配置中显式设置enforceFirstTodoWrite: false。只有显式布尔false才会关闭该功能。
总结¶
dsh-todo-float-ball 是一个为 DSH 长任务运行设计的轻量级 UI 辅助工具。它通过常驻悬浮球解决了进度追踪的痛点，适合需要长时间无人值守运行智能体的开发者使用。
