# Taiwan ETF Lookthrough 版本紀錄 ## 資料包更新規則（2026-11-02） 純快照刷新保留程式版號，另外標示打包日期與資料包 ID；每檔實際持股日照原值。同日相同資料不重複提交，功能、解析器、計算規則或操作介面有實質變動才換程式版本。早期 v1.7.1 的資料刷新紀錄保留，後續改依本規則處理。 ## v1.7.4 — 2026-11-05 - 修正 00903 的每日資料解析，支援已核對的港幣、台幣與美元證券交割餘額，保留原幣金額與正負號；未知的 NAV 與曝險權重不補為零。 - 未知幣別、重複列、非有限數值與必要資產缺漏仍會拒絕；歷史資料規則與其他 ETF 的幣別範圍不變。 - 涵蓋清單列出收錄商品與持股日；檔案校驗另供查核。沿用 2026-11-04 資料包，各檔持股日與內容維持原值。 ## v1.7.3 — 2026-11-04 - 台新日期格式：原生日期的月、日不補零（例如 2026/11/3）也能讀取；仍驗證有效日曆與兩個各自標示的 NAV 日期。 - 00731「其他資產」小計：可採已逐列驗證的四捨五入百分比精確和，每列誤差上限為 0.005 個百分點。同日匯出、金額與整基金 NAV 對帳仍須通過；帳面權重維持金額／NAV。 - 診斷：凱基缺少 NAV 與未支援資產分類分開報錯。請求前已耗盡資源，或本次回應讓累計資料量跨過上限時，均列出限制名稱與實際計數；沿用 100 次請求、80 MiB、240 秒上限。 - 沿用 2026-11-03 資料包與各 ETF 原持股日。本次為離線解析驗證，當期來源仍依實際取得與對帳結果判定。 ## v1.7.2 — 2026-11-03 - 00920 每日解析：可辨識 8 種已觀察到的幣別證券交割餘額標籤。 - 00905 解析：可辨識申贖應付款分類。 - 上述兩項均依來源記錄金額與正負號；NAV 權重未知，不補為 0。 - 00936 解析：三處日期改以有效日曆日期核對，月、日不需補零。 - 本版修正解析器，資料包與各檔持股日維持原值。 ## v1.7.1 — 2026-11-02 - 內建快照更新至 2026-11-02，72 檔；各檔持股日與內容雜湊見內建索引。 - 保留原始來源、日期、權重與未知值；下載後不會自行更新。 ## v1.7.0 — 2026-11-02 - 一般計算改讀套件內建快照，不再下載網站 JSON；不需 GCS 帳號即可離線使用。 - 內建快照由私人 GCS 封存還原，驗證日期、商品與內容雜湊，保留原始來源、權重、取得時間及未知值。 - 缺漏或過期時由 agent 查官方來源；取得失敗可使用附原日期與過期天數警告的舊快照，再退至固定研究與歷史比例。 - 新增手動打包流程：從 GCS 匯出後開 PR，審閱合併並發布新版才更新下載包；本機副本不會自行刷新。 ## v1.6.1 — 2026-11-02 安聯每日持股名稱驗證 - 00984A、00993A 的解析與每日檢查共用既有的台灣證券身分規則；公司全名或簡稱均保留原樣，權重不變。 - 未知代碼、境外證券標記與指向另一家公司的名稱仍會被拒絕；取得或解析失敗時，仍停止同投信後續抓取。 ## v1.6.0 — 2026-11-02 原始資料與不可變收據 - `publish --raw-dir` 保存解析前的原始 bytes 與逐檔取得結果。 - 收據以持股日與內容雜湊綁定本次解析；相同內容仍保留原快照時間。 - 未指定此選項時沿用原本發布行為。 ## v1.5.5 — 2026-11-02 四檔每日官方來源 - 00984A、00993A、00903、00920 通過 Actions 來源及正式 publisher 暫存發布驗收，接入每日抓取。 - 公開快照仍為 96 檔（88 檔每日來源、8 檔固定研究）。 - 沿用官方持股日（2026-10-30）與原生股票權重。未知的非股票／期貨權重不補零。annotated 為 warn，strict 仍不通過。 - 未修改已凍結快照與歷史雜湊。 ## v1.5.4 — 2026-10-29 日期配對與備援修補 野村來源先確認 PCF 的實際估值日，再取得同日資產資料。下載不完整時保留 診斷與原有快照，不將部分檔案當成完整資料；來源遭拒的紀錄可跨 ETF 沿用， 避免同一路線重複請求。網站端 agent 同時保存原檔解封與停止原因；交易所 報價遭拒不會中止其他投信的備援。 00935 已以保存的官方原檔驗證逐股市場與股票清單完整性，保留原生 NAV 權重及未知差額警示；維持 official_only，尚未啟用每日抓取或新增公開快照。 本版沒有新增正式持股資料，不代表即時來源已恢復或取得率已提高。 ## v1.5.3 — 2026-10-29 Nomura 逐股曝險來源（待發布） 00944／00980A 接入相同 GetFundAssets＋GetFundTradeInfo 契約，日期採實際 NAV 日、 原生股票權重不縮放。名稱簡稱與未解非股票殘差保留警示，不要求完整會計調節； 身分、日期、分母、市場、完整陣列與數值檢查仍保留。來源拒絕／解析失敗保留舊快照。 00935 維持原備援路線；00731 警示不變。納入與部署驗收狀態見第五輪研究紀錄。 ## v1.5.2 — 2026-10-29 00731 固定官方 API 00731 每日抓取改讀復華公開 assets API 與同日 XLSX，從前一日開始最多回查三個 日曆日；只有明確空回應才回查。日期、身分、資料不完整、未知市場、403 或 TLS 失敗停止來源並保留舊快照。原生逐股 NAV 百分比不縮放、不再額外估價；官方總表 比例的小幅差異保留為 quality_notes，金額總表與明細仍須完全相符。 本版不增加支援商品數。runner 原檔／驗證及部署狀態見 docs/etf-discovery 的第二輪紀錄。 ## 2026-10-29 文件重整 精簡 SKILL.md，集中現行規則與觸發情境；版本沿革移至本檔，固定示範詳情留在 demo/README.md，涵蓋範圍以 references/snapshot-coverage.md 為入口。計算版本維持 v1.5.1，沒有變更程式、來源資料或固定示範產物。 ### 現行規則移轉對照 | 原版本段落中的規則 | 現行位置 | | --- | --- | | 部分快照繼續查詢、同級先比完整度、下載失敗保留可用列 | SKILL.md「資料來源優先順序」 | | annotated 輸入、逐列容錯、strict 相容、五種品質等級 | SKILL.md「工作方式」、references/estimation-first.md | | 台北日期、預告附註、同日快照與重複證券 | SKILL.md「不可違反的規則」、references/estimation-first.md | | 歷史比例獨立摘要、不進個股等指標、不抵減未穿透 | SKILL.md「資料來源優先順序」、references/estimation-first.md | | 不補零／重分配／放大、未知市場、完整名單才可判零 | SKILL.md「不可違反的規則」、references/mixed-etfs.md | | 原生 parser 診斷、同日報價與 NAV、原生權重優先 | references/estimation-first.md | | 官方身分／日期／單位／數值檢查、403 與 TLS 邊界 | SKILL.md「不可違反的規則」 | | 主動官方備援、adapter、取得預算與停止條件 | SKILL.md「工作方式」、references/official-fallback.md | | modern 代碼衍生、非股票未知權重、混合資料分桶 | references/data-sources.md、references/mixed-etfs.md | | 固定示範授權、未知期貨、殘差、不冒充新平台驗收 | demo/README.md | 六句固定限制與最小離線範例原文保留；數字只能來自生成的 `result.json`。 ## 歷史發布說明（原文保留） 以下檔數、排程與驗收描述只代表各版發布時的狀態，不是當期規則。使用時以 [SKILL.md](SKILL.md) 及其現行資料合約為準；本檔不需在一般計算前載入。 v1.5.1 修正部分本機快照阻止來源升級：前十大、缺權重或不完整名單仍查詢 PyInvest， 同一時效等級優先選較完整資料，同日亦可替換。下載失敗保留可用列並明列原因； HTTP 403 是存取失敗，不能當成 CA 問題，也不得停用 TLS 驗證。 v1.5.1：錯誤只影響所在的列或來源。預設 annotated 接受字串金額、略過零市值、 完整保留現金與非台股資產分母。預告持股日不限天數但附註，採台北日期； 同日快照採最新抓取，官方表格可逐列容錯及搜尋其他工作表，支援 CSV／XLSX／XLS。 來源依當期 → 過期 → 固定研究 → 歷史比例退階；五種資料等級列在報告開頭。 歷史總比例估算進摘要的「已辨識＋歷史比例估算涵蓋率」，與已辨識股票分開， 不進公司／產業／集中度／重疊，也不抵減全額未穿透。名錄外股票另列暫列金額。 strict 模式保留既有輸入、驗證、衝突拒絕及輸出欄位。 詳見 [v1.5.1 行為與資料合約](references/estimation-first.md)。 v1.4.0 將原有 36 檔研究商品接入每日官方更新，另加入 **00878**， 合計 **77 檔自動更新候選**。原始研究快照仍保留在套件內作離線／取不到新資料時的備援； 它們自己的持股日不會被更新時間覆寫。最新公開狀態見 [快照清單](references/snapshot-coverage.md)。 計算與每日發布都採「能算先算、限制標注」：部分持股、舊資料、缺權重、 總額或四捨五入差異不再整檔拒絕；只計已知列，不補零、不重分配、不放大。 新增股票若市場尚未確認，保留未知；只有完整市場名單才能確認指定日零台股。 官方來源、HTTPS/TLS、商品身分、實際日期、單位、NaN／Inf等 仍需正確。重複證券及預告日期在 annotated 模式附註處理。`validation_policy="strict"` 保留給需要嚴格比較的使用者。 原生 parser 的非致命對帳差異由 `source_quality.parse_annotated` 保留為 `quality_notes`；直接呼叫 parser 仍可作嚴格診斷。 新增路線共用同日官方收盤價；有官網原生 NAV 權重者直接使用，避免額外下載。 無同日報價或基金 NAV 的列保留未知；不拿今天的價格乘舊股數。 06:30 排程仍只更新私有資料，17:00 隨既有影片／資料流程部署；網站更新依賴本機可用。 本機單輪成功不等於遠端 runner 或多日穩定驗證。 v1.3.0 的 36 檔固定研究與 66 檔歷史總比例參考仍可用；009828 仍只有 2026-09-30 總比例參考，不能拆成公司曝險、不能抵減未穿透金額；v1.5.1 另計歷史比例估算桶。 沒有合適快照時，**agent 主動查安全官方來源**，先提供能取得的部分結果與限制。 詳見 [研究資料與註記模式](references/research-and-annotations.md)。 以下 v1.0～1.3 紀錄保留原範圍與驗收歷史，現行名單以上述 v1.4.0 為準。 v1.2.1 修正聯博期貨欄位精度、元大應付申購預收款及台新顯示四捨五入 對帳；排程只發布合格候選，來源失敗保留舊快照並在提交後告警。 該版尚未加入 v1.3.0 的使用者註記計算模式。 v1.2.0 新增 00982T、00981T、00735、00980T 的混合／跨市場 ETF 台股現貨分析。2026-10-27 本機一輪官方 HTTPS 取得四檔全部通過， 公開快照共 40 檔；registry 共 49 檔（40 HTTP＋9 official_only）， 另有 6 檔代表商品走 registry 外官方備援，含仍缺實際持倉的 009828。 股票顯示權重與基金聚合比率分開保留；海外股票另列，低台股配置不代表 資料不完整，已確認零值與未取得資料分開。混合快照採 schema 2， 需 v1.2.0 以上套件；舊 schema 1 與固定示範原始檔保留。 請先讀[混合型資料合約與使用方法](references/mixed-etfs.md)， 並以[快照清單](references/snapshot-coverage.md)核對實際日期與狀態。 每日新增四檔使用同一驗證器；單次成功不代表整批 Actions 或多日穩定性。 v1.1.0 歷史基底：原四家33檔之外新增12個代表商品adapter；2026-10-27對歷史樣本 合格的10檔做唯一一輪官方HTTPS實跑，8檔 通過：復華00929、富蘭克林華美00905、台新00936、兆豐00932、玉山009803、 第一金00728、摩根00401A、聯博00404A。永豐00888與野村00935的當次資產／ NAV／PCF日期不符，停用排程並保留 agent 官方備援；凱基00915與聯邦009804 亦由 agent 走官方備援，資格缺口仍須補證。發布名單合計45檔：36檔HTTP、 9檔 `official_only`（原國泰5＋上述4）。原五家（中信、統一、大華銀、安聯、 華南永昌）仍保留 agent 官方備援，未列自動registry。完整的36檔公開快照與 14檔官方備援見[快照清單](references/snapshot-coverage.md)。06:30資料工作 使用同一registry；17:00隨既有影片／資料自動化建置與部署。本機單次實跑 不代表新的完整Actions批次已驗收、排程穩定或整家投信全商品支援。 已知取得方法、離線 parser 範例及各家入口見 [官方來源與 agent 備援](references/official-fallback.md)。 已發布基底 v1.0.0 的歷史範圍為 2026-10-25 已觀察的四家投信 33 檔 eligible 名錄（含 0052、00405A、0050，完整名單見 references/data-sources.md），不是當期全市場名錄：富邦 11＋元大 10＋群益 7，共 28 檔 HTTP 自動候選；國泰 5 檔為 official_only 官網備援，不排程發布這五檔。國泰 legacy 00878／00400A 與 modern 五份公開 DOM 的離線 adapter 可處理已核對官方來源；modern 股票代碼為明示衍生，沒有總 NAV 的非股票權重保留未知。原 28 檔 HTTP 的私有資料管線已通過一次 Actions 驗收，不保證每日穩定性；每日 06:30 台北排程已定案，投信更新窗口尚未確認。已發布基底的公開 GitHub 與本站下載內容曾核對一致，本版同步發布新增來源，使用時仍須核對索引與實際持股日。套件內附使用者核准的固定示範特例：原五檔共同日2026-10-22，00878只隨固定demo；daily五Cathay仍official_only，固定示範與每日來源分開處理。不得把合成案例當成真實持股或當期資料。 ## 2026-10-28 涵蓋紀錄（歷史文件） 下文為當時保存的涵蓋紀錄；現行數量與日期以下載包的 snapshot-coverage.md 及公開資料頁為準。 2026-10-28 本機資料與程式名單：77 檔接入每日官方更新，8 檔索引內官方備援；另有6檔代表商品備援。 原40檔＋研究商品36檔＋國泰00878。新增37檔已完成一輪本機官方取得與註記驗證，遠端排程須以實跑紀錄確認。 這些是個別商品，不能外推整家投信。日期以公開 index 與各快照為準。 | 投信 | 自動更新商品及本次持股日 | | --- | --- | | ab | 00404A（2026-10-27） | | capital | 00415A（2026-10-27）、00919（2026-10-27）、00923（2026-10-27）、00927（2026-10-27）、00946（2026-10-27）、00982A（2026-10-27）、00992A（2026-10-27） | | cathay | 00735（2026-10-27）、00736（2026-10-27）、00737（2026-10-27）、00878（2026-10-27）、00893（2026-10-27）、00898（2026-10-27）、00909（2026-10-27）、00916（2026-10-27） | | esun | 009803（2026-10-27） | | fhtrust | 00409A（2026-10-21）、00731（2026-10-22）、00929（2026-10-22）、00991A（2026-10-22）、00998A（2026-10-21） | | fsitc | 00728（2026-10-27） | | ftft | 00905（2026-10-27）、00961（2026-10-27） | | fubon | 00405A（2026-10-27）、0052（2026-10-27）、0057（2026-10-27）、006208（2026-10-27）、00692（2026-10-27）、00730（2026-10-27）、00733（2026-10-27）、00892（2026-10-27）、00900（2026-10-27）、009802（2026-10-27）、009809（2026-10-27） | | jpmorgan | 00401A（2026-10-27）、00989A（2026-10-27） | | kgi | 00407A（2026-10-27）、00926（2026-10-27）、00938（2026-10-28）、00952（2026-10-27）、00980T（2026-10-27）、009816（2026-10-27）、00981T（2026-10-27） | | mega | 00913（2026-10-27）、00921（2026-10-28）、00932（2026-10-22）、00943（2026-10-27）、00982T（2026-10-22）、00996A（2026-10-27） | | sinopac | 00410A（2026-10-27）、006204（2026-10-27）、00901（2026-10-27）、00907（2026-10-27）、00930（2026-10-27） | | tsit | 00703（2026-10-27）、00851（2026-10-27）、00904（2026-10-27）、00936（2026-10-27）、00947（2026-10-27）、00962（2026-10-27）、009806（2026-10-27）、009807（2026-10-27）、00986A（2026-10-27）、00987A（2026-10-27） | | union | 009825（2026-10-22） | | yuanta | 0050（2026-10-27）、0051（2026-10-27）、0053（2026-10-27）、0055（2026-10-27）、0056（2026-10-27）、006201（2026-10-27）、006203（2026-10-27）、00713（2026-10-27）、00850（2026-10-27）、00940（2026-10-27） | ## 尚無公開快照 索引內：00400A、00701、00881、00888、00915、00922、00935、009804。 索引外代表商品：00891、00939、00918、00984A、009808、009828；仍走 agent 官方備援（各檔確切入口見 official-fallback.md）。 ## 更新與品質 每日更新。 自動更新表示每日嘗試取得，不保證投信當天揭露、來源永遠可連線或持股日每天前進。 來源失敗保留舊快照與日期；部分持股、估值缺漏、舊資料與對帳差異照算可用列並標注。 00893、00916 本次有新海外證券尚未完成市場核對，已保留未知並標為部分估計；不是完整零台股證據。 原36檔研究副本仍隨套件提供作離線備援，屬歷史固定資料；不可將這些副本的日期視為每日更新。