asset-audit

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Asset Audit

资产审计

Analyze assets on a Webflow site for SEO optimization.
对Webflow站点的资产进行SEO优化分析。

Important Note

重要说明

ALWAYS use Webflow MCP tools for all operations:
  • Use Webflow MCP's
    asset_tool
    for fetching and updating assets
  • Use Webflow MCP's
    get_image_preview
    for analyzing image content
  • Use Webflow MCP's
    data_sites_tool
    with action
    list_sites
    for listing available sites
  • Use Webflow MCP's
    webflow_guide_tool
    to get best practices before starting
  • DO NOT use any other tools or methods for Webflow operations
  • All tool calls must include the required
    context
    parameter (15-25 words, third-person perspective)
所有操作必须使用Webflow MCP工具:
  • 使用Webflow MCP的
    asset_tool
    来获取和更新资产
  • 使用Webflow MCP的
    get_image_preview
    来分析图片内容
  • 使用Webflow MCP的
    data_sites_tool
    并指定动作
    list_sites
    来列出可用站点
  • 在开始操作前,使用Webflow MCP的
    webflow_guide_tool
    获取最佳实践
  • 不得使用任何其他工具或方法进行Webflow操作
  • 所有工具调用必须包含必填的
    context
    参数(15-25个单词,第三人称视角)

Instructions

操作步骤

Phase 1: Site Selection & Asset Discovery

阶段1:站点选择与资产发现

  1. Get site: Identify the target site. If user does not provide site ID, ask for it.
  2. Fetch all assets: Use Webflow MCP's
    asset_tool
    to get all assets from the site
    • For sites with 50+ assets, process in batches of 20
    • Show progress: "Processing assets 1-20 of 150..."
  3. Detect patterns: Analyze asset naming for common patterns:
    • Camera uploads (IMG_, DSC_, etc.)
    • Screenshots (screenshot, Screen Shot, etc.)
    • Generic names (untitled, image-1, etc.)
    • Date-based names (2024-01-10, etc.)
  1. 获取站点:确定目标站点。如果用户未提供站点ID,请向用户索要。
  2. 获取所有资产:使用Webflow MCP的
    asset_tool
    获取站点的所有资产
    • 对于资产数量≥50的站点,按20个一批进行处理
    • 显示进度:"正在处理第1-20个资产,共150个..."
  3. 检测命名模式:分析资产命名的常见模式:
    • 相机上传命名(IMG_、DSC_等)
    • 截图命名(screenshot、Screen Shot等)
    • 通用命名(untitled、image-1等)
    • 日期格式命名(2024-01-10等)

Phase 2: Issue Analysis & Pattern Recognition

阶段2:问题分析与模式识别

  1. Identify issues: List all assets which:
    • Do not have alt text set (null or empty string)
    • Have existing alt text but it's poor quality (too short, redundant phrases, etc.)
    • Do not have SEO-friendly asset names
    • Are duplicates or very similar
  2. Pattern detection report: Show detected patterns:
    🔍 Detected patterns:
    - 15 assets start with "IMG_" (camera uploads)
    - 8 assets contain "screenshot"
    - Suggest: Bulk rename these patterns
  3. Ask user preference: Ask if they want to generate:
    • Alt text only
    • SEO-friendly names only
    • Both
    • Apply naming pattern/template
  1. 识别问题:列出所有符合以下情况的资产:
    • 未设置alt text(值为null或空字符串)
    • 已设置alt text但质量不佳(过短、包含冗余短语等)
    • 资产名称不符合SEO友好性要求
    • 存在重复或高度相似的资产
  2. 模式检测报告:显示检测到的模式:
    🔍 检测到的模式:
    - 15个资产以"IMG_"开头(相机上传)
    - 8个资产包含"screenshot"
    - 建议:批量重命名这些模式的资产
  3. 询问用户偏好:询问用户希望生成:
    • 仅alt text
    • 仅SEO友好的名称
    • 两者都要
    • 应用命名模式/模板

Phase 3: Analysis & Suggestion Generation

