@wji.ai/cli 0.9.0 → 0.9.2

package/skill/w-film-dialogue-editor/references/lang-ko.md

@@ -0,0 +1,290 @@
+> 本文件係 **韓文（韓國語）專屬 reference guide**（首爾標準語為主軸，사투리 為輔軸）。
+> 主流程見 SKILL.md；語言中立的診斷框架見 dialogue_revision_framework.md。
+
+---
+
+# 韓文對白指南（首爾標準語為主／사투리 為輔）
+
+本文件供韓文對白任務：原創韓文劇本、中文劇本轉韓文版、校對非母語者寫的韓文對白，以及為韓國市場（지상파、종편、Netflix、TikTok／YouTube 短劇）做在地化。韓文與中文最大的差別，是**每一句都內建了「誰對誰說話」**：감사합니다／고마워요／고마워 三句都是「謝謝」，但第一句對客戶，第二句對同事，第三句只在朋友之間。中文可以靠稱謂與語氣交代關係，韓文不行——關係寫在語尾上，語尾錯了，整場戲的權力關係就塌了。覆蓋範圍：首爾標準語為主軸，사투리 作角色標記；語域分 합쇼체／해요체／반말 三層；史劇語體（하오체／하게체）只作提示。
+
+---
+
+## 一、先定三件事：地區、人物關係、語域
+
+| 軸 | 選項 | 幾時用／寫錯的代價 |
+|---|---|---|
+| **地區** | 표준어（首爾）／사투리（경상＝釜山硬、전라＝軟拖、제주·충청＝鄉土慢） | 표준어 係預設；方言只給 1–2 個角色。全劇人人方言＝散，兩個方言撈埋＝韓國演員一聽就知錯 |
+| **關係** | 上下（職場、師生、軍隊）／親疏（친한·어색한 사이）／年紀差（同갑·年上·年下） | 三樣直接決定語尾同 호칭。一集之內亂跳＝角色冇規矩；太早 반말＝冒犯；叫錯稱呼＝當場尷尬 |
+| **語域** | 합쇼체（-ㅂ니다/습니다）／해요체（-아요/어요）／반말（-아/어） | 합쇼체＝面試、新聞、客戶、軍隊；해요체＝同事、服務業、初見、長輩；반말＝朋友、同歲、上對下、家人 | 
+
+**最常見的死法**：把「有禮貌」等同「해요체」，於是全劇所有人都講해요체。真實韓劇的權力關係，是靠**同一場戲裡面語域的落差**做出來的：課長對組長用합쇼체，轉頭對實習生用반말——落差就是階級。
+
+---
+
+## 二、敬語階層與人際距離
+
+**三層語域：幾時用、幾時轉**
+
+| 語域 | 語尾 | 對誰 | 幾時轉走 |
+|---|---|---|---|
+| **합쇼체** | -ㅂ니다／-습니다／-ㅂ니까 | 客戶、上司、面試官、軍隊上級、陌生人 | 對方主動叫「말 편하게 하세요」 |
+| **해요체** | -아요／-어요／-죠／-네요 | 同事、店員、鄰居、長輩、初見 | 關係親近後，由年長或上位者提出 |
+| **반말** | -아／-어／-지／-냐 | 朋友、同歲、下屬、家人、小孩 | 吵架、翻臉時可「退回敬語」 |
+
+**轉換係關係事件，唔係語法事件。** 해요체轉반말，由年長一方開口：「우리 말 놓을까요?」（我們講半語吧？）或「말 편하게 하세요」；拒絕＝「아니에요, 괜찮아요」，等於保持距離。呢一刻本身就係戲：韓劇用「말 놓을까요」做曖昧起點，用「다시 존댓말할게요」（我還是說敬語吧）做關係冰封。轉錯的代價：下屬對上司 반말＝辭職信；上對下一直 합쇼체＝唔係尊重，係「唔當你係自己人」，比罵更冷；情侶突然 합쇼체＝吵架、撒嬌或分手前兆。
+
+**敬語三種「高度」：主體、對象、聽者**
+
+| 種類 | 做法 | 例子 | 常錯 |
+|---|---|---|---|
+| 主體敬語（주체 높임） | 加 -시- | 사장님이 오셨어요 | 對自己用 -시-（제가 가시겠습니다 ✗） |
+| 對象敬語（객체 높임） | 換動詞 | 주다→드리다、보다→뵙다、묻다→여쭙다、데려가다→모시고 가다 | 用錯方向（친구한테 드렸어 ✗） |
+| 聽者敬語（상대 높임） | 語尾 | -습니다／-어요／-어 | 語尾對、動詞錯：할아버지, 밥 먹었어요? ✗ |
+
+高頻敬語動詞：있다→계시다、먹다→드시다／잡수시다、자다→주무시다、말하다→말씀하시다、죽다→돌아가시다、아프다→편찮으시다、집→댁、밥→진지、나이→연세、이름→성함。**雙重敬語**：「사장님께서 말씀하셨습니다」正確；但「사장님께서 말씀하시었습니다」「제가 사장님을 모시고 뵈었습니다」係堆疊，韓國人聽落會覺得誇張、似古裝。
+
+**호칭（稱呼）與禁忌**
+
+| 稱呼 | 用喺邊 | 禁忌 |
+|---|---|---|
+| 씨／님 | 씨＝同歲或比自己細、關係一般；님＝職銜後（팀장님·과장님·부장님·사장님·선배님） | 對上司／長輩用 씨＝極失禮；單獨用 님 只限網絡 |
+| 선배／선배님 | 學校、公司前輩 | 自稱「선배」可以，但唔好配命令式 |
+| 職銜（과장님·차장님·부장님·사장님） | 按職級叫，唔叫名字 | 叫錯職級比叫錯名更嚴重 |
+| 어머니／아버지 | 自己父母；伴侶父母要加「-님」 | 對陌生人用＝認親，奇怪 |
+| 아줌마 → 아주머니／이모 | 街市、食店的中年女性 | 아줌마 帶貶意，服務業多用 이모 |
+| 아가씨／아저씨 | 아가씨＝舊式年輕未婚女性；아저씨＝中年男性 | 아가씨 現代易被聽成輕佻；아저씨 對三十幾歲男用＝當人老 |
+| 여기요／저기요 | 叫侍應（唔係稱呼） | 用「야」叫人＝侮辱 |
+
+---
+
+## 三、語尾與語氣：韓文對白的真正樂器
+
+情緒唔靠形容詞，靠**語尾**。同一個詞幹，語尾一換，態度由懇求變成頂嘴。
+
+| 語尾 | 態度／功能 | 例子（韓文／中譯） | 用錯後果 |
+|---|---|---|---|
+| -는데／-은데 | 鋪墊、軟化反駁、等對方接話 | 저 지금 가는데요…（我現在要走了啦……） | 講完就收，會似話沒說完 |
+| -거든요 | 補充理由、糾正對方誤解 | 제가 한 거 아니거든요（不是我做的啦） | 對上司用＝頂嘴 |
+| -잖아요 | 「你明明知道」的提醒 | 어제 말했잖아요（昨天不是說了嗎） | 對長輩用＝指責，好易吵 |
+| -네요 | 當下發現、感嘆 | 생각보다 빠르시네요（比想像中快呢） | 對上司用得多＝似評價對方 |
+| -다면서요 | 轉述確認（聽講……？） | 이사 간다면서요?（聽說你要搬家？） | 問私事＝八卦、有壓迫感 |
+| -더라고요 | 回想自己的經歷 | 그 집 비싸더라고요（那家店很貴呢） | 用嚟講對方本人嘅事＝奇怪 |
+| -(으)ㄹ게요 | 我來做（顧及對方意願的承諾） | 제가 할게요（我來做） | 陳述客觀事實要用 -(으)ㄹ 거예요 |
+| -(으)ㄹ래요 | 問意願、自己想做 | 같이 갈래요?（要一起去嗎？） | 對上司用 드실래요? 太隨便 |
+| -죠／-지요 | 確認、當然 | 그렇죠（對吧） | 反問語氣＝挑釁：제가 알죠? |
+| -(으)니까 | 理由（對方已知／命令根據） | 비 오니까 우산 챙겨（下雨，帶傘） | 對長輩用命令＝無禮 |
+| -긴요／-기는요 | 謙讓、否認對方誇獎 | 제가 뭘 했긴요（我做了什麼啊） | 語氣唔夠輕＝似冷淡 |
+| -겠- | 意志、推測、客氣 | 제가 하겠습니다／맛있겠다 | 同 -시- 撈亂 |
+| -(으)ㄹ걸요 | 保留的推測 | 아마 안 올걸요（大概不會來吧） | 講確定事實用＝唔負責任 |
+| -냐／-니 | 반말質問（低、硬） | 왜 그랬냐?（為什麼那樣？） | 對平輩用＝挑釁，對長輩＝災難 |
+| -라고요／-다고요 | 反問、重複確認 | 뭐라고요?（你說什麼？） | 語氣一重＝嗆聲 |
+| -ㅂ시다／-읍시다 | 一起做（對下或平級） | 갑시다（走吧） | 對上司用＝命令，要轉 -(으)시죠 |
+| -세요／-으세요 | 請求、命令（禮貌） | 여기 앉으세요 | 對客戶用 -시겠어요? 更軟 |
+| -던데요 | 回想＋等對方回應 | 어제는 바쁘던데요（昨天很忙呢） | 用來講自己＝唔自然 |
+
+**語氣詞／感嘆詞**同樣分階級：아／어／음（猶疑，拖長＝心虛）、아이고（唉喲，長輩中年人最多）、헐（傻眼，年輕專用）、와／대박（驚訝讚嘆，長輩用＝學後生）、진짜／정말（句尾上揚＝質疑）、글쎄(요)（唔確定、婉轉拒絕）、세상에（天啊，中年以上）、뭐야／뭐지（半語自言自語，對長輩用＝失禮）。另外 -음／-슴（보고서체）只限書面通告，口語用＝機械人。
+
+---
+
+## 四、句法特徵：韓文對白的節奏
+
+1. **SOV，動詞永遠在最後。** 重點在句尾，字幕斷句要斷在語尾之前，唔好把語尾切走；配音時最後一個音節就係演技位。
+2. **主語可省則省；은/는 vs 이/가 要分。** 「我吃過了」係 밥 먹었어，唔係 나는 밥을 먹었어——中文劇本轉韓文最常見的膨脹就係補齊主語。은/는＝話題、對比（나는 학생이에요）；이/가＝新資訊、責任歸屬（제가 했습니다＝是我做的），吵架戲把「我」寫成 내가，責任即刻壓實。
+3. **代詞陷阱。** 너 只可對熟人、下屬、晚輩；당신 只可對配偶、書面語、或吵架升級（당신이 뭘 알아요?）——對陌生人用 당신 係即刻翻臉。第三人稱直譯 그／그녀 極不自然，直接用名字或職銜。
+4. **動詞結尾＝禮貌的載體。** 名詞句（나 학생）只限 반말朋友之間；敬語場景必須有語尾，冇語尾＝冇禮貌。否定分 안（唔／意願）、못（唔能夠／能力）；안 됩니다＝不准（規則）、안 돼요＝唔得。
+
+---
+
+## 五、年齡層速查
+
+| 年齡 | 句長／語速 | 標記 | 真實講法 | 地雷 |
+|---|---|---|---|---|
+| **kid 6–12** | 短、跳 | 반말、告狀式 | 엄마, 저거 사 줘!／나 이거 싫어!／쟤가 먼저 때렸어! | 唔好寫成大人講嘢 |
+| **teen 13–19** | 快、碎 | 潮語、줄임말、反諷 | 아 진짜 짜증 나／이거 완전 대박이야／학원 가기 싫어／쌤이 또 뭐라 하셨어 | 唔好寫到似 30 歲 |
+| **young 20–29** | 快、直 | 해요체＋반말 混、自嘲 | 오늘 회식 진짜 가야 해?／퇴근하고 한잔할래?／나 요즘 좀 힘들어 | 唔好突然文藝 |
+| **mid 30–44** | 中速、有效率 | 職場語、家庭語、漢字語多 | 애 학원 끝나면 데리러 가야 해／이번 달 카드값 봤어?／팀장님한테 말씀드렸어? | 潮語要用得克制 |
+| **senior 45–59** | 慢、重 | 教訓式、比較式、고유어多 | 요즘 젊은 사람들은 말이야／그건 좀 아니지 않나／밥은 먹었나? | 唔好寫成行唔到 |
+| **elder 60+** | 慢、重複 | 자문자답、身體話題 | 아이고 허리야／약은 먹었나?／요새 세상이 다 그렇지 뭐／손녀는 언제 오나 | 唔好寫成可愛卡通老人 |
+
+**跨代落差就係免費笑點**：同一件事，teen 講「레전드」、young 講「좀 힘들어」、mid 講「바빠 죽겠어」、elder 講「그저 그렇지 뭐」。
+
+---
+
+## 六、角色類型速查（20 種）
+
+| archetype | 真實講法（2–3 句） | 一句語感 |
+|---|---|---|
+| student | 선생님, 숙제요? 깜빡했어요／이거 시험에 나와요? | 해요체打底、句尾拖長、口頭禪 되게／완전 |
+| slacker | 아 몰라, 그냥 눕자／내일 하면 되지 뭐 | 반말、拖、拒絕努力 |
+| office | 팀장님, 그 건은 제가 정리해서 드릴게요／회의 몇 시부터예요? | 해요체＋報告語，漢字語密度高 |
+| boss | 그거 오늘까지 돼요?／됐고, 다음 | 短、해요체但帶命令、慣性打斷 |
+| client | 이거 좀 더 깔끔하게 안 될까요?／일정은 언제까지 가능하세요? | 해요체、軟要求、-ㄹ까요 施壓 |
+| craftsman | 여기 수평 안 맞는데요／자재가 안 와서 오늘은 못 해요 | 短、現場語，합쇼체同해요체混 |
+| waitress | 주문하시겠어요?／잠시만요, 자리 정리하고요 | 極短、唔講長句 |
+| shopkeeper | 어서 오세요, 천천히 보세요／이거 만 원이에요 | 해요체、尾音拉長、親切 |
+| security | 차량 번호 확인하겠습니다／여기 세우시면 안 됩니다 | 합쇼체、通告體、唔帶情緒 |
+| housewife | 그 집 애가 또?／어머, 그거 진짜야? | 快、八卦推力、반말同해요체混 |
+| designer | 이 시안은 컨셉이 안 잡혀요／한 번 더 잡고 갈까요? | 해요체、專業詞、帶刺 |
+| street | 야, 너 어디야?／한 번만 더 해 봐, 진짜 | 반말、極短，威脅靠語氣 |
+| elder | 요즘 세상은 허허／밥은 먹고 다니나 | 慢、고유어多、自問自答 |
+| trainer | 자, 하나 더! 힘!／호흡 하시고, 천천히 | 大聲、短指令、해요체 |
+| mum | 밥은 먹었어?／너 또 그런 말 했어? | 해요체／반말、擔心式追問 |
+| dad | 공부는 됐고, 밥이나 먹어라／돈은 내가 준다 | 短、해라체／반말、少講感受 |
+| kid | 엄마, 나 이거!／내가 먼저야! | 短、반말、告狀式 |
+| teacher | 다 같이 읽어 볼까요?／거기, 조용히 하세요 | 해요체、清楚、重複 |
+| sales | 고객님, 이번 달까지만 이 가격이에요／제가 최대한 맞춰 드릴게요 | 해요체／합쇼체、套路、承諾 |
+| delivery | 택배 왔습니다／문 앞에 놔드릴게요 | 短、합쇼체、電話語 |
+
+---
+
+## 七、粗口與攻擊性分級
+
+| 級別 | 例子 | 性質 | 平台尺度 | 對象與風險 |
+|---|---|---|---|---|
+| **0** | 아이고、어머、세상에、진짜? | 感嘆、唔指向人 | 全平台 | 任何對象 |
+| **1** | 아이씨、젠장、짜증 나、미치겠다、답답해 | 發洩、自言自語式 | 지상파 可；劇本慎用 | 熟人、獨腳戲；連續用＝角色廉價 |
+| **2** | 꺼져、닥쳐、미친놈、병신、새끼 | 直接侮辱 | 지상파 不可；종편／OTT 可 | 對長輩用＝絕對禁忌；새끼 熟人之間可帶親暱 |
+| **3** | 씨발／시발、개새끼、좆됐다、엿 먹어라 | 真粗口 | OTT 可；지상파 要 bleep；YouTube／TikTok 前 3 秒最敏感 | 需要劇情理由＋即場後果 |
+
+**規則**：① 粗口係人物標記，唔係強度旋鈕——從不爆粗的角色第一次講 씨발，威力大過每句都講嘅角色。② **씨발 有兩種用法**：感嘆詞（씨발, 진짜…＝死啦，真係）同呼格侮辱（씨발놈아）；前者韓國觀眾覺得殺傷力低，後者係真攻擊，劇本要寫清楚。③ **존나／좆나 係程度副詞**（존나 맛있어＝他媽的好吃），攻擊性低於 개- 接頭（개웃겨、개빡쳐），但 개- 唔可以亂接名詞，接錯＝外國人味。④ **미친 跨世代**：長輩講係「真係瘋了」，年輕人講 미쳤다 可以是讚嘆（미쳤다, 이거）——同一個詞兩代意思相反。⑤ 꺼져（滾）／닥쳐（收聲）唔可以對長輩講，一講就係關係斷絕，要當事件寫。⑥ 平台：지상파（KBS／MBC／SBS）最嚴，連 아이씨 都要計；종편（JTBC／tvN）較寬；Netflix 等 OTT 最寬；YouTube 前 3 秒有粗口會被演算法壓；TikTok 最嚴。방송심의 另外會盯地名／人物影射、性暗示、校園暴力細節。
+
+---
+
+## 八、書面→口語對照（20 組）
+
+| 中文（書面／劇本常用） | 韓文真實講法 | 備註 |
+|---|---|---|
+| 你好 | 안녕하세요／안녕 | 안녕 對長輩＝失禮 |
+| 謝謝 | 감사합니다／고마워요／고마워 | 食完飯講 잘 먹었습니다 |
+| 對不起 | 죄송합니다／미안해요／미안 | 輕微打擾用 실례합니다 |
+| 沒關係 | 괜찮아요／됐어요 | 됐어요 亦可以係「不用了」 |
+| 辛苦了 | 수고하셨습니다／고생 많으셨어요 | 前者上對下或平級，後者下對上 |
+| 請多關照 | 잘 부탁드립니다 | 職場、初見萬用 |
+| 我明白了 | 알겠습니다／네, 알겠습니다 | 알겠어요 有時帶不耐煩 |
+| 知道了 | 알았어（반말）／알겠습니다（職場） | 알았어 對上＝災難 |
+| 你吃飯了嗎 | 밥 먹었어?／식사하셨어요? | 長輩用 진지 드셨어요? |
+| 再見（對方走） | 안녕히 가세요 | 自己走＝안녕히 계세요 |
+| 歡迎光臨 | 어서 오세요 | 店員標準句 |
+| 多少錢 | 얼마예요? | 市場可加 이거 얼마예요? |
+| 便宜一點 | 좀 깎아 주세요／조금만 할인해 주세요 | 市場講 깎아 주세요 最自然 |
+| 我要這個 | 이거 주세요 | 指住講，唔需要完整句 |
+| 加油 | 힘내세요／힘내／화이팅 | 화이팅 長輩少用 |
+| 怎麼辦 | 어떡해요?／어쩌죠? | 어쩌죠 帶無奈 |
+| 你說什麼 | 네?（聽唔清）／뭐라고요?（不滿） | 뭐라고요 語氣一重＝嗆 |
+| 等一下 | 잠시만요／잠깐만요 | 잠깐만 朋友用 |
+| 隨便 | 아무거나／다 좋아요 | 아무거나 해 帶唔耐煩 |
+| 我不知道 | 몰라요／글쎄요 | 글쎄요＝唔確定、婉轉 |
+
+---
+
+## 九、中 → 韓 Transcreation 陷阱（最高優先）
+
+以中文創作、日後出韓文版的項目，呢一節最容易翻車。原則係 **transcreation（再創作）而非 translation（翻譯）**：保住場面目標、人物策略與轉折，重寫語言表層。
+
+| 中文寫作習慣 | 直譯結果 | 問題 | 韓文處理 |
+|---|---|---|---|
+| 句句「辛苦了」 | 수고했어요 | 只可上對下或平級；對客戶／長輩講＝居高臨下 | 下對上：고생 많으셨습니다；對客戶：감사합니다 |
+| 「沒關係」當拒絕 | 괜찮아요 | 有時等於「不用了」，意思反轉 | 清楚拒絕：됐어요／사양할게요 |
+| 「麻煩你了」 | 번거롭게 했습니다 | 韓文冇對應社交儀式，講出嚟似道歉過重 | 改寫：신경 써 주셔서 감사합니다 |
+| 「知道了」 | 알았어요 | 對上司帶不耐煩 | 對上：알겠습니다；朋友：알았어 |
+| 「不好意思」同「對不起」唔分 | 미안합니다 | 실례합니다／죄송합니다／미안해요 分場景 | 打擾＝실례합니다；做錯＝죄송합니다 |
+| 「請慢用」 | 천천히 드세요 | 變成「慢慢食」，唔係客套 | 맛있게 드세요 |
+| 「我會考慮」 | 생각해 보겠습니다 | 商務常用，但對朋友講＝距離 | 朋友：생각해 볼게 |
+| 「再聯絡」 | 다시 연락하겠습니다 | 方向唔清：邊個打俾邊個 | 연락드릴게요／연락 주세요 |
+| 「天啊」 | 오, 하느님 | 直譯＝宗教味、出戲 | 세상에／아이고／헐 |
+| 「你瘋了嗎」 | 미쳤어? | 對長輩＝絕對禁忌 | 對長輩改：왜 그러세요? |
+| 「先生／小姐」 | 선생님／아가씨 | 선생님＝老師；아가씨 現代易冒犯 | 用職銜、여기요，或省掉稱呼 |
+| 「我們是朋友」 | 우리는 친구입니다 | 語域錯，朋友之間唔會用입니다 | 우리 친구야／우리 친구잖아 |
+
+---
+
+## 十、字幕／配音腔（번역투）常見病
+
+| 病 | 例句（病） | 改法 |
+|---|---|---|
+| 代詞過剩 | 당신은 어디에 가요? | 어디 가세요?（主語省掉） |
+| 連接詞氾濫 | 그래서、하지만、그러나 每句開頭 | 兩句並排，靠語尾轉折 |
+| 敬語用得死板 | 全場都用 -습니다 | 按關係分層：上司합쇼체、同事해요체 |
+| 感嘆詞直譯 | 오, 이것은 정말 대단합니다! | 와, 이거 진짜 대박이네요 |
+| 被動直譯 | ~에 의해서 만들어졌습니다 | 만들었습니다／직접 했습니다 |
+| 名詞堆疊 | 그의 결정에 대한 나의 생각은 | 걔 결정, 난 반대야 |
+| 稱謂直譯 | 왕 총（王總） | 김 부장님／이 대표님 |
+| 語尾全部一樣 | 全場 -어요 | 混 -거든요／-잖아요／-네요 交代態度 |
+
+---
+
+## 十一、自檢清單（交付前逐項核對）
+
+1. [ ] 每場戲的語域有冇混亂？同一角色對同一人，語尾有冇無理由跳層？
+2. [ ] 上下關係對唔對？下屬對上司有冇漏 -시-／用錯 반말？반말 對象係唔係同歲、更年輕、或已達成「말 놓기」？호칭（씨／님／職銜／선배）有冇用錯位、關係變咗有冇跟住變？
+3. [ ] 代詞有冇過剩？당신／그녀 有冇亂用？
+4. [ ] 敬語動詞對唔對？（드시다／모시다／뵙다／여쭙다）有冇雙重敬語堆疊？
+5. [ ] 語尾有冇全部同一種？情緒係唔係只靠語尾交代？
+6. [ ] 句尾重點有冇被字幕切走？配音斷句對唔對？
+7. [ ] 사투리 係唔係只給 1–2 個角色？有冇兩個方言撈埋？
+8. [ ] 粗口級別符唔符合平台？開場 3 秒乾唔乾淨？
+9. [ ] 年齡標記對唔對？40 歲角色有冇講 00 後潮語？
+10. [ ] 有冇 번역투：代詞、連接詞、被動、名詞堆疊？數字、單位、錢嘅讀法對唔對（두 시 삼십 분、만 원）？
+11. [ ] 名字同職銜前後一致？文化詞（나이、술자리、호칭）有冇解釋過度，變成說明書？朗讀一次：似唔似韓國人講嘢，定似中文句子換上韓文字？
+12. [ ] 停頓、沉默、打斷有冇寫進動作行，而唔係靠（pause）？
+---
+
+## 十二、語料庫（可查詢）
+
+### 規模
+
+| shard | 條數 | 內容 |
+|---|---|---|
+| `core.json` | 45 | 인사／존댓말、편의점、카페、식당、길 묻기、가족、婉拒、收尾 |
+| `work.json` | 45 | 회사（팀장／과장／대리）、보고、야근／회식、면접、인테리어 공사、고객 응대 |
+| `slang.json` | 43 | 신조어、반말、衝突、인터넷、少量 사투리（已標地區） |
+
+每條有：講法、羅馬字（Revised Romanization）、意思、語氣、功能、語體、粗口級別、對象、例句、場口、用錯後果、**標籤**。
+唔肯定嘅語感、階級判斷、地區限定同過時風險，全部寫喺每條嘅 `note`／`avoid`。
+
+人讀索引（自動生成）：`references/ko-index.md`；全部句：`references/data/ko-sentences.md`（另附 CSV）。
+
+### 查詢
+
+~~~bash
+cd <skill-root>
+node scripts/ref.mjs --lang ko list --age young --tag 敬語
+node scripts/ref.mjs --lang ko search 야근
+node scripts/ref.mjs --lang ko show ko-core-001
+node scripts/ref.mjs --lang ko list --tag 職場 --max-prof 0
+node scripts/ref.mjs --lang ko random --tone sassy -n 8
+node scripts/ref.mjs --lang ko sentences        # 全部 133 句
+node scripts/ref.mjs --lang ko stats
+~~~
+
+### 標籤（tags）
+
+| 組 | 標籤 |
+|---|---|
+| 場口 | 職場、餐廳、便利店、咖啡廳、地鐵、街頭、店舖、裝修、地盤、家庭、校園、酒吧、街市 |
+| 角色 | 上司、同事、客戶、店員、服務員、白領、年輕人、長輩、師傅、老闆 |
+| 用途 | 開場、收尾、拒絕、讚、踩、八卦、講價、關心、抱怨、客套、日常、面試、投訴 |
+| 語感 | 敬語、半語、直球、冷面、潮語、老派、網絡用語、中英夾雜、方言 |
+
+規則：角色標籤只取**主要角色**（archetype 第一位）；標籤係輔助檢索，唔取代 facet（角色、語氣、年齡仍然用 `--archetype`／`--tone`／`--age` 查）。
+
+### 實際分佈
+
+~~~
+語言：ko　總數：133 條
+shards：core.json(45), slang.json(43), work.json(45)
+
+[age]  young=65  mid=57  teen=30  senior=15  kid=4  elder=3
+
+[archetype]  office=61  student=38  craftsman=16  street=10  sales=10  housewife=8  boss=8  slacker=8  designer=8  client=5  shopkeeper=4  mum=3  elder=3  waitress=3  kid=1  dad=1  delivery=1  security=1
+
+[tone]  polite=79  warm=31  blunt=24  funny=17  worried=15  helpless=12  angry=11  complain=10  sassy=10  cold=8  surprised=7  proud=5  shy=4  threat=4  whiny=3  sarcastic=3  gossip=2  flirty=2
+
+[function]  question=27  urge=19  complain=19  greet=18  agree=12  dismiss=11  insult=11  farewell=6  challenge=6  tease=6  thanks=5  refuse=5  surprise=5  apology=4  warn=4  comfort=4  praise=4  encourage=3  refuse-soft=3  disagree=3  boast=3  bargain=2  joke=2  gossip=1  threaten=1
+
+[register]  everyday=51  professional=40  slang=27  internet=8  profanity=3  english-mix=2  idiom=1  proverb=1
+
+[profanity]  p0=128  p1=2  p2=2  p3=1
+~~~
+
+粗口分級見 §七：p2／p3 嘅 entry 全部標 `register=profanity`，並喺 `avoid`／`note` 寫明放送尺度（지상파／OTT／YouTube／TikTok）同對象。

