docs: CHANGELOG — mo_data + cash_log

CHANGELOG.md

@@ -231,6 +231,45 @@ cd /home/hmo/MoFin && python3 migrate_all.py
 
 - [ ] 明天开盘验证 price_monitor 正常更新 DB
 - [ ] 验证 `[PROFIT_PROTECT]` 标记取代 `[NEAR_SL]` 误报
-- [ ] DB 表新增了列，旧 `migrate_all.py` 可能需要重新跑一次
-- [ ] `refactor-for-xiaoxiao.md` 中的 Phase 2 待讨论
+- [ ] 如果启用 AlphaSift：`ALPHASIFT_ENABLED=true python3 mo_alphasift_bridge.py`
+
+---
+
+## 2026-07-01 (续) — 统一读取层 + 现金日志
+
+### mo_data.py — 统一数据读取层
+
+替代所有 `json.load(open(portfolio.json))` 等直接读 JSON 的方式。
+
+```
+mo_data.read_portfolio()   → 返回 portfolio.json 等价 dict（数据来自 DB）
+mo_data.read_decisions()   → 返回 decisions.json 等价 dict
+mo_data.read_watchlist()   → 返回 watchlist.json 等价 dict
+```
+
+- DB 优先，JSON 冷备（DB 不可用时自动 fallback）
+- 返回结构完全兼容旧代码，无需改调用方
+- 16 个文件已通过批量替换迁移
+
+### cash_log 表 — 现金变更追踪
+
+新表 `cash_log`，记录每次现金变动：
+
+| 字段 | 说明 |
+|------|------|
+| `cash_before/after` | 变更前后可用现金 |
+| `frozen_before/after` | 变更前后冻结资金 |
+| `change_amount` | 变动额（正=入金/卖股，负=出金/买股） |
+| `source` | 来源：screenshot / manual / import_xls / trade |
+| `note` | 备注 |
+| `verified` | 是否经 Dad 确认 |
+
+写入：`write_cash_log(conn, data)`
+查询：`query_cash_log(conn, limit=20)`
+
+### 待办（知微）
+
+- [ ] 明天开盘验证 price_monitor 正常更新 DB
+- [ ] 验证 `[PROFIT_PROTECT]` 标记取代 `[NEAR_SL]` 误报
+- [ ] cash_log 目前只是建表，需要在截图导入/手动改现金时调用 `write_cash_log` 记录变更
 - [ ] 如果启用 AlphaSift：`ALPHASIFT_ENABLED=true python3 mo_alphasift_bridge.py`