mc-ai-code-review 1.1.24

package/dist/summarizer/index.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * 代码改动汇总模块
+ * 基于 git diff 生成结构化的 Markdown 改动摘要，输出纯文本供 CI 脚本发布到 GitLab MR
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSummary = void 0;
+const utils_1 = require("../reviewer/utils");
+const factory_1 = require("../reviewer/modelAdapters/factory");
+const buildSummarySystemPrompt = () => {
+    return [
+        "你是一位资深开发工程师，擅长分析代码改动并生成清晰的技术摘要。",
+        "你需要根据给定的 Git diff，生成一份结构化的代码改动汇总报告。",
+        "报告使用 Markdown 格式，语言为中文，内容简洁准确。",
+        "",
+        "【输出格式要求 - 极其重要】",
+        "- 你必须直接输出纯 Markdown 文本",
+        '- 禁止返回 JSON 对象（如 {"markdown": "..."}）',
+        "- 禁止用代码块（```）包裹整个输出",
+        "- 输出的第一个字符必须是 # 号（即以 Markdown 标题开头）",
+    ].join("\n");
+};
+const buildSummaryUserPrompt = (diff) => {
+    return [
+        "请根据以下 Git diff 生成一份代码改动汇总报告。",
+        "",
+        "要求：",
+        "1. 直接输出 Markdown 文本，不要包裹在代码块中；",
+        "2. 按以下结构组织内容：",
+        "",
+        "## 概述",
+        "用 1-2 句话简要说明本次改动的整体目的和范围。",
+        "",
+        "## 主要变更",
+        "按以下类别分类列出（跳过没有对应改动的类别）：",
+        "- **新功能**：新增的组件、页面、服务等",
+        "- **Bug 修复**：修复的问题及修复方案",
+        "- **重构优化**：代码结构调整、性能优化等",
+        "- **依赖更新**：package.json 等依赖变更",
+        "- **配置调整**：配置文件的修改",
+        "",
+        "每个变更项用简短的描述说明改了什么、为什么改。",
+        "",
+        "## 受影响文件",
+        "用表格列出所有改动文件：",
+        "| 文件路径 | 变更类型 | 说明 |",
+        "| --- | --- | --- |",
+        "",
+        "变更类型为：新增 / 修改 / 删除。",
+        "",
+        "## 注意事项",
+        '列出需要关注的点，例如 breaking changes、需要额外测试的地方、潜在风险等。如果没有则写"无"。',
+        "",
+        "---",
+        "",
+        "下面是 Git diff：",
+        diff,
+    ].join("\n");
+};
+/**
+ * 从 AI 返回的内容中提取纯 Markdown
+ * 先去代码块外壳，再解 JSON 包裹，不依赖固定 key 名
+ */
+const cleanMarkdownResponse = (content) => {
+    let text = content.trim();
+    // 1. 去除代码块包裹（可能套在 JSON 外层）
+    if (text.startsWith("```markdown")) {
+        text = text.slice("```markdown".length);
+    }
+    else if (text.startsWith("```md")) {
+        text = text.slice("```md".length);
+    }
+    else if (text.startsWith("```json")) {
+        text = text.slice("```json".length);
+    }
+    else if (text.startsWith("```")) {
+        text = text.slice(3);
+    }
+    if (text.endsWith("```")) {
+        text = text.slice(0, -3);
+    }
+    text = text.trim();
+    // 2. JSON 包裹：对象取首个 string 值，纯 JSON 字符串直接解包
+    if (text.startsWith("{") || text.startsWith('"')) {
+        try {
+            const parsed = JSON.parse(text);
+            if (typeof parsed === "string") {
+                text = parsed.trim();
+            }
+            else if (typeof parsed === "object" &&
+                parsed !== null &&
+                !Array.isArray(parsed)) {
+                const firstString = Object.values(parsed).find((v) => typeof v === "string");
+                if (firstString) {
+                    text = firstString.trim();
+                }
+            }
+        }
+        catch {
+            // 不是合法 JSON，继续按纯文本处理
+        }
+    }
+    // 3. 还原字面转义的换行符
+    //    某些模型会返回字面 \n 而非真实换行，导致 GitLab 无法渲染 Markdown
+    const realNewlines = (text.match(/\n/g) || []).length;
+    const literalNewlines = (text.match(/\\n/g) || []).length;
+    if (literalNewlines > 0 && literalNewlines > realNewlines) {
+        text = text
+            .replace(/\\n/g, "\n")
+            .replace(/\\t/g, "\t")
+            .replace(/\\"/g, '"');
+    }
+    return text.trim();
+};
+/**
+ * 生成代码改动汇总，返回纯 Markdown 文本（由 CI 脚本通过 GitLab API 发布）
+ */
+const generateSummary = async (diff, config) => {
+    const effectiveDiff = (0, utils_1.filterDiffByIgnore)(diff, config.review?.ignore);
+    if (!effectiveDiff || !effectiveDiff.trim()) {
+        console.error("[summarizer] diff 为空，跳过汇总");
+        return null;
+    }
+    if (!config.ai.apiKey || !config.ai.endpoint) {
+        console.error("[summarizer] 缺少 API 配置");
+        return null;
+    }
+    const systemPrompt = buildSummarySystemPrompt();
+    const userPrompt = buildSummaryUserPrompt(effectiveDiff);
+    const modelAdapter = (0, factory_1.createModelAdapterFactory)(config.ai.endpoint, config.ai.apiKey);
+    console.error("[summarizer] 正在调用 AI 生成汇总报告...");
+    const rawContent = await modelAdapter.call(config.ai.model, systemPrompt, userPrompt);
+    if (!rawContent) {
+        console.error("[summarizer] AI 未返回有效内容");
+        return null;
+    }
+    const markdown = cleanMarkdownResponse(rawContent);
+    console.error("[summarizer] 汇总报告生成完成");
+    return markdown;
+};
+exports.generateSummary = generateSummary;
+//# sourceMappingURL=index.js.map

package/dist/summarizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/summarizer/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * AI Code Review 类型定义
+ */
+export type Severity = "info" | "warning" | "error";
+/**
+ * AI 模型配置（对用户暴露的最小必要字段）
+ * - model: 模型名称，如 deepseek-chat
+ * - endpoint: 模型对应的 HTTP 接口地址
+ * - apiKey: 调用该模型所需的密钥
+ */
+export interface AIConfig {
+    model: string;
+    endpoint: string;
+    apiKey: string;
+}
+/**
+ * 规则配置
+ */
+export interface RulesConfig {
+    custom?: string[];
+}
+/**
+ * 审查策略配置
+ */
+export interface ReviewConfig {
+    severity?: Severity;
+    ignore?: string[];
+    maxComments?: number;
+}
+/**
+ * 汇总报告配置
+ */
+export interface SummaryConfig {
+    enabled?: boolean;
+}
+/**
+ * 完整配置接口
+ */
+export interface CodeReviewConfig {
+    ai: AIConfig;
+    rules?: RulesConfig;
+    review?: ReviewConfig;
+    summary?: SummaryConfig;
+}
+/**
+ * AI 返回的评论
+ */
+export interface AIComment {
+    file: string;
+    line: number;
+    /**
+     * 用于将 AI 评论与 diff 行做精确对齐：
+     * - 期望为被评论“目标行”的完整行内容（不包含 diff 前缀 +/-/空格）
+     * - 允许为空字符串（表示空行）
+     */
+    code?: string;
+    severity: Severity;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * AI 响应
+ */
+export interface AIResponse {
+    comments: AIComment[];
+}
+/**
+ * Reviewdog JSON 格式 - 诊断信息
+ */
+export interface RdjsonDiagnostic {
+    message: string;
+    location: {
+        path: string;
+        range: {
+            start: {
+                line: number;
+                column: number;
+            };
+        };
+    };
+    severity: "ERROR" | "WARNING" | "INFO";
+}
+/**
+ * Reviewdog JSON 格式 - 完整输出
+ */
+export interface RdjsonOutput {
+    source: {
+        name: string;
+    };
+    diagnostics: RdjsonDiagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM,CAAC;gBACb,MAAM,EAAE,MAAM,CAAC;aAChB,CAAC;SACH,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * AI Code Review 类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 读取 stdin
+ */
+export declare const readStdin: () => Promise<string>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS,QAAO,OAAO,CAAC,MAAM,CAavC,CAAC"}

package/dist/utils.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readStdin = void 0;
+/**
+ * 读取 stdin
+ */
+const readStdin = () => new Promise((resolve, reject) => {
+    let data = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+        data += chunk;
+    });
+    process.stdin.on("end", () => {
+        resolve(data);
+    });
+    process.stdin.on("error", (err) => {
+        reject(err);
+    });
+});
+exports.readStdin = readStdin;
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACI,MAAM,SAAS,GAAG,GAAoB,EAAE,CAC7C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QACjC,IAAI,IAAI,KAAK,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAChC,MAAM,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAbQ,QAAA,SAAS,aAajB"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "mc-ai-code-review",
+  "version": "1.1.24",
+  "description": "AI-powered code review tool for GitLab CI/CD",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "ai-code-review": "bin/ai-code-review.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "code-review",
+    "gitlab",
+    "ci-cd",
+    "reviewdog"
+  ],
+  "author": "binn <binn@micous.com>",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "dependencies": {
+    "cosmiconfig": "^9.0.0",
+    "minimist": "^1.2.8"
+  },
+  "devDependencies": {
+    "@types/minimist": "^1.2.5",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}