阶段3:分析与优化建议生成

  1. Analyze assets: Use Webflow MCP's
    get_image_preview
    tool to analyze the assets that need updates
    • Error handling: If Webflow MCP's
      get_image_preview
      fails, use fallback:
      • Extract description from existing filename
      • Use generic placeholder with warning
      • Continue with other assets
    • Process in batches to avoid timeout
  2. Generate suggestions with validation:
    • Alt text validation:
      • Max 125 characters (warn if longer)
      • No redundant phrases ("image of", "picture of", "photo of")
      • Must end with punctuation
      • Flag generic descriptions (confidence < 50%)
    • SEO name validation:
      • Only lowercase a-z, 0-9, hyphens
      • No double extensions (.webp.webp) - strip existing extension first
      • Max 100 characters
      • Replace spaces/underscores with hyphens
      • No special characters
  3. Folder organization suggestions: If patterns detected, suggest folder structure:
    💡 Organization suggestions:
    - Create "team-photos" folder for 8 team images
    - Create "product-images" folder for 15 product shots
  1. 分析资产:使用Webflow MCP的
    get_image_preview
    工具分析需要更新的资产
    • 错误处理:如果Webflow MCP的
      get_image_preview
      工具调用失败,使用备用方案:
      • 从现有文件名中提取描述信息
      • 使用通用占位符并添加警告
      • 继续处理其他资产
    • 分批处理以避免超时
  2. 生成带验证的优化建议
    • Alt text验证
      • 最大长度为125个字符(过长时发出警告)
      • 不得包含冗余短语(如"image of"、"picture of"、"photo of")
      • 必须以标点符号结尾
      • 标记通用描述(置信度<50%)
    • SEO文件名验证
      • 仅允许小写a-z、0-9和连字符
      • 不得包含双重扩展名(如.webp.webp)- 先移除现有扩展名
      • 最大长度为100个字符
      • 将空格/下划线替换为连字符
      • 不得包含特殊字符
  3. 文件夹组织建议:如果检测到模式,建议文件夹结构:
    💡 组织建议:
    - 为8张团队图片创建"team-photos"文件夹
    - 为15张产品图片创建"product-images"文件夹

Phase 4: Granular Approval & Application

阶段4:精细化审批与应用

  1. Present suggestions with granular approval:
    • Show numbered list with checkboxes
    • Allow individual toggle: "Enter numbers to skip (e.g., '2,4')"
    • Options: "all", "none", or specific numbers
    • Show validation warnings for each suggestion
  2. Offer naming template (if many similar assets):
    🎨 Apply naming pattern?
    1. [category]-[description] (e.g., team-john-headshot)
    2. [description]-[location] (e.g., office-workspace-desk)
    3. Custom pattern...
    4. Skip patterns, use individual names
  3. Store rollback data: Before applying changes, store:
    • Original asset names
    • Original alt text
    • Timestamp
    • Assets modified
  4. Apply updates: Use Webflow MCP's
    asset_tool
    to update approved assets only
    • Show progress for batch updates
    • Handle partial failures gracefully
    • Report successes and failures separately
  5. Offer rollback option: After changes applied:
    📋 Rollback Available:
    Last update: 4 assets modified 2 minutes ago
    Type "undo" to revert these changes
  1. 展示带精细化审批的建议
    • 显示带复选框的编号列表
    • 允许单独跳过:"输入编号以跳过(例如:'2,4')"
    • 选项:"all"(全部)、"none"(全部跳过)或具体编号
    • 为每个建议显示验证警告
  2. 提供命名模板(如果存在大量相似资产):
    🎨 是否应用命名模式?
    1. [分类]-[描述](例如:team-john-headshot)
    2. [描述]-[位置](例如:office-workspace-desk)
    3. 自定义模式...
    4. 跳过模式,使用单独名称
  3. 存储回滚数据:在应用更改前,存储以下信息:
    • 原始资产名称
    • 原始alt text
    • 时间戳
    • 已修改的资产
  4. 应用更新:使用Webflow MCP的
    asset_tool
    仅更新已获批的资产
    • 显示批量更新的进度
    • 优雅处理部分失败的情况
    • 分别报告成功和失败的资产
  5. 提供回滚选项:应用更改后:
    📋 回滚可用:
    上次更新:2分钟前修改了4个资产
    输入"undo"以恢复这些更改

Examples

示例

