From 27173e07618e14df66f1c1f7f4f318792861439c Mon Sep 17 00:00:00 2001
From: "similai.tw" <similai.tw@gmail.com>
Date: Mon, 22 Jun 2026 18:11:27 +0800
Subject: [PATCH] Add static subject designer catalog

---
 .gitignore                            |  1 +
 README.md                             |  2 +
 package-lock.json                     |  4 +-
 package.json                          |  2 +-
 src/components/SettingsPanel.tsx      |  3 +-
 src/components/SubjectDesigner.tsx    | 23 ++++++++
 src/components/TaskPanel.tsx          |  3 ++
 src/domain/project.test.ts            |  7 +--
 src/domain/project.ts                 | 34 ++++++++----
 src/domain/subjectCatalog.test.ts     |  8 +++
 src/domain/subjectCatalog.ts          | 77 +++++++++++++++++++++++++++
 src/domain/subjectDescription.test.ts |  9 ++++
 src/domain/subjectDescription.ts      | 36 +++++++++++++
 src/domain/types.ts                   | 16 +++++-
 src/domain/validation.ts              |  2 +
 src/providers/tasks.test.ts           |  4 +-
 src/providers/tasks.ts                | 13 +++--
 src/styles.css                        |  1 +
 tests/e2e/smoke.spec.ts               | 14 +++--
 19 files changed, 232 insertions(+), 27 deletions(-)
 create mode 100644 src/components/SubjectDesigner.tsx
 create mode 100644 src/domain/subjectCatalog.test.ts
 create mode 100644 src/domain/subjectCatalog.ts
 create mode 100644 src/domain/subjectDescription.test.ts
 create mode 100644 src/domain/subjectDescription.ts

diff --git a/.gitignore b/.gitignore
index 6451a32..773fd31 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,3 +8,4 @@ playwright-report/
 .env.*
 !.env.example
 .vercel
+firebase-debug.log*
diff --git a/README.md b/README.md
index 2a9c81e..9dafd87 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,8 @@
 - 靜態、動態、自訂文字、訊息、大貼圖、彈出式與特效背景七種類型。
 - 每個專案只需一份 ChatGPT／Gemini 完整 Markdown 任務，可下載、重新匯入及保存產圖紀錄。
 - 最多 5 張人物、寵物或角色參考照片，本機 IndexedDB 保存並隨專案 ZIP 備份。
+- v5 靜態角色題材設計：6 大類、110 個原創子項目、角色設定、個性與道具組合。
+- 有照片時自動建立安全的外觀分析指令；無照片時可選熱門趨勢題材或完全自訂主體。
 - 2–8 行列候選網格，預設 3×3 生成 9 張候選並選出 8 張 LINE 貼圖。
 - 40 個分類、400 組台灣繁中常用語，以及自訂詞庫匯入／匯出。
 - 16 種主風格與配色、描邊、上色、造型組合。
