docs: record expanded suggestions deployment

RULES.md

@@ -27,6 +27,7 @@
 - AI 润色中性化（2026-05-26）：`509bd9b` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`，部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260526020846.tgz`。本次把画布 `AI 润色`、LLM 节点和自动执行意图分析从 SKG 广告文案接口 `/creative/copy` 拆出，新增中性 `POST /prompt/polish`：只优化用户已经写明的主体、品牌、产品、地点、风格和镜头，不主动添加 SKG、按摩产品、TikTok/Reels 广告话术、标题或 hashtag；`/creative/copy` 继续保留给明确的 SKG 营销文案场景。脚本内验证通过（web/API/Postgres Up、`/` 302、`/login/` 200、未登录 `/api/health` 401、`api:health ok db connected`），并在生产 API 容器内确认普通雨夜街头摊位提示词经 `/prompt/polish` 兜底输出不包含 SKG、massage 或 TikTok。
 - AI 润色人物安全词分流（2026-05-26）：`daec523` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`，部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260526022320.tgz`。本次在 `/prompt/polish` 增加人物意图检测：原提示词没有人物语义或明确写无人时，润色只补“保持 object-only / scene-only / product-only 构图，不新增 people、faces、bodies、hands、avatars、characters、crowds”；原提示词明确有人像、模特、角色、数字人或脸时，才补“fully fictional synthetic AI character / virtual avatar / not based on any real person”。脚本内验证通过（web/API/Postgres Up、`/` 302、`/login/` 200、未登录 `/api/health` 401、`api:health ok db connected`），并在生产 API 容器内确认雨夜章鱼烧摊位不会出现虚构角色安全词，年轻女生人像会出现虚构 AI 角色安全词。
 - 推荐词轮换（2026-05-26）：`d01fdc5` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`，部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260526023923.tgz`。本次把画布和首页推荐词从固定数组改为 4 个一组的短词池，刷新按钮绑定为切换下一组；推荐栏固定单行高度并截断过长 chip，避免把底部输入框顶高。脚本内验证通过（web/API/Postgres Up、`/` 302、`/login/` 200、未登录 `/api/health` 401、`api:health ok db connected`），并在生产 web 容器静态 bundle 中确认命中 `换一组推荐`、`魔法森林`、`无人物街景` 等新文案。
+- 推荐词扩展（2026-05-26）：`7f3a6cc` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`，部署前备份为 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260526024847.tgz`。本次新增 `web/canvas-app/src/config/suggestions.js`，把首页和画布推荐词统一为 30 组 / 120 个短词共享池，每次仍显示 4 个并按组轮换，保持单行不顶起 composer。本地验证 `groups=30`、`items=120`、最长词 5 个字符；本地 `npm run build` 和生产 Docker 构建通过，`./scripts/verify-prod-docker.sh` 复验通过（web/API/Postgres Up、`/` 302、`/login/` 200、未登录 `/api/health` 401、`api:health ok db connected`），并在生产 web 容器静态 bundle 中确认命中 `银河帐篷`。
 - 最近部署验证（2026-05-25）：`cce9779` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`，恢复 `chatfire-AI/huobao-canvas` 上游画布能力但保留 SKG 后端 `/api` 接入。部署前脚本已备份生产私有环境、任务数据、资源库和 secrets 到 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260525102857.tgz`；生产 Docker 重建后脚本内验证通过（web/API 容器 Up、`/` 302、`/login/` 200、缺失 `_next` 资源 404、未登录 `/api/health` 401、容器内 `api:health ok`、`api:ytdlp_cookie_args []`、未发现本地 API/dev URL 泄漏）。补验：外部访问 `https://marketing.skg.com/` 未登录返回 302 到 `/login/?next=/`，`https://marketing.skg.com/canvas/` 返回 308 到 `/`，`https://marketing.skg.com/p/test` 未登录返回 302 到 `/login/?next=/p/test`；容器内静态 bundle 命中 `AI 润色 / 自动执行 / 推荐： / 首帧 / 尾帧 / 多角度分镜 / 儿童绘本 / 工作流模板 / 批量下载素材`，未命中上游注册链接、火宝欢迎文案、GitHub 入口或 `/huobao-canvas`。
 - 最近部署验证（2026-05-25）：`e767d2b` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`，生产根域名改为直接进入个人生成画布，`/canvas/` 仅作为旧链接 308 跳转到 `/`。部署前脚本已备份生产私有环境、任务数据、资源库和 secrets 到 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260525095839.tgz`；生产 Docker 重建后脚本内验证通过（web/API 容器 Up、`/` 302、`/login/` 200、缺失 `_next` 资源 404、未登录 `/api/health` 401、容器内 `api:health ok`、`api:ytdlp_cookie_args []`、未发现本地 API/dev URL 泄漏）。补验：容器内 `/usr/share/nginx/html/index.html` 为 Vue 画布产物，引用 `/assets/index-CioZwOvT.js` 且 title 为 `SKG`；静态 bundle 命中 `文生图 / 文生视频 / 图生视频`，未命中 `首帧生视频 / 首尾帧生视频 / 上传首帧 / 上传尾帧 / 推荐：`；外部访问 `https://marketing.skg.com/` 未登录返回 302 到 `/login/?next=/`，`https://marketing.skg.com/canvas/` 返回 308 到 `/`，`/p/test` 未登录返回 302 到 `/login/?next=/p/test`。
 - 最近部署验证（2026-05-25）：`2a1ceee` 已通过 `./scripts/deploy-prod-safe.sh` 部署到 `/opt/skg-marketing-studio`，可见品牌位从文字命名收敛为 logo-only：首页、登录页和画布首页只显示 SKG logo，网页 title 和画布 title 为 `SKG`，首页入口按钮文案为“画布”。部署前脚本已备份生产私有环境、任务数据、资源库和 secrets 到 `/opt/skg-marketing-studio-backups/skg-marketing-preserve-20260525092749.tgz`；生产 Docker 重建后脚本内验证通过（web/API 容器 Up、`/` 302、`/login/` 200、缺失 `_next` 资源 404、未登录 `/api/health` 401、容器内 `api:health ok`、`api:ytdlp_cookie_args []`、未发现本地 API/dev URL 泄漏）。容器内静态产物复验：`index.html` 包含 `<title>SKG</title>` 和 `/skg-logo-black.svg`，首页入口包含“画布”，登录页只保留 logo；当前 `_next` 与 `/canvas` 产物未再命中 `SKG 生图生视频`、`SKG 生成画布`、`营销内容生产平台` 或 `内容生产画布` 等旧可见文案。