User prompt:
Run an asset audit on my site.
Step 1: Initial Audit Report
📊 SEO Asset Audit: MCP Demo #2

Total: 4 assets

🔍 Detected patterns:
- 4 assets have generic numeric names (1.webp, 2.webp, 3.webp, 4.webp)
- All assets are in WebP format ✓

⚠️ Missing Alt Text (4 assets):
├── 1.webp (empty alt text)
├── 2.webp (empty alt text)
├── 3.webp (empty alt text)
└── 4.webp (empty alt text)

⚠️ Non-SEO-Friendly Names (4 assets):
├── 1.webp (generic numeric name)
├── 2.webp (generic numeric name)
├── 3.webp (generic numeric name)
└── 4.webp (generic numeric name)

---

What would you like to generate?
1. Alt text only
2. SEO-friendly names only
3. Both alt text and SEO-friendly names

Please select an option (1, 2, or 3).
Example with Validation Warnings:
📋 Suggested Improvements:

[1] ✓ IMG_1234.jpg
    Alt text: "Professional team member headshot with blue background."
    New name: professional-team-member-headshot.jpg
    ✅ Validation passed

[2] ✓ screenshot-2024.png
    Alt text: "Dashboard analytics overview showing user engagement metrics."
    New name: dashboard-analytics-overview.png
    ✅ Validation passed

[3] ⚠️ untitled-image.webp
    Alt text: "Photo"
    ⚠️ Warning: Alt text too short (< 10 chars) - needs more detail
    New name: untitled-image.webp
    ⚠️ Warning: Unable to generate better name (image preview failed)

[4] ⚠️ TeamPhoto2024!!!.jpg
    Alt text: "Image of a person working on laptop in modern office with plants and natural lighting through large windows in the background."
    ⚠️ Warning: Alt text too long (137 chars) - consider shortening for screen readers
    New name: team-photo-2024.jpg
    ✅ Validation passed (special characters removed)

Which assets would you like to update?
Step 2: After user selects option 3 and images are analyzed
📋 Suggested Improvements:

[1] ✓ 1.webp
    Alt text: "Podcast host with headphones and microphone recording Webflow podcast episode in studio."
    New name: webflow-podcast-host-recording-studio.webp
    ✅ Validation passed

[2] ✓ 2.webp
    Alt text: "Professional developer wearing glasses working on laptop with Webflow logo in modern office."
    New name: developer-working-laptop-webflow-office.webp
    ✅ Validation passed

[3] ✓ 3.webp
    Alt text: "Webflow homepage hero section with tagline and email signup form."
    New name: webflow-homepage-hero-section.webp
    ✅ Validation passed

[4] ✓ 4.webp
    Alt text: "Speaker presenting on stage at Webflow Conf with audience watching."
    New name: webflow-conf-speaker-presentation-stage.webp
    ✅ Validation passed

---

Which assets would you like to update?
- Type numbers to skip (e.g., "2,4" to skip items 2 and 4)
- Type "all" to proceed with all
- Type "none" to cancel
Step 3: After user confirms with "all"
🔄 Applying updates...

Progress: ████████████████████ 100% (4/4 assets)

✅ Updates Applied Successfully!

SEO Asset Audit Complete: MCP Demo #2

Summary:
- ✅ 4 assets updated successfully
- ❌ 0 assets failed
- ⏭️ 0 assets skipped

Changes Applied:
┌─────────────────────────────────────────────────────────────────┐
│ [1] webflow-podcast-host-recording-studio.webp                  │
│     ✓ Alt text added                                            │
│     ✓ Filename updated                                          │
├─────────────────────────────────────────────────────────────────┤
│ [2] developer-working-laptop-webflow-office.webp                │
│     ✓ Alt text added                                            │
│     ✓ Filename updated                                          │
├─────────────────────────────────────────────────────────────────┤
│ [3] webflow-homepage-hero-section.webp                          │
│     ✓ Alt text added                                            │
│     ✓ Filename updated                                          │
├─────────────────────────────────────────────────────────────────┤
│ [4] webflow-conf-speaker-presentation-stage.webp                │
│     ✓ Alt text added                                            │
│     ✓ Filename updated                                          │
└─────────────────────────────────────────────────────────────────┘

