使用 Reasonix 接入 DeepSeek：从零搭建你的 AI 编程助手

1. 前言：两个主角

Reasonix 是什么？

Reasonix 是一个运行在终端中的 AI 编程助手。它不是你 IDE 里的一个插件——它就是你的编程伙伴本身。它可以直接：

• 📖 读你的代码：读文件、搜索内容、列出目录
• ✏️ 写你的代码：精确修改、多文件编辑、自动创建新文件
• ⚡ 执行命令：运行构建、测试、类型检查，甚至启动开发服务器
• 🧠 子代理模式：把复杂任务（代码审查、安全审计、全仓库探索）分派给隔离的子进程并行处理
• 📋 Plan 模式：做大型重构时，先生成计划等你审批，再动手——改错了回滚代价太大
• 

DeepSeek 是什么？

DeepSeek 是当下最热门的国产大模型之一。它提供了标准 API 接口，支持两个模型：

模型	定位	适合场景
deepseek-v4-pro	旗舰推理模型	复杂重构、源码分析、架构设计
deepseek-v4-flash	轻量快速模型	简单问答、代码补全、日常对话

为什么把它们组合？

Reasonix 负责编程工作流（文件操作、搜索、执行命令），DeepSeek 负责思考推理。你的代码永远留在本地，只有对话内容发送给模型。

你（在终端里）↔ Reasonix CLI（本地工具层）↔ DeepSeek API（云端推理）

---

2. 准备工作：获取 DeepSeek API Key

2.1 注册账号

访问 DeepSeek 开发者平台，用手机号或邮箱注册。

2.2 获取 API Key

登录后进入 API Keys 页面，点击「创建新的 API Key」，复制保存。Key 只会显示一次，请妥善保存！

2.3 充值（按需）

DeepSeek API 按 token 计费，价格远低于 GPT-4。新用户通常有免费额度。建议先充值 10-20 元测试，够用很久。

---

3. 安装 Reasonix

3.1 系统要求

• macOS / Linux / Windows（WSL 或原生终端）
• Node.js 18+
• 终端模拟器（iTerm2、Windows Terminal、Alacritty 均可）

3.2 安装

# 通过 npm 全局安装
npm install -g reasonix

# 验证安装
reasonix --version

如果安装成功，会输出版本号。

或者

Reasonix

4. 配置 DeepSeek 接入

4.1 设置环境变量

将你的 DeepSeek API Key 设为环境变量。建议写入 shell 配置文件（~/.zshrc 或 ~/.bashrc）方便持久化：

# 编辑配置文件
vim ~/.zshrc

# 添加以下两行
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
export DEEPSEEK_MODEL="deepseek-v4-pro"  # 或者 deepseek-v4-flash

# 使其生效
source ~/.zshrc

或者
直接 界面中 输入API_KEY 即可
我已经输入过了 进入 主界面了

4.2 选择模型：pro vs flash

场景	推荐模型
分析几百行源码、做架构重构方案	deepseek-v4-pro
改一行配置、问个技术概念、日常聊天	deepseek-v4-flash
不确定？先用 flash，不行切 pro	—

💡 省 token 技巧：把默认模型设为 flash，在需要深度推理时临时切换。Reasonix 支持运行时动态换模型。

4.3 验证配置

reasonix code

启动后输入 hello，如果正常回复，说明 DeepSeek 已成功接入。

---

5. 基础使用快速上手

5.1 第一个对话：让它读你的项目

进入你的项目目录，启动 Reasonix：

cd ~/my-project
reasonix code

然后直接问：

分析一下这个项目的目录结构，主要模块有哪些？

Reasonix 会自动调用 directory_tree 查看结构，调用 read_file 读关键文件，然后给你一个分析总结。

5.2 让它帮你写代码

在 src/utils 下创建一个 formatDate.ts，接收 Date 对象，返回 yyyy-MM-dd 格式的字符串。

Reasonix 会直接创建文件，写好代码。你可以说「把格式改成 yyyy/MM/dd」，它会精确修改那一行。

5.3 让它帮你搜索

项目里有哪些地方调用了 getUserById 函数？

Reasonix 会执行全局搜索，每一条结果都带上文件路径和行号，点击即可跳转。

5.4 让它帮你改代码（真正的编辑模式）

把 UserService 里的所有 console.log 改成 logger.info

Reasonix 会精准定位每一处 console.log，生成 SEARCH/REPLACE 编辑，逐处替换——不是重写整个文件，只改你要改的地方。

---

6. 进阶功能

6.1 Plan 模式：大改前的"审批表"

做多文件重构时，直接让它动手风险太高。Plan 模式让你先审后改：

> /plan
> 我想把整个项目的异常处理从 try-catch 改成全局 ExceptionHandler

