前言¶
用 DeepSeek Harness（DSH）跑对话或开发任务时，临时待办往往散在笔记、终端或别的窗口里，切出去记一笔再回来，容易打断节奏。系统自带的提醒类工具通常也不挂在 DSH 窗口上。下面介绍社区插件 dsh-todo-widget：在 DSH 界面右侧提供可拖动的悬浮按钮和待办面板，数据只写本机，不依赖外网同步。
这是什么¶
dsh-todo-widget 由维护者 duoemma 发布，归类为 DSH 客户端插件（当前 package.json 版本为 0.2.0，MIT 许可证）。它把待办钉在 DSH 边上：右侧圆形悬浮按钮 + 可调磨砂强度的面板，想记什么点开即可，不必切换到其他应用。
插件目录页：https://www.skillhub.cn/plugins/duoemma/dsh-todo-widget
源码与说明：https://github.com/duoemma/dsh-todo-widget
SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系；DSH 生态按「一切皆插件」扩展，安装前请自行查看源码与许可证。
核心功能¶
以下能力均来自项目 README，安装后以实际界面为准。
- 悬浮入口：圆形按钮可拖到任意位置，位置会被记住；角标显示未完成数量。
- 列表操作：回车添加；勾选完成；双击改名；拖动排序。
- 筛选与清理：全部 / 未完成 / 已完成三种筛选；支持一键清除已完成项。
- 外观：磨砂玻璃面板，强度 0–100% 可调；深色、浅色主题自动适配。
- 本地数据：不联网、不上传；宿主端与浏览器侧各有一份存储，按写入时间取较新的一份，宿主接口不可用时退化为纯本地模式。
面板宽 332px，高度不超过视口 60%，列表区可滚动。
安装与启用¶
从 GitHub 安装（官方 README 命令，需使用 desktop profile）：
dsh plugin --profile desktop add github:duoemma/dsh-todo-widget
安装后重启一次 DSH。
本地开发或离线环境可用仓库内的脚本：
powershell -NoProfile -ExecutionPolicy Bypass -File install-plugin.ps1
卸载：
powershell -NoProfile -ExecutionPolicy Bypass -File install-plugin.ps1 -Uninstall
插件在 DSH 进程权限下运行，安装前建议通读仓库代码与 MIT 许可证条款。
典型用法¶
- 点界面右侧圆形按钮展开待办面板，按
Esc关闭。 - 在输入框回车添加条目；勾选标记完成；双击条目改名；拖动调整顺序。
- 使用面板内的筛选切换「全部 / 未完成 / 已完成」；需要时一键清除已完成。
- 点右上角
◐打开磨砂强度滑杆，拖动即时生效（默认 82，范围 0–100）。
若需改存储目录，可设置环境变量 DSH_TODO_STORE_DIR（默认 ~/.dsh/todo-widget）。主数据文件为 ~/.dsh/todo-widget/todos.json；浏览器侧副本在 localStorage["dsh-todo-widget:state"]，供宿主接口不可用时的兜底。
适用场景与注意¶
适合：长时间开着 DSH desktop profile、希望在同一窗口内维护短待办清单的开发者或智能体使用者；对数据出境、云端同步无需求、只要本机持久化的场景。
注意：
- 安装命令带
--profile desktop，与 README 一致；其他 profile 是否支持需自行验证。 - 数据仅存本机，换机器或清目录前请自行备份
todos.json。 - 从 GitHub 安装使用的是仓库已提交的
client/构建产物；若 fork 后改src/，需本地执行node build.mjs并一并提交client/。 - 挂件支持自更新：服务端构建号变化后，页面会在约 45 秒内切换到新版本。
结尾¶
dsh-todo-widget 把待办收进 DSH 右侧：悬浮按钮、磨砂可调面板、本地 JSON 存储，适合不想为几条任务另开应用的用户。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
