20260512-skg-tk/CLAUDE.md

SKG AI 素材管线 - TK 二创验证 Agent Rules

Must Read First

• .project.json 是机器真源：公网链接、快捷登录、凭证引用都以它为准
• RULES.md 是人工规则和部署事实：启动命令、平台、域名、注意事项都写这里
• 不允许编造不存在的域名、账号、密码；未知就保持空白并明确标记待补充

Deployment Metadata Contract

• 任何任务只要新增、删除或修改公网地址，必须在同一次任务里更新 .project.json
• urls[] 推荐显式写 type：app、backend、docs、admin、repo
• 项目专属的网页登录信息，如果允许放进仓库，就写 .project.json.quick_login
• 不能直接入库的敏感登录，不要伪造 quick_login，改为写 .project.json.credentials 引用
• 数据库密码、API Key、服务器 root 密码，不属于 quick_login

Completion Gate

• 部署完成后，不允许在 .project.json 缺少最新公网链接的状态下结束任务
• 部署完成后，必须同步更新 RULES.md 的部署事实
• 如果只更新了代码但没回写部署元数据，这个任务不算完成

立项决策（2026-05-12 intake）

• 定位：SKG AI 素材生产管线第二条思路的独立原型验证，不替代主管线（工单系统场景 1），跑通后再评估合并方式
• 端口：4290
• 核心管线（7 步）：TK 链接 → 拆视频/音频 → 关键帧抽取（自动 + 手动，≤10）→ Gemini ASR + 实时英中翻译 → 接产品信息改写文案 → nano-banana-pro / GPT Image 生图（单选）→ Seedance / Kling / Veo3 生视频（参考改写后文案）→ 合成带文案成品视频
• 模型分工（key 走 Poe 优先 / OpenRouter 备用）：
  • 文字 / ASR / 翻译 / 文案改写 → Google Gemini
  • 生图 → nano-banana-pro（Gemini 3 Pro Image）+ GPT Image 二选一
  • 生视频 → Seedance + Kling + Veo3 三家可切，API 抽象层放 key

页面风格（已锁定）

• 主风格 → 04-Dark-Gallery-Ambient（暗色画廊·氛围光）
  • 路径：~/Projects/research/20260305-网页风格库/04-Dark-Gallery-Ambient.md
  • 技术栈：Next.js 16 + Tailwind 4 + Framer Motion + shadcn/ui
  • 关键帧画廊用横向 slider + ambient glow，选中态从图片提主色调营造环境光
  • 玻璃拟态卡片 bg-white/5 backdrop-blur-sm border-white/10，纯黑底 #0a0a0a~#111111
  • Playfair Display serif 做标题
• 备选 → 13-Liquid-Glass（成品输出页 hero 可叠层用）
• 触发：开发会话里说 "用 04 风格" / "用暗色画廊风格"

开发流程（UI 项目标准）

1. /plan 拆 7 步管线为原子任务（下载层 / 拆轨层 / ASR / 翻译 / 改写 / 生图 / 生视频 / 合成 / UI 工作台）
2. /ui-ux-pro-max --design-system 出 design token
3. 对接风格库 04，跑骨架
4. /review + /qa 收尾