前言¶
用 DSH 这类智能体工作台时，常会遇到一个具体问题：对话里聊出来的待办事项——改天跑一个测试、下周回顾某个方案——散落在各个会话里，关掉窗口就忘了。外部待办工具可以记，但和 agent 不打通，agent 也没法替你写日程。
dsh-schedule 解决的就是这个问题：把日程管理直接装进 DSH Web 界面，同时以 agent 工具的形式暴露给模型，人在面板里操作，agent 也能在对话里代劳。下面介绍它的功能、安装方法和典型用法。
这是什么¶
dsh-schedule 是一个 DeepSeek Harness（DSH）本地日程插件，作者是 magicOF2，许可证为 MIT，当前版本 0.2.0（package.json 标明）。它的定位一句话概括：侧边栏入口加全高抽屉日程面板，支持日程-会话链接、行内编辑与详情视图、完成打勾、重复日程与 agent 工具，数据长期保存在本地文件。
插件依赖 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools 两个 peer 包，面向 web platform，需要安装到 web profile 后使用。
核心功能¶
面板与入口¶
插件提供两个入口：会话标题栏右侧的「日程」文字按钮，以及侧边栏底部的日程入口。点开后是从右侧滑出的全高抽屉面板（不是浮动小窗），内部分三个页签：
- 今天：分未完成和已完成两区；
- 本周：按天分组展示；
- 历史：月历，外加本周、本月、本年和连续完成的统计。
面板打开期间每 30 秒自动同步一次，其他会话里 agent 修改的日程也会出现。按 Esc 或点击面板外空白处关闭。
添加与编辑¶
添加表单默认收起为「+ 添加」按钮，点开才展开完整表单（标题 + 日期/重复/时间 + 备注输入），把更多空间留给日程列表。
编辑有两种方式：日程条右侧的 ✎ 按钮直接行内编辑名称、日期、重复、时间、备注和顺延开关；点击日程标题则进入详情视图，可查看完整备注（自动换行，不再截断）、完成统计、顺延历史日期与关联会话，并支持在详情里打勾、关联和删除。
重复日程支持三种类型：一次性、每天、每周（周一到周日多选）。
完成打勾与自动顺延¶
完成一项，点日程左侧圆圈打勾。完成记录按天累积，重复日程每天独立记录；勾掉的条目进入「已完成」区，次日自动清空当日记录，但历史永久保留，可在历史页签回看。
一次性日程可以勾选「未完成自动顺延」：到期未完成时，下次打开面板自动顺延到当天。顺延经过的历史日期保留在月历中，并显示「顺」标记，完成的当天会显示最终状态。
日程与会话关联¶
这是插件比较有特点的一块：日程可以和会话互相跳转。
1、日程条右侧的 ⊕ 按钮一键关联当前会话；
2、输入框右侧的 🔗 按钮弹出日程列表，从中选择关联；
3、一个日程可以关联多个会话；
4、点击会话标签跳转回关联会话。
Agent 工具¶
插件向 agent 暴露六个工具：dailytask_add、dailytask_list、dailytask_set_done、dailytask_update、dailytask_delete、dailytask_link_session。也就是说，在任意对话里说一句「帮我记一条日程」，模型就能通过工具直接写入，不需要你手动打开面板。
存储与数据安全¶
数据保存在本地文件 ~/.dsh/dsh-schedule-data.json，结构为 items（日程定义）+ done（按日程 ID 到日期累积的完成记录）。完成历史永不删除，旧版数据文件会自动迁移。文件损坏时，插件会先把原文件备份为 .corrupt-时间戳，再以空数据启动，绝不覆盖原文。备份只需拷贝这一个文件。
安装与启用¶
官方安装方式是从源码构建后装入 web profile。先克隆仓库并构建、跑测试：
git clone https://github.com/magicOF2/dsh-schedule.git
cd dsh-schedule
pnpm build
pnpm test
pnpm build 产出 lib/ 目录（Host 端 ESM + Client bundle）；pnpm test 基于 node --test，覆盖存储核心和客户端纯视图逻辑，测试在 Windows/macOS/Linux 下均可用。
构建通过后，安装到 web profile：
dsh plugin --profile web add /path/to/dsh-schedule
其中 /path/to/dsh-schedule 换成你本地的仓库路径。最后重启 DSH：
dsh web
经过上面的步骤，重启后即可在侧边栏或会话标题栏看到日程入口。
典型用法¶
日常使用流程大致如下：
- 打开 DSH Web，从侧边栏底部或会话标题栏右侧打开日程面板；
- 点「+ 添加」展开表单，填写标题、日期/重复/时间和备注；一次性日程可勾选「未完成自动顺延」；
- 完成一项，点左侧圆圈打勾，条目进入「已完成」区；
- 需要修改时，日程条右侧 ✎ 行内编辑，或点标题进详情页；
- 想把当前会话和某个日程挂上钩，点日程条 ⊕ 或输入框右侧 🔗，之后点会话标签可跳回原会话；
- 到「历史」页签看月历和本周/本月/本年/连续完成统计，顺延过的日期会带「顺」标记；
- 不想动手时，直接在对话里说「帮我记一条日程」，agent 会调用工具完成。
适用场景与注意事项¶
适合的场景：日常在 DSH Web 里工作、待办和对话强相关的人。日程跟着界面走，agent 能读写，完成历史长期留在本地文件里，适合做周/月维度的回顾。
几点注意：
- 插件需安装到 web profile 并重启 DSH（
dsh web）后才能使用； - 数据在
~/.dsh/dsh-schedule-data.json，定期备份拷贝这个文件即可； - 和所有 DSH 插件一样，插件以当前 dsh 进程的权限运行。安装前建议先检查源码和许可证——这个项目是 MIT，仓库公开，构建和测试命令都可以本地执行验证；
- 该插件目前在 DSH Web（web platform）下使用。
另外说明：社区插件目录（skillhub.cn）是独立站点，与 DeepSeek、幻方没有官方从属关系，仅作索引用途。
小结¶
dsh-schedule 做的事情不复杂：把日程放进 DSH Web，给 agent 一组工具，把数据留在本地一个 JSON 文件里。入口、编辑、打勾、顺延、会话关联这些细节都处理得比较完整，适合把日常工作流和 agent 会话放在一处的人。
- GitHub：https://github.com/magicOF2/dsh-schedule
- 目录页：https://www.skillhub.cn/plugins/magicOF2/dsh-schedule
