前言¶
在 DeepSeek Harness（DSH）里用智能体做多步工作时，任务往往散落在不同会话的对话里：进度要自己记，结论要回去翻聊天记录。若希望「一张卡对应一项工作、独立会话执行、看板上盯住进度、做完再验收归档」，单纯靠会话列表并不顺手。
dsh-task-board（npm 包名 dsh-color-task-board，仓库 shlan28/dsh-task-board）是维护者 shlan28 发布的 工作流 类 DSH 插件：在侧栏提供四列任务看板，把卡片派发到独立会话执行，实时折算进度，结束后把结果收到「待验收」；也支持按小时 / 天 / 周定时重复执行。本文介绍其定位、能力与安装用法，事实以仓库 README 与 package 信息为准。
这是什么¶
插件在 Harness 里注入侧栏任务看板界面，并把 Host 侧的 task_board 工具注册给会话中的 agent 使用。
- 维护者：shlan28
- 分类：工作流（社区目录 skillhub 插件页）
- 许可证：MIT
- 当前 npm 版本（package.json）：0.1.6
- 运行要求：DSH
>=0.2.1-rc.5 <0.3.0，Node>=20
看板数据落在 $DSH_HOME/task-board/board.json；定时规则交给 DSH 自带定时任务服务（$DSH_HOME/storages/schedule.json），与 Harness「自动化任务」页联动，不修改 profile 配置、不写会话日志。
核心功能¶
四列看板与拖拽¶
待办、进行中、待验收、已完成四列；卡片支持标签、进度条和执行阶段，拖拽可换列。
派发到会话与进度¶
点卡片上的 ▶ 或详情里的「开始执行」时，Harness 会新建或复用会话，把任务卡写成提示词派发进去。执行过程中的 turn/start、tool/call、assistant/message、turn/end 会实时折算成进度；卡片和详情可跳转到绑定会话。
工作区绑定¶
新建或改详情时可指定工作区：▶ 与定时执行都会在对应目录下建会话；不指定则跟随宿主默认目录。工作区从列表移除后，卡片仍使用已保存的路径。
定时自动化¶
新建任务时可将「自动化」设为「定时执行」：每小时、每天或每周（可多选星期几）。到点由 DSH 定时任务把卡片派发进独立会话；结果进「待验收」，验收后普通卡进「已完成」，自动化卡回到「待办」等待下一轮（周期任务无终态）。卡片可显示规则与下次执行时间，支持暂停、启用、改规则或取消自动化。
结果回收与验收¶
任务结束自动进入「待验收」，最后一次助手回复存为「最新结果」。验收时行为见上；执行中的卡需先停止才能改工作区等字段。
会话内 task_board 工具¶
任意会话里的 agent 可调用 task_board 加卡、查卡、改卡、派发或读结果。动作包括：add、list、update、move、run（here: true 表示在当前会话执行）、result、remove。
add / update 可带 automation 对象，例如：
{ frequency: 'daily' | 'weekly' | 'hourly' | 'none', time: 'HH:MM', weekdays: ['MO', …], timeZone, active, rrule }
以及 workspace：工作区 id、绝对路径或标题（'' 清除；缺省为当前/默认目标）。
界面与主题¶
文案跟随 DSH locale；颜色使用 --dsw-alias-* 主题 token，明暗主题通用。
安装与启用¶
仓库已包含构建产物 dist/client.js，从 npm 或 GitHub 安装时不需要本地构建。
从 npm 安装（推荐）¶
在 DSH「插件」页安装外部 bundle，包名填：
dsh-color-task-board
固定版本示例：
dsh-color-task-board@0.1.6
也可用 CLI 安装到指定 profile：
dsh plugin --profile desktop add dsh-color-task-board
从 GitHub 安装¶
在插件页填写 pnpm spec：
github:shlan28/dsh-task-board
或完整地址：
https://github.com/shlan28/dsh-task-board
安装、更新、卸载与数据路径的完整说明见仓库 docs/deploy.md。
典型用法¶
- 点侧栏看板图标进入面板，右上角「新建任务」。
- 需要周期执行时，在新建面板把「自动化」切到「定时执行」，选频率与时间（每周再选星期几）后创建。
- 需要固定在某一项目目录执行时，在「工作区」下拉选择目标（默认 = 跟随宿主）。
- 卡片上点 ▶ 开始执行；在详情查看绑定会话、阶段、最新结果，可停止、验收、退回待办或删除。
- 详情中可随时更换工作区（执行中须先停）；「自动化」区块可查看下次执行时间并暂停 / 启用 / 改规则 / 取消。
- 在会话里用自然语言描述需求，例如让 agent「把 XX 加到看板」或「每天 9 点检查部署」，由 agent 调用
task_board建卡并传入automation、workspace。
适用场景与注意¶
适合：需要在 DSH 内把「待办—执行—验收」串成可见流水线、且希望每项任务在独立会话里跑、便于回看进度与最新结论的开发者；也适合需要按 schedule 重复派发同类检查类任务的场景。
权限与安全：插件以当前 DSH 进程权限运行，派发会话内的 agent 可调用宿主已有工具。安装前请阅读 仓库源码 与 MIT 许可证，确认是否符合你的环境策略。社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
本地改代码：若自行 clone 后本地 link 安装，改 client/ 只需重新构建并刷新；改 src/（Host）需移除 bundle 再装一次 Harness 才会加载新 Host 代码。详见 README「开发」一节。
结尾¶
dsh-task-board 把侧栏看板、会话派发、进度折算和验收回收接在同一条工作流上，并用 DSH 定时任务承接周期执行。需要试用或贡献时，可从社区目录页或 GitHub 仓库进入：
- 目录页：https://www.skillhub.cn/plugins/shlan28/dsh-task-board
- GitHub：https://github.com/shlan28/dsh-task-board
