dsh-todo-checklist

---

🎯 What it does · 它能做什么

大多数待办工具的失败原因是同一个：念头出现在干活的时候，而不是出现在待办 App 里。 你跟模型聊到一半，它说「另外记得核对一下 RoHS 报告有效期」，你点点头 —— 然后就没了。

这个插件把这个缺口补上。它长在 DeepSeek Harness 里，在那句话出现的瞬间把待办接住，四种接法：

所有东西都落到左侧那一个面板里 —— 每个会话都在同一个位置，回顾成本是「瞟一眼」，不是「切个 App」。

---

📸 Screenshots · 界面截图

面板：一直在那，收起时只占一行

选中文字 → 冒出一个小气泡 → AI 把这句话变成结构化待办

导出：设置页里的折叠区 —— 范围和格式都能多选，每个格式各下载一个自包含文件

设置页拆成两页 —— 「设置」放插件选项，「待办清单」放完整记录列表

整个窗口的样子

---

🚀 Quick start · 快速上手

1. 安装 —— 打开 DSH → 左侧栏 → 插件 → 添加插件 → 填 dsh-todo-checklist → 完全退出并重启 DSH。
2. 加一条 —— 在任意对话里选中一句话 → 点 ＋ 待办 → 让 AI 填，或自己打 → 保存待办。
3. 看与处理 —— 点左侧图标列底部的「待办清单」。勾掉它、双击跳回原句、或者等到点提醒自己弹出来。

整个闭环就这三步。不用注册，不用另起服务。

---

✨ Features · 功能一览

---

📤 Export · 导出

1.5.0 新增导出。设计目标很朴素：同一批记录，人要能读，AI 也要能读，而且不该需要你手动转换。

进 设置 → 待办清单，展开「导出全部记录」，选格式和范围即可。

五种格式：

范围可多选：未完成 / 逾期 / 已完成 / 已放弃 任选若干个，取并集；一条都不选就是全部记录。选中的范围会写进文件名和导出说明，例如 dsh-todo-20261019-0140-pending-overdue.md。

两点值得知道：

• 导出内容只有清单本身 —— 标题、内容、时间、状态、AI 总结、来源会话。不含对话原文，也不会上传到任何地方。
• 格式化逻辑只有一份，放在 shared/export-core.js，界面和宿主工具共用。所以你下载到的文件，和 AI 通过 todo_export 拿到的文本，是同一份代码产出的 —— 两边不会漂移。

给 AI 用的宿主工具：

todo_export({ format: "md" | "csv" | "json" | "html", scope: "all" | "pending" | "done" | "abandoned" | "overdue" })

跟模型说「把我所有待办导出成 Markdown」，它会直接在对话里返回文本。（.xlsx 是二进制，所以工具会返回一句提示让你走界面按钮 —— 这是有意划的边界，不是缺功能。）

---

🧩 Requirements · 环境要求

• DSH >= 0.2.0-rc.1，已测 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2。
• Node.js ^22.19.0 || >=24.0.0（engines 里声明；桌面端运行时自带 Node 24）。
• 桌面端或 Web 端均可 —— 客户端面声明 platform: web。
• 零运行时依赖：宿主面已预打包成自包含文件（lib/host.js、lib/typert.js，zod 已内联）。安装时不需要下载任何东西，所以 link:、离线、tarball 三种装法表现完全一致。

---

📦 Install · 安装

方式一 —— 从 npm 装（推荐，一行命令）

dsh plugin --profile desktop add dsh-todo-checklist

包已发布在公共 npm（https://www.npmjs.com/package/dsh-todo-checklist）。不写版本号就是最新版；要钉住某一版，写成 dsh-todo-checklist@<版本号>。

方式二 —— 从 GitHub 装

dsh plugin --profile desktop add https://github.com/qgd1850890306-rgb/dsh-todo-checklist.git

构建好的 lib/ 在仓库里，两种方式安装时都不需要编译 —— 不会弹 allowBuilds 授权，也不需要本地工具链。

