最后核验: 2026-06-03

解疑

Reasonix 常见问题

你可以在这里区分下载方式、版本状态、账号登录和中文用户常见问题。

Reasonix 和普通 OpenAI-compatible CLI 有什么不同?

Reasonix 的官方介绍强调 DeepSeek-native、prefix-cache stability、flash-first 成本控制和自动 tool-call repair;它不是把别的 CLI 简单换一层模型名。

第一次应该在哪个目录运行 npx reasonix code?

在你希望 Reasonix 读取和修改的项目目录里运行。这样文件上下文、命令输出和项目记忆都会绑定到正确仓库。

首次运行前应该检查哪些版本?

先检查 node -v、npm -v、npm view reasonix engines 和 npm view reasonix dist-tags。当前 npm 包声明 Node >=22;如果旧教程不一致,优先看实时包信息。

现在应该用 npx、全局 npm 安装还是源码构建?

入门体验用 npx reasonix code;需要长期复用命令时再用 npm i -g reasonix;只有在需要审计、修改或验证最新提交时,才从 main-v2 源码构建。

为什么 npm latest 和 npm next 不一样?

按 2026-06-04 查询,npm latest 是 0.53.2,npm next 是 1.1.0。未指定版本的 npm 和 npx 默认走 latest;只有明确想试 next 线时才指定 tag。

登录页会保存你的 API Key 吗?

不会。登录页使用 Clerk 处理站内账号会话。DeepSeek API Key 应保存在你自己的环境变量或 Reasonix 本地配置中。

DeepSeek API Key 应该放在哪里?

放在本机 Reasonix 配置、shell 环境变量或本地密钥管理工具里。不要贴到社区帖子、截图、公开 issue 或仓库提交中。

npx reasonix code 拉不起来或版本不对怎么办?

先运行 npm view reasonix dist-tags,检查 npm cache,并只在明确需要时指定 reasonix@latest 或 reasonix@next。如果全局安装覆盖了 npx,再检查 PATH 和 npm 全局 bin 目录。

提示 reasonix command not found 怎么办?

优先用 npx reasonix code,不需要全局安装。若使用全局安装,重新安装后确认 npm 全局 bin 目录已加入 PATH,并确认当前位于目标项目目录。

/help、/pro、/preset max 分别什么时候用?

先用 /help 查看当前 TUI 命令;需要下一轮更强推理时用 /pro;整个会话都需要更强模型配置时再用 /preset max。

Reasonix 适合什么类型的项目?

它更适合本地代码仓库:需要读取文件、运行命令、持续保留上下文的 DeepSeek-native 开发任务。只是一次性短问答时,普通聊天或轻量 CLI 就够了。

发支持问题时应该提供哪些信息?

提供执行命令、操作系统、node -v、npm -v、使用的 npm tag 和简短报错摘要。发布前删除 API Key、token、私有仓库地址和完整环境变量。