Taskball · 任务状态悬浮球

给 DeepSeek Harness 加一个悬浮球，用颜色告诉你哪个会话出问题了、哪个在等你、哪个还在跑。

不用再一个个点开会话看进度 —— 看一眼球就知道了。

这是第三方社区插件，不是 DeepSeek Harness 官方项目，与 DeepSeek 官方无隶属或背书关系。

五种颜色

颜色	含义
🔴 红	任务中断或失败
🟡 黄	有任务等你审批或决策
🔵 蓝	有任务正在执行
🟢 绿	任务已完成
⚪ 灰	暂无任何状态

球的颜色按会话数等分：几个会话有状态，就分成几个扇形，每个扇形是那个会话的颜色。同时命中多个状态时取最高的 —— 红 > 黄 > 蓝 > 绿。没有任务时球是灰的。

能做什么

一眼看全局 — 球上每个扇形对应一个会话，颜色就是它的状态。会话增减时扇形会平滑地滑开或收拢。

点开就是任务面板 — 按工作区分组列出所有要处理的会话，点标题直接跳过去。球和面板永远一致：面板里勾了「已处理」，球上对应的扇形也一起消失。

状态一变就提醒 — 从「执行中」转成失败或等你审批时，球旁边弹一个气泡通知。任务完成要不要也提醒，由你决定。

完成的任务自动收纳 — 已完成的会话收进面板底部，可以展开、可以撤销，过了保留时长就自动消失。失败、待审批、执行中的永远不会自己消失，必须你处理。

草稿也能看见 — 写了半句还没发出去的会话，列在面板最上方，点一下回去接着写。每行左侧有图标区分：文件夹 = 还没写过内容的新会话，气泡 = 聊过、还留着半句话的老会话。

嫌占地方就收起来 — 右键球选择收起，球会变成一条细竖条贴在输入框左边。竖条按任务状态分段着色，一个任务一段。点一下就变回球，位置还是收起前那个位置。

安装

要求 DeepSeek Harness 0.2.1-rc.3 或更高。

从 npm 装（推荐）：

dsh plugin add dsh-useful-taskball

从 GitHub 直接装：

dsh plugin add github:ef-umbra/dsh-useful-taskball

GitHub 安装时 DSH 会问你是否允许它运行构建脚本，选允许即可 —— 包需要现场编译出产物。

怎么用

球本身

• 拖动到顺手的位置，位置会记住。拖到侧栏分界线或屏幕边缘附近松手，球会自己贴上去；之后侧栏展开、右栏开关、窗口缩放，贴着的球会跟着移动。
• 点击展开任务面板，再点一次收起。
• 右键打开快捷设置，常用的几项在这儿：球大小、磨砂、面板不透明度、状态突变提醒、是否显示已处理区、面板字号。底部还能一步跳到完整设置，或者把球收起来。键盘用 Shift+F10，也可以点面板首行的齿轮。

处理任务

• 面板每行右侧的勾选框就是「已处理」。勾上会移到下方折叠区，随时可以撤销。
• 失败的条目光勾选会先问你一次：整行滑走，原位出现「取消 / 确认已处理」两块，点确认才真的折叠。也可以按 Esc 取消。
• 按住 Shift 再勾选失败，会列出当前所有待处理的失败会话，一次确认全部处理 —— 批量操作，但每一条都看得见。
• 按住 Shift 再勾选已完成，直接把所有已完成的一起收纳，不用确认。

让红色退场，三种方式任选：勾选「已处理」、归档那个会话、或者回去在会话里发条消息。

设置

入口在 DSH 的「插件 → 已安装插件 → Taskball · 任务状态悬浮球」，也可以在快捷面板里点「打开全部设置」。分三个标签：

外观

• 悬浮球大小：小 / 中 / 大
• 面板质感：不透明度滑块 + 磨砂玻璃开关。默认是半透明磨砂，会透出应用底色，换主题或装皮肤时面板也跟着变。
• 色盲友好配色：把「失败」和「完成」的红绿换成紫红和青绿。
• 状态表示：矩形 或 圆点，选面板里每行怎么显示状态色。
• 面板字号、是否显示已处理区、是否显示已处理计数

动效

• 勾选时的动画（向外淡出 / 向下移入）
• 吸附距离：松手时离边缘多近才吸附。设成 0 就是完全不吸附。
• 气泡显示时长、点击面板外是否关闭

通知

• 状态突变提醒（默认开）：关掉之后任何气泡都不弹，包括失败提醒。
• 完成态保留时长：已完成会话在面板里留多久。

关于这个项目

这是一个 vibe coding 项目 —— 由作者与 AI 协作写成，人负责提需求、判断效果、拍板决策，AI 负责写代码。

• 可用性优先于工程完备。功能是真机反复验证过的，但代码风格与架构不一定符合所有人的审美。
• 没有团队维护。这是个个人项目，更新节奏取决于作者自己的使用需要。
• 问题欢迎提，但不保证响应时间。Issues 会看，修不修、什么时候修看具体情况。

这个项目的想法，源自一次工作经历：那次数小时内只有几个会话在承接任务，人就在这几个会话之间来回转移。所以做了「绿色状态在点进会话后依然保留」的方案 —— 让人可以在几个主要会话之间切换、继续工作。

许可

MIT