方式三 —— 本地目录或 tarball（离线 / 内网）

dsh plugin --profile desktop add <本地目录或 .tgz 的绝对路径>

在界面上装：插件 → 添加插件 → 填 dsh-todo-checklist，或粘贴上面的 GitHub URL。

在官方「发现」页里装：本仓库根目录带了一份 index.json，按 DSH 官方的 format 1 插件市场索引写成（source.type = git，钉在发版的 commit 上）。把它加成索引源：

1. 设置 → 插件 → 发现 → 添加索引源
2. 填这个地址（镜像，带 CORS，本机可达）：

https://cdn.jsdelivr.net/gh/qgd1850890306-rgb/dsh-todo-checklist@main/index.json

社区目录 awesome-dsh-plugin 会把 npm 上已发布的插件自动收录进它的 format 1 索引（每天刷新一次），发布到 npm 之后大约一天内就会出现在官方 Discover 里，不必手动加索引源。上方自建索引是即时可用的备用路径。

升级（npm 装法）：

dsh plugin --profile desktop add dsh-todo-checklist

卸载：

dsh plugin --profile desktop remove dsh-todo-checklist

客户端界面部分的改动需要重启 DSH 才会生效。 装成功的标志：左侧图标列多出一个「待办清单」。

---

🕹 Usage · 使用

• 加待办 —— 选中文字 → ＋ 待办 → 选 AI 记录待办，或手动填标题 / 内容 / 提醒时间。
• 设提醒时间 —— 单次模式下，先点你要调的那一段（年 / 月 / 日 / 时 / 分），再按 − / ＋：只有那一段会动（分 ±30，其余 ±1）。键盘 ↑ / ↓ 步进，← / → 换段。也可以用预设：1 小时后 / 明天 09:00 / 明天 17:00 / 工作日 09:00 / 下周一 09:00。
• 重复 —— 切到每天或每周，再选星期几和时间。
• 看与改 —— 点「待办清单」展开；勾选完成；行内 ✎ 编辑、✦ 转 AI 总结、✕ 删除；⋯ 菜单里是编辑 / 删除。
• 跳回去 —— 双击标题（或点 ↗）新建会话；新会话沿用原工作区与模型，发送后该待办自动完成。
• 导出 —— 点面板头部或设置页的导出。
• 通知渠道 —— 默认应用内弹窗；要在设置页勾上 DSH-IM 推送 才会同时推到机器人（需先装 dsh-im 并配好机器人）。

---

🔒 Data, privacy & permissions · 数据、隐私与权限

• 数据在哪 —— <DSH_HOME>/storages/dsh_todo_sidecar_items.json（<DSH_HOME> 默认 ~/.dsh）。卸载插件不会删除该文件，要清空请手动删。
• 网络 —— 插件自身不发起任何外部网络请求。只有你启用 DSH-IM 推送时，才会把提醒交给本机 DSH-IM 服务、发给你自己配置的机器人。
• 日志 —— 默认不写任何日志。排障时设 DSH_TODO_DEBUG=1，日志写入 <DSH_HOME>/dsh-todo/diag.jsonl（目录可用 DSH_TODO_STATE_DIR 改）。
• 用到的能力 —— 读会话事件（用于提醒与自动完成）、按需创建会话（AI 记录 / 新建会话）、读工作区列表、调模型（AI 记录与 AI 总结）、经 DSH-IM 发消息。
• 导出 —— 文件在浏览器里生成、走正常下载路径落盘，不上传任何内容。

---

⚠️ Known limitations · 已知限制

• 提醒依赖 DSH 正在运行 —— 没有后台常驻进程，DSH 关闭期间到点的提醒会在下次启动后补发。
• 机器人推送依赖 dsh-im —— 未安装或未配机器人时推送不可用；应用内弹窗不受影响。
• 转定时任务依赖 dsh-tasks，没有时回退官方内置调度。
• AI 记录与 AI 整理各产生一次模型调用（按你配置的模型计费）。
• 多个 DSH 实例同时运行时，同一条待办的机器人推送只会发一次（跨进程原子认领）。
• 尚未进入插件市场索引 —— 按上面的包名、GitHub 地址或插件管理器安装。

