Reasonix 命令行报错排查清单

你可以用这些命令检查 Node/npm、DeepSeek API Key、Go 构建链和终端交互问题，同时避免暴露密钥。

排查顺序

先确认命令和版本，再看凭证，最后处理系统环境。这样能减少无效重装，也不会把密钥贴到公开页面。

确认 node -v、npm dist-tags、npx 或全局命令是否指向预期版本。

确认 DeepSeek API Key 存在且只保存在本机环境、Reasonix 配置或安全的 secret manager 中。

源码构建再检查 Go/make；交互异常再检查终端、Shell、Windows Terminal 或 Git for Windows。

node -v
npm view reasonix engines
npm view reasonix dist-tags
npm cache verify
npx reasonix@latest code

以实时 npm metadata 判断当前 Node 要求和 package tag。如果 npx 拉到非预期包，先清 npm cache 或显式指定目标 tag。

open https://platform.deepseek.com/api_keys
printenv DEEPSEEK_API_KEY
npx reasonix code

先确认 DeepSeek Platform API Key 是否存在；不要把 Key 写进公开仓库。

go version
make --version
git switch main-v2
make build

main-v2 是 Go 重写分支，源码构建需要 Go toolchain 和 make。

echo $TERM
printf '\e[?1000h'
# Windows 用户优先确认 Git for Windows 与 Windows Terminal 设置

GitHub issue #2649 正在跟踪 Windows Terminal 滚动/PageUpDown/选择复制相关问题。

npx reasonix@latest code
# 临时规避：消息前加空格或换行，再观察 issue #2658

这是 2026-06-02 仍在打开的 GitHub bug 反馈，适合在新闻/报错区持续跟踪。

curl -s https://api.deepseek.com | head
# 再回到 Reasonix 内运行 /help 或 /pro 验证模型切换

网络连通不等于鉴权成功；鉴权问题仍要回到 API Key 和 Reasonix 配置检查。