📋 Rollback Available:
Last update: 4 assets modified just now
Type "undo" to revert these changes

---

🎉 Your site's assets are now fully optimized for SEO and accessibility!
Alternative Step 3: User selects specific assets (e.g., "1,3")
🔄 Applying updates to assets 1 and 3...

Progress: ████████████████████ 100% (2/2 assets)

✅ Partial Update Complete!

Summary:
- ✅ 2 assets updated successfully
- ❌ 0 assets failed
- ⏭️ 2 assets skipped (as requested)

Changes Applied:
┌─────────────────────────────────────────────────────────────────┐
│ [1] webflow-podcast-host-recording-studio.webp                  │
│     ✓ Alt text added                                            │
│     ✓ Filename updated                                          │
├─────────────────────────────────────────────────────────────────┤
│ [3] webflow-homepage-hero-section.webp                          │
│     ✓ Alt text added                                            │
│     ✓ Filename updated                                          │
└─────────────────────────────────────────────────────────────────┘

Skipped Assets (can run audit again later):
- [2] 2.webp
- [4] 4.webp

📋 Rollback Available:
Type "undo" to revert these 2 changes
用户提示:
Run an asset audit on my site.
步骤1:初始审计报告
📊 SEO资产审计:MCP Demo #2

总计:4个资产

🔍 检测到的模式:
- 4个资产使用通用数字名称(1.webp、2.webp、3.webp、4.webp)
- 所有资产均为WebP格式 ✓

⚠️ 缺少Alt Text(4个资产):
├── 1.webp(空alt text)
├── 2.webp(空alt text)
├── 3.webp(空alt text)
└── 4.webp(空alt text)

⚠️ 非SEO友好名称(4个资产):
├── 1.webp(通用数字名称)
├── 2.webp(通用数字名称)
├── 3.webp(通用数字名称)
└── 4.webp(通用数字名称)

---

您希望生成什么?
1. 仅Alt text
2. 仅SEO友好名称
3. 同时生成Alt text和SEO友好名称

请选择一个选项(1、2或3)。
带验证警告的示例:
📋 优化建议:

[1] ✓ IMG_1234.jpg
    Alt text:"Professional team member headshot with blue background."
    新名称:professional-team-member-headshot.jpg
    ✅ 验证通过

[2] ✓ screenshot-2024.png
    Alt text:"Dashboard analytics overview showing user engagement metrics."
    新名称:dashboard-analytics-overview.png
    ✅ 验证通过

[3] ⚠️ untitled-image.webp
    Alt text:"Photo"
    ⚠️ 警告:Alt text过短(<10个字符)- 需要更详细的描述
    新名称:untitled-image.webp
    ⚠️ 警告:无法生成更优名称(图片预览失败)

[4] ⚠️ TeamPhoto2024!!!.jpg
    Alt text:"Image of a person working on laptop in modern office with plants and natural lighting through large windows in the background."
    ⚠️ 警告:Alt text过长(137个字符)- 考虑缩短以适配屏幕阅读器
    新名称:team-photo-2024.jpg
    ✅ 验证通过(已移除特殊字符)

您希望更新哪些资产?
步骤2:用户选择选项3并完成图片分析后
📋 优化建议:

[1] ✓ 1.webp
    Alt text:"Podcast host with headphones and microphone recording Webflow podcast episode in studio."
    新名称:webflow-podcast-host-recording-studio.webp
    ✅ 验证通过

[2] ✓ 2.webp
    Alt text:"Professional developer wearing glasses working on laptop with Webflow logo in modern office."
    新名称:developer-working-laptop-webflow-office.webp
    ✅ 验证通过

[3] ✓ 3.webp
    Alt text:"Webflow homepage hero section with tagline and email signup form."
    新名称:webflow-homepage-hero-section.webp
    ✅ 验证通过

[4] ✓ 4.webp
    Alt text:"Speaker presenting on stage at Webflow Conf with audience watching."
    新名称:webflow-conf-speaker-presentation-stage.webp
    ✅ 验证通过

---

您希望更新哪些资产?
- 输入编号以跳过(例如:"2,4"表示跳过第2和第4项)
- 输入"all"以全部更新
- 输入"none"以取消操作
步骤3:用户输入"all"确认后
🔄 正在应用更新...

