2026/5/1大约 5 分钟
Reasonix 使用指南（详细版）
1. Reasonix 是什么
Reasonix 是一个基于 AI 的代码理解与编程代理工具（AI Coding Agent）。
它的核心能力包括：
- 理解整个项目结构
- 分析代码依赖关系
- 自动修改代码
- 生成功能
- 重构项目
- 自动执行命令
- 修复 Bug
- 编写测试
- 理解大型旧项目
适合：
- Java
- Go
- Python
- Vue
- React
- Node.js
- PHP
- Rust
- Linux 运维脚本
等项目。
2. 安装 Node.js
Reasonix 依赖 Node.js。
官方下载：
建议安装：
- Node.js 22 LTS
- npm 自动附带
安装完成后验证：
node -v
npm -v3. 安装 Reasonix
推荐使用 npx：
npx reasonix code首次运行会自动下载。
4. PowerShell 报错解决
如果出现：
无法加载文件 npx.ps1，因为在此系统上禁止运行脚本执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser然后输入：
Y再重新运行：
npx reasonix code5. 启动方式
方法1：当前目录启动
进入项目目录：
cd your-project启动：
npx reasonix code方法2：指定目录
npx reasonix code ./project6. 首次启动会发生什么
Reasonix 会：
- 扫描项目
- 建立代码索引
- 分析依赖关系
- 理解项目结构
- 进入 AI 交互界面
大型项目首次会稍慢。
7. 核心工作模式
Reasonix 本质上是：
AI + 项目理解 + 自动修改代码你通过自然语言告诉它：
- 想做什么
- 修改哪里
- 修复什么
- 添加什么功能
它会自动：
- 阅读代码
- 分析逻辑
- 修改文件
- 生成代码
8. 最常见使用方式
8.1 理解项目
分析整个项目结构解释这个项目的登录流程说明数据库调用链解释这个 Vue 项目的权限系统8.2 查找代码
查找 token 校验位置查找 websocket 连接逻辑查找 protobuf 编解码逻辑8.3 修改代码
给用户列表增加分页给登录接口增加验证码将 axios 改成 fetch把项目升级到 Vue38.4 修复 Bug
修复 token 过期后页面白屏问题修复 websocket 重连失败修复 vite import.meta 报错8.5 自动生成功能
生成用户管理模块生成 RBAC 权限系统生成 RESTful API生成 protobuf 请求结构9. 推荐的高效使用方式
9.1 先让它理解项目
不要一上来就：
直接改推荐：
先分析项目结构然后：
解释认证流程再：
增加 JWT 自动续期效果会好很多。
9.2 一次只做一件事
不要：
重构整个项目并升级依赖顺便修复全部bug推荐：
先升级 Vue再：
修复路由最后：
修复状态管理9.3 指定文件范围
非常重要。
例如：
只修改 src/api/user.ts不要修改数据库结构仅修改前端页面这样 AI 更稳定。
10. 对旧项目特别强
Reasonix 最大优势：
理解旧项目
尤其适合：
- 屎山项目
- 无文档项目
- 多年老项目
- 多人维护项目
例如：
解释这个项目的启动流程分析订单状态流转说明 websocket 消息结构11. 和 DeepSeek 配合使用
很多人会：
Reasonix + DeepSeek-V4-Pro因为：
- DeepSeek 长上下文强
- 代码理解强
- 成本低
适合：
- 大项目
- 重构
- 代码解释
12. 常用 AI 提示词（非常重要）
理解项目
分析整个项目结构并说明模块职责理解调用链
分析用户登录后的完整调用链理解数据库
分析数据库表关系理解前后端交互
分析前端如何调用后端接口理解 websocket
分析 websocket 消息结构和处理流程protobuf
分析 protobuf 编解码流程重构
将该模块重构为更清晰的结构，但保持原功能不变Vue
将 Options API 改为 Composition APIJava
将该 Controller 改为 RESTful 风格Go
优化 goroutine 并发结构13. 大项目使用技巧
13.1 忽略无用目录
非常重要。
例如：
node_modules
dist
build
target
vendor否则会浪费大量 token。
13.2 分模块处理
不要一次分析整个超大型项目。
推荐：
只分析 auth 模块只分析 websocket 模块13.3 先读再改
推荐流程：
1. 先解释代码
2. 再分析问题
3. 最后修改准确率会更高。
14. 成本问题（重点）
Reasonix 本身只是：
AI Agent 外壳真正花钱的是：
大模型 token最耗 token 的场景
1. 大型旧项目
因为需要读取大量文件。
2. 全项目重构
例如：
Vue2 -> Vue33. 多轮自动修复
AI 会：
- 读取
- 修改
- 再读取
- 再修复
循环消耗。
15. 降低成本技巧
15.1 指定目录
只分析 src/auth15.2 指定文件
只修改 login.ts15.3 禁止扫描
不要读取 node_modules15.4 不要一次做太多
错误示例：
重构整个系统正确：
先重构用户模块16. 推荐工作流（最佳实践）
第一阶段：理解
分析项目结构解释启动流程说明核心模块第二阶段：定位
查找登录逻辑查找权限校验第三阶段：修改
增加功能修复 bug第四阶段：重构
优化结构拆分模块17. 适合的项目类型
Reasonix 特别适合：
- 旧项目维护
- 中大型项目
- 微服务
- 前后端分离
- Vue/React
- Java Spring
- Go 服务端
- WebSocket
- Protobuf
18. 不太适合的场景
超小项目
几十行代码：
直接问 ChatGPT 更快极度复杂架构迁移
例如：
单体 -> 微服务AI 很容易失控。
建议：
人工 + AI 配合19. 常见问题
Q1：为什么很慢？
因为：
- 正在扫描项目
- 建立索引
- 分析依赖
大型项目正常。
Q2：为什么 token 消耗高？
因为：
- 读取大量文件
- 多轮推理
- 自动修复循环
Q3：为什么 AI 会改错？
因为：
- 上下文不足
- 项目太复杂
- 指令不清晰
Q4：如何提高准确率？
关键：
明确指定：
1. 修改范围
2. 修改目标
3. 不允许修改什么20. 最推荐的使用方式
真正高效的方式：
AI 做：
- 理解
- 查找
- 生成
- 重构
- 重复劳动
人做：
- 架构
- 决策
- 最终审核这是目前 AI 编程最稳定的工作模式。