package/skill/w-film-dialogue-editor/references/lang-zh-cn.md

@@ -0,0 +1,60 @@
+> 本文件係 **大陸普通話 專屬 reference guide**（一種語體一份，唔好互相套用）。
+> 主流程見 SKILL.md；語言中立的診斷框架見 dialogue_revision_framework.md。
+
+---
+
+# 大陸普通話對白指南
+
+## 一、核心立場
+
+大陸普通話的核心不是「標準播音腔」，而是按地域、世代、行業選擇口語層次。基本語氣詞為「啊、呀、吧、嘛、呢、啦、唄、咯、嘞、嗎」，要精準標示態度，不要堆砌或機械搬粵語語氣詞（「啦／喇／啫／咋」直翻通常會出戲）。北方角色可加兒化音「玩兒、事兒、會兒、一塊兒、有點兒」，但只在角色背景說得通時用，不要全劇灑粉。
+
+按世代選用語：80後／90後／00後的網絡用語差距很大。「臥槽、絕了、破防、emo、整活、麻了、家人們、芭比 Q 了、笑死、栓 Q、人麻了」屬於後者，年長角色硬用會出戲。職場、海歸、互聯網圈會自然夾英語單字（OKR、deadline、push、follow up、cover、PPT、卷、躺平、內卷），但只在符合身份時夾。粗口參考「他媽的、操、我去、傻逼、滾、靠、媽的」，按尺度與場面選用，不要為了狠而粗。
+
+地域口音是角色標籤而非全片裝飾：京片子（兒化音多、節奏快、「您」）、東北腔（句末「啊／唄」、誇張、笑點密、「咋整」「整一個」）、川渝腔（語氣偏軟、節奏錯落、「噻／嘛／哈」）、滬語普通話（用詞偏書面、英語夾雜）、粵普（句尾常帶「啦／嘅」殘留）。每劇通常只給少數角色明顯口音，其餘角色用標準普通話。
+
+## 二、元素規則
+
+大陸普通話要按地域、世代、行業選層次。基本盤是現代口語普通話；地域口音與網絡用語是角色標籤，不是全片裝飾。避免機械搬粵語語氣詞，亦避免播音腔書面句子。
+
+| 元素 | 用法 | 風險 |
+|---|---|---|
+| 語氣詞 | 「啊、呀、吧、嘛、呢、啦、唄、咯、嘞、嗎」細分態度。 | 一句一個會像翻譯腔。 |
+| 兒化音 | 北方角色用「玩兒、事兒、會兒、一塊兒、有點兒」標識身份。 | 南方角色亂加兒化音會出戲。 |
+| 網絡用語 | 80後／90後／00後用「臥槽、絕了、破防、emo、整活、麻了、栓 Q、家人們」標年齡與圈層。 | 年長或古裝角色硬用會崩。 |
+| 英語夾雜 | 互聯網／海歸／外企圈夾「OKR、deadline、push、follow up、卷、躺平、cover」。 | 不符身份會做作。 |
+| 地域口音 | 京片子、東北、川渝、滬普、粵普作為少數角色識別符。 | 全劇人人有口音會散。 |
+| 粗口 | 「他媽的、操、我去、傻逼、滾、靠、媽的」按尺度選。 | 為了狠而粗會廉價。 |
+
+## 三、快速自檢
+
+- 讀出聲：有冇一句係「播音腔」？有就拆短。
+- 語氣詞密度：一句最多一個；「啦／喇／啫」係粵語殘留，唔好搬入普通話。
+- 網絡用語＝年齡標籤，唔係裝飾；長輩角色硬用會崩。
+- 地域口音只給少數角色，其餘用標準普通話。
+- 英語夾雜要符合行業身份（互聯網、外企、海歸），唔係人人夾。
+
+## 四、語料庫（可查詢）
+
+133 條，3 個 shard：
+
+| shard | 條數 |
+|---|---|
+| `core.json` | 45 |
+| `slang.json` | 43 |
+| `work.json` | 45 |
+
+生成物（跑 `./scripts/rebuild.sh` 會更新）：
+
+- `references/zh-cn-index.md` — 按年齡／角色嘅索引（帶標籤）
+- `references/data/zh-cn-sentences.md` — 全部對白句
+- `references/data/zh-cn-sentences.csv` — 同上，CSV
+
+~~~bash
+node scripts/ref.mjs --lang zh-cn list --age young --tag 公司
+node scripts/ref.mjs --lang zh-cn search 離職
+node scripts/ref.mjs --lang zh-cn show <id>
+node scripts/ref.mjs --lang zh-cn list --max-prof 0
+node scripts/ref.mjs --lang zh-cn stats
+~~~
+

