wehub-resource-sync
104 lines
4.0 KiB
Markdown
104 lines
4.0 KiB
Markdown
<!-- WEHUB_ZH_README -->
|
||
> [!NOTE]
|
||
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
|
||
> [English](./README.en.md) · [原始项目](https://github.com/anthropics/claude-plugins-official) · [上游 README](https://github.com/anthropics/claude-plugins-official/blob/HEAD/README.md)
|
||
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
|
||
|
||
# Claude Code 插件目录
|
||
|
||
精心整理的 Claude Code 高质量插件目录。
|
||
|
||
> **⚠️ 重要提示：** 在安装、更新或使用插件之前，请务必确认你信任该插件。Anthropic 不控制插件中包含哪些 MCP 服务器、文件或其他软件，也无法验证它们能否按预期工作，或不会发生变化。请参阅各插件的主页了解更多信息。
|
||
|
||
## 结构
|
||
|
||
- **`/plugins`** - 由 Anthropic 开发和维护的内部插件
|
||
- **`/external_plugins`** - 来自合作伙伴与社区的第三方插件
|
||
|
||
## 安装
|
||
|
||
可通过 Claude Code 的插件系统直接从此市场安装插件。
|
||
|
||
要安装，请运行 `/plugin install {plugin-name}@claude-plugins-official`
|
||
|
||
或在 `/plugin > Discover` 中浏览查找插件
|
||
|
||
## 贡献
|
||
|
||
### 内部插件
|
||
|
||
内部插件由 Anthropic 团队成员开发。参考实现请参阅 `/plugins/example-plugin`。
|
||
|
||
### 外部插件
|
||
|
||
第三方合作伙伴可提交插件以供纳入市场。外部插件须满足质量和安全标准方可获批。要提交新插件，请使用[插件目录提交表单](https://clau.de/plugin-directory-submission).
|
||
|
||
## 插件结构
|
||
|
||
每个插件均遵循标准结构：
|
||
|
||
```
|
||
plugin-name/
|
||
├── .claude-plugin/
|
||
│ └── plugin.json # Plugin metadata (required)
|
||
├── .mcp.json # MCP server configuration (optional)
|
||
├── commands/ # Slash commands (optional)
|
||
├── agents/ # Agent definitions (optional)
|
||
├── skills/ # Skill definitions (optional)
|
||
└── README.md # Documentation
|
||
```
|
||
|
||
## 插件名称不可变
|
||
|
||
市场条目中的 `name` 字段是一个**不可变的 slug**。插件一旦发布，其 `name` 不得更改——用户是按该 slug 安装的，重命名会导致安装失败并出现 `plugin-not-found` 错误。
|
||
|
||
- 若要更改插件在 UI 中的显示名称，请改为设置或更新 `displayName`。
|
||
- 若确实无法避免重命名，请在 `.claude-plugin/marketplace.json` 的顶层 `renames` 映射中添加一项，以便现有安装自动迁移：
|
||
|
||
```json
|
||
"renames": {
|
||
"old-name": "new-name"
|
||
}
|
||
```
|
||
|
||
Claude Code 插件加载器会读取此映射，并在用户下次同步时透明地将旧 slug 重写为新 slug。
|
||
|
||
## Skill-bundle 插件
|
||
|
||
当插件的源仓库随附 skills（`SKILL.md` 文件）但没有 `.claude-plugin/plugin.json` 清单时，市场条目可使用 `strict: false` 和显式的 `skills` 数组直接声明这些 skills。
|
||
|
||
```json
|
||
{
|
||
"name": "example-bundle",
|
||
"description": "Brief description of the bundled skills.",
|
||
"author": { "name": "Author Name" },
|
||
"category": "development",
|
||
"source": {
|
||
"source": "git-subdir",
|
||
"url": "https://github.com/example-org/sdk.git",
|
||
"path": "packages/agent-skills",
|
||
"ref": "main",
|
||
"sha": "<commit sha>"
|
||
},
|
||
"strict": false,
|
||
"skills": [
|
||
"./skill-a",
|
||
"./skill-b",
|
||
"./skill-c"
|
||
],
|
||
"homepage": "https://github.com/example-org/sdk"
|
||
}
|
||
```
|
||
|
||
`skills` 中的每个路径均相对于 `source.path`，并指向包含 `SKILL.md` 的目录。路径可深入多个层级——例如，`["./libA/skill-1", "./libB/skill-2"]` 会在多个库子目录中暴露精心筛选的子集。每个 skill 在 Claude Code 中注册为 `<plugin-name>:<skill-name>`。
|
||
|
||
有关底层 schema，请参阅市场文档中的 [Strict mode](https://code.claude.com/docs/en/plugin-marketplaces) in the marketplace documentation.
|
||
|
||
## 许可证
|
||
|
||
请参阅各链接插件中的相应 LICENSE 文件。
|
||
|
||
## 文档
|
||
|
||
有关开发 Claude Code 插件的更多信息，请参阅[官方文档](https://code.claude.com/docs/en/plugins).
|