v1.10.0

補上最後兩項「歷史深度」缺口：集保股權分散可看逐週趨勢、選擇權大額交易人可回溯區間。工具數不變（173），沒有移除或改名任何工具，既有呼叫不受影響。

新增能力

集保股權分散逐週趨勢（get_shareholding_distribution）

• 新增 weeks 參數（預設 1，最大 13）。weeks=1 與先前相同：最新一週的完整 17 級距表。
• weeks 2–13：逐週列出總人數、千張大戶／400張以上／10張以下散戶的持股比例與人數，以及較前一週的增減，可看出大戶是增持還是減持。
• 資料來源是集保結算所查詢頁。該頁沒有 CAPTCHA，但是有狀態的表單（單次有效、每次回應會換新的 token，且需要 cookie）；工具在同一個連線內接力傳遞 token。
• 已與開放資料逐列比對（2026-10-02；2330、6488、0050）：級距 1–15 與合計完全相同，只有「差異數調整」列不同，趨勢不使用該列。
• 已查過的週不會再變動，會快取在記憶體，重複查詢幾乎即時。
• 查0050+0056 3週範例

選擇權大額交易人未沖銷部位（get_large_traders_options_oi）

• 改由期交所網站下載頁提供，新增 start_date／end_date：預設最新交易日，也可回溯任意區間（最長一個月）。contract、call_put 篩選照舊。
• 取代原本只有最新一天的 openapi 來源；上線前已逐列比對確認內容相同，僅「全部月份」代碼不同（999999 對 999912）。
• 查詢範例

其他

• fetch_bytes 支援傳入 requests.Session（供需要 cookie 的流程使用，不走回應快取）。
• Contract test 瘦身：移除不屬於「上游介面」的斷言（我們自己的分頁、篩選邏輯由離線測試負責）。
• 文件：prompt 改指向新工具並修正過時參數（舊的 format=、count=）、移除過時的 UV 整合說明、更正 Actions 指南、README／CLAUDE.md 同步。

Full Changelog: v1.9.0...v1.10.0