generate_daily_report

Instructions

Implementation Reference

• src/index.js:203-240 (handler)

  Main handler function that implements the generate_daily_report tool logic: validates input, fetches GitLab commits using GitLabService, generates report content using helper, sends markdown report via WeChatService, and returns result.

  async handleGenerateDailyReport(args) {
    // 验证参数
    ErrorHandler.validateParams(args, {
      date: { required: true, type: 'string', format: 'date' },
      username: { required: false, type: 'string' },
      projectId: { required: false, type: 'string' },
    });
  
    const { username, date, projectId } = args;
    const gitlabConfig = config.getGitLabConfig();
    const actualUsername = username || gitlabConfig.username;
    
    logger.info('开始生成日报', { date, username: actualUsername, projectId });
    
    // 获取提交记录
    const commits = await this.gitlabService.getCommitsByDate(
      actualUsername,
      date,
      projectId
    );
  
    // 生成日报内容
    const report = this.generateReportContent(commits, date, actualUsername);
  
    // 发送到企业微信
    const result = await this.wechatService.sendMessage(report, 'markdown');
  
    logger.info(`日报生成并发送${result.success ? '成功' : '失败'}`, { commitCount: commits.length });
  
    return {
      content: [
        {
          type: 'text',
          text: `日报生成并发送${result.success ? '成功' : '失败'}\n\n报告内容:\n${report}`,
        },
      ],
    };
  }

• src/index.js:242-268 (helper)

  Supporting function that formats the daily report as Markdown from the list of commits, including summary stats and detailed list.

  generateReportContent(commits, date, username) {
    const commitCount = commits.length;
    const projects = [...new Set(commits.map(c => c.project_name))];
    
    let report = `# ${username} 的代码提交日报\n\n`;
    report += `**日期**: ${date}\n`;
    report += `**提交数量**: ${commitCount}\n`;
    report += `**涉及项目**: ${projects.join(', ')}\n\n`;
  
    if (commitCount === 0) {
      report += '今日无代码提交记录。';
    } else {
      report += '## 提交详情\n\n';
      commits.forEach((commit, index) => {
        report += `### ${index + 1}. ${commit.title}\n`;
        report += `- **项目**: ${commit.project_name}\n`;
        report += `- **时间**: ${new Date(commit.committed_date).toLocaleString('zh-CN')}\n`;
        report += `- **分支**: ${commit.ref_name || 'unknown'}\n`;
        if (commit.message && commit.message !== commit.title) {
          report += `- **详情**: ${commit.message.replace(commit.title, '').trim()}\n`;
        }
        report += `- **链接**: [查看提交](${commit.web_url})\n\n`;
      });
    }
  
    return report;
  }

• src/index.js:91-108 (schema)

  Input schema defining parameters for generate_daily_report tool: date (required), username and projectId (optional).

  inputSchema: {
    type: 'object',
    properties: {
      username: {
        type: 'string',
        description: 'GitLab用户名（可选，默认使用配置的用户名）',
      },
      date: {
        type: 'string',
        description: '查询日期，格式：YYYY-MM-DD',
      },
      projectId: {
        type: 'string',
        description: '项目ID（可选，不指定则查询所有项目）',
      },
    },
    required: ['date'],
  },

• src/index.js:88-109 (registration)

  Registration of the generate_daily_report tool in the ListTools response, including name, description, and input schema.

  {
    name: 'generate_daily_report',
    description: '生成并发送GitLab提交记录的日报到企业微信',
    inputSchema: {
      type: 'object',
      properties: {
        username: {
          type: 'string',
          description: 'GitLab用户名（可选，默认使用配置的用户名）',
        },
        date: {
          type: 'string',
          description: '查询日期，格式：YYYY-MM-DD',
        },
        projectId: {
          type: 'string',
          description: '项目ID（可选，不指定则查询所有项目）',
        },
      },
      required: ['date'],
    },
  },

• src/index.js:126-127 (registration)

  Dispatch/registration of the handler in the CallToolRequest switch statement.

  case 'generate_daily_report':
    return await this.handleGenerateDailyReport(args);