docs: 港股接入文档——SYSTEM_ARCHITECTURE加五.6节(市场抽象层/数据层/温区双市场/币种规范/现状边界)+CHANGELOG记阶段0-4变更

docs/SYSTEM_ARCHITECTURE.md

@@ -166,6 +166,49 @@ mofin_health(健康采集) → F健康 Dashboard（三层架构健康 + cron来
 | */30 盘中 | strategy_executor.py | 按激活策略调度选股 scanner |
 | 周五 17:00 | strategy_alert.py | 三振出局失效预警（滚动胜率/盈亏比） |
 
+## 五.6 港股接入（多市场支持，2026-08-14 落地）
+
+参照 A 股全链路接入港股（港股通范围）。设计原则：**不另起炉灶**——复用 A 股代码结构，市场差异点收敛到市场抽象层；**币种统一**——个股存原币（港股 HKD），计算/汇总统一转 CNY。
+
+### 市场抽象层（market_config.py，唯一事实源）
+
+所有市场判断/符号映射收敛于此，替代原先散落 6 处的各自实现：
+
+| 接口 | 作用 | 规则 |
+|------|------|------|
+| `market_for_code(code)` | 市场判断 | 5位0/1开头 → `hk`，6位 → `a`（委托 mo_models.is_hk_stock） |
+| `kline_symbol(code)` | 行情/K线符号 | `600519`→sh、`000001`→sz、`00700`→hk |
+| `MARKETS` dict | 市场配置 | index_code / currency / has_price_limit / trading_hours（港股含午休 12:00-13:00） |
+| `is_trading_now(market)` | 交易时段 | A股 9:30-11:30/13:00-15:00，港股 9:30-12:00/13:00-16:00 |
+| `get_regime_temp(code)` | 温区+温度溯源 | 按标的市场返回（A股=smoothed 顶层，港股=markets.hk） |
+
+### 数据层
+
+- **港股通名单**（hk_connect_list.py → hk_connect_stocks 表）：东财 MK0146 板块（push2delay 镜像，主 host push2 对 246 封禁），620 只标的，支持调入/调出检测，周级刷新。**港股通名单本身是数据层定期采集数据**（老莫定）
+- **股票池**：`get_stock_pool(market='a'|'hk'|'all')` 参数化（默认 'a' 行为不变；'hk'=港股通名单+港股持仓/自选）
+- **港股日K**：daily_kline_collector hk 批（腾讯 hk 前缀，入 stock_daily，与 A 股同表靠 code 长度区分）
+
+### 温区双市场
+
+- **market_regime 表**：(date, market) 联合主键，同日 A/港股各一条（迁移脚本 migrate_regime_market.py，4 表加 market 列+备份）
+- **温区判定**：compute_regime 按市场用对应指数（A股 sh000001 / 港股 hkHSI 恒生指数）
+- **温度/平滑/归因**：temp_band、regime_tracker、regime_perf 全部 market 参数化
+- **恒指历史**：hkHSI 回填 12 年（2014 起，3005 条日K + 2975 条温区）
+- **向后兼容**：market_regime_smoothed.json 顶层键= A 股（既有消费方 regime_gate/strategy_router 不受影响），markets dict 含双市场详情
+
+### 币种规范（v3 重申）
+
+- **个股一律存原币**：港股 price/cost/mv 存 HKD 原值，A 股存 CNY
+- **汇总统一折算**：市值/盈亏/总资产经 mo_models.to_cny/calc_total_mv 转 CNY
+- **价格比较用原值**：止损止盈/目标价与行情源（HKD）单位一致，不折算
+- **显示区分币种**：港股价格带 HKD/HK$ 标识
+
+### 现状与边界
+
+已落地：港股通名单采集、港股日K、温区双市场（A股 trend_down / 港股 trend_up 已验证相反）、温区感知买卖/重评、币种规范。
+**待落地**（依赖港股策略）：strategy_router 按市场激活、港股全市场选股（scanner 扫港股通池需先有港股策略）。
+**不做**：港股资金流/板块 enrichment（cninfo/sina 不支持港股）、TDX relay（已归档）。
+
 ## 六、开发原则（自动任务强约束）
 
 1. **单例守卫**：每个定时脚本必须 `_singleton_guard`（fcntl flock /tmp/mofin_locks/），防重复实例并发写（2026-08-05 进程堆积事故后统一加装）