oh-my-hermes卸载完全指南：omh uninstall --all与包管理器清理全流程-二趣网

oh-my-hermes卸载完全指南：omh uninstall --all与包管理器清理全流程

【免费下载链接】oh-my-hermesAll in one plugin for Hermes Agent ⚚ the coding intelligence, a long-term memory system and model optimized workflow packages项目地址: https://gitcode.com/GitHub_Trending/ohm/oh-my-hermes

oh-my-hermes（OMH）是 Hermes Agent 的一体化插件，为 Hermes 提供编码智能、长期记忆系统和模型优化的工作流包。当你决定不再使用它时，官方提供了完整的卸载流程：先用omh uninstall --all清掉 OMH 管理的全部本地状态和 Hermes 集成，再按安装来源用对应的包管理器命令移除 CLI 本身。本文面向新手，带你走通从"预览要删什么"到"机器上彻底无痕"的每一步，全程安全、可回退、不碰无关文件。

卸载前：先分清 OMH 装在机器上的三层

很多新手卸载不干净，是因为不清楚 OMH 到底动了哪些地方。OMH 会落地三层内容：

层	位置	说明
① CLI 命令包	包管理器全局包，或 install 脚本隔离的 venv	提供你敲的`omh`命令
② Hermes 集成	Hermes 配置里的 skills 注册、`~/.hermes/plugins/omh`插件包、TUI 组件与皮肤	让 Hermes"长出"OMH 能力
③ 本地状态	`~/.omh`（含模型链配置、长期记忆等）	OMH 自己的数据目录

对应地，卸载也要两步：omh uninstall --all负责清掉第②③层（顺带清理 installer 托管的 venv），包管理器命令负责清掉第①层。完整说明见官方文档 Uninstall 章节。

第一步：安全预览——omh uninstall --dry-run 先看看会删什么

在执行任何删除操作前，官方强烈建议先跑一次"空跑"：

omh uninstall --dry-run

它不会修改任何东西，只会列出即将被清理的注册项和文件。这是 OMH 一贯的设计哲学——只删它"有清单证明属于自己"的文件；凡是无法证明归属的目录（比如你自己放进去的同名目录），它会保留并明确报告，而不是盲目删除。

第二步：执行完整卸载——omh uninstall --all 全流程说明

确认预览结果没问题后，执行：

omh uninstall --all

--all（等价别名--purge，裸omh uninstall也是完整卸载）会完成以下动作：

把~/.omh/skills从 Hermes 配置中注销，并删除~/.omh整个状态目录（含已审核的记忆记录）
删除带 OMH 清单的~/.hermes/plugins/omh插件包，以及生成的团队角色文件
对~/.hermes/profiles/下每个 bot profile 做同样的注销与清理（同样受清单校验保护）
当当前命令正运行在 install.sh 托管的 venv 里时，连带移除该 venv 与命令链接
不会动无关的 Hermes 文件、其他插件、其他 agent，也不会碰 pipx 或开发环境里的 Python 环境

几个进阶参数，按需使用即可：

参数	作用
`--dry-run`	只预览，不修改
`--registration-only`	仅注销 Hermes 配置里的注册项，保留插件目录（这会成为"刻意退出"标记，后续`omh update`不会重新注册）
`--remove-files`	旧版清理：注册项 +`~/.omh`目录
`--force`	仅在你确实要连"无管理的"`~/.hermes/plugins/omh`目录一起删时才加
`--keep-command`	保留 install.sh 托管的命令 venv/链接，只清 Hermes 侧状态

第三步：按安装来源清理 CLI——包管理器移除对照表

omh uninstall --all管不到通过包管理器安装的第①层。注意顺序：先跑omh uninstall --all清状态，再执行包管理器移除命令（反过来只删 CLI 的话，~/.omh、记忆和 Hermes 注册都会保留下来）。

当初的安装方式	移除 CLI 的命令
Homebrew（`brew install rlaope/tap/omh`）	`brew uninstall omh`
Bun（`bun install -g oh-my-hermes`）	`bun remove -g oh-my-hermes`
npm（`npm install -g oh-my-hermes`）	`npm uninstall -g oh-my-hermes`
curl / PowerShell 安装脚本	一般无需额外操作，managed venv 已被`omh uninstall`清理

顺手清理：npm/Bun 启动器的轮子缓存

npm/Bun 方式安装的启动器会在系统缓存里保留当前 wheel 及最近两次使用的缓存（废弃的暂存目录 24 小时后自动移除）。omh uninstall --all不会动这块缓存；如果你要求"完全无痕"，等所有omh进程退出后手动删除对应目录即可：

macOS：~/Library/Caches/oh-my-hermes/npm
Linux：$XDG_CACHE_HOME/oh-my-hermes/npm（回退为~/.cache/oh-my-hermes/npm）
Windows：%LOCALAPPDATA%\oh-my-hermes\Cache\npm

卸载后验证：确认 OMH 已彻底离开

omh --version # 应提示命令不存在 omh doctor # 同上；若仍可运行，说明 CLI 包还留在 PATH 上

文档原文也提示：卸载后omh仍能运行，意味着命令包还在PATH上——回到第三步，用当初安装它的那个包管理器（或 pip/pipx）移除即可。确认无误后，可以顺手重启一次 Hermes Desktop，让 bot 会话重新加载技能列表。

常见问题：卸载时最容易踩的 4 个坑 🛠️

1. 只想让某个 bot 退出 OMH，不想全部卸载？针对单个 profile 只注销注册（保留插件目录作为退出标记）：

omh --hermes-home ~/.hermes/profiles/<name> uninstall --registration-only

2. 卸载后omh update会把注册带回来吗？不会。只要走的是--registration-only这类"刻意退出"路径，插件目录留在原地就是标记，更新逻辑尊重这个选择、绝不重新注册。

3. 装错了版本想推倒重来？直接omh uninstall --all后重装即可：重新安装（Homebrew/Bun/npm/安装脚本任选）再跑一次omh setup，状态从零开始，不会残留旧版本干扰。

4. 会不会误删我自己在~/.hermes/plugins/omh里放的东西？不会。无 OMH 清单、无法证明归属的目录默认保留并在输出中报告；只有你显式加--force才会删。

总结：卸载 oh-my-hermes 就记四步 ✅

omh uninstall --dry-run：先预览，心里有数
omh uninstall --all：清掉 Hermes 集成 +~/.omh状态
brew uninstall omh/bun remove -g oh-my-hermes/npm uninstall -g oh-my-hermes：按安装来源移除 CLI
需要完全无痕时，手动删除 npm 缓存目录并重启 Hermes

整套流程设计得相当"新手友好"：每一步都可预览、可只删一半、绝不越权删除。想深入了解各参数的完整语义，可查阅 docs/INSTALLATION.md，实现上可参考卸载命令入口 src/commands/main.py 与安装器 src/install/installer.py。

祝卸载顺利，机器干净如初！👋

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析