@wji.ai/cli 0.9.1 → 0.9.2

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

@@ -0,0 +1,242 @@
+> 本文件係 **英文專屬 reference guide**（美式為主軸、英式為輔軸），由 english_dialogue_guide.md 併入。
+> 主流程見 SKILL.md；語言中立的診斷框架見 dialogue_revision_framework.md。
+
+---
+
+# 英文對白指南（美式為主／英式為輔）
+
+本文件供英文對白任務使用：原創英文劇本、把中文劇本轉成英文版、校對非母語者寫的英文對白，以及為歐美短劇（ReelShort、DramaBox、TikTok 短劇等）做在地化。核心立場與中文對白一致——對白是人物在壓力下的行動，不是資訊傳輸；但英文的節奏、語法慣性與文化默契與中文差異極大，機械翻譯必然出戲。
+
+覆蓋範圍：**美式英語為主軸，英式英語為輔軸**（多用於反派、時尚圈守門人、跨國資本、學院權威）；年代處理**以當代為重心，聚焦世代差異**，並附 1980s–2010s 快速對照。
+
+---
+
+## 一、英文銀幕對白通則
+
+英文銀幕對白的第一原則是**短**。母語演員一句話平均 7–12 個字；超過 20 字的句子必須有明確理由（角色在演講、在崩潰、在拖延、在掩飾）。中文劇本轉英文時句長通常膨脹 30%–50%，必須反向壓縮。
+
+第二原則是 **contraction 是預設值**。`I am / do not / cannot / I will / going to` 在日常對白中寫成 `I'm / don't / can't / I'll / gonna`。不縮寫是有標記的行為，代表以下情況之一：角色在強調（"I am not going."）、在正式場合、在威脅、在念稿，或角色是非母語者／老派／機器人。校對時看見滿篇不縮寫，通常就是翻譯腔。
+
+第三原則是**潛台詞靠 deflection，不靠形容詞**。中文對白可以直接寫情緒詞，英文觀眾對直白情緒宣言（"I hate you!" "You betrayed me!" "I've never felt so alone!"）的容忍度極低，會判定為 soap opera 或 cringe。英文的高情緒場面反而傾向 understatement：越平靜越可怕。
+
+第四原則是**呼名要克制**。中文劇本習慣句句帶稱謂（「小雅，你聽我說」「王總，這件事……」），直譯成英文會出現大量 "Sarah, listen to me." — 英文對話中直呼對方名字是有重量的行為，代表警告、安撫、施壓或求饒，一場戲通常只出現一兩次。滿場呼名是新手英文劇本最明顯的破綻。
+
+其他通則：
+
+- **停頓寫進動作行，不要靠 (pause)。** 用 `△ She doesn't answer.` / `△ He looks at the door.` 取代 `(pause)`。
+- **禁止 "As you know" 式 exposition。** 熟人不解釋雙方已知的事；資訊要藏進控訴、交易、威脅、玩笑或選擇。
+- **打斷與重疊是英文對白的主要張力工具。** 用 `--` 表示被切斷，`...` 表示自己收聲。兩者意義不同：`--` 是外力，`...` 是內在退縮。
+- **英文靠句子片段（fragments）製造壓迫。** "Not tonight." "Because you asked." "Your call." 完整主謂賓反而鬆。
+- **避免副詞堆疊。** "He said angrily" 式思維會滲進對白，寫成 "I'm telling you angrily that..."。改用具體行為。
+
+---
+
+## 二、中 → 英 Transcreation 陷阱（最高優先）
+
+以普通話創作、日後出英文版的項目，這一節是最容易翻車的地方。處理原則是 **transcreation（再創作）而非 translation（翻譯）**：保住場面目標、人物策略與轉折，重寫語言表層。
+
+| 中文寫作習慣 | 直譯結果 | 問題 | 英文處理 |
+|---|---|---|---|
+| 句句帶稱謂：「小雅，我跟你說」 | "Sarah, let me tell you—" | 呼名過密，像廣播劇 | 刪掉稱謂，直接進句子；只在施壓／安撫時保留 |
+| 職銜稱呼：「王總」「李老師」「陳姐」 | "Boss Wang" / "Teacher Li" / "Sister Chen" | 英文無對應階層稱謂，直譯像字幕組 | 用名字（Vivian）、姓氏加 title（Ms. Chen）、或圈內綽號；權力關係靠語氣不靠稱謂 |
+| 情緒直述：「我恨你！」「你太過分了！」 | "I hate you!" / "You've gone too far!" | 過度 melodramatic，歐美觀眾出戲 | 改成具體、冷、小：「You knew. And you let me walk in there.」 |
+| 反問句密集：「你憑什麼？」「難道我錯了嗎？」 | "What gives you the right?" / "Am I wrong?" | 中文靠反問推情緒，英文靠陳述句加停頓 | 改成平述句 + 動作行：「You don't get to say that.」△ She keeps packing. |
+| 客套敬語：「不好意思麻煩你了」「您辛苦了」 | "Sorry to trouble you" / "You've worked hard" | 英文無此社交儀式，聽起來卑微或古怪 | 刪除，或換成 "Appreciate it." / "You good?" |
+| 成語、俗語直譯 | "Draw a snake and add feet" | 完全不通 | 找功能等價的英文慣用語，或直接改成具體畫面 |
+| 主語省略：「知道了」「去了」 | "Know." / "Went." | 英文必須有主語 | "Got it." / "She left." |
+| 語氣詞：「呵」「哼」「唉」 | "Heh." / "Hmph." / "Sigh." | 英文劇本不寫這些，讀起來像漫畫 | 改寫成動作行：△ She laughs once, without humor. |
+| 解釋型台詞：「因為我從小就……所以我才……」 | "Because ever since I was little..." | 心理自述，英文觀眾判定為 lazy writing | 拆成行為，或讓對手用指控逼出來 |
+| 「我沒事」高頻使用 | "I'm fine." | 本身沒問題，但中文短劇用得太密 | 保留一兩次做 motif，其餘換成迴避動作 |
+| 集體主語：「我們中國人」「我們女人」 | "We Chinese" / "We women" | 英文對白極少這樣概括，聽起來像宣傳 | 改成第一人稱具體經驗 |
+| 稱呼陌生人：「美女」「帥哥」「小姐」 | "Beauty" / "Handsome" / "Miss" | 直譯冒犯或滑稽 | 美式用 "Excuse me" / "Hey"；服務業用 "Ma'am"（南方尤甚）；英式用 "Sorry—" |
+
+**檢查法**：把英文稿的角色名遮住朗讀。如果聽起來像字幕、像 TED talk、像產品說明，就是 transcreation 未完成。母語耳朵最先聽出的三個破綻依序是：呼名過密、不用 contraction、情緒宣言。
+
+---
+
+## 三、美式英語：階層、地域、族裔分層
+
+美式英語的角色標記主要來自三個軸：**社會階層／教育**、**地域**、**族裔社群**。三軸可疊加，但每個角色通常只給一到兩個明顯標記，其餘用 General American（中性美語）打底。全劇人人有口音會散。
+
+### 3.1 階層與教育 register
+
+| 層次 | 語言特徵 | 常用詞 | 誤用風險 |
+|---|---|---|---|
+| Old money / prep school | Understatement、完整句、極少 profanity、名詞當動詞（summer, weekend, winter in Aspen）、迴避談錢 | "It's not really done." "How novel." "We're not doing that." | 寫成英式腔會混淆；美國上流靠含蓄不靠華麗 |
+| Corporate / MBA | Jargon 密集、被動語態迴避責任、會議語言滲入私人對話 | circle back, bandwidth, align, deck, runway, optics, take this offline, at scale, low-hanging fruit | 用在非白領角色會假 |
+| Creative / fashion / media | 形容詞誇張、反諷、圈內縮寫、把品味當道德 | obsessed, iconic, a moment, chef's kiss, so last season, elevated, editorial, commercial（貶義） | 密度過高會像模仿 *Devil Wears Prada* |
+| Working class | 短句、直接、具體名詞、profanity 作為連接詞而非侮辱 | "Yeah, no." "That's on you." "Don't start." | 不要用文法錯誤來標記階層，那是刻板印象 |
+| Academic | 從句多、限定語多、"I would argue"、迴避斷言 | arguably, to be fair, that's a fair point, nuanced | 放進吵架場面會很有喜劇效果，但別誤用 |
+| Gen Z 網生代 | 見第五節 | | |
+
+### 3.2 地域標記
+
+| 地域 | 語言特徵 | 標誌詞 |
+|---|---|---|
+| New York | 快、打斷頻繁、直接到接近無禮、Yiddish 借詞、反問式肯定 | schlep, schmuck, kvetch, spiel, "Forget about it," "What am I, nuts?" "I'm walkin' here." |
+| Southern（南方） | 迂迴禮貌、句子長、ma'am/sir、把侮辱包裝成關心 | y'all, fixin' to, "bless your heart"（＝你是白痴）, reckon, "I don't mean to be rude, but—" |
+| Midwest | 迴避衝突、過度禮貌、把拒絕說成「有點難」 | ope, "you betcha," "oh for sure," "that's different"（＝我討厭它）, pop（汽水） |
+| California / Valley | uptalk（句尾上揚）、"like" 作為 discourse marker、治療語言滲入日常 | no worries, I'm not gonna lie, honestly, holding space, that's valid, "it's giving..." |
+| Boston | 省略 r、硬、諷刺 | wicked（＝非常）, "pissa," 直呼 "kid" |
+| Texas | 慢、自信、誇張比喻 | y'all, fixin', "all hat, no cattle" |
+
+**用法**：短劇中地域標記最有效的用途是**製造階層錯位的喜劇或羞辱**——南方女孩闖進紐約時尚圈，Midwest 的禮貌在紐約被讀成軟弱。這正是逆襲題材的天然燃料。
+
+### 3.3 AAVE 與族裔社群語言
+
+處理 African American Vernacular English（AAVE）必須嚴謹。AAVE 是有完整語法系統的方言，不是「錯誤英語」。
+
+- **語法特徵**：habitual "be"（"He be working" ＝ 他慣常在工作，與 "He working" ＝ 他此刻在工作，意義不同）、copula deletion（"She my sister"）、否定一致（"Don't nobody know"）、完成體 "done"（"I done told you"）。
+- **常見詞**：finna, ain't, tryna, deadass, on God, y'all, folks.
+- **紅線**：不要用 AAVE 標記反派、笑點或低教育；不要讓非黑人角色隨意挪用 AAVE 詞彙而不設情境（這本身可以是有意識的劇情點——白人網紅挪用黑人語言被 call out，是時尚／KOL 題材的真實衝突）；不要用拼寫變形（"dat," "wuz"）來製造口音，那是 minstrel 傳統。
+- **原則**：從**這個角色是誰**出發，不要從「這個族裔怎麼講話」出發。
+
+其他社群：Spanglish 的 code-switching 通常發生在情緒轉折點（憤怒、親密、對長輩），而非隨機夾字；亞裔美國人角色若是第二代，英文是母語，**不應該有口音或文法錯誤**——第一代與第二代的語言差異本身可以是家庭衝突的載體。
+
+### 3.4 時尚／KOL 圈行話（本項目高頻）
+
+社媒與時尚產業語言更新極快，但以下核心層相對穩定：
+
+- **創作者經濟**：brand deal, PR package, gifted（"this is gifted"）, #ad, whitelisting, rate card, engagement rate, CPM, affiliate link, LTK, drop, restock, sell-through, UGC, deliverables, exclusivity clause, morality clause.
+- **平台語言**：FYP, algorithm, shadowban, ratio'd, dragged, cancelled, receipts, tea, main character, parasocial, engagement bait, gatekeep, unfollow, mutuals, storytime, GRWM（get ready with me）, haul, try-on.
+- **時尚產業**：capsule, drop, colorway, tech pack, MOQ, lead time, buy（名詞："the buy"）, market week, look book, editorial vs commercial, sample size, deadstock, dupe, fast fashion, slow fashion, greenwashing,小眾（niche）→ "under-the-radar."
+- **MCN／經紀語境**：roster, talent, management cut, 360 deal, non-compete, first look, sunset clause.
+
+**寫法提醒**：行話要從**角色的專業自信**長出來，不是撒在對白上證明編劇做過功課。反派用行話碾壓女主的無知，是第一幕最有效的羞辱場面之一。
+
+---
+
+## 四、英式英語（反派、守門人、時尚權威）
+
+英式英語在美式為主的劇裡最有效的功能是**權威與威脅**：時尚圈守門人、跨國集團高層、老牌雜誌主編、投資人。英式的禮貌與冷刀是天然的高壓語體。
+
+### 4.1 用詞對照（高頻）
+
+| 美式 | 英式 | 美式 | 英式 |
+|---|---|---|---|
+| apartment | flat | elevator | lift |
+| sneakers | trainers | pants | trousers |
+| sweater | jumper | line（排隊） | queue |
+| vacation | holiday | cell phone | mobile |
+| mad（生氣） | angry（mad ＝ 瘋） | garbage | rubbish |
+| store | shop | fall | autumn |
+| soccer | football | check（帳單） | bill |
+| resume | CV | schedule /ˈskedʒuːl/ | /ˈʃedjuːl/ |
+| period（句號） | full stop | awesome | brilliant |
+
+時尚業特有：英式用 shop floor、high street（＝大眾平價通路）、kit、smart（＝正式得體）、"it's a bit much"（＝太over）。
+
+### 4.2 句法差異
+
+- `Have you got...?`（英）vs `Do you have...?`（美）
+- `at the weekend`（英）vs `on the weekend`（美）
+- 現在完成式使用頻率高得多：`I've just eaten`（英）vs `I just ate`（美）
+- 集合名詞用複數：`The team are ready.`（英）vs `The team is ready.`（美）
+- `shall` 仍活著（英），美式基本消失
+
+### 4.3 英式 understatement 與禮貌威脅
+
+這是英式對白最有戲劇價值的部分。**越禮貌越危險**，字面意思與實際意思經常相反：
+
+| 說的話 | 實際意思 |
+|---|---|
+| "That's interesting." | 我不同意 / 這很糟 |
+| "With the greatest respect..." | 你是白痴 |
+| "I'm sure it's fine." | 我確信它不行 |
+| "We'll bear it in mind." | 已經忘了 |
+| "It's a bold choice." | 這很醜 |
+| "I might suggest..." | 照我說的做 |
+| "Not bad." | 相當好 |
+| "Quite good."（英） | 還可以（減弱）；美式 "quite good" ＝ 相當好（加強）—— 同一句話兩地意思相反 |
+
+粗口與情緒詞差異：bloody, bollocks, knackered, gutted, taking the piss, wanker, prat, sod off, can't be arsed。英式粗口在階層上比美式更寬容——上流角色講 "bloody hell" 不破人設。
+
+### 4.4 口音層次（點到即止）
+
+RP／Received Pronunciation（權威、老錢、可能是反派）、Estuary（倫敦周邊、當代中產、時尚圈常見）、Northern（曼徹斯特／利物浦，直接、溫暖、反建制）、Scottish、Irish。劇本文字層面主要靠**用詞與句法**呈現，口音交給選角與演員；必要時在動作行標註 `△ (Northern accent)`，不要用拼寫變形硬寫。
+
+---
+
+## 五、世代語言（當代核心）
+
+這是當代戲最重要的年齡標記，比地域更精準。**警告：slang 半衰期約 6–18 個月。** 建議每個角色只配 2–3 個 signature 用語，其餘用中性語言；密集堆 slang 會讓劇集兩年後不可看，也是最常見的「中年編劇寫年輕人」破綻。
+
+| 世代 | 出生年 | 語言特徵 | 標誌詞（用於校準，非照抄） |
+|---|---|---|---|
+| Gen Alpha | 2013– | 極短、遊戲／串流借詞、反諷嵌套 | sigma, skibidi, rizz, gyat, cooked, "it's so over" |
+| Gen Z | 1997–2012 | 反諷為預設、貶義褒用、名詞動詞化、句法碎裂 | no cap, bet, mid, ate, slay, delulu, the ick, low-key/high-key, real ones, aura, unserious, "it's giving—", "not me doing this," "the way she just—" |
+| Millennial | 1981–1996 | 自嘲、過度限定、流行文化比喻、感嘆式 | adulting, I can't even, literally, TBH, oof, "doing the thing," "this is fine," Harry Potter／Office 比喻 |
+| Gen X | 1965–1980 | 乾、諷刺、拒絕熱情、簡短 | whatever, as if, "yeah, no," "I'm good," 極少用 emoji 語言 |
+| Boomer | 1946–1964 | 完整句、迴避縮寫、正式問候滲入日常、對科技用詞不準 | "the Facebook," "a text message," "young lady" |
+
+**跨世代誤用是免費的喜劇與衝突**：Boomer 主管說 "we need to go viral"、Millennial 主管試圖用 Gen Z 語言拉近距離而失敗（"slay, queen" 說出口的瞬間就輸了）、Gen Z 女主用反諷回應真誠關心而傷人。KOL 題材裡，**世代語言差異本身就是商業衝突**：客戶要的 tone 與創作者的 tone 不同。
+
+社媒語言另見第三節第 3.4 小節。
+
+---
+
+## 六、年代快速對照（1980s–2010s）
+
+當代為主的劇通常只需要閃回。每個年代給**兩三個精準記號**即可，不要做道具展。
+
+| 年代 | 科技／物件 | 俚語 | 禁忌與注意 |
+|---|---|---|---|
+| 1980s | Walkman, VHS, payphone, answering machine, Filofax | rad, gnarly, psych!, "totally," "gag me" | 無手機＝聯絡不上是有效的劇情引擎 |
+| 1990s | pager, dial-up, AIM, CD, Blockbuster | as if, talk to the hand, "all that and a bag of chips," phat, "not!" | 電郵剛普及；"cell phone" 是奢侈品 |
+| 2000s | flip phone, iPod, MySpace, Sidekick, LiveJournal | "that's so random," "hot mess," "epic fail," bling, "my bad" | Y2K 時尚回潮，現在寫 2000s 有懷舊變現價值 |
+| 2010s | iPhone, Instagram（濾鏡時代）, Vine, Tumblr, Snapchat | on fleek, bae, YOLO, basic, "I can't even," squad, "throwing shade" | 初代網紅生態：濾鏡、hashtag、Instagram 方形照 |
+
+若需要更早年代（Regency、Victorian、1920s–1950s）或英式古裝，另行索取——本指南不涵蓋。
+
+---
+
+## 七、平台尺度與粗口
+
+| 平台／類型 | 尺度 | 處理 |
+|---|---|---|
+| ReelShort / DramaBox 等豎屏短劇 | 中等。允許 damn, hell, ass, bitch（有限），f-word 通常避免或極少 | 用替代式：freaking, frickin', screw, hell, "what the—"（切斷） |
+| TikTok / YouTube 分發片段 | 最嚴。演算法會壓抑含粗口內容 | 前 3 秒尤其乾淨；粗口靠 bleep 或切斷 |
+| 串流劇集 | 寬 | 按角色與階層自然使用 |
+
+原則：**粗口是角色標記與壓力指標，不是強度旋鈕**。一個從不罵髒話的角色第一次爆粗，比一個每句都罵的角色更有力。英文粗口常作為語法填充（"I'm so fucking tired"）而非侮辱，這與中文粗口的攻擊性用法不同，直譯會過重。
+
+---
+
+## 八、英文對白品質檢查清單
+
+交付前逐項核對：
+
+1. **Contraction**：日常對白是否已縮寫？不縮寫的句子是否都有戲劇理由？
+2. **呼名密度**：一場戲直呼對方名字是否超過兩次？超過就刪。
+3. **句長**：是否有超過 20 字而無理由的句子？
+4. **情緒宣言**：是否出現 "I hate you" 式直白宣言？能否改成具體、冷、小的句子？
+5. **翻譯腔**：遮住角色名朗讀，是否像字幕？是否有成語直譯、敬語殘留、主語缺失？
+6. **角色聲音**：遮住名字後能否分辨誰在說話？每個角色的階層／地域／世代標記是否一致且克制？
+7. **語體串味**：美式角色是否誤用英式詞（flat, trainers, mobile）？英式角色是否誤用美式詞？是否有角色同時帶兩地標記？
+8. **世代準確**：slang 是否符合角色出生年？是否堆砌過密以致兩年後過時？
+9. **族裔語言**：AAVE 或其他社群語言是否從角色出發而非刻板印象？是否被用來標記反派或笑點？
+10. **行話**：時尚／KOL 行話是否服務角色的專業自信與權力關係，而非炫技？
+11. **平台尺度**：粗口密度是否符合投放平台？開場 3 秒是否乾淨？
+12. **可演性**：停頓、打斷、沉默是否寫進動作行，而非依賴 (pause)？
+
+---
+
+## 九、英文語料庫（可查詢）
+
+`references/data/en/` 收錄 133 條美式英文對白，每條有 phrase、variants、example（真對白）、meaning（繁體中文解釋）、tone、function、register、profanity、tags。
+
+| shard | 條數 | 內容 |
+|---|---|---|
+| `core.json` | 45 | small talk、服務台詞（咖啡店／diner／超商）、問路、鄰里、家庭、婉拒、道別、道歉道謝 |
+| `work.json` | 45 | corporate-speak、上司下屬、面試、美式裝修工程（estimate／permit／punch list／change order）、客服、談判 |
+| `slang.json` | 43 | Gen Z／Millennial、衝突升級、網絡、地域標記（NY／Boston／Southern／California）、AAVE 借用 |
+
+~~~bash
+node scripts/ref.mjs --lang en list --age young --tag 職場
+node scripts/ref.mjs --lang en list --tag 衝突 --max-prof 1
+node scripts/ref.mjs --lang en search contractor
+node scripts/ref.mjs --lang en sentences
+~~~
+
+索引：`references/en-index.md`；全部句：`references/data/en-sentences.md`（另附 CSV）。
+每條 entry 嘅 tags 可以直接對應上面第二至第五節嘅階層、地域、世代與行話分類，寫稿前抽兩三條對照語感，唔好照抄。

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

