Reasonix — 安装与卸载完整指南

---

一、安装

Reasonix 提供 三种安装通道，按你的平台选一种即可：

① npm（跨平台：macOS / Linux / Windows / WSL）

⚠️ 官网强调：latest 标签停留在旧的 0.x，务必用 @next 装 1.x（Go 重写版）

npm install -g reasonix@next

装完后验证：

reasonix --version

前提：Node.js ≥ 22

不想全局安装也行，临时跑一次：

npx reasonix@latest code

---

② Homebrew（macOS / Linux）

brew install esengine/reasonix/reasonix

升级：

brew upgrade esengine/reasonix/reasonix
# 或简写
brew upgrade reasonix

---

③ 桌面端 / 原生包（GUI 用户）

平台	下载
macOS	Universal DMG（Apple Silicon + Intel）→ 拖入 /Applications
Windows	Installer（x64 / ARM64）或 Portable zip
Linux	.deb 包 或 tar.gz 通用归档

macOS 首次启动若提示「已损坏」：

sudo xattr -rd com.apple.quarantine /Applications/Reasonix.app

Windows SmartScreen 点 「更多信息」→「仍要运行」

---

二、首次启动

cd your-project
reasonix

首次运行会让你贴 DeepSeek API Key，之后持久化保存在 ~/.reasonix/ 配置目录下。也可以用环境变量：

export DEEPSEEK_API_KEY=sk-...

---

三、卸载

按你当初的安装方式，选对应的卸载命令：

✅ 如果是 npm 装的

npm uninstall -g reasonix

dsnix 是 reasonix 的别名 shim，如果你也装了，顺手清掉：

npm uninstall -g dsnix

---

✅ 如果是 Homebrew 装的

brew uninstall esengine/reasonix/reasonix
# 或
brew uninstall reasonix

---

✅ 如果是桌面端 DMG / Windows Installer

• macOS：把 Reasonix.app 从 /Applications 拖进废纸篓即可
• Windows：Win + R → 输入 appwiz.cpl → 找到 Reasonix → 右键「卸载」

---

🧹 清理残留配置（所有方式装完都建议做这一步）

Reasonix 的配置、缓存、会话数据存在 ~/.reasonix 目录，卸载命令不会自动删它：

rm -rf ~/.reasonix

路径	内容
~/.reasonix/	API Key、配置、索引缓存、会话历史
~/.npm/_npx/	如果用过 npx reasonix，可能有缓存（可选清）

Windows 上对应路径是 %USERPROFILE%\.reasonix

---

四、一键对照速查

你当初用的	卸载命令	额外清理
npm i -g reasonix@next	npm uninstall -g reasonix	rm -rf ~/.reasonix
brew install ...	brew uninstall reasonix	rm -rf ~/.reasonix
DMG 拖进 Applications	把 App 扔废纸篓	rm -rf ~/.reasonix
Windows Installer	「程序和功能」里卸载	删 %USERPROFILE%\.reasonix

---

一句话：卸载本身只需要反向操作安装器（npm un -g / brew un / 拖废纸篓），但 真正的"彻底卸载"记得手动 rm -rf ~/.reasonix，那里存着你的 API Key 和所有缓存数据。