用 AST 架构图把代码上下文从 25000 压到 1500 tokens

2026-11-11

CodeGraphy 扫描本地仓库，提取只保留签名、类型和文档的 AST 骨架，再通过 11 个 MCP 工具把架构上下文交给编程 Agent。项目示例称 20 文件模块从约 25,000 tokens 压到约 1,500。

使用工具CodeGraphy

实战评级

已达成

项目已提供可运行工具和演示，示例把20文件模块从约25000 tokens压到约1500。

节省数字来自项目README，未见独立复现，且标题口径与示例比例不一致。

具体怎么做: 工具扫描 Python 仓库，解析模块依赖并构建实时架构图；AST 提取器去掉函数内部实现，保留类、继承、参数、类型、默认值、docstring 和导出符号。MCP 暴露架构摘要、模块契约、子图查询、变更影响、架构 diff 和受影响测试等 11 个工具。
做到了什么: 仓库示例称一个 20 文件模块的输入从约 25,000 tokens 降到约 1,500，约减少 94%；标题中的“-85%”是项目宣传口径，两者并不一致。项目提供 Windows 2.1.0 安装包和演示，但没有独立复现。
上手要点: 先在非敏感仓库验证图和符号解析；令牌节省是项目自报，按自己的代码库实测。

使用 CodeGraphy

扫描本地仓库【路径】，生成模块与依赖图。为任务【改动目标】构建只含必要类、函数签名、类型、docstring 和依赖边的 AST 上下文，并通过 MCP 提供给【Claude/Codex】。输出完整源码输入与压缩上下文的 token 数、变更影响范围和建议测试；不要上传仓库内容。