ai-toy-patent-workflow/RULES.md

AI玩具专利生成工作流

启动

• cd ~/Projects/code/20260518-ai-toy-patent-workflow && npm run dev — 端口 4560
• 浏览器打开 http://localhost:4560
• 首次依赖装好：npm install --legacy-peer-deps（next 15 + react 19 有 peer 警告）

部署事实

• 平台：个人 VPS 76.13.31.179，Docker Compose，接入现有 Coolify Traefik
• 发布状态：VPS 生产已发布，仅个人使用
• 服务名 / 容器名：ai-toy-patent-workflow
• 服务器路径：/opt/ai-toy-patent-workflow
• 主站 / 前端：https://ai-toy.kang-kang.com
• 本地 dev：http://localhost:4560
• API / 后端：内置 Next.js API Route（生产同域名）
• 文档 / 解析：无
• 管理后台：无

快捷登录

• 无登录系统（本地工具）

元数据回写清单

• 改公网域名或迁移部署时，更新 .project.json.urls + 本节
• 数据持久化在 data/（gitignored），不入库
• VPS 数据持久化在 /opt/ai-toy-patent-workflow/data
• VPS 生产环境变量在 /opt/ai-toy-patent-workflow/deploy/.env.production，不入库

环境变量

• OPENAI_API_KEY — GPT API Key；文本/结构化/图片生成统一走 GPT 最高规格配置
• GPT_TEXT_MODEL — 默认 gpt-5.5，用于角色设定等结构化输出
• GPT_IMAGE_MODEL — 默认 gpt-image-2，用于意向图和三类素材包图片生成
• GPT_API_BASE — 默认 https://api.openai.com/v1
• SEEDANCE_API_KEY — Seedance 视频生成 Key；未配置时视频接口返回 503
• SEEDANCE_MODEL — 默认 doubao-seedance-2-0-260128
• SEEDANCE_API_BASE — 默认 https://ark.cn-beijing.volces.com/api/v3
• PUBLIC_APP_URL — 生产填公网入口，用于把 /api/img/... 补成 Seedance 可访问的绝对 URL
• 配置位置：.env.local（gitignored），参考 .env.local.example
• 图片生成未配置 GPT Key 时回退 mock（SVG 占位图），视频生成不 mock，必须配置 Seedance Key

规则

• 全项目规则真源：/Users/kangwan/Projects/code/20260317-rules-dashboard/RULES.md
• 文本/结构化/图片生成统一使用 GPT 最高规格配置
• 视频生成固定使用 Seedance
• 不允许编造不存在的部署域名、账号、密码

注意事项

• data/ 目录会存原图（generated/selected/refs），可能体积大，已 gitignored
• refs/ 下放参考资料 PDF/DOCX/图（已 gitignored，但 refs/README 之类可放进库）
• mock 模式仅用于跑通流程，生图质量为零（只是 SVG 笑脸占位）

工作流

1. 输入 prompt + 可选参考图（最多 4 张）+ 风格 + 数量（4/8/12）
2. 点 🪄 批量生成 / ⌘/Ctrl+Enter
3. 九宫格快筛：数字键 1-9 选中，Shift+1-9 打叉
4. 选中的图自动复制到 data/selected/
5. 锁定角色设定 CharacterSpec
6. 一键生成完整三包：专利包、生产打样包、宣发包
7. Seedance 生成视频任务：旋转展示、开箱、触感细节、角色故事
8. 侧栏保留历史会话，点击切换

后续路线

• 导出专利包：PNG高清 + PDF合订
• ZIP/PDF 打包下载
• Seedance 任务轮询 UI