本文建立 SOLID 在文章寫作的系統性映射，定位在組合層：卡片盒筆記法（Zettelkasten）管原子層——一張卡一個概念；SOLID 管組合層——文章之間的責任邊界、依賴方向、擴充點設計。兩層疊加構成完整的內容架構方法。

推導源頭：四種結構壓力

映射的推導源頭是文章體系承受的四種結構壓力，五原則各自管理其中一種：

結構同構的基礎是概念對應：

差異同樣真實：文章沒有編譯器、違反原則不會 crash——這決定了執行機制的不同，在「類比的邊界」段展開。

S 單一責任：一篇文章一個變動理由

程式的 SRP 說一個模組只有一個變動理由。寫作映射：一個寫作單位只承擔一個知識責任、只因一種讀者需求而修改。

判別測試有兩個。變動理由測試：這篇文章會因為什麼事件需要更新？獨立事件超過一種、就是拆分候選。刪除測試：刪掉某段後文章的核心論證仍完整、該段承擔的就是另一個責任、該路由出去。

實證：一篇企業案例分析初版同時承擔「該公司自身的財報判讀」跟「跨公司結構比較」，兩個責任互相擠壓——案例深度被比較表佔空間、比較內容被鎖在單一公司的敘事裡無法擴充。拆成案例篇跟比較篇後、兩邊各自深化（詳見 #231 案例文章跟跨公司比較是兩個分析責任）。知識卡的「一卡一概念」是 S 在原子層的同一條原則。

違反訊號：更新 A 議題時被迫重讀整篇 B 內容；兩篇文章互相解釋對方的主題；段落放錯位置時的處理是路由到該去的地方、把刪除當成唯一選項會丟失內容（見 #212 SRP 違反是路由訊號）。

O 開放封閉：對擴充開放、對重寫封閉

預期會成長的結構、設計成「新增用追加的、既有內容維持穩定」。這條原則的寫作實作是擴充點設計：比較表的比較軸、索引的表格結構、系列的骨架——這些是穩定結構、成長發生在往裡面加行加篇。

實證：加盟餐飲結構比較獨立成篇時、比較軸（食材供應模式 / 獲利結構 / 品牌集中度 / 展店策略 / 估值）就是擴充點——之後加入第三家公司只在既有軸加行、任何案例文章都保持穩定。知識卡體系同樣：新文章引用既有卡、卡不需要為新文章修改。

邊界是這條原則最重要的部分：O 管結構骨架、內容不在管轄範圍。把 O 推到內容層會變成「所有案例共用同一模板」——這直接牴觸情境優先於模板的寫作原則（AGENTS.md 原則八）。案例敘事、失敗條件、回退路徑依各自情境重寫；守 O 的只有表格軸、索引結構、系列骨架這些擴充點。

違反訊號：每次加新內容都要回頭改動多篇既有文章；比較內容散落在多篇案例文章裡、加新比較對象時不知道改哪篇。

L 替換性：同類文章對讀者履行同一契約

程式的 LSP 說子型別可以替換父型別而不破壞呼叫者的預期。寫作映射在讀者預期層、有兩個檢查面。

介面對實作：title、description、index hook 是介面、內文是實作——讀者依承諾進入、內文必須履行。description 承諾「批判性分析」、內文就要有批判檢驗、單純的公司簡介違約。同類對同類：同一個索引分類下的文章（例如「實作案例篇」）對讀者履行同型的功能契約——讀者讀過一篇案例分析、對下一篇的功能預期（有定位、有判讀、有紅旗、有可遷移框架）應該成立。契約是功能層承諾、模板是結構層複製、L 要求前者。

實證：#97 Metadata surface 要納入寫作 review——正文已改新 frame、title 跟 MOC hook 保留舊 frame、介面跟實作脫鉤；#161 摘要壓縮可以丟細節、不可以改模態——description 把本體的「可延後但要記錄」壓成「不可跳過」、讀者依摘要行動就偏離本體。

這是五個映射裡最依賴類比延伸的一條——程式的 LSP 靠型別系統定義、文章的「替換」發生在讀者預期層、沒有機器可驗證的判準。保留它的理由是「介面承諾 vs 實作履行」的檢查在寫作實務反覆出現、上述兩張卡都是這條的實例。

