禅道插件

与禅道项目管理系统集成——需求、任务、缺陷和工时管理。

概述

禅道插件通过 MySQL 直连禅道数据库，让 AI 员工可以在对话中直接管理禅道中的需求、任务和缺陷。

工具列表

工具名	功能	说明
`zentao_create_story`	创建需求	填写标题、描述、优先级等
`zentao_update_story`	更新需求	修改状态、内容、负责人
`zentao_my_stories`	查询我的需求	按状态筛选当前用户的需求
`zentao_create_task`	创建任务	关联需求，填写任务信息
`zentao_update_task`	更新任务	修改状态、进度、剩余时间
`zentao_my_tasks`	查询我的任务	查看待办、进行中的任务
`zentao_task_detail`	任务详情	查看任务完整信息和历史
`zentao_create_bug`	创建缺陷	填写缺陷信息，关联任务
`zentao_update_bug`	更新缺陷	修改状态（确认/修复/关闭）
`zentao_my_bugs`	查询我的缺陷	查看分配给我的 Bug
`zentao_log_effort`	记录工时	为任务记录实际工时

配置

环境变量

OPENVORT_ZENTAO_HOST=192.168.8.221    # 禅道数据库地址
OPENVORT_ZENTAO_USER=zentao           # 数据库用户名
OPENVORT_ZENTAO_PASSWORD=yourpassword  # 数据库密码
OPENVORT_ZENTAO_DATABASE=zentao       # 数据库名称
# 端口默认 3306，无需额外配置

也可以在 Web 管理面板的插件配置中设置。

使用示例

查看我的任务

用户: 我在禅道上还有哪些待办任务？

AI: 你当前有 3 个进行中的任务：
  1. #1024 - 用户登录页重构（剩余 4h）
  2. #1031 - API 接口文档更新（剩余 2h）
  3. #1035 - 单元测试补充（剩余 6h）

提 Bug

用户: 帮我在禅道提一个 Bug，导出功能在 Safari 上报错

AI: 好的，我帮你创建缺陷：
  - 标题：导出功能在 Safari 浏览器上报错
  - 严重程度：普通
  - 描述：用户在 Safari 浏览器中使用导出功能时出现 JS 错误
  已创建：#BUG-256。需要补充更多复现步骤吗？

记录工时

用户: 帮我记一下，任务 1024 今天干了 3 小时

AI: 已为任务 #1024「用户登录页重构」记录 3 小时工时。
  当前累计 8h / 预估 12h，进度 67%。

注意事项

禅道插件通过 MySQL 直连数据库，需要确保 OpenVort 服务器能访问禅道数据库
用户身份映射依赖通讯录插件的成员匹配