前言¶
在 DeepSeek Harness（DSH）里做日常开发或运维时，任务往往分散在笔记、聊天和外部待办工具之间；DSH 侧若缺少与桌面同屏的提醒，循环事项（工作日例会、每月报表）更难靠记忆对齐。社区插件 dsh-todos-diy 把待办、调度与提醒收进 DSH 侧边栏：数据落在本机 $DSH_HOME，提醒以页面浮层为主，可选系统通知，不接入 Agent 会话。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-todos-diy（包名与客户端 bundle id 均为 dsh-todos-diy）由维护者 huningsong 发布，在 SkillHub 插件目录 分类为工作流。当前 README 标明版本 0.7.0（schemaVersion 4），许可 MIT。
一句话定位：面向 DSH 的工作待办提醒插件——支持单次与循环（工作日 / 每周 / 每月 / 自定义 cron），主面板四阶段视图加循环、暂停独立筛选；优先级与阶段按当前时间实时派生；单次任务可选开始、必填结束时间；提醒经 shell.overlay 浮层展示，并可在设置中打开桌面系统通知。0.7.0 还包含自然语言快速添加（F10）、周报与月报（F11）等能力（见仓库 CHANGELOG 与版本规划文档）。
宿主侧不引入 @deepseek-ai/* 运行时依赖，仅使用 Node 内建模块；客户端只 require('react')。引擎要求 DSH ^0.2.1-rc.3（package.json 中 engines.dsh）。
核心功能¶
任务模型（0.2.0 起 D-25）¶
- 已删除字段
dueDate。单次任务：startAt可省略（默认创建时刻、默认不产生开始提醒），endAt必填且为唯一截止；endAt到达不会自动标记完成。 - 阶段
stage读时派生，不再依赖每日定点重算。主面板页签：未开始 / 进行中 / 已超期 / 已完成；循环与暂停单独筛选，不混入上述阶段页签（暂停 = 主动搁置，不算超期、不参与优先级）。 - 优先级只读、不落盘：24 小时内到期或已超期为高，3 天内为中，7 天内为低，更远或无结束时间为无；循环任务按
nextAt等规则参与计算（见 README「使用」表）。
循环与调度¶
- 循环类型：工作日、每周、每月、自定义 cron。
- 工作日跟随中国法定节假日与调休（内置 2024–2027 静态表）；月末不存在日期顺延到当月最后一天。
- 自研轻量调度（P0 决策 D-01，不依赖内置
ctx.schedule）；错过触发 5 分钟内补一次，超过则标missed不补发。 - 单次任务默认起止都提醒；
startAt省略时只提醒结束；会议类可关结束提醒（D-03）。
列表与交互¶
- 完成：行首圆圈；置顶 hover 行尾 📎（超期仍置顶，D-21）；暂停 hover ⏸。
- 本季度已完成留在「已完成」页签；更早季度在「历史归档」；主文件只保留本季度已完成，跨季度写入
$DSH_HOME/dsh-todos-diy/archive/completed-YYYY-Qn.json（D-24）。 - 快捷键：
N新建、/搜索、Esc关闭、↑/↓移动、Enter打开、Space完成。
提醒与统计¶
- 提醒以 DSH
shell.overlay页面浮层呈现；0.7.0 支持桌面系统通知全局开关（见 0.7.0 版本规划）。 - 统计提供六类互斥计数、
byKind与totalDone等（README 概述）。
明确不在 v1 范围¶
多用户/多设备同步、节假日表在线更新、任务模板、批量操作、日历视图、ICS 导出、未确认重复提醒、接入 Agent 会话等——README「不在本包范围」一节有完整列表。
安装与启用¶
安装命令须使用仓库 README 原文，不要用未文档化的 dsh plugin add github:... 拼接。
从 GitHub（SSH，避免 github: 简写走 HTTPS 预检超时）：
plugin_manager install_bundle target=git@github.com:huningsong/dsh-todos-diy.git
从本地开发目录：
plugin_manager install_bundle target=<本仓库的绝对路径>
安装后重启 DSH。侧边栏应出现「工作待办」入口。健康检查：
GET /api/dsh-todos-diy/health
期望载荷中 scheduler.running=true（README 安装节说明）。
npm 发布安装路径在 README 中仅描述维护者 npm publish 流程，未给出最终用户一条式命令；若你从 npm 源安装，以该源上的包说明为准。
典型用法¶
- 打开侧边栏「工作待办」，右上角「新建任务」。
- 选择循环（工作日 / 每周 / 每月 / cron）或单次（开始可留空，结束必填）。
- 到点后在 DSH 内查看提醒浮层；若已在设置中开启，可同时收到系统通知。
- 需要回顾时切换四阶段页签，或用「循环 / 暂停」筛选；查更早完成记录在「历史归档」。
- 设置页可配置时区、免打扰、提醒通道、导入导出等（具体字段以面板与
docs/requirements/需求-v1.md为准）。
HTTP API 前缀为 /api/dsh-todos-diy；持久化文件为 $DSH_HOME/dsh-todos-diy/tasks.json（单 JSON 原子写）。
适用场景与注意¶
适合：已在 DSH 桌面环境中工作、希望待办与提醒同屏、且接受本机 JSON 存储（无 v1 多设备同步）的个人或小团队。
务必注意：
- 插件在 当前 DSH 进程权限下运行，可读写
$DSH_HOME下插件目录并注册 HTTP 路由；安装前应阅读 GitHub 源码 与 MIT 许可证，自行评估是否满足环境策略。 - SkillHub 目录页星标等社区指标可能与 GitHub 不同步；功能与版本以仓库 README、
CHANGELOG.md为准。 - DSH 社区目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；非官方应用商店。
结尾¶
dsh-todos-diy 把循环规则、派生优先级、四阶段视图与浮层提醒收进 DSH 工作流分类，适合作为本机工作待办底座。进一步需求与决策编号（D-01…D-25）见仓库 docs/decisions/待讨论-缺口清单.md 与 docs/requirements/需求-v1.md。