diff --git a/package-lock.json b/package-lock.json
index 3012ac5..ddcf8e4 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "line-sticker-studio",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "line-sticker-studio",
-      "version": "4.0.0",
+      "version": "5.0.0",
       "license": "MIT",
       "dependencies": {
         "@vitejs/plugin-react": "latest",
diff --git a/package.json b/package.json
index 997fac6..5fb7bdc 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "line-sticker-studio",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "private": true,
   "description": "ChatGPT and Gemini assisted LINE sticker creation studio with local compliance validation",
   "license": "MIT",
diff --git a/src/components/SettingsPanel.tsx b/src/components/SettingsPanel.tsx
index 0a9c1c1..2a2b574 100644
--- a/src/components/SettingsPanel.tsx
+++ b/src/components/SettingsPanel.tsx
@@ -1,6 +1,7 @@
 import { getSpec } from '../domain/specs';
 import { fillCaptionSlots, RECOMMENDED_GRIDS } from '../domain/project';
 import { useProject } from '../state/ProjectContext';
+import { SubjectDesigner } from './SubjectDesigner';
 
 export function SettingsPanel() {
   const { project, updateSettings, dispatch } = useProject(); const { settings } = project; const spec = getSpec(project.type); const cellCount = settings.rows * settings.columns;
@@ -11,7 +12,7 @@ export function SettingsPanel() {
     dispatch({ type: 'update', patch: { settings: { ...settings, rows, columns }, captionSlots: fillCaptionSlots(project.captionSlots, cells), stickers: [] } }); }
   return <aside className="settings-panel panel">
     <div className="section-heading compact"><span>2</span><div><h2>設計設定</h2><p>{spec.label} · 最大 {spec.width}×{spec.height}</p></div></div>
-    <label className="field"><span>角色描述</span><textarea rows={5} value={settings.character} onChange={(e) => updateSettings({ character: e.target.value })} /></label>
+    <SubjectDesigner />
     <div className="field-grid"><label className="field"><span>LINE 入選張數</span><select value={settings.count} onChange={(e) => setCount(Number(e.target.value) as typeof settings.count)}>
       {spec.counts.map((count) => <option key={count} value={count}>{count} 張</option>)}</select></label>
       <label className="field"><span>生成格數</span><strong className="grid-total">{settings.rows}×{settings.columns}＝{cellCount} 格</strong></label></div>
diff --git a/src/components/SubjectDesigner.tsx b/src/components/SubjectDesigner.tsx
new file mode 100644
index 0000000..6e0609d
--- /dev/null
+++ b/src/components/SubjectDesigner.tsx
@@ -0,0 +1,23 @@
+import { buildSubjectDescription } from '../domain/subjectDescription';
+import { getSubjectCatalog } from '../domain/subjectCatalog';
+import type { SubjectProfile } from '../domain/types';
+import { useProject } from '../state/ProjectContext';
+
+export function SubjectDesigner(){
+  const {project,dispatch}=useProject(),catalog=getSubjectCatalog(),profile=project.subjectProfile,photoMode=project.referencePhotos.length>0;
+  const items=catalog.items.filter((item)=>item.categoryId===profile.categoryId).sort((a,b)=>Number(b.trend)-Number(a.trend)||a.sortOrder-b.sortOrder);
+  const update=(patch:Partial<SubjectProfile>)=>dispatch({type:'update',patch:{subjectProfile:{...profile,...patch,catalogVersion:catalog.version}}});
+  const toggle=(key:'personalityIds'|'propIds',id:string)=>{const current=profile[key];if(current.includes(id))return update({[key]:current.filter((item)=>item!==id)});if(current.length>=2)return;update({[key]:[...current,id]});};
+  const description=buildSubjectDescription(profile,project.referencePhotos);
+  return <div className="subject-designer"><div className="subject-heading"><div><strong>角色題材</strong><small>{photoMode?'照片決定外觀，選項補充角色設定':`內建題材 · ${catalog.items.length} 個子項目`}</small></div><span>{photoMode?'照片模式':profile.baseMode==='catalog'?'內建題材':'自訂主體'}</span></div>
+    {!photoMode&&<div className="mode-switch"><button className={profile.baseMode==='catalog'?'active':''} onClick={()=>update({baseMode:'catalog'})}>內建題材</button><button className={profile.baseMode==='custom'?'active':''} onClick={()=>update({baseMode:'custom'})}>自訂主體</button></div>}
+    {!photoMode&&profile.baseMode==='catalog'&&<div className="field-grid"><label className="field"><span>類別</span><select value={profile.categoryId} onChange={(event)=>{const categoryId=event.target.value;const first=catalog.items.filter((item)=>item.categoryId===categoryId).sort((a,b)=>Number(b.trend)-Number(a.trend)||a.sortOrder-b.sortOrder)[0];update({categoryId,itemId:first.id});}}>{catalog.categories.sort((a,b)=>a.sortOrder-b.sortOrder).map((item)=><option key={item.id} value={item.id}>{item.label}</option>)}</select></label>
+      <label className="field"><span>子項目</span><select value={profile.itemId} onChange={(event)=>update({itemId:event.target.value})}>{items.map((item)=><option key={item.id} value={item.id}>{item.trend?'🔥 ':''}{item.label}</option>)}</select></label></div>}
+    {!photoMode&&profile.baseMode==='custom'&&<label className="field"><span>自訂主體</span><input value={profile.customSubject} placeholder="例如：戴圓眼鏡的原創雲朵郵差" onChange={(event)=>update({customSubject:event.target.value})}/></label>}
+    <label className="field"><span>角色設定</span><select value={profile.roleId} onChange={(event)=>update({roleId:event.target.value})}>{catalog.roles.map((item)=><option key={item.id} value={item.id}>{item.trend?'🔥 ':''}{item.label}</option>)}</select></label>
+    <fieldset className="choice-group"><legend>個性（最多 2 個）</legend><div>{catalog.personalities.map((item)=><label className={profile.personalityIds.includes(item.id)?'selected':''} key={item.id}><input type="checkbox" checked={profile.personalityIds.includes(item.id)} disabled={!profile.personalityIds.includes(item.id)&&profile.personalityIds.length>=2} onChange={()=>toggle('personalityIds',item.id)}/>{item.trend?'🔥 ':''}{item.label}</label>)}</div></fieldset>
+    <fieldset className="choice-group"><legend>道具（最多 2 個）</legend><div>{catalog.props.filter((item)=>item.id!=='none').map((item)=><label className={profile.propIds.includes(item.id)?'selected':''} key={item.id}><input type="checkbox" checked={profile.propIds.includes(item.id)} disabled={!profile.propIds.includes(item.id)&&profile.propIds.length>=2} onChange={()=>toggle('propIds',item.id)}/>{item.label}</label>)}</div></fieldset>
+    <label className="field"><span>補充描述</span><textarea rows={3} value={profile.extraDetails} placeholder="例如：穿著淺藍襯衫、動作幅度大" onChange={(event)=>update({extraDetails:event.target.value})}/></label>
+    <div className="subject-preview"><div><strong>產圖敘述預覽</strong><button onClick={()=>void navigator.clipboard.writeText(description)}>複製</button></div><p>{description}</p><small>題材資料：{catalog.sourceLabel} · {catalog.version}</small></div>
+  </div>;
+}
diff --git a/src/components/TaskPanel.tsx b/src/components/TaskPanel.tsx
index aa95add..0841f89 100644
--- a/src/components/TaskPanel.tsx
+++ b/src/components/TaskPanel.tsx
@@ -4,6 +4,7 @@ import { buildTaskMarkdown, createGenerationTask, parseTaskMarkdown, providerUrl
 import type { GenerationTask } from '../domain/types';
 import { fillCaptionSlots } from '../domain/project';
 import { getReferencePhoto } from '../storage/referencePhotos';
+import { validateSubjectProfile } from '../domain/subjectDescription';
 import { useProject } from '../state/ProjectContext';
 
 export function TaskPanel() {
@@ -12,6 +13,7 @@ export function TaskPanel() {
   async function create() {
     setError('');
     if (project.captionSlots.length !== cellCount) return setError(`每個候選格都需要文字／動作，目前 ${project.captionSlots.length}/${cellCount}`);
+    const subjectIssues=validateSubjectProfile(project.subjectProfile,project.referencePhotos.length>0);if(subjectIssues.length)return setError(subjectIssues[0]);
     if (project.referencePhotos.length && !project.photoRightsConfirmed) return setError('請先確認參考照片使用權與肖像同意');
     for (const photo of project.referencePhotos) if (!await getReferencePhoto(photo.id)) return setError(`找不到參考照片：${photo.name}`);
     const task = createGenerationTask(project); const markdown = buildTaskMarkdown(project, task);
@@ -26,6 +28,7 @@ export function TaskPanel() {
     try { const manifest = parseTaskMarkdown(await file.text()); const targetCount = (manifest.targetCount ?? manifest.count) as typeof project.settings.count; const cells = manifest.cellCount ?? manifest.count;
       dispatch({ type: 'update', patch: (current) => ({ ...current, generationProvider: manifest.provider,
         settings: { ...current.settings, character: manifest.character, count: targetCount, rows: manifest.rows, columns: manifest.columns },
+        subjectProfile: manifest.subjectProfile ?? { ...current.subjectProfile, baseMode: 'custom', customSubject: '', roleId: 'none', personalityIds: [], propIds: [], extraDetails: manifest.character },
         captionSlots: fillCaptionSlots(manifest.captions.map((item) => ({ id: crypto.randomUUID(), phraseId: `md-${item.index}`, text: item.text, category: 'MD 匯入', intent: item.intent, visible: item.visible })), cells),
       }) }); setError('');
     } catch (reason) { setError(reason instanceof Error ? reason.message : 'MD 匯入失敗'); }
diff --git a/src/domain/project.test.ts b/src/domain/project.test.ts
index ed4067b..7d6598d 100644
--- a/src/domain/project.test.ts
+++ b/src/domain/project.test.ts
@@ -9,11 +9,12 @@ describe('貼圖專案', () => {
     const project = createProject('big');
     expect(parseProject(serializeProject(project)).type).toBe('big');
   });
-  it('可以把 v2 文字與共用影格遷移到 v4', () => {
+  it('可以把 v2 文字與共用影格遷移到 v5', () => {
     const legacy = { version: 2, name: '舊專案', type: 'static', settings: { character: '熊', phrases: '收到,謝謝', count: 8, columns: 4, padding: 10, fontSize: 42, loops: 1 }, sourceDataUrl: '', stickers: [], frames: [], updatedAt: 1 };
     const project = parseProject(JSON.stringify(legacy));
-    expect(project.version).toBe(4);
+    expect(project.version).toBe(5);
     expect(project.captionSlots.map((item) => item.text)).toEqual(['收到', '謝謝']);
   });
-  it('可以把 v3 網格與候選狀態遷移到 v4',()=>{const current=createProject();const legacy={...current,version:3,settings:{character:current.settings.character,count:8,columns:4,padding:10,fontSize:42,loops:1}};delete (legacy as Partial<typeof current>).referencePhotos;delete (legacy as Partial<typeof current>).photoRightsConfirmed;const project=parseProject(JSON.stringify(legacy));expect(project.version).toBe(4);expect(project.settings.rows).toBe(2);expect(project.referencePhotos).toEqual([]);});
+  it('可以把 v3 網格與候選狀態遷移到 v5',()=>{const current=createProject();const legacy={...current,version:3,settings:{character:'舊角色',count:8,columns:4,padding:10,fontSize:42,loops:1}};delete (legacy as Partial<typeof current>).referencePhotos;delete (legacy as Partial<typeof current>).photoRightsConfirmed;delete (legacy as Partial<typeof current>).subjectProfile;const project=parseProject(JSON.stringify(legacy));expect(project.version).toBe(5);expect(project.settings.rows).toBe(2);expect(project.referencePhotos).toEqual([]);expect(project.subjectProfile.extraDetails).toBe('舊角色');});
+  it('可以把 v4 角色描述遷移到 v5',()=>{const current=createProject();const legacy={...current,version:4,settings:{...current.settings,character:'戴眼鏡的舊角色'}};delete (legacy as Partial<typeof current>).subjectProfile;const project=parseProject(JSON.stringify(legacy));expect(project.version).toBe(5);expect(project.subjectProfile.extraDetails).toBe('戴眼鏡的舊角色');});
 });
diff --git a/src/domain/project.ts b/src/domain/project.ts
index 5085f6d..12a92d9 100644
--- a/src/domain/project.ts
+++ b/src/domain/project.ts
@@ -1,11 +1,16 @@
 import { getSpec } from './specs';
-import type { CaptionSlot, StickerProject, StickerType, StyleRecipe } from './types';
+import { SUBJECT_CATALOG_VERSION } from './subjectCatalog';
+import type { CaptionSlot, StickerProject, StickerType, StyleRecipe, SubjectProfile } from './types';
 
 const DEFAULT_CAPTIONS = ['收到', 'OK', '謝謝', '加油', '等一下', '太棒了', '哭哭', '晚安', '讚啦'];
 
 export const DEFAULT_STYLE: StyleRecipe = {
   primary: 'mascot', palette: 'vivid', outline: 'bold', rendering: 'soft', shape: 'rounded',
 };
+export const DEFAULT_SUBJECT_PROFILE: SubjectProfile = {
+  catalogVersion: SUBJECT_CATALOG_VERSION, baseMode: 'catalog', categoryId: 'animals', itemId: 'taiwan-black-bear', customSubject: '',
+  roleId: 'office-life', personalityIds: ['dramatic'], propIds: [], extraDetails: '',
+};
 
 function slot(text: string, index: number): CaptionSlot {
   return { id: crypto.randomUUID(), phraseId: `legacy-${index}`, text, category: '基本回應', intent: text, visible: true };
@@ -14,9 +19,10 @@ function slot(text: string, index: number): CaptionSlot {
 export function createProject(type: StickerType = 'static'): StickerProject {
   const spec = getSpec(type);
   return {
-    version: 4, name: '我的 LINE 貼圖', type, generationProvider: 'chatgpt',
-    settings: { character: '一隻圓滾滾的台灣黑熊，上班族襯衫，表情誇張可愛', count: spec.counts[0], rows: 3, columns: 3, padding: 10, fontSize: 42, loops: spec.minLoops ?? 1 },
+    version: 5, name: '我的 LINE 貼圖', type, generationProvider: 'chatgpt',
+    settings: { character: '', count: spec.counts[0], rows: 3, columns: 3, padding: 10, fontSize: 42, loops: spec.minLoops ?? 1 },
     captionSlots: DEFAULT_CAPTIONS.map(slot), styleRecipe: DEFAULT_STYLE,
+    subjectProfile: { ...DEFAULT_SUBJECT_PROFILE, personalityIds: [...DEFAULT_SUBJECT_PROFILE.personalityIds], propIds: [] },
     referencePhotos: [], photoRightsConfirmed: false,
     sourceDataUrl: '', stickers: [], animationSets: {}, generationTasks: [], generationAttempts: [],
     rightsConfirmed: false, complianceReport: { checkedAt: 0, blockingCount: 0, warningCount: 0 }, updatedAt: Date.now(),
@@ -40,9 +46,10 @@ interface V2Project {
   sourceDataUrl: string; stickers: StickerProject['stickers']; frames?: StickerProject['animationSets'][string]; updatedAt: number;
 }
 
-interface V3Project extends Omit<StickerProject, 'version' | 'settings' | 'referencePhotos' | 'photoRightsConfirmed'> {
+interface V3Project extends Omit<StickerProject, 'version' | 'settings' | 'referencePhotos' | 'photoRightsConfirmed' | 'subjectProfile'> {
   version: 3; settings: Omit<StickerProject['settings'], 'rows'>;
 }
+interface V4Project extends Omit<StickerProject, 'version' | 'subjectProfile'> { version: 4 }
 
 export function migrateV2(value: V2Project): StickerProject {
   const base = createProject(value.type);
@@ -50,7 +57,7 @@ export function migrateV2(value: V2Project): StickerProject {
   const stickers = (value.stickers || []).map((asset, index) => ({ ...asset, provenanceMark: asset.provenanceMark ?? 'unknown' as const,
     gridIndex: index, included: index < value.settings.count, selectedAt: index < value.settings.count ? index + 1 : undefined }));
   const firstId = stickers[0]?.id;
-  return { ...base, name: value.name, settings: { ...base.settings, character: value.settings.character, count: value.settings.count, columns: value.settings.columns, padding: value.settings.padding, fontSize: value.settings.fontSize, loops: value.settings.loops },
+  return { ...base, name: value.name, settings: { ...base.settings, character: value.settings.character, count: value.settings.count, columns: value.settings.columns, padding: value.settings.padding, fontSize: value.settings.fontSize, loops: value.settings.loops }, subjectProfile: legacySubject(value.settings.character),
     captionSlots: phrases.map(slot), sourceDataUrl: value.sourceDataUrl, stickers,
     animationSets: firstId && value.frames?.length ? { [firstId]: value.frames } : {}, updatedAt: value.updatedAt };
 }
@@ -60,13 +67,21 @@ export function migrateV3(value: V3Project): StickerProject {
   const count = value.settings.count;
   const columns = Math.min(8, Math.max(2, value.settings.columns || 3));
   const rows = Math.min(8, Math.max(2, Math.ceil(count / columns)));
-  return { ...value, version: 4, settings: { ...value.settings, rows, columns },
+  return { ...value, version: 5, settings: { ...value.settings, rows, columns },
     captionSlots: fillCaptionSlots(value.captionSlots, rows * columns),
     stickers: value.stickers.map((asset, index) => ({ ...asset, gridIndex: index, included: index < count, selectedAt: index < count ? index + 1 : undefined })),
-    referencePhotos: [], photoRightsConfirmed: false,
+    referencePhotos: [], photoRightsConfirmed: false, subjectProfile: legacySubject(value.settings.character),
     complianceReport: value.complianceReport ?? base.complianceReport };
 }
 
+export function migrateV4(value: V4Project): StickerProject {
+  return { ...value, version: 5, subjectProfile: legacySubject(value.settings.character) };
+}
+
+function legacySubject(character: string): SubjectProfile {
+  return { ...DEFAULT_SUBJECT_PROFILE, baseMode: 'custom', customSubject: '', personalityIds: [], propIds: [], roleId: 'none', extraDetails: character || '' };
+}
+
 export function fillCaptionSlots(items: CaptionSlot[], count: number): CaptionSlot[] {
   const result = items.slice(0, count);
   for (let index = result.length; index < count; index += 1) result.push(slot(DEFAULT_CAPTIONS[index % DEFAULT_CAPTIONS.length], index));
@@ -79,9 +94,10 @@ export const RECOMMENDED_GRIDS: Record<number, { rows: number; columns: number }
 };
 
 export function parseProject(raw: string): StickerProject {
-  const value = JSON.parse(raw) as StickerProject | V3Project | V2Project;
+  const value = JSON.parse(raw) as StickerProject | V4Project | V3Project | V2Project;
   if (value.version === 2) return migrateV2(value);
   if (value.version === 3) return migrateV3(value);
-  if (value.version !== 4 || !value.type || !value.settings) throw new Error('不支援的專案格式');
+  if (value.version === 4) return migrateV4(value);
+  if (value.version !== 5 || !value.type || !value.settings || !value.subjectProfile) throw new Error('不支援的專案格式');
   return value;
 }
diff --git a/src/domain/subjectCatalog.test.ts b/src/domain/subjectCatalog.test.ts
new file mode 100644
index 0000000..967f923
--- /dev/null
+++ b/src/domain/subjectCatalog.test.ts
@@ -0,0 +1,8 @@
+import { getSubjectCatalog, SUBJECT_CATALOG_VERSION } from './subjectCatalog';
+
+describe('靜態角色題材庫',()=>{
+  const catalog=getSubjectCatalog();
+  it('提供版本化的 6 類與至少 100 個子項目',()=>{expect(catalog.version).toBe(SUBJECT_CATALOG_VERSION);expect(catalog.categories.length).toBeGreaterThanOrEqual(6);expect(catalog.items.length).toBeGreaterThanOrEqual(100);});
+  it('類別與子項目 ID 唯一',()=>{expect(new Set(catalog.categories.map((item)=>item.id)).size).toBe(catalog.categories.length);expect(new Set(catalog.items.map((item)=>item.id)).size).toBe(catalog.items.length);});
+  it('每類熱門題材優先排序且不含已知品牌角色名',()=>{for(const category of catalog.categories){const items=catalog.items.filter((item)=>item.categoryId===category.id).sort((a,b)=>Number(b.trend)-Number(a.trend)||a.sortOrder-b.sortOrder);const firstNonTrend=items.findIndex((item)=>!item.trend);expect(items.slice(Math.max(0,firstNonTrend)).some((item)=>item.trend)).toBe(false);}const content=JSON.stringify(catalog);for(const banned of ['Hello Kitty','Snoopy','海綿寶寶','小熊維尼','迪士尼','三麗鷗'])expect(content).not.toContain(banned);});
+});
diff --git a/src/domain/subjectCatalog.ts b/src/domain/subjectCatalog.ts
new file mode 100644
index 0000000..4cbfd42
--- /dev/null
+++ b/src/domain/subjectCatalog.ts
@@ -0,0 +1,77 @@
+import type { CatalogSnapshot, SubjectCategory, SubjectItem, SubjectOption } from './types';
+
+export const SUBJECT_CATALOG_VERSION = '2026-06-22-tw-top30-v1';
+
+const categories: SubjectCategory[] = [
+  ['animals','動物','高辨識度、適合誇張表情與肢體動作',1],['plants','花草植栽','柔和療癒、季節與自然題材',2],
+  ['food','食物飲品','圓潤可愛、適合日常與節慶',3],['objects','生活物品','把熟悉用品擬人化成貼圖角色',4],
+  ['people','人物原型','原創人物職業與生活角色',5],['fantasy','幻想自然','不依賴既有 IP 的原創幻想角色',6],
+].map(([id,label,description,sortOrder])=>({id:String(id),label:String(label),description:String(description),sortOrder:Number(sortOrder)}));
+
+type RawItem=[string,string,string,boolean?];
+const raw:Record<string,RawItem[]>={
+  animals:[
+    ['cat','貓咪','an original round cat with readable ears and tail',true],['corgi','柯基犬','an original short-legged corgi with expressive ears',true],['rabbit','兔子','an original soft rabbit with long expressive ears',true],
+    ['duck','小鴨','an original plump yellow duck with a simple beak',true],['chicken','小雞','an original tiny chicken with lively wings',true],['bear','小熊','an original round bear with a friendly silhouette',true],
+    ['pig','小豬','an original pink pig with a round snout',true],['monkey','猴子','an original playful monkey with a curled tail',true],['frog','青蛙','an original green frog with large expressive eyes',true],
+    ['golden-retriever','黃金獵犬','an original fluffy golden retriever'],['chihuahua','吉娃娃','an original tiny chihuahua with oversized ears'],['dachshund','臘腸狗','an original long-bodied dachshund'],
+    ['shiba','柴犬','an original compact shiba dog'],['penguin','企鵝','an original round penguin'],['seal','海豹','an original soft baby seal'],['otter','水獺','an original cheerful otter'],
+    ['hamster','倉鼠','an original tiny hamster with full cheeks'],['capybara','水豚','an original calm capybara'],['shark','鯊魚','an original friendly baby shark'],['jellyfish','水母','an original translucent jellyfish'],
+    ['owl','貓頭鷹','an original wise round owl'],['fox','狐狸','an original warm-colored fox'],['tiger','老虎','an original friendly striped tiger'],['taiwan-black-bear','台灣黑熊','an original black bear with a white chest mark'],
+  ],
+  plants:[
+    ['sunflower','向日葵','a cheerful anthropomorphic sunflower'],['daisy','小雛菊','a gentle anthropomorphic daisy'],['rose','玫瑰','an elegant original rose character'],['tulip','鬱金香','a rounded tulip character'],
+    ['cherry-blossom','櫻花','an original cherry blossom spirit'],['lavender','薰衣草','a calming lavender bundle character'],['cactus','仙人掌','a soft-spined cute cactus'],['succulent','多肉植物','a plump succulent in a tiny pot'],
+    ['mushroom','小蘑菇','an original spotted mushroom character'],['clover','幸運草','a four-leaf clover mascot'],['fern','蕨類','a curled young fern spirit'],['bamboo','小竹子','an original bamboo shoot character'],
+    ['maple-leaf','楓葉','a warm autumn maple leaf character'],['sprout','小樹芽','a hopeful green sprout'],['bonsai','小盆栽','a miniature bonsai character'],['lotus','蓮花','a serene lotus character'],
+    ['hydrangea','繡球花','a clustered hydrangea character'],['monstera','龜背芋','a bold monstera leaf mascot'],
+  ],
+  food:[
+    ['egg','荷包蛋','a sunny fried egg character',true],['bread','吐司','a warm square toast character',true],['pudding','布丁','a jiggly caramel pudding'],['rice-ball','飯糰','a triangular rice ball character'],
+    ['bubble-tea','珍珠奶茶','an original bubble tea cup'],['coffee','咖啡杯','a warm coffee cup character'],['cake','小蛋糕','a celebratory cake slice'],['dumpling','水餃','a plump dumpling character'],
+    ['bao','小籠包','an original steaming soup dumpling'],['noodles','麵碗','a cozy noodle bowl'],['strawberry','草莓','a bright strawberry character'],['orange','橘子','a round citrus character'],
+    ['watermelon','西瓜','a refreshing watermelon slice'],['avocado','酪梨','a soft avocado character'],['cookie','餅乾','a crisp cookie character'],['ice-cream','冰淇淋','a colorful ice cream scoop'],
+    ['mochi','麻糬','a stretchy rice cake character'],['pineapple-cake','鳳梨酥','an original square pineapple pastry'],
+  ],
+  objects:[
+    ['phone','手機','an original anthropomorphic smartphone'],['laptop','筆記型電腦','a friendly laptop character'],['mug','馬克杯','a cozy ceramic mug'],['pillow','枕頭','a sleepy soft pillow',true],
+    ['alarm-clock','鬧鐘','an energetic alarm clock'],['umbrella','雨傘','a colorful umbrella character'],['backpack','背包','an adventurous backpack'],['shopping-bag','購物袋','a cheerful reusable shopping bag'],
+    ['pencil','鉛筆','a hardworking pencil'],['notebook','筆記本','an expressive notebook'],['stamp','印章','an original office stamp character'],['camera','相機','a curious camera character'],
+    ['headphones','耳機','a music-loving headphone character'],['game-controller','遊戲手把','an original game controller'],['lamp','小夜燈','a comforting bedside lamp'],['slipper','拖鞋','a lazy house slipper'],
+    ['tissue-box','面紙盒','a helpful tissue box'],['delivery-box','紙箱','an original cardboard delivery box'],
+  ],
+  people:[
+    ['office-worker','上班族','an original everyday office worker',true],['student','學生','an original diligent student'],['teacher','老師','an original friendly teacher'],['shopkeeper','店員','an original cheerful shop clerk'],
+    ['engineer','工程師','an original focused engineer'],['designer','設計師','an original creative designer'],['cook','料理人','an original home cook'],['nurse','護理師','an original caring medical worker'],
+    ['parent','家長','an original warm parent character'],['grandparent','活力長輩','an original energetic older adult'],['couple-avatar','情侶角色','an original affectionate couple character',true],['best-friend','好友角色','an original pair of close friends'],
+    ['homebody','宅家族','an original cozy homebody',true],['traveler','旅行者','an original curious traveler'],['athlete','運動愛好者','an original energetic sports fan'],['gardener','園藝愛好者','an original gentle gardener'],
+  ],
+  fantasy:[
+    ['cloud-spirit','雲朵精靈','an original fluffy cloud spirit'],['star-spirit','星星精靈','an original glowing star spirit'],['moon-rabbit','月光小獸','an original moonlit long-eared creature'],['tiny-dragon','迷你龍','an original tiny friendly dragon'],
+    ['forest-spirit','森林精靈','an original leafy forest spirit'],['water-spirit','水滴精靈','an original translucent water-drop spirit'],['fire-spirit','火焰精靈','an original warm flame spirit'],['stone-golem','石頭小巨人','an original gentle pebble golem'],
+    ['rainbow-creature','彩虹小獸','an original colorful fantasy creature'],['dream-blob','夢境軟泥','an original soft dream blob'],['paper-ghost','紙片幽靈','an original harmless paper ghost'],['sock-monster','襪子怪','an original mismatched sock creature'],
+    ['planet-baby','行星寶寶','an original tiny planet character'],['comet-child','彗星小孩','an original comet-tailed childlike spirit'],['tea-fairy','茶香精靈','an original tea-leaf fairy'],['clockwork-pet','發條寵物','an original small clockwork animal'],
+  ],
+};
+
+const items:SubjectItem[]=Object.entries(raw).flatMap(([categoryId,values])=>values.map(([id,label,prompt,trend=false],index)=>({id,categoryId,label,prompt,trend,sortOrder:(trend?0:100)+index})));
+const option=(values:[string,string,string,boolean?][]):SubjectOption[]=>values.map(([id,label,prompt,trend])=>({id,label,prompt,trend}));
+const roles=option([
+  ['none','不指定',''],['office-life','社畜上班族','living through relatable office work and overtime',true],['student-life','校園學生','living through everyday school moments'],['couple-life','甜蜜情侶','sharing affectionate couple interactions',true],
+  ['family-life','溫暖家人','sharing supportive family moments'],['home-life','宅家日常','enjoying a relaxed homebody routine',true],['traveler','旅行冒險','exploring places as a cheerful traveler'],['shop-clerk','親切店員','working as a friendly shop clerk'],
+  ['creator','創作者','working as an imaginative creator'],['foodie','美食愛好者','enthusiastically enjoying food'],['fitness','運動生活','living an energetic fitness lifestyle'],['healer','療癒陪伴','comforting and encouraging friends'],
+]);
+const personalities=option([
+  ['lazy','慵懶','relaxed, sleepy and adorably unhurried',true],['dramatic','反應誇張','highly expressive with exaggerated reactions',true],['funny','幽默搞笑','playful with harmless visual comedy',true],['sweet','溫柔甜美','warm, gentle and affectionate'],
+  ['optimistic','正向有活力','bright, optimistic and energetic'],['shy','害羞內向','shy with subtle reactions'],['grumpy','厭世吐槽','dryly grumpy but still lovable'],['polite','有禮貌','polite and considerate'],
+  ['confident','自信','confident and encouraging'],['clumsy','天然呆','innocently clumsy and absent-minded'],['cool','冷靜帥氣','calm and effortlessly cool'],['healing','療癒','soft, reassuring and comforting'],
+  ['mischievous','調皮','mischievous without being mean'],['romantic','浪漫','openly affectionate and romantic'],
+]);
+const props=option([
+  ['none','不指定',''],['phone','手機','a generic unbranded smartphone'],['laptop','筆電','a generic unbranded laptop'],['coffee','咖啡','a warm coffee mug'],['bubble-tea','珍奶','a generic bubble tea cup'],
+  ['pillow','枕頭','a soft pillow'],['blanket','毛毯','a cozy blanket'],['umbrella','雨傘','a simple umbrella'],['backpack','背包','a compact backpack'],['flower','花束','a small seasonal flower bouquet'],
+  ['snack','零食','a generic snack bag without logos'],['book','書本','a plain book'],['headphones','耳機','generic headphones'],['sign','手拿牌','a blank handheld sign'],['heart','愛心','simple floating heart symbols'],['sparkle','閃光','small decorative sparkles'],
+]);
+
+const snapshot:CatalogSnapshot={version:SUBJECT_CATALOG_VERSION,generatedAt:'2026-06-22T00:00:00+08:00',sourceLabel:'LINE STORE 台灣熱門前30題材人工摘要（不含品牌與角色名稱）',categories,items,roles,personalities,props};
+export function getSubjectCatalog():CatalogSnapshot{return snapshot;}
diff --git a/src/domain/subjectDescription.test.ts b/src/domain/subjectDescription.test.ts
new file mode 100644
index 0000000..2606c15
--- /dev/null
+++ b/src/domain/subjectDescription.test.ts
@@ -0,0 +1,9 @@
+import { createProject } from './project';
+import { buildSubjectDescription, validateSubjectProfile } from './subjectDescription';
+
+describe('角色敘述產生器',()=>{
+  it('無照片時使用內建題材',()=>{const project=createProject();const text=buildSubjectDescription(project.subjectProfile,[]);expect(text).toContain('black bear');expect(text).toContain('office work');});
+  it('自訂模式使用自訂主體',()=>{const project=createProject();project.subjectProfile={...project.subjectProfile,baseMode:'custom',customSubject:'戴圓眼鏡的雲朵郵差',roleId:'none',personalityIds:[],propIds:[]};expect(buildSubjectDescription(project.subjectProfile,[])).toContain('戴圓眼鏡的雲朵郵差');});
+  it('照片模式只使用照片外觀，不混入內建主體',()=>{const project=createProject();const photo={id:'p',name:'me.jpg',type:'image/jpeg' as const,width:100,height:100,bytes:10,hash:'x',order:0,primary:true};const text=buildSubjectDescription(project.subjectProfile,[photo]);expect(text).toContain('me.jpg');expect(text).toContain('non-sensitive');expect(text).not.toContain('black bear');});
+  it('限制個性與道具最多兩個',()=>{const project=createProject();const profile={...project.subjectProfile,personalityIds:['lazy','funny','sweet'],propIds:['phone','book','coffee']};expect(validateSubjectProfile(profile,false)).toEqual(expect.arrayContaining(['個性最多選擇 2 個','道具最多選擇 2 個']));});
+});
diff --git a/src/domain/subjectDescription.ts b/src/domain/subjectDescription.ts
new file mode 100644
index 0000000..76cdd1f
--- /dev/null
+++ b/src/domain/subjectDescription.ts
@@ -0,0 +1,36 @@
+import { getSubjectCatalog } from './subjectCatalog';
+import type { ReferencePhoto, SubjectProfile } from './types';
+
+export function buildSubjectDescription(profile: SubjectProfile, photos: ReferencePhoto[]): string {
+  const catalog = getSubjectCatalog(); const parts: string[] = [];
+  if (photos.length) {
+    const ordered = [...photos].sort((a,b)=>a.order-b.order); const primary = ordered.find((photo)=>photo.primary) ?? ordered[0];
+    parts.push(`Use the uploaded reference photos as the appearance source, with ${primary.name} as the primary reference.`);
+    parts.push('Analyze only visible, non-sensitive appearance: facial structure, hairstyle or fur pattern, colors, clothing and body proportions. Preserve recognizable visual traits consistently while converting the subject into an original LINE sticker character. Ignore photo backgrounds. Do not infer identity, ethnicity, health, religion or other sensitive attributes.');
+  } else if (profile.baseMode === 'custom') {
+    const subject = profile.customSubject.trim(); parts.push(`Create an original LINE sticker subject based on this description: ${subject || 'a friendly original character'}.`);
+  } else {
+    const item = catalog.items.find((entry)=>entry.id===profile.itemId && entry.categoryId===profile.categoryId) ?? catalog.items[0];
+    parts.push(`Create ${item.prompt}. Keep the design original, readable at sticker size and distinct from existing commercial characters.`);
+  }
+  const role = catalog.roles.find((entry)=>entry.id===profile.roleId); if(role?.prompt)parts.push(`Role and daily context: ${role.prompt}.`);
+  const personalities = profile.personalityIds.slice(0,2).map((id)=>catalog.personalities.find((entry)=>entry.id===id)?.prompt).filter(Boolean); if(personalities.length)parts.push(`Personality: ${personalities.join('; ')}.`);
+  const props = profile.propIds.slice(0,2).map((id)=>catalog.props.find((entry)=>entry.id===id)?.prompt).filter(Boolean); if(props.length)parts.push(`Optional recurring props: ${props.join('; ')}.`);
+  if(profile.extraDetails.trim())parts.push(`Additional creator direction: ${profile.extraDetails.trim()}.`);
+  parts.push('Do not imitate named artists, brands, logos, trademarks or protected characters.');
+  return parts.join(' ');
+}
+
+export function validateSubjectProfile(profile: SubjectProfile, hasPhotos: boolean): string[] {
+  const catalog=getSubjectCatalog(),issues:string[]=[];
+  if(profile.personalityIds.length>2)issues.push('個性最多選擇 2 個');
+  if(profile.propIds.length>2)issues.push('道具最多選擇 2 個');
+  if(!catalog.roles.some((item)=>item.id===profile.roleId))issues.push('角色設定不存在');
+  if(profile.personalityIds.some((id)=>!catalog.personalities.some((item)=>item.id===id)))issues.push('包含不存在的個性設定');
+  if(profile.propIds.some((id)=>!catalog.props.some((item)=>item.id===id)))issues.push('包含不存在的道具設定');
+  if(!hasPhotos){
+    if(profile.baseMode==='custom'&&!profile.customSubject.trim())issues.push('請輸入自訂主體');
+    if(profile.baseMode==='catalog'&&!catalog.items.some((item)=>item.categoryId===profile.categoryId&&item.id===profile.itemId))issues.push('請選擇有效的題材子項目');
+  }
+  return issues;
+}
diff --git a/src/domain/types.ts b/src/domain/types.ts
index 953ab8f..6b5a4a5 100644
--- a/src/domain/types.ts
+++ b/src/domain/types.ts
@@ -32,6 +32,19 @@ export interface StyleRecipe {
   primary: string; palette: string; outline: string; rendering: string; shape: string;
 }
 
+export interface SubjectProfile {
+  catalogVersion: string; baseMode: 'catalog' | 'custom'; categoryId: string; itemId: string;
+  customSubject: string; roleId: string; personalityIds: string[]; propIds: string[]; extraDetails: string;
+}
+
+export interface SubjectCategory { id: string; label: string; description: string; sortOrder: number }
+export interface SubjectItem { id: string; categoryId: string; label: string; prompt: string; trend: boolean; sortOrder: number }
+export interface SubjectOption { id: string; label: string; prompt: string; trend?: boolean }
+export interface CatalogSnapshot {
+  version: string; generatedAt: string; sourceLabel: string; categories: SubjectCategory[]; items: SubjectItem[];
+  roles: SubjectOption[]; personalities: SubjectOption[]; props: SubjectOption[];
+}
+
 export interface ReferencePhoto {
   id: string; name: string; type: 'image/png' | 'image/jpeg' | 'image/webp';
   width: number; height: number; bytes: number; hash: string; order: number; primary: boolean;
@@ -56,8 +69,9 @@ export interface ProjectSettings {
 }
 
 export interface StickerProject {
-  version: 4; name: string; type: StickerType; generationProvider: GenerationProvider;
+  version: 5; name: string; type: StickerType; generationProvider: GenerationProvider;
   settings: ProjectSettings; captionSlots: CaptionSlot[]; styleRecipe: StyleRecipe;
+  subjectProfile: SubjectProfile;
   referencePhotos: ReferencePhoto[]; photoRightsConfirmed: boolean;
   sourceDataUrl: string; stickers: StickerAsset[]; animationSets: Record<string, AnimationFrame[]>;
   generationTasks: GenerationTask[]; generationAttempts: GenerationAttempt[];
diff --git a/src/domain/validation.ts b/src/domain/validation.ts
index 7e98199..6fe4040 100644
--- a/src/domain/validation.ts
+++ b/src/domain/validation.ts
@@ -1,5 +1,6 @@
 import { getSpec } from './specs';
 import type { StickerProject, ValidationIssue } from './types';
+import { validateSubjectProfile } from './subjectDescription';
 
 const ONE_MB=1024*1024;
 export function validateProject(project:StickerProject):ValidationIssue[]{const spec=getSpec(project.type);const issues:ValidationIssue[]=[];
@@ -10,6 +11,7 @@ export function validateProject(project:StickerProject):ValidationIssue[]{const
   if(project.stickers.length!==cellCount)issues.push({level:'error',code:'CANDIDATE_COUNT',message:`候選素材須為 ${cellCount} 張，目前 ${project.stickers.length} 張`});
   if(selected.length!==project.settings.count)issues.push({level:'error',code:'ASSET_COUNT',message:`須入選 ${project.settings.count} 張，目前 ${selected.length} 張`});
   if(!project.rightsConfirmed)issues.push({level:'error',code:'RIGHTS',message:'尚未確認著作權、肖像權、商標與非廣告用途'});
+  for(const message of validateSubjectProfile(project.subjectProfile,project.referencePhotos.length>0))issues.push({level:'error',code:'SUBJECT_PROFILE',message});
   if(project.referencePhotos.length&&!project.photoRightsConfirmed)issues.push({level:'error',code:'PHOTO_RIGHTS',message:'尚未確認參考照片使用權及肖像同意'});
   for(const asset of selected){
     if(asset.width%2||asset.height%2)issues.push({level:'error',code:'EVEN_SIZE',message:'寬高必須是偶數',assetName:asset.name});
diff --git a/src/providers/tasks.test.ts b/src/providers/tasks.test.ts
index 94e925d..b4a0b08 100644
--- a/src/providers/tasks.test.ts
+++ b/src/providers/tasks.test.ts
@@ -6,9 +6,9 @@ describe('雙平台 MD 任務', () => {
     const project = createProject(); project.generationProvider = provider;
     project.referencePhotos=[{id:'photo',name:'me.jpg',type:'image/jpeg',width:800,height:1000,bytes:100,hash:'abc',order:0,primary:true}];
     const task = createGenerationTask(project); const markdown = buildTaskMarkdown(project, task);
-    expect(parseTaskMarkdown(markdown)).toMatchObject({ schema:'line-sticker-task/v2',provider,taskId:task.id,targetCount:8,count:9,rows:3,columns:3 });
+    expect(parseTaskMarkdown(markdown)).toMatchObject({ schema:'line-sticker-task/v3',provider,taskId:task.id,targetCount:8,count:9,rows:3,columns:3,subjectProfile:project.subjectProfile });
     expect(markdown).toContain('me.jpg');
     expect(markdown).toContain('Do not include logos, brands, watermarks');
   });
-  it('仍可解析 v1 任務',()=>{const project=createProject();const task=createGenerationTask(project);const markdown=buildTaskMarkdown(project,task).replace('line-sticker-task/v2','line-sticker-task/v1');expect(parseTaskMarkdown(markdown).schema).toBe('line-sticker-task/v1');});
+  it('仍可解析 v1 任務',()=>{const project=createProject();const task=createGenerationTask(project);const markdown=buildTaskMarkdown(project,task).replace('line-sticker-task/v3','line-sticker-task/v1');expect(parseTaskMarkdown(markdown).schema).toBe('line-sticker-task/v1');});
 });
diff --git a/src/providers/tasks.ts b/src/providers/tasks.ts
index c01478e..af2c017 100644
--- a/src/providers/tasks.ts
+++ b/src/providers/tasks.ts
@@ -1,12 +1,14 @@
 import { getSpec } from '../domain/specs';
 import { stylePrompt } from '../domain/styles';
-import type { GenerationProvider, GenerationTask, ReferencePhoto, StickerProject, TaskKind } from '../domain/types';
+import { buildSubjectDescription } from '../domain/subjectDescription';
+import type { GenerationProvider, GenerationTask, ReferencePhoto, StickerProject, SubjectProfile, TaskKind } from '../domain/types';
 
 export interface TaskManifest {
-  schema: 'line-sticker-task/v1' | 'line-sticker-task/v2'; taskId: string; provider: GenerationProvider; kind: TaskKind;
+  schema: 'line-sticker-task/v1' | 'line-sticker-task/v2' | 'line-sticker-task/v3'; taskId: string; provider: GenerationProvider; kind: TaskKind;
   stickerType: StickerProject['type']; count: number; targetCount?: number; columns: number; rows: number; cellCount?: number;
   character: string; style: string; captions: { index: number; text: string; intent: string; visible: boolean }[];
   referencePhotos?: Pick<ReferencePhoto, 'id' | 'name' | 'type' | 'width' | 'height' | 'hash' | 'primary'>[];
+  subjectProfile?: SubjectProfile; characterDescription?: string; catalogVersion?: string;
   deliverables?: { kind: 'sticker-sheet' | 'animation-frames' | 'popup-frames' | 'effect-frames'; description: string }[];
   output: { format: 'PNG'; transparent: true; width: number; height: number; frames?: { min: number; max: number; maxDurationMs: number } };
 }
@@ -22,12 +24,13 @@ export function createGenerationTask(project: StickerProject, kind: TaskKind = '
 
 export function buildTaskManifest(project: StickerProject, task: GenerationTask): TaskManifest {
   const spec = getSpec(project.type); const cellCount = project.settings.rows * project.settings.columns;
+  const characterDescription=buildSubjectDescription(project.subjectProfile,project.referencePhotos);
   const animationKind = project.type === 'animated' ? 'animation-frames' : project.type === 'popup' ? 'popup-frames' : project.type === 'effect' ? 'effect-frames' : null;
   const deliverables: NonNullable<TaskManifest['deliverables']> = [{ kind: 'sticker-sheet', description: `Create ${cellCount} candidate illustrations in an exact ${project.settings.columns} column × ${project.settings.rows} row grid.` }];
   if (animationKind) deliverables.push({ kind: animationKind, description: `After the sticker sheet is approved, create coherent frame sheets for each selected sticker in this same conversation (${spec.minFrames}–${spec.maxFrames} frames, maximum ${spec.maxDurationMs} ms).` });
-  return { schema: 'line-sticker-task/v2', taskId: task.id, provider: task.provider, kind: 'project-generation', stickerType: project.type,
+  return { schema: 'line-sticker-task/v3', taskId: task.id, provider: task.provider, kind: 'project-generation', stickerType: project.type,
     count: cellCount, targetCount: project.settings.count, columns: project.settings.columns, rows: project.settings.rows, cellCount,
-    character: project.settings.character, style: stylePrompt(project.styleRecipe),
+    character: characterDescription, characterDescription, subjectProfile: project.subjectProfile, catalogVersion: project.subjectProfile.catalogVersion, style: stylePrompt(project.styleRecipe),
     captions: project.captionSlots.slice(0, cellCount).map((item, index) => ({ index: index + 1, text: item.text, intent: item.intent, visible: item.visible })),
     referencePhotos: project.referencePhotos.map(({ id, name, type, width, height, hash, primary }) => ({ id, name, type, width, height, hash, primary })),
     deliverables, output: { format: 'PNG', transparent: true, width: 1024, height: 1024,
@@ -46,7 +49,7 @@ export function parseTaskMarkdown(markdown: string): TaskManifest {
   const match = markdown.match(/<!-- LINE_STICKER_TASK_MANIFEST\n([\s\S]*?)\nEND_LINE_STICKER_TASK_MANIFEST -->/);
   if (!match) throw new Error('找不到 LINE Sticker 任務 manifest');
   const value = JSON.parse(match[1]) as TaskManifest;
-  if (!['line-sticker-task/v1', 'line-sticker-task/v2'].includes(value.schema) || !value.taskId) throw new Error('不支援的任務格式');
+  if (!['line-sticker-task/v1', 'line-sticker-task/v2', 'line-sticker-task/v3'].includes(value.schema) || !value.taskId) throw new Error('不支援的任務格式');
   return value;
 }
 
diff --git a/src/styles.css b/src/styles.css
index 46593d2..3eba3f2 100644
--- a/src/styles.css
+++ b/src/styles.css
@@ -32,6 +32,7 @@ main { width:min(1580px,calc(100% - 32px));margin:0 auto;padding:24px 0 48px; }
 .selected-slots{display:flex;gap:6px;overflow-x:auto;margin-top:12px;padding-bottom:4px}.selected-slots>div{display:flex;align-items:center;gap:6px;flex:0 0 auto;padding:6px 8px;border:1px solid var(--line);border-radius:6px;background:#f8fafc;font-size:11px;cursor:grab}.selected-slots b{color:var(--green-dark)}.selected-slots button{background:none;color:var(--muted)}
 .style-grid{display:grid;grid-template-columns:repeat(5,1fr);gap:8px}.style-grid label{display:flex;flex-direction:column;gap:5px;color:var(--muted);font-size:11px}.prompt-preview{margin-top:10px!important;padding:9px;border-radius:7px;background:#f8fafc;color:var(--muted);font-size:11px}.task-header .section-heading{margin-bottom:10px}.task-list{display:grid;gap:6px}.task-list>div{display:flex;align-items:center;gap:10px;padding:8px 10px;border-radius:7px;background:#f8fafc;font-size:11px}.task-list small{color:var(--muted)}.task-list button{margin-left:auto;padding:5px 8px;border-radius:5px}.task-actions .primary-button{font-size:12px}
 .photo-section{padding:20px;margin-bottom:16px}.photo-actions{display:flex;align-items:center;gap:12px}.photo-actions span{color:var(--muted);font-size:12px}.photo-list{display:grid;grid-template-columns:repeat(5,minmax(0,1fr));gap:9px;margin-top:12px}.reference-photo{position:relative;padding:8px;border:1px solid var(--line);border-radius:9px;background:#fff}.reference-photo.primary{border-color:var(--green);box-shadow:0 0 0 2px rgba(6,199,85,.12)}.reference-photo img,.photo-missing{width:100%;aspect-ratio:1;object-fit:cover;border-radius:6px;background:#f1f5f9}.reference-photo strong,.reference-photo small{display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.reference-photo strong{margin-top:6px;font-size:11px}.reference-photo small{color:var(--muted);font-size:9px}.reference-photo label{font-size:10px}.photo-buttons{display:flex;gap:4px;margin-top:5px}.photo-buttons button{flex:1;border:1px solid var(--line);border-radius:4px}.rights-check{display:flex;gap:8px;align-items:flex-start;margin-top:12px;padding:10px;border-radius:7px;background:#f8fafc;font-size:11px}.photo-error{margin-top:9px;color:#b91c1c;font-size:12px}.grid-total{display:flex;align-items:center;min-height:38px;color:var(--green-dark)}.candidate-toggle{width:100%;margin-bottom:6px;padding:5px;border-radius:5px;background:#e2e8f0;font-size:10px;font-weight:800}.sticker-card.included{border-color:var(--green);box-shadow:0 0 0 2px rgba(6,199,85,.1)}.sticker-card.included .candidate-toggle{background:var(--green);color:#fff}.task-actions{display:flex;align-items:center;gap:10px}.task-actions>span{color:var(--muted);font-size:11px}
+.subject-designer{margin-bottom:16px;padding-bottom:14px;border-bottom:1px solid var(--line)}.subject-heading{display:flex;justify-content:space-between;gap:10px;align-items:flex-start;margin-bottom:10px}.subject-heading strong,.subject-heading small{display:block}.subject-heading small{margin-top:3px;color:var(--muted);font-size:10px}.subject-heading>span{padding:4px 7px;border-radius:999px;background:#dcfce7;color:var(--green-dark);font-size:9px;font-weight:900}.mode-switch{display:grid;grid-template-columns:1fr 1fr;gap:5px;margin-bottom:10px}.mode-switch button{padding:7px;border:1px solid var(--line);border-radius:6px;background:#fff;font-size:11px}.mode-switch button.active{border-color:var(--green);background:#f0fdf4;color:var(--green-dark);font-weight:800}.choice-group{margin:0 0 12px;padding:0;border:0}.choice-group legend{margin-bottom:6px;color:var(--muted);font-size:11px;font-weight:700}.choice-group>div{display:flex;flex-wrap:wrap;gap:5px;max-height:92px;overflow:auto}.choice-group label{display:flex;align-items:center;gap:4px;padding:5px 7px;border:1px solid var(--line);border-radius:999px;background:#fff;font-size:9px;cursor:pointer}.choice-group label.selected{border-color:var(--green);background:#f0fdf4}.choice-group input{width:auto}.subject-preview{padding:9px;border-radius:7px;background:#f8fafc}.subject-preview>div{display:flex;justify-content:space-between;align-items:center}.subject-preview button{font-size:10px;color:var(--green-dark)}.subject-preview p{max-height:120px;overflow:auto;margin:6px 0;color:#475569;font-size:10px;line-height:1.55}.subject-preview small{color:var(--muted);font-size:8px}
 .mark-status{width:100%;margin-top:6px;padding:5px;border:1px solid var(--line);border-radius:5px;font-size:10px}.mark-status.visible{color:#dc2626;border-color:#fecaca}.mark-status.none{color:#15803d;border-color:#bbf7d0}.rights-check{display:flex;align-items:flex-start;gap:6px;margin-top:10px;color:var(--muted);font-size:10px;line-height:1.4}.rights-check input{accent-color:var(--green)}
 .task-tools{display:flex;gap:7px}.attempt-list{display:flex;gap:8px;flex-wrap:wrap;margin-top:10px;padding-top:10px;border-top:1px solid var(--line);font-size:10px;color:var(--muted)}.attempt-list strong{color:var(--ink)}
 @media(max-width:1180px){.phrase-options{grid-template-columns:repeat(3,1fr)}}
diff --git a/tests/e2e/smoke.spec.ts b/tests/e2e/smoke.spec.ts
index a4473c4..1f0ad85 100644
--- a/tests/e2e/smoke.spec.ts
+++ b/tests/e2e/smoke.spec.ts
@@ -8,16 +8,22 @@ test('雙平台、照片、候選網格與本機範例流程', async ({ page })
   await page.getByRole('button', { name: /Gemini/ }).click();
   await expect(page.getByText(/Gemini · 一份 MD/)).toBeVisible();
   await expect(page.getByText('3×3＝9 格')).toBeVisible();
+  await expect(page.getByText('角色題材', { exact: true })).toBeVisible();
+  await page.getByLabel('類別').selectOption('plants');
+  await page.getByLabel('子項目').selectOption('sunflower');
+  await expect(page.getByText(/anthropomorphic sunflower/)).toBeVisible();
   const photoInput = page.locator('.photo-section input[type="file"]');
   await photoInput.setInputFiles({ name: 'me.png', mimeType: 'image/png', buffer: Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M/wHwAF/gL+Xw4WAAAAAElFTkSuQmCC', 'base64') });
-  await expect(page.getByText('me.png')).toBeVisible();
+  await expect(page.getByText('me.png', { exact: true })).toBeVisible();
+  await expect(page.getByText('照片模式')).toBeVisible();
+  await expect(page.getByText(/me.png as the primary reference/)).toBeVisible();
   await page.getByLabel(/我確認擁有照片使用權/).check();
   const mdDownload = page.waitForEvent('download');
   await page.getByRole('button', { name: '下載完整產圖 MD' }).click();
   const mdPath = await (await mdDownload).path();
   expect(mdPath).toBeTruthy();
   const markdown = await readFile(mdPath!, 'utf8');
-  expect(markdown).toContain('line-sticker-task/v2');
+  expect(markdown).toContain('line-sticker-task/v3');
   expect(markdown).toContain('me.png');
   expect(markdown).toContain('3 columns and 3 rows');
   const backupDownload = page.waitForEvent('download');
@@ -26,7 +32,9 @@ test('雙平台、照片、候選網格與本機範例流程', async ({ page })
   expect(backupPath).toBeTruthy();
   await page.reload();
   await page.locator('header input[type="file"]').setInputFiles(backupPath!);
-  await expect(page.getByText('me.png')).toBeVisible();
+  await expect(page.getByText('me.png', { exact: true })).toBeVisible();
+  await page.locator('.reference-photo .photo-buttons button').last().click();
+  await expect(page.getByLabel('子項目')).toHaveValue('sunflower');
   await page.getByRole('tab', { name: /大貼圖/ }).click();
   await expect(page.getByText(/最大 396×660/)).toBeVisible();
   await page.getByRole('button', { name: '載入範例' }).click();