系统难度与我们的实现
从定制商品到可生产作品，贯通多种约束
一个画册定制订单同时包含商品 SKU、物理尺寸、装帧、页数、素材、版式、可编辑状态和生产文件。AI 生成只是其中一个步骤：版式必须遵守产品约束，编辑过程要保留结构，订单还要准确关联当时确认的作品版本。
| 系统难点 | 我们的实现 | 体现的能力 |
|---|---|---|
| 多品类有不同定制规则 | 小程序按类型组织规格、工艺、页数、方向与素材要求；不同产品保留各自编辑和输出分支 | 将业务参数转化为用户可操作的产品流程 |
| AI 创意与精确几何需要衔接 | 模型理解图片、策划叙事和选择设计；确定性引擎使用统一产品规格求解布局 | 把模型能力嵌入有约束的业务系统 |
| 生成结果需要再次编辑 | 输出 OpenPolotno 的作品结构、配置和素材引用；图像、文字与图形可继续调整 | 可编辑画布与结构化作品工程 |
| 设计质量不能只靠模型自评 | 使用真实画布渲染、机械检查、封面字色测量、视觉复核与有界修复 | 可验证的 Agent 工作流与质量控制 |
| 长任务需要处理失败和重启 | SQLite 状态、活动任务复用、持久排队、检查点、并发限制、预算、超时与取消 | 让 AI 服务具备任务工程和恢复机制 |
| 既有后台与新服务分属不同系统 | Java 业务编排、PHP 永久素材 file_id、远端作品工作区与受保护内部接口 | 新旧系统契约、数据归属与跨服务协作 |
| 用户继续编辑不能改变已确认生产内容 | 子订单作品快照、付款和订单状态门槛、生产任务领取锁、导出轮询与回传绑定 | 将创作过程接入订单和生产流程 |
产品与业务界面
微信小程序：连接艺术消费与个性创作
来源：微信开发者工具当前项目的模拟器截图。页面展示公开商品和分类入口；价格、商品数量与购物车角标是截图时的页面内容，不作为营收、业务规模或验收指标。
首页将个性定制、艺术品、精品复刻、文创和设计服务集中在品牌入口。商城提供分类、搜索、筛选和商品展示。定制入口进一步连接素材和创作，而不是停留在商品介绍页。
画册配置：把物理产品规则带入创作流程
来源：生活画册规格页实际截图。截图展示尺寸、页数和方向的部分区域；装帧、纸张及封面覆膜也在同一配置流程内。
- 类型覆盖明信片、单张、框画和多类画册，按场景组织选择。
- 画册流程提供尺寸、装帧、页数、方向、纸张与覆膜配置。
- 产品参数进入作品元数据，为页面定义、AI 排版与 PDF 输出提供约束。
- 商品规格和生产工艺来自业务配置；作品集不将展示选项当作全量产品清单。
AI 入口：先完成素材准备，再进入设计
来源：当前项目的画册分类与空素材上传表单。没有上传客户照片、提交订单或执行付款。
素材页区分封面和内容图片，提示最低数量、上传进度、标题与后续裁切。示例配置中，24 个画册内页对应至少 11 张内容素材及封面；这一数量属于当前配置规则，不推广为所有产品要求。留空标题可交给 AI 生成，用户也可指定标题。
AI 编辑器：保留完整创作结构
编辑器入口：album-editor.artron.net。截图来自登录后的在线画册。选取封面、艺术内页与图层工具区域，已排除工作人员身份、生产订单和其他人员照片列表。
编辑器使用 React 与 OpenPolotno / Konva，围绕画布、页面、图片、文字和图形组织创作。AI 输出进入同一份可编辑作品结构，用户可以继续调整构图和图文关系；保存对象包含作品 JSON、产品配置与素材关联。
截图为在线编辑画布局部，完整页面还包含画册缩略图时间线。页面尺寸与物理产品定义共同约束画布。画册封面涉及封底、书脊与封面跨页，内页涉及页数、出血和内容安全区，不能仅按一张普通海报处理。
截图显示选中文本对象的边界和操作入口，没有修改内容或提交保存。创作结果保留预览和人工继续调整的入口。PDF 输出与作品编辑分开处理；生成一份作品不等于完成订单审核和生产交付。
系统架构
示意图依据当前代码整理，描述模块职责和协作关系，不是生产环境部署拓扑。
小程序承担商品、定制与用户流程；编辑器承担创作、保存和输出。Java mainV2 对接登录、SSO、AI 工作区及订单；现有 PHP / Yii 系统继续承接其原有业务、永久素材和文件绑定。Node 相册服务维护作品工作区与 PDF 导出，TypeScript Artwork Harness 承担新的 Agent 任务。
上传素材经 PHP 保存并返回真实 file_id 和文件引用。Java 与远端相册服务通过受保护的内部 HTTP 接口协作，避免把一个服务的本地文件路径误当作另一个服务可直接访问的共享目录。
多端协同与后台管理
用户创作与工作人员生产各有入口
| 入口 | 主要分工 |
|---|---|
| 微信小程序 | 商品浏览、定制规格、素材准备、AI 状态、编辑入口、订单及个人业务页面 |
| 移动编辑 / 预览 | 适配手机上的作品查看和相应编辑操作，与同一作品数据协作 |
| PC AI 编辑器 | 页面与图文创作、作品保存、预览、PDF 导出和工作人员处理 |
| 既有管理系统 | 商品、订单、审核、文件绑定与后续生产业务 |
角色权限区分工作人员和用户工作区。作品、素材和进度接口使用会话范围校验；内部服务对接使用独立认证。已有业务系统的功能和历史数据属于项目的集成基础，不能全部归为团队新建成果。
关键工程实现
1. 多角色 Agent：从理解图片到整册设计
当前相册服务的 AI 入口对接 TypeScript Artwork Harness。仓库保留的 Python agent-flow 是旧实现；本案例以新 Harness 的入口和代码为依据。
| 角色或阶段 | 实际职责 |
|---|---|
| Image Analyst | 理解单张图片、主体、场景和构图，缓存有效分析结果 |
| Story Curator | 策划整册主题、章节叙事与内容关系，在允许范围内处理顺序 |
| Art Director | 提出字体、配色、模板与封面方向，基于实际渲染比较候选 |
| Copywriter / Composer | 文案与排版分支并行，按关联页分批；照片归属由程序约束 |
| 确定性布局与真实渲染 | 求解页面几何，检查字体与结构，生成可用于复核的 OpenPolotno 校样 |
| 视觉复核与修复 | 全册机械检查、模型视觉抽检、有界修改与局部复查，最多两轮修复 |
| 作品提交 | 保存作品、配置和缩略图，确认服务提交凭证后报告完成 |
Agent 通过原生工具调用提交结构化结果，Schema 校验限制输出。模型可选择主题、风格、字体、配色和版式；产品尺寸、页数及发布路径由程序掌握。当前实现使用 DeepSeek Harness 组件，模型与兼容接口可按环境配置；本案例不绑定某一个模型的效果宣传。
2. 精确版式：统一屏幕与纸张的几何定义
依据 pageSpecs、产品页面定义和输出逻辑绘制。示意图不代表实物印刷测量。
页面定义将成品毫米尺寸、像素换算、DPI、出血、装帧、书脊和封面跨页组织成同一套几何约束。AI 使用这套规格进行布局，编辑器保留结构，PDF 按产品类型处理页面尺寸、工艺区域与标记。
内容图保持原比例和留白，文字与图片建立可解释的区域关系。新版 Harness 还对封面真实渲染中的标题区域做局部字色对比度测量，结果写回布局和作品文字属性，帮助编辑预览和 PDF 使用同一份设计决定。
3. 任务可靠性：进度、恢复、预算与发布确认
依据任务仓库、调度器、检查点、复核流程和发布代码整理。
- SQLite 作为 Agent 状态来源，同一用户和作品复用已有活动任务，支持持久排队与取消。
- 检查点绑定输入、上游输出、模型和构建版本；重启复用有效阶段产物，预算不会随重启重置。
- 单册、全局模型请求和渲染分别限制并发，保留调用超时、任务超时和 Token 预算。
- 实际渲染检查资源、字形、文字高度、几何、照片覆盖与封面可读性；每批复核和修复历史保留记录。
- 作品、配置与缩略图形成 SHA-256 发布清单，核对提交凭证后才报告完成。
- ETA 需要同模型、相近图片量及当前阶段的足够成功样本；阶段进度不能直接当作剩余时间。
这是面向单实例的任务工程实现，不能据此宣称已具备多机调度或无限并发。生成速度、模型审美和生产效果需另行验收。
4. 印刷生产：保存当时确认的作品版本
依据当前子订单作品快照和 ProductionJobService 整理。图示不是本次执行完成的真实订单。
单张、明信片和框画的自动生产分支按子订单冻结作品版本，再核对真实付款及父子订单状态。后台任务通过领取锁、导出启动与轮询、重试等待和取消核对推进生产文件；导出结果回传既有 PHP 文件接口并绑定对应订单。
框画生产码和说明来自权威子订单信息；不同类型的 PDF 有各自页面规则。画册等类型仍保留适用的工作人员审核与处理路径。PDF 导出还包含分块渲染、合并、页面尺寸和工艺区域处理；特殊印刷标准以实际配置和验证结果为准。
这项项目体现的能力
| 能力 | 雅昌项目中的体现 |
|---|---|
| 从业务规则到产品流程 | 将艺术商品、定制规格、工艺、素材与订单组织成微信小程序 |
| 复杂编辑器工程 | 可编辑的多页画布、图文元素、产品几何、素材引用和作品结构 |
| Agent 系统建设 | 多角色协作、受限工具调用、结构化结果、真实渲染和有界修复 |
| AI 服务可靠性 | 持久任务、检查点、并发与预算、失败取消、缓存和发布确认 |
| 新旧系统整合 | Java / Node / PHP 多服务契约、永久素材 file_id 和远端工作区 |
| 创作与生产衔接 | 作品快照、异步 PDF、订单门槛、生产文件回传和绑定 |
这项经验可以用于其他“理解素材 → 生成结构化结果 → 校验 → 人工调整 → 业务执行”的 Agent 场景。新的行业仍需定义自身字段、工具权限、质量规则和验收数据，不能直接假定更换提示词就能复用整个系统。
资料与说明
本案例以 2026-10-08 至 2026-10-09 核对的项目代码和界面为依据。项目正在持续建设，作品集展示团队实现和工程方法，不替代最终业务验收。
- 小程序截图来自微信开发者工具中实际打开的
artron-monorepo/artron-print/miniprogram，已排除开发者账号、源码面板和日志；仅保留应用区域。 - 编辑器截图来自用户完成登录后的 AI 画册编辑器。页面使用既有画册，仅选取不含人员与订单信息的局部；不是此次调用最新 Harness 生成的效果证明。
- Agent、架构、几何和生产任务图为根据代码绘制的说明图，不冒充软件页面。
- 未在此次制作中上传客户照片、执行 AI 付费生成、创建或支付真实订单、部署服务或修改业务数据库。
- 不披露工作人员凭证、客户资料、内部生产订单或服务器密钥。
- 没有将历史测试记录作为本次验收结果，也没有虚构营收、用户数、AI 成功率、生成时长或印刷质量指标。
编辑器与 Agent 基于现有开源和业务基础建设。作品集中的能力描述指团队完成的产品开发、规则整合、接口协作与工程实现。