本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

DSH-taskboard

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 侧栏 任务板 按钮和原生 overlay 页面（不是 iframe，也不建立第二套聊天运行时）
• 本地 SQLite 项目、任务、评论、关系、附件、工作流和自动化
• 稳定可读编号（如 DSH-42）、不透明 id，以及乐观版本
• 七种状态：backlog → todo → in_progress → in_review → done，另有 blocked、canceled
• 进程内 Agent 工具 taskboard_*（不含验收，也不含通用改状态）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装上后 DSH 里会多出什么？

侧栏底部出现"任务板"入口和原生 overlay 页面（不是 iframe，不另起聊天运行时），并向所有 Agent 注册 8 个进程内工具（taskboard_list / get / claim / comment / submit_review / block / release_claim / relate）（README.zh.md:18-32、src/index.ts:65-90、src/tool/index.ts:32-150）。

数据存在哪里？卸载插件会丢吗？

默认落在 .dsh/taskboard.sqlite（WAL 模式）和 .dsh/taskboard-attachments 目录下；首次启动由 Host 解析路径，浏览器不能改。可通过 DSH_TASKBOARD_DATABASE / DSH_TASKBOARD_ATTACHMENTS 环境变量覆盖。备份必须同时带上 SQLite（在线还要 WAL）和附件目录，要做一致离线备份请先停 Harness（README.zh.md:204-209、README.zh.md:319-344）。

为什么 Agent 工具里没有"验收/改状态"这种能力？

这是有意设计：Agent 只能把已验证工作提交到 in_review；批准、验收、退回、归档、恢复、取消、重新打开、强制接管、永久删除只能由人类（UI 或 CLI）执行。源码 requireHuman 在多个写入路径里抛错，Agent/自动化路径拿不到这些能力（README.zh.md:239-240、src/sqlite/provider.ts:344/375/394/416/556/603/658/729/753/758/792/797/811）。

遇到 TASK_STALE_VERSION（乐观冲突）怎么办？

重新读取任务详情、按当前真实版本再次提交，不要用旧版本重试。所有非创建类的写入都强制要求带上当前精确 version（UPDATE ... WHERE id = ? AND version = ? 的 SQL 在 result.changes !== 1 时抛 TASK_STALE_VERSION，CLI 退出码 5）（README.zh.md:254-256、src/sqlite/provider.ts:695、src/cli.ts:329）。

安装后需要重启 DSH 吗？

必须重启。插件的 bundle 注册和 client-modules 扫描只在启动时执行，profile 层变更不会热加载 UI；安装完成后还要轮询 GET / 含包名 + /plugins/@shengsheng/dsh-taskboard/client.js 返回 200 才算激活（README.zh.md:153-202）。

不重启 web 能直接用 dsh-taskboard CLI 吗？

可以。CLI 是独立的无头 JSON 入口，直接读 SQLite，不依赖 Harness 进程；只要 ~/.dsh/taskboard.sqlite 路径可达就能用 dsh-taskboard project list 等命令（src/cli.ts:111-148、README.zh.md:288-313）。

项目级自动化是怎么工作的？

在任务板页面为项目建一条自动化规则（间隔、Agent 预设、模型路由、工作器上限、配额），启用后 Host 调度器认领合格 todo、驱动根 Agent Session + Goal，在 in_review 停下；配额用尽会暂停新认领但不打断已在跑的工作（README.zh.md:315-317、src/automation/index.ts）。

附件大小有限制吗？

单文件默认 25 MiB、单任务默认 100 MiB；允许的类型在配置 schema 里固定为 json / pdf / zip / 图片 / markdown / 文本等（src/index.ts:49-52）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.5+
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则