内容
# 设计路由器 GPT-5.5 MCP
[](LICENSE)
设计路由器 GPT-5.5 MCP 是一个开源的 MCP 服务器和前端生成的包编译器。它接受产品简介，将其路由到精选的设计库，并返回一个包含布局方向、源代码支持的模式、实现约束和反复制规则的紧凑构建包。
它适用于可以编写代码但需要更清晰的设计上下文的编码代理。包与模型无关：可与 GPT-5.5 类代理、Codex 风格的编码代理或 Qwen 3.6 27B 类的强大开放/本地编码模型一起使用。输出不是主题、模板或截图克隆。它是一个结构化的简介，告诉模型使用哪个模式系列、适应哪些细节以及不能复制什么。
## 提供内容
- 用于 LM Studio、OpenCode、Codex 兼容客户端和其他代理运行时的 MCP 标准输入/输出服务器。
- 用于离线或脚本使用的 CLI 包编译器。
- 路由引擎，根据锚定包和支持库对前端简介进行评分。
- 具有从 `micro` 到较大源代码摘录的令牌模式的包渲染器。
- `goldensets/` 中的完整公共黄金集库以及 `src/design_router_mcp/goldensets/` 下的打包副本。
- 验证、捐赠者卫生、源代码摘录、路由替代和密度工具。
## 模型目标
设计路由器 GPT-5.5 MCP 不依赖于一个专有的模型。它是适用于任何可以遵循构建包并编写可用代码的模型的 frontend 上下文层。
良好的匹配包括：
- GPT-5.5 类编码代理；
- Codex 风格的存储库代理；
- 本地或开放编码模型，如 Qwen 3.6 27B；
- 使用 `token_mode: "micro"` 或 `token_mode: "compact"` 的小上下文模型；
- 使用 `code_profile: "code_first"` 和较大源代码摘录的更强大的代理。
## 为什么存在
通用模型倾向于将前端工作简化为相同的几个操作：柔和的渐变、超大尺寸的英雄、相等的卡片网格、发明的社会证明、弱表单和未检查的移动布局。设计路由器 GPT-5.5 MCP 修复了起始上下文。它为模型提供了一个更强大的设计系统，然后才编写代码。
当您希望生成的 UI 从强大的示例中继承真实结构而不窃取捐赠者网站的身份、复制、资产、推荐语或声明时，服务器尤其有用。
## 黄金集，而非复制集
黄金集是模式源。它们不是要克隆的页面。
包可以包括源代码摘录、组件结构、密度提示、章节排序、排版模式、交互状态和视觉规则。包还带有防护措施，告诉模型为目标简介编写新的页面复制品，并避免复制捐赠者的身份。
反复制层正是出于这个原因而存在的：
- 捐赠者的商业名称、电话号码、电子邮件、域名、评论、奖项和声明被视为不安全的目标页面材料；
- 源代码用于语气、层次和密度，而不是直接粘贴的原始文本；
- 光栅图像和外部资产 URL 被阻止，除非用户为目标构建提供资产；
- 生成的页面应使用新鲜的目标特定复制品、中立的占位符用于缺失的证明及其自身的视觉构图；
- 支持库示例用于三角测量布局模式，而不是重建一个捐赠者页面。
## 零镜头视觉证明
这些帧来自同一个演讲者公司提示运行的本地屏幕录制，运行零镜头。两个比较剪辑是第一次和第二次尝试，没有设计路由器包。选定的运行使用包引导的 MCP 流。这是第一次通过的方向的视觉证据，而不是正式的基准。
| 第一次尝试，无包 | 第二次尝试，无包 | 包引导运行 |
|---|---|---|
| <img src="docs/assets/zero-shot-proofs/baseline-try-1.jpg" alt="第一次零镜头演讲者公司尝试，无设计路由器包" width="260"> | <img src="docs/assets/zero-shot-proofs/baseline-try-2.jpg" alt="第二次零镜头演讲者公司尝试，无设计路由器包" width="260"> | <img src="docs/assets/zero-shot-proofs/mcp-good-01.jpg" alt="使用设计路由器 GPT-5.5 MCP 的包引导零镜头演讲者公司首页" width="260"> |
包引导运行将演讲者公司方向带过了英雄，进入更深的产品部分和查询流程：
<img src="docs/assets/zero-shot-proofs/mcp-good-02.jpg" alt="包引导的演讲者公司首页的内部部分" width="720">
## 安装
```bash
git clone https://github.com/alexalexalex222/design-router-gpt-5.5-mcp.git
cd design-router-gpt-5.5-mcp
python -m venv .venv
. .venv/bin/activate
pip install -e ".[dev,mcp]"
PYTHONPATH=src python -m design_router_mcp.cli --repo-root . validate
```
## CLI 使用
导出包：
```bash
PYTHONPATH=src python -m design_router_mcp.cli --repo-root . export \
--surface website.local_service \
--task "为一家严肃的武术健身房构建主页" \
--output-dir /tmp/design-router-gpt-5.5-mcp-packet \
--token-mode compact \
--stack html_css \
--code-profile code_first
```
导出写入：
```text
/tmp/design-router-gpt-5.5-mcp-packet/PACKET.md
/tmp/design-router-gpt-5.5-mcp-packet/SOURCES.json
```
将 `PACKET.md` 提供给将构建页面的编码代理。
有用的 CLI 命令：
```bash
PYTHONPATH=src python -m design_router_mcp.cli --repo-root . list
PYTHONPATH=src python -m design_router_mcp.cli --repo-root . validate
PYTHONPATH=src python -m design_router_mcp.cli --repo-root . hygiene --pack-id localhost_fullsite_pattern_bank_20260622_v1
```
## MCP 使用
在虚拟环境中安装包，然后将您的 MCP 客户端指向标准输入/输出入口点：
```json
{
"mcpServers": {
"design-router-gpt-5.5-mcp": {
"command": "/absolute/path/to/.venv/bin/design-router-gpt-5.5-mcp",
"args": ["--repo-root", "/absolute/path/to/design-router-gpt-5.5-mcp"]
}
}
}
```
主要工具：
```text
resolve_design_context
```
附加工具：
```text
inspect_design_library
get_source_excerpt
export_opencode_bundle
route_alternatives
donor_starvation_audit
code_density_metrics
audit_source_hygiene
validate_design_router
```
推荐的请求形状：
```json
{
"surface": "website.local_service",
"task": "为演讲者公司构建一个优质的主页",
"stack": "html_css",
"token_mode": "compact",
"code_profile": "code_first",
"packet_intent": "implementation_blueprint"
}
```
## 库内容
公共库目前包含 22 个路由包：
- 用于 SaaS 仪表盘、格斗运动、水服务、直播商务、开发者文档、奢侈品/编辑页面、产品/规格页面、交互式乐器、金融终端、园艺护理、法律/商业页面、橱柜、地板等本地服务表面的锚定包；
- 用于 GA SMB 页面结构和 2026-06-22 捕获的 localhost 完整站点模式库的支持库；
- 用于导航、英雄、卡片、表单、选项卡、常见问题解答、定价、统计数据、画廊、页脚和交互状态的共享原子。
## 验证
运行公共烟雾测试：
```bash
PYTHONPATH=src python -m pytest tests -q
```
验证设计库：
```bash
PYTHONPATH=src python -m design_router_mcp.cli --repo-root . validate
```
在更改包元数据或入口点时构建轮子：
```bash
python -m pip wheel . --no-deps -w /tmp/design-router-gpt-5.5-mcp-wheel
```
## 项目布局
```text
src/design_router_mcp/ 规范的 Python 包
goldensets/ 公共路由设计库
tests/ 公共烟雾测试
docs/eval-quality.md 质量和评估笔记
server.json MCP/服务器清单
CANONICAL_SOURCE.md 源代码树边界笔记
MIGRATION.md 清理和迁移笔记
```
## 许可证
MIT。参见 `LICENSE`。
