clean
用途
删除缓存的远程规范和保存的 API 调用响应。这可以释放磁盘空间，并在下次 update 或 mcp 启动时强制重新下载规范文件。
何时使用
- 远程服务器上的规范文件已更改，你想强制刷新
- 你想释放磁盘空间
- 你正在排查缓存过时的问题
- 在运行
update之前确保干净的重新缓存
语法
bash
swag2mcp clean [path]参数
| 参数 | 位置 | 必需 | 描述 |
|---|---|---|---|
path | 1 | 否 | 工作区目录。如果省略，通过路径解析规则解析。 |
标志
无。
工作原理
bash
swag2mcp clean
swag2mcp clean ./my-workspace清理的内容
| 目录 | 内容 | 原因 |
|---|---|---|
cache/ | 下载的远程规范文件 | 强制下次访问时重新下载 |
responses/ | 保存的 API 调用响应 | 释放磁盘空间 |
保留的内容
| 目录 | 内容 | 原因 |
|---|---|---|
specs/ | 本地规范文件 | 这些是你的源文件，不是缓存 |
auth_scripts/ | 认证脚本 | 这些是用户创建的，不是缓存 |
孤立认证脚本清理
清理后，clean 还会删除配置中不再存在的 spec 的认证脚本。这防止了过时脚本的积累。
自动清理
当 MCP 服务器启动（swag2mcp mcp）时，超过 48 小时的响应会自动删除。你通常不需要为日常维护手动运行 clean。
命令后验证
bash
ls ~/.swag2mcp/cache
# 应为空（目录存在但没有文件）细节
- 无需配置：
clean即使没有有效的配置文件也能工作。它只是删除缓存和响应目录。 - 孤立清理尽力而为： 如果配置文件损坏或无法读取，孤立认证脚本清理会被跳过（不会致命）。
- 目录被保留：
cache/和responses/目录本身被保留 — 只删除其内容。