内容
# 🎨 AI 原语中心
> 一个用于发现、安装和管理 GitHub Copilot 提示库的视觉化市场。
[](https://marketplace.visualstudio.com/items?itemName=AmadeusITGroup.prompt-registry)
[](https://amadeusitgroup.github.io/prompt-registry/)
[](https://opensource.org/licenses/Apache-2.0)
[](https://github.com/AmadeusITGroup/prompt-registry)
---
**AI 原语中心** 改变了您发现和管理 GitHub Copilot 提示的方式。浏览视觉化市场,按标签搜索,并通过单击安装精选的提示库 - 无需手动复制文件或克隆仓库。
> **ℹ️ 注意:** 该项目以前称为 **提示注册表**。现已更名为 **AI 原语中心**,以更好地反映其更广泛的范围。

---
## 🚀 快速入门
1. **安装** — 在 VS Code 扩展中搜索 "AI 原语中心"(`Ctrl+Shift+X`)
2. **选择中心** — 在第一次启动时,从欢迎对话框中选择一个中心(或跳过配置)
3. **浏览** — 在 AI 原语中心侧边栏中单击 "市场"
4. **安装** — 单击任何软件包图块,然后单击 **安装**
5. **使用** — 您的提示现在已在 GitHub Copilot 中可用! 🎉
扩展程序自动添加 Awesome Copilot 源,并在启动时同步您选择的中心的配置文件。
→ [完整入门指南](./docs/user-guide/getting-started.md)
---
## ✨ 主要功能
- **🎨 视觉化市场** — 在基于图块的界面中浏览软件包,支持搜索、筛选和一键安装([详细信息](./docs/user-guide/marketplace.md))
- **🔌 多源支持** — 连接到 GitHub、本地目录、APM 仓库或 Awesome Copilot 集合([详细信息](./docs/user-guide/sources.md))
- **📦 版本管理** — 跟踪版本、检测更新并启用自动后台更新([详细信息](./docs/user-guide/configuration.md))
- **👥 配置文件和中心** — 按项目/团队组织软件包并在您的组织中共享配置([详细信息](./docs/user-guide/profiles-and-hubs.md))
- **🤖 内置 Copilot 技能** — 在聊天中直接向 GitHub Copilot 询问有关 AI 原语中心的问题 - 设置、创作、故障排除等
- **🌍 跨平台** — 支持 macOS、Linux 和 Windows,适用于所有 VS Code 版本
---
## 🤖 向 Copilot 询问 AI 原语中心
AI 原语中心附带了一个内置的 **Copilot 技能**,允许您在聊天中直接向 GitHub Copilot 询问有关扩展程序的问题。无需额外设置 - 只要安装了扩展程序,技能就可用。
**您可以询问:**
- **用户** — "如何添加本地源?", "有哪些作用域可用?", "为什么我的中心没有显示?"
- **作者** — "如何创建集合?", "清单中需要哪些字段?", "如何发布到中心?"
技能从扩展程序自己的文档中回答问题,因此响应始终基于您安装的版本的实际行为。
> **注意:** 技能仅涵盖用户和作者主题。如有贡献者问题(架构、测试、内部实现),请直接查阅 [贡献者指南](./docs/contributor-guide/development-setup.md)。
> **看到不正确或意外的答案?** 请 [提交问题](https://github.com/AmadeusITGroup/prompt-registry/issues),描述您提出的问题和收到的回应,或直接联系项目贡献者。
---
## 📚 文档
| 受众 | 描述 | 链接 |
|----------|-------------|------|
| **用户** | 安装、市场、源、配置文件、故障排除 | [用户指南](./docs/user-guide/getting-started.md) |
| **作者** | 创建、验证和发布提示集合 | [作者指南](./docs/author-guide/creating-source-bundle.md) |
| **贡献者** | 开发设置、架构、测试、编码标准 | [贡献者指南](./docs/contributor-guide/development-setup.md) |
| **参考** | 命令、设置、适配器 API、中心架构 | [参考文档](./docs/reference/commands.md) |
→ [完整文档索引](./docs/README.md)
---
## 📦 安装
**从 VS Code 市场:**
1. 打开 VS Code → 按 `Ctrl+Shift+X`
2. 搜索 "AI 原语中心" → 单击 **安装**
**从 VSIX:**
```bash
code --install-extension prompt-registry-0.0.2.vsix
```
**从源代码:**
```bash
git clone https://github.com/AmadeusITGroup/prompt-registry.git
cd prompt-registry
npm install
npm run package:vsix
code --install-extension prompt-registry-0.0.2.vsix
```
**适用于自定义 VS Code 实例**(具有自定义 user-data-dir/extensions-dir):
```bash
# 在构建上述 VSIX 后,安装到您的自定义 VS Code 实例
code --user-data-dir "$ud" --extensions-dir "$ed" --install-extension prompt-registry-0.0.2.vsix
```
---
## 🔌 支持的源
| 源类型 | 描述 |
|-------------|-------------|
| **Awesome Copilot** | 精选社区集合 |
| **GitHub** | 直接来自 GitHub 仓库 |
| **本地** | 文件系统目录 |
| **APM** | APM 包仓库 |
→ [源配置指南](./docs/user-guide/sources.md)
---
## 🏗️ 架构概述
```
市场/树视图 → 注册表管理器 → 适配器(GitHub、本地等)
↓
软件包安装程序 → Copilot 同步
```
→ [完整架构文档](./docs/contributor-guide/architecture.md)
---
## 🔧 故障排除
**Copilot 中未显示软件包?**
- 在扩展程序日志中检查同步是否完成
- 运行 "AI 原语中心:同步所有软件包"
- 重启 VS Code(`Ctrl+R`)
**安装失败?**
- 验证网络连接和仓库访问
- 检查软件包是否具有有效的 `deployment-manifest.yml`
→ [完整故障排除指南](./docs/user-guide/troubleshooting.md)
---
## 🤝 贡献
我们欢迎贡献!请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md) 获取指南。
→ [开发设置](./docs/contributor-guide/development-setup.md) | [编码标准](./docs/contributor-guide/coding-standards.md)
---
## 📄 许可证
[Apache 2.0](./LICENSE.txt) — 请参阅 [SECURITY.md](./SECURITY.md) 获取安全策略。
---
## 🙏 致谢
- **微软** - 感谢 GitHub Copilot 和 VS Code
- **Awesome Copilot 社区** - 感谢精选提示集合
- **贡献者** - 感谢所有为该项目做出贡献的人
---
## 🔗 链接
- [VS Code 市场](https://marketplace.visualstudio.com/items?itemName=AmadeusITGroup.prompt-registry)
- [GitHub 仓库](https://github.com/AmadeusITGroup/prompt-registry)
- [报告问题](https://github.com/AmadeusITGroup/prompt-registry/issues)
- [讨论](https://github.com/AmadeusITGroup/prompt-registry/discussions)