docs/source-analysis.html

@@ -610,7 +610,8 @@
                 <tr><td><code>web/app/page.tsx</code></td><td>旧 React 单对话框生成台源码仍保留，便于以后回滚或抽能力；当前生产根域名已经由 <code>web/canvas-app/</code> 画布产物覆盖，不再把这个 React 首页作为默认首屏。该页面里的模式也已收敛为文生图、文生视频、图生视频；图生视频只显示“上传图片”，不把“首帧/首尾帧”作为用户入口。旧 TK 复刻工作台组件仍保留在 <code>web/components/ad-recreation-board.tsx</code>，但不再作为默认首页渲染。</td></tr>
                 <tr><td><code>web/canvas-app/</code></td><td>SKG 内部画布应用：从 <code>chatfire-AI/huobao-canvas</code> 交互逻辑改造而来。当前策略是“保留成熟画布能力，替换品牌/路由/API”：Vue Flow 节点画布、项目列表、推荐词、AI 润色、自动执行、工作流模板、首帧/尾帧/参考图节点、图片/视频/LLM 配置节点、模型配置和批量下载都保留；可见品牌收敛为 SKG logo，不展示上游注册链接或外部品牌。生产路径固定为根域名 <code>/</code>，内部路由用 <code>/p/:id?</code>；项目列表和画布 JSON 优先同步到服务端 Postgres，浏览器本地存储只是缓存/导入来源；来源说明保存在 <code>THIRD_PARTY_NOTICES.md</code>，不展示给终端用户。</td></tr>
                 <tr><td><code>web/canvas-app/src/stores/projects.js</code></td><td>画布项目 Pinia store：启动时先读本地 <code>localStorage["ai-canvas-projects"]</code> 作为缓存，再调用 <code>GET /canvas-projects</code> 拉服务端项目；如果发现本地旧项目，会调用 <code>POST /canvas-projects/import</code> 导入到当前登录用户。新建、重命名、画布节点变更、复制和删除会同步到 <code>/canvas-projects</code>，本地缓存只用于快速打开和网络异常兜底。</td></tr>
