用最强梯队的agent项目尝试做人类艺术长廊项目的问题记录与解决方案全档案

写在前面的话

1月初我的一个想法“用目前“号称最强”的Agent平台做一个人类艺术作品展示，看看他们能否做到：收集、整理、归纳、分析、借鉴美术风格生成新的画作”。然后就有了这个项目，目前磕磕绊绊的做着，感谢所有观众不会催我赶紧做完。
本期文章就是对这个项目有个阶段性小结，整体来看youmind的审美和执行能力不错，最好的一点就是反思能力很好，它能自己归因自己是因为什么做不到，并且给出行之有效的建议和方法。manus？不好意思最开始的收集就陷入无限循环，300美元出去了，啥都没有。
并且这篇文章也是youmind自己总结了我的所有对话、资料后辅助我来写出的总结报告。

1. 项目概述

项目名称：人类艺术长廊（Human Art Gallery）
项目目标：甄选人类历史上的100幅绘画杰作，构建一个集高清图像、历史背景、艺术技法解析及AI绘画提示词（Prompt）于一体的数字化知识库与展示网页。
当前状态：进行中（已完成001-060批次整理，061-080批次进行中，网页端经历重构）。

本文档旨在如实记录项目执行过程中遇到的所有阻碍、错误决策及最终解决方案，作为项目复盘与后续工作的避坑指南。

2. 问题分类索引

分类	问题编号	问题简述	严重等级	状态
网页生成	WEB-001	过度设计导致的页面加载失败	🔴 致命	✅ 已解决
网页生成	WEB-002	违背用户指令使用Emoji	🟠 严重	✅ 已解决
网页生成	WEB-003	核心功能（图片）缺失	🔴 致命	✅ 已解决
技术规范	TECH-001	图片Markdown语法非标准导致渲染失败	🔴 致命	✅ 已解决
技术规范	TECH-002	工具对Wikimedia URL的兼容性限制	🟡 中等	🔄 规避中
内容质量	CONT-001	041-060批次部分模块（英文Prompt/技法）缺失	🟠 严重	✅ 已解决
内容质量	CONT-002	061-080批次源数据与框架不一致	🟡 中等	🔄 处理中

3. 详细问题记录

🏗️ 网页生成与架构问题

WEB-001：过度设计（Over-engineering）危机

发现时间：网页开发初期
问题描述：在接到制作"20件艺术作品展示网页"的需求时，盲目追求复杂功能（时间轴、多维筛选、视差滚动、复杂动画），导致交付的页面一直处于Loading状态，无法正常使用。
用户反馈：

"一直在 loading 没有效果展示"
"我不敢相信，你又开倒车。。"
"甚至还不如第一版本。。。你目前就生一个画作了。甚至点开看都没有画。。。"
根本原因：
1. 虚荣心作祟：试图展示技术能力而非解决用户需求。
2. 本末倒置：在核心数据（图片）尚未跑通的情况下，堆砌交互特效。
3. 复杂性螺旋：为了修复一个Bug引入了更复杂的逻辑，导致系统脆弱性增加。
解决方案：
- 做减法：彻底砍掉所有非必要功能（筛选、时间轴、动画）。
- 回归HTML本质：使用最基础的卡片式布局，确保"20张图+点击详情"的核心链路畅通。

图注：简单的需求被复杂的架构所困——过度设计的直观展示

经验教训：先做能用的，再做好用的。 任何时候都不能为了形式而牺牲核心功能。

WEB-002：需求理解偏差（Emoji事件）

发现时间：网页代码交付阶段
问题描述：用户在需求中明确指出"检查拒绝任何emoji"，但在编写代码时，为了界面"美观"，擅自添加了📸、📋、🎨等图标。
用户反馈：

"1、检查拒绝任何emoji"
根本原因：
- 主观臆断：认为自己的审美优于用户的明确限制。
- 审查不严：没有将用户的"负面约束"（Negative Constraints）作为硬性验收标准。
解决方案：
- 全局搜索并删除所有Emoji字符。
- 建立严格的需求核对清单（Checklist）。

An image to describe post

图注：用户的"不要"是硬性约束，任何美化理由都不能凌驾于规则之上

