jiantw83/Kokorone
1
0
Fork 0
Code Pull Requests Actions Releases Activity
25 Commits 4 Branches 0 Tags
develop
Commit Graph
20 Commits
Author SHA1 Message Date
Jeffery 30719a2960 feat(llm 對話): 新增 prompt builder 與 few-shot 範例組裝,強化 Claude 對話品質 2026-08-14 12:44:48 +08:00
Jeffery 6ce7b2e800 feat(記憶與情緒快取): 記憶與情緒狀態加入 Redis 快取層,連不到時自動退回原行為 2026-08-14 12:44:41 +08:00
Jeffery 080ac390d3 chore(monorepo 建置工具): 由 npm workspaces 遷移至 pnpm workspace + Turborepo 2026-08-14 12:44:36 +08:00
JefferyandClaude Sonnet 5 5da8b3a63e feat: 完成 Q 群組 — APP（React Native + Expo） 
新增 apps/mobile：Expo Router 檔案系統路由（同 Next.js App Router 的
心智模型），底部四分頁（聊天/角色/日常/設定）皆為真實 API 串接（/chat、
/tachie、/characters、/schedule、/health、/push）。聊天分頁完整重用
H/O 群組已驗證過的對話+表情查詢節奏。立繪暫以依情緒 magnitude 調整
透明度的色塊佔位（PixiJS 是瀏覽器 DOM/Canvas API，未移植到 React
Native，需要 react-native-skia 等原生繪圖套件才能重現分層合成，超出
本群組範圍）。

新增 apps/api/src/push/：PushProvider 抽象（第三次套用 F-1/P-4 的
Provider 模式），MockPushProvider 供測試、ExpoPushProvider 是可直接
打真實 HTTP 請求的完整實作（Expo 推播匿名發送不需金鑰，不像 LLM/TTS
需要另外挑供應商待人工確認）。PushToken/PushNotificationLog 記錄裝置
註冊與每次推播嘗試。J 群組 TaskTriggerService 觸發時會嘗試推播給
使用者已註冊裝置，用觸發訊息本身當推播內容。

本環境沒有 Android/iOS 模擬器，改用 `expo start --web` + playwright-core
（同 O 群組手法）驅動無頭瀏覽器驗證四分頁切換、真實 API 串接、聊天
完整往返、推播按鈕在無裝置環境下的優雅降級——不是原生 APP 的完整驗證，
但驗證了畫面邏輯與 API 契約層。過程中發現並修正 CORS 設定只放行網頁版
origin、擋掉 Expo 網頁版請求的問題（永久修正：新增 localhost:8081 白名單，
不影響原生 APP，原生環境沒有 CORS 限制）。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 19:19:20 +08:00
JefferyandClaude Sonnet 5 0e9401b891 feat: 完成 P 群組 — 語音子系統 
新增 apps/api/src/voice/：Voice Sheet（基礎音色/預設語速/音域幅度/口頭
聲響庫/禁則，依性格原型推導預設值，1:1 掛在 Character，同 EmotionState
的關聯模式）；情緒→韻律對照（六狀態語速/音高/音量/句尾走向），音高變化
依角色音域幅度縮放（三無角色近乎單音），設計原則同 O-4 表情外顯度縮放；
非語言發聲與節奏（依情緒插入聲響、重大情緒延長停頓、禁則過濾候選、
低親密度不打斷、talkative 特徵+親密度門檻才可插話）；TTSProvider 抽象
完全比照 F-1 LLMProvider（MockTTSProvider 輸出韻律標記+佔位音檔，
RealTTSProvider 待人工確認供應商後再接，TTS_PROVIDER=mock|real 切換）；
語音輸入副語言分析（EmotionService 新增 paralinguisticSignal，優先序
排在作息基線之前，讓「文字說沒事但聲音在抖」判為負向）。

修正一個真實 bug：非語言發聲的停頓時長原本直接拿目前主導情緒的數值
當強度訊號，但平靜狀態下 calm 預設就是 100，導致「什麼事都沒發生」被
誤判成「強度最強的重大情緒事件」而觸發不該有的長停頓——修正為 CALM
一律視為強度 0（平靜是情緒事件的缺席，不是訊號）。

