Jamesfish/code2context

## 💡 痛点 当使用 AI 编码助手（Cursor、Claude、Copilot、Cline...）时，生成结果的质量严重依赖于 **它对项目的理解程度**。 但构建和维护这种上下文非常痛苦： - **手动编写 `.cursorrules` 或 `CLAUDE.md`** 耗时费力 - **上下文会随着代码演进而过时**——你忘记更新它 - **每个 AI 工具需要不同的格式**——适用于 Cursor 的方法对 Claude 不适用 - **大型代码库难以总结**——很难判断哪些内容值得包含 ## ✅ Code2Context 的不同之处 Code2Context 不向你提问，也不需要模板。它 **读取你的实际代码并提取真实信息**。 ``` # 一个命令。零个问题。真实分析。 npx code2context init ``` 仅此而已。Code2Context 会自动： 1. 🔍 **扫描** 项目中的每个文件 2. 🧩 **解析** 模块导入/导出以构建依赖关系图 3. 📐 **检测** 实际代码模式中的编码约定 4. 📊 **分析** Git 历史以识别热点文件和开发方向 5. 🤖 **生成** AI 驱动的架构洞察（可选） 6. 📤 **导出** 为 `.cursorrules`、`CLAUDE.md` 或任何你需要的格式 ``` npx code2context export --format cursor # → .cursorrules npx code2context export --format claude # → CLAUDE.md npx code2context export --format text # → CONTEXT.txt # 代码有变更？增量更新（由 git-diff 驱动，快速） npx code2context update ``` **无需手动编写。无需过时上下文。为所有 AI 工具提供单一事实来源。** ## 🎯 核心优势 ### 1. 🔬 真实代码分析，而非模板 Code2Context 不从模板或问卷生成上下文。它 **分析你的实际源代码**： - 解析 `import`/`export` 语句（ES 模块、CommonJS、Python） - 构建真实的 **模块依赖图** - 识别入口点、关键导出者和最常用的依赖项 - 检测命名约定、文件组织模式和代码风格 ``` ✔ 46 modules parsed, 7 internal + 77 external deps ✔ Naming: PascalCase, 4 scripts, 17 env vars ``` ### 2. 📊 Git 感知智能 Code2Context 读取你的 Git 历史以了解 **项目中实际发生的事情**： - **热点文件**——最常被修改的文件 - **开发方向**——团队是在构建功能、修复 Bug 还是重构？ - **贡献者**——谁在做什么 - **最近提交**——最近发生了什么变化 这意味着生成的上下文反映的是项目的 **当前现实**，而非静态快照。 ### 3. ⚡ 零配置，一键运行 无需交互式向导，无需问卷，也不需要配置文件。 ``` # 直接运行即可。它会找出所有答案。 npx code2context init ``` Code2Context 会自动检测你的语言、框架、包管理器、入口点和约定——全部来自你的代码。 ### 4. 🔄 增量更新（基于 Git Diff） 首次扫描后，更新快速且精准： ``` npx code2context update ``` 这使用 `git diff` 检测自上次扫描以来的变更，并仅重新分析受影响区域。无需完整重扫。 ### 5. 🤖 可选的 AI 增强洞察 可选地使用任何 LLM 生成更深层洞察： - **架构决策**——代码为何如此组织 - **编码指南**——AI 助手应遵循的约定 - **AI 陷阱**——该类型项目中 AI 助手常犯的错误 支持 **任何 OpenAI 兼容 API**——OpenAI、DeepSeek、OpenRouter、Ollama、Groq、Mistral 等。 **无需任何 API 密钥，Code2Context 也能完美运行**——所有代码分析均在本地完成，零外部调用。 ## 🔍 提取内容 | 层级 | 检测内容 | 方法 | |------|----------|------| | 🏗️ **项目结构** | 目录、关键文件、入口点 | 文件系统遍历 | | 🧩 **模块图** | 导入、导出、依赖关系 | 正则解析 | | 📐 **编码约定** | 命名模式、文件组织、代码风格 | 模式检测 | | 🔧 **配置** | 脚本、环境变量、依赖、框架 | 配置文件解析 | | 📊 **Git 洞察** | 开发方向、热点文件、贡献者 | Git 历史分析 | | 🤖 **AI 摘要** | 架构决策、编码指南、陷阱 | LLM 驱动（可选） | ### 支持的语言 **完整模块解析**（导入 + 导出）： - TypeScript / JavaScript（ES 模块 + CommonJS） - Python **文件检测**（结构 + 约定）： - Rust、Go、Java、Kotlin、Swift、Ruby、PHP、C#、C++、C、Vue、Svelte、Dart、Elixir、Scala、Zig ## 🚀 快速开始 ### 1. 初始化上下文 ``` npx code2context init ``` 这会扫描你的项目并生成： - `.code2context/context.json` —— 结构化上下文数据 - `.code2context/context.md` —— 人类可读的摘要 ### 2. 导出到你的 AI 工具 ``` # 适用于 Cursor npx code2context export --format cursor # → 在项目根目录创建 .cursorrules # 适用于 Claude npx code2context export --format claude # → 在项目根目录创建 CLAUDE.md ``` ### 3. 保持更新 ``` npx code2context update ``` ### 4. 检查上下文健康状态 ``` npx code2context stats ``` ## 🤖 可选的 AI 增强分析 ### 选项 A：环境变量 ``` export CODE2CONTEXT_API_KEY=your-key export CODE2CONTEXT_BASE_URL=https://api.provider.com/v1 # optional export CODE2CONTEXT_MODEL=model-name # optional ``` ### 选项 B：配置文件 ``` npx code2context config init npx code2context config set ai.provider deepseek npx code2context config set ai.model deepseek-chat ```

