dsh-todo — 侧栏待办清单：列表 / Markdown 双视图，新建自动补齐创建时间、提醒时间与提醒模式

[wsqstar]

分享一个刚做好的社区插件：给 DSH 侧栏加一个待办清单面板。

两种视图，同一份数据

侧栏多一个待办图标，点开在主区域打开面板。顶部可切换「列表」和「Markdown」：

• 列表是点按式的：勾选、点行展开编辑、按 全部 / 待办 / 今天 / 已完成 筛选；
• Markdown 既是预览也是编辑器：任务项的复选框能直接点，切到源码模式改完文本点「写回清单」，会按行解析回条目——id、备注、提醒设置都不丢。

两个视图改的是同一份数据，不存在两边不同步。

新建时自动补齐三个字段

这是它和普通 todo 的主要差别。回车新建一条，插件立刻写入：

字段	自动值
创建时间	建条目那一刻
提醒时间	once 取「现在 + 60 分钟」并向上取整到 5 分钟刻度，同时作为默认截止时间；daily 取每日时刻；lead 取截止时间减提前分钟
提醒模式	none / once / daily / lead

四种模式都能在行内编辑器里改，切模式时会自动补齐该模式缺的字段——比如从「不提醒」切到「每日」但没填时刻，就补上默认时刻；切到「截止前」没填截止时间，就用提醒时间兜底。逾期、今日到期、待提醒、已提醒分别用不同状态色标出。

提醒到点后只在面板上标记，不注入会话、不打断正在跑的 turn。

面板和 agent 用同一份数据

模型可以通过 todo_board 工具（list / add / update / toggle / remove / clear_done / markdown）操作同一份清单，和面板调用的是同一组 Host 方法，所以状态变化和失败原因一致。在对话里让模型加一条，侧栏立刻看得到。

安装

已发布到 npm（v0.1.1）：

dsh plugin --profile <你的 profile> add @mappedinfo/dsh-todo

也可以直接从仓库装最新 main：

dsh plugin --profile <你的 profile> add github:Mappedinfo/dsh-todo

或者在 DSH 插件页的 Add 里填入同一个地址。装完侧栏出现待办图标，数据落在 ~/.dsh/dsh-todo/state.json（原子写入，文件损坏不会阻塞启动）。

装完如果侧栏没出现图标或模型看不到 todo_board 工具，重启一次 DSH 即可——长期运行的宿主会缓存已导入的插件模块。

仓库

https://github.com/Mappedinfo/dsh-todo

实现上只用 --dsw-alias-* 主题令牌，浅色/深色跟随宿主；没有构建步骤，Host 是原生 ESM，Client 是 __ModuleLoader__ 工厂。仓库带自检：node scripts/smoke.mjs（14 项，数据模型与 Markdown 往返）和 node scripts/client-smoke.mjs（10 项，真跑 bundle 的 factory 与两种视图渲染）。

欢迎试用、提 issue，也欢迎直接说哪里不好用。

---

English: an unofficial community plugin that adds a todo panel to the DSH sidebar, with list and Markdown views over one dataset. New tasks automatically get a creation time, a reminder time and a reminder mode (none / once / daily / lead). Install with dsh plugin --profile <profile> add github:Mappedinfo/dsh-todo. Repo: https://github.com/Mappedinfo/dsh-todo