经验教训：用户的"不要"比"要"更重要。 明确的约束条件必须无条件遵守。

WEB-003：核心功能（图片）缺失

An image to describe post

图注：华丽的画框中空无一物——形式大于内容的典型案例

发现时间：网页交付中期
问题描述：在追求页面交互效果时，忽略了最核心的数据源配置，导致网页虽然有框架、有按钮、有动画，但最重要的20幅艺术作品图片无法加载显示。
用户反馈：

"缺少了最重要的图"
"甚至点开看都没有画。。。"
根本原因：
- 关注点错位：把精力花在"画框"（UI）上，忘了"画"（内容）。
- 测试盲区：只测试了代码逻辑，没测试真实数据加载。
解决方案：
- 优先修复图片数据源路径。
- 建立"无图不发布"的原则。
经验教训：内容即王（Content is King）。 没有内容的容器毫无价值。

🔧 技术规范与工具问题

TECH-001：非标准图片格式导致的渲染失败

发现时间：2026年1月13日（041-060批次验收时）
问题描述：041-060批次文档中，13幅作品图片无法显示，2幅一直Loading。
根本原因：
- 使用了平台内部的上传占位符格式 [[uploadingImage:{"id":"...","src":"..."}]]。
- 该格式不是标准Markdown语法，在通用Markdown渲染器（如YouMind）中无法解析。
解决方案：
- 执行正则替换，将所有非标准标签转换为标准Markdown语法：![Alt Text](URL)。
- 修复前：[[uploadingImage:{"src":"https://..."}]]
- 修复后：![莫奈睡莲](https://...)

An image to describe post

图注：非标准格式导致的渲染阻断与标准化的修复方案

解决状态：✅ 041-060批次已100%修复。

TECH-002：工具架构与URL类型的匹配问题

发现时间：资料收集阶段
问题描述：在使用 saveMaterials 工具保存包含Wikimedia Commons长链接的图片时，偶尔出现解析超时或格式错误。
根本原因：
- Wikimedia的图片URL结构复杂且包含特殊字符，部分工具的URL解析器未做完整兼容。
- 工具试图抓取元数据时被目标站点的反爬策略拦截。
解决方案：
- 规避策略：不强行使用 saveMaterials 处理图片资源。
- 替代方案：直接在Markdown文档中引用图片URL，或手动上传图片获取稳定链接后再写入文档。

An image to describe post

图注：复杂URL在工具漏斗中的兼容性瓶颈

📝 内容质量与流程问题

CONT-001：批次内容完整性缺失

发现时间：041-060批次初审
问题描述：
- 10件作品缺少"Prompt Example (English)"模块。
- 14件作品缺少"技术要点"模块。
- 导致该批次文档结构与前40件作品不统一。
根本原因：
- 生成模板漂移：在长对话中，AI生成的输出格式逐渐偏离了初始设定的六大模块标准。
- 缺乏验证流程：生成后直接交付，未进行结构完整性检查。
解决方案：
- 人工回填所有缺失模块，补全英文Prompt和技术关键词。
- 统一所有作品的文档结构为：图片 -> 信息表 -> 技法 -> 历史 -> AI专区（中/英/技术点）。

An image to describe post

图注：缺失的拼图——内容模块不完整破坏了文档的整体性

经验教训：信任但要验证（Trust, but verify）。 每一批次生成后必须对照标准模板进行结构核查。

CONT-002：源数据与框架不一致（061-080批次）

发现时间：当前（061-080批次处理中）
问题描述：
- 061-080批次涉及长卷（如《洛中洛外图》）和挂轴，图片比例特殊。
- 源文档中目前图片均为 [[图片待上传]] 占位符。
- 部分作品的AI提示词侧重于"纸张纹理"和"笔触"，与油画批次的描述逻辑差异较大。
根本原因：
- 东方绘画（卷轴、屏风）的物理形态与西方架上绘画差异巨大，原有的一套展示框架（如简单的卡片图）可能无法完美适配长宽比极端的作品。
拟定解决方案：
- 图片处理：需要手动寻找适合网页展示的裁切图（局部特写）配合全卷缩略图。
- Prompt调整：在AI专区增加针对"水墨"、"绢本"、"金箔"等特殊材质的描述权重。