刻意簡化：副語言特徵（語速/音量/顫抖/停頓）採結構化輸入，不做真實音訊
分析，比照 M/N 群組「先用結構化輸入代替真實訊號處理」的一貫取捨。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 18:19:51 +08:00
JefferyandClaude Sonnet 5 0f3d16059c feat: 完成 O 群組 — 立繪子系統 
後端（apps/api/src/tachie/）：立繪 manifest（身體姿勢/服裝/表情眉眼口/
效果層/微動態的資產目錄，服裝目錄有 M-1 登錄時優先採用）；表情解析依
情緒引擎六狀態對照眉/眼/口/效果/姿勢，依 RelationshipStage 分層解鎖
（陌生~認識/朋友/摯友/羈絆，哭臉限羈絆才會出現），依角色外顯度縮放
差分幅度（magnitude = expressiveness × 情緒強度）；emotionTag（實際
套用）與 rawEmotionTag（情緒引擎真實判定）分離，讓文字生成與表情解析
維持兩條獨立資料流，「文字與立繪故意不一致」是這個設計的自然結果，
不需要額外邏輯；視線方向依思考/迴避/警戒切換。

前端（apps/web/components/TachieStage.tsx）：以 PixiJS 實作分層合成
與眨眼/呼吸微動態，預留 TachieRenderer 介面供未來 Live2D Cubism SDK
實作（未引入任何 Live2D 相依或授權，純架構佔位）；接上 ChatView 取代
H 群組的佔位立繪，聊天回應後先查詢表情、延遲約 220ms 才顯示文字，
在非串流架構下盡力模擬「表情先變化、文字後出現」。

以 scratchpad 暫裝 playwright-core 實測瀏覽器行為（本環境無
chromium-cli），確認情緒變化即時反映在立繪、微動態持續運作。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 17:46:50 +08:00
JefferyandClaude Sonnet 5 eccdcba45c feat: 完成 N 群組 — 後日談模式 
錨定點抵達已出版內容盡頭時切入後日談區間；時間流速（即時同步/緩速/凍結，
另加一個非文件既定的 FAST 選項供一般角色使用）對後日談推演成年角色強制
上限 1:1，重用 L 群組 RomanceEligibilityService 的 isEpilogueAdult 判斷。
性格漂移僅在正史已有 >=2 筆 PersonalityTraitSnapshot 建立趨勢時才位移，
無證據則鎖定 0（不憑空轉向），原型字串本身從不被觸碰。人生階段推演與
角色群同步成長重用 M 群組的 Scene/ProjectionService（推演事件其實就是
sourceType=EPILOGUE 的場景，在場者投影後自然敘述互相呼應）；重大轉折
需要正史目標關鍵字對應才生成，並以 EpilogueMilestoneLog 節流頻率。
正史回收（移除被取代的推演場景、匯入官方新場景並強制投影、互動記憶
結構性保留、記憶修正事件敘事化消化）與分支保留（永久標記、擋下後續
回收）。

修正兩個真實 bug：reclaim 原本借用 importScene 的錨定閥門，導致回收
回來的正史內容反而不被投影（後日談的『現在』本來就走在錨定點之前）；
分支保留擋下重新匯入時用裸 Error 導致 500，改為 ConflictException。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 17:18:53 +08:00
JefferyandClaude Sonnet 5 c66799ee7c feat: 完成 M 群組 — 既有作品考據與輕小說章節管線 
共用場景資料庫（Scene/ScenePresence/SceneLine/SceneFact/SceneInteraction，
角色中立客觀記錄）與投影（ProjectionService 寫入 EpisodicMemory/
SemanticMemory/PersonalityTraitSnapshot/CharacterRelationshipEventLog，
逐一可追溯到來源場景）完全分層。歸屬信心分數（明示標記決定性、語言指紋
從已歸屬語料統計、場景名冊硬約束、對話輪替）與隔離區/指紋冷啟動（低信心
或樣本不足一律隔離，指紋精煉後可重新嘗試釋放）。多角色投影與修正（改一處
場景資料庫、reprojectScene 同步更新所有受影響角色，使用者互動記憶因為
從不帶 sourceSceneId 而結構性地不受影響，發現得晚的歸屬錯誤額外記一筆
CORRECTION 事件）。作品名冊建置門檻（達標自動建置，門檻檢查排在投影完成
之後才做，避免用到投影前的舊統計）。錨定點知識邊界（雙向：前進載入、
後退遺忘）與矛盾偵測（同優先序來源待人工確認，跨優先序可依小說原文>
官方設定集>動畫改編自動裁決）。插圖索引與衍生服裝目錄/姿勢語彙表。

