前言¶
在 DSH 里和 Agent 协作时，待办往往散落在对话、笔记或系统提醒里，和 Harness 会话不在同一界面。系统日历或第三方清单可以记事项，但不会出现在 DSH 左侧导航，Agent 也无法按同一套数据读写。下面介绍社区插件 dsh-todo（维护者 AsakuraAOI，分类：客户端）：在 DSH 左侧增加「待办」入口，支持清单管理、可选倒计时，以及 Windows 桌面版下的可置顶独立小窗口；同时向 Agent 暴露 todo_list、todo_add、todo_update 等工具，与界面共用本机持久存储。
这是什么¶
dsh-todo 是 DeepSeek Harness 的客户端插件，版本 0.3.0（MIT 许可证）。一句话定位：在 DSH 左侧导航添加「待办」，集中查看要做的事；可将同一份清单打开为独立小窗口，放在桌面一角，按需置顶或最小化。
插件主页与源码：
- 社区目录：https://www.skillhub.cn/plugins/AsakuraAOI/dsh-todo
- GitHub：https://github.com/AsakuraAOI/dsh-todo
核心功能¶
左侧导航与清单界面¶
安装并重启后，「待办」与插件、学习、技能中心位于同一左侧导航区域。
- 输入标题并按 Enter 或点击「添加」。展开「添加描述和详情」可填写简短描述（最多 200 字）与完整详情（最多 20000 字），通过「编辑」修改。
- 列表只显示简短描述预览（最多两行），点击标题或描述查看完整内容。详情窗口显示完整标题、描述、详情、状态及倒计时；可从详情进入编辑，点击关闭或按 Escape 返回清单。
- 旧版的长备注会完整保留在详情中，清单改为显示简短预览。
- 清单、详情和输入框不显示滚动条；长内容仍可通过滚轮、触控板或键盘滚动查看。
倒计时与排序¶
- 可选勾选「设置倒计时」，输入时长（分钟、小时或天，最长 365 天），或选择本地截止时间。添加后立即开始计时，关闭窗口或重启也继续计算；编辑时可调整或取消。
- 默认按剩余时间从少到多排列，超时事项在前，未设置倒计时的在后；相同截止时间按创建时间从新到旧排列。倒计时每秒刷新，超时后显示「已超时」，不自动完成事项。已完成或已结束的事项仅显示截止时间。
状态与筛选¶
- 勾选表示「已完成」；在已完成列表取消勾选可恢复为进行中。
- 「结束」表示不再继续，记录移到已结束列表；点击「恢复待办」可重新继续。
- 使用进行中、已完成、已结束、全部筛选查看记录。结束不会删除数据。
独立窗口（Windows 桌面版）¶
主页面右上角的「独立窗口」打开单独的桌面窗口，再次点击会唤起已有窗口。小窗口中可添加、编辑、勾选和结束待办，也可点击「置顶／取消置顶」「最小化」「关闭」。关闭小窗口不会清空清单；再次打开时默认不置顶。退出 DSH 或停用插件时，小窗口也会退出。
独立窗口沿用主窗口当前的明暗主题和配色变量；在 DSH 中切换主题后，已打开的小窗口也会同步更新。独立窗口当前支持 Windows 桌面版 DSH，复用其已安装的 Electron 运行时，不需要下载其他运行时。不支持在普通浏览器页面中创建可置顶的原生窗口。
Agent 工具¶
| 工具 | 用途 |
|---|---|
todo_list |
默认读取进行中待办，status 可设为 completed、ended 或 all |
todo_add |
添加 title、可选的简短描述 notes、完整详情 details 和倒计时截止时间 dueAt |
todo_update |
根据 id、expectedVersion 更新描述／详情、设置／取消 dueAt，或执行 complete、end、reopen |
工具说明要求 Agent 仅在用户要求记录待办时写入；其内部执行计划仍使用 DSH 自带的 todo_write。
dueAt 使用带时区的 ISO 日期时间，例如 2026-10-18T18:00:00+08:00；null 取消倒计时，更新时省略则保留已有时间。Agent 读取到的列表与界面采用同样的默认排序。
数据与同步¶
数据保存在用户主目录下的 .dsh/storages/dsh-todo/todos.json。卸载插件不删除该文件，重新安装后可继续使用。备份时请先退出 DSH，再复制此文件。
主页面、独立窗口和工具共用本机的持久清单，所有会话共享，不按会话隔离。页面约每 1.5 秒同步；过期修改会被拒绝，避免覆盖另一处的新内容。
安装与启用¶
在已配置 desktop profile 的环境下，可用官方命令从 GitHub 添加：
dsh plugin --profile desktop add 'github:AsakuraAOI/dsh-todo'
也可以在 DSH 的「插件 → 添加插件」中选择本地目录，填写本插件目录的绝对路径；或选择打包后的 dsh-todo-0.3.0.tgz。按插件管理器提示重启后，左侧会出现「待办」入口。
插件以 Node.js >= 22 构建，无运行时 npm 依赖；面向 DSH 客户端注入侧栏与主题相关模块（@deepseek-ai/dsh-client-ui-sidebar、@deepseek-ai/dsh-client-ui-theme）。
典型用法¶
界面操作¶
- 重启后在左侧进入「待办」，输入标题并添加。
- 需要截止提醒时展开描述与详情，勾选「设置倒计时」并填写时长或本地截止时间。
- 在 Windows 桌面版 DSH 中点击「独立窗口」，将小窗口放在桌面一角，按需置顶。
与 Agent 对话¶
可以对 Agent 说：
- 「帮我记一条待办：周五前整理报告」
- 「把整理报告标为已完成」
Agent 通过 todo_add、todo_update 等工具写入或更新，与你在页面上看到的数据一致。
适用场景与注意¶
适合谁： 长期在 DSH 桌面版里工作、希望待办与 Harness 同屏或同数据源的开发者；需要在 Windows 上把清单钉在桌面一角的用户；希望 Agent 按用户明确要求把事项写入持久清单、而不是只写在对话里的场景。
安装前建议： 插件以当前 DSH 进程权限运行，安装前应阅读仓库源码与 MIT 许可证，确认数据路径与行为符合预期。社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
平台限制： 可置顶的原生独立窗口仅 Windows 桌面版 DSH；主页面与 Agent 工具在插件接口支持的客户端环境中使用。独立窗口通过带随机令牌的回环连接访问同一份数据，不开放远程待办访问。
维护与贡献： 修改界面后需 npm run build 重新构建；仓库提供 npm run check、npm test 与 Electron 冒烟脚本供开发与验证。
结尾¶
dsh-todo 把待办放进 DSH 左侧导航，并与 Agent 工具、本机 todos.json 对齐；Windows 桌面版还可打开可置顶的小窗口，主题与主界面同步。需要安装命令与字段说明时，以 GitHub README 为准。
- 社区目录：https://www.skillhub.cn/plugins/AsakuraAOI/dsh-todo
- GitHub：https://github.com/AsakuraAOI/dsh-todo
