Repowise – 本地、自托管的代码库智能

它是什么

Repowise 是一个基于 Python 的工具，可创建仓库的调用图、Git 历史、测试、文档和设计决策的单一本地索引。索引存储在本地（无需 API 密钥或云服务），开发人员或任何 MCP 兼容的编码助手（Claude Code、Cursor、VS Code 扩展等）都可以查询。

核心功能

领域	您可以询问索引的内容	Repowise 如何回答
代码理解	“什么调用了这个函数？” “这个功能在哪里实现？” “为什么创建这个模块？”	从调用图（26 种语言）和生成的 wiki 构建的引用答案；决策链接到 ADR、# WHY: 注释、提交和 PR。
安全变更管理	“如果我修改 auth.py 会破坏什么？” “这个 diff 应该运行哪些测试？” “这个 PR 有风险吗？”	从图、共同变更历史、测试影响推断和与仓库自身近期提交相比的 0-10 风险评分，得出符号级别的爆炸半径。
代码健康与债务	“我们应该先修复什么？” “死代码在哪里？” “有哪些性能热点？”	53 个确定性检测器产生每个文件的健康评分、排名修复优先队列、死代码置信度级别和重构建议（提取方法/类、拆分文件等）。
文档	“给我这个模块的文档。” “哪些文档已过时？”	自动生成的 wiki（无需 LLM）加上可选的模型撰写的散文；文档漂移检测会标记不再与代码匹配的 markdown。
跨仓库合约	“这个 API 变更会破坏另一个服务吗？”	从 HTTP、gRPC、OpenAPI、主题匹配跨仓库的合约；在工作区中显示破坏性变更防护。
安全性	“我们刚刚提交了密钥吗？”	扫描工作树和完整 Git 历史中的密钥、令牌和危险调用，并提供 pre-commit 和 CI 门禁。

如何使用

1. 安装 – uv tool install repowise（或 pipx / pip）。
2. 初始化 – repowise init --yes --no-prose 创建索引（图、Git、健康、死代码、文档）无需任何外部 API 密钥。
3. 提供服务 – repowise serve 运行本地仪表板和 MCP 服务器，编码代理可以调用。
4. 查询 – 代理可以调用内置工具，例如 get_overview、risk、distill，或者您可以直接使用 CLI（repowise risk main..HEAD、repowise distill pytest）。

也可以将一行提示发送给支持 MCP 的代理：

Read https://docs.repowise.dev/setup.md and set up Repowise in this repository.

代理会自动安装、索引和连接 Repowise。

证据与性能

• ‑31.6 % 在 43 题基准测试中代理输出减少（p < 0.0001）。
• 2.3× 比 CodeScene 发现更多缺陷（p = 0.003）。
• 在笔记本电脑上索引 58,924 个文件，约 2 小时。
• 在 Go 和 TypeScript 上调用图精度 0.976‑0.995，在 7 个数据集上优于其他六个工具。
• 所有分析都在本地运行，核心层无需 LLM 调用。

部署选项

• 自托管 – 在本地运行仪表板和 MCP 服务器（AGPL‑3.0）。
• 托管 SaaS – repowise.dev 提供相同的功能，加上即将推出的 Foresight 功能（针对真实代码变更模式训练的模型）和团队工作区。
• 企业版 – 支持多仓库工作区、合规报告、规模调整指南和可选的商业许可。

适用对象

• 希望编码助手拥有即时、准确上下文的开发人员。
• 寻求更安全的 pull‑request、测试选择智能和风险评分的团队。
• 需要自托管、零 API 密钥代码库智能以符合合规的组织。
• 任何希望使用数据驱动排名优先处理技术债务的人。

---

以上所有细节直接取自仓库的 README；未添加外部声明。