进度:██████████████████████ 100%(4/4个资产)

✅ 更新已成功应用!

SEO资产审计完成:MCP Demo #2

摘要:
- ✅ 4个资产更新成功
- ❌ 0个资产更新失败
- ⏭️ 0个资产被跳过

已应用的更改:
┌─────────────────────────────────────────────────────────────────┐
│ [1] webflow-podcast-host-recording-studio.webp                  │
│     ✓ 已添加Alt text                                            │
│     ✓ 已更新文件名                                          │
├─────────────────────────────────────────────────────────────────┤
│ [2] developer-working-laptop-webflow-office.webp                │
│     ✓ 已添加Alt text                                            │
│     ✓ 已更新文件名                                          │
├─────────────────────────────────────────────────────────────────┤
│ [3] webflow-homepage-hero-section.webp                          │
│     ✓ 已添加Alt text                                            │
│     ✓ 已更新文件名                                          │
├─────────────────────────────────────────────────────────────────┤
│ [4] webflow-conf-speaker-presentation-stage.webp                │
│     ✓ 已添加Alt text                                            │
│     ✓ 已更新文件名                                          │
└─────────────────────────────────────────────────────────────────┘

📋 回滚可用:
上次更新:刚刚修改了4个资产
输入"undo"以恢复这些更改

---

🎉 您站点的资产现在已完全适配SEO和无障碍访问要求!
替代步骤3:用户选择特定资产(例如:"1,3")
🔄 正在为资产1和3应用更新...

进度:██████████████████████ 100%(2/2个资产)

✅ 部分更新完成!

摘要:
- ✅ 2个资产更新成功
- ❌ 0个资产更新失败
- ⏭️ 2个资产被跳过(按用户要求)

已应用的更改:
┌─────────────────────────────────────────────────────────────────┐
│ [1] webflow-podcast-host-recording-studio.webp                  │
│     ✓ 已添加Alt text                                            │
│     ✓ 已更新文件名                                          │
├─────────────────────────────────────────────────────────────────┤
│ [3] webflow-homepage-hero-section.webp                          │
│     ✓ 已添加Alt text                                            │
│     ✓ 已更新文件名                                          │
└─────────────────────────────────────────────────────────────────┘

被跳过的资产(可稍后重新运行审计):
- [2] 2.webp
- [4] 4.webp

📋 回滚可用:
输入"undo"以恢复这2项更改

Guidelines

指导原则

Phase 1: Critical Validations (Must Follow)

阶段1:关键验证(必须遵守)

File Extension Handling:
  • ALWAYS strip existing extension before adding new one
  • Bad:
    image.webp
    new-name.webp.webp
  • Good:
    image.webp
    new-name.webp
  • Implementation: Use filename without extension + new extension
Alt Text Quality Rules:
  • Max length: 125 characters (accessibility best practice)
  • Must end with punctuation (period, exclamation, question mark)
  • Remove redundant phrases:
    • ❌ "Image of a person" → ✅ "Person working at desk"
    • ❌ "Picture of logo" → ✅ "Company logo on blue background"
    • ❌ "Photo showing" → ✅ Direct description
  • Flag if too short (< 10 chars): ⚠️ "Too generic - needs more detail"
  • Flag if too long (> 125 chars): ⚠️ "Consider shortening for screen readers"
SEO Filename Rules:
  • Only allow: lowercase a-z, numbers 0-9, hyphens
  • Max length: 100 characters (before extension)
  • Convert spaces to hyphens:
    team photo
    team-photo
  • Convert underscores to hyphens:
    team_photo
    team-photo
  • Remove special characters:
    photo!@#$
    photo
  • Convert to lowercase:
    TeamPhoto
    team-photo
  • Remove consecutive hyphens:
    team--photo
    team-photo
  • Trim leading/trailing hyphens:
    -photo-
    photo
文件扩展名处理:
  • 必须先移除现有扩展名,再添加新扩展名
  • 错误示例:
    image.webp
    new-name.webp.webp
  • 正确示例:
    image.webp
    new-name.webp
  • 实现方式:使用不带扩展名的文件名 + 新扩展名
