# 42plugin
Source: https://docs.42plugin.com/builtin/42plugin
插件搜索与管理增强
用自然语言搜索、安装、发布插件。不用记命令，说人话就行。
## 如何使用
在 Claude Code 中输入：
```bash theme={null}
/42plugin
```
然后用自然语言告诉 AI 你想做什么。
## 搜索插件
想找科研论文相关的插件？直接说：
```bash theme={null}
/42plugin 搜索科研论文相关的插件
```
AI 会自动搜索并分类展示结果。结果按类型分组，一目了然：
* 论文写作/审稿类
* 演示/展示类
* 模板/格式类
想安装哪个？直接告诉 AI 插件名称即可。
## 安装插件
```bash theme={null}
/42plugin 安装 scientific-manuscript-review
```
AI 会确认后自动安装。
## 查看已安装
```bash theme={null}
/42plugin 列出我安装的所有插件
```
## 发布插件
有了好的 Skill？发布到官网分享给大家：
```bash theme={null}
/42plugin 发布 ./my-skill 到官网
```
AI 会引导你完成发布流程。
## 智能关键词扩展
你说「writing」，AI 会自动扩展为相关关键词一起搜索。
| 你说 | AI 搜索 |
| ------------ | -------------------------- |
| writing | writing, blog, copywriting |
| research | research, paper, academic |
| notes | notes, obsidian, knowledge |
| presentation | presentation, slides, ppt |
## 安全确认机制
涉及修改的操作会先确认：
* **需要确认**：安装、卸载、发布
* **无需确认**：搜索、查看、列表
确保你不会误操作。
## 支持的操作
| 操作 | 示例 |
| -- | ------------------- |
| 搜索 | 搜索代码审查相关的插件 |
| 安装 | 安装 typo-check |
| 卸载 | 卸载 typo-check |
| 查看 | 查看 typo-check 的详细信息 |
| 列表 | 列出我安装的所有插件 |
| 发布 | 发布 ./my-skill 到官网 |
## 相关功能
使用 CLI 命令搜索插件
使用 CLI 命令安装插件
# 42plugin-agents
Source: https://docs.42plugin.com/builtin/42plugin-agents
多代理协作技能创建
用多个 AI 代理协作，帮你创建高质量的技能。
## 什么是 Agents 的 Agents？
它用多个 AI 代理协作，帮你创建高质量的技能。
和 `/42plugin-meta` 的快捷创建不同，它会：
1. **联网搜索** 10,000+ 公开插件，学习优秀设计
2. **分析你的对话历史**，提取工作流模式
3. **自动生成**技能，并持续优化直到高水准
## 如何启用
```bash theme={null}
42plugin builtin enable 42plugin-agents
```
确认后即可使用。
## 三大核心能力
### 1. 联网学习公开插件
全球开源社区编写的 Agents、Skills，全部是你的学习对象。
站在巨人的肩膀上，避免重复造轮子。
### 2. 分析对话历史
更酷的是，它能搜索你本地的对话历史记录。
你和 AI 犯过的错、走过的弯路、容易出错的点，统统可以写成新插件。
大幅降低重复劳动，避免再次犯错。
### 3. 持续优化
生成后不会停止，还会有一个 Agent 启动，帮你持续优化。
直到达到较高水准。
## 使用示例
启用后，在 Claude Code 中调用：
```bash theme={null}
/42plugin-agents "代码审查助手"
```
### 创建流程
AI 会自动执行以下流程：
| 阶段 | 内容 |
| ------- | ------------------- |
| Phase 1 | 需求分析，启动后台代理分析对话历史 |
| Phase 2 | 库探索，搜索相关插件，学习优秀设计模式 |
| Phase 3 | 技能设计，基于分析结果，设计技能结构 |
| Phase 4 | 审查优化，自动评估质量，持续改进 |
## 这就是混合智能
人类的创意 + AI 的能力，深度融合。
你提供方向，AI 帮你：
* 学习全球优秀实践
* 挖掘你的隐性知识
* 持续优化直到满意
## 相关功能
使用元插件快速创作技能
发布你创作的插件
# 42plugin-chat
Source: https://docs.42plugin.com/builtin/42plugin-chat
快捷导出当前对话
你和 AI 的每一次对话，都是一次知识创造。一行命令保存下来。
## 如何使用
在当前对话窗口输入：
```bash theme={null}
/42plugin-chat
```
对话自动导出到 `./chats` 目录。
## 三种导出格式
导出会生成三个文件，满足不同需求：
| 文件 | 内容 | 适用场景 |
| ----------- | ----------- | ------- |
| `hi.md` | 仅用户消息 | 快速回顾问题 |
| `hi+ai.md` | 用户 + AI 对话 | 分享、复盘 |
| `detail.md` | 完整详情（含工具调用） | 深度分析、学习 |
## 导出完整详情
需要包含工具调用和思考过程？
```bash theme={null}
/42plugin-chat --detail
```
完整详情文件会包含：
* AI 的每一步思考过程
* 调用了哪些工具
* 工具的输入和输出
适合深度分析 AI 是如何解决问题的。
## 使用场景
### 复盘学习
解决了一个复杂问题？导出对话，日后复盘时可以回顾 AI 的思路和方法。
### 团队分享
导出 `hi+ai.md`，分享给同事。比口头描述更准确，比截图更完整。
### 创建技能
发现对话中有可复用的工作流？导出后可以作为创建技能的素材。
### 归档备份
重要对话及时导出，避免历史记录丢失。
## 相关功能
自动保存对话记录
使用 CLI 命令批量导出
# 42plugin-eval
Source: https://docs.42plugin.com/builtin/42plugin-eval
技能评估套件——用数据衡量技能值不值得用
技能越来越多，但哪个真的有用？42eval 用断言测试 + 盲测对比，量化每个技能的实际贡献。
## 为什么需要评测技能？
一个技能可能让 AI 的输出结构更清晰，也可能只是多绕了一圈，结果和直接问 AI 差不多。更糟的情况是，技能反而限制了模型本身的能力，输出质量不升反降。
没有评测，这些都只能靠感觉。42eval 把感觉变成数据。
## 如何启用
```bash theme={null}
42plugin builtin enable 42plugin-eval
```
启用后你会获得：
* **命令行工具** `42plugin eval` — 适合批量操作和自动化
* **交互式技能** `/42plugin-eval` — 在 Claude Code 中使用，AI 引导你完成评测
## 核心方法：衡量技能的增量贡献
42eval 不问「输出好不好」，而是问「相比不用技能，输出多了什么」。
用同一道题考两遍——一遍让 AI「带着技能」答题，一遍让 AI「裸考」。然后对比两份答卷，逐条检查断言是通过还是失败。差值就是技能的真实贡献。
### 断言的四种分类
| 分类 | 检查什么 | 举例 |
| --------------------- | ------------- | ----------------- |
| **structure**（结构） | 输出有没有特定的章节、表格 | 「包含 PICOS 五个章节标题」 |
| **content**（内容） | 有没有特定的实质性内容 | 「至少分析了 3 个核心实体」 |
| **differential**（差异化） | 没有技能就做不到的事 | 「使用了技能定义的三阶段分析法」 |
| **quality**（质量） | 整体输出质量是否达标 | 「给出了可执行的下一步建议」 |
其中 **differential（差异化）** 断言是重点——它检查的是「只有用了技能才会出现的东西」。
### 技能矩阵：四种技能类型
42eval 用一个 2×2 矩阵刻画技能的价值来源：**AI 模型自身能力**和**技能编码的人类经验质量**。
| | 模型能力强 | 模型能力弱 |
| --------- | ---------------- | -------------------- |
| **人类经验高** | **mastery**（精通） | **codification**（规范） |
| **人类经验低** | **leverage**（杠杆） | **scaffolding**（脚手架） |
不同象限的技能，价值来源和评测策略不同。`42plugin eval classify` 会自动分析并推荐对应的评测策略。
### 断言健康度：评测你的评测
评测完成后，每条断言会被标记健康状态：
| 状态 | 含义 | 建议 |
| ---------------------- | ---------- | ------------ |
| **skill-differential** | 带技能通过，裸考失败 | 保留——技能的核心贡献 |
| **always-pass** | 两侧都通过 | 替换——断言没有区分度 |
| **always-fail** | 两侧都失败 | 检查——断言可能不合理 |
| **inverse** | 裸考反而通过 | 排查——技能可能帮了倒忙 |
## 两种使用方式
### 方式一：在 Claude Code 中交互式评测
适合第一次使用或快速评测一个技能。
```
/42plugin-eval
```
AI 会引导你完成完整流程：选择技能 → 自动分类 → 设计测试用例和断言 → 执行评测 → 生成报告。
### 方式二：命令行独立运行
适合批量评测或 CI 集成。
```bash theme={null}
# 1. 给技能分类
42plugin eval classify <技能路径>
# 2. 初始化评测工作区
42plugin eval init <技能路径>
# 3. 编写测试用例（在 .42eval/技能名/cases/ 目录下创建 JSON 文件）
# 4. 运行评测
42plugin eval run <技能路径> -i 1
# 5. 查看统计摘要
42plugin eval benchmark <技能路径> -i 1
# 6. 生成可视化报告
42plugin eval report <技能路径> -i 1 --open
```
## 读懂评测结果
关键指标是 **delta（增量）**——用了技能后，断言通过率比不用技能高出多少。
| delta | 评价 | 含义 |
| ------ | --- | ---------- |
| > 30% | 优秀 | 技能价值非常显著 |
| 20–30% | 良好 | 技能有明确效果 |
| 10–20% | 及格 | 有一定帮助，还能优化 |
| \< 10% | 不及格 | 技能可能需要重新设计 |
## 迭代改进
评测不是终点，而是改进的起点：
```bash theme={null}
# 修改技能后重新快照
42plugin eval init <技能路径> --force
# 用新版本号跑第二轮评测
42plugin eval run <技能路径> -i 2
# 查看两轮之间的提升
42plugin eval benchmark <技能路径> -i 2
```
benchmark 会自动计算 **version\_delta**（版本间增量），告诉你这次改进提升了多少。
## 命令速查
| 命令 | 说明 |
| ------------------------------------------ | ------------- |
| `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` 输出。
42eval 需要 42plugin CLI 0.3.9 或更高版本。运行 `42plugin upgrade` 升级到最新版。
## 相关功能
使用元插件快速创作技能
多代理协作创建高质量技能
# 42plugin-meta
Source: https://docs.42plugin.com/builtin/42plugin-meta
技能创建指南和模板
好的工作流，不该每次都重复。把它打包成技能，以后一个命令就能复用。
## 什么是技能（Skill）？
技能是一个包含指令、脚本和资源的文件夹。Claude 会动态加载它来执行特定任务。
你可以把技能理解为「AI 的新手入门指南」——只包含 Claude 不知道的专业知识。
## 如何使用
在对话窗口输入：
```bash theme={null}
/42plugin-meta
```
AI 会引导你完成整个创建流程。
元插件集成了大量实战中的内隐知识，帮你写出高手水准的技能。
## 创建流程
### Phase 1：理解使用场景
AI 会询问：
* 这个技能解决什么问题？
* 什么时候应该触发这个技能？
* 有什么现有的工作流可以参考？
### Phase 2：规划资源
决定技能需要哪些文件：
| 资源类型 | 什么时候需要 | 示例 |
| ------------- | ----------- | --------------- |
| `scripts/` | 重复使用的代码 | `validate.py` |
| `references/` | 超过 100 行的文档 | `api_docs.md` |
| `assets/` | 输出时使用的模板 | `template.pptx` |
### Phase 3：创建 SKILL.md
AI 会帮你写好 SKILL.md，包含：
* 规范的 frontmatter
* 清晰的使用说明
* 常见错误处理
### Phase 4：验证发布
```bash theme={null}
42plugin __ validate ./my-skill
```
验证通过后，一键发布到官网：
```bash theme={null}
42plugin publish ./my-skill --public
```
## 专家经验内置
这个功能来源于真实项目实战中的大量内隐知识：
* AgentSkills 协议验证
* 优秀实践自动应用
* 常见错误自动修正
帮你写出高手水准的技能。
## 创作示例
### 示例 1：检查错别字技能
```bash theme={null}
/42plugin-meta 创建一个检查代码中错别字的技能
```
### 示例 2：代码审查助手
```bash theme={null}
/42plugin-meta 创建一个代码审查助手
```
## 更强大的选择
如果你需要更强大的创作能力，可以使用 Agents 的 Agents：
多代理协作，联网学习，自动优化
## 相关功能
发布你创作的插件
# autosave
Source: https://docs.42plugin.com/builtin/autosave
自动保存对话记录
自动保存你与 Claude 的每一次对话。
## 功能说明
autosave 是内置的对话自动保存功能，默认开启。它会自动记录你与 AI 的对话历史，方便日后查阅和导出。
首次安装 42plugin CLI 时，对话自动保存功能默认开启
## 管理自动保存
```bash theme={null}
# 查看当前状态
42plugin chat autosave
# 开启自动保存
42plugin chat autosave on
# 关闭自动保存
42plugin chat autosave off
```
## 相关功能
使用 42plugin-chat 快捷导出当前对话
# 内置元能力
Source: https://docs.42plugin.com/builtin/index
用 AI 创造 AI 能力
内置元能力是活水插件的核心创新。它们的共同点是：**让你用 AI 来增强 AI 的能力**。
## 查看内置组件
```bash theme={null}
42plugin builtin
```
输出示例：
```
📦 内置组件状态
已启用 (6):
插件: 42plugin, 42plugin-agents, 42plugin-chat, 42plugin-eval, 42plugin-meta
功能: autosave
💡 使用 '42plugin builtin list' 查看详情
使用 '42plugin builtin enable <名称>' 启用组件
```
## 查看详细列表
```bash theme={null}
42plugin builtin list
```
输出示例：
```
📦 内置组件
────────────────────────────────────────────────────────────
组件 类型 状态 描述
────────────────────────────────────────────────────────────
autosave 功能 ✓ 已启用 自动保存对话记录
42plugin 插件 ✓ 已启用 插件搜索与管理增强
42plugin-agents 插件 ✓ 已启用 多代理协作技能创建
42plugin-chat 插件 ✓ 已启用 快捷导出当前对话
42plugin-eval 插件 ✓ 已启用 技能评估套件
42plugin-meta 插件 ✓ 已启用 技能创建指南和模板
────────────────────────────────────────────────────────────
```
## 启用/禁用组件
```bash theme={null}
# 启用组件
42plugin builtin enable <名称>
# 禁用组件
42plugin builtin disable <名称>
```
## 内置组件一览
| 组件 | 类型 | 命令 | 描述 |
| ------------------------------------------- | -- | ------------------ | --------- |
| [autosave](/builtin/autosave) | 功能 | - | 自动保存对话记录 |
| [42plugin](/builtin/42plugin) | 插件 | `/42plugin` | 插件搜索与管理增强 |
| [42plugin-agents](/builtin/42plugin-agents) | 插件 | `/42plugin-agents` | 多代理协作技能创建 |
| [42plugin-chat](/builtin/42plugin-chat) | 插件 | `/42plugin-chat` | 快捷导出当前对话 |
| [42plugin-eval](/builtin/42plugin-eval) | 插件 | `/42plugin-eval` | 技能评估套件 |
| [42plugin-meta](/builtin/42plugin-meta) | 插件 | `/42plugin-meta` | 技能创建指南和模板 |
## 为什么叫「元能力」？
认知科学中有大量关于「元」的研究：元语言、元认知、元记忆、元理性……
「元」的核心是**对自身的反思和操作**。
活水插件的元能力也是如此：用 AI 来创造 AI 的能力，用插件来创造插件。
这是**混合智能**的体现——人类的创意与 AI 的能力深度融合。
# 42skill 创作工具
Source: https://docs.42plugin.com/create/42skill
在网页上用 AI 辅助创作插件
42skill 是活水插件的网页创作工具，让你无需安装任何软件，直接在浏览器中创作插件。
## 什么是 Skill
Skill（技能）遵循 Anthropic 的开放 Agent Skills 规范，本质是一个包含 SKILL.md 的文件夹，可选附带脚本、文档和模板。Skill 跨平台兼容 Claude Code、Codex、Gemini 等支持该规范的工具。
## 创作流程
### 步骤 1：准备素材
42skill 支持三种素材输入方式：
* **上传文件**：PDF、TXT、Markdown 文件
* **输入 URL**：自动抓取网页内容
* **粘贴文本**：直接粘贴文本素材
**举例**：你可以上传一篇 Paul Graham 的创业文章，让 42skill 从中提炼出一个创业想法评估插件。
### 步骤 2：描述意图
告诉 42skill 你希望这个插件做什么。如果不确定怎么描述，可以点击 AI 建议按钮自动生成意图描述。
### 步骤 3：生成与预览
AI 会经历四个阶段：
1. 分析素材
2. 规划结构
3. 撰写内容
4. 质量校验
生成完成后，你可以查看质量评分（结构性、可操作性、覆盖度），不满意可以点击"优化"继续迭代。
### 步骤 4：试炼
在发布前，通过对话式试炼测试插件效果：
* 系统提供 3 个引导问题（入门、实战、深度）
* 每轮对话显示 token 消耗
* 试炼历史自动保存在浏览器中
### 步骤 5：发布
一键发布到插件市场。发布后可以用以下命令安装：
```bash theme={null}
42plugin install yourname/main/skill-name
```
在 Claude Code 中通过 `/skill-name` 调用。
## 使用配额
| 功能 | 免费版 | Pro 版 |
| ----- | ----- | --------------------- |
| 生成次数 | 1 次/天 | 42 次/天 |
| 试炼次数 | 3 轮/天 | 42 轮/天 |
| AI 积分 | - | 100 点（约 100 万 tokens） |
AI 积分换算：1 积分 = 1 万 tokens。Pro 用户赠送 100 积分（约 100 万 tokens）。
## 与 /42plugin-meta 的区别
| 特点 | 42skill（网页） | /42plugin-meta（CLI） |
| ---- | ------------- | ------------------- |
| 使用方式 | 浏览器中操作 | Claude Code 对话中使用 |
| 素材输入 | 上传文件、URL、粘贴文本 | 对话式交互 |
| 适合场景 | 从文章/文档快速生成插件 | 从零开始深度定制 |
| 试炼功能 | 内置对话式试炼 | 直接在 Claude Code 中测试 |
| 无需安装 | 是 | 需要 Claude Code |
42skill 适合从现有素材快速生成插件，/42plugin-meta 适合从零开始交互式创建。两者可以配合使用。
## 下一步
使用 /42plugin-meta 深度定制
发布并分享你的作品
# 用元插件加速创作
Source: https://docs.42plugin.com/create/meta-skills
使用内置元能力快速创作高质量插件
元插件是活水插件的核心创新，让你秒速创作专业级插件。
## 内置元能力
活水插件内置了多个元能力，用 AI 来增强 AI 的能力：
| 能力 | 命令 | 描述 |
| ------------------------------------------- | ------------------ | --------- |
| [42plugin-meta](/builtin/42plugin-meta) | `/42plugin-meta` | 技能创建指南和模板 |
| [42plugin-agents](/builtin/42plugin-agents) | `/42plugin-agents` | 多代理协作技能创建 |
查看所有内置元能力
## 快速创建技能
在对话窗口输入：
```bash theme={null}
/42plugin-meta
```
AI 会引导你完成整个创建流程。
技能创建指南和模板
## 高级：多代理协作
如果你需要更强大的创作能力：
```bash theme={null}
42plugin builtin enable 42plugin-agents
```
它会联网学习、分析对话历史、持续优化。
多代理协作技能创建
## 下一步
发布你创作的插件
# 发布你的插件
Source: https://docs.42plugin.com/create/publish-share
使用 pub 命令秒速发布你的插件
创作完插件后，使用 `42plugin pub` 命令发布。
## 发布命令
在插件目录下执行：
```bash theme={null}
42plugin pub
```
完整命令：`42plugin publish`
## 发布流程
1. 自动检测插件类型
2. 验证插件格式
3. **选择许可证**（必须）
4. 自动生成 LICENSE 文件
5. 上传到服务器
6. 生成插件页面
秒速发布！只需输入 `pub` 三个字母即可完成发布。
## 发布选项
### 公开发布
```bash theme={null}
42plugin pub --public
```
默认发布的插件仅自己可见，使用 `--public` 参数公开发布。
### 私有发布（Pro）
```bash theme={null}
42plugin pub --private
```
Pro 用户可以发布私有插件，仅自己和组织成员可见。
了解更多 Pro 功能，请查看 [Pro 与组织版](/pro)。
### 指定许可证
```bash theme={null}
42plugin pub --license MIT
```
发布时**必须选择许可证**。如果未通过参数指定，CLI 会交互式提示选择。
CLI 根据插件可见性智能推荐默认许可证：
| 可见性 | 默认许可证 | 说明 |
| ---------- | ----------------- | ----------- |
| 公开（public） | MIT | 宽松开源，对使用者友好 |
| 私有（self） | 42plugin-personal | 仅作者自用 |
| 团队（team） | 42plugin-team | 仅限团队内使用 |
## 支持的许可证
活水插件采用 [SPDX](https://spdx.org/) 标准，支持以下许可证：
**SPDX 宽松协议（公开插件推荐）：**
| 许可证 | 说明 |
| ------------ | --------------------- |
| MIT | 宽松，允许任何用途，保留版权声明即可 |
| Apache-2.0 | 类似 MIT，额外提供专利授权保护 |
| ISC | 类似 MIT 的简化版 |
| BSD-2-Clause | 简洁宽松，保留版权和免责声明 |
| BSD-3-Clause | 比 BSD-2 多一条：不得用作者名背书 |
| CC0-1.0 | 放弃所有权利，进入公共领域 |
| Unlicense | 公共领域贡献，无任何限制 |
| MPL-2.0 | 文件级 copyleft，修改的文件需开源 |
**平台自定义协议（Pro 用户）：**
| 许可证 | 说明 |
| ----------------- | --------------- |
| 42plugin-personal | 仅作者自用，他人不可使用或分发 |
| 42plugin-team | 仅限作者团队内使用 |
CLI 会自动生成标准的 LICENSE 文件，无需手动编写。
完整许可证说明：[42plugin.com/licenses](https://42plugin.com/licenses)
### 预演模式
```bash theme={null}
42plugin pub --dry-run
```
模拟发布流程但不实际上传，用于发布前检查。
### 指定插件名称
```bash theme={null}
42plugin pub --name my-plugin
```
### 指定插件类型
```bash theme={null}
42plugin pub --type skill
```
支持的类型：skill、command、hook、agent
### 指定套包
```bash theme={null}
42plugin pub --kit my-kit
```
发布到指定套包下，而非默认的 main 套包。
### 指定路径
```bash theme={null}
42plugin pub ./my-plugin
```
### 强制发布
```bash theme={null}
42plugin pub --force
```
## 发布选项一览
| 选项 | 说明 |
| --------------------- | ----------------------- |
| `--public` | 公开发布 |
| `--private` | 私有发布（Pro） |
| `--license ` | 指定许可证（如 MIT、Apache-2.0） |
| `--dry-run` | 预演模式，不实际上传 |
| `--name ` | 指定插件名称 |
| `--type ` | 指定插件类型 |
| `--kit ` | 指定发布到的套包 |
| `--force` | 强制发布 |
| `--no-sync-version` | 不同步版本号到 frontmatter |
## 下一步
发布前自动检查插件质量
创建和管理插件套包
# 创作你的第一个插件
Source: https://docs.42plugin.com/create/your-first-plugin
从零开始创作一个 AI 插件
活水插件让创作插件变得简单而高效。
## 什么是插件？
插件是增强 AI 能力的扩展，主要类型：
* **Skill（技能）** - 为 AI 提供特定领域能力
* **Command（命令）** - 定义可执行的斜杠命令
* **Hook（钩子）** - 响应事件自动触发
* **Agent（代理）** - 定义 AI 角色和行为
## 创作方式
### 方式一：使用 /42plugin-meta（推荐）
在 Claude Code 对话中直接输入：
```
/42plugin-meta
```
AI 会引导你完成整个创建流程，包括需求分析、结构设计、内容生成和质量检查。
这是最简单的方式，无需任何安装步骤，开箱即用。
### 方式二：使用 42skill 网页工具
访问 [42skill 创作工具](/create/42skill)，在网页上通过可视化界面创作插件：
1. 描述你的插件功能
2. AI 自动生成插件结构和内容
3. 在线预览和编辑
4. 一键下载或发布
### 方式三：手动创作
创建插件目录和文件：
```bash theme={null}
mkdir -p .claude/skills/my-plugin
```
在目录中创建 `SKILL.md` 文件，编写插件内容：
```markdown theme={null}
---
name: my-plugin
description: 插件描述
version: 1.0.0
---
# 你的插件名称
这里编写插件的 Prompt 内容...
```
手动创作适合有经验的创作者，可以完全控制插件的每个细节。初次创作推荐使用方式一或方式二。
## 下一步
了解内置元能力
发布并分享你的插件
# 浏览插件市场
Source: https://docs.42plugin.com/discover/web-browse
注册、登录、修改用户名，开始探索插件世界
访问 [42plugin.com](https://42plugin.com) 开始你的插件之旅。
## 注册与登录
访问 [42plugin.com/auth/login](https://42plugin.com/auth/login)
支持多种登录方式：
* 手机号
* 微信
* GitHub
**举例**：如果你是第一次使用，推荐用微信扫码登录，最快捷。如果你是开发者，可以用 GitHub 账号登录，方便后续发布插件。
## 修改用户名
首次登录后，建议设置一个个性化的用户名：
1. 点击右上角头像
2. 进入个人设置
3. 修改用户名
4. 保存
用户名将用于你发布的插件路径，如 `yourname/main/plugin`（默认kit为main）
**举例**：比如你叫张三，可以设置用户名为 `zhangsan`，以后你发布的插件路径就是 `zhangsan/main/my-plugin`。
## 浏览插件
### 首页推荐
首页展示：
* 热门插件
* 最新上传
* 精选套包
* 分类导航
**举例**：打开首页，你会看到"心理学文献检索"、"保存对话记录"等热门插件。如果你是产品经理，可以关注"需求分析"、"用户研究"等分类。
### Explore 发现页
访问 [42plugin.com/explore](https://42plugin.com/explore)，按 6 大分类发现插件：
| 分类 | 说明 |
| ----- | --------------------------------------------- |
| AI 先锋 | Anthropic、OpenAI、DeepSeek 等 30+ AI 公司的官方及社区插件 |
| 热门开源 | LangChain、Docker、Supabase、Vue.js 等热门开源项目的插件 |
| 社群之星 | 来自社区活跃创作者的精选作品 |
| 编程语言 | Python、TypeScript、Go、Rust 等，按语言快速找到开发工具 |
| 学术前沿 | 覆盖生命科学、数学物理、文献管理等学术方向 |
| 效率神器 | 写作创作、办公文档、数据分析、项目管理等实用工具 |
**举例**：如果你是 Python 开发者，点击"编程语言"分类，就能快速找到 Python 相关的代码生成、调试、测试插件。
### 插件详情
点击插件卡片查看：
* 插件描述和使用说明
* 活水指数（42score）评分
* 下载统计
* 版本历史
* 作者信息
**举例**：点击"心理学文献检索"插件，你会看到它的活水指数是 4.7 分，支持 Semantic Scholar、OpenAlex 等多个数据库。
## 浏览套包
套包是一组相关插件的集合，可以一键安装多个插件。
浏览套包：
* 科研学术套包
* 开发工具套包
* 内容创作套包
* 更多分类...
**举例**：如果你是研究生，可以安装"科研学术套包"，一次性获得文献检索、数据分析、论文写作等多个插件。
## 下一步
使用搜索功能快速找到插件
收藏插件，稍后一键安装
# 收藏你喜欢的
Source: https://docs.42plugin.com/discover/web-favorites
收藏插件，一键安装所有收藏
收藏功能让你可以标记喜欢的插件，稍后一键安装。
## 如何收藏
在插件卡片上点击 ❤️ 图标即可收藏。
收藏后：
* 图标变为红色
* 自动添加到收藏列表
**举例**：浏览时看到"心理学文献检索"插件很有用，点击 ❤️ 收藏。继续浏览，又收藏了"保存对话记录"、"数据分析"等 5 个插件。
## 查看收藏
点击右上角头像 → 我的收藏，查看所有收藏的插件和套包。
## 一键安装收藏
这是活水插件的特色功能！
使用 CLI 命令：
```bash theme={null}
42plugin install like
```
会自动安装你收藏的所有插件，跨套包安装，只安装你真正需要的。
这个功能特别适合：
* 在新电脑上快速恢复工作环境
* 跨项目同步常用插件
* 精选自己的插件工具箱
## 取消收藏
再次点击 ❤️ 图标即可取消收藏。
## 下一步
一键安装全套工具
# 搜索你需要的
Source: https://docs.42plugin.com/discover/web-search
使用搜索功能快速找到你需要的插件
活水插件提供强大的搜索功能，帮助你快速找到需要的插件。
## 搜索框
在首页顶部的搜索框输入关键词，支持：
* 插件名称
* 功能描述
* 作者名称
* 标签关键词
**举例**：如果你想找文献检索相关的插件，可以搜索"文献"、"论文"、"检索"等关键词。如果你知道作者是"42ailab"，也可以直接搜索作者名。
## 搜索结果
搜索结果分为两类：
### 插件结果
显示匹配的插件，包含：
* 插件名称和图标
* 简短描述
* 活水指数评分
* 下载次数
**举例**：搜索"心理学"，会显示"心理学文献检索"插件，活水指数 4.7 分。点击即可查看详情。
### 套包结果
显示匹配的套包，包含：
* 套包名称
* 包含的插件数量
* 套包描述
* 下载次数
## 筛选功能
使用筛选器精确查找：
* 按类型筛选：Skill、Command、Hook、Agent
* 按分类筛选：科研、开发、创作等
* 按评分筛选：高分优先
## 下一步
收藏插件，稍后一键安装
# 常见问题
Source: https://docs.42plugin.com/faq
使用活水插件的常见问题解答
## 安装相关
### 如何安装 42plugin CLI？
复制命令到终端执行：
```bash theme={null}
# macOS / Linux
curl -fsSL https://get.42plugin.com/cli | bash
# Windows (PowerShell)
irm https://get.42plugin.com/cli.ps1 | iex
```
### 安装失败怎么办？
1. 检查网络连接
2. 确认已登录：`42plugin auth --status`
3. 尝试重新安装：`42plugin install --force`
### 如何更新 CLI？
```bash theme={null}
42plugin upgrade
```
### 如何批量更新已安装的插件？
```bash theme={null}
# 检查哪些插件有可用更新
42plugin update --check
# 一键更新所有插件
42plugin update
```
## 认证相关
### 如何切换账号？
```bash theme={null}
42plugin auth --logout
42plugin auth
```
### 验证码过期怎么办？
验证码有效期为 15 分钟。如果过期，请重新执行 `42plugin auth` 获取新的验证码。
### 登录失败怎么办？
1. 检查网络连接
2. 确认验证码输入正确
3. 尝试重新登录
4. 访问 [42plugin.com](https://42plugin.com) 检查账号状态
## 搜索相关
### AI 智能搜索是什么？
AI 智能搜索使用自然语言理解技术，让你用日常语言描述需求，AI 会推荐最匹配的插件。
```bash theme={null}
42plugin search "我想做心理学文献综述" --ai
```
免费用户每天 42 次 AI 搜索，[Pro 用户](/pro)每天 420 次。
### 普通搜索和 AI 搜索有什么区别？
* **普通搜索**：基于关键词匹配，适合知道具体插件名或关键词的场景
* **AI 搜索**：基于语义理解，适合用自然语言描述需求的场景
## 插件相关
### 什么是活水指数？
活水指数（42score）是用于评估插件文档质量和完整性的综合评分系统，基于插件质量进行评估。评分维度包括：
* 描述清晰：插件描述的长度、清晰度、使用场景说明；
* 内容丰富：正文长度、结构化程度、标题层级、列表、表格、链接；
* 示例充实：代码块数量、语言标注、示例章节、用法说明、输出结果；
* 规范程度：frontmatter 完整性，以及是否符合AgentSkill等规范；
* 可信来源：来源、License 类型等。
帮助用户快速识别文档完善、示例丰富的优质插件，也为创作者提供插件文档优化方向。分数越高代表插件质量越好。
### 全局安装和项目安装有什么区别？
* **全局安装**：存放在 `~/.claude/`，对所有项目生效
* **项目安装**：存放在 `./.claude/`，仅当前项目生效
### 如何卸载插件？
```bash theme={null}
42plugin uninstall
```
详见[卸载插件](/install/cli-uninstall)。
## 技能评估相关
### 42eval 是什么？
42eval 是 42plugin CLI 内置的技能评估套件，用数据量化每个技能的实际贡献。它通过断言测试 + 盲测对比，回答「这个技能到底值不值得用」。
详见[技能评估套件](/builtin/42plugin-eval)。
### 如何开启 42eval？
```bash theme={null}
42plugin builtin enable 42plugin-eval
```
需要 CLI 版本 0.3.9 或更高。
### delta（增量）怎么看？
delta 是用了技能后，断言通过率比不用技能高出多少。> 30% 为优秀，20–30% 为良好，10–20% 为及格，\< 10% 说明技能可能需要重新设计。
### 不会写断言怎么办？
在 Claude Code 中输入 `/42plugin-eval`，AI 会帮你自动生成断言。你只需要告诉 AI 想测试什么场景，它会输出 5–6 条断言供你挑选和修改。
## Pro 相关
### 免费版和 Pro 版有什么区别？
| 功能 | 免费版 | Pro 版（199 元/年） |
| ---------- | ------ | -------------- |
| AI 语义搜索 | 42 次/天 | 420 次/天 |
| 智能推荐 | 5 次/天 | 420 次/天 |
| 插件安装 | 42 次/天 | 无限 |
| 插件发布 | 公开 | 公开 + 私有 |
| 42skill 生成 | 1 次/天 | 42 次/天 |
详见 [Pro 与组织版](/pro)。
### 如何查看我的使用配额？
```bash theme={null}
42plugin status
```
### 组织版适合什么场景？
组织版适合团队协作场景，支持成员管理、无限私有插件、共享套包等功能。适合需要在团队内统一管理和分享插件的企业和组织。
# 登录你的账号
Source: https://docs.42plugin.com/install/cli-auth
使用设备授权码登录 42plugin
使用 `42plugin auth` 命令登录你的账号。
## 登录步骤
```bash theme={null}
42plugin auth
```
执行后会：
1. 自动打开浏览器
2. 显示设备验证码（如：`ABCD-1234`）
3. 在浏览器中输入验证码
4. 完成登录
如果浏览器未自动打开，请手动复制显示的链接并在浏览器中打开
## 查看登录状态
```bash theme={null}
42plugin auth --status
```
## 登出
```bash theme={null}
42plugin auth --logout
```
## 切换账号
```bash theme={null}
42plugin auth --logout
42plugin auth
```
## 下一步
开始安装你的第一个插件
# 管理对话记录
Source: https://docs.42plugin.com/install/cli-chat
使用 CLI 命令管理和导出对话记录
使用 `42plugin chat` 命令管理你与 Claude 的对话记录。
推荐使用快捷方式 `/42plugin-chat` 导出当前对话，详见 [42plugin-chat](/builtin/42plugin-chat)
## 查看对话列表
```bash theme={null}
42plugin chat list
```
列出所有已保存的对话记录。
## 查看最近对话
```bash theme={null}
42plugin chat recent
```
快速查看最近的对话记录，默认显示最近 10 条。
## 搜索对话
```bash theme={null}
42plugin chat search "关键词"
```
在对话记录中搜索包含关键词的内容。
## 导入对话
```bash theme={null}
42plugin chat import
```
从文件导入对话记录。支持导入 JSON 格式的 Claude Code 对话文件。
## 管理自动保存
```bash theme={null}
# 查看当前状态
42plugin chat autosave
# 开启自动保存
42plugin chat autosave on
# 关闭自动保存
42plugin chat autosave off
```
如果你之前使用的是旧版自动保存（基于 hook），升级到新版后请先运行 `42plugin chat autosave` 查看状态，确认已切换到内置自动保存。旧版 hook 配置可安全删除。
## 导出对话记录
### 交互式导出
运行以下命令进入交互式界面：
```bash theme={null}
42plugin chat export
```
按提示选择：
1. **导出范围**：今天 / 本周 / 本月 / 全部 / 自定义日期
2. **项目筛选**：全部项目或指定项目
3. **输出目录**：默认 `./chats`
### 命令行模式
适合脚本调用或快速导出：
```bash theme={null}
# 导出今天的对话
42plugin chat export -d today
# 导出本周的对话到指定目录
42plugin chat export -d week -o ~/my-chats
# 导出指定项目的对话
42plugin chat export -p "my-project" --all
# 导出指定日期范围
42plugin chat export --from 2025-12-01 --to 2025-12-31 --all
```
## 导出文件结构
导出完成后，你会得到两个文件夹：
```
./chats/
├── hi/ # 仅用户输入
│ └── 2025-12-30-a1b2c3d4.md
└── hi+ai/ # 完整对话（含 AI 回复）
└── 2025-12-30-a1b2c3d4.md
```
### 文件示例
`hi/` 目录下的文件（仅用户输入）：
```markdown theme={null}
# 用户输入记录 2025-12-30
> Session ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
> 项目: my-awesome-project
> 创建时间: 2025-12-30 10:15:30
---
## User [10:15:30]
帮我写一个快速排序算法
---
## User [10:16:45]
加上注释说明
---
```
`hi+ai/` 目录下的文件包含完整对话，包括 Claude 的回复。
## 子命令一览
| 子命令 | 说明 |
| --------------- | ------ |
| `chat list` | 查看对话列表 |
| `chat recent` | 查看最近对话 |
| `chat search` | 搜索对话内容 |
| `chat import` | 导入对话记录 |
| `chat export` | 导出对话记录 |
| `chat autosave` | 管理自动保存 |
## 相关功能
使用 /42plugin-chat 快捷导出当前对话
自动保存对话记录功能
# 发布前检查
Source: https://docs.42plugin.com/install/cli-check
发布前自动检查插件质量
使用 `42plugin check` 命令在发布前检查插件质量和规范性。
## 基础用法
```bash theme={null}
42plugin check
```
在插件目录下运行，自动检查当前插件。
## 指定路径
```bash theme={null}
42plugin check ./my-plugin
```
## 检查项目
命令会检查以下内容：
| 检查项 | 说明 |
| ----------- | --------------------------------- |
| 文件结构 | SKILL.md 等必要文件是否存在 |
| Frontmatter | 元数据是否完整（name、description、version） |
| 内容质量 | 描述长度、结构化程度、示例数量 |
| 规范合规 | 是否符合 AgentSkill 等规范要求 |
| 安全检查 | 是否包含敏感信息或危险操作 |
## 示例
```bash theme={null}
$ 42plugin check
检查 ./my-plugin...
✓ 文件结构完整
✓ Frontmatter 格式正确
⚠ 建议添加更多使用示例
✓ 无安全风险
活水指数预估: 4.2 / 5.0
建议：添加 2-3 个代码示例可提升评分
```
建议在每次发布前运行 `42plugin check`，确保插件质量。也可以使用 `42plugin pub --dry-run` 模拟完整发布流程。
## 下一步
检查通过后，发布你的插件
# Git 直装
Source: https://docs.42plugin.com/install/cli-git-install
从任意 Git 仓库直接安装 AI 插件
除了从活水插件市场安装，你还可以从任意 Git 仓库直接安装插件。
## 快速开始
```bash theme={null}
# 从 GitHub 安装
42plugin install github.com/anthropics/skills
# 从 CNB 安装
42plugin install cnb.cool/cnb/skills/cnb-skill
# 只安装仓库中的某个 Skill
42plugin install github.com/anthropics/skills/pptx
```
## 支持的平台
只要能 `git clone`，就能 `42plugin install`：
| 平台 | 格式 |
| --------- | ---------------------------- |
| GitHub | `github.com/owner/repo` |
| CNB | `cnb.cool/org/group/project` |
| GitLab | `gitlab.com/group/repo` |
| Gitea | `gitea.com/owner/repo` |
| 任意 Git 仓库 | 支持 HTTPS 和 SSH 协议 |
## 支持的 URL 格式
CLI 对输入格式做了充分兼容：
| 格式 | 示例 |
| ----------- | ---------------------------------------------------- |
| 快捷格式（推荐） | `github.com/owner/repo` |
| 完整 URL | `https://github.com/owner/repo` |
| 指定单个 Skill | `github.com/owner/repo/skill-name` |
| 带协议指定 Skill | `https://github.com/owner/repo/skill-name` |
| 指定分支和路径 | `https://github.com/owner/repo/tree/main/skills/xxx` |
| GitLab 格式 | `https://gitlab.com/group/repo/-/tree/main/skills` |
| CNB 三级路径 | `cnb.cool/org/group/project` |
| SSH 协议 | `git@github.com:owner/repo` |
你可以直接复制粘贴 Git 仓库的网址，CLI 会自动识别格式。省略 `https://` 也没问题，CLI 会自动补全。
## 批量安装与单独安装
**批量安装**——指向仓库地址，CLI 自动扫描所有可安装的插件，你选择要装哪些：
```bash theme={null}
42plugin install https://github.com/anthropics/skills
42plugin install https://github.com/microsoft/skills
```
**单独安装**——在仓库地址后加上 Skill 名称，精确安装：
```bash theme={null}
42plugin install github.com/anthropics/skills/pptx
```
## 更新 Git 安装的插件
Git 安装的插件支持自动更新检查：
```bash theme={null}
42plugin update
```
CLI 会通过 `git ls-remote` 比对远程仓库的最新版本，发现更新后自动拉取。
## 安全检查
从 Git 仓库直接安装的插件未经市场审核，CLI 内置了安全扫描：
* 检测可疑的二进制文件
* 扫描敏感文件（如 `.env`、凭证文件）
* 识别危险代码模式（如 `eval`、`exec`）
发现风险时，CLI 会显示黄色警告并征求确认。请仔细查看详情后决定是否继续安装。
## 配额与权限
Git 直装需要登录。如果尚未登录，请先运行：
```bash theme={null}
42plugin auth
```
| 能力 | 免费版 | Pro 版 |
| ------ | ------ | ------- |
| 公开仓库安装 | 42 次/天 | 420 次/天 |
| 私有仓库安装 | — | 420 次/天 |
* **按仓库计数**：一个仓库安装多个插件只算 1 次配额
* **公开仓库**人人可装，**私有仓库** Pro 专属
了解更多 Pro 功能，请查看 [Pro 与组织版](/pro)。
## 安装选项
| 选项 | 说明 |
| ------------ | ------------ |
| `--global` | 全局安装，对所有项目生效 |
| `--force` | 强制重新克隆仓库 |
| `--no-cache` | 跳过本地缓存 |
| `--copy` | 复制文件而非符号链接 |
## 下一步
从活水插件市场安装插件
检查并更新已安装的插件
# 查看插件详情
Source: https://docs.42plugin.com/install/cli-info
在命令行中查看插件的详细信息
使用 `42plugin info` 命令查看插件的详细信息。
## 基础用法
```bash theme={null}
42plugin info 42ailab/sci/psych-review
```
## 输出信息
命令会显示插件的完整信息：
* **名称和描述**
* **版本号**
* **作者信息**
* **活水指数（42score）**
* **下载次数**
* **插件类型**（skill、command、hook、agent）
* **所属套包**
* **依赖关系**
* **最近更新时间**
## 示例
```bash theme={null}
$ 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 输出
```bash theme={null}
42plugin info 42ailab/sci/psych-review --json
```
以 JSON 格式输出，方便脚本处理。
## 下一步
安装你感兴趣的插件
# 安装插件
Source: https://docs.42plugin.com/install/cli-install
使用 CLI 快速安装插件和套包
使用 `42plugin install` 命令安装插件。
## 安装单个插件
```bash theme={null}
42plugin install 42ailab/sci/psych-review
```
## 交互式安装
不传插件名时，自动进入交互式搜索模式：
```bash theme={null}
42plugin install
```
输入关键词搜索，用空格选择多个插件，回车确认安装。
## 安装套包
```bash theme={null}
42plugin install 42ailab/kit/sci
```
套包会安装多个相关插件。
## 一键安装收藏
```bash theme={null}
42plugin install like
```
这会安装你在网页上收藏的所有插件。
活水插件采用高并发下载和智能缓存，几乎所有插件都是秒下体验！
## 全局安装
```bash theme={null}
42plugin install --global
```
全局安装的插件对所有项目生效，存放在 `~/.claude/`
## 强制重新安装
```bash theme={null}
42plugin install --force
```
## 安装选项
| 选项 | 说明 |
| ------------ | ------------- |
| `--global` | 全局安装，对所有项目生效 |
| `--force` | 强制重新安装 |
| `--no-cache` | 跳过缓存，从服务器重新下载 |
| `--optional` | 仅安装套包中的可选插件 |
| `--copy` | 复制到当前目录而非符号链接 |
## 从 Git 仓库安装
除了从市场安装，你还可以从任意 Git 仓库直接安装：
```bash theme={null}
42plugin install github.com/anthropics/skills
```
支持 GitHub、GitLab、CNB 等任意 Git 平台。
了解 Git 直装的完整用法、支持格式和配额规则
## 下一步
查看已安装的插件列表
# 管理你的套包
Source: https://docs.42plugin.com/install/cli-kit
创建和管理插件套包
使用 `42plugin kit` 命令管理你的插件套包。套包是一组相关插件的集合，方便分享和批量安装。
## 查看你的套包
```bash theme={null}
42plugin kit list
```
列出你创建的所有套包。
## 创建套包
```bash theme={null}
42plugin kit create my-toolkit
```
创建一个新的空套包。
## 添加插件到套包
```bash theme={null}
42plugin kit add my-toolkit 42ailab/sci/psych-review
```
## 从套包移除插件
```bash theme={null}
42plugin kit remove my-toolkit 42ailab/sci/psych-review
```
## 查看套包内容
```bash theme={null}
42plugin kit info my-toolkit
```
查看套包中包含的所有插件。
## 示例
```bash theme={null}
# 创建一个开发工具套包
$ 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`
## 下一步
发布插件到套包
检查插件质量
# 查看已安装
Source: https://docs.42plugin.com/install/cli-list
查看当前项目或全局已安装的插件
使用 `42plugin list` 命令查看已安装的插件。
## 查看当前项目
```bash theme={null}
42plugin list
```
别名：`42plugin ls`
## 查看全局插件
```bash theme={null}
42plugin list --global
```
## 查看所有项目
```bash theme={null}
42plugin list --all
```
## 筛选特定类型
```bash theme={null}
42plugin list --type skill
```
支持的类型：skill、command、hook、agent
## JSON 输出
```bash theme={null}
42plugin list --json
```
以 JSON 格式输出，方便脚本处理和自动化集成。
## 下一步
更新已安装的插件到最新版本
卸载不再需要的插件
# 命令行搜索
Source: https://docs.42plugin.com/install/cli-search
在命令行中快速搜索插件
使用 `42plugin search` 命令在命令行中搜索插件。
## 基础搜索
```bash theme={null}
42plugin search "关键词"
```
## AI 智能搜索
使用 `-A` 或 `--ai` 启用 AI 智能搜索，用自然语言描述你的需求：
```bash theme={null}
42plugin search "我想做心理学文献综述" --ai
```
AI 会理解你的意图，推荐最匹配的插件。
免费用户每天 42 次 AI 搜索，Pro 用户每天 420 次（且可搜索私有插件）。
## 搜索特定类型
```bash theme={null}
42plugin search "文献综述" --type skill
```
## 只搜索套包
```bash theme={null}
42plugin search "科研" --kit
```
## 搜索特定插件
使用 `-p` 或 `--plugin` 在已安装的插件中搜索：
```bash theme={null}
42plugin search "review" --plugin
```
## 搜索选项
| 选项 | 说明 |
| --------------- | ------------------------------- |
| `-A, --ai` | 启用 AI 智能搜索 |
| `--type ` | 按类型筛选（skill、command、hook、agent） |
| `--kit` | 只搜索套包 |
| `-p, --plugin` | 在已安装插件中搜索 |
| `--limit ` | 限制返回结果数量 |
| `--all` | 显示所有结果（不分页） |
| `--json` | 以 JSON 格式输出结果 |
## 下一步
让 AI 为你推荐插件
查看插件的详细信息
# 账户与配额
Source: https://docs.42plugin.com/install/cli-status
查看账户状态和使用配额
使用 `42plugin status` 命令查看你的账户信息和使用配额。
## 基础用法
```bash theme={null}
42plugin status
```
## 输出信息
```bash theme={null}
$ 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 与组织版](/pro)。
## 下一步
解锁更多高级功能
登录或切换账号
# 智能推荐
Source: https://docs.42plugin.com/install/cli-suggest
让 AI 根据你的项目智能推荐插件
使用 `42plugin suggest` 命令，AI 会分析你当前的项目上下文，从 2.3 万+ 插件中推荐最适合的。
## 基础用法
```bash theme={null}
42plugin suggest
```
AI 通过五层信号检测分析你的项目：
1. **文件类型** — .pptx、.pdf、.ipynb 等推断使用场景
2. **角色关键词** — 扫描 CLAUDE.md、README.md 中的角色描述
3. **Node.js 依赖** — 读取 package.json
4. **Python 依赖** — 读取 requirements.txt、pyproject.toml
5. **语言特征** — go.mod、Cargo.toml、pubspec.yaml 等
## 按角色推荐
跳过项目扫描，直接描述你的角色或场景：
```bash theme={null}
42plugin suggest --for "我是产品经理，做 B 端 SaaS"
42plugin suggest --for "写报告 PPT"
42plugin suggest --for "数据分析"
```
不只是开发者！产品经理、设计师、运营、HR 等角色都能获得有针对性的推荐。
## 示例
```bash theme={null}
$ 42plugin suggest
🔍 分析项目上下文...
推荐插件：
1. 42ailab/dev/code-review - 代码审查助手
2. 42ailab/dev/test-gen - 测试用例生成
3. 42ailab/dev/doc-gen - 文档生成工具
输入编号安装，或按 Enter 跳过
```
## 使用配额
| 套餐 | 每日次数 |
| ----- | ----- |
| 免费版 | 5 次 |
| Pro 版 | 420 次 |
## 下一步
手动搜索你想要的插件
安装推荐的插件
# 卸载插件
Source: https://docs.42plugin.com/install/cli-uninstall
卸载不再需要的插件
使用 `42plugin uninstall` 命令卸载已安装的插件。
## 卸载插件
```bash theme={null}
42plugin uninstall 42ailab/sci/psych-review
```
## 卸载全局插件
```bash theme={null}
42plugin uninstall 42ailab/sci/psych-review --global
```
## 示例
```bash theme={null}
$ 42plugin uninstall 42ailab/sci/psych-review
✓ 已卸载 42ailab/sci/psych-review
```
## 卸载选项
| 选项 | 说明 |
| ---------- | --------- |
| `--global` | 卸载全局安装的插件 |
卸载插件不会删除你在使用该插件时产生的数据或对话记录。
## 下一步
发现更多有用的插件
查看剩余的已安装插件
# 更新插件
Source: https://docs.42plugin.com/install/cli-update
更新已安装的插件到最新版本
使用 `42plugin update` 命令更新已安装的插件。支持并行版本检查，快速完成更新。
## 更新当前项目插件
```bash theme={null}
42plugin update
```
## 更新全局插件
```bash theme={null}
42plugin update -g
```
## 更新所有项目的插件
```bash theme={null}
42plugin update -a
```
## 更新指定插件
```bash theme={null}
42plugin update 42ailab/sci/psych-review
```
## 检查可用更新
```bash theme={null}
42plugin update --check
```
仅检查哪些插件有可用更新，不实际更新。
## 自动确认
```bash theme={null}
42plugin update -a -y
```
跳过确认提示，适合脚本和自动化场景。
## 示例
```bash theme={null}
$ 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 以更新所有插件
```
```bash theme={null}
$ 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` 保持插件最新，获得最佳体验和安全修复。
## 下一步
查看当前安装的插件
卸载不再需要的插件
# 一键安装脚本
Source: https://docs.42plugin.com/install/one-click
一条命令安装 Claude Code、42plugin 等全套工具
还在为配置开发环境头疼？一条命令，1-3 分钟，全套工具自动装好。
## 2.0 版亮点
CDN 全球分发网络，国内外用户极速下载
零依赖安装，纯二进制分发，无需 Node.js / Python
官方构建流水线，SHA-256 完整性校验
新手友好交互界面，一键安装、升级、卸载
## 安装内容
脚本会自动安装：
| 组件 | 说明 |
| --------------- | ------- |
| **Claude Code** | AI 编程助手 |
| **42plugin** | 插件管理器 |
| **42cc** | 图形化配置工具 |
| **Zed** | 代码编辑器 |
预计安装时间 1-3 分钟，所需磁盘空间约 300MB。
## 开始安装
打开终端（按 `Command + 空格`，输入"终端"，回车），粘贴以下命令：
```bash theme={null}
curl -fsSL https://get.42plugin.com/mac | bash
```
以**管理员身份**打开 PowerShell（按 `Win + X`，选择"终端(管理员)"），运行：
```powershell theme={null}
irm https://get.42plugin.com/win | iex
```
必须使用 PowerShell，CMD（命令提示符）无法运行安装命令。
安装成功后会显示：
```
🎉 恭喜！安装完成！
```
## 安装后：刷新终端
**重要**：安装完成后，必须关闭当前终端，打开**新的**终端窗口，再继续下面的步骤。
验证安装：
```bash theme={null}
claude --version
```
如果显示版本号（如 `2.1.71`），说明安装成功。
**如果提示 command not found：**
* 完全关闭终端应用，重新打开
* 或运行：`source ~/.zshrc`（bash 用户用 `source ~/.bashrc`）
## 只安装单个工具
不需要全套？可以用快捷命令单独安装：
```bash theme={null}
# 只安装 Claude Code
curl -fsSL https://get.42plugin.com/cc | bash
# 只安装 42plugin CLI
curl -fsSL https://get.42plugin.com/cli | bash
# 只安装 42cc 配置工具
curl -fsSL https://get.42plugin.com/42cc | bash
# 只安装 Zed 编辑器
curl -fsSL https://get.42plugin.com/zed | bash
```
```powershell theme={null}
# 只安装 Claude Code
irm https://get.42plugin.com/cc.ps1 | iex
# 只安装 42plugin CLI
irm https://get.42plugin.com/cli.ps1 | iex
# 只安装 42cc 配置工具
irm https://get.42plugin.com/42cc.ps1 | iex
# 只安装 Zed 编辑器
irm https://get.42plugin.com/zed.ps1 | iex
```
## 配置 Claude Code
根据你的所在地区，选择合适的方式：
**MiniMax（推荐）**
1. 访问 [MiniMax 开放平台](https://platform.minimaxi.com/)
2. 注册并创建 API Key
3. 详细教程：[MiniMax Claude Code 配置指南](https://platform.minimaxi.com/docs/guides/text-ai-coding-tools)
**智谱 AI**
1. 访问 [智谱 AI 开放平台](https://open.bigmodel.cn/)
2. 注册并创建 API Key
3. 详细教程：[智谱 Claude Code 配置指南](https://docs.bigmodel.cn/cn/coding-plan/tool/claude)
**Claude Pro/Max 订阅（推荐）**
1. 访问 [claude.ai](https://claude.ai/)
2. 订阅 Claude Pro（\$20/月）或 Claude Max
3. 运行 `claude login`，选择通过浏览器登录
**Anthropic API（按量付费）**
1. 访问 [Anthropic Console](https://console.anthropic.com/)
2. 注册并创建 API Key
如果安装了 42cc（macOS），可运行 `open -a 42cc` 在图形界面中配置。
## 升级
```bash theme={null}
# 升级全部已安装的组件
curl -fsSL https://get.42plugin.com/mac | bash -s -- --upgrade
# 只升级 Claude Code
curl -fsSL https://get.42plugin.com/cc | bash -s -- --upgrade
# 只升级 42plugin
curl -fsSL https://get.42plugin.com/cli | bash -s -- --upgrade
```
```powershell theme={null}
# 升级全部已安装的组件
& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Upgrade
# 只升级 Claude Code
& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only claude-code -Upgrade
# 只升级 42plugin
& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only 42plugin -Upgrade
```
升级模式只会更新已安装的组件，不会意外安装新组件。如果所有组件都已是最新版本，脚本会提示「已是最新」。
## 卸载
```bash theme={null}
# 卸载全部组件
curl -fsSL https://get.42plugin.com/mac | bash -s -- --uninstall
# 只卸载 Claude Code
curl -fsSL https://get.42plugin.com/cc | bash -s -- --uninstall
# 只卸载 42cc
curl -fsSL https://get.42plugin.com/42cc | bash -s -- --uninstall
```
```powershell theme={null}
# 卸载全部组件
& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Uninstall
# 只卸载 Claude Code
& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only claude-code -Uninstall
# 只卸载 42cc
& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Only 42cc -Uninstall
```
卸载后配置文件（`~/.claude/`）会保留，如需彻底删除：
```bash theme={null}
rm -rf ~/.claude
```
## 快捷命令一览
| 操作 | 命令 |
| --------------- | ------------------------------------------------------------------- |
| **全套安装**（推荐） | `curl -fsSL https://get.42plugin.com/mac \| bash` |
| 只装 Claude Code | `curl -fsSL https://get.42plugin.com/cc \| bash` |
| 只装 42plugin CLI | `curl -fsSL https://get.42plugin.com/cli \| bash` |
| 只装 42cc | `curl -fsSL https://get.42plugin.com/42cc \| bash` |
| 只装 Zed 编辑器 | `curl -fsSL https://get.42plugin.com/zed \| bash` |
| **升级全部** | `curl -fsSL https://get.42plugin.com/mac \| bash -s -- --upgrade` |
| 升级单个 | `curl -fsSL https://get.42plugin.com/cc \| bash -s -- --upgrade` |
| **卸载全部** | `curl -fsSL https://get.42plugin.com/mac \| bash -s -- --uninstall` |
| 卸载单个 | `curl -fsSL https://get.42plugin.com/cc \| bash -s -- --uninstall` |
| 操作 | 命令 |
| --------------- | -------------------------------------------------------------------------- |
| **全套安装**（推荐） | `irm https://get.42plugin.com/win \| iex` |
| 只装 Claude Code | `irm https://get.42plugin.com/cc.ps1 \| iex` |
| 只装 42plugin CLI | `irm https://get.42plugin.com/cli.ps1 \| iex` |
| 只装 42cc | `irm https://get.42plugin.com/42cc.ps1 \| iex` |
| 只装 Zed 编辑器 | `irm https://get.42plugin.com/zed.ps1 \| iex` |
| **升级全部** | `& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Upgrade` |
| 升级单个 | `& ([scriptblock]::Create((irm .../win))) -Only claude-code -Upgrade` |
| **卸载全部** | `& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Uninstall` |
| 卸载单个 | `& ([scriptblock]::Create((irm .../win))) -Only claude-code -Uninstall` |
## 高级选项
| 参数 | 说明 |
| -------------------- | ------------- |
| `--only <组件>` | 只安装指定组件（逗号分隔） |
| `--skip <组件>` | 跳过指定组件 |
| `-y, --yes` | 跳过所有确认提示 |
| `--dry-run` | 预览模式 |
| `--upgrade` | 升级已安装的组件到最新版本 |
| `--uninstall` | 卸载所有组件 |
| `-t, --troubleshoot` | 显示故障排除指南 |
可用组件名：`claude-code`、`42plugin`、`42cc`、`zed`
## 常见问题
按 `Ctrl + C` 中断后重新运行安装命令即可。脚本使用 CDN 加速分发，重试通常即可恢复。
运行 `xcode-select --install`，在弹出窗口中点击「安装」，等待完成后重试。
以管理员身份运行 PowerShell，先执行：
```powershell theme={null}
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
```
输入 `Y` 确认，然后重新运行安装命令。
关闭终端并重新打开一个新窗口。macOS/Linux 也可执行 `source ~/.zshrc` 或 `source ~/.bashrc` 立即生效。
macOS/Linux：`curl -fsSL https://get.42plugin.com/mac | bash -s -- --upgrade`
Windows：`& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Upgrade`
也可以只升级单个组件，如 `curl -fsSL https://get.42plugin.com/cc | bash -s -- --upgrade`。
macOS/Linux：`curl -fsSL https://get.42plugin.com/mac | bash -s -- --uninstall`
Windows：`& ([scriptblock]::Create((irm https://get.42plugin.com/win))) -Uninstall`
支持单组件卸载，如 `curl -fsSL https://get.42plugin.com/cc | bash -s -- --uninstall`。
***
遇到问题？访问 [42ailab/42plugin/meta](https://cnb.cool/42ailab/42plugin/meta) 提交 issue。
# 安装CLI
Source: https://docs.42plugin.com/install/quick-setup
快速的方式开始使用活水插件
最快 1 分钟完成安装，开始使用活水插件。
## 什么是 CLI？
CLI（Command Line Interface，命令行界面）是通过文本命令与计算机交互的方式。
**42plugin CLI 的意义**：
* 快速安装和管理插件
* 跨项目同步插件配置
* 自动化插件发布流程
* 与 AI 编码助手无缝集成
## 步骤 1：安装 42plugin CLI
打开终端（按 `Command + 空格`，输入 `Terminal`），执行：
```bash theme={null}
curl -fsSL https://get.42plugin.com/cli | bash
```
打开 PowerShell（按 `Win + X`，选择 "终端"），执行：
```powershell theme={null}
irm https://get.42plugin.com/cli.ps1 | iex
```
## 步骤 2：验证安装
```bash theme={null}
42plugin --version
```
看到版本号即表示安装成功！
## 下一步
安装 Claude Code 等配套工具
使用 42plugin auth 登录
# 配套工具
Source: https://docs.42plugin.com/install/tools
AI 编码助手和配置工具
安装配套软件，获得最佳体验。
## Claude Code（必需）
42plugin 目前仅支持 Claude Code。
**macOS / Linux：**
```bash theme={null}
curl -fsSL https://get.42plugin.com/cc | bash
```
**Windows（PowerShell）：**
```powershell theme={null}
irm https://get.42plugin.com/cc.ps1 | iex
```
访问 [claude.ai/download](https://claude.ai/download) 或运行：
```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```
### 升级 Claude Code
```bash theme={null}
curl -fsSL https://get.42plugin.com/cc | bash -s -- --upgrade
```
### 国内 API 配置
如需使用国内 API 服务：
* **MiniMax**：[官方配置教程](https://platform.minimaxi.com/docs/guides/text-ai-coding-tools)
* **智谱**：[官方配置教程](https://docs.bigmodel.cn/cn/coding-plan/tool/claude)
## 42cc
42cc 是一款极简的 Claude Code 模型配置工具，图形界面操作，告别手动编辑 JSON 配置文件。
**支持平台**：macOS、Windows
**功能特点**：
* **配置**：选择模型供应商，输入 API Key，保存即可
* **切换**：系统托盘菜单一键切换配置，无需重启
* **诊断**：内置配置测试，自动检测网络连接、Key 验证、API 兼容性
**支持的模型供应商**：
| 供应商 | 说明 |
| ------------ | ------------------------------- |
| Anthropic 官方 | Claude 系列模型 |
| MiniMax | 国内合规 API 服务 |
| 智谱 GLM | 国内合规 API 服务 |
| Ollama | 本地模型部署 |
| DeepSeek | 国内 AI 模型服务 |
| 自定义服务 | 任何兼容 Anthropic Messages API 的服务 |
**macOS / Linux：**
```bash theme={null}
curl -fsSL https://get.42plugin.com/42cc | bash
```
**Windows（PowerShell）：**
```powershell theme={null}
irm https://get.42plugin.com/42cc.ps1 | iex
```
**macOS：** 下载 [42cc.dmg](https://cdn.42plugin.com/42cc/latest/42cc.dmg) 安装
**Windows：** 下载 [42cc.exe](https://cdn.42plugin.com/42cc/latest/42cc.exe) 安装
首次打开如被 macOS 阻止，右键点击应用选择"打开"，或运行：
```bash theme={null}
xattr -cr /Applications/42cc.app && open -a 42cc
```
## Zed 编辑器
推荐使用 Zed 编辑器，轻量快速。
**macOS / Linux：**
```bash theme={null}
curl -fsSL https://get.42plugin.com/zed | bash
```
**Windows（PowerShell）：**
```powershell theme={null}
irm https://get.42plugin.com/zed.ps1 | iex
```
**macOS（Homebrew）：**
```bash theme={null}
brew install --cask zed
```
**macOS / Linux（官方脚本）：**
```bash theme={null}
curl -f https://zed.dev/install.sh | sh
```
**Windows：** 访问 [Zed 官网](https://zed.dev/download) 下载安装包
## 下一步
使用 42plugin auth 登录
# 你好，活水插件的新朋友
Source: https://docs.42plugin.com/introduction
AI 插件生态系统平台 - 增强你的 AI 能力
活水插件（[42plugin](https://42plugin.com)）是一个 AI 插件生态系统平台，帮助你发现、安装、创作和分享 AI 插件。它由活水AI实验室（[42ailab](https://42ailab.com)）出品并负责维护。
活水插件（42plugin）包括 Web App 与 CLI 两种相互补充的服务形式。活水插件（42plugin）Web App 的访问网址是：[42plugin.com](https://42plugin.com)；活水插件（42plugin）的 CLI 版本为：42plugin CLI。
## 支持的 AI 工具
目前只支持：
* **Claude Code**（推荐）- Anthropic 官方 CLI 工具
## 核心优势
2.3万+ 插件库，[活水指数](/faq#什么是活水指数)评分，中文优化，智能分类
高并发下载，智能缓存，秒下体验，自动安装
[元技能](/create/meta-skills)加速创作，集成专家知识，质量远超同类
秒速发布，只需 pub 三个字母
## 下一步
快速了解如何使用活水插件
在网页上探索插件
一键安装全套工具
创作你的第一个插件
## 反馈与建议
遇到问题或有建议？欢迎[提交反馈](https://cnb.cool/42ailab/42plugin/meta)。
# Pro 与组织版
Source: https://docs.42plugin.com/pro
解锁更多高级功能
活水插件提供免费版、Pro 版和组织版三个套餐。
## 套餐对比
### 发现与安装
| 功能 | 免费版 | Pro 版（199 元/年） | 组织版（999 元/年起） |
| ------------------------ | ----------- | -------------- | ------------- |
| 搜索 10,000+ 插件（含 AI 语义搜索） | 42 次/天 | 420 次/天 | 420 次/天 |
| 市场安装（含套包内插件） | 42 次/天 | 420 次/天 | 420 次/天 |
| Git 直装（从任意仓库安装） | 公开仓库 42 次/天 | 公开+私有 420 次/天 | 公开+私有 420 次/天 |
| 私有插件 & 套包下载 | — | 不限 | 不限 |
### 创作与发布
| 功能 | 免费版 | Pro 版 | 组织版 |
| -------------------- | ------------- | ----- | --- |
| 高效创作（自动生成 · 优化 · 验证） | 支持 | 支持 | 支持 |
| 发布到公开市场（宽松许可证） | 支持 | 支持 | 支持 |
| 私有插件与套包（专用许可证） | — | 支持 | 支持 |
| 公开套包配额 | 3 套 · 每套 42 个 | 不限 | 不限 |
### 特色能力
| 功能 | 免费版 | Pro 版 | 组织版 |
| ----------------------- | --- | ----- | --- |
| Agents 集成 | 支持 | 支持 | 支持 |
| 对话管理（自动保存/导入导出/快捷搜索） | 支持 | 支持 | 支持 |
| 元技能 · 元 Agents · 42eval | 支持 | 支持 | 支持 |
| 专属徽章 | — | 支持 | 支持 |
### 配套工具
| 功能 | 免费版 | Pro 版 | 组织版 |
| ---------- | ----- | --------------------- | ------ |
| 一键安装 | 支持 | 支持 | 支持 |
| 42cc 可视化配置 | 支持 | 支持 | 支持 |
| 42skill 生成 | 1 次/天 | 42 次/天 | 42 次/天 |
| 42skill 试炼 | 3 轮/天 | 42 轮/天 | 42 轮/天 |
| AI 点数 | — | 100 点（约 100 万 tokens） | 随席位分配 |
### 组织协作
| 功能 | 免费版 | Pro 版 | 组织版 |
| ------- | --- | ----- | --------------------- |
| 创建组织和团队 | - | - | 最多 9 个团队 |
| 成员管理 | - | - | 42 名普通成员 |
| Pro 席位 | - | - | 含 3 个（可加购 199 元/席位/年） |
| 团队专属套包 | - | - | 支持 |
| 组织内私有共享 | - | - | 支持 |
## Pro 版
Pro 版面向个人用户，**199 元/年**。
### 核心能力
* **AI 搜索 & 推荐扩容**：每天 420 次，且能搜到私有插件
* **Git 直装私有仓库**：从任意私有 Git 仓库安装插件（420 次/天）
* **私有插件**：发布仅自己可见的插件，使用 42plugin-personal 专用许可证
```bash theme={null}
42plugin pub --private
```
* **42skill 高频创作**：每天 42 次生成 + 42 轮试炼
* **AI 点数**：赠送 100 点（约 100 万 tokens）
* **跨设备同步**：私有内容随账号走
* **专属徽章**：个人主页展示
## 组织版
组织版面向团队和企业，**999 元/年起**，含 3 个 Pro 席位。
### 核心能力
* **成员管理**：邀请团队成员，细粒度权限控制
* **团队专属套包**：组织内共享插件套包，一键安装
* **组织内私有共享**：私有插件在组织内可见
* **可扩展**：加购 Pro 席位（199 元/席位/年），扩展团队和成员数
## 升级方式
访问 [42plugin.com/pricing](https://42plugin.com/pricing) 选择套餐，支持微信支付，无自动续费。
查看当前套餐和使用情况：
```bash theme={null}
42plugin status
```
## 常见问题
### 免费版够用吗？
大多数个人用户，免费版已能满足日常需求。如果你频繁使用 AI 搜索和推荐、需要私有插件、或高频使用 42skill，建议升级 Pro。
### Pro 能创建组织吗？
不能。创建组织需要组织版。
### 组织版含几个 Pro 席位？
基础包含 3 个 Pro 席位，普通成员 42 名。可按 199 元/席位/年加购。
# 5分钟上手指南
Source: https://docs.42plugin.com/quickstart
快速了解如何使用活水插件
本指南将带你快速上手活水插件，从安装到使用。
## 前置要求
* 已安装 AI 编码助手（目前只支持 [Claude Code](https://claude.ai/download)）
**新用户？** 推荐使用 [一键安装脚本](/install/one-click)，一条命令自动安装 Claude Code、42plugin 等全套工具。
## 步骤 1：安装 CLI 工具
```bash macOS / Linux theme={null}
curl -fsSL https://get.42plugin.com/cli | bash
```
```powershell Windows theme={null}
irm https://get.42plugin.com/cli.ps1 | iex
```
验证安装：
```bash theme={null}
42plugin --version
```
## 步骤 2：登录认证
```bash theme={null}
42plugin auth
```
执行后会自动打开浏览器，输入验证码完成登录。
## 步骤 3：浏览插件
访问 [42plugin.com](https://42plugin.com) 浏览插件市场：
* 浏览热门插件和套包
* 搜索你需要的功能
* 收藏感兴趣的插件
## 步骤 4：安装插件
### 安装单个插件
```bash theme={null}
42plugin install 42ailab/sci/psych-review
```
### 安装套包
```bash theme={null}
42plugin install 42ailab/kit/sci
```
### 一键安装收藏
```bash theme={null}
42plugin install like
```
## 步骤 5：使用插件
在 Claude Code 中直接使用：
```
帮我做一个关于青少年心理健康的系统文献综述
```
Claude 会自动激活相关插件完成任务。
## 下一步
探索更多插件
创作你的插件
# CLI 命令一览
Source: https://docs.42plugin.com/reference/cli-commands
所有 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 --global # 全局安装
42plugin install --force # 强制重装
42plugin install --no-cache # 跳过缓存
42plugin install --optional # 安装可选依赖
42plugin install --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 # 导入对话
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 # 启用
42plugin builtin disable # 禁用
```
### clean — 清理缓存
```bash theme={null}
42plugin clean
```
### purge — 彻底清除
```bash theme={null}
42plugin purge
```
`purge` 会删除所有本地数据，包括已安装的插件和配置。请谨慎使用。
### 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
```
# 探索插件生态
Source: https://docs.42plugin.com/use/explore
按 AI 公司、开源项目、编程语言、学术方向和效率场景发现插件
2.3 万+ 插件，光靠搜索不够。你需要一张地图。
访问 [42plugin.com/explore](https://42plugin.com/explore)，六大板块帮你从不同维度看到整个生态的全貌。
## AI 先锋
来自 30+ 家 AI 公司和平台的精选套包。
涵盖 AI 模型公司（Anthropic、OpenAI、Mistral、DeepSeek、Cohere、Meta）、AI 平台（Hugging Face、Replicate、W\&B、ElevenLabs）、以及大厂 AI 部门（Microsoft、Google、Google DeepMind）等。
每张卡片标注了套包数和插件数，点击进入该组织的主页，查看所有套包和插件。
## 热门开源
知名开源项目的插件与套包，通过 Tab 标签页切换六个子分类：
| 子分类 | 代表项目 |
| ------------- | ------------------------------------------ |
| AI 框架 & Agent | LangChain、MCP、LobeHub、FastGPT |
| 数据库 & ORM | Neon、Supabase、Prisma、Drizzle、MongoDB、Redis |
| Web 框架 & CMS | Hono、Express、Svelte、Vue.js、Nuxt、Astro |
| 开发工具 | Vite、Biome、Tailwind CSS、tRPC、TanStack |
| 基础设施 & 服务 | Docker、Cloudflare、Stripe、Sentry、Figma |
| 生产力工具 | Obsidian、Fabric、n8n |
## 社群之星
12 位活跃的插件创作者，每张卡片展示插件数量和优质率。点击可以查看他们发布的全部插件。
## 编程语言
Python、TypeScript、Go、Rust……以彩色标签云形式展示，点击对应语言，直接筛选出该语言相关的插件。
## 学术前沿
科学研究与教育场景的插件。覆盖研究工具、生命科学、数学计算、物理科学、教育、文献管理、引用、实验等方向。
## 效率神器
提升工作效率的生产力工具。包括写作创作、办公文档、技术文档、数据分析、项目管理、设计、自动化、营销等领域。
## 为什么需要探索页？
搜索适合明确需求，但探索适合发现可能性。
你可能不知道 LangChain 发布了 AI Agent 套包，不知道 Supabase 有多少个数据库插件，不知道有人已经为 Hono 和 tRPC 写好了开发技能。
探索页就是入口——从不同维度切入，看到整个生态的全貌。
开始探索 2.3 万+ 插件
# 发现更多有趣的插件
Source: https://docs.42plugin.com/use/interesting-plugins
来自活水周刊的精选插件推荐，按场景分类
每周，活水周刊会从新增的数百个插件中精选最有趣、最实用的推荐给你。以下是近期精选，按使用场景分组。
## 开发者工具
### 智能提交
提交代码前，自动检测有没有不小心把密钥写进去。集成 gitleaks 安全扫描，多个文件修改按功能目的自动拆分成独立提交。
[查看插件 →](https://42plugin.com/user3602/xingyu-tools/smart-commit)
### 安全代码审查
采用零信任思路，只盯高置信度（> 95%）的可利用漏洞。聚焦输入解析、数据库查询、身份验证、外部 API 调用等关键路径，对齐 OWASP 标准。
[查看插件 →](https://42plugin.com/xinbenlv/codereview-skills/codereview-security)
### 本地网页测试
用 Playwright 和 Lighthouse 一键检测页面性能和可访问性。支持 Next.js、Vite、Nuxt 等主流框架，开发阶段就能发现问题。
[查看插件 →](https://42plugin.com/qujing/dev-tools/web-local-test)
### Mermaid ASCII 渲染器
在终端里画流程图！把 Mermaid 图表渲染成 ASCII 艺术，支持流程图、状态图、序列图、类图、ER 图。
[查看插件 →](https://42plugin.com/joe/joe/mermaid-ascii-renderer)
### Claude 规则创建
团队项目里 Claude 总是不听话？通过引导式提问，帮你发现「你的项目到底需要什么约束」，根据项目特点量身定制规则。
[查看插件 →](https://42plugin.com/xallenchen/public-skills/claude-rules)
### 任务完成通知
Claude Code 跑长任务时，macOS 通知中心横幅 + 声音提醒，点击通知直接跳回编辑器。配置为 Stop hook，任务结束自动触发。
[查看插件 →](https://42plugin.com/user3602/xingyu-tools/cc-done-notifier)
***
## 办公与效率
### 多项目 AI 管理器
同时推进多个项目？三层结构（阶段 → 任务组 → 冲刺），为不同任务分配 AI 代理角色，完整的敏捷开发流程。
[查看插件 →](https://42plugin.com/stormakerho/ai-agentic-agile-dev-pm/pm)
### 会议录音转纪要
把录音文件丢给它，自动提取关键决策、讨论要点和待办事项，生成标准格式会议纪要，自动标注责任人和截止时间。
[查看插件 →](https://42plugin.com/user3602/xingyu-tools/meeting-to-report)
### 文档美化大师
一键把 Word 文档变身麦肯锡风格、经济学人风格、苹果风格等 10 种高端品牌美学，上传 DOCX 即可一键美化。
[查看插件 →](https://42plugin.com/promptadvisers/claude-code-polished-documents-skills/document-polisher)
### PDF 处理
读取提取、创建生成、合并拆分——一个插件搞定 PDF 所有事。
[查看插件 →](https://42plugin.com/sheng-jie/learn-cc-csharp/pdf)
### AI 每日简报
打造个性化的 AI 简报系统。三层智能过滤，越用越懂你，根据阅读习惯自动调整优先级。
[查看插件 →](https://42plugin.com/xallenchen/public-skills/ai-briefing)
### 万能数据查询
汇率、农历、历史事件、百科、油价、金价、化学元素——一个插件搞定七类日常查询。
[查看插件 →](https://42plugin.com/vikiboss/60s-skills/data-query)
***
## 思维与决策
### 深度阅读分析器
用 SCQA、5W2H、批判性思维等 10+ 种经典框架分析文章，把散乱的阅读感受整理成清晰的洞察、论点和行动项。不是泛泛的「帮我总结」，而是带框架的深度理解。
[查看插件 →](https://42plugin.com/yyh211/claude-meta-skill/deep-reading-analyst)
### 项目风险预检
新项目启动前先想想它怎么会失败。假设项目已经失败，倒推所有可能的原因，从技术、资源、时间、沟通等维度系统识别风险，附带预防措施。
[查看插件 →](https://42plugin.com/tjboudreaux/cc-thinking-skills/thinking-pre-mortem)
### 认知协议套件
一套帮你「想清楚再动手」的思维工具：意图澄清、多视角分析、决策前填补空白、从历史对话中提取洞察。适合重要决策前使用。
[查看套包 →](https://42plugin.com/jongwony/epistemic-protocols/hermeneia)
### 自适应多智能体研究团队
让多个 AI 专家帮你分析复杂问题。三轮工作流——事实收集、观点辩论、达成共识，输出带成本估算的可执行方案。
[查看插件 →](https://42plugin.com/joe/joe/adaptive-team-research)
### Gepetto 实施计划生成
新功能动手前先做好前期功课。自动调研现有方案，引导梳理需求优先级，生成的计划经过多轮 AI 审查，拆成可执行的阶段。
[查看插件 →](https://42plugin.com/softaworks/gepetto/gepetto)
***
## 学习与研究
### 考试真题解码器
输入历年真题，自动解码考点分布、生成诊断报告、输出速记手册。支持数理型和论述型学科，中英文双语。
[查看插件 →](https://42plugin.com/xinwenli/research-toolkit/exam-review-blueprint)
### 译文疑点溯源
图书编辑的神器。输入有疑问的中文译文，自动定位原文、分析偏差、给出修改建议，告别翻原书逐页对照。
[查看插件 →](https://42plugin.com/kkjiayu/trans-edit-kit/trans-edit)
### 学术 PDF 双栏转换
论文 PDF 的左右双栏排版，复制粘贴出来全是乱的。智能识别左右栏阅读顺序，自动剔除页眉页脚，基于 pymupdf 直接解析，速度快精度高。
[查看插件 →](https://42plugin.com/wx_bu9bfl/pdf-tools/pdf-two-column-to-md)
### EPUB 转 Markdown
电子书按章节拆解为干净的 Markdown 文件。保留原始结构，自动生成 INDEX.md 和 metadata.json。
[查看插件 →](https://42plugin.com/wx_9cx0xs/knowledge-tools/epub-to-markdown)
***
## 内容创作
### AI 电影创作助手
一句话或一张图片，就能拍一部 30 秒的电影。从创意到完整剧本、从剧本到电影级输出，零门槛创作。
[查看插件 →](https://42plugin.com/happycapy-ai/happycapy-skills/film-creator)
### Markdown 一键做 PPT
用 Markdown 写完内容，直接生成演示幻灯片。标题、列表、代码块自动布局，每页可附带讲稿提示，兼容 Deckset 和 Marp。
[查看插件 →](https://42plugin.com/jykim/claude-obsidian-skills/markdown-slides)
### Slidev 演示文稿套装
用 Markdown 写 PPT 的进阶方案。代码块丝滑过渡、Shiki 语法高亮、淡入淡出过渡效果、Vue 组件增强交互。
[查看套包 →](https://42plugin.com/yoanbernabeu/kit/slidev-skills)
***
## 生活与成长
### 东木生命繁荣套包
三个能陪你聊成长、聊自我接纳、聊人生故事的 AI 伙伴：
| 技能 | 主题 | 适合场景 |
| -------- | -------- | -------------- |
| 理想女孩成长指南 | 美丽、有趣、精彩 | 外貌焦虑、性格培养、职场竞争 |
| 爱自己实践指南 | 自我接纳 | 识别自我否定、东亚文化困境 |
| 人生叙事探索指南 | 叙事心理学 | 梳理人生故事、理解转折与选择 |
AI 不只是冰冷的效率工具，当它被注入好的方法论和真诚的关怀，它可以成为一个耐心的伙伴。
***
以上插件精选自[活水周刊](https://42plugin.com/blog)。每周更新，发现更多有趣的插件。
## 下一步
按 AI 公司、开源项目、编程语言等维度浏览
安装你感兴趣的插件
# 心理学文献检索
Source: https://docs.42plugin.com/use/psych-review
使用 psych-review 插件进行系统文献综述
psych-review 是一个专业的心理学系统文献综述插件。
这是插件使用的举例说明。更多插件请访问 [活水插件官网](https://42plugin.com)
## 插件简介
* 支持多数据库检索（Semantic Scholar、OpenAlex、PsycINFO）
* 遵循 PRISMA 标准流程
* 自动生成 APA 第 7 版格式引用
* 集成专家知识，质量远超同类工具
## 安装
```bash theme={null}
42plugin install 42ailab/sci/psych-review
```
## 使用方法
在 AI 编码助手中，直接描述你的需求：
```
帮我做一个关于青少年心理健康的系统文献综述，时间范围 2020-2025
```
AI 会自动激活 psych-review 插件，帮你完成：
1. 界定研究问题（PICOS 框架）
2. 多数据库搜索
3. 结果聚合去重
4. 筛选与质量评估
5. 生成 APA 格式综述
## 核心功能
* 自动搜索文献
* 智能去重
* APA 格式引用
* 质量评估
* 生成完整综述文档
## 下一步
按 AI 公司、开源项目等维度浏览
来自活水周刊的精选推荐