任务进度条 · Task Progress Bars
给 DeepSeek Harness Web UI 的会话任务清单换上每个任务一条进度条，并在任务完成时提供可选提醒。
A DeepSeek Harness Web UI plugin that renders a progress bar for every session task and offers optional completion reminders.
功能 / Features
- 每个任务一条进度条：输入框上方的任务面板中，每个任务显示状态点、任务名、迷你进度条和百分比。
- 待处理
pending→0%；进行中in_progress→50%（呼吸动画）；已完成completed→100%（成功色 + 删除线）。 - 整体进度：标题行常驻整体进度条，显示「已完成 x/y · 百分比」；总进度按加权估算
(完成数 + 0.5 × 进行中数) / 总数，是"大概进度"。 - 可选完成提醒：面板右上角铃铛按钮，默认关闭、点击开启，偏好保存在浏览器本地。
- 任务变为已完成时弹应用内提醒；全部完成时提示「全部任务完成 🎉」并附会话名。
- 跨会话监控：切换到别的会话时，原会话任务完成也会提醒；面板自身另有兜底检测，5 秒内去重。
- 系统通知可用时额外发送；应用内提醒始终兜底（Windows 上系统通知依赖应用通知设置）。
- 可折叠：点击标题行展开/收起任务列表；折叠状态与提醒开关都会被记住。
- 跟随主题：只使用 Harness 的
--dsw-alias-*主题 token，自动适配明暗主题。 - 8 种语言：中文、English、日本語、Español、Français、Deutsch、Русский、Português。
环境要求 / Requirements
- DeepSeek Harness（Web UI / Desktop），版本
0.2.2-rc.1附近。 - 当前 Agent 预设需要挂载
@deepseek-ai/dsh-tool-todo（standand预设默认已挂载，todos投影即数据源）。 - 无构建步骤：
client.js是 Harness 客户端可直接加载的普通 JS 插件包。
安装 / Installation
方式一：让 Harness 里的智能体安装（推荐）
git clone https://github.com/4133chen/dsh-task-progress.git
然后在任一 DSH 会话中把该目录告诉智能体，例如：
> 用 plugin_manager 把 dsh-task-progress 目录安装为本地插件。
智能体会调用 plugin_manager install_bundle（绝对路径指向克隆下来的目录）：安装包、写入 profile 的 bundle 选择并热加载，通常无需重启。安装结束后输入框上方即出现任务进度面板。
方式二：手动加入 profile
- 在
~/.dsh/profiles/<你的profile>/package.json中把插件加入依赖与 bundle 列表：
{
"dependencies": { "@local/task-progress": "link:/path/to/dsh-task-progress" },
"dsh": { "profile": { "bundles": ["...", "@local/task-progress"] } }
}
- 在 profile 目录执行
pnpm install（或直接使用 Harness 的插件管理界面安装本地包）。 - 重启 Harness（或等待 HMR）后生效。
卸载 / Uninstall
在 设置 → 插件 中禁用或移除本插件即可；内置任务面板会自动恢复。
使用 / Usage
- 让智能体维护任务清单（它会调用
todo_write），面板即出现在输入框上方。 - 每个任务的进度条按状态估算；任务变为「进行中」时进度到一半，完成后满格。
- 点右上角 🔔 开启完成提醒；再点一次关闭。
- 全部完成后面板显示 100%；下一回合开始时旧清单会随
todo_write生命周期清空。
实现 / How it works
| 文件 | 作用 |
|---|---|
index.js |
Host 半边：空插件，仅作为 Loader 行让 dsh.client 声明加入浏览器插件表 |
client.js |
浏览器半边：读取会话 todos 投影、渲染进度面板、注册提醒 toast 栈 |
cordis.patch.yml |
bundle 补丁：插入 task-progress 行 |
locale/*.json |
插件列表展示用标题/描述（8 语言） |
icon.svg |
原创插件图标 |
- 面板复用
conversation.input.dock中内置任务面板的 cell（id: "todo"，priority: -100更低者胜），因此不会出现两份任务列表；禁用本插件后内置面板自动恢复。 - 提醒 toast 注册在 frame-wide 的
shell.overlay槽位（id: "task-progress.toasts"），点击穿透层上自行接管指针事件。 - 完成检测同时覆盖：当前面板（
useProjection("todos")）与跨会话监控（ctx.sessions.list的projectionsBySession），并用 5 秒去重避免重复提醒。
本地化 / Localization
界面文案与插件列表标题/描述提供中文、English、日本語、Español、Français、Deutsch、Русский、Português 八种语言；随 Harness 语言设置切换。
已知限制 / Limitations
- 数据源是会话任务清单（
todo_write维护的todos投影），不是 Agent Teams 的共享任务板。 - "进度"是按任务状态估算的大概值，不是按耗时/子任务的精确百分比。
- 系统通知在 Windows 上是否弹出取决于系统通知设置与应用标识；应用内提醒不依赖它。
- 本插件替换了内置任务面板（同 cell 覆盖），如不希望替换可把
client.js里的id改成自己的值并调整样式后作为附加面板使用。
开发 / Development
- 无打包步骤：修改
client.js后由 Harness 客户端 HMR 自动替换插件（该 profile 需启用client-hmr）。 - 自检脚本：
node --check client.js；仓库不含构建产物。 - License: MIT
许可 / License
MIT © 2026 4133chen
