dsh-taskboard 是什么？为 DeepSeek Harness 内置原生 SQLite 任务板

dsh-taskboard 是装进 DeepSeek Harness（DSH）侧边栏的原生本地任务板插件：它把 SQLite 当作唯一任务权威，管理项目、任务、评论、附件、工作流与自动化，让人和 Agent 在同一张板上建卡、执行与验收，并且职责分得清清楚楚——Agent 只能把工作提交到待审，最终完成必须由人来点。 本文介绍 dsh-taskboard 是什么、核心功能有哪些、怎么安装与启用、典型用法与常见问题。

dsh-taskboard 是什么？

dsh-taskboard 解决的是「Harness 里没有一块原生任务板」的问题：不用 iframe、不用第二个聊天运行时，在 DSH 侧边栏点一下就能打开任务板，数据全部存在本地 SQLite，人和 Agent 在同一界面里各司其职。 以下定位与事实来自官方 README（来源）：

dsh-taskboard（GitHub 仓库 shengsheng90/DSH-taskboard）由 shengsheng90 维护，Apache-2.0 协议开源，npm 包名为 @shengsheng/dsh-taskboard，是 DSH Plugin 生态里的 workflow 类 UI 插件，官方目标是兼容 DeepSeek Harness 的 web profile。它把任务板按钮放进 Harness 侧边栏底部，点击展开原生覆盖页面，并提供 Board、List、Gantt、Workflows 与 Dashboard 多种视图。设计上它不接管会话与执行：Agent Session、Goal、Workspace、工具与权限仍然属于 Harness 本身，任务板只负责「任务这一层」。任务拥有稳定可读的 key（例如 DSH-42）、不透明 id 与乐观版本号；Agent 通过进程内 taskboard_* 工具认领并处理任务，把已验证工作提交到 in_review，只有经过身份验证的人类在 UI 或 CLI 才能把任务接受为 done。

dsh-taskboard 的核心功能有哪些？

核心能力围绕「原生任务板、SQLite 本地存储、七种状态、人机验收权分离、无头 JSON CLI、打包 Skill」展开：把任务管理完整收进 Harness，同时把「谁能验收」锁死在人类手上。 以下能力来自官方 README（来源）：

• 原生任务板：Harness 侧边栏按钮加原生覆盖页，不是 iframe，也不是第二个聊天运行时。
• SQLite 本地存储：项目、任务、评论、关系、附件、工作流与自动化全部保存在本地 SQLite 中，SQLite 是唯一任务权威。
• 七种任务状态：backlog → todo → in_progress → in_review → done，外加 blocked 与 canceled。
• Agent 工具与验收分离：进程内 taskboard_* 工具没有接受与通用改状态能力，Agent 只能提交到 in_review。
• 无头 JSON CLI：dsh-taskboard 命令行工具，输出带版本的 JSON，便于脚本化与互操作。
• 打包 Skill：附带 manage-taskboard 技能，Agent 可直接按内置流程操作任务板。

怎么安装与启用 dsh-taskboard？

安装 dsh-taskboard 推荐走 npm 官方包；需要源码时按官方流程构建 tarball 再安装，绝不能直接用 git 源直装——因为 lib 目录不入 git，git 安装会缺编译产物。装完重启 Harness，侧边栏底部就会出现 Taskboard 按钮。 命令与要求来自官方 README（来源）：

1. 检查工具链（建议）：dsh-taskboard 需要较新的 Node 与 pnpm 11，先确认版本满足要求，避免构建或运行失败。

2. 从 npm 安装（推荐）：在 DeepSeek Harness 项目根目录执行，装进 web profile：

dsh plugin --profile web add @shengsheng/dsh-taskboard

3. 从源码构建 tarball（可选）：需要审阅或改动源码时，先构建再打包，然后安装 tarball：

git clone https://github.com/shengsheng90/DSH-taskboard.git
cd DSH-taskboard
pnpm install
pnpm build
pnpm pack

打包完成后，用 -w（workspace root）标志把生成的 tarball 加入 profile：

dsh plugin --profile web add -w /绝对路径/shengsheng-dsh-taskboard.tgz

4. 确认写入与重启：检查 profile 的 package.json 出现该依赖，然后重启 Harness 进程；也可用 --dump-config 查看 taskboard 配置层是否就位：

dsh --profile web --dump-config

5. 验证已加载：重启后刷新浏览器，侧边栏底部出现 Taskboard 按钮即为成功；若从命令行验证，可用 curl 请求客户端资源：

curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/plugins/@shengsheng/dsh-taskboard/client.js

6. 更新插件：重跑安装命令即可解析 npm 上的新版本（也可用宿主更新命令）：

dsh plugin --profile web update @shengsheng/dsh-taskboard

7. 卸载插件：在宿主插件管理中移除，或执行移除命令后重启：

dsh plugin remove @shengsheng/dsh-taskboard

dsh-taskboard 典型用法

