禅道任务面板 (zentao-panel)

在 VS Code / Qoder（及任何 VS Code 内核 IDE）侧边栏查看今天的 禅道任务、需求、Bug。

本扩展是 QODER 工作流的可视化伴侣：数据来自 .qoder/scripts/ 的禅道集成， 面板负责"一眼看全今天的活"，不改禅道、不碰 git。

功能

• 🗂 三域聚合：一次展示「指派给我的任务 + 需求 + Bug」，跨所有执行/产品全量拉取，不漏项。
• 🔴🟡 状态分组：任务按「进行中 / 未开始」分组；Bug 标严重度；需求标归属（指派给我 / 我提的）。
• 🔔 活动栏徽章：图标角标显示"待处理总数"，切换走再回来不丢状态。
• 🔄 手动/自动刷新：标题栏刷新按钮；可配置 zentaoPanel.autoRefreshMinutes 定时刷新。
• 👁 显示/隐藏已关闭项：标题栏眼睛图标切换"只看活动项 / 含历史"。
• 🔗 点击直达禅道：点卡片「禅道」按钮，在外部浏览器打开该任务/Bug 的禅道详情页。
• ✏️ 禅道写操作（v0.3+）：直接在面板里流转状态——
  • 任务：开始 / 暂停 / 完成 / 记工时
  • Bug：确认（认领） / 解决
  • 需要参数的操作（如完成填工时、解决选方式）会弹输入框；每个写操作都有归属校验（防误改队友的）和二次确认。
• 🔒 凭据安全：禅道 Token 全程留在 Python 侧，不经过 webview，符合现有安全模型。

依赖

• 本仓库已初始化 QODER 工作流：根目录存在 .qoder/scripts/domain/task/wlkj_panel.py （由 @hupan56/wlkj 随 init/update 带入；如缺失请先 npx @hupan56/wlkj init）。
• Python 3（脚本用）：扩展自动探测 python / python3 / py，找不到时可在设置里指定 zentaoPanel.pythonPath。
• 禅道凭据已配置：.qoder/config.yaml 的 zentao.url + workspace/members/<我>/.private/secrets/zentao.env。 （凭据配置见工作流文档；扩展本身不含任何密钥。）
• 内网连通：禅道在内网，本机需能直连。

安装

方式一：从 VSIX 安装（团队内分发，推荐）

code --install-extension zentao-panel-0.5.1.vsix

或在 Qoder / VS Code 中：扩展面板 → ... 菜单 →「从 VSIX 安装」→ 选 .vsix 文件。

方式二：从源码打包

cd packages/zentao-panel
npm install
npm run package        # webpack 打包 dist/extension.js
npx vsce package       # 产出 zentao-panel-0.1.0.vsix

开发调试

cd packages/zentao-panel
npm install
npm run watch          # 或在 VS Code 里按 F5（已配 launch.json，会用 qoderAll 仓库作测试工作区）

配置项

| 配置 | 默认 | 说明 | |------|------|------| | zentaoPanel.pythonPath | "" | Python 可执行路径，留空自动探测 | | zentaoPanel.autoRefreshMinutes | 0 | 自动刷新间隔（分钟），0 关闭 |

数据口径

面板数据与工作流的 my_workbench（禅道 MCP 工具）完全一致：

• 任务活动态：wait / doing / pause
• Bug 活动态：active（resolved 算已解决，剔除）
• 需求活动态：active / reviewing / changing
• 归属语义：任务/需求/Bug 都严格只认「指派给我」（assignedTo==我），不混入「我创建的」。

边界（本期不做）

• 不上架 VS Code Marketplace（团队内 VSIX 分发即可）。
• 不做指派/转交/删除等管理操作（那些是组长/测试的活，面板聚焦开发者日常高频操作）。

License

MIT