蓝湖设计稿分析
前置条件
lanhu MCP Server 已注册在 .claude/settings.json。首次使用需配置蓝湖 Cookie：
- 浏览器登录蓝湖 → F12 开发者工具 → Network → 复制请求头中的 Cookie
- 填入
.claude/settings.json 的 lanhu.env.LANHU_COOKIE
MCP 工具清单
| 工具 | 用途 | 输入 |
|---|
lanhu_resolve_invite_link | 解析蓝湖邀请链接 | 邀请链接 URL |
lanhu_get_pages | 获取原型文档页面列表+截图 | 含 docId 的蓝湖 URL |
lanhu_get_ai_analyze_page_result | AI 分析原型页面（开发/测试/探索视角） | 含 docId 的 URL + 页面名 + 模式 |
lanhu_get_designs | 获取 UI 设计图列表 | 不含 docId 的蓝湖 URL |
lanhu_get_ai_analyze_design_result | AI 分析设计图（含尺寸/颜色/CSS） | 不含 docId 的 URL + 设计图名 |
lanhu_get_design_slices | 提取设计稿切图资源 | 不含 docId 的 URL + 设计图名 |
lanhu_say | 发送团队留言 | URL + 内容 |
lanhu_say_list | 查询留言列表 | URL 或 'all' |
lanhu_say_detail | 查看留言详情 | 消息 ID |
lanhu_say_edit | 编辑留言 | URL + 消息 ID + 新内容 |
lanhu_say_delete | 删除留言 | URL + 消息 ID |
lanhu_get_members | 获取项目成员 | URL |
URL 类型区分（重要）
| URL 类型 | 特征 | 用于 |
|---|
| 原型文档 URL | 含 docId 参数 | lanhu_get_pages、lanhu_get_ai_analyze_page_result |
| 设计项目 URL | 不含 docId | lanhu_get_designs、lanhu_get_design_slices |
| 邀请链接 | lanhuapp.com/link/#/invite?sid=xxx | 先用 lanhu_resolve_invite_link 解析 |
典型工作流
1. 需求分析（与 analyze-requirements 联动）
收到蓝湖链接
│
├─ 邀请链接？ → lanhu_resolve_invite_link → 获取真实 URL
│
├─ 含 docId？（原型文档）
│ ├─ lanhu_get_pages → 获取页面列表和截图
│ └─ lanhu_get_ai_analyze_page_result(mode="development") → 获取字段/逻辑/流程
│
└─ 不含 docId？（设计项目）
├─ lanhu_get_designs → 获取设计图列表
└─ lanhu_get_ai_analyze_design_result → 获取尺寸/颜色/CSS
2. 前端开发（获取设计参数）
lanhu_get_designs → 查看设计图列表
→ lanhu_get_ai_analyze_design_result → 获取精确设计参数（尺寸/间距/颜色/字体）+ HTML+CSS 代码
→ lanhu_get_design_slices → 提取切图/图标资源
3. 分析模式选择
lanhu_get_ai_analyze_page_result 支持 3 种模式：
| 模式 | 关注点 | 适用场景 |
|---|
development | 字段规则、业务逻辑、全局流程图 | 后端/前端开发 |
testing | 测试场景、用例、边界值、校验规则 | 测试编写 |
exploration | 核心功能概览、模块依赖、评审要点 | 需求评审 |
与其他技能联动
| 场景 | 先用 lanhu-design | 再用 |
|---|
| 需求分析 | 获取原型截图和页面结构 | analyze-requirements 输出开发任务清单 |
| 前端开发 | 获取设计参数和切图 | ui-pc 实现页面 |
| 接口开发 | 从原型推导接口字段 | api-development / crud-development |
注意
- 蓝湖 Cookie 有效期有限，过期需重新获取
- 原型文档和设计项目使用不同的 URL 格式，工具不能混用
- 大型原型建议分页面分析，避免单次请求过大
- 与
analyze-requirements 的区别：本技能负责从蓝湖获取数据，analyze-requirements 负责分析数据输出任务