dsh-taskboard 的用法是一条完整闭环：人建项目与任务并审批开工，Agent 认领执行后提交待审，人再验收通过；需要自动化或脚本化时，用内置 automation 或 JSON CLI 即可。 步骤来自官方 README（来源）：

1. 创建项目：打开 Harness Web 界面，点击侧边栏底部的 Taskboard，创建项目并填写名称与短 key（用于生成 DSH-1 这样的可读 id），Workspace 留空即为全局项目。

2. 创建任务：在项目里创建任务，新任务默认进入 backlog（也可以直接建成 todo）；用 Markdown 写描述，通过粘贴、拖拽或文件选择器附加文件。

3. 审批开工：对 backlog 任务执行 Approve for work，把它推进到 todo——Agent 与自动化只能认领符合资格的 todo 任务。

4. Agent 认领与执行：Agent 用 taskboard_claim 认领任务（携带期望版本号），在任务绑定的 Workspace、分支或 worktree 中工作，验证通过后调用 taskboard_submit_review 把工作提交到 in_review：

人建卡 → 人审批开工 → Agent/自动化认领 → Agent 工作并验证 → 提交 in_review → 人验收 done 或退回返工

5. 人类验收：打开 in_review 任务，阅读结果评论与验证证据，选择 Accept 接受为 done，或 Return for rework 退回返工；退回会释放认领。

6. 使用多种视图：按需切换 Board、List、Gantt、Workflows 与 Dashboard；页面跟随 Harness 语言（中文或英文）。先映射 Workspace 后，可在任务上用 Open in new session 打开带任务上下文的原生空白会话。

7. 自动化与脚本化：在任务板页面为项目创建 automation（间隔、Agent preset、模型路由、worker 数与配额策略），启用后宿主调度器认领符合条件的 todo，驱动根 Agent Session 与 Goal，并在 in_review 停止。脚本化操作走 JSON CLI：

dsh-taskboard --database .dsh/taskboard.sqlite project list
dsh-taskboard --database .dsh/taskboard.sqlite project create --key DSH --name "My project"
dsh-taskboard --database .dsh/taskboard.sqlite task get --task DSH-1

dsh-taskboard 常见问题与排错

常见问题集中在「按钮不出现」「git 源安装缺文件」「页面一直空白」「工具链不匹配」四类，分别对应检查 profile、改走 npm/tarball、重启后轮询、核对 Node 与 pnpm 版本。 依据来自官方 README（来源）：

1. 装完侧边栏没有 Taskboard 按钮：症状是安装成功但界面找不到入口。原因：没有装进 web profile，或 Harness 未重启（插件只在启动时装载）。解决：确认用 --profile web 安装，重启 Harness，再刷新浏览器检查侧边栏底部。

2. 用 git 源或源码目录安装后报缺 lib：症状是宿主启动报 import/apply 错误或提示包缺 bundle 入口。原因：lib 目录被 git 忽略，git 直装拿不到编译产物。解决：不要用 git 源直装，改为 npm 包或按官方流程 pnpm build && pnpm pack 后安装 tarball。

3. 页面一直空白或 client.js 404：症状是任务板打开空白、命令行请求资源返回 404。原因：安装后没重启，或检查得太早。解决：重启 Harness，等待启动完成后再轮询资源地址与页面清单，出现插件名才算就绪。

4. 构建时报工具链版本错误：症状是 pnpm install 或 pnpm build 直接失败。原因：Node 或 pnpm 版本不满足要求。解决：把 Node 升级到 22 以上（推荐 24 系列）并安装 pnpm 11 后重试，再走构建打包流程。

适用场景与注意

dsh-taskboard 适合希望把「任务管理」作为一等公民放进 DSH 工作流的用户：多任务、多 Agent 协作需要跟踪与验收，同时要求数据留本地、可审计。 适用性与限制来自官方 README（来源）：

典型场景包括：人机协作开发——人建卡、Agent 认领执行、人验收的完整闭环；多 Agent 并行——用项目 worker 数限制并发的认领与执行；自动化流水线——为项目配置 automation，让调度器定时认领并驱动 Goal；本地优先团队协作——数据存在本地 SQLite，不依赖云端服务。需要注意的限制有：要求较新的 Node（内置 node:sqlite 的 24 系列体验最好）与 pnpm 11；插件目标兼容 DeepSeek Harness 的 web profile，安装与更新都需重启宿主；数据库与附件默认落在 DSH 本机数据目录，正式备份前建议先停止 Harness，并同时备份 SQLite（含 WAL）与附件目录；Agent 永远不能自行验收，这是刻意的安全设计，不是缺失功能；自动化运行中宿主暂无主动配额信号，新规则默认按 ignore 处理，可选择 pause-on-uncertain 来暂停新认领但不取消正在运行的工作。

项目链接

dsh-taskboard 是 shengsheng90 维护的 Apache-2.0 开源项目，作为 DeepSeek Harness 的原生本地任务板持续迭代。 想查看完整功能、截图与插件信息，欢迎访问本站的 dsh-taskboard 插件详情页：dsh-taskboard。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：shengsheng90/DSH-taskboard。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。