内容
# 一致性 AI 角色工作室
一个用于在多个场景中生成**相同角色**图像的仪表板，由
[WaveSpeed](https://wavespeed.ai) 和 [Higgsfield](https://higgsfield.ai) 提供支持，以及一个共享的提示 MCP 服务器，以便 Claude Code 可以构建与仪表板相同的提示。
## 为什么是这种形式
存在两种角色一致性机制，它们不可互换：
- **WaveSpeed LoRA** — 通过 WaveSpeed API 从 10-20 张图片的 zip 文件中训练。完全可自动化，因此仪表板可以端到端地创建这些。
- **Higgsfield Soul ID** — 在 Higgsfield 平台上从 20+ 张照片中训练。训练不在 WaveSpeed API 上公开，因此仪表板只能注册和使用您在 Higgsfield 上创建的 `soul_id`（或通过他们托管的 MCP）。
提示逻辑位于 `packages/prompt-kit` 中，被 **网页应用** 和 MCP 服务器导入，因此在浏览器中构建的提示与 Claude Code 构建的提示字节相同。
## 布局
```
apps/web/ Next.js 仪表板（服务器端 WaveSpeed 代理）
packages/wavespeed/ 类型化的 REST 客户端：提交 · 轮询 · 训练
packages/prompt-kit/ 确定性提示组合（无 LLM 调用）
servers/prompt-mcp/ MCP 服务器（stdio）封装 prompt-kit
```
## MCP 服务器
| 服务器 | 源代码 | 目的 |
|---|---|---|
| `prompt-mcp` | 此仓库 | 构建/验证角色提示 |
| `wavespeed-mcp` | `pip install wavespeed-mcp` | 来自 Claude Code 的临时生成 |
| `higgsfield` | `https://mcp.higgsfield.ai/mcp`（OAuth） | Soul ID 训练 |
参见 `.mcp.json`。提示 MCP 服务器**不调用**任何 LLM；Claude Code 是 LLM，服务器仅提供结构化组合和模型特定的语法。
## 设置
```bash
pnpm install
cp .env.local.example apps/web/.env.local # 填写 WaveSpeed + Supabase
pnpm test # 单元测试
pnpm dev # 仪表板 on :3000
```