Alt文本质量规则:
  • 最大长度:125个字符(无障碍访问最佳实践)
  • 必须以标点符号结尾(句号、感叹号、问号)
  • 移除冗余短语:
    • ❌ "Image of a person" → ✅ "Person working at desk"
    • ❌ "Picture of logo" → ✅ "Company logo on blue background"
    • ❌ "Photo showing" → ✅ 直接描述
  • 过短(<10个字符)时标记警告:⚠️ "过于通用 - 需要更详细的描述"
  • 过长(>125个字符)时标记警告:⚠️ "考虑缩短以适配屏幕阅读器"
SEO文件名规则:
  • 仅允许:小写a-z、数字0-9、连字符
  • 最大长度:100个字符(不含扩展名)
  • 将空格转换为连字符:
    team photo
    team-photo
  • 将下划线转换为连字符:
    team_photo
    team-photo
  • 移除特殊字符:
    photo!@#$
    photo
  • 转换为小写:
    TeamPhoto
    team-photo
  • 移除连续连字符:
    team--photo
    team-photo
  • 移除首尾连字符:
    -photo-
    photo

Phase 2: Batch Processing & Performance

阶段2:批量处理与性能

Large Site Handling:
  • Sites with 50+ assets: Process in batches of 20
  • Show progress: "Processing batch 1 of 5 (assets 1-20)..."
  • Allow user to process specific batches
  • Timeout protection: If Webflow MCP's
    get_image_preview
    takes > 30s, skip to next batch
Pattern Detection: Detect and report these patterns:
  • Camera uploads:
    IMG_
    ,
    DSC_
    ,
    DCIM_
    ,
    P_
  • Screenshots:
    screenshot
    ,
    Screen Shot
    ,
    Capture
  • Generic names:
    untitled
    ,
    image-1
    ,
    photo
    ,
    asset
  • Date formats:
    2024-01-10
    ,
    20240110
    ,
    01-10-2024
  • Suggest bulk rename when 3+ assets match a pattern