-                <tr><td><code>web/canvas-app/src/views/Canvas.vue</code></td><td>画布主交互：恢复上游底部 prompt composer、<code>AI 润色</code>、<code>自动执行</code>、推荐词、节点菜单、工作流面板、API/模型设置入口和批量下载入口。自动执行会调用 <code>useWorkflowOrchestrator</code> 分析提示词，创建文生图、图转视频、故事板、多角度分镜或绘本节点组；手动模式只创建文本节点，用户自行连接节点。底部推荐词为短词池，4 个一组单行展示，刷新按钮只轮换下一组，不改变输入面板高度。</td></tr>
+                <tr><td><code>web/canvas-app/src/views/Canvas.vue</code></td><td>画布主交互：恢复上游底部 prompt composer、<code>AI 润色</code>、<code>自动执行</code>、推荐词、节点菜单、工作流面板、API/模型设置入口和批量下载入口。自动执行会调用 <code>useWorkflowOrchestrator</code> 分析提示词，创建文生图、图转视频、故事板、多角度分镜或绘本节点组；手动模式只创建文本节点，用户自行连接节点。底部推荐词来自共享短词池，4 个一组单行展示，刷新按钮在 30 组内轮换，不改变输入面板高度。</td></tr>
+                <tr><td><code>web/canvas-app/src/config/suggestions.js</code></td><td>首页和画布共用的推荐词配置：维护 <code>QUICK_SUGGESTION_GROUPS</code>，当前为 30 组 / 120 个短词，每组 4 个，控制刷新按钮的轮换范围；词条保持短小，避免推荐栏换行或顶起 composer。</td></tr>
                 <tr><td><code>web/canvas-app/src/config/models.js</code></td><td>画布媒体模型和规格的前端白名单：图片只内置 <code>auto</code>、<code>gpt-image-2</code>、<code>gemini-3-pro-image-preview</code>，尺寸只内置 <code>auto</code>、<code>1024x1536</code>、<code>1024x1024</code>、<code>1536x1024</code>；视频只内置 <code>seedance</code> / <code>Seedance 2.0 Fast</code>，画幅和时长对齐后端 <code>/health</code> 能力边界。<code>useModelConfig.js</code> 和 Pinia 模型 store 会忽略浏览器本地自定义图片/视频模型，防止旧缓存把不可用模型带回生成下拉。</td></tr>
                 <tr><td><code>web/canvas-app/src/hooks/useApi.js</code></td><td>画布到本项目后端的适配层：不再读取浏览器 API Key，而是使用当前登录会话 Cookie 调用 <code>/api</code>。文生图 / 图生图先创建轻量 creative job，再调用 <code>/frames/0/generate</code>；文生视频 / 图生视频调用 <code>/storyboard/video</code> 并轮询 <code>/jobs/{id}</code>，完成后把图片或 mp4 URL 写回画布节点。<code>useChat</code> 已从 SKG 广告文案接口切到 <code>/prompt/polish</code>：AI 润色显式使用 image/video prompt 模式，LLM 节点使用通用 chat 模式，避免自动注入用户没有提到的 SKG 或营销语境；后端会判断原提示词是否有人物意图，无人物时禁止新增人物，有人物时才声明虚构 AI 角色。</td></tr>
                 <tr><td><code>web/scripts/sync-canvas-root.mjs</code></td><td>构建桥接脚本：在 <code>next build</code> 静态导出完成后，把 Vite 画布产物 <code>web/canvas-app/dist</code> 覆盖到 <code>web/out</code> 根目录，使 <code>https://marketing.skg.com</code> 登录后直接进入画布；旧 <code>web/scripts/sync-canvas-dist.mjs</code> 保留但不再由生产构建调用。</td></tr>
