在软件项目管理中，月报是项目经理和团队成员了解项目进展、识别风险、制定下一步计划的重要工具。传统的禅道项目月报虽然数据全面，但缺乏深度分析和智能洞察。本文将分享如何通过禅道二次开发，结合Dify AI工作流，为项目月报注入AI智能分析能力。

一、项目背景与需求分析

1.传统月报的局限性

数据罗列为主：仅展示已完成需求、未完成任务等基础数据

缺乏深度分析：需要项目经理手动分析数据背后的含义

洞察力有限：难以从海量数据中发现潜在问题和机会

2.AI智能分析的价值

自动生成深度分析：基于数据自动生成项目健康状况评估

风险预警：提前识别项目延期、资源不足等风险

智能建议：提供针对性的改进建议和优化方案

二、技术架构设计

1.整体架构

禅道月报页面 → 数据收集 → Dify API → AI工作流 → 智能分析报告 → 前端展示

2.关键技术栈

前端：ZUI框架 + JavaScript + HTML/CSS

后端：PHP（禅道扩展）

AI平台：Dify工作流

数据格式：JSON

三、Dify工作流配置与集成

1.Dify API配置类

创建通用的Dify API调用类：

window.DifyAPI = class DifyAPI {
    constructor(config = {}) {
        this.baseURL = config.baseURL || 'https://api.dify.ai/v1';
        this.apiKey = config.apiKey || '';
        this.headers = {
            'Content-Type': 'application/json',
            'Authorization': `Bearer ${this.apiKey}`
        };
    }

    async callWorkflow(params) {
        const response = await fetch(`${this.baseURL}/workflows/run`, {
            method: 'POST',
            headers: this.headers,
            body: JSON.stringify({
                inputs: params.inputs,
                response_mode: params.response_mode || 'blocking',
                user: params.user || 'zentaouser'
            })
        });
        return await response.json();
    }
}

2.禅道配置集成

在禅道语言文件中添加Dify配置：

$lang->monthly->dify = new stdclass();
$lang->monthly->dify->apiKey = 'app-pVrkX2GZXsp7NusmrsbsAD3g';
$lang->monthly->dify->baseURL = 'http://172.19.64.1:8090/v1';

3.Dify工作流

四、效果展示

预期效果

一键智能分析：项目经理点击按钮即可获得深度分析

多维度洞察：涵盖进度、质量、风险等多个维度

可执行建议：提供具体的改进措施和建议

时间节省：将数小时的手工分析缩短到几分钟

结语：AI赋能项目管理

通过禅道二次开发与Dify工作流的整合，我们成功将AI智能分析能力引入传统项目管理工具。这种集成不仅提升了月报的分析深度和实用性，也为项目管理人员提供了数据驱动的决策支持。

技术要点总结：

禅道二次开发需要熟悉其MVC架构和ZUI框架

Dify API集成要注意错误处理和超时设置

前后端数据传递要确保格式一致

用户体验要考虑加载状态和错误提示

安全性要考虑API密钥管理和访问控制

通过本文的实践案例，希望为正在探索AI与现有系统融合的开发者提供有价值的参考和启发。

目前存在的问题及解决方案：其他页面切换至月报页面时页面script脚本不会加载，这是由于禅道页面加载机制导致的，所以我们需要将相关样式放在index.ui.css里，相关js脚本放在index.ui.js里面，同时利用事件委托将智能分析按钮点击事件绑定到document上。
优化方案：

1. Dify将禅道报告分析助手工作流分成主体报告和Echarts图表生成两个工作流，在界面上分别并行渲染；
2. 将主体报告工作流调用改成流式输出调用，提升用户体验；
3. 使用zui.Markdown.parsed来转换工作流返回结果，添加表格、段落样式。