今天遇到的問題

一份流暢的報告，可能混在一起放了來源數字、程式算出的值和 AI 的解釋。我希望讀者不只讀懂結論，也能回頭核對。

一個核心概念：資料的來歷

行情日期、抓取時間、報告時間不一定相同。星期日抓到星期五的收盤，不能把它標成星期日行情。官方資料端點與可用欄位要先看文件與實際回應。TWSE OpenAPI

實作：先完成一檔的真實報告

先依 docs/engine-audit.md 檢查可用的單股官方行情介面。
實作 research report --symbol 2330，重用引擎 provider。
所有快取和引擎輸出導向工作台 .local，不寫原專案。
報告加入已有筆記、實際行情日期、取得時間、來源、
可用數值、觀察、風險與缺口；今天尚未算的指標保留未提供。
產出 Markdown、HTML、歷史版本與 SQLite 索引。
HTML 轉義文字；輸出失敗不能覆寫上一份完整報告。
缺行情時退出失敗，不能改用 demo；其他缺欄保留原因。
只做一檔，不執行全市場 scan。

PowerShell：

.\.venv\Scripts\research.exe report --symbol 2330
Get-Content .\reports\2330.md

自行用瀏覽器開啟 reports/2330.html，核對兩種格式的日期與數字。若來源回應失敗，保存錯誤與診斷；本日狀態記為阻塞，不能換假資料當實測成功。

一個失敗案例

報告把缺少的本益比顯示為 0。請檢查是否把 null 經過預設值處理變成 0；「沒有值」和數字零是不同狀態。

當日驗收

• [ ] Markdown／HTML 的數字與日期一致。
• [ ] 至少抽查一個數字，能找到來源與欄位。
• [ ] 原有研究假設保留，未被 AI 改成結論。

實測後補：實際資料日期、來源、一次人工核對與輸出截圖。不是整份內容都由 AI 宣稱正確。

下一天預告

明天加入指標，先用固定小序列驗算，再放進真實報告。