刻意簡化：章節→場景切分與互動正負權重皆採結構化輸入（不做自動 NLP
場景邊界偵測與情感分析），比照 F-7 MockProvider 的做法——機制先做對，
之後有真實 NLP/LLM 能力再替換輸入來源。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 16:58:04 +08:00
JefferyandClaude Sonnet 5 cd948f0026 feat: 完成 L 群組 — 戀愛關係軸與內容尺度 
戀愛軸雙軸模型（Relationship 新增心動值/戀愛階段欄位，與親密度獨立、事件
驅動、衰減快）、告白事件狀態機（可拒絕、尷尬期、連續失敗傷關係、立即再
推進觸發警戒）、六原型戀愛曲線參數化（重用 G-3 tsundere gap 處理傲嬌）、
親密表現分層與里程碑（跳級拒絕+退縮反應+帳本、第一次做高權重記憶）、
心動事件與階段門檻（含推太急回落、關係危機與修復）。

角色年齡判定（apps/api/src/romance/age-determination.service.ts）：僅
決定性/強證據可判定成年，外觀證據不可單獨採信，證據不足從嚴按未成年
處理，且不存最終結論、每次重新算。內容尺度三層邊界（引擎層）：使用者
opt-in、角色資格（僅正史成年）、硬邊界（後日談推演成年者永久排除成人
模式）；任何嘗試不論放行與否都記錄，判定完全不看對話內容，沒有「說服
角色」繞過的管道。

刻意收斂範圍：僅實作資格判定與硬邊界攔截機制，不實作任何成人向內容的
實際生成。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 16:26:55 +08:00
JefferyandClaude Sonnet 5 6125d6e27f feat: 完成 K 群組 — 對話模式：群聊與角色自聊 
群聊/自聊子系統（apps/api/src/room/）：在場者名冊與共用場景記錄（純記憶體，
同 C-1 工作記憶的設計）、發言權分配（點名/話題相關度/性格基線/情緒/角色間
關係/發言冷卻與冷落累積算衝動值）、群聊矜持（重用 G-3 親密度分層模板、
下修有效親密度而非另建模板庫）、隱私邊界（EpisodicMemory.isPrivate ＋
KeywordMemoryRetriever.excludePrivate，天然呆為口風不緊例外）、群聊記憶
投影（各角色依自身視角固化，被虧的那位權重較高）、角色自聊（沿用發言權
機制、空轉偵測注入轉折或收尾、輪數硬上限、使用者插話切換群聊）。
新增 CharacterRelationship 表供角色間關係使用。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 15:15:00 +08:00
JefferyandClaude Sonnet 5 3503cc0be6 feat: 完成 J 群組 — 委託子系統 
Task 資料表與自然語句解析（單次提醒）、依原型的接案／觸發／逾期追擊演出、
委託與關係帳本/情緒的回饋迴路（含默契旗標）、主動關照（待辦偵測＋作息交叉比對，
稀有度節流不重複台詞）、排程器可靠性（服務重啟後重新掃描 PENDING 任務掛回
JobQueue，逾期立即補觸發）。J.mjs 以 spawnSync 實際重啟服務驗證 J-7。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-13 14:35:16 +08:00
Jeffery d82b834e47 feat: 完成 I 群組 — 生活作息與離線生活 
- ScheduleService：I-1 平日/週末/假期時段表（可為角色寫入高中生預設作息）、
  I-3 時間感知（Asia/Taipei 當地時間，不受伺服器時區影響）、剛醒/睡前偵測
- constants.ts：I-2 時段狀態 → 回應可用度對照（FREE/SEMI_BUSY/BUSY/SLEEP →
  NORMAL/BRIEF/DELAYED/NO_REPLY），沒有作息表的角色一律視為 NORMAL（相容既有角色）