package/skill/w-film-dialogue-editor/references/lang-zh-hk-mandarin.md

@@ -0,0 +1,34 @@
+> 本文件係 **港式普通話 專屬 reference guide**（一種語體一份，唔好互相套用）。
+> 主流程見 SKILL.md；語言中立的診斷框架見 dialogue_revision_framework.md。
+
+---
+
+# 港式普通話對白指南
+
+## 一、核心立場
+
+港人講普通話的特徵：粵語句法殘留（量詞錯位「一位朋友／一條短訊」、後置副詞「先」「過」、動補結構不純）、英語夾雜頻率高於大陸普通話、語氣詞會混用「啦／囉／嘛／呢／嘅」、聲調平、句尾常拉長。
+
+這種語體適合：港人在內地經商或生活、合拍片中的港籍角色、TVB 國配感的角色。寫作時不必每句都「港普」，而是在情緒鬆動或不耐煩時讓粵式句法浮上來，作為身份標記與壓力指標。
+
+## 二、元素規則
+
+港人講普通話的角色，語體要帶可辨識的粵式痕跡，但不能寫成笑料堆。痕跡是情緒鬆動或不耐煩時自然浮現，不是每句都港普。
+
+| 元素 | 用法 | 風險 |
+|---|---|---|
+| 句法殘留 | 量詞錯位（「一位朋友」「一條短訊」）、後置副詞（「先」「過」）、動補不純。 | 全劇都港普會像諷刺。 |
+| 語氣詞混用 | 「啦／囉／嘛／呢／嘅」交叉出現。 | 三地語氣詞同時上會亂。 |
+| 英語夾雜 | 密度高於大陸普通話，符合港人職場與生活慣性。 | 對手戲角色不夾會反差過大。 |
+| 聲調與節奏 | 句子偏平、句尾常拉長，可標「（拖音）」「（粵腔）」提示演員。 | 純文字難呈現，需要演員配合。 |
+
+## 三、快速自檢
+
+- 粵語句法殘留要「情緒鬆動時才浮上來」，唔係每句都港普。
+- 量詞錯位（一位朋友／一條短訊）、後置「先／過」係特徵，唔係錯。
+- 語氣詞會混「啦／囉／嘛／呢／嘅」——但唔好變成笑料堆。
+- 適合：港人北上、合拍片港籍角色、TVB 國配感角色。
+
+## 四、語料庫
+
+暫無獨立語料庫。