Reasonix 会生成一份完整计划——包括要改哪些文件、每个文件改什么、哪一步风险高——等待你审批。你确认后它才开始动手。

6.2 Skills（技能）系统：一键调用专业工作流

Reasonix 内置了一系列可复用的"技能"。常用场景：

# 代码审查——让子代理审查你的改动
/review "focus on the auth module"

# 安全审查——专门检查注入、密钥泄露、路径穿越
/security-review "check all user input handling"

# 探索代码库——让子代理去读几十个文件，你只看结论
/explore "find all places where password is handled"

你可以用 /skill <skill-name> 调用已有技能，也可以用 create_skill 创建自己的专属技能。

6.3 Memory 系统：让 Reasonix"记住"你的偏好

Reasonix 默认不知道你的项目规范。用 Memory 告诉它：

> 记住：这个项目用 pnpm 不是 npm，所有安装命令用 pnpm
> 记住：我们团队禁止用 any 类型，代码审查时严格检查

以后每次对话，这些记忆会自动加载到上下文中。它也支持项目级记忆（只在这个项目生效）和全局记忆（所有项目都生效）。

6.4 Subagent（子代理）：并行处理大任务

当你有两件独立的事情需要同时调查时：

> 同时分析一下 UserService 的 bug 和 OrderService 的性能问题

Reasonix 会启动两个隔离的子代理并行调查，各自在独立的上下文中读文件、分析，最后把结论汇总给你。子代理的工具调用不进你的主对话上下文，节省大量 token。

6.5 MCP Server：接入外部工具

Reasonix 支持 MCP 协议，可以接入第三方工具扩展能力：

# 接入文件系统工具
reasonix mcp add filesystem --from-catalog filesystem

# 接入 GitHub 工具
reasonix mcp add github --from-catalog github

接入后，Reasonix 可以直接操作文件系统、查询 GitHub Issue 等。

---

7. 最佳实践

7.1 给上下文，再提问

❌ 不好：「修复这个 bug」
✅ 好：「读取 src/user/login.ts 文件，第 45 行的 validateToken 返回了 null 导致下游 NPE，帮我分析原因并修复」

Reasonix 能看到你的文件系统，但先说清楚你要查什么，它才精准定位。

7.2 Plan 模式不滥用

• 改一两个文件 → 直接说，让它改
• 改 5+ 个文件或涉及架构变更 → /plan 走审批

一个原则：如果改错了你无法一行 git checkout -- . 回滚，就走 Plan 模式。

7.3 简单任务用 flash，省钱又快

日常问答、解释代码、搜文件——fly 模型完全够用。遇到需要深入推理的——分析复杂源码、设计架构方案——再切到 pro。

7.4 善用 Memory 固化规则

每当你发现 Reasonix 反复犯同样的"错误"（比如不用你项目的包管理器），别只是纠正——用 Memory 让它永远记住。一劳永逸。

7.5 子代理是省 token 的利器

当你需要了解"项目中所有数据库操作是怎么做的"——不要让它直接在主对话中读几十个文件（会爆上下文）。用 /explore 交给子代理，它读完分析完，只返回结论。

---

8. 常见问题 FAQ

Q：API Key 设置了但 Reasonix 不认？

检查：

1. 确认环境变量名是 DEEPSEEK_API_KEY（全大写）
2. 确认 source ~/.zshrc 或重启终端
3. 用 echo $DEEPSEEK_API_KEY 验证是否输出正确的 key

Q：pro 和 flash 怎么选？

你要做什么	选
日常聊天、解释概念	flash ✅
搜索文件、简单重构	flash ✅
深度源码分析、架构方案	pro ✅
不确定？	flash 先试，不够再切 pro

Q：怎么看用了多少 token？

每次对话结束后，Reasonix 会显示本轮 token 使用量。你也可以用 reasonix stats 查看历史统计。

Q：代码安全吗？

Reasonix 是一个本地终端应用。你的源代码不会被上传到任何第三方服务器——只有你发给模型的对话内容会发送到 DeepSeek API。所有文件操作（读、写、搜索、执行命令）都是在你本地完成的。

---

结语

Reasonix + DeepSeek 的组合，本质上是把"编程"和"思考"解耦：

• Reasonix 负责编程工作流——它是一个懂文件系统、会执行命令、能管理子任务的"手"
• DeepSeek 负责推理——它是能理解复杂需求、分析源码、生成方案的"脑"

两者通过 API 连接在一起，给你一个在终端里就能完成阅读 → 思考 → 修改 → 验证完整闭环的 AI 编程伙伴。

现在，打开终端，装上 Reasonix，接上 DeepSeek，开始你的第一段对话吧。