@tomako/tools-runtime 0.1.4 → 0.1.6

package/src/features/tools/product-poster-generator/widget/product-poster-generator.tsx

@@ -3,6 +3,7 @@
 import { ChevronDown, FileImage } from "lucide-react";
 import {
     useMemo,
+    useEffect,
     useRef,
     useState,
     type ChangeEvent,
@@ -22,8 +23,10 @@ import {
     PRODUCT_POSTER_STYLES,
     productPosterGeneratorInputSchema,
     type ProductPosterFormat,
+    type ProductPosterGeneratorInput,
     type ProductPosterStyle,
 } from "../../../../lib/tools/product-poster-generator-schema";
+import { downloadBlob } from "../../../../lib/file/download";
 import { cn } from "@tomako/ui/cn";
 import {
     fetchProductPosterGenerationTask,
@@ -50,6 +53,11 @@ import {
     toolTextareaClass,
     type ToolLoadingStep,
 } from "../../../../components/tools/workspace";
+import {
+    clearToolTaskRecovery,
+    persistToolTaskRecovery,
+    readToolTaskRecovery,
+} from "../../../../components/tools/engine/task-recovery";
 import {
     MAX_TASK_POLL_ATTEMPTS,
     POSTER_FORMAT_OPTIONS,
@@ -70,6 +78,7 @@ import {
     getPosterIntentId,
     getPosterResultError,
     getSafeErrorMessage,
+    fetchProductPosterPng,
     loadingProgress,
     loadingStepIndex,
     readImageAsDataUrl,
@@ -86,6 +95,13 @@ import type {
     ResultState,
 } from "./types";
 
+const RECOVERY_SLUG = "product-poster-generator";
+
+type PosterTaskRecoveryInput = {
+  input: ProductPosterGeneratorInput;
+  settingsSummary: string;
+};
+
 export function ProductPosterGenerator() {
   const locale = useLocale();
   const taskLocale = locale as AppLocale;
@@ -99,6 +115,8 @@ export function ProductPosterGenerator() {
   const [fieldErrors, setFieldErrors] = useState<FieldErrors>({});
   const [formError, setFormError] = useState<string | null>(null);
   const [advancedOpen, setAdvancedOpen] = useState(false);
+  const [downloading, setDownloading] = useState(false);
+  const [downloadError, setDownloadError] = useState<string | null>(null);
 
   const formatLabels = t.raw("formatLabels") as Record<ProductPosterFormat, string>;
   const styleLabels = t.raw("styleLabels") as Record<ProductPosterStyle, string>;
@@ -158,6 +176,39 @@ export function ProductPosterGenerator() {
 
   const busy = result.phase === "submitting" || result.phase === "polling";
 
+  useEffect(() => {
+    const recovered = readToolTaskRecovery<PosterTaskRecoveryInput>(RECOVERY_SLUG, {
+      parseInput: (value) => {
+        if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+        const candidate = value as Partial<PosterTaskRecoveryInput>;
+        const parsed = productPosterGeneratorInputSchema.safeParse(candidate.input);
+        if (!parsed.success || typeof candidate.settingsSummary !== "string") return null;
+        return { input: parsed.data, settingsSummary: candidate.settingsSummary };
+      },
+    });
+    if (!recovered) return;
+    const generationId = generationSeqRef.current + 1;
+    generationSeqRef.current = generationId;
+    setForm({
+      ...defaultForm,
+      ...recovered.input.input,
+      screenshotNames: [],
+      screenshotDataUrls: [],
+      logoName: undefined,
+      logoDataUrl: undefined,
+    });
+    void watchPosterTask(
+      recovered.taskId,
+      recovered.input.input,
+      recovered.input.settingsSummary,
+      generationId,
+      recovered.startedAtMs,
+      "RESTORING",
+    );
+    // Restore only once for this mounted tool route.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
   function scrollToResult() {
     window.requestAnimationFrame(() => {
       resultRef.current?.scrollIntoView({ behavior: "smooth", block: "center" });
@@ -289,6 +340,7 @@ export function ProductPosterGenerator() {
     }
 
     setFormError(null);
+    setDownloadError(null);
     setFieldErrors({});
     const generationId = generationSeqRef.current + 1;
     generationSeqRef.current = generationId;
@@ -320,9 +372,39 @@ export function ProductPosterGenerator() {
     if (generationSeqRef.current !== generationId) return;
 
     const taskId = submitted.taskId;
-    setResult({ phase: "polling", taskId, status: submitted.status });
+    const startedAtMs = Date.now();
+    persistToolTaskRecovery<PosterTaskRecoveryInput>(
+      RECOVERY_SLUG,
+      taskId,
+      { input: posterInput, settingsSummary: posterSettingsSummary },
+      startedAtMs,
+    );
+    await watchPosterTask(
+      taskId,
+      posterInput,
+      posterSettingsSummary,
+      generationId,
+      startedAtMs,
+      submitted.status,
+    );
+  }
 
-    for (let attempt = 0; attempt < MAX_TASK_POLL_ATTEMPTS; attempt += 1) {
+  async function watchPosterTask(
+    taskId: string,
+    posterInput: ProductPosterGeneratorInput,
+    posterSettingsSummary: string,
+    generationId: number,
+    startedAtMs: number,
+    initialStatus: string,
+  ) {
+    setResult({ phase: "polling", taskId, status: initialStatus });
+    const elapsedAttempts = Math.max(
+      0,
+      Math.floor((Date.now() - startedAtMs) / TASK_POLL_INTERVAL_MS),
+    );
+    const remainingAttempts = Math.max(1, MAX_TASK_POLL_ATTEMPTS - elapsedAttempts);
+
+    for (let attempt = 0; attempt < remainingAttempts; attempt += 1) {
       try {
         const task = await fetchProductPosterGenerationTask(taskId);
         if (generationSeqRef.current !== generationId) return;
@@ -376,24 +458,40 @@ export function ProductPosterGenerator() {
     }
   }
 
-  function downloadPosterPng() {
-    if (result.phase !== "ready") return;
-    const link = document.createElement("a");
-    link.href = result.data.imageUrl;
-    link.download = `${result.data.fileBaseName}-poster.webp`;
-    link.target = "_blank";
-    link.rel = "noreferrer";
-    link.click();
+  async function downloadPosterPng() {
+    if (result.phase !== "ready" || downloading) return;
+    const generationId = generationSeqRef.current;
+    setDownloading(true);
+    setDownloadError(null);
+    try {
+      const file = await fetchProductPosterPng(
+        result.data.imageUrl,
+        result.data.fileBaseName,
+      );
+      if (generationSeqRef.current !== generationId) return;
+      downloadBlob(file.blob, file.fileName);
+    } catch {
+      if (generationSeqRef.current === generationId) {
+        setDownloadError(t("errors.downloadFailed"));
+      }
+    } finally {
+      if (generationSeqRef.current === generationId) {
+        setDownloading(false);
+      }
+    }
   }
 
   function reset() {
     generationSeqRef.current += 1;
+    clearToolTaskRecovery(RECOVERY_SLUG);
     if (logoInputRef.current) logoInputRef.current.value = "";
     if (screenshotInputRef.current) screenshotInputRef.current.value = "";
     setForm(defaultForm);
     setResult({ phase: "idle" });
     setFieldErrors({});
     setFormError(null);
+    setDownloadError(null);
+    setDownloading(false);
     setAdvancedOpen(false);
   }
 
@@ -599,14 +697,16 @@ export function ProductPosterGenerator() {
               body={result.data.summary ?? t("readyHint")}
               actions={
                 <ToolResultActions
-                  downloadLabel={t("downloadPng")}
+                  downloadLabel={downloading ? t("loadingSteps.finish") : t("downloadPng")}
                   resetLabel={t("reset")}
-                  onDownload={downloadPosterPng}
+                  onDownload={() => void downloadPosterPng()}
                   onReset={reset}
                 />
               }
             />
 
+            {downloadError ? <ToolErrorBanner>{downloadError}</ToolErrorBanner> : null}
+
             <figure className="flex min-h-[28rem] items-center justify-center overflow-hidden rounded-[1.25rem] border border-[#E4E9F1] bg-white p-3">
               {/* eslint-disable-next-line @next/next/no-img-element */}
               <img

package/src/features/tools/slogan-generator/slogan-generator.package.ts

@@ -6,7 +6,7 @@ import type { ToolPackage } from "../package/types";
  * Slogan Generator（direct 车道）。
  * 证据：docs/seo-keyword-briefs/slogan-generator.md（slogan generator 12,100/mo LOW + 竞品拆解）。
  * 反超点（相对 logo.com / ahrefs / shopify / copy.ai / grammarly）：
- * 免登录页面内直出；每条候选带风格标签 + why-it-works 理由（ahrefs 只有裸文本）；
+ * 登录后在页面内直出；每条候选带风格标签 + why-it-works 理由（ahrefs 只有裸文本）；
  * 一次 10 条覆盖多风格；输出附挑选/测试建议；支持可选品牌名生成 name-based slogan。
  * scene "slogan_generator" 需在 168 compose 的 LLM_DIRECT_ALLOWED_SCENES 白名单内。
  */
@@ -35,18 +35,18 @@ export const sloganGeneratorPackage: ToolPackage = {
     toolType: "generator",
     keywordEvidence: "docs/seo-keyword-briefs/slogan-generator.md",
     seo: {
-      updatedAt: "2026-07-04",
+      updatedAt: "2026-08-30",
       readingTime: "6 min",
       ogImage: "/tools/slogan-generator-hero.webp",
     },
   },
   copy: {
-    title: { en: "Slogan Generator", zh: "Slogan 广告语生成器", "zh-tw": "Slogan 廣告語生成器" },
+    title: { en: "AI Slogan Generator for Business", zh: "AI Slogan 广告语生成器", "zh-tw": "AI Slogan 廣告語產生器" },
     description: {
-      en: "Free AI slogan generator: describe your business and get 10 catchy slogan and tagline ideas across styles from bold and minimal to playful and benefit-driven — each with a style tag and a why-it-works note. No sign-up, results on this page.",
-      zh: "免费 AI Slogan 生成器：描述你的业务，一次获得 10 条广告语和 tagline 候选，覆盖大胆、极简、俏皮、利益导向等多种风格，每条附风格标签和入选理由。免注册，结果直接在本页给出。",
+      en: "Describe your business and get 10 AI slogan and tagline ideas across distinct styles, each with a why-it-works note. Sign in to generate and compare the full set.",
+      zh: "描述你的业务，一次生成 10 条 Slogan 和 tagline 候选，覆盖大胆、极简、俏皮、利益导向等多种风格，每条附风格标签和入选理由。登录后可在本页生成并比较完整结果。",
       "zh-tw":
-        "免費 AI Slogan 生成器：描述你的業務，一次獲得 10 條廣告語和 tagline 候選，覆蓋大膽、極簡、俏皮、利益導向等多種風格，每條附風格標籤和入選理由。免註冊，結果直接在本頁給出。",
+        "描述你的業務，一次產生 10 條 Slogan 和 tagline 候選，涵蓋大膽、極簡、俏皮、利益導向等多種風格，每條附風格標籤和入選理由。登入後可在本頁產生並比較完整結果。",
     },
     intro: {
       en: "A good slogan is 3-6 words that carry your brand promise. Instead of staring at a blank page or paying an agency, describe what you do and compare structured candidates side by side — with reasons, not just word salad.",
@@ -60,9 +60,9 @@ export const sloganGeneratorPackage: ToolPackage = {
       "zh-tw": "品牌工具",
     },
     keywords: {
-      en: ["slogan generator", "slogan creator", "slogan maker", "free slogan generator", "ai slogan generator", "tagline generator", "business slogan generator"],
-      zh: ["slogan 生成器", "slogan 制作", "广告语生成器", "品牌口号生成", "tagline 生成器", "免费广告语工具", "AI 广告语"],
-      "zh-tw": ["slogan 生成器", "slogan 製作", "廣告語生成器", "品牌口號生成", "tagline 生成器", "免費廣告語工具", "AI 廣告語"],
+      en: ["slogan generator", "slogan creator", "slogan maker", "ai slogan generator", "tagline generator", "business slogan generator"],
+      zh: ["slogan 生成器", "slogan 制作", "广告语生成器", "品牌口号生成", "tagline 生成器", "AI 广告语"],
+      "zh-tw": ["slogan 產生器", "slogan 製作", "廣告語產生器", "品牌口號產生", "tagline 產生器", "AI 廣告語"],
     },
     inputSignal: {
       en: "One-sentence business description + optional brand name",
@@ -214,13 +214,13 @@ Quality requirements:
       zh: "一句说清业务就够了。品牌名、目标人群和风格方向会让候选更贴合。",
       "zh-tw": "一句說清業務就夠了。品牌名、目標人群和風格方向會讓候選更貼合。",
     },
-    submitLabel: { en: "Generate 10 slogans", zh: "生成 10 条 Slogan", "zh-tw": "生成 10 條 Slogan" },
+    submitLabel: { en: "Generate 10 slogans", zh: "生成 10 条 Slogan", "zh-tw": "產生 10 條 Slogan" },
     resultTitle: { en: "Compare your candidates", zh: "横向比较候选", "zh-tw": "橫向比較候選" },
-    pendingTitle: { en: "Writing your slogans", zh: "正在生成 Slogan", "zh-tw": "正在生成 Slogan" },
+    pendingTitle: { en: "Writing your slogans", zh: "正在生成 Slogan", "zh-tw": "正在產生 Slogan" },
     pendingHint: {
       en: "Usually takes 15-30 seconds. Candidates across multiple styles are being written and annotated.",
       zh: "通常需要 15-30 秒。正在生成多风格候选并为每条写入选理由。",
-      "zh-tw": "通常需要 15-30 秒。正在生成多風格候選並為每條寫入選理由。",
+      "zh-tw": "通常需要 15-30 秒。正在產生多風格候選，並為每條寫入入選理由。",
     },
     errorOverrides: {
       validation: {
@@ -236,16 +236,88 @@ Quality requirements:
   page: {
     workspace: {
       heading: {
-        en: "Get 10 slogan candidates worth comparing",
-        zh: "一次拿到 10 条值得比较的 Slogan",
-        "zh-tw": "一次拿到 10 條值得比較的 Slogan",
+        en: "AI slogan generator: 10 ideas worth comparing",
+        zh: "AI Slogan 生成器：一次拿到 10 条值得比较的候选",
+        "zh-tw": "AI Slogan 產生器：一次取得 10 條值得比較的候選",
       },
       hint: {
         en: "Describe the business in one or two sentences, optionally add the brand name and audience. You get 10 candidates across multiple styles, each with a style tag and a note on why the line works — ready to shortlist, test, and refine.",
         zh: "用一两句话描述业务，可选填品牌名和目标人群。你会得到覆盖多种风格的 10 条候选，每条带风格标签和入选理由——直接进入筛选、测试和打磨。",
         "zh-tw": "用一兩句話描述業務，可選填品牌名和目標人群。你會得到覆蓋多種風格的 10 條候選，每條帶風格標籤和入選理由——直接進入篩選、測試和打磨。",
       },
-      badge: { en: "Free, no sign-up", zh: "免费免注册", "zh-tw": "免費免註冊" },
+      badge: { en: "Sign in to generate", zh: "登录后生成", "zh-tw": "登入後產生" },
+    },
+    standard: {
+      benefits: {
+        title: {
+          en: "Compare distinct slogan directions, not filler variations",
+          zh: "比较真正不同的 Slogan 方向，而不是凑数变体",
+          "zh-tw": "比較真正不同的 Slogan 方向，而不是湊數變體",
+        },
+        cards: [
+          {
+            title: { en: "10 varied candidates", zh: "10 条多风格候选", "zh-tw": "10 條多風格候選" },
+            body: { en: "Compare bold, minimal, playful, premium, and benefit-led lines side by side.", zh: "并排比较大胆、极简、俏皮、高端和利益导向的表达。", "zh-tw": "並排比較大膽、極簡、俏皮、高端和利益導向的表達。" },
+          },
+          {
+            title: { en: "Reasons you can judge", zh: "每条都有判断依据", "zh-tw": "每條都有判斷依據" },
+            body: { en: "Each line explains the rhythm, contrast, specificity, or promise that makes it work.", zh: "每条都说明节奏、对比、具体性或承诺为什么成立。", "zh-tw": "每條都說明節奏、對比、具體性或承諾為什麼成立。" },
+          },
+          {
+            title: { en: "A shortlist with next steps", zh: "带下一步的候选清单", "zh-tw": "帶下一步的候選清單" },
+            body: { en: "Use read-aloud, recall, trademark, and domain checks before choosing a final line.", zh: "定稿前继续做朗读、记忆、商标和域名检查。", "zh-tw": "定稿前繼續做朗讀、記憶、商標和網域檢查。" },
+          },
+        ],
+      },
+      imageTextSections: [
+        {
+          id: "section-primary",
+          title: { en: "Start with a brief the generator can understand", zh: "先给生成器一份能读懂的业务简介", "zh-tw": "先給產生器一份能讀懂的業務簡介" },
+          body: {
+            en: ["State who the business serves and what changes for them.", "Add the brand name only when you want name-based wordplay; vague one-word prompts produce generic lines."],
+            zh: ["写清业务服务谁，以及为他们带来什么变化。", "只有需要名字相关的文字游戏时才填写品牌名；单个空泛词只会得到通用句子。"],
+            "zh-tw": ["寫清業務服務誰，以及為他們帶來什麼變化。", "只有需要名字相關的文字遊戲時才填寫品牌名；單一空泛詞只會得到通用句子。"],
+          },
+          image: { src: "/tools/slogan-generator-value.webp", alt: { en: "A concise slogan standing out from vague drafts.", zh: "一句清晰口号从空泛草案中脱颖而出。", "zh-tw": "一句清晰口號從空泛草案中脫穎而出。" }, side: "left" },
+          imageFirst: true,
+        },
+        {
+          id: "section-variation",
+          title: { en: "Compare styles before polishing words", zh: "先比较风格方向，再打磨具体词句", "zh-tw": "先比較風格方向，再打磨具體詞句" },
+          body: {
+            en: ["Shortlist candidates from different styles rather than near-duplicates.", "Read them aloud and test recall beside the logo with people who do not already know the brand."],
+            zh: ["从不同风格中挑选候选，不要只留同一个想法的近似变体。", "逐条朗读，并把它们和 Logo 放在一起，让不了解品牌的人测试记忆度。"],
+            "zh-tw": ["從不同風格中挑選候選，不要只留同一個想法的近似變體。", "逐條朗讀，並把它們和 Logo 放在一起，讓不了解品牌的人測試記憶度。"],
+          },
+          image: { src: "/tools/slogan-generator-standard.webp", alt: { en: "Slogan candidates compared for fit and memorability.", zh: "按贴合度和记忆度比较口号候选。", "zh-tw": "按貼合度和記憶度比較口號候選。" }, side: "right" },
+        },
+        {
+          id: "section-support",
+          title: { en: "Treat every result as a draft to clear", zh: "把每条结果当成仍需检查的草案", "zh-tw": "把每條結果當成仍需檢查的草案" },
+          body: {
+            en: ["The tool does not check trademarks, domains, or social handles.", "Search the exact phrase in your market and reject lines that overpromise what the product can deliver."],
+            zh: ["工具不会检查商标、域名或社媒账号占用。", "请在目标市场搜索候选原文，并淘汰任何超出产品真实能力的承诺。"],
+            "zh-tw": ["工具不會檢查商標、網域或社群帳號佔用。", "請在目標市場搜尋候選原文，並淘汰任何超出產品真實能力的承諾。"],
+          },
+          image: { src: "/tools/slogan-generator-support.webp", alt: { en: "A slogan shortlist passing brand and trademark checks.", zh: "口号候选清单经过品牌和商标检查。", "zh-tw": "口號候選清單經過品牌和商標檢查。" }, side: "left" },
+          imageFirst: true,
+        },
+      ],
+      generation: {
+        title: { en: "Move from candidate list to a tested slogan", zh: "从候选清单走到经过测试的最终口号", "zh-tw": "從候選清單走到經過測試的最終口號" },
+        image: { src: "/tools/slogan-generator-result-use.webp", alt: { en: "A shortlisted slogan tested beside a logo and landing page.", zh: "入围口号与 Logo 和落地页一起测试。", "zh-tw": "入圍口號與 Logo 和網站首頁一起測試。" }, side: "left" },
+        steps: [
+          { title: { en: "Shortlist three directions", zh: "选出三个不同方向", "zh-tw": "選出三個不同方向" }, body: { en: "Keep candidates that make one clear, honest promise.", zh: "保留只表达一个清晰、诚实承诺的候选。", "zh-tw": "保留只表達一個清晰、誠實承諾的候選。" } },
+          { title: { en: "Test sound and recall", zh: "测试读感和记忆度", "zh-tw": "測試讀感和記憶度" }, body: { en: "Read each aloud and ask unfamiliar readers what they remember later.", zh: "逐条朗读，并询问陌生读者过一段时间后还记得哪条。", "zh-tw": "逐條朗讀，並詢問陌生讀者過一段時間後還記得哪條。" } },
+          { title: { en: "Clear conflicts before launch", zh: "上线前排查冲突", "zh-tw": "上線前排查衝突" }, body: { en: "Check exact-phrase search, trademarks, domains, and handles before committing.", zh: "定稿前检查原文搜索、商标、域名和账号占用。", "zh-tw": "定稿前檢查原文搜尋、商標、網域和帳號佔用。" } },
+        ],
+        ctaLabel: { en: "Generate slogan candidates", zh: "生成 Slogan 候选", "zh-tw": "產生 Slogan 候選" },
+      },
+      faq: {
+        title: { en: "Slogan generator FAQs", zh: "Slogan 生成器常见问题", "zh-tw": "Slogan 產生器常見問題" },
+        intro: { en: "Generate a broad shortlist, then test and clear the final phrase before using it.", zh: "先生成覆盖不同方向的候选，再测试并检查最终短语。", "zh-tw": "先產生涵蓋不同方向的候選，再測試並檢查最終短語。" },
+        ctaLabel: { en: "Create slogan candidates", zh: "生成 Slogan 候选", "zh-tw": "產生 Slogan 候選" },
+      },
     },
     sections: [
       {
@@ -469,17 +541,17 @@ Quality requirements:
       {
         kind: "cards",
         heading: {
-          en: "Why this beats the usual free slogan tools",
-          zh: "为什么比常见的免费 slogan 工具好用",
-          "zh-tw": "為什麼比常見的免費 slogan 工具好用",
+          en: "Why this beats basic slogan lists",
+          zh: "为什么比常见的 slogan 列表更好用",
+          "zh-tw": "為什麼比常見的 slogan 清單更好用",
         },
         items: [
           {
-            title: { en: "Results on this page, no account", zh: "本页直出，无需注册", "zh-tw": "本頁直出，無需註冊" },
+            title: { en: "Full results on this page", zh: "完整结果在本页展示", "zh-tw": "完整結果在本頁顯示" },
             body: {
-              en: "Slogan creators from Shopify, Copy.ai, and Grammarly route you into a sign-up or product funnel before the full result. Here the complete list renders right below the form.",
-              zh: "Shopify、Copy.ai、Grammarly 的 slogan 工具在给出完整结果前会把你引进注册或产品漏斗。这里的完整候选就渲染在表单下方。",
-              "zh-tw": "Shopify、Copy.ai、Grammarly 的 slogan 工具在給出完整結果前會把你引進註冊或產品漏斗。這裡的完整候選就渲染在表單下方。",
+              en: "After you sign in once, the complete candidate set renders directly below the form instead of sending you to a separate editor or workflow.",
+              zh: "登录后，完整候选会直接显示在表单下方，不会再把你带到另一个编辑器或流程。",
+              "zh-tw": "登入後，完整候選會直接顯示在表單下方，不會再把你帶到另一個編輯器或流程。",
             },
           },
           {
@@ -605,14 +677,14 @@ Quality requirements:
       },
       {
         question: {
-          en: "Is this slogan generator really free?",
-          zh: "这个 slogan 生成器真的免费吗？",
-          "zh-tw": "這個 slogan 生成器真的免費嗎？",
+          en: "Do I need an account to generate slogans?",
+          zh: "生成 Slogan 需要登录吗？",
+          "zh-tw": "產生 Slogan 需要登入嗎？",
         },
         answer: {
-          en: "Yes — no account, no credit card, and the full result renders on this page. Heavy usage is rate-limited per minute to keep the tool fast for everyone.",
-          zh: "免费——不需要账号和信用卡，完整结果就在本页显示。为了保证所有人的速度，每分钟的生成次数有上限。",
-          "zh-tw": "免費——不需要帳號和信用卡，完整結果就在本頁顯示。為了保證所有人的速度，每分鐘的生成次數有上限。",
+          en: "Yes. Sign in before generation so the model request can run securely. After sign-in, the complete candidate set and its review notes render on this page.",
+          zh: "需要。生成前请先登录，以便安全运行模型请求；登录后，完整候选和复核说明会直接显示在本页。",
+          "zh-tw": "需要。產生前請先登入，以便安全執行模型請求；登入後，完整候選與複核說明會直接顯示在本頁。",
         },
       },
     ],

package/src/features/tools/twitter-gif-downloader/twitter-gif-downloader.container.tsx

@@ -40,14 +40,13 @@ export async function TwitterGifDownloaderContainer({ locale, spec }: ToolPagePr
     <ToolPageShell
       locale={locale}
       spec={spec}
-      heroVariant="immersive"
-      heroBackgroundImage="/tools/twitter-gif-downloader-hero.webp"
-      heroBackgroundAlt={t("heroVisualAlt")}
+      showDefaultHeader={false}
     >
       <ToolWorkspaceSection
         heading={t("workspaceHeading")}
         hint={t("workspaceHint")}
         badge={t("workspaceBadge")}
+        headingLevel="h1"
       >
         <TwitterGifDownloader />
       </ToolWorkspaceSection>

package/src/features/tools/twitter-gif-downloader/twitter-gif-downloader.spec.ts

@@ -5,7 +5,7 @@ export const twitterGifDownloaderSpec: ToolSpec = {
   toolType: "downloader",
   seo: {
     "publishedAt": "2026-06-29",
-    "updatedAt": "2026-08-04",
+    "updatedAt": "2026-08-30",
     "readingTime": "5 min",
     "featured": false,
     "ogImage": "/tools/twitter-gif-downloader-hero.webp"

package/src/i18n/messages/en/tools/app-icon-resizer.ts

@@ -21,7 +21,7 @@ const appIconResizer = {
   guide: {
     heroVisualAlt:
       "App icon asset package visual showing one source icon exported into store submission, Xcode, and Android launcher files.",
-    workspaceHeading: "App icon package generator",
+    workspaceHeading: "App Icon Resizer and Asset Package",
     workspaceHint:
       "One source, one local ZIP for store and engineering handoff.",
     workspaceBadge: "PNG + ZIP",

package/src/i18n/messages/en/tools/app-store-screenshot-generator.ts

@@ -16,9 +16,9 @@ const appStoreScreenshotGenerator = {
   guide: {
     heroVisualAlt:
       "Hero visual for an app store listing image generator, showing a complete app store screenshot set.",
-    workspaceHeading: "Upload UI screenshots to generate listing images",
+    workspaceHeading: "App Store Screenshot Generator",
     workspaceHint:
-      "Upload real UI screenshots. A cloud Agent uses Skills-OL to fetch supporting context, plan the complete set, and submit live image tasks.",
+      "Upload real UI screenshots. An online image generation workflow reads supporting context, plans the complete set, and submits live image tasks.",
     whatYouGetHeading: "What you get after generation",
     valueVisualAlt:
       "App store listing image export bundle with phone screenshots, a feature graphic, PNG files, and SVG files.",
@@ -78,7 +78,7 @@ const appStoreScreenshotGenerator = {
     supportBody: [
       "You must upload local UI screenshots. Product URL, App Store or Google Play links, product name, and selling points provide supporting context for title, description, and page-summary clues.",
       "Apple App Store and Google Play directions are supported, including complete screenshot sets, portrait screenshots, and feature graphics.",
-      "This version uses a cloud Agent and Skills-OL to submit live image tasks, but it does not connect to App Store Connect or Google Play Console.",
+      "This version uses an online image generation workflow to submit live image tasks, but it does not connect to App Store Connect or Google Play Console.",
       "If a screenshot includes test accounts, real users, private data, or unauthorized brands, redact it before use.",
       "If no result appears, check that the URL is not empty, the uploaded file is PNG/JPG/WebP, browser file reading is allowed, and the selected input source matches your data.",
       "Before real submission, review the latest platform dimensions, review policies, trademark or copyright permissions, privacy content, copy claims, and readability on target devices.",

package/src/i18n/messages/en/tools/cold-start-channel-selector.ts

@@ -1,8 +1,8 @@
 const coldStartChannelSelector = {
   meta: {
-    title: "Growth Channel Strategy Generator",
-    description: "Build a growth channel strategy for an early product. Add your product, audience, time, and budget to choose the first channel to test and the signal that guides the next step.",
-    intro: "Choose the first growth channel to test, then use real signals to decide what comes next.",
+    title: "Customer Acquisition Channel Selector",
+    description: "Choose customer acquisition channels to test first. Add your product, audience, time, and budget to get ranked options, first actions, and validation signals.",
+    intro: "Choose the first customer acquisition channel to test, then use real signals to decide what comes next.",
     category: "Growth strategy tools",
     keywords: [
       "customer acquisition channels",
@@ -33,7 +33,7 @@ const coldStartChannelSelector = {
     },
   ],
   guide: {
-    workspaceTitle: "Growth Channel Strategy",
+    workspaceTitle: "Choose the First Customer Acquisition Channels to Test",
     workspaceHint:
       "Add your product, customer, time, and budget. Get a growth channel strategy to test, why it fits, and the signal that tells you what to do next.",
     workspaceBadge: "Early-stage growth channel strategy",

package/src/i18n/messages/en/tools/competitor-analysis.ts

@@ -1,7 +1,7 @@
 const competitorAnalysis = {
   meta: {
-    title: "Competitor Analysis Tool",
-    description: "Enter a competitor's URL and a cloud agent researches public signals into a structured profile: overview, traffic and growth, business scale, team, and funding — with sources and confidence.",
+    title: "AI Competitor Analysis Tool: Sources",
+    description: "Enter a competitor URL and get a sourced profile of its product, traffic, growth, business scale, team, and funding, with confidence shown for each finding.",
     intro: "Turn a single competitor URL into a one-page profile. Built from public web and search signals, every dimension shows its confidence so you can act on positioning, growth, and competitive decisions.",
     category: "Market research tools",
     keywords: [
@@ -37,10 +37,10 @@ const competitorAnalysis = {
     running: "Researching…",
     emptyTitle: "The competitor profile will appear here",
     emptyHint:
-      "Enter a competitor URL and a cloud agent researches public signals into a structured profile.",
+      "Enter a competitor URL and an online research workflow turns public signals into a structured profile.",
     runningTitle: "Researching this competitor",
     runningHint:
-      "The agent is reading the site and searching public signals for traffic, scale, team, and funding. This usually takes 1-3 minutes.",
+      "The research workflow is reading the site and searching public signals for traffic, scale, team, and funding. This usually takes 1-3 minutes.",
     status: {
       default: "Researching",
       PENDING: "Queued",
@@ -126,21 +126,25 @@ const competitorAnalysis = {
     },
   },
   guide: {
+    workspaceHeading: "AI Competitor Analysis Tool",
+    workspaceHint: "Enter a public competitor URL to build a sourced profile with confidence and unknowns shown for every major finding.",
+    workspaceBadge: "Public sources only",
     visualAlt: {
-      hero: "Competitor profile report preview (visual pending)",
-      howToUse: "Competitor analysis workflow illustration (visual pending)",
-      result: "Competitor profile result guidance illustration (visual pending)",
+      hero: "Competitor profile report with sourced findings and confidence levels.",
+      howToUse: "Workflow from a public competitor URL to a sourced competitor profile.",
+      result: "Competitor findings separated into evidence, estimates, confidence, and unknowns.",
+      useCases: "Teams applying competitor research to positioning, pricing, and launch decisions.",
     },
     howToUseKicker: "How it works",
     howToUse: "How to analyze a competitor",
     howToUseSteps: [
       "Paste the competitor's public website URL; optionally add a name and the dimensions you care about.",
-      "A cloud agent reads the site and searches public signals for traffic, scale, team, and funding.",
+      "An online research workflow reads the site and searches public signals for traffic, scale, team, and funding.",
       "Results come back as a structured profile — each dimension shows confidence and degrades instead of inventing data.",
       "Start with the overview and traffic trend, then turn “Positioning & openings” into your own positioning, pricing, or channel hypotheses.",
     ],
     runtimeNote:
-      "Research runs on a cloud agent using public web and search only. The page renders the structured result only — no local template fallback.",
+      "Research runs through an online workflow using public web and search only. The page renders the structured result only — no local template fallback.",
     resultKicker: "Result guidance",
     resultGuidance: "How to read the profile",
     guidanceBullets: [
@@ -174,7 +178,7 @@ const competitorAnalysis = {
       {
         question: "Does it access private or logged-in pages?",
         answer:
-          "No. The agent reads public pages and public search results only — it does not crawl private, authenticated, or paywalled content.",
+          "No. The research workflow reads public pages and public search results only — it does not crawl private, authenticated, or paywalled content.",
       },
       {
         question: "What should I do with the result?",