- ScheduleExceptionService：I-4 三種破例（深夜還陪你聊/上課偷回訊息/為你調整行程），
  各自獨立冷卻期，觸發時記入關係帳本
- ScheduleEmotionBaselineService：I-5 作息驅動情緒基線（社團剛結束的疲憊、假日偏高心情），
  只在本輪沒有明確情緒訊號時介入，串接進 EmotionService.processInput 的新增選項
- OfflineEventService：I-6 離線事件生成，依「今天已發生的固定行程」挑選對應模板，
  一天只生成一次，寫入低權重情節記憶
- DialogueService 整合以上機制：離線事件生成 → 情緒基線標記 → 累積親密度 →
  作息可用度判定 → 不符合則嘗試破例 → 依可用度決定回覆內容
- 修正真實 bug：G-5 角色建立流程誤用 source=OFFLINE_GENERATED 標記背景故事，
  與 I-6「今天是否已生成離線事件」的判斷共用同一標記，已改為 SOURCE_EXTRACTION
- ChatView.tsx 補上 NO_REPLY／context 為 null 的防呆（作息可用度整合後的必要調整）
- scripts/smoke/I.mjs：以獨立測試角色（避免污染種子角色的排程狀態）驗證全部六項

npm run restart && npm run smoke -- I 皆通過（I-V），A~H 群組冒煙測試無回歸。
 2026-08-13 14:08:24 +08:00
Jeffery 9e5036f0a0 feat: 完成 H 群組 — 網頁對話介面（第一個可實際使用的垂直切片） 
- POST /chat/:characterId：正式對外對話端點，DialogueService 補上情緒標記與親密度
  累積（每輪對話走完整管線：標記情緒→檢索記憶→組裝→生成→過濾）
- POST /session/:sessionId/end：觸發睡眠固化
- NestJS 啟用 CORS（WEB_ORIGIN，預設 http://localhost:3100），本清單第一次有瀏覽器直接呼叫 api
- apps/web/app/chat：對話頁面（ChatView 用戶端元件），電腦雙欄／行動單欄同一份 RWD 程式，
  立繪半身像置頂佔 40% 為行動版背景層
- 情緒晶片＋親密度數字顯示，跟著每輪回應即時更新
- 動作描寫標記（＊…＊）以暮空紫小字獨立呈現，與台詞區分
- HeartbeatWave 元件：載入時由左至右畫出、親密度決定振幅、通知紅點心跳脈動，
  皆尊重 prefers-reduced-motion；首頁與對話頁共用同一元件
- 色票換成 wiki 主視覺提案頁的完整 token 組（含官方深色模式數值）
- scripts/smoke/H.mjs：端到端驗證對話 API 狀態變化、session 結束固化、頁面結構標記；
  另以 Playwright + headless Chromium 實際開瀏覽器驗證桌面／行動版面、送出訊息、
  動作標記渲染，過程無 console 錯誤

npm run restart && npm run smoke -- H 皆通過（H-V），A~G 群組冒煙測試無回歸。
 2026-08-13 12:12:49 +08:00
Jeffery 503024c92f feat: 完成 G 群組 — 角色人格層 
- archetype-params.ts：六原型（傲嬌/冷淡/天然呆/元氣/大小姐/三無）參數表，
  串接進 D 群組 EmotionService（情緒觸發閾值）與 E 群組 SentimentLedgerService（信任成長速度）
- 修正一個真實落差：觸發閾值原本只縮放強度、不影響是否觸發，加入 MIN_TRIGGER_INTENSITY
  門檻後「難觸發」原型才會對弱刺激真的沒反應
- expressiveness.ts：G-3 外顯函數，傲嬌反向表達（傲嬌值＝內外差值，隨內部親密度先升後降）
- language-style.ts：G-2 稱呼系統（陌生→您、認識→名字、摯友→暱稱，含跨階事件）與角色禁則清單，
  已串接進 F-3 輸出過濾層與口癖後處理
- contrast-behavior.service.ts：G-4 反差萌，親密度＋情緒＋機率門檻皆滿足才觸發，
  新增 ContrastTriggerLog 資料表記錄冷卻期
