feat: 完成 K 群組 — 對話模式：群聊與角色自聊

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

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

todo.md

@@ -286,13 +286,24 @@ flowchart TB
 
 ### K. 對話模式：群聊與角色自聊
 
-- [ ] **K-1 在場者模型（S）**：session 支援多角色參與者名冊，角色可讀取「誰在場」。驗收：群聊 session 內每個角色都能取得完整在場名單。依據：§群聊中的行為變化「在場者感知」。
-- [ ] **K-2 群聊行為變化（S）**：人前矜持（一對一會撒嬌的角色群聊時收斂、傲嬌更嘴硬）、對不同對象使用不同稱呼與語氣。驗收：同角色在一對一與群聊的同一情境輸出不同。依據：§群聊中的行為變化。
-- [ ] **K-3 隱私邊界（S）**：一對一聊過的私密內容，該角色在群聊中不主動洩漏（口風不緊為角色設定的例外）。驗收：標記為私密的記憶不會出現在群聊回應中。依據：§跨模式的記憶連續性「隱私邊界」。
-- [ ] **K-4 發言權分配（M）**：每輪計算各角色發言衝動值（被點名／話題相關度／性格基線／情緒狀態／與發言者關係／發言冷卻），超過門檻才發言；沉默也是演出。驗收：三無角色整場只發言少數次、元氣角色發言最多、剛發言者衝動下降。依據：§發言權分配表。
-- [ ] **K-5 群聊記憶投影（M）**：群聊記錄為一份共用場景記錄，session 結束時各角色以自身視角萃取記憶，情緒標記可不同。驗收：同一場群聊固化後，兩角色的情節記憶內容與權重不同。依據：§群聊的記憶投影。
-- [ ] **K-6 角色自聊（M）**：話題種子（使用者指定／共同記憶抽取／日常情境模板）、發言權沿用群聊機制、空轉偵測（重複與資訊量下降）注入轉折或收尾、輪數上限硬停損、使用者插話即切換群聊。驗收：無人插話時能自然收尾且不超過輪數上限。依據：§模式三：角色自聊（旁觀模式）。
-- [ ] **K-V 階段驗證（XS）**：`npm run restart && npm run smoke -- K`（K.mjs：發言權分佈、群聊投影差異、隱私邊界、自聊收斂）。
+- [x] **K-1 在場者模型（S）**：session 支援多角色參與者名冊，角色可讀取「誰在場」。驗收：群聊 session 內每個角色都能取得完整在場名單。依據：§群聊中的行為變化「在場者感知」。
+- [x] **K-2 群聊行為變化（S）**：人前矜持（一對一會撒嬌的角色群聊時收斂、傲嬌更嘴硬）、對不同對象使用不同稱呼與語氣。驗收：同角色在一對一與群聊的同一情境輸出不同。依據：§群聊中的行為變化。
+- [x] **K-3 隱私邊界（S）**：一對一聊過的私密內容，該角色在群聊中不主動洩漏（口風不緊為角色設定的例外）。驗收：標記為私密的記憶不會出現在群聊回應中。依據：§跨模式的記憶連續性「隱私邊界」。
+- [x] **K-4 發言權分配（M）**：每輪計算各角色發言衝動值（被點名／話題相關度／性格基線／情緒狀態／與發言者關係／發言冷卻），超過門檻才發言；沉默也是演出。驗收：三無角色整場只發言少數次、元氣角色發言最多、剛發言者衝動下降。依據：§發言權分配表。
+- [x] **K-5 群聊記憶投影（M）**：群聊記錄為一份共用場景記錄，session 結束時各角色以自身視角萃取記憶，情緒標記可不同。驗收：同一場群聊固化後，兩角色的情節記憶內容與權重不同。依據：§群聊的記憶投影。
+- [x] **K-6 角色自聊（M）**：話題種子（使用者指定／共同記憶抽取／日常情境模板）、發言權沿用群聊機制、空轉偵測（重複與資訊量下降）注入轉折或收尾、輪數上限硬停損、使用者插話即切換群聊。驗收：無人插話時能自然收尾且不超過輪數上限。依據：§模式三：角色自聊（旁觀模式）。
+- [x] **K-V 階段驗證（XS）**：`npm run restart && npm run smoke -- K`（K.mjs：在場名單、發言權分配、群聊矜持、隱私邊界、記憶投影、角色自聊收斂）。
+
+> **實作記錄（K 群組）**：
+> - 群聊/自聊子系統放在 `apps/api/src/room/`。**刻意不建 `Room`/`RoomTurn` 之類的資料表**：`RoomService` 用純記憶體 `Map`（同 C-1 `WorkingMemoryService` 的設計哲學）存參與者名冊與場景逐輪記錄，因為這本質上是 session 期間的暫存場景，session 結束後就該由 K-5 的固化流程萃取成各角色的長期記憶並丟棄原始記錄——長期保存的只有固化後的 `EpisodicMemory`。**這意味著 api 行程重啟會讓所有進行中的房間消失**，跟 C-1 的工作記憶是同一個已知取捨，不是 bug。
+> - 新增了 `CharacterRelationship` 資料表（有向邊：`characterId` 對 `otherCharacterId` 的觀感，`affinity` 0~100 ＋ `dynamic` 描述性標籤），供「角色間關係上場」與 K-4 發言權分配裡「與發言者的關係」使用；未設定時預設中性值 50。這是全新的角色對角色關係系統，跟 E 群組的 `Relationship`（角色對使用者）是兩張獨立的表，不要混用。
+> - `EpisodicMemory` 新增 `isPrivate` 欄位（K-3），`packages/shared` 的 `EpisodicMemory` 型別也要同步加這個欄位（否則 apps/api 引用共享型別時型別會不匹配）。`KeywordMemoryRetriever.retrieve` 新增 `excludePrivate` 選項；**誰來決定要不要排除私密記憶是呼叫端的責任**——`RoomGenerationService` 一律傳 `excludePrivate: !archetypeParams.traits.includes("loose-lipped")`，一對一對話（`ContextAssemblerService`）完全沒動、不會受影響。`天然呆` 原型加了 `loose-lipped` 特徵旗標作為「口風不緊」的例外原型。
+> - **K-4 發言權分配公式**：`score = 性格基線×0.3 + 話題相關度×0.25 + 情緒修正×0.15 + 關係修正×0.15 + 冷落累積加成 − 剛發言冷卻懲罰`，被點名時再加一個很大的固定加成（0.6，幾乎必回），門檻設在 0.25。**話題相關度刻意不是單純的「命中詞數/清單總詞數」比例**：角色喜好清單通常只有幾個詞，一旦命中就該是強訊號，用比例會被清單長度稀釋掉，所以命中時下限給 0.5（`Math.max(0.5, hits/keywords.length)`）。中文以單字成詞很常見（貓／狗／書），關鍵字清單的切詞正規表達式必須把全角「：」「；」都當分隔符，且長度門檻不能設 `>=2`（否則會濾掉單字關鍵字）——**這是本群組踩到的實際 bug，切詞沒處理全角標點導致話題相關度永遠算不出命中**，已修正並在 `speaking-right.service.ts` 留了註解說明。
+> - **K-2 群聊矜持的實作方式很輕巧**：完全重用 G-3 的親密度分層模板系統（`intimacyTier`/`pickTemplates`），群聊/自聊時把「餵給生成上下文的親密度」下修 35（傲嬌再多扣 15），讓同一套模板庫自然选到「低親密度」那一層、更收斂的回應，**沒有另外做一套群聊專用模板**。副作用：`MockProvider` 目前完全不吃 `context.history`／`context.retrievedMemories`，所以「對不同對象不同稱呼」是在 `RoomGenerationService` 外面手動 prepend 稱呼字串（`"${address}，${生成文字}"`），不是模板系統原生支援對象切換——這也是為什麼 K-3 的隱私過濾沒辦法用「回應文字裡有沒有出現私密內容」來驗收（MockProvider 根本不會把記憶內容寫進輸出），K.mjs 改成直接打 `GET /memory/:characterId/retrieve?excludePrivate=` 驗證過濾機制本身。**日後 R-3 換上真正的 LLM Provider 後，這裡的稱呼/矜持處理方式可能需要重新設計**（真正的 LLM 應該能在 prompt 裡吃到「這是群聊，在場者有誰」而自然產生矜持與對象切換，不必再靠外部下修親密度這個折衷做法）。
+> - **K-5 記憶投影的「被虧的記得比較牢」**：固化時逐輪呼叫 D-1 的 `RuleBasedEmotionTagger` 幫每一句話打情緒標記，非自己說的話只有「情緒強烈」或「提到自己（別名比對）」才留存，權重公式 `aboutMe ? 1.5+intensity : isSelf ? 1+intensity : 0.5+intensity`——同一句被虧的台詞，當事人權重 2.2、單純旁觀的角色權重只有 1.2（已用 smoke test 驗證這個差距一定成立）。
+> - **K-6 角色自聊的收斂機制**：完全重用 K-4 的 `SpeakingRightService.decideSpeakers`（把上一輪發言內容當作「發言者」丟進去算下一輪各角色的衝動值，衝動最高者發言；若全部低於門檻仍強制選最高分者發言，否則自聊會卡死不動），空轉偵測比對最近 3 轮内容是否完全重複或字數持續遞減，偵測到就注入 `TOPIC_TWIST_LINES` 轉折句；同一房間累積 2 次轉折仍空轉就直接收尾（`SELF_CHAT_WRAP_UP_LINES`）。**因為 MockProvider 的模板池很小（多數原型只有通用預設兩句），空轉偵測在測試裡幾乎每次都會被觸發**，這是預期行為，不是 bug——等 R-3 真正的 LLM 上線後，重複發生的機率會大幅降低，但空轉偵測機制本身仍應保留（真人對話一樣會陷入互相客套的迴圈）。使用者插話（`interject`）只是把 `room.mode` 從 `SELF_CHAT` 切成 `GROUP`，插話內容走跟一般群聊訊息完全相同的路徑。
+> - `RoomModule` 依賴 `LlmModule` 取得 `LLM_PROVIDER`（重用 F-2 的 Provider 抽象），但 `LlmModule` 原本只 export `DialogueService`/`BehaviorReinforcementService`，**這次補上 `LLM_PROVIDER` 到 export 清單**，否則 `RoomGenerationService` 在 DI 階段會解析不到這個 token 而直接炸掉啟動。之後任何模組想直接注入 `LLM_PROVIDER`（不透過 `DialogueService`）都要記得先確認它在 exports 裡。
+> - **`DialogueService`（一對一聊天）完全沒有被本群組改動**——群聊/自聊是平行的一套生成路徑（`RoomGenerationService`），不是在 `DialogueService` 裡加分支。這是刻意的取捨：一對一的管線已經很長（作息／破例／記憶檢索／禁則），硬塞群聊語意進去會讓兩種模式互相拖累；缺點是兩套生成路徑目前有一些邏輯重複（組裝 `GenerationContext` 的細節），**如果之後要讓兩套路徑共用更多邏輯，可以考慮把 `ContextAssemblerService` 抽出一個「不含 session/schedule 依賴」的核心組裝函式，供两邊共用**，本群組沒有做這個重構。
 
 ### L. 戀愛關係軸與內容尺度