# ai-cli-cleaner 中文文档 规范地址：https://npmcn.com/package/ai-cli-cleaner/ 版本：0\.1\.0-beta\.6 npm 元数据更新时间：2026-11-03T00:53:36.017Z 中文译文更新时间：2026-11-03T03:03:54.689Z 软件包许可：MIT 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/ai-cli-cleaner 原文对照：https://npmcn.com/package/ai-cli-cleaner/?lang=original 项目主页：https://github.com/Huang-KJ/ai-cli-cleaner#readme 源码仓库：https://github.com/Huang-KJ/ai-cli-cleaner ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.8 MB，190 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：^22\.22\.2 \|\| ^24\.15\.0 \|\| ^26\.0\.0 - 运行依赖：2 个 - 首次发布：2026-10-18T03:58:05.812Z - 最新版本发布：2026-11-03T00:46:41.413Z - 已发布版本数：7（近 12 个月 7 个） ## 中文简介 安全地从Codex， Copilot, Antigravity, OpenCode， Grok和Claude Code中删除本地对话。 ## 安装 ```sh npm install ai-cli-cleaner ``` 也可以使用：`pnpm add ai-cli-cleaner`、`yarn add ai-cli-cleaner`、`bun add ai-cli-cleaner` ## README # AI CLI Cleaner [![CI](https://github.com/Huang-KJ/ai-cli-cleaner/actions/workflows/ci.yml/badge.svg)](https://github.com/Huang-KJ/ai-cli-cleaner/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/ai-cli-cleaner?label=npm)](https://www.npmjs.com/package/ai-cli-cleaner) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://npmcn.com/package/ai-cli-cleaner/LICENSE) [![Platform: macOS 26+](https://img.shields.io/badge/platform-macOS%2026%2B-lightgrey.svg)](https://npmcn.com/package/ai-cli-cleaner/docs/compatibility.md) [![Node.js: 22 / 24 / 26](https://img.shields.io/badge/node-22%20%7C%2024%20%7C%2026-339933.svg)](https://npmcn.com/package/ai-cli-cleaner/docs/installation.md#requirements) 审查和删除本地AI代理对话在macOS上。选择单独的会话或清除座席的本地历史记录，包括支持的索引和相关数据。内存是默认保存的。保留已知的登录、设置、MCP、技能和插件路径；进程、打开文件、路径、所有权和格式检查可以拒绝操作。 这是测试版软件。保持一个独立的备份，回顾预览和 [格式的限制](https://npmcn.com/package/ai-cli-cleaner/docs/compatibility.md)，并在删除前关闭所选代理。文件移动到macOS垃圾桶；支持的索引更改具有备份和操作日志。恢复是手动的，垃圾不是安全擦除。 ## 安装 要求macOS 26或更高版本，Node.js `^22.22.2`， `^24.15.0`，或者 `^26.0.0`， NPM为10、11或12；与这些Node.js版本绑定的npm可以正常工作。Node.js和npm必须已经安装。 ```bash npm install --global ai-cli-cleaner@latest ai-cleaner --version ai-cleaner doctor --all ``` 该包包括编译后的CLI、本机帮助程序和绑定的运行时依赖项；不需要源代码构建。每个版本，包括测试版，都是使用npm发布的 `latest` 标记，因此重新运行相同的命令将安装最新版本。内置的更新程序使用单独发布的GitHub版本，所以它不遵循npm的dist-tags。看到 [安装和更新](https://npmcn.com/package/ai-cli-cleaner/docs/installation.md) 用于运行时设置、源代码/存档的安装和删除。 ## 快速启动 检查您的环境，预览整个范围，并在交互式终端中查看单个对话： ```bash ai-cleaner doctor --target codex ai-cleaner clean --target codex --dry-run ai-cleaner clean --all --dry-run --verbose ai-cleaner conversations --target codex --dry-run ``` 关闭选定的代理，然后再次运行选择器并确认要删除的对话： ```bash ai-cleaner conversations --target codex ``` 对于代理人 **本地会话历史和相关数据**，查看预览，保持代理关闭，并运行： ```bash ai-cleaner clean --target codex ``` **记忆默认是完整的，包括和 `--all`， `--yes`，或者 `--force-stop`.** 添加 `--include-memories` 仅当您还希望删除受支持的内存存储时。在运行之前预览更大的作用域： ```bash ai-cleaner clean --all --include-memories --dry-run --verbose ai-cleaner clean --all --include-memories --force-stop ``` 默认保留Codex的内存数据库和 `memories/`心意相通的 `memory/`，以及克劳德的项目和子代理的内存目录。保留的记忆仍然可以包含删除的对话的信息。 `conversations` 也默认保留记忆；它的 `--include-memories` 选项仅删除可归因于所选对话的支持记录，即当前法典数据库记录。在选择删除期间，共享内存文件和其他代理的内存存储保持不变。看到 [内存范围](https://npmcn.com/package/ai-cli-cleaner/docs/compatibility.md#memory-preservation) 对于精确路径。 **法典完全清除也移除有效 `YYYY-MM-DD` 目录直接在里面 `~/Documents/Codex`，其中包含所有内容—包括项目源文件。** 它也去掉了那个根 `.DS_Store` 仪元数据。它保存了 `Codex` 根目录、普通命名项目目录、无效日期和以日期命名的文件。删除选定对话不会删除这些工作区。完全清理还可以包括附件、语音记录、目标、队列、生成的图像、可视化、日志和缓存。确认前请查看实际路径。 ## 支持代理 | 代理 | `--target` | 选择对话 | 全面清理 | | --- | --- | --- | --- | | Codex CLI / App | `codex` | 支持本地记录和索引 | 包括上面描述的过时的工作区 | | GitHub Copilot CLI | `copilot` | 支持的会话记录和索引 | 支持的本地历史和相关数据 | | 谷歌反重力CLI / IDE | `antigravity` | 当任一共享protobuf摘要非空时阻塞 | 包括已知的CLI和IDE根 | | OpenCode | `opencode` | 支持的SQLite格式 | 在混合数据库中保留受支持的帐户/配置数据 | | Grok Build命令行 | `grok` | 支持的会话和索引 | 当地的历史;回忆只与 `--include-memories` | | 克劳德代码 | `claude` | 预览;使用完全清理来删除 | 本地历史、工件和支持的Desktop Code边栏记录；回忆只与 `--include-memories` | 支持取决于存储格式和所有权检查。 [兼容性](https://npmcn.com/package/ai-cli-cleaner/docs/compatibility.md) 定义验证用例、根、遗留存储和拒绝；桌面GUI行为和云模型不在这些CLI案例中。当Antigravity的共享摘要阻止个人删除时，使用其内置的 `/resume` 接口。OpenCode遗留JSON支持对已知会话子目录的完全清除，但不支持选择性删除。 ## 命令 | 命令 | 目的 | | --- | --- | | `ai-cleaner conversations` | 选择一个代理，然后交互式地选择对话； `--target` 直接选择一个代理。 | | `ai-cleaner clean --target codex,copilot` | 清除所选代理的完整本地历史记录。 | | `ai-cleaner clean --all --dry-run` | 预览所有六个代理的清理摘要。 | | `ai-cleaner clean --all --include-memories --dry-run` | 预览包含支持内存存储的所有代理。 | | `ai-cleaner clean --target claude` | Clean Claude Code支持本地历史和相关数据。 | | `ai-cleaner doctor --all` | 检查平台、工具、数据根和正在运行的代理。 | | `ai-cleaner recovery list` | 列出本地操作记录。 | | `ai-cleaner recovery inspect ` | 检查备份、完整性和手动恢复指导。 | | `ai-cleaner update` | 查看GitHub公共版本以获得更新的稳定版本。 | | `ai-cleaner update --install` | 在受支持的全局安装中验证并安装已发布的更新。 | 运行 `ai-cleaner --help` 为选项。对话和恢复列表使用系统时区； `--timezone Asia/Taipei` 或者另一个IANA区域覆盖它。 `doctor`， `recovery list`, `recovery inspect ` 支持 `--json`;看到 [复苏](https://npmcn.com/package/ai-cli-cleaner/docs/recovery.md) 用于操作状态、保留副本和手动恢复。 `clean` 默认情况下显示简短的摘要，包括是否保留或包含内存。添加 `--verbose` (或 `-v`)获取完整的范围、路径和索引更新； `clean --all --dry-run --verbose` 在不停止代理或删除原件的情况下预览这些详细信息。关机影响、过时的Codex工作空间内容、错误和恢复路径仍然可见，没有详细的输出。 ## 数据处理和限制 清理作用于已知的本地路径。它不调用提供商云历史api，不发现任意工作区，也不搜索磁盘。同步受影响文件的外部服务可能会传播其本地删除。自定义根如不同 `CODEX_HOME` 拒绝;符号链接或重新定位的文档根不支持Codex完全清除。 `--force-stop` 请求关闭，并可能关闭ChatGPT/Codex或克劳德桌面应用程序时选择。 `--yes` 跳过完全清理确认，但保留过程和数据检查。开放的SQLite数据库或sidecars，未知的格式，模糊的所有权，以及发现后的更改可能会阻止删除；保存数据并调查拒绝。 演练不会删除原始数据或停止代理。SQLite检查使用私有临时副本，其中可能包含敏感数据和旁注；这些副本随后会被移到垃圾桶。垃圾、备份和日志会保留数据，直到你处理它们；该工具从不清空废纸篓或擦除备份。选择的删除遵循受支持的id、拥有的路径和数据库关系，而不从文本提及推断所有权。 ## 终端和脚本 对话选择和确认需要一个标准输入和标准错误的交互式终端。提示和错误归为标准错误；结果将输出到标准输出。对于脚本，使用 `clean --dry-run`，然后使用 `clean --yes` 只有当跳过确认是故意的。管道 `y` 在发现或变异之前，交互式命令被拒绝。 退出密码是 `0` 成功或故意取消No/Escape， `1` 对于错误或不完整的操作，和 `130` 用于在交互式提示期间按Ctrl-C。 ## 文档和社区 [安装](https://npmcn.com/package/ai-cli-cleaner/docs/installation.md) · [兼容性](https://npmcn.com/package/ai-cli-cleaner/docs/compatibility.md) · [复苏](https://npmcn.com/package/ai-cli-cleaner/docs/recovery.md) · [贡献](https://npmcn.com/package/ai-cli-cleaner/CONTRIBUTING.md) · [安全](https://npmcn.com/package/ai-cli-cleaner/SECURITY.md) 报告可重现的bug和特性请求 [GitHub的问题](https://github.com/Huang-KJ/ai-cli-cleaner/issues)，使用合成示例和编辑输出。保留会话、原始数据库、帐户标识符、完整的个人路径、秘密和完整的报告日志。遵循 [安全策略](https://npmcn.com/package/ai-cli-cleaner/SECURITY.md) 用于漏洞披露。 下许可 [麻省理工学院](https://npmcn.com/package/ai-cli-cleaner/LICENSE)． 捆绑的本机Trash helper包含自己的helper [麻省理工学院的许可](https://npmcn.com/package/ai-cli-cleaner/vendor/license) 和 [出处](https://npmcn.com/package/ai-cli-cleaner/vendor/provenance.json)． 项目拥有的索赔帮助器具有独立的 [源和二元来源](https://npmcn.com/package/ai-cli-cleaner/vendor/claims-provenance.json). ## 常见问题 ### ai-cli-cleaner 是什么？ 安全地从Codex， Copilot, Antigravity, OpenCode， Grok和Claude Code中删除本地对话。 ### 如何安装 ai-cli-cleaner？ 在项目目录运行 npm install ai-cli-cleaner，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ai-cleaner，可以用 npx ai-cleaner 直接运行。 ### ai-cli-cleaner 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ai-cli-cleaner 是否存在。 ### ai-cli-cleaner 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### ai-cli-cleaner 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js ^22\.22\.2 \|\| ^24\.15\.0 \|\| ^26\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### ai-cli-cleaner 可以商用吗？ ai-cli-cleaner 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### ai-cli-cleaner 还在维护吗？ 最新版本 0\.1\.0-beta\.6 发布于 2026/11/03（今天）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/10/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。