docs: 新增 TaiwanStockMarginMaintenance（個股融資維持率）中英雙語文件

[linsamtw]

摘要

新增 sponsor 等級資料集 個股融資維持率 TaiwanStockMarginMaintenance 的中英雙語文件。

• 資料區間：2001-01-05 ~ now（上櫃自 2007-01-04 起）
• 付費等級：sponsor only（backer 不可用），heading 標註沿用
  TaiwanStockLoanCollateralBalance / TaiwanStockIndustryChainMoneyFlow 的
  「(只限 sponsor 會員使用)」寫法
• 欄位：date、stock_id、margin_balance、margin_cost、margin_ratio、margin_maintenance

修改檔案

檔案	內容
docs/tutor/TaiwanMarket/Chip.md	總數 25 → 26；清單新增連結；檔尾新增資料集章節 + ??? note 四點說明 + 範例
docs/tutor/TaiwanMarket/Chip.en.md	總數 25 → 26；同上英文版
docs/tutor/TaiwanMarket/DataList.md	總數 90 → 91；Chip 清單新增連結
docs/tutor/TaiwanMarket/DataList.en.md	總數 90 → 91；Chip 清單新增連結
docs/WhatIsNew.md / .en.md	2026-08-03 新增一則（只寫資料區間，未寫更新頻率）
docs/llms-full.txt	Chip 區塊 23 → 24；新增 dataset 區塊（Tier / Data range / Update / Params / Columns / Notes），純文字
docs/llms.txt	Chip 分類清單加入 dataset 名

文件必要註記（以 ??? note 摺疊區塊呈現）

1. 本資料集為估算指標：公開資訊只揭露個股融資餘額「張數」、未揭露個股層級的「融資金額」，無官方真值可對；各家服務同樣各自估算，數字不會一致。
2. 融資成數採法定上限：上市六成；上櫃 2014-11-10 起六成、之前五成。警示股／處置股實際成數可能較低。
3. 上櫃起始日與上市不同：上市 2001-01-05、上櫃 2007-01-04。
4. 成本線為名目值：已調整股數事件（分割／面額變更／減資／配股）並於除息日扣除現金股利。

錨點驗證

以 markdown.extensions.toc.slugify 實測，並與 repo 內既有同型標題交叉比對：

• 中文（標題含 ASCII 資料集名）：#taiwanstockmarginmaintenance-sponsor
  （對照 台股產業鏈資金流向 TaiwanStockIndustryChainMoneyFlow (…) →
  #taiwanstockindustrychainmoneyflow-sponsor，與現行連結一致）
• 英文（完整標題 slug）：
  #individual-stock-margin-maintenance-taiwanstockmarginmaintenance-only-available-for-sponsor-members
  （對照 Industry Chain Money Flow … → #industry-chain-money-flow-…-only-available-for-sponsor-members）

Chip / DataList 中英四份清單的連結皆使用上述同一錨點。

備註

• docs/llms-full.txt 的 Chip 區塊標題原本寫 23 datasets，但區塊內實際有 24 個
  ### 條目（既有落差）。本 PR 僅將其 +1 為 24，未一併修正該落差。

待其他 repo

本 PR 只動文件；資料集本身的實作、API 註冊與 SDK 方法（taiwan_stock_margin_maintenance）由其他 repo 的 MR 提供。

🤖 Generated with Claude Code

[linsamtw]

⚠️ Merge 前請注意：!!! output 的 DataFrame 範例是「構造值」，不是真實 API 輸出。

寫這段時 FinMind API / MCP 持續回 5xx，本機 .env 的 token 又已於 2026-08-02 輪替失效，無法取得真實資料。目前表格中：

• 2026-07-28 / 2330 這列的 close 2280 → margin_cost 2346.9 → margin_maintenance 161.92 來自 Spec §3.4 的 prototype 實測值
• 其餘 4 列（含所有 margin_balance 數值、以及 07-28 那列的 margin_balance）是為了讓 close / (margin_cost × margin_ratio) × 100 內部自洽而構造出來的，沒有對過真實資料

建議處置（擇一）：

1. 等 ddb11 建表 + backfill 完成、API 上線後，用真實輸出重新產生這張表再 merge
2. 或先 merge 其餘內容，另開一個 follow-up PR 只換這張表

另外附帶說明：docs/llms-full.txt 的 Chip 區塊計數在本 PR 之前就已經對不上（header 寫 23、實際 24 個 ### 項目）。本 PR 只做 +1（23 → 24），維持 repo 既有的「照著加一」慣例，沒有順手修既存偏差。同樣的偏差在 Chip.md / Chip.en.md 也存在（宣稱 26、清單實際 28 條連結）。要不要統一校正這幾個計數，建議另開單處理，不混進本 PR。