@@ -0,0 +1,312 @@
+> 本文件係 **日文專屬 reference guide**（東京標準語為主軸、関西弁為對照軸）；主流程見 SKILL.md，語言中立的診斷框架見 dialogue_revision_framework.md。
+
+# 日文對白指南（東京標準語為主／関西弁為輔）
+本文件供日文對白任務使用：原創日文劇本、把中文劇本轉成日文版、校對字幕與配音稿、為日本市場的短劇做在地化。核心立場同其他語言一致——對白係人物在壓力下的行動，唔係資訊傳輸；但日文的敬語系統、主語省略、終助詞與ウチ／ソト意識，令逐字翻譯幾乎一定出戲。以**東京標準語（共通語）**為主軸、**関西弁**作對照，敬語以**現代商務日語**為準，唔寫昭和式過度敬語。
+
+## 一、先定三件事
+
+寫日文對白之前先答三條問題；答錯任何一條，之後幾多修辭都救唔返。
+
+### 1.1 地區：東京標準語 vs 関西弁
+
+| 項目 | 東京標準語 | 関西弁（大阪） | 使用判斷 |
+|---|---|---|---|
+| 否定 | 行かない | 行かへん | 関西背景角色用；半混最難聽 |
+| 斷定 | そうだよ | せやで | 一句東京一句大阪＝即刻出戲 |
+| 不行／拒絕 | だめ／無理 | あかん | 「あかん」帶人情味，勸阻、講價常用 |
+| 感謝／道歉 | ありがとう／ごめん | おおきに／すんません | 老舖、年長者、關西商業場景高頻 |
+| 吐槽 | 何言ってるの | なんでやねん | 喜劇節奏嘅核心拍子 |
+
+関西弁係一套完整語法，唔係「標準語講歪」。最難聽嘅做法係東京角色偶爾加一句「せやな」扮親切——觀眾一聽就知編劇唔識。関西仲有敬語形「〜はる」（見下表），係對長輩、客人用嘅正式講法。
+
+| 標準語（尊敬語） | 関西弁（〜はる） | 備註 |
+|---|---|---|
+| 行かれる／いらっしゃる | 行かはる | 對長輩、客人都用；東京人聽落覺得親切 |
+| 食べられる／召し上がる | 食べはる | 年輕角色互相用會過敬，同輩之間用返タメ口 |
+| される／なさる／言われる | しはる／言わはる | 唔可以同標準語尊敬語混：冇「いらっしゃはる」 |
+
+### 1.2 ウチ／ソト（內外關係）
+
+| 場面 | ウチ（內） | ソト（外） | 語言後果 |
+|---|---|---|---|
+| 公司內部 | 同僚、部下 | — | タメ口可，但對上司仍要丁寧 |
+| 面對客戶 | — | 客戶、供應商 | 丁寧語＋謙譲語；自己公司的人一律降格 |
+| 家庭 | 家人 | 訪客、鄰居 | 對家人タメ口，訪客一到即刻切り替え |
+| 朋友聚會 | 熟人 | 初次見面 | 全場只有一個人講敬語＝關係信號 |
+
+先問「呢場戲嘅ウチ係邊個」：同一個課長，社內叫「田中さん」，對客就係「田中が申しておりました」。
+
+### 1.3 語域三檔
+
+| 語域 | 形式 | 對象 | 例 |
+|---|---|---|---|
+| 丁寧語（ですます） | 〜です／〜ます | 初對面、客、目上 | 少々お待ちください |
+| タメ口（常體） | 〜だ／〜る | 同輩、朋友、家人、目下 | ちょっと待って |
+| 尊敬語・謙譲語 | 動作の向き | 客・目上／自己的動作 | ご覧になりますか／拝見しました |
+
+固定 register 靠三點：**一人稱**（俺／僕／私／あたし／わし）＋**文末**（だ／です／っす）＋**呼稱**（さん／くん／呼び捨て）。三點一致；故意唔一致就係戲——電話用敬語，一收線即刻轉タメ口。
+
+## 二、敬語三層
+
+敬語唔係越高越好。日劇真正嘅高手係丁寧語打底，關鍵位落一發尊敬語，令對方即刻坐直；成套尊敬語反而似電話錄音。
+
+| 動詞 | 尊敬語（對方動作） | 謙譲語（自己動作） | 丁寧語 | 螢幕場景 |
+|---|---|---|---|---|
+| 言う | おっしゃる | 申す／申し上げる | 言います | 轉述上司指示 |
+| 行く | いらっしゃる／おいでになる | 伺う／参る | 行きます | 去客先 |
+| 来る | いらっしゃる／おいでになる／見える | 参る | 来ます | 迎接客戶 |
+| いる | いらっしゃる | おる | います | 確認在席 |
+| 食べる | 召し上がる | いただく | 食べます | 接待、請客 |
+| 見る | ご覧になる | 拝見する | 見ます | 遞資料 |
+| する | なさる | いたす | します | 請託 |
+| もらう | お受け取りになる | いただく | もらいます | 收件、收禮 |
+| あげる | お与えになる（偏書面） | 差し上げる | あげます | 送手信 |
+
+- **尊敬語同謙譲語係方向**：尊敬語只講對方動作（「私がいらっしゃいます」係最典型嘅錯）；謙譲語壓低自己，對社外唔可以抬自己公司嘅人。
+- **丁寧語係底**：八成場面丁寧語已經夠；唔肯定就用丁寧語——二重敬語比唔用敬語更失禮。
+
+**二重敬語同バイト敬語（常見錯）**
+
+| NG | 問題 | 改 |
+|---|---|---|
+| おっしゃられる／ご覧になられる | 敬語形＋られる | おっしゃる／ご覧になる |
+| お伺いさせていただきます | 伺う＋させていただく | 伺います |
+| お召し上がりになられる | 三重敬語 | 召し上がります |
+| させていただきます（濫用） | 許可の意味が消える | します |
+| よろしかったでしょうか | 過去形が不自然 | よろしいですか |
+| 千円からお預かりします | 「から」不要 | 千円お預かりします |
+| こちらコーヒーになります | 「になる」係變化 | コーヒーです |
+| お水のほうお持ちしました | 「のほう」無意義 | お水お持ちしました |
+
+## 三、終助詞與語氣
+
+日文角色嘅態度，七成落喺句尾一粒字。**一句最多一個終助詞**，兩個已經係強烈情緒，三個就係綜藝口白。
+
+| 終助詞 | 態度 | 例 | 用錯後果 |
+|---|---|---|---|
+| よ | 告知、帶上目線 | 明日、休みだよ | 對客用「よ」＝教訓人 |
+| ね | 同意要求、拉近 | いい天気ですね | 連續「ね」＝逼人附和 |
+| よね | 確認＋施壓 | 明日、来るよね？ | 溫柔問句變質問責 |
+| さ | 輕鬆、投げやり | まあ、そういうこともあるさ | 上目線，女性少用 |
+| な | 感嘆／禁止 | 危ないな／行くな | 語調一錯就變命令 |
+| なあ | 感慨、独り言 | いいなあ | 對人講＝唔理人 |
+| かよ | 反語、不信 | なんだよ、それかよ | 直接挑釁，客前 NG |
+| じゃん | 開き直り | 前も言ったじゃん | 關東若者；對上司＝不遜 |
+| っす | 輕敬語、体育会系 | 了解っす／マジっすか | 半端敬語，接客 NG |
+| ぞ | 男性、威壓／独り言 | 行くぞ | 對客＝威脅 |
+| ぜ | 男性、邀約 | 行こうぜ | 女性角色用＝演出痕跡重 |
+| わ | 柔軟斷定 | もう帰るわ | 關西用法更強、帶怒 |
+| もの（もん） | 辯解、撒嬌 | だって仕方ないもん | 成年男性用＝幼稚 |
+| かな | 婉曲、迷い | そろそろ行こうかな | 該決定時用＝優柔不断 |
+| でしょ | 確認、押付 | だから言ったでしょ | 對客＝責備 |
+| だろ | 男性、詰め | だから言っただろ | 一講就變吵架 |
+| のに | 不滿、可惜 | 言ったのに | 對客＝埋怨 |
+| けど | 前置き、婉拒 | 悪いけど、今日は無理 | 句尾「けど」＝話未講完，空氣中斷 |
+| かしら | 女性、上品（偏舊） | これ、合うかしら | 年輕角色用＝動畫腔 |
+
+堆砌係最常見嘅病：「そうだよねー、わかるよー、でもさー」——呢句係綜藝主持，唔係人講嘢。
+
+## 四、稱謂與呼び方
+
+| 稱謂 | 對邊個 | 例 | 禁區 |
+|---|---|---|---|
+| さん | 預設，保持恰當距離 | 田中さん、いいですか | 對自己公司的人講「さん」俾客聽＝NG |
+| くん | 男性同輩／目下 | 佐藤くん、これ頼む | 對女性部下用＝軍隊感 |
+| ちゃん | 親密、可愛 | みきちゃん、おいで | 對客、對上司＝失禮 |
+| 様 | 客、通知、書面 | お客様、お呼び出しです | 日常對話用＝機械感 |
+| 先生 | 教師、醫、議員、律師 | 先生、質問いいですか | 對普通同事用＝叫錯人 |
+| 先輩 | 同組織內年長 | 先輩、これどうすれば | 對客唔用 |
+| 課長／部長／社長 | 役職呼び | 課長、お時間よろしいですか | 對社外用＝NG |
+| 呼び捨て | 親密／目上から目下 | 田中、来い | 對客、對上司＝宣戰 |
+
+由姓轉名係日本戲最重要嘅關係刻度，正常由**對方**開口「下の名前で呼んでいいよ」；主角搶先叫名＝越界。呼び捨て係另一個刻度，用錯等於侮辱，用得準等於親密。對社外要**降格**：「田中は席を外しております」，唔可以講「田中課長はいらっしゃいません」。
+
+## 五、句法特徵
+
+- **SOV＋省略＋一人稱**：動詞放最後、修飾語在前，倒裝係張力工具（「行ったよ、昨日、一人で」）；主語預設省略，寫出來就係強調或發難（「私がやった」）；俺／僕／私 一場戲內漂移就係編劇痕迹。
+- **だ・である vs 會話**：である 係旁白、論文、演說；會話常體係「だ＋終助詞」；ですます 係距離；體言止め（「以上。」「理由は一つ。」）適合反派。
+- **相槌要寫**：「うん」「へえ」「そうなんだ」係日文對話嘅呼吸；一句都冇，會覺得兩個人在讀稿。
+
+## 六、年齡層速查
+
+- **kid（6–12）**：「ねえねえ、これ見て！」「ずるい！」「もう一回！」「ママー、トイレー」——語尾上揚、撒嬌、句子短。
+- **teen（13–19）**：「まじで？」「うざっ」「きもい」「てか、だるくない？」——「っ」切句、若者語，對長輩轉敬語仲未上手。
+- **young（20–29）**：「めっちゃいいじゃん」「やばい、間に合わない」「とりま行こ」「りょ」——氣氛優先，敬語係「っす」混住。
+- **mid（30–44）**：「さすがにそれはないでしょ」「ちょっと確認します」「助かります」——場面切換純熟，推責任嘅講法多。
+- **senior（45–59）**：「そうですねえ」「まあ、いいんじゃない」「最近の若い人はねえ」——句尾拉長、帶評價、斷定。
+- **elder（60+）**：「ありがとうねえ」「えらいねえ」「わしが若い頃はな」「おおきに」——方言與老派詞、慢、常帶人生教訓。
+
+## 七、角色類型速查
+
+| 角色（archetype） | 例台詞 | 語感 |
+|---|---|---|
+| student | 先生、これ試験に出ますか？／バイトだるい | 語尾上揚、若者語 |
+| slacker | まあ、なんとかなるっしょ／今日は無理 | 冇力、語尾拖長 |
+| office | お疲れさまです／それ、共有しときます | 丁寧語底、略語多 |
+| boss | で、いつできるの？／上に通しといて | 短、斷定、用提問逼人 |
+| client | 予算、これくらいなんですけど／他社さんは安かったですよ | 婉曲＋比較施壓 |
+| craftsman | この下地、弱いな／図面と現場、違うぞ | 現場語、短句、斷定 |
+| waitress | お待たせしましたー／ご注文お決まりですか | 愛想＋定型、語尾拉長 |
+| shopkeeper | らっしゃい！／これ、今日入ったやつ | 威勢、常體 |
+| security | すみません、こちらでお待ちください | 丁寧、定型、保持距離 |
+| housewife | うちの旦那がねえ／それ、いくらしたの？ | 世間話、對價錢敏感 |
+| designer | この色、重いかな／トーン合わせましょう | 用形容詞評價、提案型 |
+| street | おい、そこの／聞いてんのか | 短、威壓、呼び捨て |
+| elder | わしが若い頃はなあ／まあ、座りなさい | 慢、教訓、方言 |
+| trainer | あと五回！ラスト！／フォーム崩れてるよ | 命令＋激勵、聲量大 |
+| mum | ごはんできてるよ／ちゃんと食べた？ | 溫柔嘅斷定＋問句 |
+| dad | 金はあるか？／ほどほどにしろよ | 無口、短、掩飾 |
+| kid | ぼくがやる！／ずるい！ | 全力、語尾上揚 |
+| teacher | 静かに／ここ、大事だからね | 短指示＋說明 |
+| sales | 一点だけ提案させてください／本日決めていただければ | 敬語＋收單話術 |
+| delivery | 宅配です、ハンコお願いします／置き配でいいですか | 定型、快、丁寧 |
+
+## 八、粗口／髒話分級
+
+| 級 | 詞 | 語感 | 平台 |
+|---|---|---|---|
+| p1 | バカ、アホ、うるさい、ムカつく、うざい、最低 | 日常鬧人，唔破壞關係 | 全部可 |
+| p2 | クソ、バカ野郎、てめえ、ふざけんな、消えろ | 明確敵意，吵架入口 | 地上波限深夜；配信可 |
+| p3 | 死ね、殺すぞ、カス、ゴミ、手前 | 放送禁止級、威脅 | 地上波 NG；TikTok 有刪片風險 |
+
+| 平台 | 尺度 | 處理 |
+|---|---|---|
+| 地上波 | 最嚴（BPO 放送コード） | 「死ね」NG、差別語 NG，p1 止 |
+| Netflix／Prime | 寬 | p3 可，但差別語、侮辱實存人物照樣出事 |
+| YouTube | 廣告收益與年齡限制風險 | p2 止；開頭 3 秒要乾淨 |
+| TikTok／Shorts／縱向短劇 | 自動偵測＋平台審查，日本市場接近地上波 | p1 為主，p2 靠 bleep 或切斷 |
+
+地域差要留神：關西で「アホ」係親密、「バカ」係侮辱；東京大致相反，但「アホか」兩地都係挑釁。粗口係**角色刻度**，唔係強度旋鈕。
+
+## 九、書面→口語對照
+
+| 中文書面 | 直譯（錯／生硬） | 日文真實講法 | 場口 |
+|---|---|---|---|
+| 我知道了 | 私は知りました | 了解しました／わかった／オッケー | 職場回應 |
+| 非常抱歉 | 非常に申し訳ありません | 申し訳ございません／すみません／悪い | 道歉 |
+| 請問您貴姓 | お名前は何ですか | お名前を伺ってもよろしいですか | 接待 |
+| 麻煩你了 | あなたを煩わせました | お手数をおかけします／よろしくお願いします | 拜託人 |
+| 沒關係 | 関係ありません | 大丈夫です／気にしないで | 安慰 |
+| 你在幹什麼 | あなたは何をしていますか | 何してるの？／何やってんの？ | 質問 |
+| 我要走了 | 私は行きます | そろそろ失礼します | 收線、離席 |
+| 真的嗎 | 本当ですか | まじで？／うそ／本当に？ | 反應 |
+| 謝謝你的幫助 | あなたの助けに感謝します | 助かりました／ありがとうございます | 道謝 |
+| 我不同意 | 私は同意しません | それはちょっと…／納得できない | 反對 |
+| 你辛苦了 | あなたは大変でした | お疲れさまでした | 同事收工 |
+| 請多關照 | （無對應直譯，硬譯會變怪） | よろしくお願いします／よろしく | 自我介紹、收線 |
+| 我不會 | 私はできません | できません／無理です／分かんない | 拒絕 |
+| 我早就知道了 | 私はもう知っていました | 知ってたよ／前から言ってるじゃん | 埋怨 |
+| 你沒事吧 | あなたは大丈夫ですか | 大丈夫？／平気？ | 關心 |
+| 太貴了 | とても高いです | 高っ／ちょっと高いですね | 講價 |
+| 別開玩笑 | 冗談を言わないで | やめてよ／冗談でしょ | 制止 |
+| 我在忙 | 私は忙しいです | 今ちょっと立て込んでて | 推辭 |
+| 隨便 | 勝手に | なんでもいいよ／おまかせします | 點餐、決定 |
+| 馬上 | すぐに | すぐ行く／ちょっと待って | 回應 |
+
+## 十、中→日 transcreation 陷阱
+
+| 中文／漢字面 | 以為係 | 實際處理 |
+|---|---|---|
+| 大丈夫です | 沒問題 | 亦係婉拒：店員問「袋いりますか」→「大丈夫です」＝不用 |
+| 検討します | 會考慮 | 商務上多數＝拒絕；「前向きに検討します」更似拒絕 |
+| 麻煩你了 | 一個講法 | お手数をおかけします（求人）／よろしくお願いします（收線）／悪いね（朋友） |
+| 知道了 | 一個講法 | 了解しました（同事）／承知しました（客、書面）／かしこまりました（接客）／わかった（同輩） |
+| 加油 | 頑張って | 只可上對下或同輩；對上司用「応援しています」「ご健闘をお祈りします」 |
+| 沒關係 | 大丈夫 | 對客用「とんでもないです」更得體 |
+| 隨便 | なんでもいい | 易失禮；改「おまかせします」「何でも大丈夫です」 |
+| 你辛苦了 | お疲れさま | お疲れさまです（同事）／ご苦労さま（只可上對下，反用＝侮辱） |
+| 好的 | はい | 對客只可 はい／かしこまりました；「了解です」對客偏輕 |
+| 我再想想 | 考えさせて | ちょっと考えさせてください（真考慮）／検討します（婉拒） |
+| 我請客 | おごる | おごります（朋友）／ごちそうします（約會、正式，較 soft） |
+| 稱謂 | さん 萬用 | 「王さん」可；「小王」NG；「先生」係老師／醫生，唔係 Mr. |
+
+## 十一、字幕／配音腔（翻訳調）常見病
+
+| 病 | 例 | 改法 |
+|---|---|---|
+| 主語過多 | 私はあなたのことが好きです | 好きだよ |
+| 代名詞連發／直譯「あなた」 | あなたはどう思いますか／彼は、彼女は | どう思う？；改名字或省略（あなた 只剩妻子叫丈夫、或吵架） |
+| 過度敬語 | 友達に「お元気でいらっしゃいますか」 | 元気？ |
+| 句尾一律です／文語混入 | 全部「〜です」；会話に「〜である」「〜なのだ」 | 會話混 だ／よ／ね／じゃん；〜だよ／〜んだよ |
+| 書面接続詞 | しかし／なぜなら／したがって | でも／だって／だから |
+| 感嘆詞直譯 | 「ああ」「おお」 | え／うわ／まじで |
+| 語順照搬 | あなたは私にそれを教えた | それ、教えてくれたよね |
+| 敬語與タメ口混線／冇附和 | 同場兩種 register；兩人輪流講完整句 | 固定 register；加 うん／へえ／そうなんだ |
+
+## 十二、自檢清單
+
+- [ ] 三點 register 定咗而且一致：一人稱、文末、呼稱。
+- [ ] ウチ／ソト 切換位（尤其對客場面）正確。
+- [ ] 敬語層數對（冇二重敬語、冇バイト敬語），對社外有降格（「田中は席を外しております」）。
+- [ ] 每個角色 1–2 個 signature 終助詞，冇堆砌。
+- [ ] 敬語／タメ口 切換有戲劇理由，唔係隨機。
+- [ ] 主語省略自然；冇一句一個「私は」。
+- [ ] 冇直譯「あなた」「彼／彼女」。
+- [ ] 関西弁冇半混：一係成套，一係唔用。
+- [ ] 婉拒用法冇譯錯（大丈夫です／検討します／ちょっと…）；年齡層詞彙對（teen 唔講長輩語）。
+- [ ] 粗口級別符合平台，開頭 3 秒乾淨。
+- [ ] 相槌、間（ま）有寫，唔係兩人輪流讀稿。
+- [ ] 商談／接待場面：敬語係角色武器，唔係背景音；用得愈準，翻臉時愈痛。
+- [ ] 遮住角色名讀一次，仍然分得出邊個講。
+
+---
+
+## 十三、語料庫（可查詢）
+
+### 規模
+
+| shard | 條數 | 內容 |
+|---|---|---|
+| `core.json` | 45 | あいさつ、コンビニ、飲食、道を尋ねる、家族、電話、婉拒（大丈夫です 陷阱）、締め |
+| `work.json` | 45 | 敬語／報連相、上司部下、残業／飲み会、面接、リフォーム工事（見積もり・追加工事・工期・内覧・引き渡し）、クレーム対応 |
+| `slang.json` | 43 | 若者言葉、タメ口、関西弁、衝突、ネット、バイト敬語／二重敬語 |
+
+每條有：講法、羅馬字（Hepburn）、意思、語氣、功能、語體、粗口級別、對象、例句、場口、用錯後果、**標籤**。
+敬語／タメ口 嘅階級判斷、關西弁同標準語嘅界線、過時風險，全部寫喺每條嘅 `note`／`avoid`。
+
+人讀索引（自動生成）：`references/ja-index.md`；全部句：`references/data/ja-sentences.md`（另附 CSV）。
+
+### 查詢
+
+~~~bash
+cd <skill-root>
+node scripts/ref.mjs --lang ja list --age young --tag 敬語
+node scripts/ref.mjs --lang ja search 見積もり
+node scripts/ref.mjs --lang ja show ja-core-001
+node scripts/ref.mjs --lang ja list --tag 居酒屋 --max-prof 0
+node scripts/ref.mjs --lang ja random --tone sarcastic -n 8
+node scripts/ref.mjs --lang ja sentences        # 全部 133 句
+node scripts/ref.mjs --lang ja stats
+~~~
+
+### 標籤（tags）
+
+| 組 | 標籤 |
+|---|---|
+| 場口 | 職場、餐廳、便利店、咖啡廳、居酒屋、地鐵、街頭、店舖、裝修、地盤、家庭、校園、酒吧 |
+| 角色 | 上司、同事、客戶、店員、服務員、白領、年輕人、長輩、師傅、老闆 |
+| 用途 | 開場、收尾、拒絕、讚、踩、八卦、講價、關心、抱怨、客套、日常、面試、投訴 |
+| 語感 | 敬語、直球、冷面、潮語、老派、網絡用語、方言、黑話、外來語 |
+
+規則：角色標籤只取**主要角色**（archetype 第一位）；標籤係輔助檢索，唔取代 facet（角色、語氣、年齡仍然用 `--archetype`／`--tone`／`--age` 查）。
+
+### 實際分佈
+
+~~~
+語言：ja　總數：133 條
+shards：core.json(45), slang.json(43), work.json(45)
+
+[age]  young=88  mid=87  teen=43  senior=35  elder=9  kid=4
+
+[archetype]  office=50  student=35  sales=31  client=17  boss=16  craftsman=16  slacker=12  shopkeeper=11  waitress=8  designer=7  street=7  elder=6  mum=5  kid=4  housewife=3  delivery=2  security=1  dad=1
+
+[tone]  polite=51  warm=24  blunt=16  worried=8  helpless=8  surprised=6  angry=6  cold=4  funny=4  sarcastic=3  whiny=1  flirty=1  threat=1  sassy=1  proud=1
+
+[function]  agree=24  question=21  urge=16  greet=15  farewell=11  complain=11  praise=10  apology=9  thanks=8  warn=7  refuse-soft=6  insult=6  encourage=5  surprise=5  joke=4  threaten=4  comfort=3  dismiss=3  gossip=3  bargain=2  disagree=2  tease=2  refuse=2  challenge=1  boast=1
+
+[register]  professional=52  everyday=35  slang=22  internet=7  english-mix=6  profanity=5  idiom=4  proverb=2
+
+[profanity]  p0=126  p2=4  p1=2  p3=1
+~~~
+
+粗口分級見 §八：p2／p3 嘅 entry 全部標 `register=profanity`，並喺 `avoid`／`note` 寫明平台尺度（地上波／Netflix／YouTube／TikTok）同放送禁止用語風險。