问题描述
当前 CLI(0.2.0)及底层 zentao-api SDK 均未注册 effort(工时日志)模块,无法通过 CLI 对工时记录进行查看、登记、编辑或删除。
工时日志目前唯一的产生途径是任务状态流转附带生成(task start / task finish),历史工时记录一旦登记有误(工作内容写错、剩余工时漏填等),CLI 无任何修正手段,只能回到 web 端手工处理。
使用场景
研发效能管理场景下,工程师及 AI Agent 需要:
- 查看任务已登记的工时记录列表(谁、哪天、耗时多少、剩余多少、工作内容)
- 在任务中途随时登记工时,而不必依赖 start/finish 状态流转
- 修正历史工时记录(工作内容、耗时、剩余工时)
- 删除误登记的工时记录
实测验证
# CLI 0.2.0
$ zentao ls effort --task 25146
Error(E2001): 未找到指定的模块 effort,请通过 `zentao help` 查看支持的模块
$ zentao create effort ...
Error(E2001): 未找到指定的模块 effort
- task 模块全部 action 仅
activate / close / finish / start,无 recordEffort / editEffort / deleteEffort
- zentao-api SDK(0.4.1)模块注册表中无 effort 相关定义
task finish 命名参数仅 currentConsumed / consumed / realStarted / finishedDate / comment,无 left(剩余工时)字段,显式填写剩余工时只能依赖 --data 透传,且服务端是否采纳无法确认
期望
按优先级排序,任一实现即可解决核心痛点:
- 新增 effort 模块:支持
ls / get / create / update / delete,与 web 端「任务 → 工时」能力对齐(禅道 web 端已具备完整工时管理,说明服务端数据模型与操作入口是现成的)
- 或在 task 模块增加扩展操作:
recordEffort(登记)、editEffort(编辑)、deleteEffort(删除)、efforts(列表)
- start / finish 支持显式 left 参数:登记工时时可明确填写剩余工时,而非依赖服务端自动清零
环境
- zentao-cli: 0.2.0(当前最新稳定版,CHANGES.md 至 Unreleased 均无 effort 相关记录)
- zentao-api: 0.4.1
- 禅道服务端: BIZ 12.7.1
问题描述
当前 CLI(0.2.0)及底层 zentao-api SDK 均未注册 effort(工时日志)模块,无法通过 CLI 对工时记录进行查看、登记、编辑或删除。
工时日志目前唯一的产生途径是任务状态流转附带生成(
task start/task finish),历史工时记录一旦登记有误(工作内容写错、剩余工时漏填等),CLI 无任何修正手段,只能回到 web 端手工处理。使用场景
研发效能管理场景下,工程师及 AI Agent 需要:
实测验证
activate / close / finish / start,无 recordEffort / editEffort / deleteEfforttask finish命名参数仅 currentConsumed / consumed / realStarted / finishedDate / comment,无 left(剩余工时)字段,显式填写剩余工时只能依赖--data透传,且服务端是否采纳无法确认期望
按优先级排序,任一实现即可解决核心痛点:
ls / get / create / update / delete,与 web 端「任务 → 工时」能力对齐(禅道 web 端已具备完整工时管理,说明服务端数据模型与操作入口是现成的)recordEffort(登记)、editEffort(编辑)、deleteEffort(删除)、efforts(列表)环境