vite-plugin-ai-code-review 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# vite-plugin-ai-code-review
+
+AI-powered code review plugin for Vite. Automatically review code quality, security, and best practices.
+
+## ✨ Features
+
+- 🔍 **Auto Review** - Automatically review code on build
+- 🤖 **AI Analysis** - Use OpenAI to analyze code quality
+- 🔒 **Security Check** - Detect security vulnerabilities
+- ⚡ **Performance** - Find performance issues
+- 📊 **Reports** - Generate detailed review reports
+- 🎯 **Git Integration** - Review only changed files
+
+## 📦 Installation
+
+::: code-group
+
+```bash [npm]
+npm install -D vite-plugin-ai-code-review
+```
+
+```bash [yarn]
+yarn add -D vite-plugin-ai-code-review
+```
+
+```bash [pnpm]
+pnpm add -D vite-plugin-ai-code-review
+```
+
+:::
+
+## 🚀 Quick Start
+
+```typescript
+// vite.config.ts
+import { defineConfig } from "vite";
+import { vitePluginAICodeReview } from "vite-plugin-ai-code-review";
+
+export default defineConfig({
+  plugins: [
+    vitePluginAICodeReview({
+      apiKey: process.env.OPENAI_API_KEY,
+      mode: "changed", // 'all' | 'changed'
+      level: "standard", // 'basic' | 'standard' | 'strict'
+      rules: {
+        security: "error",
+        performance: "warn",
+        style: "info",
+      },
+      output: {
+        console: true,
+        html: true,
+        markdown: true,
+      },
+    }),
+  ],
+});
+```
+
+## 📚 Documentation
+
+Full documentation: https://mo520.github.io/vite-plugin-ai/plugins/ai-code-review
+
+## 📄 License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,202 @@
+import { Plugin } from 'vite';
+
+/**
+ * AI 代码审查器
+ */
+interface ReviewIssue {
+    file: string;
+    line?: number;
+    category: "security" | "performance" | "style" | "best-practice";
+    severity: "error" | "warn" | "info";
+    message: string;
+    suggestion?: string;
+    code?: string;
+}
+interface ReviewerOptions {
+    apiKey: string;
+    apiUrl: string;
+    model: string;
+    level: "quick" | "standard" | "thorough";
+    rules: {
+        security?: string;
+        performance?: string;
+        style?: string;
+        bestPractice?: string;
+    };
+    cache: boolean;
+}
+declare class CodeReviewer {
+    private llm;
+    private options;
+    private cache;
+    constructor(options: ReviewerOptions);
+    /**
+     * 审查代码
+     */
+    review(code: string, filePath: string): Promise<ReviewIssue[]>;
+    /**
+     * 执行审查
+     */
+    private performReview;
+    /**
+     * 构建系统提示
+     */
+    private buildSystemPrompt;
+    /**
+     * 构建用户提示
+     */
+    private buildUserPrompt;
+    /**
+     * 解析问题
+     */
+    private parseIssues;
+    /**
+     * 获取语言类型
+     */
+    private getLanguage;
+    /**
+     * 生成缓存键
+     */
+    private getCacheKey;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+    /**
+     * 获取缓存统计
+     */
+    getCacheStats(): {
+        size: number;
+        hits: number;
+    };
+}
+
+/**
+ * Git 工具类
+ * 用于获取 Git 变更信息
+ * 统一策略：对比上一次提交（HEAD~1）
+ */
+declare class GitUtils {
+    /**
+     * 获取 Git 变更的文件列表
+     * 统一策略：对比上一次提交（HEAD~1）
+     */
+    getChangedFiles(): Promise<string[]>;
+    /**
+     * 检查是否在 Git 仓库中
+     */
+    private isGitRepository;
+    /**
+     * 获取与上一次提交的差异文件
+     */
+    private getCommitDiffFiles;
+    /**
+     * 获取最近一次提交的所有文件
+     */
+    private getLastCommitFiles;
+    /**
+     * 获取未提交的变更文件（降级方案）
+     */
+    private getUncommittedFiles;
+    /**
+     * 获取最近 N 次提交的变更文件
+     */
+    getRecentChangedFiles(commits?: number): Promise<string[]>;
+    /**
+     * 获取当前分支名
+     */
+    getCurrentBranch(): string;
+    /**
+     * 获取文件的 Git 状态
+     */
+    getFileStatus(filePath: string): string;
+}
+
+/**
+ * 报告生成器
+ */
+
+interface ReporterOptions {
+    console?: boolean;
+    html?: boolean;
+    markdown?: boolean;
+    json?: boolean;
+    failOnError?: boolean;
+}
+declare class Reporter {
+    private options;
+    constructor(options?: ReporterOptions);
+    /**
+     * 生成报告
+     */
+    generate(issues: ReviewIssue[]): Promise<void>;
+    /**
+     * 生成控制台报告
+     */
+    private generateConsoleReport;
+    /**
+     * 生成 HTML 报告
+     */
+    private generateHTMLReport;
+    /**
+     * 生成 Markdown 报告
+     */
+    private generateMarkdownReport;
+    /**
+     * 生成 JSON 报告
+     */
+    private generateJSONReport;
+    /**
+     * 按类别分组
+     */
+    private groupByCategory;
+    /**
+     * 获取类别图标
+     */
+    private getCategoryIcon;
+    /**
+     * 获取严重程度图标
+     */
+    private getSeverityIcon;
+}
+
+/**
+ * AI Code Review Plugin
+ *
+ * 功能：
+ * - 审查代码质量
+ * - 检测安全问题
+ * - 发现性能问题
+ * - 提供改进建议
+ */
+
+interface CodeReviewOptions {
+    apiKey?: string;
+    apiUrl?: string;
+    model?: string;
+    mode?: "changed" | "all" | "manual";
+    files?: string[];
+    level?: "quick" | "standard" | "thorough";
+    rules?: {
+        security?: "error" | "warn" | "info" | "off";
+        performance?: "error" | "warn" | "info" | "off";
+        style?: "error" | "warn" | "info" | "off";
+        bestPractice?: "error" | "warn" | "info" | "off";
+    };
+    include?: string[];
+    exclude?: string[];
+    output?: {
+        console?: boolean;
+        html?: boolean;
+        markdown?: boolean;
+        json?: boolean;
+        failOnError?: boolean;
+    };
+    cache?: boolean;
+    batchSize?: number;
+    maxConcurrent?: number;
+    enabled?: boolean;
+}
+declare function vitePluginAICodeReview(options?: CodeReviewOptions): Plugin;
+
+export { type CodeReviewOptions, CodeReviewer, GitUtils, Reporter, vitePluginAICodeReview };