I 介面隔離：讀者不被迫消費無關內容

程式的 ISP 說 client 不該被迫依賴用不到的方法。寫作映射：不同讀者群透過不同入口進入體系、每條入口只包含該讀者需要的內容。

實作在三個層次。模組層是讀者路線表——企業財務分析模組的三條路線（報表識讀 / 投資評估 / 價值鏈追溯）讓同一批文章對三種讀者呈現三種讀取序列、每條序列跳過該讀者用不到的篇章。文章層是視角分段——投資人視角跟加盟主視角各自成段、讀者可以跳過非自身視角的段落。術語層是知識卡外移——術語解釋放卡片、需要的讀者點進去、已熟悉的讀者不被打斷。

文章的 I 比程式更嚴苛：程式的 caller 被迫依賴多餘介面、代價是編譯負擔；讀者被迫閱讀無關內容、代價是直接棄讀。

違反訊號：描述目標讀者時需要用「和」連接多個群體、且各群體需要的內容在文中交錯到無法跳讀；讀者要讀完大段無關內容才能到達自己需要的部分。

D 依賴反轉：案例依賴方法論、方法論不依賴案例

程式的 DIP 說高層模組跟低層模組都依賴抽象。寫作映射：具體層（案例文章）依賴抽象層（方法論、知識卡）；抽象層引用具體只作為示例、不作為前提。

依賴方向決定變動傳遞方向。案例更新（財報換季、公司改變策略）不會迫使方法論改寫；方法論修正會提示所有案例重檢——這個不對稱正是體系要的：抽象層穩定、具體層流動。

實證：AGENTS.md 的既有規則「Backend 是語言無關層、各語言章節可連到 Backend 能力、Backend 不反向依賴語言實作」就是 D、先於本文存在。ddd/（方法論精神層）跟 flutter/（語言實作層）的模組拆分同樣路由單向。案例文章引用企業評估定位做兩軸分析、方法論篇不需要知道任何一篇案例的存在。

違反訊號：讀方法論篇必須先讀過某篇案例才看得懂（抽象依賴了具體）；修改某篇案例時要回頭改方法論（變動反向傳遞）；方法論的判準用某個案例的特殊條件寫成（過度擬合單一 case）。

類比的邊界

映射有三個誠實的限制。

執行機制不同。程式違反 SOLID 由編譯器、runtime、測試暴露；文章違反由 review 暴露、依賴人或 agent 執行。所以 SOLID 寫作映射必須掛上 review 機制才有效力——multi-round review 的 frame 清單裡、結構軸（責任邊界 / 依賴方向 / 擴充點 / 讀者分流）是一個獨立的檢查 frame。

L 是最弱映射。型別系統對「可替換」有機器可驗證的定義、讀者預期沒有。L 的寫作版本操作化成「介面承諾 vs 實作履行」的比對——這是它可執行的形式、也是它的極限。

D 不是真正的反轉。程式的 DIP 核心是控制反轉：高層模組定義抽象介面、低層模組實作它、依賴方向被「倒過來」。寫作映射借不到這一半——方法論沒有定義一個「案例必須實作的介面」、案例也不是被注入方法論的可替換實作。寫作版的 D 實際只保住了 DIP 的一半：依賴無環（案例引用方法論、方法論不回指案例）加上穩定度梯度（抽象層穩定、具體層流動）。用「反轉」命名是取它「變動不反向傳遞」的效果、不是取控制反轉的機制；把它讀成完整的 IoC 會期待一個不存在的介面契約。這一半的缺席也解釋了為什麼 D 的違反只能靠依賴圖檢查（有沒有環、改案例要不要回改方法論）、而不像程式能靠介面型別擋下。

模板化風險。O 跟 L 都有被過度應用成「統一模板」的風險。判別線：SOLID 管誰承擔什麼責任、依賴往哪走、擴充點在哪——這些是結構；情境敘事、案例語言、失敗條件的描述是內容、依情境重寫。結構原則被拿來否定合理的情境差異時（「這篇的章節跟那篇長得不一樣、不符合 O」）、是誤用訊號、回到情境優先於模板。

