- 1. 禅道介绍
- 1.1 关于禅道项目管理软件
- 1.2 如何获得支持
- 1.3 各版本功能差异
- 1.4 关注我们
- 2. 安装禅道
- 2.1. 环境搭建
- 2.1.1 搭建Ubuntu环境安装禅道
- 2.1.2 搭建Centos环境安装禅道
- 2.1.3 安装PHP的ioncube扩展
- 2.2. 安装禅道
- 2.2.1 选择适合您的安装方法
- 2.2.2 新版本禅道的安装升级
- 2.2.3 Windows一键安装包（新版）
- 2.2.4 Windows一键安装包（旧版）
- 2.2.5 linux用一键安装包(推荐)
- 2.2.6 使用源码包安装(各系统通用)
- 2.2.7 使用源码包安装(MAC系统)
- 2.2.8 基于禅道当前的一键安装包（Windows和Linux）如何源码安装旗舰版禅道
- 2.2.9 渠成命令行安装禅道
- 2.2.10 Docker和Kubernetes方式部署禅道
- 2.3 安装PHP的LDAP扩展
- 2.4 在线安装云禅道
- 2.5 安装 APCu扩展
- 2.6 安装DuckDB引擎
- 2.7. 信创支持
- 2.7.1 OceanBase数据库
- 2.8. 安装文档协同服务
- 2.8.1 安装Windows协同服务
- 2.8.2 安装Linux协同服务
- 2.1. 环境搭建
- 3. 升级禅道
- 3.1. 升级禅道新版本
- 3.1.1 选择和自己环境对应的升级方式
- 3.1.2 通过源代码方式升级(通用)
- 3.1.3 windows一键安装包的升级
- 3.1.4 linux一键安装包升级
- 3.1.5 docker安装禅道-升级禅道
- 3.1.6 旧版Docker镜像升级说明
- 3.1.7 通过Roadrunner管理定时任务
- 3.2 如何安装ioncube扩展
- 3.1. 升级禅道新版本
- 4. 维护配置
- 4.1. 维护禅道
- 4.1.1 初始化管理脚本
- 4.1.2 备份禅道
- 4.1.3 恢复删除的资源
- 4.1.4 如何更新燃尽图
- 4.1.5 一键安装包如何实现mysql异机连接
- 4.1.6 linux一键安装包配置https
- 4.1.7 禅道一键安装包迁移/更新禅道一键安装包
- 4.2. 配置禅道
- 4.2.1 设置是否允许匿名访问
- 4.2.2 如何配置email发信
- 4.2.3 如何成为超级管理员
- 4.2.4 配置禅道系统为静态访问
- 4.2.5 去掉禅道访问地址中的zentao
- 4.2.6 linux一键安装包去掉禅道访问地址中的zentao
- 4.2.7 集成禅道和svn
- 4.2.8 集成禅道和git
- 4.2.9 在第三方应用中集成禅道
- 4.2.10 第三方应用配置免密登录禅道
- 4.2.11 第三方应用集成禅道客户端进行消息通知
- 4.2.12 集成webhook
- 4.2.13 集成ZDOO
- 4.2.14 客户端集成
- 4.2.15 浏览器通知的设置
- 4.2.16 集成钉钉工作消息通知
- 4.2.17 集成企业微信应用消息通知
- 4.2.18 集成企业微信群机器人
- 4.2.19 集成飞书群机器人
- 4.2.20 集成飞书消息通知
- 4.2.21 解决一键安装包密码口令弱的问题
- 4.3. 性能优化
- 4.3.1 nginx反向代理禅道502或504bad gateway错误
- 4.3.2 linux系统中配置session使用redis
- 4.3.3 缓存功能
- 4.1. 维护禅道
- 5. 快速入门
- 5.1. 新版本快速入门
- 5.1.1 20版本禅道的新增功能
- 5.1.2 新版本禅道的最简使用
- 5.1.3 20版本禅道的界面变化
- 5.1. 新版本快速入门
- 6. 按照角色使用
- 6.1. 管理员
- 6.2. 项目集负责人
- 6.3. 产品经理
- 6.3.1 维护模块
- 6.3.2 产品多分支/平台管理
- 6.3.3 维护计划
- 6.3.4 维护需求
- 7.4.5 需求的状态和研发阶段
- 6.3.6 创建发布
- 6.3.7 跟踪进度
- 6.3.8 反馈管理（企业版）
- 6.4. 项目经理
- 6.5. 研发人员
- 6.5.1 参加产品计划会议，分解任务
- 6.5.2 领取任务，并每天更新任务
- 6.5.3 创建构建，提交测试
- 6.5.4 确认Bug，解决Bug
- 6.5.5 执行的综合、需求、Bug、任务看板
- 6.6. 测试人员
- 7. 功能介绍
- 7.1. 核心管理结构
- 7.1.1 项目集（Program）
- 7.1.2 项目（Project）
- 7.1.3 产品（Product）
- 7.1.4 执行（Execution）
- 7.1.5 管理模型
- 7.2. 地盘
- 7.3. 项目集
- 7.4. 产品
- 7.4.1 创建产品
- 7.4.2 维护模块
- 7.4.3 产品多分支/平台管理
- 7.4.4 维护计划
- 7.4.5 维护需求
- 7.4.6 需求的评审
- 7.4.7 需求的状态和研发阶段
- 7.4.8 创建发布
- 7.4.9 跟踪进度
- 7.4.10 业务需求&需求多层级
- 7.5. 项目
- 7.6. 执行
- 7.6.1 参加产品计划会议，分解任务
- 7.6.2 领取任务，并每天更新任务
- 7.6.3 创建构建，提交测试
- 7.6.4 确认Bug，解决Bug
- 7.6.5 执行的综合、需求、Bug、任务看板
- 7.7. 测试
- 7.8. 自动化测试
- 7.9 DevOps（解决方案）
- 7.10. 文档
- 7.11. AI
- 7.11.1 AI小程序简介
- 7.11.2 创建与设计AI小程序
- 7.11.3 发布与禁用小程序
- 7.11.4 调试AI小程序
- 7.11.5 前台小程序的应用
- 7.11.6 AI小程序的导入导出
- 7.11.7 管理AI小程序权限
- 7.12. BI
- 7.12.1 维度（企业版8.4+）
- 7.12.2 大屏（企业版8.4+）
- 7.12.3 透视表
- 7.12.4 透视表下钻
- 7.12.5. 大屏设计器
- 7.12.5.1 大屏设计器界面布局
- 7.12.5.2 大屏设计器引用图表
- 7.12.5.3 大屏设计器引用透视表
- 7.12.6 图表
- 7.12.7. 度量项
- 7.12.7.1 查看度量项
- 7.12.8 数据表（企业版8.4+）
- 7.13. 反馈
- 7.14. 看板
- 7.14.1 通用看板功能
- 7.15. 工作流
- 7.16. 学堂
- 7.17. 资产库（旗舰版）
- 7.17.1 资产库管理（旗舰版）
- 7.18. 组织
- 7.18.1 团队成员和工作信息
- 7.18.2 人力资源日历（需安装插件）
- 7.18.3 组织动态
- 7.18.4 公司信息
- 7.19. 办公
- 7.20. 后台设置
- 7.20.1 后台首页
- 7.20.2. 系统设置
- 7.20.3 功能开关
- 7.20.4. 人员管理
- 7.20.5. 模型配置
- 7.20.6. 功能配置
- 7.20.7 文档模板
- 7.20.8. 通知设置
- 7.20.9 插件管理
- 7.20.10 二次开发
- 7.20.11 Jira数据导入
- 7.20.12 Jira数据导入--数据迁移说明
- 7.20.13 Confluence数据导入
- 7.20.14. 权限维护和控制
- 7.20.14.1 项目集的权限维护和访问控制
- 7.20.14.2 产品的权限维护和访问控制
- 7.20.14.3 项目的权限维护和访问控制
- 7.20.14.4 执行的权限维护和访问控制
- 7.20.14.5 项目和执行的访问控制和数据关系
- 7.20.15. AI配置
- 7.20.16. DevOps设置
- 7.20.16.1. 资源
- 7.21. 客户端增强版会议SRS
- 7.21.1. 音视频会议配置
- 7.21.1.1 安装音视频服务端
- 7.21.1.2 安装SRS音视频服务端
- 7.21.1.3 开启和配置音视频功能
- 7.21.2. 发起会议
- 7.21.2.1 一对一会话中发起音视频会议
- 7.21.2.2 群组会话中发起音视频会议
- 7.21.2.3 独立发起音视频会议入口
- 7.21.3. 加入会议
- 7.21.3.1 分享音视频会议到会话
- 7.21.3.2 通过会议的ID加入会议
- 7.21.4. 预约会议
- 7.21.4.1 预约会议
- 7.21.5. 会议应用
- 7.21.5.1 音视频会议应用
- 7.21.1. 音视频会议配置
- 7.22. 客户端增强版会议Jitsi
- 7.1. 核心管理结构
- 8. AI插件
- 8.1 AI插件安装
- 8.2 ZAI服务安装
- 8.3 AI插件功能使用
- 8.4 ZAI服务控制面板使用
- 8.5 禅道MCP部署
- 9. 其他相关
- 9.1. 其他
- 9.1.1 禅道所使用到的第三方代码
- 9.1.2 禅道FAQ
- 9.1.3 如何帮助禅道项目
- 9.1.4 禅道商业服务
- 9.1.5 禅道项目的贡献者
- 9.1.6 历史修改记录
- 9.1.7 禅道对象名称的重名规则
- 9.1. 其他
- 10. IPD版本功能介绍
- 10.1. 禅道IPD版介绍
- 10.1.1 关于禅道IPD版
- 10.1.2 禅道IPD版的核心流程
- 10.2. IPD版的安装和升级
- 10.2.1 选择适合您的安装方法
- 10.2.2 选择适合您的升级方法
- 10.3. 需求与市场管理界面
- 10.4. IPD研发管理界面
- 10.1. 禅道IPD版介绍
ZAI服务控制面板使用 分享链接 /book/zentaopms/1789.html?releaseID=21
本篇目录
在zai btea2及之后，访问zai服务地址（如默认 http://10.0.0.164:5000/ ）即可进入zai控制台。
-
默认用户:
admin -
密码：
123456
左侧导航栏
应用管理
ZAI服务支持两种类型的应用。
- 聊天应用 用于支持AI对话类的场景（对AI说“你好！”）
- MCP服务 用于支持将一个功能作为MCP服务，能被AI MCP客户端调用（将查询天气的功能做成MCP服务，并配置给支持MCP功能的AI客户端后，对AI说“今天天气怎么样？”，AI会调用对应的MCP服务来查询天气并组织语言回答您的问题。）
聊天应用
创建聊天应用
点击创建新的应用以创建聊天应用。后续界面如下。
在应用描述框里添加聊天应用的描述即可创建聊天应用。
此时我们刚刚创建的聊天应用处于未发布状态。我们点击该应用，进入到应用中。此时是设置调试界面。
关于提示词
提示词应简洁明要。
关于变量
目前只有 _terminate 变量设置是有效的，用于在挂载插件的情况下避免插件输出的内容被AI二次处理。关于插件，详见插件管理章节。
关于插件
ZAI有自己的插件系统，用于丰富AI的功能，应用可以挂载ZAI系统中创建并发布的插件以增强能力。关于插件，详见插件管理章节。
保存并发布
当你修改设置调试界面的设置后，请点击保存按钮保存更改。点击发布会将应用发布，使之能被第三方调用。
查看API
点击API查看聊天应用为第三方提供的API，您可以通过此页面的信息来进行客户端的开发。禅道AI插件就是使用的这些接口。
禅道AI插件默认使用的聊天应用
当您在初始化ZAI服务./zaiiniter init后会创建一个名为zchat的聊天应用，此为禅道AI插件使用的，请不要删除。
MCP服务应用
创建MCP服务应用
同样，点击创建MCP Server创建MCP服务应用。后续界面如下。
刚刚创建的MCP服务应用处于未发布状态，点击创建的MCP服务应用的名称，进入设置与调试界面。
进入设置与调试界面后。
实质上MCP服务应用所承载的实际的功能逻辑是来源与插件的。也就是MCP服务应用为骨架，插件为内容。
查看API
MCP服务应用的API不在API页面中，在设置与调试界面中，显示的地址即为MCP服务的地址。
禅道MCP Server
如果你初始化了禅道MCP Server ./zaiiniter zentaomcp ，你将会看到一个名为zmcp的MCP服务应用。请不要删除它。
可以看到它挂载了一个ztjsplugin这个插件正是禅道MCP的功能。
插件管理
ZAI的插件能丰富聊天应用的功能，让AI调用一些外部的方法。插件也为MCP服务应用提供了内容（实际的功能）。
Javascript插件
创建JavaScript插件
点击创建JavaScript插件创建。
编辑插件信息
创建后会进入编辑插件信息界面。
点击右上角 创建 来创建这样一个插件。
环境变量设置_terminate，如果启用，则插件输出的结果不会被AI处理，直接返回给用户。
JavaScript插件内容示例
/** * 合并2个字符串，并返回 * * @api * @mcp * @param {string} str1 - 第一个字符串参数 * @param {string} str2 - 第二个字符串参数 * @returns {string} 返回合并字符串 */ function combineStrings(str1, str2) { return str1 + str2; }-
@api使得此函数能作为api被第三方调用 -
@mcp使得此函数能被MCP客户端调用
或者参照禅道MCP服务挂载的ztjsplugin，禅道MCP服务初始化操作见禅道MCP文档。
OpenAPI插件
敬请期待。
挂载插件
挂载插件到聊天应用
进入聊天应用的设置与调试界面。
挂载插件到MCP服务应用
操作与挂载插件到聊天应用相同。
空间设置
目前只有一个Default空间，后续涉及到多空间多用户会补充说明，敬请期待。
系统管理
进入系统管理页面显示如下信息。
空间管理
后续使用到多空间多用户时会补充说明，敬请期待。
系统集成
配置与第三方系统的集成。 添加系统会生成两个字段ID和Token，第三方系统向ZAI发送含有下方所示字段头信息的请求，能被ZAI验权通过。
expiredTime = xxxxxx; // Unix时间戳 appID = ID; userID = 第三方系统用户的ID; hash = md5(Token + appID + userID + expiredTime);用户管理
管理ZAI服务的用户信息，目前只一个admin就够了，你可以在此修改admin的密码。
供应商管理
能配置ZAI服务使用的模型的提供商。
模型管理
能创建、禁用、删除已被配置的模型服务商支持的模型。
创建模型
许可证
可查看、更新许可证信息。
更新许可证
名额有限
完善信息领取项目管理礼包
