ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

REA 卸载只需两步:rea uninstall 与 --purge-data 各管什么

REA 卸载只需两步:rea uninstall 与 --purge-data 各管什么

REA 卸载只需两步:rea uninstall 与 --purge-data 各管什么

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

REA(Reverse Engineer Anything)用完了想体面地请它走人?卸载清理没那么可怕:整套流程只处理 REA 自己写入的注册项、技能文件和本地数据,你的分析引擎、其他工具和其他数据全部原样保留。

🧭 动手前:先认清 REA 卸载会碰到的三样东西

REA 留在机器上的痕迹只有三类:

  • MCP 注册项:各 Agent 配置文件里一条名为rea的服务器条目;
  • 技能目录:~/.agents/skills/下的reverse-engineer-anything技能(部分 Agent 还有各自的技能目录);
  • 本地数据:~/.rea/cache与~/.rea/state,外加系统缓存里的 Kuna 默认缓存、(Linux 上)Hopper 发布归档。

卸载认的是所有权,而不是文件名——能证明是 REA 写入的,才会被处理。

🪶 温和移除:rea uninstall 默认卸载移除清单

先跑温和的一步:

rea uninstall

这条命令会遍历所有受支持的 Agent 客户端配置(共 26 个条目,覆盖 Claude Code、Cursor、Codex、Gemini CLI、Windsurf、VS Code 等),逐个检查它们的配置文件,只摘除 REA 写入的那条rea注册项,文件里其他内容原样写回。

两个要心里有数的保险:

  • 如果你手动配置了一个也叫rea的 MCP 服务器、但它不是 REA 的,会被识别为非 REA 所有而原样保留;
  • 改动之前,原配置先备份为同目录下的.rea.backup文件,想回退就把备份覆盖回去。

技能目录同理:清单能确认是 REA 装的才移除,目录里别的文件保留。主流程实现在 src/application/Uninstall.ts。

🧽 彻底清理:--purge-data 额外清理范围与保留清单

第一步跑得没问题的话,可以进一步把 REA 的数据缓存也清干净:

rea uninstall --purge-data

两种模式的差别:

  • 默认rea uninstall:移除注册项和 REA 技能文件,保留~/.rea本地数据;
  • 加--purge-data:额外移除~/.rea/cache与~/.rea/state、Kuna 默认缓存、(Linux 上)Hopper 发布归档缓存。

它依旧不碰的:

  • Hopper、Ghidra、IDA 等分析引擎——哪怕 Hopper 是 setup 阶段经 REA 审批装的,卸载也原样保留,结果清单里还明确把它标成 retained;
  • Node.js、npm 等运行环境;
  • 你自己装的其他技能与 MCP 服务器;
  • Evidence 文件、网络捕获 HAR 等分析产物。

--purge-data参数在 src/cli/setupCommands.ts 注册,MCP 键名rea与技能名集中在 identity.ts 维护。

📋 跑完看四句话:卸载状态说明(removed / retained / skipped / failed)

结果是结构化清单,每条带一个状态。怎么读:

  • removed:成功移除,无需处理;
  • retained:REA 主动选择不碰——同名条目不是 REA 的,或路径是符号链接。看一眼 detail 确认即可,也可以放着不管;
  • skipped:没有事可做,该客户端没有 REA 注册项或路径不存在,无需处理;
  • failed:没操作成,多是权限问题。按提示处理完,直接重跑。

整个流程是幂等的:有failed条目时整体状态就是失败,但处理好之后把同一条命令再跑一遍即可,已经干净的部分不会重复处理。

🛑 卸载主动踩刹车的四种情况

情况不对时,REA 宁可停下也不乱动。逻辑统一是:遇到什么 → 它做什么 → 你做什么:

  1. 配置解析不了:文件损坏或格式不对 → 不改动该文件 → 先修好配置再重跑;
  2. 备份写不了:.rea.backup写不出去 → 完全不做修改 → 检查权限后重跑;
  3. 写入失败:配置写入或回读校验没过 → 先恢复原文并保留备份 → 查看报错信息,或手动用备份还原;
  4. 受管路径是符号链接:~/.rea/cache、~/.rea/state或技能目录是指向别处的链接 → 不删除 → 先确认链接目标再手动处理。

一句话收束:rea uninstall摘掉的是 REA 在各 Agent 里的注册和装好的技能,--purge-data再把~/.rea下 REA 自己的缓存与状态清掉——分析引擎、其他工具和其他数据都原样保留,放心清理。

  • docs/installation.md:安装、更新与卸载的完整说明
  • docs/cli.md:命令输出与退出状态参考

【免费下载链接】reaReverse engineer anything with agents, from app behavior down to native binaries.项目地址: https://gitcode.com/GitHub_Trending/rea2/rea

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进