# hk-stock-morning-report 版本更新日誌

> 記錄每一次迭代變化。訪問者可在 [clawhub.com](https://clawhub.ai/skills/hk-stock-morning-report) 查看完整版本歷史。

---

## 📋 版本更新日誌

### 🆕 v1.2.7 — 2026-04-28
**新增發送前二次核查清單（8項），cron job核查步驟已更新**
- SKILL.md：新增規則5「發送前二次核查清單」
- stock_report_job_steps.md：第八步覆核環節新增完整核查清單，27項檢查完成後方可發送

### 🆕 v1.2.6 — 2026-04-28
**新增規則4：數據內部溯源**
- 每個引用數字必須記錄來源URL和時間戳，存在工作記憶中備查
- 報告本身保持乾淨，不展示時間戳

### 🆕 v1.2.5 — 2026-04-28
**修正規則3：澄清早上數據口徑**
- 規則3修正為：早上8點只可用上一個交易日收盤數據，今天收盤數據不可用

### 🆕 v1.2.4 — 2026-04-28
**三大致命錯誤接連犯下，發布緊急更新**
- **錯誤1（致命）：自作主張以為4/27是佛誕假期** → 實際2026年佛誕是5月25日，4/27是正常交易日。首當日根據不准確的假日假設編造「休市無交易」錯誤內容
- **錯誤2（致命）：第三部分恒指數據虛假** → 引用的Yahoo文章時間戳「08:39」，實際是4月28日晚收盤後（19:39/20:39）上傳的收盤數據，不是早上可用的數據。早上8點港股根本還沒開盤
- **錯誤3：第三部分搜索關鍵詞未加「年月日」** → 搜索 `港股 4月28日` 導致搜索引擎返回舊聞
- **固化規則**：`第三部分搜索關鍵詞必須含「YYYY年MM月DD日」`；`第一部分必須先確認當日是否交易日，不準猜測假日`
- 第四部分：曦智科技(01879.HK)暗盤數據屬盤後數據，可在復市前報道的IPO消息，但需標明「暗盤」
- SKILL.md 已新增這三條規則

### 🆕 v1.2.3 — 2026-04-27
**全域段落空行規則（錯誤9變體）**
- 問題：今早晨報（4月27日）所有段落之間都缺空行，不只是▶️與摘要
- 原因：之前只重點防範▶️與摘要之間（錯誤9），忽略了大標題↔免責聲明、📍N↔正文、資料來源↔版權聲明等位置
- 修正：所有邏輯塊之間都必須用 `\n\n`（雙換行）產生空行
- ERRORS.md 已新增錯誤9變體說明

### 🆕 v1.2.2 — 2026-04-25
**修正方向錯誤：港字應移除而非補回** 🔴緊急修復
- 用戶明確要求「不要港字」，要的是「昨日股市回顧」而非「昨日港股回顧」
- 上次 v1.2.1 搞反了方向，把「港」加回去而非移除
- 修正：全部文件統一為「昨日/週X/上週X股市回顧」（無港）

### 🆕 v1.2.1 — 2026-04-25
**全面修補「港」字缺失錯誤** 🔴緊急修復（已撤銷）
- 問題：所有相關文件（JS/Python/SKILL.md/模板）中「昨日股巿回顧」均少了一個「港」字
- 根源：上次修正只改了記憶文件，未同步到底層代碼
- 修補：stock_report.js、generate_report.py、stock_report_job_steps.md、stock_report_format.md 等全部文件統一補上「港」字（方向錯誤，已廢棄）

### 🆕 v1.2.0 — 2026-04-24
**固化方法論：確認正確晨報輸出流程** ❗重要更新
- 第一部分搜索原則：使用格隆匯收評+騰訊財經API
- 第三部分實時搜索原則：搜索當天日期（即使港股休市也有宏觀/政策/大行消息）
- 發布時SKILL.md版本號失誤（漏改為1.2.0），實際內容已是1.2.0

### 🆕 v1.1.4 — 2026-04-24
**飛書卡片支援文字複製，取消代碼塊** ❗重要更新
- 背景：飛書卡片已支援文字選取複製功能
- 變更：晨報推送取消代碼塊，只發卡片
- 同步：MEMORY.md 飛書推送格式規則更新

### 🆕 v1.1.3 — 2026-04-23
**移除南下資金「成交」字段** ❗重要更新
- 問題：SKILL.md 格式示例仍含有「成交OOO億（港元）」，與用戶需求不符
- 修正：SKILL.md 南下資金標準格式移除「成交」字段，只保留「凈買入XX億（港元）」
- 強調：只顯示凈買入/凈賣出，不顯示成交金額

### 🆕 v1.1.2 — 2026-04-23
**作風調整**：日後遇到不明確環節，主動先向用戶確認再做，不再自行猜測

### 🆕 v1.1.1 — 2026-04-23
**新增 CHANGELOG.md 版本歷史文件**，記錄 v1.0.0 至 v1.1.0 完整迭代
- 包含：每次版本更新內容、核心教訓、版本對照表
- 訪問者可在 clawhub.com 發布頁查看完整迭代歷程

### 🐛 v1.0.8 — 2026-04-23
**修正格式錯誤** ❗重要更新
- 問題：輸出包含了「成交 1256.56億」，但用戶只要求「凈買入/賣出」金額
- 修正：移除「成交」字段，只保留「凈買入XXX億（港元）」
- 同步更新：fetch_southbound_data.py 腳本 + SKILL.md

### ⚙️ v1.0.7 — 2026-04-23
**固化 agent 三步流程** ❗重要更新
- 流程：tavily 搜索 → 確認口徑 → 寫入 JSON → 運行格式化腳本
- 修復：dict 比對 bug（計算 net_buy minus net_sell）
- 同步：stcn.com 全市場口徑 vs 成交活躍股口徑區分寫入 SKILL.md

### 🔧 v1.0.6 — 2026-04-23
**從規則升級到工具**
- 新增：fetch_southbound_data.py（格式化輸出腳本）
- 新增：southbound_report_template.md（完整模板 + 核查清單）
- 意義：從「文字規則」升級為「自動化工具」，減少主觀判斷

### 📝 v1.0.5 — 2026-04-22
**錯誤教訓固化** ❗重要更新
- 新增：南下資金口徑規則（stcn.com 全市場 ≠ 成交活躍股，兩者差 4 倍）
- 新增：三驗原則（口徑 + 日期 + 來源，每次用數字前必須確認）
- 新增：歷史版本優先原則（用戶說某版本有數據，先查再使用）
- 修正：勝宏科技代碼 02476.HK（之前錯為 03839.HK）

### 🔵 v1.0.0-v1.0.4
**初期框架建設**
- v1.0.0：4 部分晨報結構（市場回顧 → 南下資金 → 熱點資訊 → 熱門港股）
- v1.0.1：Tushare 停用，熱點搜索改為當天日期
- v1.0.2：新增虛擬資產 ETF 每日 9:00 監控任務（13 隻 ETF 清單）
- v1.0.3：格式固化，飛書卡片 + 代碼塊雙版本推送
- v1.0.4：錯誤檢討口號階段（香港假日 gov.hk 規則）

---

## 📊 核心教訓

| 教訓 | 發生版本 | 影響 |
|------|---------|------|
| 數據口徑必須區分 | v1.0.5 | 全市場213.60億 vs 成交活躍股48.90億，差4倍 |
| 成交金額 ≠ 凈買入 | v1.0.8 | 成交1256.56億 vs 凈買入213.60億 |
| 勝宏科技代碼不可猜測 | v1.0.5 | 02476.HK（對）vs 03839.HK（錯）|
| 大標題日期 ≠ 交易日期 | v1.0.5 | 大標題=報告生成日；第一部分=上一交易日 |
| ▶️標題和摘要之間必須空一行 | v1.0.4 | 連續3次錯誤（錯誤9，最高頻）|
| 飛書卡片支援文字複製 | v1.1.4 | 取消代碼塊，只發卡片即可 |
