> ## Documentation Index
> Fetch the complete documentation index at: https://docs.42plugin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI 命令一览

> 所有 42plugin CLI 命令的快速参考

42plugin CLI 提供 19 个公开命令，覆盖从发现到发布的完整工作流。

## 发现与安装

| 命令          | 别名   | 说明                 | 文档                             |
| ----------- | ---- | ------------------ | ------------------------------ |
| `search`    | -    | 搜索插件（支持 AI 智能搜索）   | [命令行搜索](/install/cli-search)   |
| `suggest`   | -    | 智能推荐插件             | [智能推荐](/install/cli-suggest)   |
| `info`      | -    | 查看插件详情             | [查看插件详情](/install/cli-info)    |
| `auth`      | -    | 登录 / 登出            | [登录你的账号](/install/cli-auth)    |
| `install`   | `i`  | 安装插件或套包            | [安装插件](/install/cli-install)   |
| `list`      | `ls` | 查看已安装插件            | [查看已安装](/install/cli-list)     |
| `update`    | -    | 更新已安装插件            | [更新插件](/install/cli-update)    |
| `uninstall` | -    | 卸载插件               | [卸载插件](/install/cli-uninstall) |
| `upgrade`   | -    | 升级 42plugin CLI 自身 | -                              |

## 创作与发布

| 命令        | 别名    | 说明      | 文档                              |
| --------- | ----- | ------- | ------------------------------- |
| `publish` | `pub` | 发布插件    | [发布你的插件](/create/publish-share) |
| `check`   | -     | 发布前质量检查 | [发布前检查](/install/cli-check)     |
| `kit`     | -     | 管理套包    | [管理你的套包](/install/cli-kit)      |

## 特色能力

| 命令        | 别名 | 说明               | 文档                               |
| --------- | -- | ---------------- | -------------------------------- |
| `chat`    | -  | 对话管理（导出、搜索、自动保存） | [管理对话记录](/install/cli-chat)      |
| `eval`    | -  | 技能评估（分类、评测、报告）   | [技能评估套件](/builtin/42plugin-eval) |
| `builtin` | -  | 管理内置元能力          | [内置元能力](/builtin/index)          |

## 维护

| 命令      | 说明         |
| ------- | ---------- |
| `clean` | 清理插件缓存     |
| `purge` | 彻底清除所有本地数据 |

## 系统

| 命令           | 说明                                   |
| ------------ | ------------------------------------ |
| `status`     | 查看账户状态和配额（[详情](/install/cli-status)） |
| `completion` | 生成 shell 自动补全脚本                      |

***

## 命令详情

### search — 搜索插件

```bash theme={null}
42plugin search "关键词"
42plugin search "文献综述" --ai        # AI 智能搜索
42plugin search "科研" --kit           # 只搜索套包
42plugin search "关键词" --type skill  # 按类型筛选
42plugin search "review" --plugin      # 搜索已安装插件
42plugin search "关键词" --limit 5     # 限制结果数量
42plugin search "关键词" --all         # 显示所有结果
42plugin search "关键词" --json        # JSON 输出
```

### suggest — 智能推荐

```bash theme={null}
42plugin suggest                                    # 根据项目上下文推荐
42plugin suggest --for "我是产品经理，做 B 端 SaaS"   # 按角色推荐
42plugin suggest --for "数据分析"                     # 按场景推荐
```

### info — 查看插件详情

```bash theme={null}
42plugin info 42ailab/sci/psych-review
42plugin info 42ailab/sci/psych-review --json
```

### auth — 登录与登出

```bash theme={null}
42plugin auth                  # 登录
42plugin auth --status         # 查看状态
42plugin auth --logout         # 登出
```

### install — 安装插件

```bash theme={null}
42plugin install                                  # 交互式安装
42plugin install 42ailab/sci/psych-review          # 安装插件
42plugin install 42ailab/kit/sci                   # 安装套包
42plugin install like                              # 安装收藏
42plugin install <name> --global                   # 全局安装
42plugin install <name> --force                    # 强制重装
42plugin install <name> --no-cache                 # 跳过缓存
42plugin install <name> --optional                 # 安装可选依赖
42plugin install <name> --copy                     # 复制而非链接
```