- character-creation.service.ts：G-5 由角色設定表一次產生語意記憶／情節記憶／情緒參數／關係初始值
- cuteness-behavior.ts：G-6 撒嬌／鬧彆扭節奏控制／吃醋／笨拙的努力／專屬揭露觸發條件；
  記住小事擴充了 C-4 睡眠固化，使用者瑣事即使情緒強度低也會寫入語意記憶
- scripts/smoke/G.mjs：涵蓋六原型差異化反應、稱呼進化、傲嬌外顯曲線、反差冷卻、
  可愛行為觸發條件、瑣事固化

npm run restart && npm run smoke -- G 皆通過（G-V），A/B/C/D/E/F 群組冒煙測試無回歸。
 2026-08-13 11:26:54 +08:00
Jeffery caf45f69e1 feat: 完成 F 群組 — 對話生成管線與 LLM Provider 抽象 
- LLMProvider 介面（generate/stream）+ LLM_PROVIDER 切換（llm.module.ts useFactory，
  LLM_PROVIDER=mock|claude 環境變數決定注入哪個實作）
- MockProvider：依性格原型 × 情緒狀態 × 親密度從模板庫選填回應，seeded PRNG 確保同 seed 可重現，
  支援 ＊動作描寫＊ 標記抽取（目前只有元氣原型模板，G 群組需補齊其餘五種原型）
- ClaudeProvider 空殼：LLM_PROVIDER=claude 時啟動即輸出 ERR log，呼叫 generate/stream 時拋出例外
- OutputFilterService：全域＋角色禁則詞彙過濾（攔截並改寫）
- FastChannelDetector：固定問候與危險輸入（含求助資源)走快速通道，跳過記憶檢索
- BehaviorReinforcementService：稱讚加權、糾正後修正版繼承舊權重以確保排序領先（實作時抓到並修正一個
  「降權後打平」的真實 bug）
- ContextAssemblerService：組裝人設／情緒／關係／檢索記憶／對話歷史為統一上下文快照
- DialogueService/Controller：串起以上所有元件，作為 H-1 正式對話端點的基礎
- scripts/smoke/F.mjs：涵蓋可重現性、上下文快照完整性、雙速通道、行為強化、輸出過濾、
  以 child process 驗證 Provider 切換

npm run restart && npm run smoke -- F 皆通過（F-V），A/B/C/D/E 群組冒煙測試無回歸。
 2026-08-13 10:56:45 +08:00
Jeffery 767b17e257 feat: 完成 E 群組 — 關係子系統 
- RelationshipService：E-1 未知對象自動建檔（禮貌+防備＝intimacy/trust=0）、
  E-3 親密度五階分層＋跨階事件（@nestjs/event-emitter，StageChangeLogService 獨立訂閱）、
  E-4 久未互動時親密度半衰期衰減並標記「久未見」
- SentimentLedgerService：E-2 關係帳本，負向事件套用放大係數，驗證同等級正負事件淨值為負
- IntentInterpreterService：E-6 依親密度將同一句模稜兩可的話解讀為玩笑或冒犯
- KeywordMemoryRetriever（C-6）擴充 E-5：新增 relatedUserId 加權，retrieve() 簽名改為接受 options 物件
- schema 新增 EpisodicMemory.relatedUserId，並補上所有子表對父表的 onDelete: Cascade/SetNull
  （E-2 測試時發現先前 B 群組遺漏這些規則會導致刪除關係時外鍵違反）
