核心用法
zentao-api 是一款面向禅道项目管理系统的深度集成技能，基于 RESTful API v2.0 提供完整的项目管理自动化能力。用户通过配置 ZENTAO_URL、ZENTAO_TOKEN 等环境变量完成鉴权后，可直接对项目集、产品、项目、执行、需求、Bug、任务等 20+ 核心模块进行数据操作。
显著优点
1. 覆盖度极广：完整支持禅道核心业务流程，从需求规划（Story/Epic/Requirement）到缺陷跟踪（Bug）、任务执行（Task）、测试管理（Testcase/Testtask）直至发布管理（Release），实现 DevOps 全流程闭环
2. 状态流转原生支持：内置需求变更/关闭/激活、Bug 解决/关闭/激活、任务启动/完成/关闭等状态机操作，无需手动处理复杂的状态迁移逻辑
3. 智能缓存机制：首次登录后自动持久化 token 至 ~/.zentao-token.json，后续调用零感知复用，兼顾安全性与便捷性
4. 字段智能补全：PUT 编辑操作自动先 GET 当前数据再合并用户修改，避免字段遗漏导致的 API 报错
潜在局限
- 企业级部署依赖：需自建禅道服务器或购买官方云服务，无法直接用于 Jira、TAPD 等其他项目管理平台
- 版本锁定风险：当前基于 v2.0 API，若禅道后续大版本升级可能存在兼容性问题
- 网络可达性要求：内网部署场景下需确保运行环境与禅道服务器的网络连通
适合人群
- 研发团队负责人：批量查询项目进展、生成周报数据
- 测试工程师：自动化 Bug 创建、批量关闭已修复缺陷
- 产品经理：快速创建需求、跟踪需求状态流转
- DevOps 工程师：集成至 CI/CD 流水线，实现构建-发布数据自动同步
常规风险
- 写操作不可逆：删除操作无回收站机制，执行前务必确认
- Token 泄露风险：
~/.zentao-token.json文件需妥善保管，避免权限过大账号的 token 泄露 - 并发冲突：多用户同时编辑同一资源时可能产生覆盖冲突，关键业务建议增加人工复核环节