dsh-task-board
移植自 CodexFF 的画布任务看板：父子层级任务树与任务边界，会话「任务看板」tab 内磁吸对齐的可拖拽面板，配套 `board_*` / `task_*` 模型工具与同步技能。
READMEEnglish | 中文
DSH 任务看板插件（dsh-task-board）
把 CodexFF 的项目任务看板移植为 DeepSeek Harness（DSH） 正式插件：会话内新增
对话 → 轨迹 → 任务看板 三个 tab，看板为画布式面板（拖拽 / 层级 / 折叠），配套
模型工具与同步技能，数据落在本地 JSON，无需任何外部服务。
功能特性
- 会话视图 tab：
对话 → 轨迹 → 任务看板（conversation.view，order 20）。 - 画布式看板：每主任务一个子任务面板，面板可拖拽、磁吸对齐（25px 基准间距、 顶部行对齐、纵向堆叠自动水平居中）、折叠/展开；临时任务与业务任务分色标记。
- 任务模型：父子任务树、任务边界（目标/包含/不包含/验收）、勾选完成、 子任务全部完成时自动收口父任务；新增未完成子任务会级联重开祖先任务。
- 模型工具（与 CodexFF MCP 同名语义）：
board_get/board_revision：读看板与修订号board_sync：批量创建/更新任务（一次调用内支持key引用）task_create/task_update/task_delete：单任务操作
- 技能：
dsh-task-board（任务拆分与同步纪律），模型会自动加载。 - 存储：
$DSH_HOME/taskboards/<sha256(项目路径)>.json，格式与 CodexFF 一致， 每个项目一个原子写入的 JSON 文件。
安装
方式一：一条命令安装（推荐）
▼sh复制代码dsh plugin --profile web add @etony668/dsh-task-board
然后打开或刷新 DSH 网页界面，「任务看板」tab 出现在「轨迹」之后。 插件也已收录至插件市场（workflow 分类）。
方式二：从 GitHub 克隆（备选）
macOS / Linux（bash）
▼bash复制代码git clone https://github.com/etony668/dsh-task-board.git cd dsh-task-board ./install.sh
Windows（PowerShell）
▼powershell复制代码git clone https://github.com/etony668/dsh-task-board.git cd dsh-task-board .\install.ps1
Windows 用户也可以在 Git Bash 中运行
./install.sh（效果相同）。
然后刷新 DSH 页面（或重启 DSH）即可看到「任务看板」tab。 页面无变化时重启一次 DSH —— 补丁在启动时必然生效。
方式一b：插件市场一键安装
本插件已提交 awesome-dsh-plugin 收录（workflow
分类，合并后生效）。装有 dsh-market
插件市场后，打开 DSH 设置 → 插件市场，搜索 task-board 即可一键安装，无需
手动克隆。
方式二：手动安装
-
把本仓库内容放到
~/.dsh/plugins/dsh-task-board/（或任意目录）。 -
运行
./reinstall.sh—— 它会把包复制进当前运行时node_modules/@etony668/dsh-task-board/并建立 profile 回退符号链接。 -
确认
~/.dsh/cordis.patch.yml包含（不存在则创建）：▼yaml复制代码- insert: - id: task-board name: '@etony668/dsh-task-board'
reinstall.sh/reinstall.ps1会自动探测 macOS / Windows / Linux 常见 DSH 运行时目录； 探测不到时用DSH_TASK_BOARD_RUNTIME（bash）或-RuntimeRoot（PowerShell）指定：
- bash：
DSH_TASK_BOARD_RUNTIME="/path/to/runtime" ./reinstall.sh- PowerShell：
.\reinstall.ps1 -RuntimeRoot "C:\path\to\runtime"
使用
- 顶部 tab 切换到「任务看板」；看板内无返回按钮，返回对话用顶部「对话」tab，
键盘
Tab/Esc也可返回（输入框聚焦时不劫持）。 - 看板视图下底部消息框自动隐藏，避免遮挡。
- 模型完成任务变更后会给出可点击的「查看任务看板」链接，点击即切换 tab。
升级
DSH 升级会生成新的运行时版本目录，node_modules 与 profile 符号链接需要重建：
▼bash复制代码cd ~/.dsh/plugins/dsh-task-board && ./reinstall.sh
Windows：
▼powershell复制代码cd $env:USERPROFILE\.dsh\plugins\dsh-task-board .\reinstall.ps1
cordis.patch.yml 位于 ~/.dsh，不受升级影响。
卸载
▼bash复制代码# 1) 从补丁中删除插件行（编辑 ~/.dsh/cordis.patch.yml，移除 - insert: 部分） # 2) 删除源码与运行时副本 rm -rf ~/.dsh/plugins/dsh-task-board rm -rf <runtime>/versions/*/node_modules/@etony668/dsh-task-board rm -f ~/.dsh/profiles/node_modules/@etony668/dsh-task-board # 3) 数据（可选）：~/.dsh/taskboards/*.json
目录结构
▼text复制代码index.js 包根入口（loader 以 <pkg>/index.js 解析；re-export lib/index.js） lib/index.js host 插件（node ESM）：存储 + 工具 + 技能 + /api/task-board 路由 lib/client.js web 插件 bundle（__ModuleLoader__ 手工构建，仅依赖 react） package.json dsh.client: { platform: web }，exports ./client install.sh 一键安装（复制 + 安装 + patch 写入，macOS/Linux bash） install.ps1 一键安装（Windows PowerShell） reinstall.sh 重装到当前运行时 node_modules + profile 回退符号链接（bash） reinstall.ps1 重装（Windows PowerShell）
开发
插件遵循 DSH 双端插件结构：host 端（Node ESM）提供存储/工具/技能/路由，
client 端（浏览器 bundle）注册 conversation.view tab 并渲染看板。
修改后 ./install.sh 重装并刷新页面即可；host 端改动需重启 DSH。