@@ -1243,6 +1244,18 @@ ProductRefStateItem {
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-26 · 推荐词扩展为 30 组共享短词池</h3>
+              <span class="tag violet">Canvas</span>
+              <span class="tag rose">UX</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>推荐词刷新已经可用，但词池只有少数组，用户连续点击时会很快回到同一批，感觉“刷来刷去就这两组”。</p>
+              <p><strong>改动：</strong>新增 <code>web/canvas-app/src/config/suggestions.js</code>，把首页 <code>Home.vue</code> 和画布 <code>Canvas.vue</code> 的推荐词统一改为 <code>QUICK_SUGGESTION_GROUPS</code>，当前 30 组 / 120 个短词，每次仍显示 4 个并按组轮换。</p>
+              <p><strong>影响：</strong>用户可以连续刷新更多主题、场景、产品、镜头和风格灵感；推荐栏仍保持单行短词展示，不会顶起输入框。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-26 · 推荐词刷新改为短词轮换</h3>

web/canvas-app/src/config/suggestions.js

@@ -0,0 +1,32 @@
+export const QUICK_SUGGESTION_GROUPS = [
+  ['魔法森林', '三只小猫', '多角度分镜', '夏日田野'],
+  ['雨夜街摊', '产品特写', '水花慢镜', '极简桌面'],
+  ['无人物街景', '夜市霓虹', '电商白底', '咖啡窗边'],
+  ['插画封面', '厨房晨光', '3D 产品', '海边慢步'],
+  ['樱花小路', '玻璃花房', '露营夜灯', '复古厨房'],
+  ['雪山清晨', '海边黄昏', '森林木屋', '城市天台'],
+  ['未来展厅', '透明材质', '金属微光', '柔和阴影'],
+  ['香水静物', '珠宝近景', '护肤瓶身', '白底套图'],
+  ['手作陶杯', '咖啡拉花', '甜品橱窗', '面包出炉'],
+  ['雨后街角', '地铁站台', '便利店夜', '书店暖光'],
+  ['儿童绘本', '水彩动物', '云朵小岛', '童话城堡'],
+  ['动漫少女', '机甲少年', '赛博街区', '霓虹背光'],
+  ['古风庭院', '宋式茶席', '竹林小径', '月下湖面'],
+  ['户外露营', '徒步山路', '公路日落', '湖边野餐'],
+  ['宠物写真', '猫咪午睡', '小狗奔跑', '兔子花园'],
+  ['办公桌面', '键盘特写', '创意白板', '会议晨光'],
+  ['运动瞬间', '瑜伽清晨', '跑步剪影', '泳池水花'],
+  ['科技发布', '产品旋转', '参数分镜', '开箱镜头'],
+  ['家居客厅', '卧室暖灯', '窗边绿植', '阳台微风'],
+  ['餐桌俯拍', '火锅热气', '寿司吧台', '水果切面'],
+  ['微距花瓣', '水滴叶片', '蝴蝶停留', '晨露草地'],
+  ['沙漠公路', '银河帐篷', '极光雪原', '热气球'],
+  ['电影海报', '悬疑走廊', '逆光人物', '红蓝光影'],
+  ['产品拆解', '材质对比', '功能三镜', '使用场景'],
+  ['小镇集市', '老街门牌', '木质招牌', '雨伞人群'],
+  ['空镜转场', '慢推镜头', '俯拍街区', '环绕拍摄'],
+  ['品牌主图', '社媒封面', '直播背景', '短片开场'],
+  ['草莓蛋糕', '柠檬汽水', '冰块特写', '夏日餐桌'],
+  ['山谷溪流', '雾气森林', '日出云海', '秋叶小路'],
+  ['无脸模特', '侧脸剪影', '背影行走', '虚拟角色']
+]

web/canvas-app/src/views/Canvas.vue

@@ -291,6 +291,7 @@ import ApiSettings from '../components/ApiSettings.vue'
 import DownloadModal from '../components/DownloadModal.vue'
 import WorkflowPanel from '../components/WorkflowPanel.vue'
 import AppHeader from '../components/AppHeader.vue'
+import { QUICK_SUGGESTION_GROUPS } from '../config/suggestions'
 
 // API Config state | API 配置状态
 const modelStore = useModelStore()
@@ -444,17 +445,10 @@ const inputPlaceholder = '你可以试着说"帮我生成一个二次元的卡
 
 // Quick suggestions | 快捷建议
 const suggestionPage = ref(0)
-const suggestionGroups = [
+const suggestions = computed(() => QUICK_SUGGESTION_GROUPS[suggestionPage.value % QUICK_SUGGESTION_GROUPS.length])
-  ['魔法森林', '三只小猫', '多角度分镜', '夏日田野'],
-  ['雨夜街摊', '产品特写', '水花慢镜', '极简桌面'],
-  ['无人物街景', '夜市霓虹', '电商白底', '咖啡窗边'],
-  ['插画封面', '厨房晨光', '3D 产品', '海边慢步']
-]
-
-const suggestions = computed(() => suggestionGroups[suggestionPage.value % suggestionGroups.length])
 
 const refreshSuggestions = () => {
-  suggestionPage.value = (suggestionPage.value + 1) % suggestionGroups.length
+  suggestionPage.value = (suggestionPage.value + 1) % QUICK_SUGGESTION_GROUPS.length
 }
 
 // Add new node | 添加新节点

web/canvas-app/src/views/Home.vue

@@ -232,6 +232,7 @@ import {
 import { useModelStore } from '../stores/pinia'
 import ApiSettings from '../components/ApiSettings.vue'
 import AppHeader from '../components/AppHeader.vue'
+import { QUICK_SUGGESTION_GROUPS } from '../config/suggestions'
 
 const router = useRouter()
 const dialog = useDialog()
@@ -285,17 +286,10 @@ const renameTargetId = ref(null)
 
 // Suggestions tags | 建议标签
 const suggestionPage = ref(0)
-const suggestionGroups = [
+const suggestions = computed(() => QUICK_SUGGESTION_GROUPS[suggestionPage.value % QUICK_SUGGESTION_GROUPS.length])
-  ['魔法森林', '三只小猫', '多角度分镜', '夏日田野'],
-  ['雨夜街摊', '产品特写', '水花慢镜', '极简桌面'],
-  ['无人物街景', '夜市霓虹', '电商白底', '咖啡窗边'],
-  ['插画封面', '厨房晨光', '3D 产品', '海边慢步']
-]
-
-const suggestions = computed(() => suggestionGroups[suggestionPage.value % suggestionGroups.length])
 
 const refreshSuggestions = () => {
-  suggestionPage.value = (suggestionPage.value + 1) % suggestionGroups.length
+  suggestionPage.value = (suggestionPage.value + 1) % QUICK_SUGGESTION_GROUPS.length
 }
 
 // Format date | 格式化日期