内容
# AI 市场
适用于 [GitHub Copilot CLI](https://github.com/github/copilot-cli) 的个人 AI 插件市场。它捆绑了可重用的技能、钩子和 MCP 服务器，您可以通过单个命令将其安装到任何 Copilot 会话中。
这里的每个插件都旨在使 AI 辅助开发工作流程更快、更可重复。按需安装所需的插件，或添加整个市场并浏览。
**网站：** [urikanonov.github.io/ai-marketplace](https://urikanonov.github.io/ai-marketplace/) - 在浏览器中浏览插件并尝试可评论的 HTML 审查界面。
## 可用插件
| 插件 | 描述 | 安装 |
|--------|-------------|---------|
| `commentable-html` | 将独立的 HTML 报告、计划、仪表板或设计文档转换为可评论的审查界面：审查者可以选择任何段落、表格单元格、代码块、KQL 查询、图表、图像或 Mermaid 图表，留下内联评论，并将整个线程导出回代理。极大地缩短了 AI 规划和迭代循环，通过在原地审查工件 | `copilot plugin install commentable-html@urikan-ai-marketplace` |
| `urikan-ai-marketplace-auto-updater` | 自动更新此市场中安装的所有插件（可选） | `copilot plugin install urikan-ai-marketplace-auto-updater@urikan-ai-marketplace` |
## 入门指南
### 从终端
**1. 添加市场**
```bash
copilot plugin marketplace add https://github.com/urikanonov/ai-marketplace
```
**2. 安装插件**
```bash
copilot plugin install urikan-ai-marketplace-auto-updater@urikan-ai-marketplace
```
**3. 验证**
```bash
copilot plugin list
```
### 在 Copilot 会话中
您可以使用内置的 `/plugin` 斜杠命令在不离开会话的情况下管理插件：
```
/plugin marketplace add https://github.com/urikanonov/ai-marketplace
/plugin install commentable-html@urikan-ai-marketplace
/plugin list
/plugin marketplace browse urikan-ai-marketplace
/plugin update <PLUGIN_NAME>
/plugin uninstall <PLUGIN_NAME>
```
## 更新
当此仓库中推送新的插件或更新时：
```bash
copilot plugin update <PLUGIN_NAME>
```
或安装 `urikan-ai-marketplace-auto-updater` 以自动更新此市场中安装的每个插件。
> 自动更新器运行一个 PowerShell 会话启动钩子。在 macOS 和 Linux 上，它需要 PowerShell 7 (`pwsh`) 在您的 PATH 上；如果 `pwsh` 未安装，钩子将简单地不执行（它永远不会阻止会话启动）。使用 `brew install --cask powershell` 或您的发行版的包（`apt install -y powershell`）安装它。
## 仓库布局
```
ai-marketplace/
.github/
plugin/marketplace.json # 市场清单：列出每个已发布的插件
schemas/ # 清单和 plugin.json 的 JSON 模式
workflows/ # CI：validate.yml + plugin-tests.yml（Playwright）
CODEOWNERS
plugins/
urikan-ai-marketplace-auto-updater/ # 会话启动钩子，自动更新插件
commentable-html/ # 插件目录源（推荐形状）
pkg/ # 已发布：plugin.json + skills/commentable-html/
dev/ # 不发布：Playwright 测试，开发文档
scripts/validate_marketplace.py # 市场验证器（CI + 预提交）
scripts/validate_markdown.py # Markdown 清洁验证器（CI + 预提交）
.githooks/pre-commit # 在每次提交前运行验证器
AGENTS.md CONTRIBUTING.md SECURITY.md MAINTAINING.md LICENSE README.md
```
市场清单位于 `.github/plugin/marketplace.json`。每个条目通过其 `source` 字段指向插件目录（或单个技能目录）。**只有插件的注册 `source` 在安装时分发** - 插件目录旁边的一个 `dev/` 文件夹（测试、构建工具、源）保留在仓库中，永远不会发布。参见 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [AGENTS.md](AGENTS.md)。
## 信任和安全
这里的插件可以分发技能、MCP 服务器和会话钩子，它们在您的机器上运行代码（例如，自动更新器在会话启动时运行 PowerShell 钩子）。在安装插件之前，请审查其内容。如需私下报告安全问题，请参见 [SECURITY.md](SECURITY.md)。使用 `copilot plugin uninstall <name>` 卸载任何插件。
对 `main` 的每个更改都经过拉取请求，并必须通过所需的 CI 检查：`validate`（市场清单、每个 `plugin.json` 和每个 `SKILL.md` 针对 JSON 模式和一致的 `source` 路径和版本，以及 Markdown 验证器、脚本单元测试和更改日志同步）、`version-bump`（已发布的源更改需要版本号更新）、`dist-in-sync`（插件的已提交构建输出与其 `dev/` 源匹配）、`actionlint`（每个 GitHub Actions 工作流都正常运行）、`site`（Pages 站点干净地再生并且其 Playwright 套件通过）和 `plugin-tests`（插件 Playwright 门控）。使用 `python scripts/validate_marketplace.py` 和 `python scripts/validate_markdown.py` 在本地运行验证器，或使用 `git config core.hooksPath .githooks` 启用 Git 钩子（预提交验证器和预推送门控）。有关完整的门控，请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
**自动更新器注意：** 安装 `urikan-ai-marketplace-auto-updater` 是一个永久授权 - 在每个会话启动时，它为您的已安装插件运行 `copilot plugin update`，因此它会静默应用维护者稍后合并的任何内容。如果您更喜欢审查每个更新，请勿安装它并自己运行 `copilot plugin update <name>`。参见 [SECURITY.md](SECURITY.md)。
## 报告问题和请求功能
在插件中找到错误？ [打开错误报告](https://github.com/urikanonov/ai-marketplace/issues/new?template=plugin-issue.yml)。它要求提供插件名称和版本、描述、重现步骤、截图或附件以及您的环境，以便快速重现和解决问题。
希望插件执行更多操作？ [为现有插件请求功能](https://github.com/urikanonov/ai-marketplace/issues/new?template=feature-request.yml)，或 [建议全新插件或技能](https://github.com/urikanonov/ai-marketplace/issues/new?template=plugin-request.yml)。 [问题选择器](https://github.com/urikanonov/ai-marketplace/issues/new/choose) 列出了每种表单。
## 贡献
`main` 分支受到保护：每个更改 - 包括维护者的更改 - 都通过拉取请求落地，该请求必须通过 CI。直接推送到 `main` 被阻止。有关完整的流程，包括如何改进现有插件和添加新插件，请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可证
[MIT](LICENSE) (c) Uri Kanonov
MCP 市场