跟卡片盒筆記法的分工

S 是兩層的接縫——卡片層的「一卡一概念」跟文章層的「一篇一責任」是同一條原則在不同粒度的形式。體系從卡片長到文章、從文章長到模組時、S 一路適用；O / L / I / D 在多篇文章開始形成體系時才進場。

結構檢查清單

檢查時機有兩個：新文章動筆前（決定它的責任邊界跟依賴方向）、系列成長到出現結構張力時（加新內容變得越來越貴、就是結構 review 的訊號）。

本文依賴 SOLID 寫作方法論的組合層框架、是它在術語層的應用。

難度曲線假說的檢驗

「難度低多解釋、難度高少解釋」的假說有一個成立面跟兩個問題面。

成立面：行內解釋（在正文用一兩句定義術語）打斷所有讀者的閱讀流、對已熟悉術語的讀者是純成本。深度分析的目標讀者大多已具備基礎詞彙、行內解釋量隨深度遞減是合理的。

問題一：「難度」是主觀推導、寫作時無法檢查。同一篇文章對財務背景讀者是入門、對工程師是進階——難度是「文章假設讀者已有什麼」的衍生感受、可操作的是那個假設本身。把假設顯式化成前置知識基線（本文預設讀者已具備哪些詞彙）、難度就從 vibes 變成可宣告、可檢查的 fact。

問題二：「少解釋」如果操作成「裸用術語」、會切斷空降讀者（從搜尋直達深度篇、跳過前置路線的讀者）的回路。知識卡系統讓「少解釋」有第二種操作：正文用術語、連結到卡片——專業讀者不被打斷（連結可以不點）、缺經驗讀者一跳可達。所以深度篇遞減的是行內解釋、連卡密度維持。

明確定義

術語處理的三級

判定兩軸

軸一：術語在本文的角色

• 主線——本文的核心論證繞著它轉、或本文就是在教它（例：營業槓桿之於一篇拆解「營收 +9.5% 為何淨利 +42%」的案例分析）
• 支撐——論證用到、但本文不負責教（例：P/E 之於同一篇案例分析）
• 背景——順帶出現、換掉措辭不影響論證

角色不靠語感判、用兩個機械測試落位，避免這一軸停在維度清單。黑箱測試分主線與支撐：讓讀者把這個術語當黑箱（只知道名字加一句話結論、不懂內部機制），還跟得上本文的核心論證嗎——跟得上是支撐或背景（結論代入即可），跟不上是主線（論證繞著它的機制轉、不展開就斷線）。刪除測試分支撐與背景：把這個術語整個拿掉，論證有沒有少一個環節——少一環是支撐（論證引用了它的結論）、毫無影響是背景（純措辭）。兩個測試串起來就是角色軸的判定順序：先問黑箱測試分出主線，再對非主線的問刪除測試分出支撐與背景。

軸二：術語相對於本文宣告的基線

基線的操作化定義：

1本文基線 = 模組讀者定位聲明 ∪ 讀者路線中位於本文之前的篇章所教的主線術語

模組讀者定位是基線起點（例：財務分析模組的起點定位是「工程背景、第一次看財報」）；文章在讀者路線中的位置決定基線的累積量——路線第一篇的基線最小、越後段越多術語從「要解釋」轉入「已具備」。

判定矩陣

三條推論：

1. 主線術語永遠行內展開、跟文章深度無關——深度文章的「難」該來自論證複雜度、主線名詞裸奔只是斷路。讀者為了主線概念跳出去讀卡、回來時論證已斷線。
2. 「支撐 × 基線外 × 無卡」就是缺卡的精確定義——這是「需要抽出來成為知識卡」的判定條件、取代「感覺這個詞需要解釋」。
3. 難度曲線的真身：文章越深、越多術語落在基線內、行內解釋自然遞減；連卡是為空降讀者保留的回路、不遞減。

同篇密度控制

