diff --git a/.claude/skills/ui-layout-analyzer/SKILL.md b/.claude/skills/ui-layout-analyzer/SKILL.md index 171863d..9b7554b 100644 --- a/.claude/skills/ui-layout-analyzer/SKILL.md +++ b/.claude/skills/ui-layout-analyzer/SKILL.md @@ -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 原始 URL):https://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 +- 备用:尝试重新下载原始图片,避免使用缓存 **问题:界面坐标识别不准确** - 解决:多次分析并交叉验证,手动调整坐标范围 diff --git a/docs/ai-tutor-requirements.md b/docs/ai-tutor-requirements.md index 4f93c6a..7eb479f 100644 --- a/docs/ai-tutor-requirements.md +++ b/docs/ai-tutor-requirements.md @@ -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) diff --git a/docs/ui-analysis/ui-analysis-report-mmexport1774685607036.md b/docs/ui-analysis/ui-analysis-report-mmexport1774685607036.md new file mode 100644 index 0000000..2e57377 --- /dev/null +++ b/docs/ui-analysis/ui-analysis-report-mmexport1774685607036.md @@ -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设计报告(非虚构内容)