前言¶

在 DeepSeek Harness（DSH）里做日常任务，常见做法是另开一个备忘录或让 agent 只记在对话里。清单和对话两套状态容易脱节：侧栏里勾掉的项，对话里可能还在；循环任务、工作日调休也很难用通用笔记表达。dsh-quadrant-todo 是挂在侧栏的待办插件（侧栏显示名「待办」），数据落在 profile 下的 JSON，并通过 personal_todo 工具与 agent 读写同一份 todos.json。下面介绍它的定位、安装方式与典型用法。

这是什么¶

维护者 ZIYE-JK（社区目录分类：工作流）。仓库与插件标识统一为 dsh-quadrant-todo，上游自 Natte 的 dsh-sidebar-todo@0.2.3 演进并大幅重写。README 写明当前能力对应版本 1.1.0（四象限矩阵、周/月视图、统计、按开始时刻的系统与飞书通知、每日检查点、法定工作日与艾宾浩斯重复）；package.json 中版本号为 1.2.0，安装前以你实际拉取的提交为准。

插件不依赖 npm 上的 @deepseek-ai/* 包，只使用宿主运行时提供的 ModuleLoader、侧栏槽位、Web 路由与工具注册等契约。数据默认路径为 %DSH_PROFILE_DIR%/data/dsh-todolist/todos.json，可直接备份或手工编辑。

核心功能¶

左栏四个主界面：做计划（艾森豪威尔四象限）、月视图、周视图、统计。

新建与编辑：支持标题、备注、日期、时间、优先级、分类、重复规则；弹窗顶部「一句话填写」可解析如「明天下午3点 交周报 #工作」。未排期任务在详情列「编辑」里排期。

循环任务：每天 / 每周（可多选周几）/ 每月 / 每年 / 法定工作日（跟随中国调休）/ 艾宾浩斯记忆曲线（1、2、4、7、15、30、60 天），可设结束日期。列表只展示本周期应完成的一次；勾选本次完成后行保留并加删除线。每月 31 号在短月落到当月最后一天。

通知：顶部喇叭配置系统通知与飞书通知（飞书需同宿主启用 dsh-im）。提醒对齐任务开始时刻，支持 leadMinutes、逾期后每日提醒、默认 11:00 与 16:00 的每日检查点汇总，以及静默时段。

agent 工具 personal_todo：action 为 list / add / update / complete / confirm / delete；支持 repeat 与循环任务的 date 完成指定次。工具可从口语推断重复规则，例如在对话中说「每周一到周五 18 点交日报」即可建任务。

兼容性（摘自 README 验证表）：在宿主 0.2.2-rc.1 下插件 1.1.0 已于 2026-11-09 标记可用；engines.dsh 要求 >=0.2.1-rc.2 || >=0.2.2-rc.1，Node >=22。升级宿主后建议：重载插件 → 侧栏打开「待办」→ agent 调用一次 personal_todo list。

安装与启用¶

npm 包名已定为 dsh-quadrant-todo，README 注明尚未发布到 npm；当前推荐从 GitHub 安装。

从 GitHub 源码安装：

dsh plugin --profile web add github:ZIYE-JK/dsh-quadrant-todo

npm 发布后或将来的市场安装方式（README 原文）：

dsh plugin --profile web add dsh-quadrant-todo

装完后侧栏「自动化任务」下方出现「待办」；也可在宿主 插件 → 发现 搜索 dsh-quadrant-todo 或「待办」。本机开发可用 plugin_manager install_bundle，target 指向仓库目录；改 index.js 需关开插件行重载，改 client.js 可由 HMR 拾取。

可选配置写在 cordis.patch.yml 对应插件行的 config：

- id: dsh-quadrant-todo
  config:
    staleDays: 7   # 超过多少天还没定日期算「积压」
    dataPath: ''   # 可选，覆盖默认数据文件路径

通知相关字段在界面或数据中形如（节选）：

"notify": {
  "system": true,
  "feishu": true,
  "leadMinutes": 5,
  "overdueDaily": true,
  "checkpoints": ["11:00", "16:00"],
  "quietHours": { "enabled": false, "start": "22:00", "end": "08:00" }
}

典型用法¶

1. 侧栏进入「做计划」，用四象限拖拽或新建安排优先级；切「月视图」「周视图」看日历密度，在「统计」看完成情况。
2. 用一句话快速建项：明天下午3点 交周报 #工作，再微调日期选择器（含今天/明天/下周一快捷）。
3. 需要 agent 代劳时，让模型调用 personal_todo：list 查看（循环任务会标注「循环·本次 MM-DD」），add/update 带 repeat，complete 对循环任务传入 date 指定完成哪一次。
4. 开启通知后，在静默时段外接收开始提醒与检查点汇总；飞书通道需 dsh-im 已启用。

数据文件示例结构：

{ "version": 1, "todos": [ { "id": "t_...", "title": "交周报", "dueDate": "2026-10-22", "done": false } ] }

损坏时会备份为 todos.corrupt-<时间戳>.json 并以空清单启动。

适用场景与注意¶

适合在 DSH 内长期驻留、希望侧栏与 agent 共用一套待办、且需要中国工作日调休或艾宾浩斯复习节奏的个人工作流。分类由待办里的标签名自然增长，可在页头「分类」统一管理。

安装前建议自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，数据文件路径位于你的 profile 目录。README 明确：不要与上游 dsh-sidebar-todo 同装，二者会争用 /todo/api 与同一路径的 todos.json。

社区目录页：dsh-quadrant-todo @ SkillHub。源码与完整说明：github.com/ZIYE-JK/dsh-quadrant-todo。SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系。