同一術語在一篇文章內第一次出現時連卡、後續裸用。背景 × 基線內可裸用的設計也是密度控制的一部分——判定矩陣本身防止「每句三個連結」的視覺噪音。

SOLID 對應

D 的對應值得展開：一篇文章裸用「非控制權益」、等於它依賴一個沒有住址的知識——讀者卡住時沒有官方回路、只能離開文章去搜尋（可能找到口徑不一致的解釋）。連卡把這個依賴變成宣告過的邊：文章 → 卡、卡不依賴文章、卡的內容更新時所有引用文章自動受益。

反向驗證

全連卡會不會更簡單？（取消矩陣、所有術語一律連卡）——主線術語只連卡會斷論證線（推論一）、背景 × 基線內連卡是純噪音。矩陣的存在理由是這兩端、中間段（支撐術語）確實預設連卡。

基線宣告會不會擋掉空降讀者？——基線管的是行內解釋量、連卡管空降可達性、兩個機制獨立。空降讀者落在深度篇、遇到基線內術語仍有卡片回路（前置篇章教過的主線術語本身就該有卡）。

「最不熟悉的讀者」建卡判準跟基線會不會矛盾？——建卡判準（常識是相對於讀者背景的：目標讀者群裡最不熟悉的那端能不能理解）決定卡該不該存在、基線決定文章對卡的引用形式。兩者作用在不同層：卡的存在服務整個讀者群的最弱端、文章的處理級別服務該篇的定位。矩陣讓兩者相容：基線內術語仍然有卡（服務空降）、只是文章端可以裸用。

實測：financial-analysis 模組掃描

對 content/business/financial-analysis/（40 篇）掃描高頻財會術語、比對 knowledge-cards/（55 張）的覆蓋：

掃描揭露的模式：方法論長文存在、原子卡缺席。「關係人交易」有整篇長文深入分析、文章引用時連到長文——依賴有宣告（比裸用好）、但讀者只想要 30 秒定義時被丟進一篇 200 行的文章。修法是建原子卡、卡內連長文作深讀路徑——卡答「這是什麼」、長文答「怎麼判讀」。

單篇 demo：八方雲集案例分析

用判定矩陣對一篇實際文章逐術語判定（該文位於價值鏈追溯路線第四篇、基線含報表識讀路線的三率詞彙）：

矩陣在這篇抓到兩個裸用違規（P/E、配息率）跟三個「連長文改連卡」的升級點——判定可重算、每個結論都能從兩軸推出、驗證了定義的可操作性。

執行流程

新文章寫作時（生成端）：讀者定位聲明步驟加一項——確認本文在讀者路線中的位置、寫下基線範圍；初稿完成後跑一輪術語 pass、對每個專業術語走矩陣、缺卡先建卡再交稿。

存量模組 audit 時：

1. 詞頻掃描（grep 術語清單、按篇數排序）比對卡片目錄 → 缺卡清單
2. 缺卡按「出現篇數 × 支撐角色」排優先序、批次建卡（建卡規範照 AGENTS.md 知識卡片規範：一卡一語意、情境精確命名、鄰卡連結）
3. 新卡登記進卡片目錄 _index.md 的分類表——索引是必經註冊點、不是選配。第一批實跑（financial-analysis 8 張卡）時發現 7 張既有卡從未進索引：卡片正常運作、文章連得到、只有目錄層讀者看不見它們——登記漏了不產生任何錯誤訊號、所以要寫進流程而非依賴記憶
4. 卡建成後回填連結——每篇文章該術語第一次出現處連卡；回填是本流程工作量最大的一步（一個術語可能散在十多篇）、先用 grep 定位各篇第一次出現、逐處判斷角色再連
5. 主線術語檢查：各篇的核心機制詞是否行內展開（矩陣推論一）

邊界

方法論適用於「有知識卡系統的教學型內容」。缺卡片基礎設施的體系（單篇部落格、無互連的文件）只剩行內 / 裸用二選、矩陣退化成「基線外就行內解釋」。基線的操作化依賴讀者路線表——模組還沒有路線表時、先補路線表（或至少模組讀者定位聲明）、再談基線。work-log 型的事件記錄以自己看懂為準、不適用本矩陣。