lanhu-design-mcp 0.2.2 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -20
- package/dist/index.js +19 -30
- package/package.json +2 -5
package/README.md
CHANGED
|
@@ -1,14 +1,15 @@
|
|
|
1
1
|
# lanhu-design-mcp
|
|
2
2
|
|
|
3
3
|
零依赖 stdio MCP server，让任意支持 MCP 的 coding Agent（Claude Code / Cursor / Trae /
|
|
4
|
-
opencode
|
|
4
|
+
opencode）直接读蓝湖设计稿做开发：
|
|
5
5
|
|
|
6
6
|
- **结构化图层树**：官方 API（Cookie 直调）取 x/y/宽高/色值/字号/圆角（含逐角）/描边/阴影/文本，精确数值来自结构化数据，**不靠视觉模型 OCR 截图小字**；
|
|
7
7
|
- **团队目录导航**：团队 → 项目 → 分组（需求）→ 设计稿完整层级，一次拉取、按需下钻；
|
|
8
8
|
- **切图下载**：单稿或分组批量，三层去重 + 字节级验真，直接落盘本地 assets；
|
|
9
|
-
-
|
|
9
|
+
- **视觉理解**：配置视觉模型后自动理解设计稿封面图语义（`visionAnalysis`）。
|
|
10
10
|
|
|
11
|
-
TypeScript + 官方 MCP SDK。你的 coding Agent 就是流水线里的"代码生成引擎"——本 MCP 只负责"读设计"
|
|
11
|
+
TypeScript + 官方 MCP SDK。你的 coding Agent 就是流水线里的"代码生成引擎"——本 MCP 只负责"读设计"；
|
|
12
|
+
实现完成后的验证（截图、比对、缺陷检查）由 Agent 用自己的浏览器与多模态能力完成，不经 MCP 中转。
|
|
12
13
|
|
|
13
14
|
## 环境要求
|
|
14
15
|
|
|
@@ -28,7 +29,7 @@ npm install && npm run build # esbuild 打包为单文件 dist/index.js
|
|
|
28
29
|
- **手动**：F12 → Network → 任意请求复制 `Cookie` 头整串，写入同一文件；
|
|
29
30
|
- 过期后重跑一次登录脚本即可，AI 检测到 401 时会提示你。
|
|
30
31
|
|
|
31
|
-
### 2. 视觉模型（analyze
|
|
32
|
+
### 2. 视觉模型（analyze 需要）
|
|
32
33
|
|
|
33
34
|
配置 `VLM_API_KEY`，可选 `VLM_BASE_URL` / `VLM_MODEL`（任何 OpenAI 兼容端点均可，默认 DeepSeek）。
|
|
34
35
|
配好后 `lanhu_fetch_design` **默认自动返回视觉理解**；想跳过传 `analyze:false`，或设 `LANHU_AUTO_ANALYZE=0` 全局关闭。
|
|
@@ -63,33 +64,18 @@ npm install && npm run build # esbuild 打包为单文件 dist/index.js
|
|
|
63
64
|
| `lanhu_read_sector` | 按分组列稿目录（稿名/尺寸/层数，不含图层树） |
|
|
64
65
|
| `lanhu_fetch_design` | 读单稿结构化图层树 + 视觉语义理解 |
|
|
65
66
|
| `lanhu_download_slices` | 切图下载到本地 assets（单稿 / 分组批量） |
|
|
66
|
-
| `lanhu_verify_spec` | 设计稿验收：图层树期望值 ↔ 页面计算样式逐字段 diff |
|
|
67
|
-
| `lanhu_verify_render` | 渲染页 vs 设计稿语义对比（主观线索） |
|
|
68
|
-
| `vision_defect_check` | 整页/局部 UI 缺陷检测（12 类） |
|
|
69
|
-
| `vision_e2e_triage` | E2E 失败截图 + DOM 归因 |
|
|
70
67
|
|
|
71
68
|
工具入参 schema 自描述，Agent 在工具列表里即可看到完整入参说明。
|
|
72
69
|
|
|
73
|
-
## 验收口径（H5 webview 项目）
|
|
74
|
-
|
|
75
|
-
`lanhu_verify_spec` 验收 webview 内嵌页时，以下差异属预期，会自动降级：
|
|
76
|
-
|
|
77
|
-
- **宽度严格、高度宽松**：`x` / 非文本层 `width` 严比；`y` / `height` 因状态栏与动态渲染整体偏移，降 `minor`；
|
|
78
|
-
- **状态栏不渲染**：稿顶状态栏层比对前剔除，整体竖直偏移记入 `offset`，不报缺陷；
|
|
79
|
-
- **文案语义接近即可**：文本差异降 `minor`；配视觉模型时做语义等价判定，确为不同含义才升 `major`；
|
|
80
|
-
- **前置去噪**：`opacity=0`、零尺寸、蒙版/标注/备份组、占位切图等无效层不参与比对；
|
|
81
|
-
- **背景回退**：叶子节点背景透明时向上回退 3 级祖先背景色，未命中封顶 `major`。
|
|
82
|
-
|
|
83
70
|
## 环境变量
|
|
84
71
|
|
|
85
72
|
| 变量 | 必填 | 默认 | 说明 |
|
|
86
73
|
|---|---|---|---|
|
|
87
|
-
| `VLM_API_KEY` | analyze
|
|
74
|
+
| `VLM_API_KEY` | analyze 时必填 | — | 视觉模型 Key（须为对应平台签发，如 api.deepseek.com 需 DeepSeek key） |
|
|
88
75
|
| `VLM_BASE_URL` | 否 | `https://api.deepseek.com` | 任意 OpenAI 兼容端点 |
|
|
89
76
|
| `VLM_MODEL` | 否 | `deepseek-v4-flash-vision-exp` | 视觉模型名 |
|
|
90
77
|
| `LANHU_VISION_MAX_TOKENS` | 否 | `8192` | 输出上限（GLM 系模型因 thinking 计入预算，分支内默认 `16384`；设太小 JSON 会被半截截断） |
|
|
91
78
|
| `LANHU_VISION_TIMEOUT_MS` | 否 | `120000` | 单次视觉请求超时（毫秒） |
|
|
92
|
-
| `LANHU_VISION_MAX_EDGE` | 否 | `1568` | 入参图压缩最长边 |
|
|
93
79
|
| `LANHU_VISION_CACHE` | 否 | `1` | 设 `0` 关闭视觉结果缓存（`LANHU_VISION_CACHE_DIR` 可改目录） |
|
|
94
80
|
| `LANHU_AUTO_ANALYZE` | 否 | — | 设 `0` 关闭 fetch_design 自动视觉分析（视觉模型配齐时默认自动开） |
|
|
95
81
|
| `VISION_USE_V1` | 否 | — | 设 `0` 切到端点原生 `/chat/completions` |
|