vcode-analysis 0.3.0__tar.gz → 0.5.0__tar.gz

{vcode_analysis-0.3.0/vcode_analysis.egg-info → vcode_analysis-0.5.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: vcode-analysis
-Version: 0.3.0
+Version: 0.5.0
 Summary: 基于大模型的智能代码分析工具，支持代码审查、文档生成、架构分析和安全扫描
 Author-email: Wellchang <2483808264@qq.com>
 License: MIT
-Project-URL: Homepage, https://gitcode.com/wellchang/code-analysis
-Project-URL: Repository, https://gitcode.com/wellchang/code-analysis
-Project-URL: Documentation, https://gitcode.com/wellchang/code-analysis/blob/master/docs/USER_MANUAL.md
-Project-URL: Bug Tracker, https://gitcode.com/wellchang/code-analysis/issues
+Project-URL: Homepage, https://xxxxxx
+Project-URL: Repository, https://xxxxxx
+Project-URL: Documentation, https://xxxxxx
+Project-URL: Bug Tracker, https://xxxxxx
 Keywords: vcode-analysis,llm,code-review,documentation
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -54,11 +54,13 @@ Dynamic: license-file
 | 📝 **文档生成** | 自动生成模块文档、API 文档 |
 | 🏗️ **架构分析** | 分析项目结构、依赖关系、代码度量 |
 | 🔒 **安全扫描** | 检测常见安全漏洞和风险代码 |
+| 🔗 **上下文增强** | 解析项目依赖关系，提供关联文件上下文给 LLM |
 | ⚡ **并发分析** | 支持多线程并发分析，默认 5 个线程 |
 | 📦 **批量操作** | 批量克隆、批量 Git 操作、多仓库管理 |
 | 📂 **目录分析** | 扫描项目结构、识别技术栈 |
-| 🌐 **多语言支持** | Python, Java, Kotlin, C, JavaScript, TypeScript 等 |
+| 🌐 **多语言支持** | Python, Java, Kotlin, C/C++, JavaScript, TypeScript, Vue 等 |
 | 🤖 **私有化部署** | 兼容 OpenAI API 格式，支持任何私有化 LLM |
+| 🌍 **环境变量** | 支持环境变量配置，方便 CI/CD 集成 |
 
 ## 🚀 快速开始
 
@@ -80,11 +82,21 @@ pip install vcode-analysis[parsers,rich]
 **方式二：从源码安装**
 
 ```bash
-git clone https://gitcode.com/wellchang/code-analysis.git
+git clone 
 cd code-analysis
 pip install -e .
 ```
 
+**方式三：离线安装**
+
+```bash
+# Windows
+install_offline.bat
+
+# Linux/macOS
+bash install_offline.sh
+```
+
 ### 配置
 
 ```bash
@@ -98,7 +110,7 @@ vcode-analysis config --init
 ### 使用
 
 ```bash
-# 代码审查（结果自动保存到 result/目录名_review_时间戳.md）
+# 代码审查（默认启用批量分析和缓存，大幅减少 API 调用）
 vcode-analysis review ./src
 
 # 架构分析
@@ -110,10 +122,43 @@ vcode-analysis security ./src --deep
 # 使用 10 个并发线程加速分析
 vcode-analysis review ./src --workers 10
 
+# 禁用缓存（强制重新分析）
+vcode-analysis review ./src --no-cache
+
+# 禁用批量分析（逐文件分析）
+vcode-analysis review ./src --no-batch
+
+# 启用上下文增强（提供项目结构和依赖关系）
+vcode-analysis review ./src --context
+
+# 输出 JSON 格式
+vcode-analysis review ./src --format json
+
 # 目录扫描
 vcode-analysis scan-dir ./project
+
+# 目录扫描（指定深度）
+vcode-analysis scan-dir ./project --depth 3
 ```
 
+## ⚡ 性能优化
+
+### 批量分析 + 缓存（v0.4.0 新增）
+
+**默认启用**，可大幅提升分析效率：
+
+| 场景 | 原方式 | 优化后 | 提升 |
+|------|--------|--------|------|
+| 首次分析 100 个文件 | 100 次 API 调用 | ~15 次 | 减少 85% |
+| 二次分析（仅 10 个文件变更） | 100 次 API 调用 | ~2 次 | 减少 98% |
+
+**优化原理**：
+- **智能合并**：按语言类型分组，动态估算 Token 数，多文件合并为一次 API 调用
+- **双层缓存**：内存缓存（快速）+ 磁盘缓存（持久化），基于内容哈希
+- **增量分析**：自动跳过未变更的文件
+
+**缓存位置**：`~/.code-analysis/cache/`
+
 ## 📖 命令概览
 
 ```bash
@@ -129,6 +174,27 @@ Commands:
     git-status      查看多仓库状态
     scan-dir        扫描目录结构
     config          配置管理
+
+Options:
+    -c, --config <file>     配置文件路径
+    --base-url <url>        LLM API 地址
+    --api-key <key>         API 密钥
+    -m, --model <name>      模型名称
+    --max-tokens <n>        最大输出 Token 数 (默认: 4096)
+    --timeout <n>           请求超时时间/秒 (默认: 180)
+    -o, --output <file>     输出文件路径
+    -f, --format <format>   输出格式 (markdown/json)
+    -w, --workers <n>       并发线程数 (默认: 5)
+    --context               启用上下文增强分析
+    --no-cache              禁用缓存（默认启用缓存）
+    --no-batch              禁用批量分析（默认启用批量合并）
+    --deep                  深度扫描 (安全扫描)
+    --branch <name>         克隆的分支名
+    --analyze               克隆后自动分析
+    --parallel              并行克隆
+    --repos <names>         指定仓库名列表（逗号分隔）
+    --depth <n>             扫描深度
+    --type <type>           文档类型 (module/api)
 ```
 
 ## 🌍 支持的语言
@@ -139,12 +205,17 @@ Commands:
 | Java | `.java` | AST |
 | Kotlin | `.kt`, `.kts` | 双模式 |
 | C | `.c`, `.h` | 双模式 |
+| C++ | `.cpp`, `.hpp`, `.cc`, `.cxx` | 正则 |
 | JavaScript | `.js`, `.jsx` | 正则 |
 | TypeScript | `.ts`, `.tsx` | 正则 |
+| Vue | `.vue` | 正则 |
+
+> 此外还支持配置文件（`.json`、`.yaml`、`.yml`）和文档（`.md`）的分析
 
 ## 📚 文档
 
 - [完整使用手册](docs/USER_MANUAL.md)
+- [批量分析与缓存优化设计](docs/design/batch-cache-optimization.md)
 - [Kotlin 解析器设计](docs/design/kotlin-parser-design.md)
 - [C 解析器设计](docs/design/c-parser-design.md)
 
@@ -158,18 +229,25 @@ code-analysis/
 │   ├── llm_client.py      # LLM 客户端
 │   ├── git_handler.py     # Git 操作 + 批量操作
 │   ├── config.py          # 配置管理
-│   └── ignore.py          # 统一过滤规则
+│   ├── ignore.py          # 统一过滤规则
+│   ├── token_estimator.py # Token 估算模块
+│   ├── batch_planner.py   # 批量分析规划器
+│   ├── batch_analyzer.py  # 批量分析器
+│   └── cache_manager.py   # 缓存管理器
 ├── analyzers/
 │   ├── code_review.py     # 代码审查
 │   ├── documentation.py   # 文档生成
 │   ├── architecture.py    # 架构分析
 │   ├── security.py        # 安全扫描
-│   └── directory.py       # 目录分析
+│   ├── directory.py       # 目录分析
+│   └── context_builder.py # 上下文构建器
 └── parsers/
     ├── python_parser.py   # Python AST 解析器
     ├── java_parser.py     # Java AST 解析器
     ├── kotlin_parser.py   # Kotlin 解析器（双模式）
     ├── c_parser.py        # C 语言解析器（双模式）
+    ├── javascript_parser.py # JavaScript 解析器
+    ├── typescript_parser.py # TypeScript 解析器
     └── ...
 ```
 
@@ -187,8 +265,30 @@ vcode-analysis review ./src --workers 10
 # 自定义输出路径
 vcode-analysis review ./src --output custom_report.md
 
+# 输出 JSON 格式
+vcode-analysis review ./src --format json
+
+# 启用上下文增强（提供项目依赖关系和关联文件信息）
+vcode-analysis review ./src --context
+
 # 审查最新提交
 vcode-analysis review-commit HEAD
+
+# 审查指定提交
+vcode-analysis review-commit abc1234 --path ./src
+```
+
+### 文档生成
+
+```bash
+# 生成模块文档（默认）
+vcode-analysis doc ./src
+
+# 生成 API 文档
+vcode-analysis doc ./src --type api
+
+# 自定义输出路径
+vcode-analysis doc ./src --output docs.md
 ```
 
 ### 安全扫描
@@ -207,6 +307,18 @@ vcode-analysis security ./src
 # 批量克隆（从文件读取 URL 列表）
 vcode-analysis batch-clone repos.txt ./projects --parallel
 
+# 克隆后自动分析
+vcode-analysis batch-clone repos.txt ./projects --parallel --analyze
+
+# 克隆指定分支
+vcode-analysis clone https://example.com/repo.git --branch develop
+
+# 批量拉取更新
+vcode-analysis batch-pull ~/projects
+
+# 拉取指定仓库
+vcode-analysis batch-pull ~/projects --repos repo1,repo2
+
 # 查看多仓库状态
 vcode-analysis git-status ~/projects
 ```
@@ -221,10 +333,30 @@ llm:
   model: qwen3.5-35b-a3b
   temperature: 0.7
   max_tokens: 4096
+  timeout: 180                    # 请求超时时间（秒）
 
 analysis:
   max_file_size: 102400
-  max_workers: 5                      # 并发分析线程数
+  max_workers: 5                  # 并发分析线程数
+
+  # 支持的文件扩展名（不在此列表中的文件将被忽略）
+  supported_extensions:
+    - ".py"
+    - ".java"
+    - ".kt"
+    - ".kts"
+    - ".js"
+    - ".jsx"
+    - ".ts"
+    - ".tsx"
+    - ".vue"
+    - ".c"
+    - ".h"
+    - ".cpp"
+    - ".hpp"
+    - ".cc"
+    - ".cxx"
+
   ignore_patterns:
     # 默认已包含多语言依赖目录和缓存文件
     # Python: .venv, venv, __pycache__, .pytest_cache, .mypy_cache
@@ -234,8 +366,24 @@ analysis:
     # .NET: bin, obj
     # 以及: .git, .idea, .vscode, *.pyc, *.min.js 等
     # 用户可在此添加额外的自定义忽略规则
+
+cache:
+  ttl: 604800                     # 缓存有效期（秒），默认 7 天
+  memory_cache_size: 1000         # 内存缓存最大条目数
 ```
 
+### 环境变量
+
+除了配置文件，还可以通过环境变量设置（优先级高于配置文件）：
+
+| 环境变量 | 对应配置项 |
+|----------|-----------|
+| `OPENAI_API_BASE` 或 `OPENAI_BASE_URL` | `llm.base_url` |
+| `OPENAI_API_KEY` | `llm.api_key` |
+| `CODE_ANALYSIS_MODEL` | `llm.model` |
+| `CODE_ANALYSIS_TEMPERATURE` | `llm.temperature` |
+| `CODE_ANALYSIS_MAX_TOKENS` | `llm.max_tokens` |
+
 ## 🤝 扩展开发
 
 ### 添加新的分析器
@@ -290,12 +438,3 @@ twine upload dist/*
 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.3.0 → vcode_analysis-0.5.0}/README.md

@@ -14,11 +14,13 @@
 | 📝 **文档生成** | 自动生成模块文档、API 文档 |
 | 🏗️ **架构分析** | 分析项目结构、依赖关系、代码度量 |
 | 🔒 **安全扫描** | 检测常见安全漏洞和风险代码 |
+| 🔗 **上下文增强** | 解析项目依赖关系，提供关联文件上下文给 LLM |
 | ⚡ **并发分析** | 支持多线程并发分析，默认 5 个线程 |
 | 📦 **批量操作** | 批量克隆、批量 Git 操作、多仓库管理 |
 | 📂 **目录分析** | 扫描项目结构、识别技术栈 |
-| 🌐 **多语言支持** | Python, Java, Kotlin, C, JavaScript, TypeScript 等 |
+| 🌐 **多语言支持** | Python, Java, Kotlin, C/C++, JavaScript, TypeScript, Vue 等 |
 | 🤖 **私有化部署** | 兼容 OpenAI API 格式，支持任何私有化 LLM |
+| 🌍 **环境变量** | 支持环境变量配置，方便 CI/CD 集成 |
 
 ## 🚀 快速开始
 
@@ -40,11 +42,21 @@ pip install vcode-analysis[parsers,rich]
 **方式二：从源码安装**
 
 ```bash
-git clone https://gitcode.com/wellchang/code-analysis.git
+git clone 
 cd code-analysis
 pip install -e .
 ```
 
+**方式三：离线安装**
+
+```bash
+# Windows
+install_offline.bat
+
+# Linux/macOS
+bash install_offline.sh
+```
+
 ### 配置
 
 ```bash
@@ -58,7 +70,7 @@ vcode-analysis config --init
 ### 使用
 
 ```bash
-# 代码审查（结果自动保存到 result/目录名_review_时间戳.md）
+# 代码审查（默认启用批量分析和缓存，大幅减少 API 调用）
 vcode-analysis review ./src
 
 # 架构分析
@@ -70,10 +82,43 @@ vcode-analysis security ./src --deep
 # 使用 10 个并发线程加速分析
 vcode-analysis review ./src --workers 10
 
+# 禁用缓存（强制重新分析）
+vcode-analysis review ./src --no-cache
+
+# 禁用批量分析（逐文件分析）
+vcode-analysis review ./src --no-batch
+
+# 启用上下文增强（提供项目结构和依赖关系）
+vcode-analysis review ./src --context
+
+# 输出 JSON 格式
+vcode-analysis review ./src --format json
+
 # 目录扫描
 vcode-analysis scan-dir ./project
+
+# 目录扫描（指定深度）
+vcode-analysis scan-dir ./project --depth 3
 ```
 
+## ⚡ 性能优化
+
+### 批量分析 + 缓存（v0.4.0 新增）
+
+**默认启用**，可大幅提升分析效率：
+
+| 场景 | 原方式 | 优化后 | 提升 |
+|------|--------|--------|------|
+| 首次分析 100 个文件 | 100 次 API 调用 | ~15 次 | 减少 85% |
+| 二次分析（仅 10 个文件变更） | 100 次 API 调用 | ~2 次 | 减少 98% |
+
+**优化原理**：
+- **智能合并**：按语言类型分组，动态估算 Token 数，多文件合并为一次 API 调用
+- **双层缓存**：内存缓存（快速）+ 磁盘缓存（持久化），基于内容哈希
+- **增量分析**：自动跳过未变更的文件
+
+**缓存位置**：`~/.code-analysis/cache/`
+
 ## 📖 命令概览
 
 ```bash
@@ -89,6 +134,27 @@ Commands:
     git-status      查看多仓库状态
     scan-dir        扫描目录结构
     config          配置管理
+
+Options:
+    -c, --config <file>     配置文件路径
+    --base-url <url>        LLM API 地址
+    --api-key <key>         API 密钥
+    -m, --model <name>      模型名称
+    --max-tokens <n>        最大输出 Token 数 (默认: 4096)
+    --timeout <n>           请求超时时间/秒 (默认: 180)
+    -o, --output <file>     输出文件路径
+    -f, --format <format>   输出格式 (markdown/json)
+    -w, --workers <n>       并发线程数 (默认: 5)
+    --context               启用上下文增强分析
+    --no-cache              禁用缓存（默认启用缓存）
+    --no-batch              禁用批量分析（默认启用批量合并）
+    --deep                  深度扫描 (安全扫描)
+    --branch <name>         克隆的分支名
+    --analyze               克隆后自动分析
+    --parallel              并行克隆
+    --repos <names>         指定仓库名列表（逗号分隔）
+    --depth <n>             扫描深度
+    --type <type>           文档类型 (module/api)
 ```
 
 ## 🌍 支持的语言
@@ -99,12 +165,17 @@ Commands:
 | Java | `.java` | AST |
 | Kotlin | `.kt`, `.kts` | 双模式 |
 | C | `.c`, `.h` | 双模式 |
+| C++ | `.cpp`, `.hpp`, `.cc`, `.cxx` | 正则 |
 | JavaScript | `.js`, `.jsx` | 正则 |
 | TypeScript | `.ts`, `.tsx` | 正则 |
+| Vue | `.vue` | 正则 |
+
+> 此外还支持配置文件（`.json`、`.yaml`、`.yml`）和文档（`.md`）的分析
 
 ## 📚 文档
 
 - [完整使用手册](docs/USER_MANUAL.md)
+- [批量分析与缓存优化设计](docs/design/batch-cache-optimization.md)
 - [Kotlin 解析器设计](docs/design/kotlin-parser-design.md)
 - [C 解析器设计](docs/design/c-parser-design.md)
 
@@ -118,18 +189,25 @@ code-analysis/
 │   ├── llm_client.py      # LLM 客户端
 │   ├── git_handler.py     # Git 操作 + 批量操作
 │   ├── config.py          # 配置管理
-│   └── ignore.py          # 统一过滤规则
+│   ├── ignore.py          # 统一过滤规则
+│   ├── token_estimator.py # Token 估算模块
+│   ├── batch_planner.py   # 批量分析规划器
+│   ├── batch_analyzer.py  # 批量分析器
+│   └── cache_manager.py   # 缓存管理器
 ├── analyzers/
 │   ├── code_review.py     # 代码审查
 │   ├── documentation.py   # 文档生成
 │   ├── architecture.py    # 架构分析
 │   ├── security.py        # 安全扫描
-│   └── directory.py       # 目录分析
+│   ├── directory.py       # 目录分析
+│   └── context_builder.py # 上下文构建器
 └── parsers/
     ├── python_parser.py   # Python AST 解析器
     ├── java_parser.py     # Java AST 解析器
     ├── kotlin_parser.py   # Kotlin 解析器（双模式）
     ├── c_parser.py        # C 语言解析器（双模式）
+    ├── javascript_parser.py # JavaScript 解析器
+    ├── typescript_parser.py # TypeScript 解析器
     └── ...
 ```
 
@@ -147,8 +225,30 @@ vcode-analysis review ./src --workers 10
 # 自定义输出路径
 vcode-analysis review ./src --output custom_report.md
 
+# 输出 JSON 格式
+vcode-analysis review ./src --format json
+
+# 启用上下文增强（提供项目依赖关系和关联文件信息）
+vcode-analysis review ./src --context
+
 # 审查最新提交
 vcode-analysis review-commit HEAD
+
+# 审查指定提交
+vcode-analysis review-commit abc1234 --path ./src
+```
+
+### 文档生成
+
+```bash
+# 生成模块文档（默认）
+vcode-analysis doc ./src
+
+# 生成 API 文档
+vcode-analysis doc ./src --type api
+
+# 自定义输出路径
+vcode-analysis doc ./src --output docs.md
 ```
 
 ### 安全扫描
@@ -167,6 +267,18 @@ vcode-analysis security ./src
 # 批量克隆（从文件读取 URL 列表）
 vcode-analysis batch-clone repos.txt ./projects --parallel
 
+# 克隆后自动分析
+vcode-analysis batch-clone repos.txt ./projects --parallel --analyze
+
+# 克隆指定分支
+vcode-analysis clone https://example.com/repo.git --branch develop
+
+# 批量拉取更新
+vcode-analysis batch-pull ~/projects
+
+# 拉取指定仓库
+vcode-analysis batch-pull ~/projects --repos repo1,repo2
+
 # 查看多仓库状态
 vcode-analysis git-status ~/projects
 ```
@@ -181,10 +293,30 @@ llm:
   model: qwen3.5-35b-a3b
   temperature: 0.7
   max_tokens: 4096
+  timeout: 180                    # 请求超时时间（秒）
 
 analysis:
   max_file_size: 102400
-  max_workers: 5                      # 并发分析线程数
+  max_workers: 5                  # 并发分析线程数
+
+  # 支持的文件扩展名（不在此列表中的文件将被忽略）
+  supported_extensions:
+    - ".py"
+    - ".java"
+    - ".kt"
+    - ".kts"
+    - ".js"
+    - ".jsx"
+    - ".ts"
+    - ".tsx"
+    - ".vue"
+    - ".c"
+    - ".h"
+    - ".cpp"
+    - ".hpp"
+    - ".cc"
+    - ".cxx"
+
   ignore_patterns:
     # 默认已包含多语言依赖目录和缓存文件
     # Python: .venv, venv, __pycache__, .pytest_cache, .mypy_cache
@@ -194,8 +326,24 @@ analysis:
     # .NET: bin, obj
     # 以及: .git, .idea, .vscode, *.pyc, *.min.js 等
     # 用户可在此添加额外的自定义忽略规则
+
+cache:
+  ttl: 604800                     # 缓存有效期（秒），默认 7 天
+  memory_cache_size: 1000         # 内存缓存最大条目数
 ```
 
+### 环境变量
+
+除了配置文件，还可以通过环境变量设置（优先级高于配置文件）：
+
+| 环境变量 | 对应配置项 |
+|----------|-----------|
+| `OPENAI_API_BASE` 或 `OPENAI_BASE_URL` | `llm.base_url` |
+| `OPENAI_API_KEY` | `llm.api_key` |
+| `CODE_ANALYSIS_MODEL` | `llm.model` |
+| `CODE_ANALYSIS_TEMPERATURE` | `llm.temperature` |
+| `CODE_ANALYSIS_MAX_TOKENS` | `llm.max_tokens` |
+
 ## 🤝 扩展开发
 
 ### 添加新的分析器
@@ -250,12 +398,3 @@ twine upload dist/*
 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.3.0 → vcode_analysis-0.5.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.3.0 → vcode_analysis-0.5.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),
             )