Error Handling:
  • If Webflow MCP's
    get_image_preview
    fails:
    1. Log the error (don't show to user)
    2. Use fallback: Extract description from filename
    3. Mark with ⚠️ warning: "Generated from filename (image preview failed)"
    4. Continue with other assets
  • Partial success handling:
    • Report successes separately from failures
    • Show: "✅ 15 updated, ❌ 2 failed, ⏭️ 3 skipped"
    • Offer to retry failed assets
大型站点处理:
  • 资产数量≥50的站点:按20个一批处理
  • 显示进度:"正在处理第1批(共5批),资产1-20..."
  • 允许用户处理特定批次
  • 超时保护:如果Webflow MCP的
    get_image_preview
    调用耗时>30秒,跳过当前批次处理下一批
模式检测: 检测并报告以下模式:
  • 相机上传:
    IMG_
    DSC_
    DCIM_
    P_
  • 截图:
    screenshot
    Screen Shot
    Capture
  • 通用名称:
    untitled
    image-1
    photo
    asset
  • 日期格式:
    2024-01-10
    20240110
    01-10-2024
  • 当≥3个资产匹配某一模式时,建议批量重命名
错误处理:
  • 如果Webflow MCP的
    get_image_preview
    调用失败:
    1. 记录错误(不向用户显示)
    2. 使用备用方案:从文件名提取描述
    3. 标记警告⚠️:"从文件名生成(图片预览失败)"
    4. 继续处理其他资产
  • 部分成功处理:
    • 分别报告成功和失败的资产
    • 显示:"✅ 15个更新成功,❌ 2个更新失败,⏭️ 3个被跳过"
    • 提供重试失败资产的选项

Phase 3: Advanced Features

阶段3:高级功能

Granular Approval System:
  • Number each suggestion:
    [1]
    ,
    [2]
    ,
    [3]
    , etc.
  • Show checkmark status:
    or
  • Accept multiple formats:
    • "all" - approve all
    • "none" - cancel operation
    • "1,3,5" - skip items 1, 3, and 5
    • "2-5" - skip items 2 through 5
  • Always show validation status per item
Naming Templates: Offer templates when 5+ similar assets detected:
  1. [category]-[description]-[modifier]
    • Example:
      product-laptop-front-view.jpg
  2. [description]-[location]-[year]
    • Example:
      team-photo-office-2024.jpg
  3. [type]-[name]-[variant]
    • Example:
      icon-arrow-blue.svg
Folder Organization: Suggest folders when detecting:
  • 5+ images with "team", "staff", "employee" →
    team-photos
    folder
  • 5+ images with "product", "item" →
    product-images
    folder
  • 5+ images with "logo", "brand" →
    branding
    folder
  • 5+ images with "screenshot", "capture" →
    screenshots
    folder
Rollback System: Before any update, store in memory:
json
{
  "timestamp": "2026-01-10T00:45:00Z",
  "assets": [
    {
      "id": "asset-id",
      "originalName": "1.webp",
      "originalAltText": "",
      "newName": "podcast-host.webp",
      "newAltText": "Podcast host recording..."
    }
  ]
}
  • Offer undo for 5 minutes after changes
  • Clear rollback data after next audit starts
  • Show rollback option in final summary
Duplicate Detection:
  • Compare asset sizes (exact match = likely duplicate)
  • Compare filenames (similar names = potential duplicate)
  • Report: "⚠️ Potential duplicates: asset1.jpg (2.4MB) and asset1-copy.jpg (2.4MB)"
  • Don't auto-delete - let user decide
精细化审批系统:
  • 为每个建议编号:
    [1]
    [2]
    [3]
  • 显示勾选状态:
  • 支持多种输入格式:
    • "all" - 批准所有建议
    • "none" - 取消操作
    • "1,3,5" - 跳过第1、3、5项
    • "2-5" - 跳过第2至第5项
  • 始终显示每个项目的验证状态
命名模板: 当检测到≥5个相似资产时,提供模板:
  1. [category]-[description]-[modifier]
    • 示例:
      product-laptop-front-view.jpg
  2. [description]-[location]-[year]
    • 示例:
      team-photo-office-2024.jpg
  3. [type]-[name]-[variant]
    • 示例:
      icon-arrow-blue.svg
文件夹组织: 当检测到以下情况时建议创建文件夹:
  • ≥5张包含"team"、"staff"、"employee"的图片 →
    team-photos
    文件夹
  • ≥5张包含"product"、"item"的图片 →
    product-images
    文件夹
  • ≥5张包含"logo"、"brand"的图片 →
    branding
    文件夹
  • ≥5张包含"screenshot"、"capture"的图片 →
    screenshots
    文件夹
回滚系统: 在进行任何更新前,将以下信息存储在内存中:
json
{
  "timestamp": "2026-01-10T00:45:00Z",
  "assets": [
    {
      "id": "asset-id",
      "originalName": "1.webp",
      "originalAltText": "",
      "newName": "podcast-host.webp",
      "newAltText": "Podcast host recording..."
    }
  ]
}
  • 更改后5分钟内提供撤销选项
  • 下次审计开始时清除回滚数据
  • 在最终摘要中显示回滚选项
重复资产检测:
  • 比较资产大小(完全匹配则可能为重复资产)
  • 比较文件名(名称相似则可能为重复资产)
  • 报告:"⚠️ 潜在重复资产:asset1.jpg(2.4MB)和asset1-copy.jpg(2.4MB)"
  • 不自动删除 - 由用户决定

General Best Practices

通用最佳实践

  • Always use Webflow MCP's
    get_image_preview
    to understand image content
  • Generate specific, descriptive suggestions (not generic)
  • Validate all suggestions before presenting to user
  • Handle partial operations gracefully
  • Provide clear progress indicators for long operations
  • Group similar issues together in reports
  • Use visual indicators: ✅ ⚠️ ❌ 🔍 💡 📋 🎉
  • Be conversational but concise
  • Always offer rollback after changes
  • 始终使用Webflow MCP的
    get_image_preview
    来理解图片内容
  • 生成具体、有描述性的建议(而非通用建议)
  • 向用户展示前先验证所有建议
  • 优雅处理部分操作失败的情况
  • 为耗时较长的操作提供清晰的进度指示
  • 在报告中将相似问题分组展示
  • 使用视觉指示器:✅ ⚠️ ❌ 🔍 💡 📋 🎉
  • 保持对话式但简洁的风格
  • 更改后始终提供回滚选项