package/dist/index.d.ts

@@ -0,0 +1,202 @@
+import { Plugin } from 'vite';
+
+/**
+ * AI 代码审查器
+ */
+interface ReviewIssue {
+    file: string;
+    line?: number;
+    category: "security" | "performance" | "style" | "best-practice";
+    severity: "error" | "warn" | "info";
+    message: string;
+    suggestion?: string;
+    code?: string;
+}
+interface ReviewerOptions {
+    apiKey: string;
+    apiUrl: string;
+    model: string;
+    level: "quick" | "standard" | "thorough";
+    rules: {
+        security?: string;
+        performance?: string;
+        style?: string;
+        bestPractice?: string;
+    };
+    cache: boolean;
+}
+declare class CodeReviewer {
+    private llm;
+    private options;
+    private cache;
+    constructor(options: ReviewerOptions);
+    /**
+     * 审查代码
+     */
+    review(code: string, filePath: string): Promise<ReviewIssue[]>;
+    /**
+     * 执行审查
+     */
+    private performReview;
+    /**
+     * 构建系统提示
+     */
+    private buildSystemPrompt;
+    /**
+     * 构建用户提示
+     */
+    private buildUserPrompt;
+    /**
+     * 解析问题
+     */
+    private parseIssues;
+    /**
+     * 获取语言类型
+     */
+    private getLanguage;
+    /**
+     * 生成缓存键
+     */
+    private getCacheKey;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+    /**
+     * 获取缓存统计
+     */
+    getCacheStats(): {
+        size: number;
+        hits: number;
+    };
+}
+
+/**
+ * Git 工具类
+ * 用于获取 Git 变更信息
+ * 统一策略：对比上一次提交（HEAD~1）
+ */
+declare class GitUtils {
+    /**
+     * 获取 Git 变更的文件列表
+     * 统一策略：对比上一次提交（HEAD~1）
+     */
+    getChangedFiles(): Promise<string[]>;
+    /**
+     * 检查是否在 Git 仓库中
+     */
+    private isGitRepository;
+    /**
+     * 获取与上一次提交的差异文件
+     */
+    private getCommitDiffFiles;
+    /**
+     * 获取最近一次提交的所有文件
+     */
+    private getLastCommitFiles;
+    /**
+     * 获取未提交的变更文件（降级方案）
+     */
+    private getUncommittedFiles;
+    /**
+     * 获取最近 N 次提交的变更文件
+     */
+    getRecentChangedFiles(commits?: number): Promise<string[]>;
+    /**
+     * 获取当前分支名
+     */
+    getCurrentBranch(): string;
+    /**
+     * 获取文件的 Git 状态
+     */
+    getFileStatus(filePath: string): string;
+}
+
+/**
+ * 报告生成器
+ */
+
+interface ReporterOptions {
+    console?: boolean;
+    html?: boolean;
+    markdown?: boolean;
+    json?: boolean;
+    failOnError?: boolean;
+}
+declare class Reporter {
+    private options;
+    constructor(options?: ReporterOptions);
+    /**
+     * 生成报告
+     */
+    generate(issues: ReviewIssue[]): Promise<void>;
+    /**
+     * 生成控制台报告
+     */
+    private generateConsoleReport;
+    /**
+     * 生成 HTML 报告
+     */
+    private generateHTMLReport;
+    /**
+     * 生成 Markdown 报告
+     */
+    private generateMarkdownReport;
+    /**
+     * 生成 JSON 报告
+     */
+    private generateJSONReport;
+    /**
+     * 按类别分组
+     */
+    private groupByCategory;
+    /**
+     * 获取类别图标
+     */
+    private getCategoryIcon;
+    /**
+     * 获取严重程度图标
+     */
+    private getSeverityIcon;
+}
+
+/**
+ * AI Code Review Plugin
+ *
+ * 功能：
+ * - 审查代码质量
+ * - 检测安全问题
+ * - 发现性能问题
+ * - 提供改进建议
+ */
+
+interface CodeReviewOptions {
+    apiKey?: string;
+    apiUrl?: string;
+    model?: string;
+    mode?: "changed" | "all" | "manual";
+    files?: string[];
+    level?: "quick" | "standard" | "thorough";
+    rules?: {
+        security?: "error" | "warn" | "info" | "off";
+        performance?: "error" | "warn" | "info" | "off";
+        style?: "error" | "warn" | "info" | "off";
+        bestPractice?: "error" | "warn" | "info" | "off";
+    };
+    include?: string[];
+    exclude?: string[];
+    output?: {
+        console?: boolean;
+        html?: boolean;
+        markdown?: boolean;
+        json?: boolean;
+        failOnError?: boolean;
+    };
+    cache?: boolean;
+    batchSize?: number;
+    maxConcurrent?: number;
+    enabled?: boolean;
+}
+declare function vitePluginAICodeReview(options?: CodeReviewOptions): Plugin;
+
+export { type CodeReviewOptions, CodeReviewer, GitUtils, Reporter, vitePluginAICodeReview };