> ## 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.

# 发布你的插件

> 使用 pub 命令秒速发布你的插件

创作完插件后，使用 `42plugin pub` 命令发布。

## 发布命令

在插件目录下执行：

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

完整命令：`42plugin publish`

## 发布流程

1. 自动检测插件类型
2. 验证插件格式
3. **选择许可证**（必须）
4. 自动生成 LICENSE 文件
5. 上传到服务器
6. 生成插件页面

<Info>
  秒速发布！只需输入 `pub` 三个字母即可完成发布。
</Info>

## 发布选项

### 公开发布

```bash theme={null}
42plugin pub --public
```

默认发布的插件仅自己可见，使用 `--public` 参数公开发布。

### 私有发布（Pro）

```bash theme={null}
42plugin pub --private
```

Pro 用户可以发布私有插件，仅自己和组织成员可见。

<Tip>
  了解更多 Pro 功能，请查看 [Pro 与组织版](/pro)。
</Tip>

### 指定许可证

```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 <license>` | 指定许可证（如 MIT、Apache-2.0） |
| `--dry-run`           | 预演模式，不实际上传              |
| `--name <name>`       | 指定插件名称                  |
| `--type <type>`       | 指定插件类型                  |
| `--kit <kit>`         | 指定发布到的套包                |
| `--force`             | 强制发布                    |
| `--no-sync-version`   | 不同步版本号到 frontmatter     |

## 下一步

<CardGroup cols={2}>
  <Card title="发布前检查" icon="check" href="/install/cli-check">
    发布前自动检查插件质量
  </Card>

  <Card title="管理你的套包" icon="box" href="/install/cli-kit">
    创建和管理插件套包
  </Card>
</CardGroup>