@sharbel：本周GitHub增长最快的10个仓库：1. codegraph（+14.1K星标）为Claude预索引的代码知识图谱……

本周增长最快的10个GitHub仓库：1. codegraph (+14.1K stars) 预索引代码知识图谱，用于Claude Code、Codex、Cursor、OpenCode和Hermes Agent — 更少Token、更少工具调用、100%本地 https://github.com/colbymchenry/codegraph… 2. openhuman (+17.1K stars) 你的个人AI超级智能。私密、简单且极其强大。https://github.com/tinyhumansai/openhuman… 3. academic-research-skills (+11.6K stars) Claude Code的学术研究技能：研究→写作→审阅→修订→定稿 https://github.com/Imbad0202/academic-research-skills… 4. RuView (+6.8K stars) π RuView将普通WiFi信号转化为实时空间智能、生命体征监测和存在检测——无需任何视频像素。https://github.com/ruvnet/RuView 5. agentmemory (+6.9K stars) #1 基于真实世界基准测试的AI编码代理持久记忆 https://github.com/rohitg00/agentmemory… 6. supertonic (+3.6K stars) 闪电般快速、设备端、多语言TTS——原生运行于ONNX。https://github.com/supertone-inc/supertonic… 7. CloakBrowser (+7.0K stars) 能通过所有机器人检测测试的隐身Chromium。即插即用的Playwright替代品，带有源码级指纹补丁。30/30测试通过。https://github.com/CloakHQ/CloakBrowser… 8. ViMax (+2.7K stars) “ViMax：代理式视频生成（导演、编剧、制片人、视频生成器四合一）” https://github.com/HKUDS/ViMax 9. 12-factor-agents (+1.9K stars) 构建真正适用于生产客户的LLM驱动软件应遵循哪些原则？https://github.com/humanlayer/12-factor-agents… 10. bun (+2.0K stars) 极快的JavaScript运行时、打包器、测试运行器和包管理器——合而为一 https://github.com/oven-sh/bun 本周主题：代理记忆、上下文效率与设备端智能正在使AI基础设施成为最热门的构建类别。收藏此页。下周的列表将完全不同。— # colbymchenry/codegraph 来源：https://github.com/colbymchenry/codegraph # CodeGraph ### 使用语义代码智能赋能Claude Code、Cursor、Codex、OpenCode和Hermes Agent 约降低35%成本 · 减少约70%工具调用 · 100%本地 npm版本 (https://www.npmjs.com/package/@colbymchenry/codegraph) 许可证：MIT (https://opensource.org/licenses/MIT) 自包含 (https://nodejs.org/) Windows macOS Linux Claude Code Cursor Codex CLI opencode Hermes Agent ## 快速开始 无需Node.js — 一条命令即可获取适合您操作系统的构建： bash # macOS / Linux curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh # Windows (PowerShell) irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex 已安装Node？使用npm替代（适用于任何版本）： bash npx @colbymchenry/codegraph # 零安装，或： npm i -g @colbymchenry/codegraph CodeGraph自带运行时 — 无需编译，无原生构建，在所有环境上运行一致。交互式安装程序会自动配置您的代理 — Claude Code、Cursor、Codex CLI、opencode、Hermes Agent。 ### 初始化项目 bash cd your-project codegraph init -i 1_C_VYnhpys0UHrOuOgpgoyw ### 卸载 改变主意了？一条命令即可从所有已配置的代理中移除CodeGraph： bash codegraph uninstall 撤销安装程序 — 从每个已配置的代理中移除CodeGraph的MCP服务器配置、指令和权限。您的项目索引（.codegraph/）保持不变；对每个项目使用codegraph uninit移除。使用--target从特定代理中移除，或使用--yes以非交互方式运行。 — ## 为什么选择CodeGraph？ 当Claude Code探索代码库时，它会生成Explore代理，这些代理通过grep、glob和Read扫描文件——每次工具调用都会消耗Token。CodeGraph为这些代理提供预索引的知识图谱——符号关系、调用图和代码结构。代理直接查询图谱，无需扫描文件。 ### 基准测试结果 跨7个真实世界开源代码库（涵盖7种语言）进行测试，比较一个代理（Claude Code，headless模式）在有和无CodeGraph的情况下回答一个架构问题的表现。每个单元格是每臂4次运行的中位数节省值。 > 平均：成本降低35% · Token减少59% · 速度提升49% · 工具调用减少70% | 代码库 | 语言 | 成本 | Token | 时间 | 工具调用 | |–––––|–––––|——|––––|——|————| | VS Code | TypeScript · ~10k 文件 | 降低35% | 减少73% | 提升41% | 减少72% | | Excalidraw | TypeScript · ~600 | 降低47% | 减少73% | 提升60% | 减少86% | | Django | Python · ~2.7k | 降低34% | 减少64% | 提升59% | 减少81% | | Tokio | Rust · ~700 | 降低52% | 减少81% | 提升63% | 减少89% | | OkHttp | Java · ~640 | 降低17% | 减少41% | 提升36% | 减少64% | | Gin | Go · ~150 | 降低22% | 减少23% | 提升34% | 减少19% | | Alamofire | Swift · ~100 | 降低38% | 减少59% | 提升51% | 减少77% | 收益随代码库规模扩大而增长：在大型仓库中，代理从索引中通过少量调用（零文件读取）直接获取答案，而无需CodeGraph的代理则会展开grep/find/Read（以及它生成的子代理）。在像Gin这样的小型仓库（~150个文件）中，原生搜索已经很快，因此差距缩小。 完整的基准测试详情 方法论。 每臂使用claude -p（Claude Opus 4.7, Claude Code v2.1.145）在仓库上以headless模式运行，并带有--strict-mcp-config：使用 = 启用CodeGraph的MCP服务器，不使用 = 空MCP配置。两者均可使用内置的Read/Grep/Bash。每个仓库的问题相同，每臂4次运行，报告中间值。成本 = 运行的total_cost_usd；Token = 处理的总token（包括缓存的输入 + 输出）；时间 = 挂钟时间；工具调用 = 每次工具调用，包括模型生成的任何子代理内部的调用。仓库以--depth 1克隆，并由提供服务的同一CodeGraph构建版本索引。 查询： | 代码库 | 查询 | |–––––|—––| | VS Code | “扩展宿主如何与主进程通信？” | | Excalidraw | “Excalidraw如何渲染和更新画布元素？” | | Django | “Django的ORM如何从QuerySet构建并执行查询？” | | Tokio | “tokio如何在其运行时上调度和执行异步任务？” | | OkHttp | “OkHttp如何通过其拦截器链处理请求？” | | Gin | “gin如何通过其中间件链路由请求？” | | Alamofire | “Alamofire如何构建、发送和验证请求？” | 原始中位数 — 使用 → 不使用： | 代码库 | 成本 | Token | 时间 | 工具调用 | |–––––|——|––––|——|————| | VS Code | $0.42 → $0.64 | 393k → 1.4M | 1分0秒 → 1分43秒 | 7 → 23 | | Excalidraw | $0.54 → $1.02 | 851k → 3.2M | 1分17秒 → 3分14秒 | 12 → 83 | | Django | $0.41 → $0.62 | 499k → 1.4M | 1分0秒 → 2分25秒 | 9 → 48 | | Tokio | $0.50 → $1.04 | 657k → 3.4M | 1分5秒 → 2分56秒 | 9 → 75 | | OkHttp | $0.36 → $0.44 | 352k → 596k | 45秒 → 1分11秒 | 5 → 14 | | Gin | $0.36 → $0.46 | 431k → 562k | 47秒 → 1分11秒 | 7 → 8 | | Alamofire | $0.61 → $0.99 | 1.1M → 2.6M | 1分19秒 → 2分41秒 | 15 → 64 | 为什么CodeGraph胜出： 有了索引，代理直接回答——使用codegraph_context映射区域，然后一次codegraph_explore获取相关源代码——然后停止，通常零文件读取。而没有它，代理（以及它生成的Explore子代理）花费大部分预算在发现（find/ls/grep）上，然后才能读取正确的代码。CodeGraph仅在直接查询时有用，因此它的指令引导代理直接回答，而不是将探索委托给文件读取的子代理——否则子代理无论如何都会读取文件，CodeGraph就成了额外开销。 — ## 主要特性 | | | |—|—| | 智能上下文构建 | 一次工具调用返回入口点、相关符号和代码片段——无需昂贵的探索代理 | | 全文搜索 | 在您的整个代码库中立即按名称查找代码，由FTS5驱动 | | 影响分析 | 在修改前追踪任何符号的调用者、被调用者以及完整影响半径 | | 始终最新 | 文件监视器使用原生操作系统事件（FSEvents/inotify/ReadDirectoryChangesW），带防抖自动同步——图谱随您编码保持最新，零配置 | | 19+种语言 | TypeScript、JavaScript、Python、Go、Rust、Java、C#、PHP、Ruby、C、C++、Swift、Kotlin、Dart、Lua、Luau、Svelte、Liquid、Pascal/Delphi | | 框架感知路由 | 识别Web框架路由文件，并将URL模式链接到其处理程序，支持14个框架 | | 100%本地 | 数据不会离开您的机器。无需API密钥。无外部服务。仅SQLite数据库 | — ## 框架感知路由 CodeGraph检测Web框架路由文件，并发出通过references边链接到其处理程序类或函数的route节点。调用视图/控制器的调用者现在会同时显示绑定它的URL模式。 | 框架 | 识别的模式 | |—|—| | Django | path(), re_path(), url(), include() 在 urls.py 中（CBV .as_view(), 点分路径） | | Flask | @app.route('/path', methods=[...])，蓝图路由 | | FastAPI | @app.get(...), @router.post(...)，所有标准方法 | | Express | app.get(...), router.post(...) 带中间件链 | | NestJS | @Controller + @Get/@Post/...，GraphQL @Resolver + @Query/@Mutation，@MessagePattern/@EventPattern，@SubscribeMessage | | Laravel | Route::get(), Route::resource(), Controller@action，元组语法 | | Drupal | *.routing.yml 路由（_controller, _form, 实体处理器）；hook_* 实现于 .module/.theme/.install/.inc | | Rails | get '/x', to: 'users#index'，哈希火箭 => 语法 | | Spring | @GetMapping, @PostMapping, @RequestMapping 在方法上 | | Gin / chi / gorilla / mux | r.GET(...), router.HandleFunc(...) | | Axum / actix / Rocket | .route("/x", get(handler)) | | ASP.NET | [HttpGet("/x")] 属性在动作方法上 | | Vapor | app.get("x", use: handler) | | React Router / SvelteKit | 路由组件节点 | — ## 快速启动 ### 1. 运行安装程序 bash npx @colbymchenry/codegraph 安装程序将： - 询问配置哪些代理 — 自动检测已安装的：Claude Code、Cursor、Codex CLI、opencode、Hermes Agent - 提示将codegraph安装到PATH（以便代理可以启动MCP服务器） - 询问配置是应用于所有项目还是仅当前项目 - 为每个选择的代理写入MCP服务器配置文件 + 一个指令文件（例如CLAUDE.md、.cursor/rules/codegraph.mdc、~/.codex/AGENTS.md） - 当Claude Code是目标之一时，设置自动允许权限 - 初始化您当前的项目（仅限本地安装） 非交互式（脚本/CI）： bash codegraph install --yes # 自动检测代理，安装全局 codegraph install --target=cursor,claude --yes # 明确的目标列表 codegraph install --target=auto --location=local # 检测到的代理，项目本地 codegraph install --print-config codex # 打印配置片段，不写入文件 | 标志 | 值 | 默认 | |—|—|—| | --target | auto, all, none, 或 csv (claude,cursor,...) | 提示 | | --location | global, local | 提示 | | --yes | (布尔值) | 每一步都提示 | | --no-permissions | (布尔值) 跳过Claude自动允许列表 | 权限开启 | | --print-config | 转储一个代理的配置片段并退出 | — | ### 2. 重启您的代理 重启您的代理（Claude Code / Cursor / Codex CLI / opencode / Hermes Agent）以加载MCP服务器。 ### 3. 初始化项目 bash cd your-project codegraph init -i 构建每个项目的知识图谱索引。同时连接任何项目本地的代理表面（例如Cursor的.cursor/rules/codegraph.mdc），这样一次全局的codegraph install就能在您打开的任何项目中工作——无需为每个项目重新运行安装程序。 就是这样——当存在.codegraph/目录时，您的代理将自动使用CodeGraph工具。 手动设置（替代方案） 全局安装： bash npm install -g @colbymchenry/codegraph 添加到 ~/.claude.json： json { "mcpServers": { "codegraph": { "type": "stdio", "command": "codegraph", "args": ["serve", "--mcp"] } } } 添加到 ~/.claude/settings.json（可选，用于自动允许）： json { "permissions": { "allow": [ "mcp__codegraph__codegraph_search", "mcp__codegraph__codegraph_context", "mcp__codegraph__codegraph_callers", "mcp__codegraph__codegraph_callees", "mcp__codegraph__codegraph_impact", "mcp__codegraph__codegraph_node", "mcp__codegraph__codegraph_status", "mcp__codegraph__codegraph_files" ] } } 全局指令参考 安装程序会自动将这些指令添加到 ~/.claude/CLAUDE.md： markdown ## CodeGraph CodeGraph构建代码库的语义知识图谱，实现更快速、更智能的代码探索。 ### 如果项目中存在 `.codegraph/` **永远不要在主线会话中直接调用 `codegraph_explore` 或 `codegraph_context`。** 这些工具会返回大量源代码，占满主线会话上下文。相反，对于任何探索性问题（例如“X如何工作？”、“解释Y系统”、“Z在哪里实现？”），始终生成一个Explore代理。 **生成Explore代理时**，在提示中包含以下指令： > 该项目已初始化CodeGraph（`.codegraph/` 存在）。使用 `codegraph_explore` 作为您的主要工具——它一次调用即可从所有相关文件返回完整的源代码部分。 > > **规则：** > 1. 遵循 `codegraph_explore` 工具描述中的探索调用预算——它根据项目大小自动缩放。 > 2. 不要重新读取 `codegraph_explore` 已返回源代码的文件。源代码部分是完整且权威的。 > 3. 仅在需要更多详细信息时，回退到grep/glob/read来读取“其他相关文件”下列出的文件，或者如果 `codegraph` 未返回结果。 **主线会话只能直接使用这些轻量级工具**（用于针对性的查找，而不是探索）： | 工具 | 用途 | |------|---------| | `codegraph_search` | 按名称查找符号 | | `codegraph_callers` / `codegraph_callees` | 追踪调用流 | | `codegraph_impact` | 编辑前检查受影响的区域 | | `codegraph_node` | 获取单个符号的详细信息 | ### 如果 `.codegraph/` 不存在 在会话开始时，询问用户是否希望初始化CodeGraph：“我注意到该项目尚未初始化CodeGraph。您是否希望我运行 `codegraph init -i` 来构建代码知识图谱？” — ## 工作原理 ┌─────────────────────────────────────────────────────────────────┐ │ Claude Code │ │ │ │ "实现用户认证" │ │ │ │ ▼ │ │ ┌─────────────────┐ ┌─────────────────┐ │ │ │ Explore Agent │ ──── │ Explore Agent │ │ │ └────────┬────────┘ └────────┬────────┘ │ │ │ │ │ └───────────┼────────────────────────┼─────────────────────────────┘ │ │ ▼ ▼ ┌───────────────────────────────────────────────────────────────────┐ │ CodeGraph MCP Server │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ Search │ │ Callers │ │ Context │ │ │ │ "auth" │ │ "login()" │ │ for task │ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │ │ │ │ │ │ └────────────────┼────────────────┘ │ │ ▼ │ │ ┌───────────────────────┐ │ │ │ SQLite Graph DB │ │ │ │ • 387 符号 │ │ │ │ • 1,204 边 │ │ │ │ • 即时查找 │ │ │ └───────────────────────┘ │ └───────────────────────────────────────────────────────────────────┘ 1. 提取 — tree-sitter (https://tree-sitter.github.io/) 将源代码解析为抽象语法树并提取符号。