---

🩺 Troubleshooting · 故障排查

打开 F12 → Console：

• __DSH_TODO_FOLLOWUP_TRACE__ —— 最近一次「新建会话」链路的逐步打点（工作区解析、RPC、打开会话）。
• __DSH_TODO_ENTRY_ERROR__ —— 槽位渲染异常记录。

常见提示：

---

🛠 Development · 开发

dsh-todo-checklist/
├── package.json           # dsh.bundle / dsh.client / dshhub 元数据 / compatibility
├── cordis.patch.yml       # profile 配置层：插入 todo-sidecar 宿主插件
├── icon.svg               # 插件图标（同时作为 ./icon 导出）
├── locale/                # 展示元数据：en.json、zh.json（meta.title / meta.description）
├── typert.js              # 宿主面 Typert 清单源码（strict codec，loader 自动发现）
├── host/
│   ├── index.js           # todos 服务、AI 记录、提醒引擎、todo_add / todo_list / todo_export
│   └── store.js           # 存储域 + 容错解析与抢救
├── shared/
│   └── export-core.js     # 客户端与宿主共用的格式化逻辑（markdown/html/csv/json/xlsx）
├── client-src/
│   ├── index.js           # 客户端可读源码（手写 h()，无 JSX）
│   ├── export.js          # 客户端薄壳：再导出 core + 浏览器下载
│   └── segment-due-input.js
├── scripts/
│   ├── build-client.mjs   # esbuild → lib/client.js 工厂包
│   ├── build-host.mjs     # esbuild → lib/host.js、lib/typert.js（内联 zod，零依赖）
│   └── release-pack.mjs   # 打发布包：换名 + 重建产物 + 自检
└── lib/
    ├── client.js          # window.__ModuleLoader__.load({ id, factory }) 产物
    ├── host.js            # 宿主面入口（package.json 的 "main"）
    └── typert.js          # Typert 清单产物（exports["./typert"]）

• 构建全部产物：node scripts/build-host.mjs && node scripts/build-client.mjs（或 npm run build）。模块 id 恒等于包名，与官方插件一致。
• 宿主面改动必须跑 build-host.mjs —— 运行时读的是 lib/host.js，不是 host/index.js。
• dependencies 故意留空（zod 只在构建期需要，放在 devDependencies），这样 link: 安装和离线安装不会因为缺依赖而激活失败。
• 打发布包（换名 + 重建产物 + 自检）：node scripts/release-pack.mjs --name <npm 包名>。
• 官方检查：dsh-plugin-dev check（静态 16 条规则）与 dsh-plugin-dev verify（打包 → 装进干净 profile → 冒烟 → 卸载）。

---

📝 Changelog · 更新日志

见 CHANGELOG.md。近期：1.5.11 模型旁可选思考强度、提醒时间加日历、公开截图换成通用测试数据；1.5.10 设置页拆成「设置 / 待办清单」两页、点待办先关设置页再跳转、去掉多余的「默认目标」下拉；1.5.9 修复「点开较早的会话后目标那句不高亮」；1.5.8 设置页按用途重新分组、导出格式可多选；1.5.7 修复点击待办跳转会话后不高亮；1.5.6 安装说明不再写死版本号，以后发版不会再出现包内版本与实际版本不一致；1.5.5 修正 1.5.4 包内那份「这个包没有发布到 npm」的自相矛盾说明；1.5.4 导出范围改为多选（未完成 / 逾期 / 已完成 / 已放弃，取并集），并去掉多余的「给人看 / 给 AI 看」标注；1.5.3 把导出从侧栏移到设置页的可折叠区；1.5.2 修正 todo_list 把已放弃记录渲染成未勾选项的问题；1.5.1 修复插件重载后待办不可读（存储域 already-open）；1.5.0 新增导出（HTML / Markdown / Excel / CSV / JSON）与 todo_export 工具。

---

📄 License · 许可

MIT