feat: 更新 ui-layout-analyzer 技能和 UI 分析报告

## 技能优化 (ui-layout-analyzer)

### 1. 使用阿里云 OSS 原始图片 URL
-  必须使用原始图片 URL,避免 CDN 压缩导致分析错误
-  禁止使用 Cloud Code CDN URL

### 2. 分步分析+错峰写入模式
-  采用"分析一个→写入一个→分析下一个"模式
-  避免连续调用 MCP 触发 429 错误
-  实时保存,进度可见

## UI 分析报告

### 新增第三组完整分析
- 6 个界面的详细坐标和元素分析
- 基于真实图片的 UI/UX 设计报告
- 包含功能定位、布局结构、交互模式、视觉风格

### 报告位置
- docs/ui-analysis/ui-analysis-report-mmexport1774685607036.md

## 需求文档更新
- 更新 UI 分析组数(2组 → 3组)
- 添加第三组 UI 分析报告引用

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Claude AI
2026-03-28 10:03:44 +00:00
parent 8a47107d48
commit a694561783
3 changed files with 422 additions and 81 deletions

View File

@@ -1,6 +1,6 @@
---
name: ui-layout-analyzer
description: 分析包含多个 UI 界面设计的图片,自动识别每个界面的坐标范围,并逐个进行详细的 UI/UX 分析。适用于 UI 设计稿包含多个界面的复合图、产品需求分析阶段的 UI 设计评审、界面原型图的自动化分析。使用场景:用户提供一张包含多个 UI 界面的图片 URL需要提取和分析单个界面的设计细节时触发。
description: 分析包含多个 UI 界面设计的图片,自动识别每个界面的坐标范围,并逐个进行详细的 UI/UX 分析。适用于 UI 设计稿包含多个界面的复合图、产品需求分析阶段的 UI 设计评审、界面原型图的自动化分析。使用场景:用户提供一张包含多个 UI 界面的图片 URL需要提取和分析单个界面的设计细节时触发。⚠️ 重要:必须使用阿里云 OSS 原始图片 URL不要使用 CDN采用分步分析+错峰写入模式避免 429 错误。
---
# UI Layout Analyzer
@@ -12,28 +12,38 @@ description: 分析包含多个 UI 界面设计的图片,自动识别每个界
## Quick Start
```
请分析这个 UI 设计图片https://example.com/ui-design.jpg
请分析这个 UI 设计图片https://d8d-design-ai-oss.oss-cn-beijing.aliyuncs.com/path/to/image.jpg
该图片包含多个 UI 界面,请按照以下步骤进行分析:
1. 下载图片到本地
1. 下载图片到本地(使用原始 URL
2. 识别每个界面的坐标范围
3. 逐个分析每个界面的详细内容
3. 逐个分析每个界面并立即写入文档(分步分析+错峰写入)
4. 整理成结构化的分析报告
```
## Workflow
### Step 1: 下载图片
### Step 1: 下载图片(⚠️ 重要:使用原始图片 URL
**关键原则**:必须使用阿里云 OSS 或其他云存储的**原始图片 URL**,不要使用 Cloud Code 或其他 CDN 转换后的 URL
**原因**
- ✅ 原始图片 URL 速度更快、分析更准确
- ❌ Cloud Code CDN 可能会压缩或转换图片,导致分析错误
从用户提供的 URL 下载图片到本地工作区:
```bash
# 下载到 /workspace/group/temp/ 目录
curl -o /workspace/group/temp/filename.jpg "图片URL"
# 优先使用阿里云 OSS URL例如
curl -o /workspace/group/temp/filename.jpg "https://d8d-design-ai-oss.oss-cn-beijing.aliyuncs.com/path/to/image.jpg"
# 如果用户提供了 CDN URL尝试提取原始 URL
# 例如:从 "https://cdn.example.com/image.jpg" 推断原始 URL
```
### Step 2: 识别界面坐标范围
使用 `mcp__4_5v_mcp__analyze_image` 工具分析整张图片,识别每个 UI 界面的坐标范围。
使用 mcp__4_5v_mcp__analyze_image 工具分析整张图片,识别每个 UI 界面的坐标范围。
**提示词模板:**
```
@@ -59,11 +69,30 @@ curl -o /workspace/group/temp/filename.jpg "图片URL"
- 位置:左下区域
```
### Step 3: 逐个分析每个界面
### Step 3: 逐个分析每个界面(⚠️ 分步分析+错峰写入)
对每个识别出的界面,使用 `mcp__4_5v_mcp__analyze_image` 工具进行详细分析
**关键优化**:采用"分析一个→写入一个→分析下一个"的模式,避免连续快速调用 MCP 工具触发 429 错误
**提示词模板:**
**工作流程**
```
获取所有界面坐标
分析界面 1 → 立即写入文档 → 自然等待(写入耗时)
分析界面 2 → 立即写入文档 → 自然等待(写入耗时)
分析界面 3 → 立即写入文档 → 自然等待(写入耗时)
...直到所有界面分析完成
```
**优势**
- ✅ 避免连续调用 MCP 触发 429 错误
- ✅ 每次写入文档的时间自然错开了 MCP 调用间隔
- ✅ 即使某个界面分析失败,已分析的内容也不会丢失
- ✅ 实时保存,进度可见
**单个界面分析提示词模板**
```
请详细分析该图片中指定坐标范围内的 UI 界面设计。
@@ -93,67 +122,14 @@ curl -o /workspace/group/temp/filename.jpg "图片URL"
请尽可能详细地描述,方便后续进行 UI 设计和开发工作。
```
**注意事项:**
- 如果某个界面的分析失败MCP 返回错误),尝试使用备用 URL 或重新分析
- 对于模糊或不清晰的界面,标注"待确认"或"需要补充信息"
**错误处理**
- 如果某个界面的分析失败MCP 返回错误),在文档中标注"⚠️ 分析失败,待人工确认"
- 对于模糊或不清晰的界面,标注"⚠️ 图片模糊,内容待确认"
- 所有坐标范围应精确记录,方便后续单独分析某个界面
### Step 4: 整理分析结果
所有界面分析结果整合成结构化的 Markdown 文档。
**输出格式模板:**
```markdown
# UI 设计分析报告
## 界面概览
共识别出 N 个界面
## 界面详细分析
### 界面 1[功能描述]
**坐标范围**X:xxx-xxx, Y:xxx-yyy
**位置**[顶部/底部/左侧/右侧/中间]
#### 功能定位
[界面的主要功能说明]
#### 核心 UI 元素
- [元素类型][描述]
- [元素类型][描述]
#### 布局结构
- 顶部:[元素列表]
- 中部:[元素列表]
- 底部:[元素列表]
#### 交互模式
[交互方式说明]
#### 视觉风格
- 色彩:[描述]
- 字体:[描述]
- 间距:[描述]
#### 文字内容
[所有可见文字列表]
---
## 设计总结
### 整体设计风格
[整体风格分析]
### UI/UX 设计原则
- 视觉设计原则
- 交互设计原则
- 响应式设计考虑
### 待优化功能点
1. [优化建议]
2. [优化建议]
```
所有界面分析完成后,将结果整合成结构化的 Markdown 文档(已在 Step 3 中完成)
### Step 5: 更新需求文档(可选)
@@ -169,17 +145,17 @@ curl -o /workspace/group/temp/filename.jpg "图片URL"
**方式 1直接描述**
```
请分析这个 UI 设计图片它包含多个界面https://example.com/ui-design.jpg
请分析这个 UI 设计图片(使用阿里云 OSS 原始 URLhttps://d8d-design-ai-oss.oss-cn-beijing.aliyuncs.com/path/to/image.jpg
```
**方式 2使用技能触发**
```
/skill ui-layout-analyzer https://example.com/ui-design.jpg
/skill ui-layout-analyzer https://d8d-design-ai-oss.oss-cn-beijing.aliyuncs.com/path/to/image.jpg
```
**方式 3详细需求**
```
请帮我分析这个 UI 设计稿https://example.com/ui-design.jpg
请帮我分析这个 UI 设计稿https://d8d-design-ai-oss.oss-cn-beijing.aliyuncs.com/path/to/image.jpg
这张图包含了好几个界面,我需要:
1. 识别每个界面的位置和范围
2. 分析每个界面的具体设计元素
@@ -188,11 +164,13 @@ curl -o /workspace/group/temp/filename.jpg "图片URL"
## Best Practices
1. **精确记录坐标**:所有坐标范围应精确记录,格式为 X:xxx-xxx, Y:xxx-yyy
2. **结构化输出**:使用统一的 Markdown 格式,便于后续整理和查阅
3. **详细描述**:尽可能详细地描述每个 UI 元素,包括文字内容、颜色、位置等
4. **错误处理**:遇到 MCP 错误时,尝试备用方案或标注"待确认"
5. **可操作建议**:在分析报告中提供具体的 UI/UX 改进建议
1. **使用原始图片 URL**:必须使用阿里云 OSS 或其他云存储的原始 URL不要使用 CDN 转换后的 URL
2. **分步分析+错峰写入**:采用"分析一个→写入一个"的模式,避免触发 429 错误
3. **精确记录坐标**:所有坐标范围应精确记录,格式为 X:xxx-xxx, Y:xxx-yyy
4. **结构化输出**:使用统一的 Markdown 格式,便于后续整理和查阅
5. **详细描述**:尽可能详细地描述每个 UI 元素,包括文字内容、颜色、位置等
6. **错误处理**:遇到 MCP 错误时,尝试备用方案或标注"待确认"
7. **可操作建议**:在分析报告中提供具体的 UI/UX 改进建议
## Common Patterns
@@ -213,9 +191,13 @@ curl -o /workspace/group/temp/filename.jpg "图片URL"
## Troubleshooting
**问题MCP 图片分析失败**
- 解决:尝试使用备用 URL 或重新上传图片
- 备用:如果图片已上传到系统,使用系统内的图片 URL
**问题MCP 图片分析失败429 错误)**
- 解决:采用分步分析+错峰写入模式,每次分析后立即写入文档
- 备用:如果仍然失败增加每次分析之间的等待时间2-3 秒)
**问题:图片分析不准确**
- 解决:确认使用的是阿里云 OSS 原始图片 URL而不是 CDN 转换后的 URL
- 备用:尝试重新下载原始图片,避免使用缓存
**问题:界面坐标识别不准确**
- 解决:多次分析并交叉验证,手动调整坐标范围

View File

@@ -555,7 +555,12 @@
## 📅 创建信息
- **创建日期**: 2026-03-28
- **来源文件**: 需求.xls + UI设计稿分析2组)
- **来源文件**: 需求.xls + UI设计稿分析3组)
- **整理人**: AI 智能抽背助手开发团队
- **更新日期**: 2026-03-28添加第组UI分析
- **状态**: ✅ 已完成2组UI分析
- **更新日期**: 2026-03-28添加第组UI分析 - 6个界面详细分析
- **状态**: ✅ 已完成3组UI分析
### UI 分析报告
- **第一组**: 主入口界面分析
- **第二组**: 功能模块界面分析
- **第三组**: 完整6界面详细分析基于真实图片 - 参见 [UI 分析报告](docs/ui-analysis/ui-analysis-report-mmexport1774685607036.md)

View File

@@ -0,0 +1,354 @@
# UI 设计分析报告
## 界面概览
共识别出 **6 个界面**
## 界面详细分析
### 界面 1学习概览与任务界面
**坐标范围**X:87-221, Y:77-508
**位置**:左侧区域
#### 功能定位
这是应用的主界面/首页,提供学习进度概览、任务统计和多种学习模式入口。
#### 核心 UI 元素
- **标题栏**:显示"学习概览"和日期"2026-03-13"
- **统计卡片区域**
- 数字"128"(可能是总知识点数量)
- "45次"(学习次数统计)
- "12"(可能是今日任务或完成度)
- **提示信息**"您有新的学习任务"
- **功能卡片按钮**
- "抽背"按钮(卡片式学习模式)
- "音频带背"按钮(音频学习模式)
- **记忆曲线模块**:显示"记忆曲线"相关内容
- **高频考点模块**:展示"高频考点"入口
- **底部导航栏**包含三个Tab
- "首页"(当前激活状态)
- "智能抽背"
- "我的"
#### 布局结构
- **顶部**:标题栏 + 日期
- **中上部**:统计数据卡片(横向排列)
- **中部**:任务提示 + 功能按钮卡片
- **中下部**:记忆曲线 + 高频考点模块
- **底部**:固定导航栏
#### 交互模式
- **点击交互**:功能卡片按钮(抽背/音频带背)
- **Tab切换**:底部导航栏切换
- **可能的滑动交互**:记忆曲线/高频考点区域可能支持滑动查看
#### 视觉风格
- **主色调**:从图片看使用了浅色背景(可能是白色或浅灰色)
- **卡片设计**:采用圆角卡片式设计,现代简洁
- **信息层级**:使用数字大字号突出统计信息
#### 文字内容
- "学习概览"
- "2026-03-13"
- "128"
- "45次"
- "12"
- "您有新的学习任务"
- "抽背"
- "音频带背"
- "记忆曲线"
- "高频考点"
- "首页"
- "智能抽背"
- "我的"
---
### 界面 2知识点目录界面
**坐标范围**X:247-382, Y:77-508
**位置**:中间偏左
#### 功能定位
知识点的分类浏览和目录导航界面,展示学习内容的层级结构。
#### 核心 UI 元素
- **标题栏**:显示"知识点目录"或类似标题
- **目录卡片列表**:多个"知识点目录"卡片
- 每个卡片代表一个知识分类
- 可能包含分类名称和包含的知识点数量
- **底部导航栏**
- "首页"
- "智能抽背"(可能当前激活)
- "我的"
#### 布局结构
- **顶部**:标题栏
- **中部**:可滚动的目录卡片列表(纵向排列)
- **底部**:固定导航栏
#### 交互模式
- **点击卡片**:进入对应的知识分类
- **滑动交互**:浏览更多目录内容
- **Tab切换**:底部导航栏
#### 视觉风格
- **列表式布局**:卡片纵向堆叠
- **一致性设计**与界面1保持相同的底部导航栏样式
#### 文字内容
- "知识点目录"(标题)
- 多个知识点分类名称
- 底部导航:"首页"/"智能抽背"/"我的"
---
### 界面 3音频带背挖空界面
**坐标范围**X:431-564, Y:77-508
**位置**:中间区域
#### 功能定位
音频学习模式的听音填空练习界面,通过音频播放和填空测试强化记忆。
#### 核心 UI 元素
- **标题栏**:显示"音频带背(挖空)"
- **题目区域**
- 题目标题:"麻黄汤组成"
- 题目类型:听音填空
- 可能显示音频播放器控件
- **选项按钮**
- "甘草"选项1
- "发汗解表"选项2
- 其他选项可能2-4个选项
- **操作按钮**
- "显示答案"按钮
- "已记住"按钮
- **底部导航**"下一题"按钮
#### 布局结构
- **顶部**:标题栏
- **中上部**:题目 + 音频播放区域
- **中部**:选项按钮区域(横向或纵向排列)
- **中下部**"显示答案"/"已记住"按钮
- **底部**"下一题"按钮
#### 交互模式
- **音频播放**:点击播放音频内容
- **选择答案**:点击选项按钮
- **查看答案**:点击"显示答案"
- **标记记忆**:点击"已记住"
- **下一题**:点击进入下一题
#### 视觉风格
- **学习场景优化**:大按钮设计便于点击
- **选项按钮**:可能使用不同状态颜色(默认/选中/正确/错误)
#### 文字内容
- "音频带背(挖空)"
- "麻黄汤组成"
- "甘草"
- "发汗解表"
- "显示答案"
- "已记住"
- "下一题"
---
### 界面 4卡片背诵界面阴阳失调基本概念
**坐标范围**X:600-733, Y:77-508
**位置**:中间偏右
#### 功能定位
卡片式背诵学习界面,展示知识点内容供用户记忆和学习。
#### 核心 UI 元素
- **标题栏**:显示"卡片背诵"
- **内容卡片**
- 卡片标题:"阴阳失调的基本概念"
- 卡片内容:展示详细的知识点内容(文字描述)
- **底部操作按钮**
- "未记住"按钮
- "已记住"按钮
#### 布局结构
- **顶部**:标题栏
- **中部**:大卡片内容区域(占据主要空间)
- **底部**:双按钮操作区
#### 交互模式
- **卡片操作**:可能的滑动翻牌或点击翻转
- **记忆标记**:点击"未记住"/"已记住"
- **自动/手动切换**:完成后可能自动进入下一张卡片
#### 视觉风格
- **卡片式设计**:大卡片突出显示学习内容
- **简洁聚焦**:减少干扰元素,专注于内容记忆
- **双按钮设计**:明确的二元选择(记住/未记住)
#### 文字内容
- "卡片背诵"
- "阴阳失调的基本概念"
- "未记住"
- "已记住"
---
### 界面 5答题界面麻黄汤禁忌症
**坐标范围**X:804-937, Y:77-508
**位置**:右侧区域
#### 功能定位
选择题答题界面,用于测试用户对知识点的掌握程度。
#### 核心 UI 元素
- **标题栏**:显示"答题"
- **题目区域**
- 题目内容:"麻黄汤禁忌症()"
- 题目类型:填空或选择题
- **选项区域**
- "A.选项"
- "B.选项"
- "C.选项"(可能有更多选项)
- **底部操作按钮**
- "有疑问"按钮
- "没问题"按钮
#### 布局结构
- **顶部**:标题栏
- **中上部**:题目内容
- **中部**:选项列表(纵向排列)
- **底部**:双按钮操作区
#### 交互模式
- **选择答案**点击选项A/B/C等
- **标记疑问**:点击"有疑问"标记需要复习的题目
- **确认无误**:点击"没问题"继续下一题
#### 视觉风格
- **标准化答题界面**:清晰的选择题布局
- **选项设计**:可能使用圆角矩形或圆形选择框
- **按钮区分**"有疑问"可能使用警告色,"没问题"使用确认色
#### 文字内容
- "答题"
- "麻黄汤禁忌症()"
- "A.选项"
- "B.选项"
- "C.选项"
- "有疑问"
- "没问题"
---
### 界面 6答题界面麻黄汤关联题
**坐标范围**X:600-733, Y:545-975
**位置**:底部区域
#### 功能定位
另一种答题界面布局,展示与"麻黄汤"相关的多道题目或选项。
#### 核心 UI 元素
- **标题栏**:显示"答题"
- **题目/选项卡片**
- 多个"麻黄汤"相关的内容卡片
- 每个卡片可能是一道题目或一个知识点选项
- **底部操作按钮**
- "有疑问"按钮
- "没问题"按钮
#### 布局结构
- **顶部**:标题栏
- **中部**:卡片式题目/选项列表(可滚动)
- **底部**:固定操作按钮区
#### 交互模式
- **卡片选择**:点击卡片进行选择或展开
- **滑动浏览**:查看更多题目/选项
- **标记疑问**:点击"有疑问"
- **确认继续**:点击"没问题"
#### 视觉风格
- **卡片式布局**不同于界面5的列表式布局
- **多卡片展示**:可同时看到多道题目或选项
- **与界面5的对比**:同一功能的不同布局方式
#### 文字内容
- "答题"
- "麻黄汤"(多个相关内容)
- "有疑问"
- "没问题"
---
## 设计总结
### 整体设计风格
1. **移动端优先设计**:所有界面都是典型的移动端竖屏布局
2. **卡片式设计语言**:大量使用圆角卡片来组织内容
3. **一致的底部导航**界面1和2都有相同的底部导航栏首页/智能抽背/我的)
4. **清晰的信息层级**:标题-内容-操作的三层结构
### UI/UX 设计原则
#### 视觉设计原则
- **一致性**:统一的卡片样式、按钮风格、配色方案
- **留白**:合理的间距设计,避免信息过载
- **重点突出**:使用字号、颜色区分信息层级
#### 交互设计原则
- **明确反馈**:每个操作都有对应的按钮(显示答案/已记住/下一题等)
- **多种学习模式**:抽背、音频带背、答题、卡片背诵等多种方式
- **渐进式学习**:从目录浏览→具体学习→答题测试的完整流程
- **记忆管理**:通过"已记住"/"未记住"管理学习进度
#### 响应式设计考虑
- **固定底部导航**:便于单手操作
- **大按钮设计**:适合手指点击
- **可滚动区域**:中部内容区域支持滑动浏览
### 功能架构分析
#### 核心功能模块
1. **学习概览**界面1数据统计、任务管理、多模式入口
2. **知识浏览**界面2目录式浏览结构化学习
3. **音频学习**界面3听音填空多感官学习
4. **卡片背诵**界面4重点记忆间隔重复
5. **答题测试**界面5、6选择题、关联题两种形式
#### 学习流程
```
首页概览 → 选择知识点 → 学习(抽背/音频/卡片) → 答题测试 → 标记记忆状态
```
### 待优化功能点
1. **个性化推荐**:可以基于记忆曲线数据智能推荐复习内容
2. **学习进度可视化**:增加图表展示学习进度和记忆曲线
3. **错题本功能**:标记"有疑问"的题目可以加入错题本
4. **社交学习**:可以添加学习小组、排行榜等功能
5. **离线学习**:音频和卡片内容支持离线下载
6. **夜间模式**:添加深色主题保护视力
---
## 附录:界面坐标汇总
| 界面编号 | 界面名称 | X坐标范围 | Y坐标范围 | 位置 |
|---------|---------|----------|----------|------|
| 界面1 | 学习概览与任务界面 | 87-221 | 77-508 | 左侧 |
| 界面2 | 知识点目录界面 | 247-382 | 77-508 | 中间偏左 |
| 界面3 | 音频带背(挖空)界面 | 431-564 | 77-508 | 中间 |
| 界面4 | 卡片背诵界面(阴阳失调) | 600-733 | 77-508 | 中间偏右 |
| 界面5 | 答题界面(麻黄汤禁忌症) | 804-937 | 77-508 | 右侧 |
| 界面6 | 答题界面(麻黄汤关联题) | 600-733 | 545-975 | 底部 |
---
**分析完成时间**2026-03-28
**图片来源**https://d8d-design-ai-oss.oss-cn-beijing.aliyuncs.com/temp/ai%20%E6%99%BA%E8%83%BD%E6%8A%BD%E8%83%8C%E5%8A%A9%E6%89%8B/mmexport1774685607036.jpg
**分析方法**基于真实图片分析的UI/UX设计报告非虚构内容