提供者配置（点击展开）

``` # OpenAI（默认） export CODE2CONTEXT_API_KEY=sk-xxx # DeepSeek（最具成本效益） export CODE2CONTEXT_API_KEY=sk-xxx export CODE2CONTEXT_BASE_URL=https://api.deepseek.com export CODE2CONTEXT_MODEL=deepseek-chat # OpenRouter（100+ 模型） export CODE2CONTEXT_API_KEY=sk-or-xxx export CODE2CONTEXT_BASE_URL=https://openrouter.ai/api/v1 export CODE2CONTEXT_MODEL=anthropic/claude-3.5-sonnet # Ollama（本地、免费、私有） export CODE2CONTEXT_API_KEY=ollama export CODE2CONTEXT_BASE_URL=http://localhost:11434/v1 export CODE2CONTEXT_MODEL=llama3 # Groq（最快推理） export CODE2CONTEXT_API_KEY=gsk_xxx export CODE2CONTEXT_BASE_URL=https://api.groq.com/openai/v1 export CODE2CONTEXT_MODEL=llama-3.1-70b-versatile ```

### 可用提供者 | 提供者 | `ai.provider` | 默认模型 | 说明 | |--------|---------------|----------|------| | OpenAI | `openai` | `gpt-4o-mini` | 默认 | | DeepSeek | `deepseek` | `deepseek-chat` | 成本最低 | | OpenRouter | `openrouter` | `claude-3.5-sonnet` | 100+ 模型 | | Ollama | `ollama` | `llama3` | 本地、免费、私有 | | Together AI | `together` | `Llama-3-70b` | 开源模型 | | Groq | `groq` | `llama-3.1-70b` | 推理最快 | | Mistral | `mistral` | `mistral-large` | 欧洲提供商 | | 自定义 | `custom` | — | 手动设置 `baseURL` | ## ⚙️ 配置 ``` npx code2context config init # Create config file npx code2context config init --global # Create global config npx code2context config show # View resolved config npx code2context config set # Set a value ``` 配置文件格式（`.code2context/config.json`）： ``` { "ai": { "provider": "deepseek", "baseURL": "https://api.deepseek.com", "model": "deepseek-chat" }, "scan": { "ignore": ["vendor", "generated"], "maxFiles": 10000 }, "export": { "defaultFormat": "cursor" } } ``` 配置优先级：CLI 参数 > 环境变量 > 项目配置 > 全局配置 > 默认值。 ## 📊 输出示例 ``` 🔮 Code2Context — Initializing project context ✔ Found 58 files ✔ my-nextjs-app — TypeScript, JavaScript + Next.js, React, Tailwind CSS ✔ 5 directories, ~7399 lines ✔ 46 modules parsed, 7 internal + 77 external deps ✔ Naming: PascalCase, 4 scripts, 17 env vars ✔ 2 commits analyzed, 10 hot files ✔ AI analysis complete (your-provider / your-model) ✅ Context generated successfully! 📁 .code2context/context.json — Structured context (22.1KB) 📄 .code2context/context.md — Human-readable context ⏱️ Completed in 56.7s ``` 生成的 `.cursorrules` 包含： ``` # 项目：my-nextjs-app ## 项目概述 A Next.js 13+ application built with TypeScript and Tailwind CSS... ## 架构决策 - Adopted the Next.js app router with route-specific layout.tsx and page.tsx - Separated concerns by placing reusable utilities in src/lib/ and src/types/ ... ## 模块结构 Entry points: - src/app/page.tsx → exports: HomePage Key modules: - src/lib/utils/index.ts → formatDate, parseConfig, validateInput... ## 重要：需要注意 AI 的陷阱 - ⚠️ Assuming all components are client-side; forgetting to add 'use client' - ⚠️ Misplacing environment variables: variables without NEXT_PUBLIC_ prefix... ``` ### 真实项目性能 | 项目 | 语言 | 文件数 | 模块数 | 上下文大小 | 耗时 | |------|------|--------|--------|------------|------| | Next.js 应用 | TypeScript | 58 | 46 | 18.8KB | 0.4s | | Express.js | JavaScript (CJS) | 213 | 22 | 13.0KB | 0.1s | | FastAPI | Python | 2,984 | 758 | 54.5KB | 0.5s | | Vue Core | TypeScript 单体 | 702 | 283 | 55.4KB | 0.3s | ## 📋 全部命令 | 命令 | 说明 | |------|------| | `code2context init` | 扫描项目并生成结构化上下文 | | `code2context update` | 增量更新上下文（基于 Git Diff） | | `code2context export` | 导出为 AI 格式（cursor/claude/text/json） | | `code2context stats` | 显示上下文统计与健康状态 | | `code2context config init` | 生成配置文件 | | `code2context config show` | 显示解析后的当前配置 | | `code2context config set` | 设置配置值 | ### 常用标志 ``` code2context init --dir /path/to/project # Specify project directory code2context init --no-ai # Skip AI analysis code2context export --format claude # Choose export format code2context export --output ./ctx.md # Custom output path ``` ## 🗺️ 路线图 - [x] 核心 CLI（`init`、`update`、`export`、`stats`、`config`） - [x] 多格式导出（cursor、claude、text、json） - [x] 基于 Git Diff 的增量更新 - [x] 可选的 AI 增强分析（任何 OpenAI 兼容提供者） - [x] 配置文件支持（项目 + 全局） - [x] 模块解析 — JS/TS（ESM + CJS）+ Python - [x] 大型项目优化（自动修剪） - [ ] MCP 服务器（让 AI 工具直接调用 Code2Context） - [ ] 更多语言解析器（Rust、Go、Java） - [ ] 上下文质量评分 - [ ] IDE 插件（VS Code、JetBrains） ## ☕ 支持本项目 如果 Code2Context 为你节省了时间并改进了 AI 编码流程，请考虑请我喝杯咖啡。你的支持有助于保持项目的活跃维护。 每一份贡献——无论多小——都深表感激。 🙏

| 微信支付 | 支付宝 | |----------|--------| | | |

你也可以通过以下方式支持： - ⭐ **Star 本项目**——帮助他人发现它 - 🐛 **报告 Bug 或提出功能建议** - 📢 **与开发朋友分享 Code2Context** ## 📄 许可证 MIT © [Jamesfish](LICENSE)

标签：AI编码助手, CLAUDE.md, Cursor规则, git历史分析, MITM代理, Node.js工具, NPM包, OSV-Scalibr, SEO关键词, 上下文管理, 代码上下文提取, 代码分析工具, 代码理解, 依赖图构建, 单命令工具, 增量更新, 架构洞察, 模块导入解析, 网络安全研究, 自动分析, 自动化攻击, 规则生成, 逆向工具, 零配置