卸载
移除 Apothem 并清理工具配置。
先移除工具配置
本页使用的裸 apothem 命令，是一键安装器（即安装指南中的第 3 个安装渠道）写入的垫片，该垫片所在目录位于 PATH 中之后即可运行。在其他安装渠道上，按照安装指南所述，把 apothem 替换为 npx @ahmed-g-gad/apothem 即可。
在卸载 Apothem 之前，先移除每个工具适配器的配置，让你的工具回到干净的状态。运行 apothem harnesses list 查看当前已安装了哪些适配器，然后逐个移除，或使用覆盖整个注册表的选择器：
apothem uninstall --harness claude-code
apothem uninstall --harness cursor --project /path/to/project
apothem uninstall --harness all --project /path/to/project --yes传入 --yes 可跳过每个工具的确认提示。
移除引擎
移除方式与你所使用的安装渠道相对应。渠道编号取自安装渠道表：
-
Claude Code 插件（渠道 1）——在 Claude Code 内部移除该插件：
/plugin uninstall apothem@apothem（插件市场条目可以通过/plugin marketplace remove ahmed-g-gad/apothem移除）。 -
npx（渠道 2）——无需移除任何内容；
npx从其缓存中运行。若要删除缓存副本，请使用npm cache clean --force清除缓存。 -
一键安装器（渠道 3）——从检出目录运行对应的卸载脚本：
scripts/installer/uninstall.sh（POSIX）或scripts/installer/uninstall.ps1（PowerShell）。每个脚本都会移除由--harness（PowerShell 中为-Harness）指定的工具；未指定时依次取APOTHEM_HARNESS，最后默认为 Claude Code。它同时还会移除apothem命令垫片。源码取自APOTHEM_SOURCE（若已设置），否则取自APOTHEM_HOME（默认为$HOME/.apothem）。除非传入--remove-source（PowerShell 中为-RemoveSource），否则源码会保留。该标志只删除APOTHEM_HOME处的受管克隆，且仅当其包含.git目录时才会删除。若使用默认位置，它还会删除~/.apothem/下的安装备份与台账。两者在删除工具配置与源码之前都会先请求确认。--yes（PowerShell 中为-Yes）可跳过这些确认。两者都会拒绝不安全的目标。 -
VS Code 系扩展（渠道 4）——先从命令面板运行 Apothem: Uninstall 以移除工具配置，然后在扩展视图中移除该扩展，或使用
code --uninstall-extension ahmed-g-gad.apothem-vscode移除（通过较早的apothem.vsix安装的副本，标识符为ahmed-g-gad.apothem）。默认情况下，该扩展通过npx运行引擎，因此上面的 npx 条目已涵盖缓存。 -
命令行引导入口（渠道 5–7）——在工具配置被移除之后，使用其宿主工具移除该扩展或插件。各宿主如下：
channel 5 Gemini CLI extension channel 6 Qwen Code extension channel 7 Codex plugin该引导入口只添加通过
npx调用引擎的助手上下文（一个上下文文件、一条命令或一项技能），因此不会残留其他任何内容。渠道 5 和 6 的扩展宿主提供卸载命令；对于渠道 7 的插件宿主，请在其插件浏览器中卸载apothem。gemini extensions uninstall apothem # channel 5 qwen extensions uninstall apothem # channel 6 -
直接引擎（渠道 8）——无需卸载任何内容；在工具配置被移除之后，删除该克隆即可。
-
备份与状态——安装备份位于
~/.apothem/backups/下，安装台账位于~/.apothem/state/下。两者的规模都保持有界：每次安装、卸载和回滚之后，Apothem 会为每个安装根目录保留最新的 10 条安装记录，为每个工具保留最新的 10 组备份，并且绝不删除某条被保留的记录仍需要的备份，因此最近 10 次安装仍可回滚。若要保留更少，运行apothem backups prune --keep N（加上--dry-run可先查看它将移除哪些内容）；它绝不会移除回滚某个工具最近一次安装时所要恢复的那份备份。一旦引擎已被移除，且你不再需要任何历史记录，删除~/.apothem/。
不会被移除的内容
- 位于
~/.config/apothem/profile.yaml或--profile PATH的共享配置档案 YAML 绝不会被apothem uninstall移除。 - 工具目录中无关的、由操作者编写的文件会被保留。
- 你添加到共享设置文件中的条目会被保留：你自己的权限规则、MCP 服务器和钩子处理程序都会保留。卸载只移除安装台账记录为属于 Apothem 的键和列表条目（参见设置）。
- 安装根目录下
.apothem/中的共享数据存储（memory/、contexts/、learning/）会保留，只要同一根目录下仍有另一个已安装的工具在使用它们。卸载该根目录下的最后一个工具时，会先将每个存储复制到~/.apothem/backups/中，然后将其连同其中的全部内容一并移除。 <project>/.apothem/plans/（以及旧版<project>/.plans/）下的计划套件不受影响。
目录
卸载还会移除安装所创建的目录（例如首次安装之前并不存在的 ~/.claude/），前提是这些目录已为空。仍存放着你的文件、或存放着另一个已安装工具所使用数据的目录会被保留。安装之前就已存在的目录绝不会被移除。
要彻底清理某个工具的根目录，请先确认你已备份所有想要保留的自定义规则、辅助器或配置档案文件，然后移除工具参考页面上记录的工具原生路径。