⚡

清除插件缓存Skill clear-plugin-cache

清除插件缓存技能，用于管理Claude插件系统，通过清理缓存解决插件异常、释放磁盘空间，操作后需重新安装插件。关键词：插件缓存清除、Claude工具、DevOps操作、软件维护、缓存管理。

DevOps 0 次安装 0 次浏览 更新于 3/11/2026

name: clear-plugin-cache description: 清除缓存的插件副本（之后需要重新安装） argument-hint: [plugin-name] [–force]（可选） allowed-tools: Read, Bash(rm:), Bash(ls:), Bash(du:), Bash(test:), Glob

清除插件缓存命令

从插件系统缓存中清除缓存的插件副本。这是一个更激进的操作，会删除整个插件安装，之后需要重新安装。

何时使用

  • 插件在更新后行为异常
  • 插件安装损坏
  • 释放大量磁盘空间
  • 需要全新重新安装

对于完全插件重置（包括注册表和设置）：使用 /user-config:reset-plugins 代替。此命令仅清除缓存，同时保留注册表。

清除与保留的内容

清除：

  • ~/.claude/plugins/cache/ - 所有缓存的插件副本

保留（不清除）：

  • ~/.claude/plugins/installed_plugins.json - 插件注册表（知道要重新安装什么）
  • ~/.claude/plugins/known_marketplaces.json - 市场源

参数

  • 无参数：清除所有插件缓存（提示确认）
  • plugin-name：仅清除指定插件的缓存（例如 claude-ecosystem）
  • –force：跳过确认

示例：

/clear-plugin-cache                        # 清除所有插件
/clear-plugin-cache claude-ecosystem       # 仅清除 claude-ecosystem
/clear-plugin-cache --force                # 清除所有，无需确认
/clear-plugin-cache claude-ecosystem --force   # 清除一个，无需确认

步骤 1：解析参数

plugin_filter = None  # 或特定插件名称
force_mode = "--force" in arguments（不区分大小写）

# 解析：任何不是 --force 的内容被视为插件名称
for arg in arguments:
    if arg.lower() == "--force":
        force_mode = True
    elif not arg.startswith("--"):
        plugin_filter = arg

步骤 2：定位插件缓存

插件缓存位于：~/.claude/plugins/cache/

结构：

~/.claude/plugins/
  cache/
    {marketplace}/
      {plugin-name}/
        {version}/
          ...（完整插件副本）

步骤 3：清点缓存内容

列出将清除的内容：

# 列出所有市场目录
ls -la ~/.claude/plugins/cache/

# 对每个市场，列出插件
ls -la ~/.claude/plugins/cache/{marketplace}/

# 获取总大小
du -sh ~/.claude/plugins/cache/

如果设置了 plugin_filter，则仅清点该特定插件。

步骤 4：确认（除非使用 --force）

如果 NOT force_mode，呈现缓存清除计划：

对于所有插件

## 插件缓存清除计划

**目标：** 所有缓存的插件副本

| 市场 | 插件 | 大小 |
| --- | --- | --- |
| claude-code-plugins | 10 | 120 MB |

**总计：** 120 MB 跨 10 个插件

> **警告：** 这将删除所有已安装插件。
> 您需要使用 `/plugin install {name}@{marketplace}` 重新安装它们。
> 插件注册表（installed_plugins.json）被保留，因此 Claude Code
> 知道要重新安装什么。

**继续？** 回复“yes”以继续，或使用 `--force` 跳过此确认。

对于单个插件

## 插件缓存清除计划

**目标：** 仅 claude-ecosystem 插件缓存

| 插件 | 版本 | 大小 |
| --- | --- | --- |
| claude-ecosystem | 3.0.0 | 106 MB |

> **注意：** 清除后，使用以下命令重新安装：
> `/plugin install claude-ecosystem@claude-code-plugins`

**继续？** 回复“yes”以继续，或使用 `--force` 跳过此确认。

步骤 5：清除缓存

对于所有插件

rm -rf ~/.claude/plugins/cache/*

对于单个插件

# 查找并删除所有市场中的特定插件
rm -rf ~/.claude/plugins/cache/*/{plugin-name}

步骤 6：报告成功

## 插件缓存已清除

成功清除插件缓存。

**清除：**
- X 个插件（Y MB 总计）

**保留：**
- installed_plugins.json（插件注册表）
- known_marketplaces.json（市场源）

**下一步：**
使用以下命令重新安装插件：

`/plugin install {plugin-name}@{marketplace}`

或交互式浏览并重新安装：

`/plugin`

错误处理

  • 缓存未找到： 报告“未找到插件缓存目录或已为空。”
  • 权限被拒绝： 报告“权限被拒绝。检查 ~/.claude/plugins/cache/ 上的文件权限。”
  • 插件未找到： 报告“在缓存中未找到插件“{name}”。可用插件：{list}”

安全说明

  • 这对本地和基于 git 的市场都是安全的 - 缓存始终是下游副本
  • 本地市场： 插件将从源目录重新复制
  • Git 市场： 插件将从远程重新克隆/获取

原始源（您的本地仓库或 git 远程）永远不会被修改。

跨平台说明

  • Windows：~ 解析为 %USERPROFILE%
  • 使用正斜杠路径以保持一致性
  • rm -rf 在 Windows 上的 Git Bash 中有效

相关命令

  • /user-config:reset-plugins - 完全插件重置（缓存 + 注册表 + 设置）
  • /user-config:prune - 通用 Claude Code 缓存清理（排除插件）
  • /plugin uninstall {name} - 正确移除特定插件