最后核验: 2026-06-03

相关报错命令行

Reasonix 命令行报错排查清单

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

npx reasonix code 拉不起来或版本不对

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。

没有 DeepSeek API Key 或登录凭证失效

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

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

源码构建提示 make/go 找不到

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/选择复制相关问题。

以 # 开头的消息没有被 agent 收到

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

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

需要确认 DeepSeek API 连通性

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

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

GitHub issue tracker