repowise 使用教程

repowise 是一款面向AI时代的代码库智能分析工具，30秒索引任意仓库，自动生成文档和依赖图，为AI编程助手提供架构感知能力。 ## 快速开始 1. 安装 repowise：运行 added 80 packages in 27s 33 packages are looking for funding run `npm fund` for details 或通过 Docker 部署（适合团队共享）。 2. 索引你的代码仓库：在项目根目录执行 ，工具会在 30 秒内完成代码解析、依赖分析和文档生成。 3. 启动 MCP 服务：运行 ，启动 MCP 工具服务端。在 Claude Code 或 Cursor 的配置中添加 MCP 服务地址，AI 助手即可获得代码仓库的深度理解能力。 4. 访问 Web 面板：运行 在浏览器中查看生成的 Wiki 文档、依赖关系图和代码健康报告。 ## 核心功能演示 **功能一：自动架构文档生成** 执行 后，工具会扫描整个代码仓库，自动识别模块边界、核心接口和数据流向，生成结构化的 Wiki 文档。文档包含目录结构说明、模块职责描述、关键类/函数的调用关系，以及自动生成的架构图。文档会随代码变更自动更新。 **功能二：MCP 工具集成** 启动 MCP 服务后，在 Claude Code 中提问 这个项目的认证流程是怎么实现的，AI 会通过 repowise 的 MCP 工具查询代码的调用链和依赖关系，给出基于实际代码结构的精准回答，而不是猜测。repowise 提供了 9 个 MCP 工具，覆盖代码搜索、依赖查询、热点分析等场景。 **功能三：代码健康评估** 运行 ，工具会从多个维度评估代码质量：复杂度分布、重复代码比例、测试覆盖率缺口、过时依赖等，生成 0-100 的健康评分。还会标记出高风险变更区域，帮助团队在 code review 时重点关注。 ## 实际使用案例 **场景一：新成员快速上手大型项目** 后端开发小赵刚加入一个有 20 万行代码的电商项目。他用 repowise 索引仓库后，通过生成的 Wiki 文档和架构图快速理解了系统全貌。在 Claude Code 中开发功能时，AI 能准确告诉他应该在哪个模块添加代码、需要遵循哪些现有模式，上手时间从预期的两周缩短到了三天。 **场景二：重构前的风险评估** 团队计划重构支付模块但担心影响范围太大。用 repowise 分析后，工具清晰展示了支付模块被 12 个其他模块依赖，列出了所有调用入口和数据流向，还标记出了 3 处复杂度过高的热点代码。团队据此制定了分阶段重构方案，重构过程中没有出现遗漏导致的线上问题。 ## 常见问题 FAQ **Q1：支持哪些编程语言？** 目前支持 JavaScript/TypeScript、Python、Go、Java、Rust 等主流语言。对于不在支持列表中的语言，会以通用方式解析文件结构和依赖关系，但深度分析能力会受限。 **Q2：索引大型仓库会不会很慢？** 得益于增量索引技术，首次索引 10 万行代码约 30 秒。后续只索引变更文件，通常几秒即可完成。如果是超大型单体仓库（百万行级别），建议按模块分别索引。 **Q3：代码数据会不会上传到外部？** 不会。repowise 完全本地运行，所有分析数据存储在本地的 目录中。支持完全离线使用，适合对数据安全要求严格的企业环境。 ## 小贴士 1. 配合 使用：在项目根目录创建 文件，排除 、 等目录，索引更快且结果更精准。 2. CI/CD 集成：在流水线中添加 命令，当代码健康评分低于阈值时自动阻止合并，持续守护代码质量。 3. 定期更新索引：设置 git hook 在每次提交后自动运行 ，确保 AI 助手始终基于最新代码结构给出建议。