dsh-zentao-hub
Manifest validZenTao panel for DSH: reads the requirements, tasks and bugs assigned to you through REST v1/v2 or the official zentao-cli, dispatches an agent on a branch you name, and writes a state transition back
dsh-zentao-hub
English · 简体中文
DSH 的禅道面板:从 禅道 里读取分配给你的需求、任务与缺陷,选一个工作区、手填分支名,把选中的条目派发给 Agent;干完之后把状态和一句备注写回禅道。
本包是从 dsh-task-hub(TAPD + 禅道双来源)中把禅道部分拆分出来的独立插件,并在拆分基础上补齐了四条能力:数据通道可切换(含官方 zentao-cli)、「我的地盘」+ 未完成计数、Bug 分诊矩阵、状态回写。
四条能力
1. 数据通道:v1 / v2 / auto / zentao-cli
设置里的「数据通道」决定读写的接口来源:
| 通道 | 读 | 写 | 说明 |
|---|---|---|---|
v1 | 产品/项目枚举 | ✗ | 拆分前的行为,最保守 |
v2 | /my/* 服务端「指派给我」 | ✓ | 禅道 22.5+ 有 /my/*,22.0+ 有状态流转端点 |
auto | 先探 v2,失败回落 v1 | ✓(v2 生效时) | 换实例不用改配置 |
cli | zentao my tasks/bugs/stories | ✓ | 交给官方 zentao-cli,登录、分页、版本门槛都由它负责 |
cli 通道填的是命令行本身(默认 zentao,也支持 npx zentao-cli@0.4.4 这种带参数的形式),插件不再保存禅道密码;站点和账号从 zentao auth status 里读,任务链接照样能拼对。
为什么值得切到 cli:v1 那套「先枚举产品/项目、再本地按处理人过滤」在容器多的时候请求量线性增长;my 是服务端过滤。而且写端点、版本判断(E2010)、写后回查这些规则 CLI 已经实现过一遍,插件不用二次演绎。
2. 「我的地盘」+ 未完成计数
- 通道支持
/my/*时,面板默认直接读「指派给我」,不再需要选产品/项目(v1 会退化为枚举,禅道 <22.5 也会自动回退)。 - 侧栏那一行显示为「禅道 (N)」,N 是当前读取范围内未完成的条目数。DSH 的
sidebar.panellist只给图标传{ size, active }、行布局由侧栏自己排,没有角标位置,所以没有往图标上画气泡:计数放在label里(label是个 thunk,侧栏每次投影都会重读),读屏软件和侧栏收起后的「More」菜单都能拿到这个数字。 - 计数来源:列表加载时顺手更新;另有一条
/api/zentao/counts只取计数、不拉列表(180 秒一次,connection/reset时立刻刷一次)。
已知取舍:label 不是响应式的 —— 数字变化要等侧栏下一次投影才会更新(点一下面板、切一次会话即可);如果需要"秒变"的视觉提示,可以在图标上恢复一个小圆点。
3. Bug 分诊矩阵
「读取范围 = 产品缺陷」时多出一个「矩阵」视图:严重程度 × 状态(P1–P4 / 未填 × 待解决 / 已解决 / 已关闭),每格最多列 4 条、多的显示 +N;点条目直接进派发弹窗,补充要求会预填「先复现这个 Bug 并确认根因,再动手修改」。状态或严重程度落在轴外的条目不会消失,归到 stray 里。
提测之后真正落到开发头上的是 Bug,而「哪个 P1 还没解决」用看板要读 40 张卡,用矩阵一眼就够。
4. 回写:派发即开始
派发成功后(任务处于未开始),面板会自动打开回写弹窗,把这次派发写成一次状态流转:
PUT /tasks/31/start { realStarted: "2026-11-17 10:00:00", comment: "已派发 DSH 会话,工作分支 feature/x" }
或者走 CLI:zentao task start --task-id=31 --real-started=... --comment=...。
弹窗先给你看这次要提交的请求/命令原文,点确认才发。执行完会重新读一次条目,把「禅道现在到底是什么状态」报给你;回查失败就明说没核实,不会假装成功。
卡片上按条目当前状态并排给出动作(第一项就是主按钮,「关闭」放最后并标红);「派发 Agent」只在未开始/未认领时才是主按钮,已完成条目会提示「先重新激活再派发」:
| 动作 | 端点 | 必填 |
|---|---|---|
| 开始 | PUT /tasks/{id}/start | realStarted |
| 完成 | PUT /tasks/{id}/finish | currentConsumed、realStarted、finishedDate(面板自动预填,可改) |
| 关闭 | PUT /tasks/{id}/close | — |
| 重新激活 | PUT /tasks/{id}/activate | — |
| 指派给… | PUT /tasks/{id} / PUT /bugs/{id} | assignedTo |
| 解决 / 确认 | PUT /bugs/{id}/resolve / /confirm | resolution / — |
「指派给」是带模糊搜索的下拉(匹配姓名、账号,账号即拼音,所以输 ljl 能定位 lijialuo),五十多人也不用滚。候选人是禅道的真实人员列表(GET /users,缓存 10 分钟),不是硬编码;改派弹窗会提醒你:改派后这条会从「我的地盘」消失。一个必须承认的限制:PUT /tasks/{id} 没有 comment 字段,所以纯改派带不了备注;想留话就把 assignedTo 挂在开始/完成/激活上一起提交——面板会按这个规则来,改派弹窗里也会明说。
一个必须承认的接口限制
禅道 API 2.0 的 239 条路径里没有独立的「加备注」端点,comment 只挂在状态流转上(start / finish / close / resolve / activate)。所以「写一句备注回禅道」必然同时是一次状态变更——对派发来说这正好是 start,语义上也说得通。详见 docs/zentao-api-notes.md(端点、方法、必填字段都从 zentao-api SDK 的机器可读定义里反查得到,不是猜的)。
安装
dsh plugin --profile web add dsh-zentao-hub # 从 npm 装(推荐)
dsh plugin --profile web add github:SivanCola/dsh-zentao-hub # 或从 GitHub 装
包名与仓库名:都是
dsh-zentao-hub。刻意避开了dsh-zentao——那个名字在 npm 上属于别人的无关插件。
装完重启 dsh web,侧边栏会出现「禅道」。桌面端请在应用内的 设置 → 插件 里安装。需要 DSH 0.2.1+。用 cli 通道还需要 npm i -g zentao-cli(建议 0.4.4+)并先 zentao auth login。
首次配置
点面板右上角「设置」:
| 字段 | 说明 |
|---|---|
| 数据通道 | v1 / v2 / 自动 / zentao-cli,见上表 |
| 禅道地址 | 例如 https://zentao.example.com,会自动补 /api.php/v1 或 /v2(cli 通道可留空) |
| Basic Auth | 网关(Apache/Nginx)另有一层 HTTP 认证时打开 |
| 禅道账号 / 密码 | REST 通道必填;密码只写入 DSH credentials(也可用 ZENTAO_PASSWORD) |
| 读取范围 | 产品需求(研发/用户/业务需求)、项目任务、产品缺陷(Bug) |
| 优先读取「我的地盘」 | 通道支持时默认开;关掉就回到产品/项目枚举 |
| 产品 / 项目 | 点「读取产品」「读取项目」后勾选,或直接填 ID(cli 通道不需要) |
派发流程
- 面板列出当前范围里「处理人 = 我」的条目,按最近修改排序,可筛选 未完成 / 已完成 / 全部,按容器筛选,按任务号、父需求号或标题搜索。「读取范围」在面板顶部就能切(产品需求 / 项目任务 / 产品缺陷),切换会写回设置并重新拉取列表 —— 不必进设置页。枚举模式下(v1 通道、或关掉「我的地盘」)顶部还会多出一个「容器 · N」,可以就地勾选要读取的产品/项目并写回设置;
/my/*生效时它不出现,因为容器不参与查询。 - 点某条的「派发 Agent」,选「继续原对话」或「新开对话」。首次派发填目标工作区、分支名称(完整分支名,如
feature/order-export,用git check-ref-format校验)、worktree 与基线分支。 - 插件依次:建/复用 worktree → 建 DSH 工作区与会话 → 把标题、来源链接、完整正文、参考资料与工作环境写进输入框草稿(禅道正文里的图片与附件也会下载并挂上)→ 会话标题改为
<分支名> · <标题>→ 跳转过去。不会自动发送。 - 若是任务且还在「未开始」,紧接着弹出回写弹窗,确认后置为进行中并写明这是哪次派发。
数据与失败模式
- 设置:
~/.dsh/zentao/settings.json;派发记录:~/.dsh/zentao/state.json(按zentao:<条目 id>分)。 - 首次启动会把
~/.dsh/task-hub/里的禅道配置与zentao:*记录搬过来,TAPD 记录留在原地。 - 回写是不可逆的真实操作:计划与执行分两次调用,计划先展示,确认后才落库;
comment上限 500 字。 cli通道没有二进制下载能力(v2 也没有附件下载端点),所以没另配账号密码时草稿里会明确写「附件未随任务下发」,而不是静默丢附件。- 老版本
zentao-cli(≤0.4.1)的参数解析不同,插件会把E2009识别成「CLI 版本过旧」并给升级命令,而不是报参数错误。
开发
npm test # 114 项:纯函数、v1/v2/cli 三条读通道、回写计划与执行、git 流程、宿主路由、客户端渲染与角标
改完代码后,已安装的 bundle 需要重启 DSH 才会加载新的 JS 代次。
行为说明(几处容易误以为是 bug 的地方)
- worktree 模式下分支已在别处检出:不再报错,直接复用那个检出目录(你自己的仓库最常见),并在派发前检查该目录有没有正在跑的会话。
- 草稿附件:落在
~/.dsh/zentao/drafts/(目录 0700、文件 0600),超过 7 天的会在下次写草稿时清掉。 - 就地切换分支前的备份:备份目录里若有文件未能保存(路径不存在、非普通文件),会记在
manifest.json的skipped里,不再静默跳过。
限制
- 回写做「开始 / 完成 / 关闭 / 重新激活 / 改派 / 解决 / 确认」,但不做任意字段编辑(名称、截止日期、优先级等),也不写工时明细(完成时的
currentConsumed会提交,consumed只透传)。 - cli 通道的「我的地盘」按 CLI 版本门槛(22.5+);低于门槛时会明确报
E2010。 - 处理人过滤在 v1 通道下仍是本地的,请求量随容器数增长。
- 附件上限:单图 6MB、总附件 20MB。
- 不代替 Agent 执行计划;派发后由会话里的 Agent 自己规划与实现。
更新记录
0.2.1
- 侧栏图标与
icon.svg对齐:之前只换了包图标,侧栏那个字形是客户端代码里内联画的,所以重启也不会变。
0.2.0
- v2 通道修好了:
/users/me取代不存在的/user(否则整条/my/*会报认证失败)、分页读pager.recTotal(不再只拿第一页)、auto不会因一次网络抖动永久降级到 v1。 - 写回动作扩到 7 个:开始 / 完成 / 关闭 / 重新激活 / 指派给 / 解决 / 确认;完成时三个必填字段自动预填,「指派给」带模糊搜索的人员名单。
- 修掉 26 个审计缺陷,其中 5 条高危:
git status -z首条路径被截坏导致备份漏文件、未跟踪文件被静默覆盖、保存设置必报setApp is not defined、断网时面板白屏、设置页开 Basic Auth 必崩。 - 面板:「读取范围」搬到工具栏;容器选择只在枚举模式下出现;侧栏计数改为
禅道 (N);图标重绘为禅关圆 + 勾。 - 测试从 92 项增到 114 项。
相关链接
- dsh-task-hub:TAPD + 禅道双来源的上游项目,本插件由它拆分而来。
- npm: dsh-zentao-hub
Comments
Loading…
Similar plugins
TAPD + ZenTao task hub for DSH: list assigned work in the sidebar and dispatch an agent on a branch you name.
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-task-hubby dsh-plugin-collection
让 Herdr 认识 DSH 面板:把 agent 的 working/idle/blocked 状态报给 Herdr,支持面板跳转与 --wait。状态上报 / 终端集成。| Teaches Herdr about DSH panes: reports agent working/idle/blocked state, enabling panel jump and --wait support.
★ 0
MIT
TypeScript
Oct 15, 2026
dsh plugin --profile web add dsh-herdr-site一个 dsh host 层插件:用一张任务定义表驱动周期性任务,按时间窗与依赖把任务派发成独立会话执行(调度层零大模型介入)
★ 2
↓ 193/wk
MIT
TypeScript
dsh plugin --profile web add dsh-task-dispatch-tableGroup-chat multi-agent orchestration console for DSH: autonomous decision-making, task dispatch, verification and iterative optimization for long tasks; bundles its own backend, installs with `dsh plu
★ 0
dsh plugin --profile web add dsh-agent-hubby WuJiaoJue
Reports the dsh/cc-tui agent working, idle and blocked states to the Herdr terminal workspace manager over its custom-integration protocol, so a dsh pane gets state, panel jump and --wait support.
★ 0
↓ 66/wk
MIT
TypeScript
Sep 16, 2026
dsh plugin --profile web add dsh-herdr-siteMulti-agent orchestration controller for DSH — tiers, staged receipts, a token ledger and a run panel on top of the official Agent Teams.
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-token2biq