vcode-analysis 0.2.0__tar.gz → 0.4.0__tar.gz

{vcode_analysis-0.2.0/vcode_analysis.egg-info → vcode_analysis-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vcode-analysis
-Version: 0.2.0
+Version: 0.4.0
 Summary: 基于大模型的智能代码分析工具，支持代码审查、文档生成、架构分析和安全扫描
 Author-email: Wellchang <2483808264@qq.com>
 License: MIT
@@ -40,7 +40,8 @@ Dynamic: license-file
 
 # Code Analysis - 智能代码分析工具
 
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI version](https://img.shields.io/pypi/v/vcode-analysis.svg)](https://pypi.org/project/vcode-analysis/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 基于私有化部署大模型的智能代码分析工具，支持代码审查、文档生成、架构分析和安全扫描。
@@ -53,6 +54,7 @@ Dynamic: license-file
 | 📝 **文档生成** | 自动生成模块文档、API 文档 |
 | 🏗️ **架构分析** | 分析项目结构、依赖关系、代码度量 |
 | 🔒 **安全扫描** | 检测常见安全漏洞和风险代码 |
+| ⚡ **并发分析** | 支持多线程并发分析，默认 5 个线程 |
 | 📦 **批量操作** | 批量克隆、批量 Git 操作、多仓库管理 |
 | 📂 **目录分析** | 扫描项目结构、识别技术栈 |
 | 🌐 **多语言支持** | Python, Java, Kotlin, C, JavaScript, TypeScript 等 |
@@ -62,20 +64,32 @@ Dynamic: license-file
 
 ### 安装
 
+**方式一：从 PyPI 安装（推荐）**
+
+```bash
+# 基础安装
+pip install vcode-analysis
+
+# 安装额外解析器支持
+pip install vcode-analysis[parsers]
+
+# 安装所有可选依赖
+pip install vcode-analysis[parsers,rich]
+```
+
+**方式二：从源码安装**
+
 ```bash
-# 克隆项目
 git clone https://gitcode.com/wellchang/code-analysis.git
 cd code-analysis
-
-# 安装依赖
-pip install httpx docopt pyyaml
+pip install -e .
 ```
 
 ### 配置
 
 ```bash
 # 初始化配置文件
-python cli.py config --init
+vcode-analysis config --init
 
 # 编辑配置文件
 # ~/.code-analysis/config.yaml
@@ -84,17 +98,20 @@ python cli.py config --init
 ### 使用
 
 ```bash
-# 代码审查
-python cli.py review ./src
+# 代码审查（结果自动保存到 result/目录名_review_时间戳.md）
+vcode-analysis review ./src
 
 # 架构分析
-python cli.py arch ./src
+vcode-analysis arch ./src
 
 # 安全扫描
-python cli.py security ./src --deep
+vcode-analysis security ./src --deep
+
+# 使用 10 个并发线程加速分析
+vcode-analysis review ./src --workers 10
 
 # 目录扫描
-python cli.py scan-dir ./project
+vcode-analysis scan-dir ./project
 ```
 
 ## 📖 命令概览
@@ -161,28 +178,37 @@ code-analysis/
 ### 代码审查
 
 ```bash
-# 审查整个项目
-python cli.py review ./src --output report.md
+# 审查整个项目（结果保存到 result/src_review_20260320_120000.md）
+vcode-analysis review ./src
+
+# 使用 10 个线程加速分析
+vcode-analysis review ./src --workers 10
+
+# 自定义输出路径
+vcode-analysis review ./src --output custom_report.md
 
 # 审查最新提交
-python cli.py review-commit HEAD
+vcode-analysis review-commit HEAD
 ```
 
 ### 安全扫描
 
 ```bash
 # 深度安全扫描
-python cli.py security ./src --deep --output security.md
+vcode-analysis security ./src --deep
+
+# 快速扫描
+vcode-analysis security ./src
 ```
 
 ### 批量操作
 
 ```bash
 # 批量克隆（从文件读取 URL 列表）
-python cli.py batch-clone repos.txt ./projects --parallel
+vcode-analysis batch-clone repos.txt ./projects --parallel
 
 # 查看多仓库状态
-python cli.py git-status ~/projects
+vcode-analysis git-status ~/projects
 ```
 
 ## ⚙️ 配置示例
@@ -242,11 +268,34 @@ parser = CASTParser()
 result = parser.parse_file('main.c', mode='fast')
 ```
 
+## 📦 发布到 PyPI
+
+### 发布新版本
+
+```bash
+# 安装发布工具
+pip install build twine
+
+# 构建包
+python -m build
+
+# 上传到 PyPI
+twine upload dist/*
+```
+
+### 发布到 TestPyPI（测试）
+
+```bash
+# 上传到 TestPyPI
+twine upload --repository testpypi dist/*
+```
+
 ## 📄 许可证
 
 [MIT License](LICENSE)
 
 ## 🔗 链接
 
+- [PyPI 包地址](https://pypi.org/project/vcode-analysis/)
 - [项目主页](https://gitcode.com/wellchang/code-analysis)
 - [问题反馈](https://gitcode.com/wellchang/code-analysis/issues)

{vcode_analysis-0.2.0 → vcode_analysis-0.4.0}/README.md

@@ -1,6 +1,7 @@
 # Code Analysis - 智能代码分析工具
 
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI version](https://img.shields.io/pypi/v/vcode-analysis.svg)](https://pypi.org/project/vcode-analysis/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 基于私有化部署大模型的智能代码分析工具，支持代码审查、文档生成、架构分析和安全扫描。
@@ -13,6 +14,7 @@
 | 📝 **文档生成** | 自动生成模块文档、API 文档 |
 | 🏗️ **架构分析** | 分析项目结构、依赖关系、代码度量 |
 | 🔒 **安全扫描** | 检测常见安全漏洞和风险代码 |
+| ⚡ **并发分析** | 支持多线程并发分析，默认 5 个线程 |
 | 📦 **批量操作** | 批量克隆、批量 Git 操作、多仓库管理 |
 | 📂 **目录分析** | 扫描项目结构、识别技术栈 |
 | 🌐 **多语言支持** | Python, Java, Kotlin, C, JavaScript, TypeScript 等 |
@@ -22,20 +24,32 @@
 
 ### 安装
 
+**方式一：从 PyPI 安装（推荐）**
+
+```bash
+# 基础安装
+pip install vcode-analysis
+
+# 安装额外解析器支持
+pip install vcode-analysis[parsers]
+
+# 安装所有可选依赖
+pip install vcode-analysis[parsers,rich]
+```
+
+**方式二：从源码安装**
+
 ```bash
-# 克隆项目
 git clone https://gitcode.com/wellchang/code-analysis.git
 cd code-analysis
-
-# 安装依赖
-pip install httpx docopt pyyaml
+pip install -e .
 ```
 
 ### 配置
 
 ```bash
 # 初始化配置文件
-python cli.py config --init
+vcode-analysis config --init
 
 # 编辑配置文件
 # ~/.code-analysis/config.yaml
@@ -44,17 +58,20 @@ python cli.py config --init
 ### 使用
 
 ```bash
-# 代码审查
-python cli.py review ./src
+# 代码审查（结果自动保存到 result/目录名_review_时间戳.md）
+vcode-analysis review ./src
 
 # 架构分析
-python cli.py arch ./src
+vcode-analysis arch ./src
 
 # 安全扫描
-python cli.py security ./src --deep
+vcode-analysis security ./src --deep
+
+# 使用 10 个并发线程加速分析
+vcode-analysis review ./src --workers 10
 
 # 目录扫描
-python cli.py scan-dir ./project
+vcode-analysis scan-dir ./project
 ```
 
 ## 📖 命令概览
@@ -121,28 +138,37 @@ code-analysis/
 ### 代码审查
 
 ```bash
-# 审查整个项目
-python cli.py review ./src --output report.md
+# 审查整个项目（结果保存到 result/src_review_20260320_120000.md）
+vcode-analysis review ./src
+
+# 使用 10 个线程加速分析
+vcode-analysis review ./src --workers 10
+
+# 自定义输出路径
+vcode-analysis review ./src --output custom_report.md
 
 # 审查最新提交
-python cli.py review-commit HEAD
+vcode-analysis review-commit HEAD
 ```
 
 ### 安全扫描
 
 ```bash
 # 深度安全扫描
-python cli.py security ./src --deep --output security.md
+vcode-analysis security ./src --deep
+
+# 快速扫描
+vcode-analysis security ./src
 ```
 
 ### 批量操作
 
 ```bash
 # 批量克隆（从文件读取 URL 列表）
-python cli.py batch-clone repos.txt ./projects --parallel
+vcode-analysis batch-clone repos.txt ./projects --parallel
 
 # 查看多仓库状态
-python cli.py git-status ~/projects
+vcode-analysis git-status ~/projects
 ```
 
 ## ⚙️ 配置示例
@@ -202,11 +228,34 @@ parser = CASTParser()
 result = parser.parse_file('main.c', mode='fast')
 ```
 
+## 📦 发布到 PyPI
+
+### 发布新版本
+
+```bash
+# 安装发布工具
+pip install build twine
+
+# 构建包
+python -m build
+
+# 上传到 PyPI
+twine upload dist/*
+```
+
+### 发布到 TestPyPI（测试）
+
+```bash
+# 上传到 TestPyPI
+twine upload --repository testpypi dist/*
+```
+
 ## 📄 许可证
 
 [MIT License](LICENSE)
 
 ## 🔗 链接
 
+- [PyPI 包地址](https://pypi.org/project/vcode-analysis/)
 - [项目主页](https://gitcode.com/wellchang/code-analysis)
 - [问题反馈](https://gitcode.com/wellchang/code-analysis/issues)

{vcode_analysis-0.2.0 → vcode_analysis-0.4.0}/analyzers/__init__.py

@@ -5,6 +5,7 @@ from .documentation import DocumentationAnalyzer, DocumentationResult
 from .architecture import ArchitectureAnalyzer, ArchitectureResult, ModuleInfo, DependencyInfo
 from .security import SecurityAnalyzer, SecurityResult, SecurityIssue
 from .directory import DirectoryAnalyzer, DirectoryAnalysisResult, ProjectInfo
+from .context_builder import ContextBuilder, AnalysisContext
 
 __all__ = [
     "CodeReviewAnalyzer",
@@ -21,4 +22,6 @@ __all__ = [
     "DirectoryAnalyzer",
     "DirectoryAnalysisResult",
     "ProjectInfo",
+    "ContextBuilder",
+    "AnalysisContext",
 ]

{vcode_analysis-0.2.0 → vcode_analysis-0.4.0}/analyzers/architecture.py

@@ -166,6 +166,16 @@ class ArchitectureAnalyzer:
         self.modules: list[ModuleInfo] = []
         self.dependencies: list[DependencyInfo] = []
 
+    def _count_lines(self, content: str) -> int:
+        """准确计算代码行数"""
+        if not content:
+            return 0
+        # 如果以换行符结尾，换行符数量就是行数
+        # 否则，行数 = 换行符数量 + 1
+        if content.endswith('\n'):
+            return content.count('\n')
+        return content.count('\n') + 1
+
     def _detect_imports(self, content: str, language: str, file_path: str = "") -> list[str]:
         """检测文件中的导入语句"""
         imports = []
@@ -349,7 +359,7 @@ class ArchitectureAnalyzer:
                 language=file_info.language,
                 imports=imports,
                 exports=[],  # TODO: 实现导出检测
-                lines=len(content.split('\n')),
+                lines=self._count_lines(content),
                 classes=structures.get("classes", 0),
                 functions=structures.get("functions", 0),
             )

vcode_analysis-0.4.0/analyzers/code_review.py

@@ -0,0 +1,307 @@
+"""代码审查分析器"""
+
+from dataclasses import dataclass
+from typing import Optional, TYPE_CHECKING
+from core.analyzer import Analyzer, FileInfo, AnalysisResult
+
+if TYPE_CHECKING:
+    from .context_builder import AnalysisContext
+
+
+@dataclass
+class CodeReviewResult:
+    """代码审查结果"""
+    file_path: str
+    score: int  # 1-10, 0 表示分析失败
+    issues: list[dict]
+    suggestions: list[str]
+    summary: str
+    success: bool = True
+
+
+def _add_line_numbers(content: str) -> str:
+    """给代码添加行号前缀，方便 LLM 准确定位问题"""
+    lines = content.split('\n')
+    max_width = len(str(len(lines)))
+    numbered_lines = [f"{i+1:>{max_width}}| {line}" for i, line in enumerate(lines)]
+    return '\n'.join(numbered_lines)
+
+
+# 代码审查提示词模板
+CODE_REVIEW_PROMPT = """请审查以下 {language} 代码:
+
+文件: {file_path}
+
+```{language}
+{content}
+```
+
+请进行代码审查，必须严格按照以下 JSON 格式输出，不要输出任何其他内容:
+
+{{"score": 评分1-10, "issues": [{{"type": "问题类型", "severity": "high/medium/low", "line": 行号, "description": "问题描述"}}], "suggestions": ["改进建议"], "summary": "代码评价总结"}}"""
+
+
+# 带上下文的代码审查提示词模板
+CODE_REVIEW_PROMPT_V2 = """请审查以下 {language} 代码:
+
+文件: {file_path}
+
+{context_section}
+
+## 当前文件代码
+```{language}
+{content}
+```
+
+请进行代码审查，必须严格按照以下 JSON 格式输出，不要输出任何其他内容:
+
+{{"score": 评分1-10, "issues": [{{"type": "问题类型", "severity": "high/medium/low", "line": 行号, "description": "问题描述", "context": "相关上下文说明(可选)"}}], "suggestions": ["改进建议"], "summary": "代码评价总结", "cross_file_issues": ["跨文件问题(可选)"]}}"""
+
+
+COMMIT_REVIEW_PROMPT = """你是一位代码审查专家。请审查以下 Git 提交的变更。
+
+提交信息: {commit_message}
+作者: {author}
+
+变更内容:
+{diff}
+
+请分析：
+1. 变更的目的和影响
+2. 潜在的问题或风险
+3. 代码风格和最佳实践
+4. 改进建议
+
+以 Markdown 格式输出审查报告。"""
+
+
+class CodeReviewAnalyzer:
+    """代码审查分析器"""
+
+    def __init__(self, analyzer: Analyzer):
+        self.analyzer = analyzer
+
+    def review_file(self, file_info: FileInfo) -> CodeReviewResult:
+        """审查单个文件"""
+        try:
+            # 读取文件内容并添加行号
+            content = self.analyzer.read_file_content(file_info)
+            numbered_content = _add_line_numbers(content)
+
+            # 构建提示词
+            prompt = CODE_REVIEW_PROMPT.format(
+                file_path=file_info.relative_path,
+                language=file_info.language,
+                content=numbered_content,
+            )
+
+            # 调用 LLM
+            response = self.analyzer.llm.simple_chat(prompt)
+
+            result = AnalysisResult(
+                file_path=file_info.relative_path,
+                analyzer="code_review",
+                success=True,
+                content=response,
+            )
+        except Exception as e:
+            result = AnalysisResult(
+                file_path=file_info.relative_path,
+                analyzer="code_review",
+                success=False,
+                content="",
+                errors=[str(e)],
+            )
+
+        if not result.success:
+            return CodeReviewResult(
+                file_path=file_info.relative_path,
+                score=0,
+                issues=[{"type": "error", "severity": "high", "description": result.errors[0]}],
+                suggestions=[],
+                summary="分析失败",
+                success=False,
+            )
+
+        # 解析 JSON 结果
+        import json
+        try:
+            # 尝试从 markdown 代码块中提取 JSON
+            content = result.content
+            if "```json" in content:
+                content = content.split("```json")[1].split("```")[0]
+            elif "```" in content:
+                content = content.split("```")[1].split("```")[0]
+
+            data = json.loads(content.strip())
+            return CodeReviewResult(
+                file_path=file_info.relative_path,
+                score=data.get("score", 0),
+                issues=data.get("issues", []),
+                suggestions=data.get("suggestions", []),
+                summary=data.get("summary", ""),
+            )
+        except json.JSONDecodeError:
+            # 如果解析失败，返回原始内容作为总结
+            return CodeReviewResult(
+                file_path=file_info.relative_path,
+                score=0,
+                issues=[],
+                suggestions=[],
+                summary=result.content,
+            )
+
+    def review_commit(self, commit_hash: str) -> AnalysisResult:
+        """审查指定提交"""
+        git = self.analyzer.git
+        if not git:
+            return AnalysisResult(
+                file_path="",
+                analyzer="code_review",
+                success=False,
+                content="",
+                errors=["目标路径不是有效的 Git 仓库"],
+            )
+
+        commit_info = git.get_commit_info(commit_hash)
+        diffs = git.get_commit_diff(commit_hash)
+
+        # 构建差异内容
+        diff_content = ""
+        for diff in diffs:
+            diff_content += f"\n### {diff.file_path}\n"
+            diff_content += f"状态: {diff.status} (+{diff.additions}/-{diff.deletions})\n"
+            diff_content += f"```diff\n{diff.diff}\n```\n"
+
+        prompt = COMMIT_REVIEW_PROMPT.format(
+            commit_message=commit_info.message,
+            author=commit_info.author,
+            diff=diff_content,
+        )
+
+        response = self.analyzer.llm.simple_chat(prompt)
+
+        return AnalysisResult(
+            file_path=commit_hash,
+            analyzer="code_review",
+            success=True,
+            content=response,
+            metadata={
+                "commit_hash": commit_hash,
+                "author": commit_info.author,
+                "date": commit_info.date.isoformat(),
+                "files_changed": commit_info.files_changed,
+            },
+        )
+
+    def review_files(self, file_infos: list[FileInfo]) -> list[CodeReviewResult]:
+        """审查多个文件"""
+        results = []
+        for file_info in file_infos:
+            result = self.review_file(file_info)
+            results.append(result)
+        return results
+
+    def review_file_with_context(
+        self,
+        file_info: FileInfo,
+        context: "AnalysisContext",
+        context_builder=None
+    ) -> CodeReviewResult:
+        """带上下文的文件审查
+
+        Args:
+            file_info: 文件信息
+            context: 分析上下文
+            context_builder: 上下文构建器（用于格式化）
+
+        Returns:
+            审查结果
+        """
+        try:
+            # 读取文件内容并添加行号
+            content = self.analyzer.read_file_content(file_info)
+            numbered_content = _add_line_numbers(content)
+
+            # 构建上下文部分
+            context_section = ""
+            if context_builder:
+                context_section = context_builder.format_context_for_prompt(
+                    file_info.relative_path, context
+                )
+
+            # 构建提示词
+            prompt = CODE_REVIEW_PROMPT_V2.format(
+                file_path=file_info.relative_path,
+                language=file_info.language,
+                context_section=context_section,
+                content=numbered_content,
+            )
+
+            # 调用 LLM
+            response = self.analyzer.llm.simple_chat(prompt)
+
+            result = AnalysisResult(
+                file_path=file_info.relative_path,
+                analyzer="code_review",
+                success=True,
+                content=response,
+            )
+        except Exception as e:
+            result = AnalysisResult(
+                file_path=file_info.relative_path,
+                analyzer="code_review",
+                success=False,
+                content="",
+                errors=[str(e)],
+            )
+
+        if not result.success:
+            return CodeReviewResult(
+                file_path=file_info.relative_path,
+                score=0,
+                issues=[{"type": "error", "severity": "high", "description": result.errors[0]}],
+                suggestions=[],
+                summary="分析失败",
+                success=False,
+            )
+
+        # 解析 JSON 结果
+        import json
+        try:
+            # 尝试从 markdown 代码块中提取 JSON
+            content = result.content
+            if "```json" in content:
+                content = content.split("```json")[1].split("```")[0]
+            elif "```" in content:
+                content = content.split("```")[1].split("```")[0]
+
+            data = json.loads(content.strip())
+
+            # 提取跨文件问题并添加到 issues
+            issues = data.get("issues", [])
+            cross_file = data.get("cross_file_issues", [])
+            if cross_file:
+                for cf_issue in cross_file:
+                    issues.append({
+                        "type": "cross_file",
+                        "severity": "medium",
+                        "description": cf_issue,
+                    })
+
+            return CodeReviewResult(
+                file_path=file_info.relative_path,
+                score=data.get("score", 0),
+                issues=issues,
+                suggestions=data.get("suggestions", []),
+                summary=data.get("summary", ""),
+            )
+        except json.JSONDecodeError:
+            # 如果解析失败，返回原始内容作为总结
+            return CodeReviewResult(
+                file_path=file_info.relative_path,
+                score=0,
+                issues=[],
+                suggestions=[],
+                summary=result.content,
+            )