SKG 营销内容工作台 Agent Rules

Must Read First

.project.json 是机器真源：公网链接、快捷登录、凭证引用都以它为准
RULES.md 是人工规则和部署事实：启动命令、平台、域名、注意事项都写这里
工作看板全局规则是本项目的开发收口默认规则；本地规则缺失时按 /Users/kangwan/Projects/code/20260317-rules-dashboard/RULES.md、SCHEMA.md、rules/03-Git约定.md、rules/04-版本发布规则.md 补齐
不允许编造不存在的域名、账号、密码；未知就保持空白并明确标记待补充

开发任务结束前必须执行并汇报 git status -sb
功能、修复、规则或部署元数据变更完成后，必须创建人工语义 commit；auto-save 只算安全快照
默认先在本地 Docker 完整验证：./scripts/start-local-docker.sh 后运行 ./scripts/verify-local-docker.sh；用户明确确认“可以推送 / 上推 / 部署”前，不要 git push，也不要运行生产部署脚本。
涉及模型接入、API Key、图片生成或视频生成链路修复时，如果用户已经提供本地可用的 base/key 且没有明确禁止真实调用，Agent 必须直接触发一次最小真实生成做端到端验证，不能只停在配置检查、dry-run 或让用户手动点测；汇报时说明实际触发的模型、入口、任务 ID/生成 URL 或失败原因，以及是否产生了真实调用消耗。
Gitea 是主远端，origin 必须指向 Gitea；只有在用户明确确认推送后，才把已验证的人工语义 commit 推送到 Gitea。
当前主分支为 main，Gitea 仓库为 https://git.kang-kang.com/kangwan/20260512-skg-tk
.memory/worklog.json 是辅助日志，不代替人工语义 commit 和 Gitea 远端记录
不能推送时，必须说明当前分支、本地领先/落后数量、最新未推送 commit 和失败原因

最终产品基线是 https://marketing.skg.com 登录后的个人生成画布；本地开发和验收必须尽量复刻这套线上运行形态。
根域名生产入口由 web/canvas-app/ 的 Vue / Vite 画布产物承载；旧 React 首页、旧 TK 复刻工作台、Agent Cut 和详情页能力只能作为高级/兼容/回滚参考，不能当默认产品基线。
之后所有升级、修复和产品判断，优先围绕根域名画布、当前 /api、Postgres 持久化、飞书登录和 owner 隔离展开。
本地同构环境优先使用 Docker：docker-compose.local.yml + deploy/.env.local + data-local/；不要用本地 dev server 的偶然行为代替生产形态判断。
遇到线上用户 bug，先只读确认生产事实：用户身份、owner、job、canvas project、generated asset、日志时间线；必要时把最小可复现数据拉到本地 Docker 环境复现和修复，不能直接在生产库里试错。

项目内源码解析页固定为 docs/source-analysis.html
该页面用于帮助用户把产品需求准确描述到源码位置：功能区、节点职责、数据模型、接口、变更影响都要能查到
任何改动只要影响产品理解、节点职责、界面行为、数据模型、API、运行方式或用户操作路径，必须在同一次任务里更新 docs/source-analysis.html
更新时至少补充“变更记录”，必要时同步更新源码结构地图、界面区域到源码、数据模型、接口地图、节点职责边界
不要把源码解析页接入主应用路由，除非用户明确要求；它默认是项目内独立 HTML 文档

任何图片 / 视频 / 抽帧 / 产品图 / 生成图 / 首尾帧 / 视频候选缩略图，不允许临时手写一套孤立交互；当前工作台新增媒体展示默认复用 web/components/media-asset-tile.tsx
所有媒体缩略图默认支持鼠标停留放大预览；预览层必须挂到顶层固定浮层，不能被滚动容器、面板或表格裁切
可删除的媒体素材必须显示删除入口；删除按钮、重新生成按钮、状态遮罩和悬停预览交互要在全项目保持一致
缩略图尺寸可按区域调整，但图片 / 视频必须可完整查看；需要裁切时必须仍能通过悬停预览看到完整素材
新增媒体板块验收时必须检查：悬停放大、删除入口、预览不被遮挡、图片完整性、视频预览、模型 / 状态标注是否与已有板块一致