# 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` 收尾