CLI 命令一览
所有 42plugin CLI 命令的快速参考与逐命令详解
42plugin CLI 提供 19 个公开命令，覆盖从发现到发布的完整工作流。下面先给出总览表，再在「命令详解」中逐个说明用法、选项和示例。
发现与安装
| 命令 | 别名 | 说明 | 文档 |
|---|---|---|---|
search | - | 搜索插件（支持 AI 智能搜索） | 命令行搜索 |
suggest | - | 智能推荐插件 | 智能推荐 |
info | - | 查看插件详情 | 查看插件详情 |
auth | - | 登录 / 登出 | 登录你的账号 |
install | i | 安装插件或套包 | 安装插件 |
list | ls | 查看已安装插件 | 查看已安装 |
update | - | 更新已安装插件 | 更新插件 |
uninstall | - | 卸载插件 | 卸载插件 |
upgrade | - | 升级 42plugin CLI 自身 | 升级 CLI |
创作与发布
| 命令 | 别名 | 说明 | 文档 |
|---|---|---|---|
publish | pub | 发布插件 | 发布你的插件 |
check | - | 发布前质量检查 | 发布前检查 |
kit | - | 管理套包 | 管理你的套包 |
特色能力
| 命令 | 别名 | 说明 | 文档 |
|---|---|---|---|
chat | - | 对话管理（导出、搜索、自动保存） | 管理对话记录 |
eval | - | 技能评估（分类、评测、报告） | 技能评估套件 |
builtin | - | 管理内置元能力 | 内置元能力 |
维护
| 命令 | 说明 |
|---|---|
clean | 清理插件缓存 |
purge | 彻底清除所有本地数据 |
系统
| 命令 | 说明 |
|---|---|
status | 查看账户状态和配额（详情） |
completion | 生成 shell 自动补全脚本 |
命令详解
登录你的账号
使用 42plugin auth 命令登录你的账号（设备授权码方式）。
登录步骤
42plugin auth
执行后会：
- 自动打开浏览器
- 显示设备验证码（如：
ABCD-1234） - 在浏览器中输入验证码
- 完成登录
如果浏览器未自动打开，请手动复制显示的链接并在浏览器中打开
查看登录状态
42plugin auth --status
登出
42plugin auth --logout
切换账号
42plugin auth --logout
42plugin auth
安装插件
使用 42plugin install（别名 i）命令安装插件和套包。
安装单个插件
42plugin install 42ailab/sci/psych-review
交互式安装
不传插件名时，自动进入交互式搜索模式：
42plugin install
输入关键词搜索，用空格选择多个插件，回车确认安装。
安装套包
42plugin install 42ailab/kit/sci
套包会安装多个相关插件。
一键安装收藏
42plugin install like
这会安装你在网页上收藏的所有插件。
活水插件采用高并发下载和智能缓存，几乎所有插件都是秒下体验！
全局安装
42plugin install <name> --global
全局安装的插件对所有项目生效，存放在 ~/.claude/
强制重新安装
42plugin install <name> --force
安装选项
| 选项 | 说明 |
|---|---|
--global | 全局安装，对所有项目生效 |
--force | 强制重新安装 |
--no-cache | 跳过缓存，从服务器重新下载 |
--optional | 仅安装套包中的可选插件 |
--copy | 复制到当前目录而非符号链接 |
从 Git 仓库安装
除了从市场安装，你还可以从任意 Git 仓库直接安装：
42plugin install github.com/anthropics/skills
支持 GitHub、GitLab、CNB 等任意 Git 平台。
Git 直装详细指南
了解 Git 直装的完整用法、支持格式和配额规则
查看已安装
使用 42plugin list（别名 ls）命令查看已安装的插件。
42plugin list # 当前项目
42plugin list --global # 全局插件
42plugin list --all # 所有项目
42plugin list --type skill # 筛选类型
42plugin list --json # JSON 输出
- 支持的类型：skill、command、hook、agent
--json以 JSON 格式输出，方便脚本处理和自动化集成
更新插件
使用 42plugin update 命令更新已安装的插件。支持并行版本检查，快速完成更新。
更新当前项目插件
42plugin update
更新全局插件
42plugin update -g
更新所有项目的插件
42plugin update -a
更新指定插件
42plugin update 42ailab/sci/psych-review
检查可用更新
42plugin update --check
仅检查哪些插件有可用更新，不实际更新。
自动确认
42plugin update -a -y
跳过确认提示，适合脚本和自动化场景。
示例
$ 42plugin update --check
检查更新中...
可用更新：
42ailab/sci/psych-review 1.0.0 → 2.1.0
42ailab/dev/code-review 1.2.0 → 1.3.0
运行 42plugin update 以更新所有插件
$ 42plugin update
更新中...
✓ 42ailab/sci/psych-review 2.1.0
✓ 42ailab/dev/code-review 1.3.0
已更新 2 个插件
更新选项
| 选项 | 说明 |
|---|---|
-g, --global | 更新全局安装的插件 |
-a, --all | 更新所有项目的插件 |
--check | 仅检查可用更新 |
-y, --yes | 自动确认，无需手动确认 |
--force | 强制更新（忽略版本检查） |
建议定期运行 42plugin update 保持插件最新，获得最佳体验和安全修复。
卸载插件
使用 42plugin uninstall 命令卸载已安装的插件。
42plugin uninstall 42ailab/sci/psych-review # 卸载插件
42plugin uninstall 42ailab/sci/psych-review --global # 卸载全局插件
示例：
$ 42plugin uninstall 42ailab/sci/psych-review
✓ 已卸载 42ailab/sci/psych-review
| 选项 | 说明 |
|---|---|
--global | 卸载全局安装的插件 |
卸载插件不会删除你在使用该插件时产生的数据或对话记录。
命令行搜索
使用 42plugin search 命令在命令行中搜索插件。
基础搜索
42plugin search "关键词"
AI 智能搜索
使用 -A 或 --ai 启用 AI 智能搜索，用自然语言描述你的需求：
42plugin search "我想做心理学文献综述" --ai
AI 会理解你的意图，推荐最匹配的插件。
免费用户每天 42 次 AI 搜索，Pro 用户每天 420 次（且可搜索私有插件）。
搜索特定类型
42plugin search "文献综述" --type skill
只搜索套包
42plugin search "科研" --kit
搜索已安装插件
使用 -p 或 --plugin 在已安装的插件中搜索：
42plugin search "review" --plugin
限制数量与 JSON 输出
42plugin search "关键词" --limit 5 # 限制结果数量
42plugin search "关键词" --all # 显示所有结果
42plugin search "关键词" --json # JSON 输出
搜索选项
| 选项 | 说明 |
|---|---|
-A, --ai | 启用 AI 智能搜索 |
--type <type> | 按类型筛选（skill、command、hook、agent） |
--kit | 只搜索套包 |
-p, --plugin | 在已安装插件中搜索 |
--limit <n> | 限制返回结果数量 |
--all | 显示所有结果（不分页） |
--json | 以 JSON 格式输出结果 |
智能推荐
使用 42plugin suggest 命令，AI 会分析你当前的项目上下文，从 2.3 万+ 插件中推荐最适合的。
基础用法
42plugin suggest
AI 通过五层信号检测分析你的项目：
- 文件类型 — .pptx、.pdf、.ipynb 等推断使用场景
- 角色关键词 — 扫描 CLAUDE.md、README.md 中的角色描述
- Node.js 依赖 — 读取 package.json
- Python 依赖 — 读取 requirements.txt、pyproject.toml
- 语言特征 — go.mod、Cargo.toml、pubspec.yaml 等
按角色推荐
跳过项目扫描，直接描述你的角色或场景：
42plugin suggest --for "我是产品经理，做 B 端 SaaS"
42plugin suggest --for "写报告 PPT"
42plugin suggest --for "数据分析"
不只是开发者！产品经理、设计师、运营、HR 等角色都能获得有针对性的推荐。
示例
$ 42plugin suggest
🔍 分析项目上下文...
推荐插件：
1. 42ailab/dev/code-review - 代码审查助手
2. 42ailab/dev/test-gen - 测试用例生成
3. 42ailab/dev/doc-gen - 文档生成工具
输入编号安装，或按 Enter 跳过
使用配额
| 套餐 | 每日次数 |
|---|---|
| 免费版 | 5 次 |
| Pro 版 | 420 次 |
查看插件详情
使用 42plugin info 命令查看插件的详细信息。
42plugin info 42ailab/sci/psych-review
命令会显示插件的完整信息：
- 名称和描述
- 版本号
- 作者信息
- 活水指数（42score）
- 下载次数
- 插件类型（skill、command、hook、agent）
- 所属套包
- 依赖关系
- 最近更新时间
示例：
$ 42plugin info 42ailab/sci/psych-review
📦 42ailab/sci/psych-review
描述: 心理学文献检索与综述助手
版本: 2.1.0
类型: skill
作者: 42ailab
活水指数: 4.7
下载: 1,234
更新: 2025-03-01
套包: 42ailab/kit/sci
加 --json 以 JSON 格式输出，方便脚本处理：
42plugin info 42ailab/sci/psych-review --json
账户与配额
使用 42plugin status 命令查看你的账户信息和使用配额。
42plugin status
输出示例：
$ 42plugin status
👤 账户信息
用户名: zhangsan
邮箱: zhangsan@example.com
套餐: Pro
到期: 2026-12-31
📊 今日使用
AI 搜索: 45 / 420
智能推荐: 12 / 420
插件安装: 8 / 无限
42skill 生成: 2 / 42
42skill 试炼: 5 / 42
💾 本地存储
已安装插件: 23 个
缓存大小: 12.3 MB
每日配额
| 功能 | 免费版 | Pro 版 |
|---|---|---|
| AI 语义搜索 | 42 次/天 | 420 次/天 |
| 智能推荐 | 5 次/天 | 420 次/天 |
| 插件安装 | 42 次/天 | 无限 |
| 42skill 生成 | 1 次/天 | 42 次/天 |
| 42skill 试炼 | 3 轮/天 | 42 轮/天 |
了解更多套餐详情，请查看 Pro 与组织版。
管理你的套包
使用 42plugin kit 命令管理你的插件套包。套包是一组相关插件的集合，方便分享和批量安装。
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 # 查看套包中包含的所有插件
完整示例：
# 创建一个开发工具套包
$ 42plugin kit create dev-tools
✓ 创建套包 dev-tools
# 添加常用插件
$ 42plugin kit add dev-tools my-org/main/code-review
$ 42plugin kit add dev-tools my-org/main/test-gen
$ 42plugin kit add dev-tools my-org/main/doc-gen
# 查看套包内容
$ 42plugin kit info dev-tools
📦 dev-tools
- my-org/main/code-review
- my-org/main/test-gen
- my-org/main/doc-gen
发布插件时使用 --kit 参数可以直接发布到指定套包：42plugin pub --kit dev-tools
发布前检查
使用 42plugin check 命令在发布前检查插件质量和规范性。
42plugin check # 在插件目录下运行，检查当前插件
42plugin check ./my-plugin # 检查指定路径
命令会检查以下内容：
| 检查项 | 说明 |
|---|---|
| 文件结构 | SKILL.md 等必要文件是否存在 |
| Frontmatter | 元数据是否完整（name、description、version） |
| 内容质量 | 描述长度、结构化程度、示例数量 |
| 规范合规 | 是否符合 AgentSkill 等规范要求 |
| 安全检查 | 是否包含敏感信息或危险操作 |
示例：
$ 42plugin check
检查 ./my-plugin...
✓ 文件结构完整
✓ Frontmatter 格式正确
⚠ 建议添加更多使用示例
✓ 无安全风险
活水指数预估: 4.2 / 5.0
建议：添加 2-3 个代码示例可提升评分
建议在每次发布前运行 42plugin check，确保插件质量。也可以使用 42plugin pub --dry-run 模拟完整发布流程。
升级 CLI
42plugin upgrade
升级 42plugin CLI 自身。
发布插件
详细流程见 发布你的插件。
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 # 不同步版本号
对话管理
详细用法见 管理对话记录。
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 # 关闭自动保存
技能评估
详细用法见 技能评估套件。
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 输出。
管理内置元能力
详细说明见 内置元能力。
42plugin builtin list # 查看内置能力
42plugin builtin enable <name> # 启用
42plugin builtin disable <name> # 禁用
清理缓存
42plugin clean
彻底清除
42plugin purge
purge 会删除所有本地数据，包括已安装的插件和配置。请谨慎使用。
Shell 补全
42plugin completion bash # Bash 补全
42plugin completion zsh # Zsh 补全
42plugin completion fish # Fish 补全
安装补全脚本：
# Zsh（推荐）
42plugin completion zsh > ~/.zfunc/_42plugin
# Bash
42plugin completion bash > /etc/bash_completion.d/42plugin