前言¶
在 DeepSeek Harness（DSH）里长时间跑智能体对话时，任务往往散落在对话记录、外部笔记或脑子里，和当前工作台脱节。系统设置旁若没有一块能随手勾选、设截止日并和 Agent 同步的待办区，「让模型帮我勾掉第 3 条」这类诉求就要靠复制粘贴或手工改文件。社区插件 dsh-better-todo（维护者 lewisyoung0914，npm 包名 dsh-better-todo，当前版本 1.6.8，MIT 许可证）面向 DSH Web 客户端：在界面右侧提供可拖拽、四边吸附的浮动面板，内含今日/更多分组、全量列表视图、附件与番茄钟，并通过五个 Agent 工具和 /todo 斜杠命令与对话侧联动。数据写在本地 ~/.dsh/todo-panel/，不上传。以下介绍其定位、能力与安装用法；事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-better-todo 是 DSH Web UI 的待办浮动面板插件，分类属于客户端侧能力扩展。它占用 Web 客户端槽位 shell.overlay 与 sidebar.footer.action，在侧边栏底部与 Settings 并列出现一行 Todo（显示未完成条数），点击可打开/关闭面板；面板位置、列表、附件与计时器配置由插件 Host 半部持久化到单一 JSON 文档。
核心功能¶
浮动面板与侧栏入口¶
拖动面板标题栏可移动窗口，松手后自动吸附到最近的窗口边缘（左/右/上/下），避免半屏悬空；双击标题栏可重置位置。侧栏 Todo 行会记住面板是否曾打开。
列表视图与条目细节¶
- Home：Today（今天到期）与 More（其余含无截止日），两组可折叠。
- All：未完成与已完成分开；已完成默认展示 10 条，每次「加载更多」再增 20 条。
- 点 + 可新建：标题、详情、截止时间与一个附件。
- 点条目先进入只读详情页，需点右上角 Edit 才进入编辑表单。
- 图片附件点击全屏预览（点背景或 Esc 关闭）；其他类型点击即下载。
番茄钟¶
面板标题栏的时钟入口打开计时页：专注时长（预设 15/30/45/60 分钟，或手动 1–180 分钟）、轮数（1–12）、休息间隔（预设 3/5/10/15，或 1–120）。倒计时显示在标题栏，旁有暂停/继续。专注或休息到零时不会自动切阶段：倒计时停下，面板内弹出提示（若面板已关会重新打开），并在 Windows 上触发 toast；须点 Start break / Start focus 进入下一阶段，Later 可收起提示。界面语言随应用设置在中英文间切换。
Agent 工具（读写在对话中完成）¶
插件注册五个工具，安装并对插件加载后即可在任意对话中使用；面板约数秒内同步，空闲时约每 4 秒轮询一次。
| 工具 | 作用概要 |
|---|---|
todo_list |
status: all（默认）/open/done；limit: 1–200，默认 100 |
todo_add |
title 必填；可选 detail、due |
todo_update |
id 必填；可改 title/detail/due/done |
todo_remove |
id 必填 |
todo_attach |
id 与本地 path（≤32 MB） |
写操作通过文档 rev 做乐观并发；冲突时 Host 返回 409，面板合并后重试。修改插件 index.js 或新安装后，需在插件列表中重载插件或重启 DSH，工具才会重新注册。
Composer 斜杠命令 /todo¶
不经过模型，按固定规则解析，适合快速改表：
| 输入示例 | 效果 |
|---|---|
/todo |
未完成项（含位置与 id） |
/todo add Write the report |
新增一条 |
/todo finish 3 |
勾选 id 为 3（或 id 前缀） |
/todo remove 3 |
删除（含附件） |
亦支持中文口语化写法（如 /todo 完成 3）。详情见 README「Slash command」一节。
通知与已知限制¶
阶段结束时除面板内告警外，优先用页面 Notification API；不可用时 Host 侧可回退到 PowerShell toast。首次点 Start 会请求通知权限。窗口长时间最小化时 Chromium 可能节流定时器，通知或迟到约一分钟；窗口重新可见后会立即复核阶段。Windows 专注助手会屏蔽 toast；拒绝通知时面板内提示仍可用。
安装与启用¶
插件要求 DSH 版本满足 package.json 中 engines.dsh：
>=0.2.1-rc.1 <0.2.2-0 || >=0.2.2-rc.1 <0.3.0-0
（README 说明该区间是为兼容 node-semver 对预发布版的匹配规则。）
从 GitHub 添加：
dsh plugin --profile web add https://github.com/lewisyoung0914/dsh-better-todo
重启 dsh web（或桌面客户端）并刷新页面。上架市场后也可按名称安装：
dsh plugin --profile web add dsh-better-todo
典型用法¶
| 操作 | 位置 |
|---|---|
| 开关面板 | 侧栏底部 Todo |
| 移动/复位面板 | 拖标题栏；双击标题栏复位 |
| 新建 | 面板标题栏 + |
| 编辑 | 点条目文字进入详情再 Edit |
| 完成 | 条目左侧复选框 |
| 计时器 | 标题栏时钟或进行中倒计时 |
| 暂停/继续倒计时 | 标题栏旁 ⏸ / ▶ |
| 无鼠标管理列表 | 在 Composer 输入 /todo 系列命令 |
计时页内 Start / Pause 控制当前阶段，Reset 清空并回到空闲；仅空闲时可改专注/轮数/休息设置，避免运行中跳变。
适用场景与注意¶
适合在 DSH Web 工作台内希望待办、番茄钟与 Agent 同屏协作的开发者。插件与当前 dsh 进程权限 一致运行，可读写 ~/.dsh/todo-panel/ 及 todo_attach 指定的本地路径；安装前宜浏览 源码 与 LICENSE。社区目录 skillhub 插件页 与 GitHub 为独立社区信息来源，并非 DeepSeek / 幻方官方应用商店。
结尾¶
dsh-better-todo 把浮动待办、本地持久化、番茄钟与 todo_* 工具、/todo 命令收进 Web 客户端一层，减少在 Harness 与外部 Todo 应用之间来回切换。进一步了解与 Issue 见 GitHub，条目索引见 skillhub 目录页。
