前言¶
在 DSH 里和模型聊方案、排期、核对项时，待办往往出现在回复的某一句话里，而不是单独的待办应用里。关掉会话或切到别的窗口，那条「记得周五前核对 RoHS」就容易丢。常见做法是复制到笔记或外部 Todo，多一步切换，也缺少和原对话、原句的关联。
下面介绍社区插件 dsh-todo-checklist（维护者 qgd1850890306-rgb），分类为客户端。它在 DSH 内提供划词加待办、对话里由模型写入待办、左侧栏汇总，以及到期提醒与导出，数据落在本机存储，插件自身不发起外部网络请求（启用 DSH-IM 推送时例外）。当前 npm 包版本为 1.5.12，许可证 MIT；GitHub 星标为 0，尚未依赖官方 Discover 自动收录，需按 README 中的包名或地址安装。
这是什么¶
dsh-todo-checklist 是 DeepSeek Harness 的待办 sidecar：在那句话出现的上下文里创建条目，并在左侧固定面板里统一查看与处理。宿主面预打包为自包含文件，零运行时依赖；兼容 DSH >= 0.2.0-rc.1（README 写明已测 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2），Node.js 要求 ^22.19.0 || >=24.0.0。客户端声明 platform: web，桌面端与 Web 端均可使用。
目录页：skillhub.cn/plugins/qgd1850890306-rgb/dsh-todo-checklist（社区目录站点，与 DeepSeek / 幻方无官方从属关系）。源码与说明：github.com/qgd1850890306-rgb/dsh-todo-checklist。
核心功能¶
四种写入方式¶
| 你做的事 | 待办如何进入 |
|---|---|
| 在回复里选中文字，点 ＋ 待办 | 弹出卡片，可用 AI 预填标题 / 内容 / 提醒时间，也可手填 |
| 对话中说「记一下……」「提醒我周五前」等 | 模型调用内置工具 todo_add（source: "model"）写入 |
| 一段对话结束 | 未落实的意图可被自动捕获为待办 |
| 问「我现在有哪些待办？」 | 模型调用 todo_list，与面板共用同一数据 |
左侧栏面板¶
入口在官方左侧图标列底部的「待办清单」。收起时显示概要（如预期项数、待完成项数）；展开后含搜索、提醒筛选，以及未完成 / 已完成 / 已放弃 / 逾期四个分组。勾选完成、行内编辑、删除；双击标题或点 ↗ 可新建会话，沿用原工作区与模型，待办内容预填输入框，发送后该待办自动完成。
到期提醒¶
约每 30 秒扫描到期项。默认应用内弹窗（知道了 / 查看 / 完成；「查看」跳回原会话并高亮原句）。若在设置中启用 DSH-IM 推送，可同时推到本机配置的机器人（需先安装并配置 dsh-im；单条待办可覆盖全局默认）。提醒依赖 DSH 正在运行；关闭期间到点的提醒会在下次启动后补发。
导出¶
自 1.5.0 起支持在 设置 → 待办清单 中导出。格式：HTML、Markdown、Excel (.xlsx)、CSV、JSON；范围可多选（未完成 / 逾期 / 已完成 / 已放弃，不选则全部）。导出内容仅为清单字段，不含对话原文，不上传外部。
模型也可通过宿主工具导出文本类格式：
todo_export({ format: "md" | "csv" | "json" | "html", scope: "all" | "pending" | "done" | "abandoned" | "overdue" })
.xlsx 为二进制，工具会提示通过界面按钮下载。
其它能力（README 已说明）¶
- 编辑与延期：标题、内容、提醒时间；单次提醒支持年 / 月 / 日 / 时 / 分分段调节；延期预设含 +1 天、下周一 09:00、自定义。
- 重复：每天或每周，可选星期与时间。
- AI 重新整理：把已有待办交回模型重写为结构化内容并替换原条目（各产生一次模型调用，按所配模型计费）。
- 转定时任务：依赖 dsh-tasks；未安装时回退官方内置调度，都没有会有明确提示。
- 持久化：个人存储域
dsh_todo_sidecar_items；单条损坏会独立抢救或丢弃，不拖垮整个插件。
安装与启用¶
插件在 DSH 进程权限下运行，安装前建议浏览仓库源码与 MIT 许可证。客户端 UI 变更需完全退出并重启 DSH 后生效；装成功的标志是左侧出现「待办清单」图标。
方式一（推荐，npm）
dsh plugin --profile desktop add dsh-todo-checklist
包发布在 npmjs.com/package/dsh-todo-checklist。钉版本可写 dsh-todo-checklist@<版本号>。
方式二（GitHub）
dsh plugin --profile desktop add https://github.com/qgd1850890306-rgb/dsh-todo-checklist.git
方式三（本地目录或 tarball，离线 / 内网）
dsh plugin --profile desktop add <本地目录或 .tgz 的绝对路径>
界面安装：左侧 插件 → 添加插件 → 填 dsh-todo-checklist 或粘贴上述 GitHub URL。
可选索引源（即时发现，非必须）：设置 → 插件 → 发现 → 添加索引源，地址为：
https://cdn.jsdelivr.net/gh/qgd1850890306-rgb/dsh-todo-checklist@main/index.json
README 说明发布到 npm 后，社区 awesome-dsh-plugin 索引约一天内也会收录，不必一定自建索引。
升级（npm）：再次执行 dsh plugin --profile desktop add dsh-todo-checklist。
卸载
dsh plugin --profile desktop remove dsh-todo-checklist
卸载不会删除待办数据文件；要清空需手动删除存储文件（见下文）。
典型用法¶
- 安装 —— 按上面任选一种方式安装，重启 DSH。
- 加一条 —— 在任意对话回复中选中一句话 → 点 ＋ 待办 → 选「AI 记录待办」或手填 → 保存待办。
- 设提醒 —— 在卡片里点要调的年 / 月 / 日 / 时 / 分段，再用 − / ＋ 或键盘方向键；也可用预设（如 1 小时后、明天 09:00、下周一 09:00 等）。
- 查看与处理 —— 打开左侧「待办清单」；勾选完成；需要上下文时双击标题新建会话并发送。
- 对话写入 —— 直接对模型说「记一下明天提交报告」或「我有哪些待办」，由
todo_add/todo_list处理。 - 导出 —— 面板头部或设置页「待办清单」中的导出区，选格式与范围下载。
数据、隐私与注意¶
- 数据位置：
<DSH_HOME>/storages/dsh_todo_sidecar_items.json，默认<DSH_HOME>为~/.dsh。 - 网络：插件自身不发起外部请求；仅 DSH-IM 推送会交给本机 IM 服务。
- 排障：设
DSH_TODO_DEBUG=1，日志写入<DSH_HOME>/dsh-todo/diag.jsonl（目录可用DSH_TODO_STATE_DIR修改）。F12 Console 可看__DSH_TODO_FOLLOWUP_TRACE__、__DSH_TODO_ENTRY_ERROR__。 - 侧栏开关：「在左侧边栏显示待办清单」变更后需重启 DSH。
- 限制：机器人推送依赖 dsh-im；多 DSH 实例同时运行时，同一条待办的机器人推送只会发一次。
结尾¶
dsh-todo-checklist 把待办创建点放在对话和选区上，用左侧面板降低回顾成本，并用本机持久化与多格式导出保留记录。适合长期在 DSH 里做方案、排期和跟进的开发者；若你已在用 dsh-im 或 dsh-tasks，提醒与转定时任务可以一并接上。
- 目录页：https://www.skillhub.cn/plugins/qgd1850890306-rgb/dsh-todo-checklist
- GitHub：https://github.com/qgd1850890306-rgb/dsh-todo-checklist
