Reasonix 是一款专为 DeepSeek 模型设计的开源终端 AI 编程助手，支持在终端和桌面客户端中使用。以下是其核心使用方法：
一、 环境准备与安装
环境要求：需要安装 Node.js（建议 ≥ 20.10 或 22 版本）。Windows 用户需额外安装 Git for Windows。
获取密钥：前往 DeepSeek 开放平台申请并获取 API Key。
启动方式：
终端版：无需全局安装，进入项目目录后运行 npx reasonix code 即可快速启动。首次运行会引导输入 API Key 并自动保存。
桌面客户端：支持 macOS、Windows、Linux，下载安装包后直接打开，内置运行时，零配置即可启动。
二、 核心运行模式
启动后，你可以根据需求选择不同的运行模式：
编程模式 (code)：主入口，支持文件读写、执行终端命令。例如输入“帮我写一个 Express 服务器”，它会自动读取项目、编辑代码并展示修改预览。
纯聊天模式 (chat)：运行 reasonix chat，不触碰文件和终端，适合纯粹的技术问答或代码片段分析。
一次性任务 (run)：运行 reasonix run "任务"，适合执行单次指令并将结果输出到标准输出（stdout）。
三、 常用快捷命令
在交互界面中，可通过斜杠命令（/）调出功能菜单：
模型与推理切换：输入 /pro 可临时升级到 v4-pro 模型（用完自动回落）；使用 /preset 或 /effort 切换思考深度（如 fast、smart、max）。
权限与执行模式：按 Shift+Tab 切换执行模式。review（敏感操作需确认）、AUTO（编辑自动执行，终端命令需确认）、YOLO（全自动执行，不建议在生产环境使用）。
项目初始化：输入 /init 生成 REASONIX.md 配置文件。
上下文管理：使用 /compact 手动压缩当前上下文，防止 token 累积。
账单与状态：输入 /stats 查看 token 消耗、缓存命中率和费用；运行 reasonix doctor 进行环境健康检查。
四、 进阶功能
Plan 模式（先审后改）：在进行多文件重构等大改动前，输入 /plan，Agent 会生成包含修改文件和步骤的完整计划，等待你审批后再执行，降低风险。
Skills（技能）系统：支持使用 Markdown 编写可复用的工作流。可通过 /skill new 创建自定义技能，或使用内置技能如 /review（代码审查）、/security-review（安全审查）。
MCP 扩展：支持接入 Model Context Protocol 服务器。配置写在 ~/.reasonix/config.json 中，或通过 /mcp 命令浏览内置市场并安装。
持久记忆：支持项目级和全局级两层记忆，使用 /memory 管理，让 Agent 记住你的项目规范和偏好。
移动端与网页端：
QQ 通道：在终端运行 /qq connect，可将会话延伸至 QQ，在手机上继续对话。
网页控制台：终端启动后会显示本地链接（如 http://127.0.0.1:11555/?token=），复制到浏览器打开可获得更直观的可视化操作界面。
