内容
# PromptBridge007
<p align="center">
<strong>编写一次，随处部署。</strong><br>
跨平台 AI 提示词管理系统 — 转换、部署和同步提示词，支持 24 种 AI 编码工具。
</p>
<p align="center">
<a href="#功能特点">功能特点</a> •
<a href="#支持的工具">支持的工具</a> •
<a href="#快速入门">快速入门</a> •
<a href="#架构">架构</a> •
<a href="#命令行界面">命令行界面</a> •
<a href="#MCP 服务器">MCP 服务器</a> •
<a href="#许可证">许可证</a>
</p>
---
## 功能特点
- **格式转换** — 在 24 种 AI 工具格式之间转换提示词（Cursor MDC、Claude Code、GitHub Copilot、Windsurf 等）
- **一键部署** — 将提示词部署到任何支持的工具，支持三种模式：原始、自定义、增量
- **双向同步** — 将提示词推送到/从工具目录中，并具有冲突检测功能
- **环境扫描** — 自动检测已安装的 AI 工具并导入现有的提示词文件
- **公共库同步** — 克隆和导入社区提示词仓库（例如 [CL4R1T4S](https://github.com/elder-plinius/CL4R1T4S)）
- **MCP 服务器** — 让 AI 助手通过 Model Context Protocol 搜索、部署和管理提示词
- **命令行界面** — 完整的命令行界面，用于自动化和脚本编写
- **Web UI** — Next.js 仪表板，用于可视化提示词管理
- **多项目** — 跨多个项目目录管理提示词
- **监视模式** — 自动检测工具目录中的文件更改
- **语义搜索** — TF-IDF 评分 + 基于标签的相似性搜索
## 支持的工具
| 国际版 | 国内版 (中国) |
|---|---|
| Cursor | Kimi Code |
| Claude Code | Doubao (豆包) |
| GitHub Copilot | Qwen Code (通义灵码) |
| Windsurf | Coze (扣子) |
| Aider | GLM (智谱) |
| Gemini CLI | Tiangong AI (天工) |
| Codex (OpenAI) | DeepSeek Coder |
| OpenCode | Spark Code (星火代码) |
| Trae | Yuanbao (腾讯元宝) |
| Amp | |
| Kiro | |
| Replit | |
| Warp | |
| OpenClaw | |
## 快速入门
### 前置条件
- Node.js 18+
- npm 或 pnpm
### 安装
```bash
git clone https://github.com/superaimagic/PromptBridge007.git
cd PromptBridge007/web
npm install
```
### 开发
```bash
npm run dev
```
在 http://localhost:3000 打开 — 入门向导将指导您完成设置。
### 命令行界面
```bash
# 扫描已安装的 AI 工具
npx tsx src/cli/index.ts scan
# 列出所有提示词
npx tsx src/cli/index.ts list
# 将提示词部署到 Cursor
npx tsx src/cli/index.ts deploy <file-id> cursor
# 搜索提示词
npx tsx src/cli/index.ts search "security"
# 转换格式
npx tsx src/cli/index.ts convert <file-id> to_cursor
# 与工具同步
npx tsx src/cli/index.ts sync cursor
# 列出支持的工具
npx tsx src/cli/index.ts tools
```
## 架构
```
┌─────────────────────────────────────────────┐
│ Next.js 16 (App Router) + Hono API │
│ ┌──────────┐ ┌──────────┐ ┌───────────┐ │
│ │ Landing │ │ /app/* │ │ /api/* │ │
│ │ Page │ │ (SPA) │ │ (Hono) │ │
│ └──────────┘ └──────────┘ └─────┬─────┘ │
│ │ │
│ ┌──────────────────────────────────▼─────┐ │
│ │ 核心引擎 │ │
│ │ ToolRegistry │ FormatMatrix │ │
│ │ ScanEngine │ DeployEngine │ │
│ │ SyncEngine │ PublicSyncEngine │ │
│ │ WatchEngine │ SearchEngine │ │
│ └──────────────────────────────────┬─────┘ │
│ │ │
│ ┌──────────────────────────────────▼─────┐ │
│ │ SQLite (libsql) + Drizzle ORM │ │
│ └────────────────────────────────────────┘ │
│ │ │
│ ┌──────────────────────────────────▼─────┐ │
│ │ MCP 服务器 (stdio + HTTP) │ │
│ │ 8 工具 + 4 资源 │ │
│ └────────────────────────────────────────┘ │
└─────────────────────────────────────────────┘
```
### 核心引擎
| 引擎 | 描述 |
|--------|-------------|
| **FormatMatrix** | 在 PIF（Prompt Internal Format）和 24 种工具特定格式之间转换 |
| **ScanEngine** | 检测已安装的 AI 工具并导入现有的提示词文件 |
| **DeployEngine** | 将提示词部署到目标工具目录，支持三种模式 |
| **SyncEngine** | 数据库和工具目录之间的双向同步 |
| **PublicSyncEngine** | 从社区提示词仓库克隆/拉取 |
| **WatchEngine** | 监视工具目录的文件更改 |
| **SearchEngine** | TF-IDF 评分 + 基于标签的相似性搜索 |
## MCP 服务器
PromptBridge007 包含一个 MCP 服务器，允许 AI 助手直接访问您的提示词库。
### 工具
| 工具 | 描述 |
|------|-------------|
| `search_prompts` | 按关键词、标签或格式搜索提示词 |
| `get_prompt` | 获取特定提示词，可选格式转换 |
| `deploy_prompt` | 将提示词部署到目标 AI 工具 |
| `convert_format` | 将提示词转换为目标格式 |
| `scan_environment` | 扫描已安装的 AI 工具 |
| `sync_tool` | 与工具目录同步提示词 |
| `list_tools` | 列出所有支持的 AI 工具 |
| `suggest_similar` | 根据标签查找相似提示词 |
### 资源
| 资源 | 描述 |
|----------|-------------|
| `prompt-library://catalog` | 完整的提示词目录 |
| `prompt-library://tools` | 支持的工具列表 |
| `prompt-library://formats` | 可用的格式转换 |
| `prompt-library://stats` | 库统计信息 |
### 与 Claude Desktop / Cursor 配合使用
将以下内容添加到您的 MCP 配置中：
```json
{
"mcpServers": {
"promptbridge007": {
"command": "npx",
"args": ["tsx", "path/to/PromptBridge007/web/src/mcp/server.ts"]
}
}
}
```
或使用 HTTP 端点：`http://localhost:3000/api/mcp/*`
## API
所有功能均可通过 `/api/*` 处的 REST API 访问：
| 端点 | 方法 | 描述 |
|----------|--------|-------------|
| `/api/init` | POST | 初始化数据库 |
| `/api/projects` | GET/POST | 管理项目 |
| `/api/files` | GET/POST | 列出/创建提示词 |
| `/api/files/:id` | GET/PUT/DELETE | CRUD 单个提示词 |
| `/api/files/search` | POST | 搜索提示词 |
| `/api/tools` | GET | 列出支持的工具 |
| `/api/scan` | POST | 扫描环境 |
| `/api/deploy` | POST | 部署提示词 |
| `/api/sync/statuses` | GET | 获取同步状态 |
| `/api/sync/:tool_id` | POST | 与工具同步 |
| `/api/convert` | POST | 转换格式 |
| `/api/public-sources` | GET/POST | 管理公共仓库 |
| `/api/mcp/tools` | GET | 列出 MCP 工具 |
| `/api/mcp/execute` | POST | 执行 MCP 工具 |
## 项目结构
```
web/
├── src/
│ ├── app/ # Next.js App Router 页面
│ ├── cli/ # 命令行界面入口（pb007）
│ ├── components/ # React UI 组件
│ ├── lib/
│ │ ├── api/ # Hono API 路由
│ │ │ └── routes/ # 模块化路由文件
│ │ ├── core/ # 核心引擎
│ │ ├── db/ # 数据库模式和种子
│ │ └── stores/ # 状态管理
│ └── mcp/ # MCP 服务器
├── package.json
└── tsconfig.json
```
## 技术栈
- **前端**：Next.js 16，React 19，Tailwind CSS，Base UI
- **API**：Hono（嵌入在 Next.js 路由处理器中）
- **数据库**：SQLite（libsql），Drizzle ORM
- **MCP**：Model Context Protocol（stdio + HTTP）
- **命令行界面**：Commander.js
## 贡献
欢迎贡献！请随时提交拉取请求。
1. 分叉仓库
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 打开拉取请求
## 许可证
MIT 许可证 — 请参阅 [LICENSE](LICENSE) 获取详细信息。
## 致谢
- [CL4R1T4S](https://github.com/elder-plinius/CL4R1T4S) — AI 系统透明度项目
- [gray-matter](https://github.com/jonschlinkert/gray-matter) — 前置元数据解析
- [Drizzle ORM](https://orm.drizzle.team/) — TypeScript ORM
- [Hono](https://hono.dev/) — 快速 Web 框架
