54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
# SKG AI 素材管线 - TK 二创验证
|
||
|
||
## 启动
|
||
- 前端 dev：`cd web && pnpm dev`（Next.js 16，端口 4290）
|
||
- 后端 dev：`cd api && uvicorn main:app --port 4291 --reload`（FastAPI，端口 4291，重任务用）
|
||
- 说明：以上为规划脚手架，未实际生成；开发会话第一步起骨架时落地
|
||
|
||
## 立项决策快索引
|
||
- 详见 `CLAUDE.md` 立项决策段 + `.memory/plan.md` 七步管线拆解
|
||
- 风格：`04-Dark-Gallery-Ambient`（路径：`~/Projects/research/20260305-网页风格库/04-Dark-Gallery-Ambient.md`）
|
||
- 第一冲刺：步骤 1-4（下载 / 拆轨 / 关键帧 / ASR+翻译）
|
||
|
||
## 部署事实
|
||
- 平台：待定
|
||
- 发布状态：未部署
|
||
- 主站 / 前端：待定
|
||
- API / 后端：待定
|
||
- 文档 / 解析：待定
|
||
- 管理后台：待定
|
||
|
||
## 快捷登录
|
||
- 登录地址：待补充
|
||
- 用户名：待补充
|
||
- 密码：待补充
|
||
- 说明：这里只写项目专属网页登录；数据库密码、API Key、服务器 root 密码不要写这里
|
||
|
||
## 元数据回写清单
|
||
- 新增或变更公网地址后，必须同步更新 `.project.json.urls`
|
||
- 如果有网页后台登录：
|
||
- 可直接入库：写 `.project.json.quick_login`
|
||
- 不应入库：写 `.project.json.credentials` 引用
|
||
- 部署完成后，`RULES.md` 和 `.project.json` 必须同一次任务一起更新
|
||
|
||
## 环境变量
|
||
- `LLM_BASE_URL` / `LLM_API_KEY`：OpenAI 兼容网关，用于 ASR、翻译、文案改写、图像等模型调用
|
||
- `ASR_MODEL`：音频转写模型，默认 `whisper-1`
|
||
- `TRANSLATE_MODEL`：字幕翻译模型，默认 `gemini-2.5-flash`
|
||
- `REWRITE_MODEL`：通用改写/分镜描述模型，默认 `gemini-2.5-pro`
|
||
- `AUDIO_REWRITE_MODEL`：音频口播改写模型，默认跟随 `REWRITE_MODEL`
|
||
- `AUDIO_PRODUCT_BRIEF`：音频口播改写时注入的 SKG 产品卖点
|
||
- `MINIMAX_API_KEY`：MiniMax T2A 配音 Key，只能放本地 `api/.env`，不能入库
|
||
- `MINIMAX_TTS_BASE_URL` / `MINIMAX_TTS_MODEL` / `MINIMAX_TTS_VOICE_ID`：MiniMax 配音端点、模型和音色配置
|
||
- `POE_API_KEY` / `VIDEO_API_KEY`：视频生成通道 Key，只能放本地环境变量
|
||
|
||
## 规则
|
||
- 不允许编造不存在的部署域名、账号、密码
|
||
- 没有公网地址时，`.project.json.urls` 保持空数组
|
||
- 任何部署或域名变化，都要先改元数据，再视为任务完成
|
||
|
||
## 注意事项
|
||
- 项目内源码解析页：`docs/source-analysis.html`
|
||
- 源码解析页是给产品协作和需求描述用的独立 HTML，不接入 Next 应用路由
|
||
- 后续任何功能、节点职责、接口、数据模型或用户操作路径变更，都要同步更新 `docs/source-analysis.html` 的对应章节和变更记录
|