今天遇到的問題

這個系列不是從零寫完整股票資料平台。我們接手既有 stock-analysis-lab，把研究筆記與 Claude Code 工作流程加上去。但 README 的描述不能直接當成驗收結果。

一個核心概念：程式存在與資料可用是兩回事

provider 描述資料怎麼取得；CLI 是操作入口；checkpoint 保存進度；報告是執行後產物。它們分別能證明不同的事。

本次教材規劃時，實際讀到引擎以 240 日視窗取得價量，股票池還有篩選條件。讀者拿到不同版本，必須再查一次。

實作：只讀探索資料流

先將作者提供的乾淨引擎版本放在工作台相鄰目錄。不要帶入作者 .env、webhook、快取或私人筆記。下載位址尚未準備前，這一步屬於教材發布阻塞，不能請讀者自行猜網址。

請閱讀相鄰 stock-analysis-lab 的 README、config、
cli、data_sources 和 batch_refresh 相關程式。
只讀探索；不要執行批次、修改原引擎或讀取 .env。
回答：
1. report 與 refresh-finmind-batch 的入口。
2. provider、快取與輸出目錄如何設定。
3. targets 如何產生，有哪些排除條件。
4. 價格查詢的實際起訖期間。
5. complete、insufficient、failed、completed 各代表什麼。
引用檔名與具體程式位置，指出 README 和程式的差異。

將核對後結果保存為 docs/engine-audit.md。記錄引擎 commit；沒有 Git 時記錄版本來源與檔案 hash。

一個失敗案例

看到 targets 有一千多檔，就寫「全市場完整」。實際上有些標的被排除，且資料期間有限。用官方股票集合比對與歷史起訖日期驗證，不能只看總數。

當日驗收

• [ ] 能指出從 CLI 到 provider 再到報告的實際流程。
• [ ] 寫出兩項既有引擎尚未證明的能力。
• [ ] 今日沒有觸發批次或改動生產快取。

實測後補：一段實際程式證據，以及它如何改變原先假設。

下一天預告

明天建立工作台自己的 SQLite，保存研究紀錄。