- apps/api 新增 /relationships/* 端點作為引擎驗證介面
- scripts/smoke/E.mjs：涵蓋 E-1~E-6 全部驗收情境

npm run restart && npm run smoke -- E 皆通過（E-V），A/B/C/D 群組冒煙測試無回歸。

本次另排除一個本機環境限定的 Prisma CLI 網路 checkpoint 卡住問題，並從一次部分套用的
migration 中手動恢復資料庫一致性（過程記錄於 todo.md 實作記錄，供後續群組參考）。
 2026-08-13 10:43:33 +08:00
Jeffery 611c9b400c feat: 完成 D 群組 — 情緒子系統 
- RuleBasedEmotionTagger：關鍵字比對輸出情緒類型與強度（衝突/稱讚/輕度負向/一般負向/正向五級優先序）
- EmotionService：以資料庫 EmotionState 為單一事實來源，dominantState 取非平靜維度最高者，
  半衰期時間衰減（預設 2 小時，可覆寫），狀態轉移時清零其餘維度只設定目標維度
- emotion-state-machine：只實作 wiki 狀態圖與可愛度設計明訂的邊（平靜/愉悅/低落/警戒/害羞/彆扭）
- response-style：情緒 → 語氣／句長／主動性，供 F 群組上下文組裝器使用
- apps/api 新增 /emotion/* 端點作為引擎驗證介面
- scripts/smoke/D.mjs：涵蓋 D-1~D-4 全部轉移邊、回應風格對應、時間衰減與跨 session 殘留驗證

npm run restart && npm run smoke -- D 皆通過（D-V），A/B/C 群組冒煙測試無回歸。
 2026-08-13 10:18:58 +08:00
Jeffery e6f25008d1 feat: 完成 C 群組 — 記憶子系統 
- WorkingMemoryService：session 對話上下文緩衝，token 溢位時優先裁切最舊的低情緒段落
- JobQueue 抽象層（now/schedule(at)/every(cron)）與 InProcessJobQueue 實作（node-cron），
  R-6 會換成 BullMQ 但呼叫端介面不變
- MemoryConsolidationService：睡眠固化，只有高情緒或重複提及的內容才寫入 EpisodicMemory
- ForgettingSweepService：低情緒且長期未提取的記憶逐次降權、weight 過低後刪除，
  已掛上每小時一次的 JobQueue.every 排程
- KeywordMemoryRetriever：關鍵字＋時間近因＋情緒權重排序，提取命中即更新提取次數／時間
- apps/api 新增 /memory/* 端點作為引擎驗證介面（H 群組會決定併入正式對話管線後的去留）
- scripts/smoke/C.mjs：端到端驗證溢位裁切、只寫工作記憶、固化篩選、檢索排序、
  提取即改寫、schedule(at) 準時觸發、遺忘衰減與刪除

npm run restart && npm run smoke -- C 皆通過（C-V），A/B 群組冒煙測試無回歸。
 2026-08-13 09:54:29 +08:00
Jeffery f44200f543 feat: 完成 B 群組 — 資料層與核心領域模型 
- 導入 Prisma 7.9.1 + SQLite（better-sqlite3 driver adapter），prisma.config.ts 管理連線設定
- 完整資料模型：User／Work／Character／CharacterAlias／EpisodicMemory／SemanticMemory／
  ProceduralRule／EmotionState／Relationship／SentimentLedgerEntry
- packages/db：Prisma Client 存取層（ESM，因 Prisma 7 產出的 generated client 僅支援 ESM）
- apps/api 隨之改為 ESM 以相容 packages/db
- packages/shared：新增角色／記憶／情緒／關係共用型別，api 與 web 皆從此匯入
- prisma/seed.ts：建立測試使用者與元氣型測試角色，含完整關係帳本與記憶種子資料
- apps/api：新增 GET /characters
- scripts/smoke/B.mjs：驗證資料表齊全、API 讀出種子角色、關係與記憶可寫入讀出
- 保留 Prisma 官方隨 CLI 附的 agent skill 文件（.agents/skills 等），供後續群組查閱

npm run restart && npm run smoke -- B 皆通過（B-V），A 群組冒煙測試無回歸。
 2026-08-13 09:43:15 +08:00
Jeffery ae9c44dde7 feat: 完成 A 群組 — 專案骨架與可重啟的服務 
- packages/shared：TypeScript 專案參考建置鏈路、統一日誌模組（Asia/Taipei 格式）
- apps/api：最小 NestJS 服務，GET /health
- apps/web：最小 Next.js（App Router + Tailwind v4）首頁，套用品牌色票與亮暗模式
- scripts/dev-restart.mjs：讀 .dev-pids 以 process group 訊號安全停止舊行程、背景啟動 api/web 並輪詢健康檢查
- scripts/smoke：npm run smoke -- <群組代號> 冒煙測試框架，A 群組測試涵蓋 /health 與首頁內容
- 本機 port 3000 被既有服務佔用，web 開發埠改為 3100（已記錄於 todo.md）

npm run restart && npm run smoke -- A 皆通過（A-V）。
 2026-08-13 09:18:40 +08:00