DSH Plugins Marketplace

DSH Plugins

Plugins

/

Workflow & Automation

/

dsh-zentao-hub

d

dsh-zentao-hub

Manifest valid

ZenTao 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

UI (client)hasBundlePatch

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 生效时)换实例不用改配置
clizentao 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}/startrealStarted
完成PUT /tasks/{id}/finishcurrentConsumed、realStarted、finishedDate(面板自动预填,可改)
关闭PUT /tasks/{id}/close—
重新激活PUT /tasks/{id}/activate—
指派给…PUT /tasks/{id} / PUT /bugs/{id}assignedTo
解决 / 确认PUT /bugs/{id}/resolve / /confirmresolution / —

「指派给」是带模糊搜索的下拉(匹配姓名、账号,账号即拼音,所以输 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 通道不需要)

派发流程

  1. 面板列出当前范围里「处理人 = 我」的条目,按最近修改排序,可筛选 未完成 / 已完成 / 全部,按容器筛选,按任务号、父需求号或标题搜索。「读取范围」在面板顶部就能切(产品需求 / 项目任务 / 产品缺陷),切换会写回设置并重新拉取列表 —— 不必进设置页。枚举模式下(v1 通道、或关掉「我的地盘」)顶部还会多出一个「容器 · N」,可以就地勾选要读取的产品/项目并写回设置;/my/* 生效时它不出现,因为容器不参与查询。
  2. 点某条的「派发 Agent」,选「继续原对话」或「新开对话」。首次派发填目标工作区、分支名称(完整分支名,如 feature/order-export,用 git check-ref-format 校验)、worktree 与基线分支。
  3. 插件依次:建/复用 worktree → 建 DSH 工作区与会话 → 把标题、来源链接、完整正文、参考资料与工作环境写进输入框草稿(禅道正文里的图片与附件也会下载并挂上)→ 会话标题改为 <分支名> · <标题> → 跳转过去。不会自动发送。
  4. 若是任务且还在「未开始」,紧接着弹出回写弹窗,确认后置为进行中并写明这是哪次派发。

数据与失败模式

  • 设置:~/.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 项。

相关链接

Comments

Loading…

Similar plugins

dsh-task-hub

TAPD + ZenTao task hub for DSH: list assigned work in the sidebar and dispatch an agent on a branch you name.

Workflow & AutomationManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-task-hub

by 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.

Tools & CapabilitiesManifest valid

★ 0

MIT

TypeScript

Oct 15, 2026

dsh plugin --profile web add dsh-herdr-site

一个 dsh host 层插件:用一张任务定义表驱动周期性任务,按时间窗与依赖把任务派发成独立会话执行(调度层零大模型介入)

Workflow & AutomationManifest valid

★ 2

↓ 193/wk

MIT

TypeScript

dsh plugin --profile web add dsh-task-dispatch-table

Group-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

Workflow & AutomationManifest valid

★ 0

dsh plugin --profile web add dsh-agent-hub

by 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.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

↓ 66/wk

MIT

TypeScript

Sep 16, 2026

dsh plugin --profile web add dsh-herdr-site

Multi-agent orchestration controller for DSH — tiers, staged receipts, a token ledger and a run panel on top of the official Agent Teams.

Workflow & AutomationManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-token2biq