### list — 查看已安装

```bash theme={null}
42plugin list                  # 当前项目
42plugin list --global         # 全局插件
42plugin list --all            # 所有项目
42plugin list --type skill     # 筛选类型
42plugin list --json           # JSON 输出
```

### update — 更新插件

```bash theme={null}
42plugin update                                    # 更新当前项目插件
42plugin update -g                                 # 更新全局插件
42plugin update -a                                 # 更新所有项目插件
42plugin update 42ailab/sci/psych-review            # 更新指定插件
42plugin update --check                             # 仅检查可用更新
42plugin update -a -y                              # 全自动更新，无需确认
```

### uninstall — 卸载插件

```bash theme={null}
42plugin uninstall 42ailab/sci/psych-review
42plugin uninstall 42ailab/sci/psych-review --global
```

### upgrade — 升级 CLI

```bash theme={null}
42plugin upgrade
```

### publish — 发布插件

```bash theme={null}
42plugin pub                           # 发布当前目录
42plugin pub ./my-plugin               # 发布指定路径
42plugin pub --public                  # 公开发布
42plugin pub --private                 # 私有发布（Pro）
42plugin pub --dry-run                 # 预演模式
42plugin pub --name my-plugin          # 指定名称
42plugin pub --type skill              # 指定类型
42plugin pub --kit my-kit              # 指定套包
42plugin pub --force                   # 强制发布
42plugin pub --no-sync-version         # 不同步版本号
```

### check — 发布前检查

```bash theme={null}
42plugin check                         # 检查当前目录
42plugin check ./my-plugin             # 检查指定路径
```

### kit — 管理套包

```bash theme={null}
42plugin kit list                                        # 查看套包列表
42plugin kit create my-toolkit                           # 创建套包
42plugin kit add my-toolkit 42ailab/sci/psych-review     # 添加插件
42plugin kit remove my-toolkit 42ailab/sci/psych-review  # 移除插件
42plugin kit info my-toolkit                             # 查看套包详情
```

### chat — 对话管理

```bash theme={null}
42plugin chat list                     # 查看对话列表
42plugin chat recent                   # 查看最近对话
42plugin chat search "关键词"           # 搜索对话
42plugin chat import <path>            # 导入对话
42plugin chat export                   # 交互式导出
42plugin chat export -d today          # 导出今天的对话
42plugin chat export -d week -o ~/my-chats  # 导出到指定目录
42plugin chat autosave                 # 查看自动保存状态
42plugin chat autosave on              # 开启自动保存
42plugin chat autosave off             # 关闭自动保存
```

### eval — 技能评估

```bash theme={null}
42plugin eval classify <技能路径>                    # 技能分类
42plugin eval init <技能路径>                         # 初始化评测工作区
42plugin eval init <技能路径> --force                 # 重新快照
42plugin eval run <技能路径> -i <轮次>                # 运行完整评测
42plugin eval benchmark <技能路径> -i <轮次>          # 查看统计摘要
42plugin eval report <技能路径> -i <轮次> --open      # 生成并打开 HTML 报告
42plugin eval serve <技能路径>                        # 启动本地报告查看器
```

所有子命令均支持 `--json` 输出。

### builtin — 管理内置元能力

```bash theme={null}
42plugin builtin list                  # 查看内置能力
42plugin builtin enable <name>         # 启用
42plugin builtin disable <name>        # 禁用
```

### clean — 清理缓存

```bash theme={null}
42plugin clean
```

### purge — 彻底清除

```bash theme={null}
42plugin purge
```

<Warning>
  `purge` 会删除所有本地数据，包括已安装的插件和配置。请谨慎使用。
</Warning>

### status — 账户状态

```bash theme={null}
42plugin status
```

### completion — Shell 补全

```bash theme={null}
42plugin completion bash       # Bash 补全
42plugin completion zsh        # Zsh 补全
42plugin completion fish       # Fish 补全
```

安装补全脚本：

```bash theme={null}
# Zsh（推荐）
42plugin completion zsh > ~/.zfunc/_42plugin

# Bash
42plugin completion bash > /etc/bash_completion.d/42plugin
```
