trading: 日内T/长桥/六合彩文档与脚本 + quant-factor-mining 新目录

lottery-hk/references/agent-workflow-pitfalls.md

@@ -1,4 +1,4 @@
-# Agent Workflow Pitfalls (2026-07-30 实战累积, 2026-08-02 修正 Qi-2 与 no_agent 规则)
+# Agent Workflow Pitfalls (2026-07-30 实战累积, 2026-08-04 第 4 次修正)
 
 ## 用户硬偏好 (违反必踩坑)
 
@@ -23,7 +23,7 @@
 ### 4. **跑 X 框架不要自己造公式**
 用户原话: "记得我说过不要跑频率, 没有意义, 我要说什么你才能记住" / "我要 4 框架"
 - **"4 框架"** = reference 里的真实推演流程 (v_xg.json + 挂牌 + 红字), **不是** agent 写 河洛/梅花/玄空/奇门 公式
-- **"特码分析"** = sol.2344a.cc 挂牌 + 玄机 + 红字, **不混** v_xg.json Qi-2 期数据
+- **"特码分析"** = sol.2344a.cc 挂牌 + 玄机 + 红字, **不混** v_xg.json Qi-1 期数据
 - **流程**: 看到关键词 → 跑真脚本 (`lottery_4frame.py` / `lottery_特码.py`), 不要尝试自己推
 - **保留路径**: `python3 ~/.hermes/skills/trading/lottery-hk/scripts/lottery_4frame.py`
 - **保留路径**: `python3 ~/.hermes/skills/trading/lottery-hk/scripts/lottery_特码.py [期号]`
@@ -40,25 +40,45 @@
 - 任何时间字段 (挂牌/开奖/推送/cron schedule) 默认 UTC+8
 - cron schedule 是 UTC → 推送时**显式标注 "北京时间"**
 - agent 默认假设 UTC → 用户必纠正
+- **agent 默认时间不准** (system prompt 时间可能旧), 要实时用 `date` 命令确认
 
 ### 挂牌日 = 开彩日 (硬规则)
 - sol.2344a.cc 挂牌帖发布时间 = 实际开奖日, **同一天**
 - **错** (旧 SKILL.md 描述): "挂牌提前 2-3 天"
 - **对** (用户 2026-07-30 实战确认): 挂牌日 = 开彩日, 同天
 
-### v_xg.json 字段语义 (2026-08-04 第三次修正!)
+### v_xg.json 字段语义 (2026-08-04 **第 4 次修正**, marksix6.com 验证)
 - **`Qi` = 最新已开期号** (刚开) — **不是"下次将开"**
 - **`Nq` = 未开下期期号** (下一个)
 - **`Week`/`Day`/`Year`/`Moon` = Nq 期(未开下期)开彩日** (北京时间) — **不是 Qi 期**
-- **`Data.1-7` = Qi-2 期 已开号码** (不是 Qi-1) — 7 个号码 + 5 行字段
-- **取 Qi 期(刚开)真开号码**: 查 sol.2344a.cc/挂牌 或 lottery.db, **v_xg.json 不显示 Qi 期号码**
+- **`Data.1-7` = Qi 期真开彩号码** (不是 Qi-1, 也不是 Qi-2) — 7 个号码 + 5 行字段 (sx/nim/color/style/number)
+- **取 Qi 期真开号码**: v_xg.json Data.1-7 **就是 Qi 期真开** (2026-08-04 marksix6.com 验证)
 - **取 Qi 期开彩日**: Nq 期开彩日 - 1 个开彩日 (周二/四/六规律), 或查 sol.2344a.cc 挂牌帖
-- **早期版本错误 (3 层错)**:
+- **早期版本错误 (4 层错)**:
   - v1.0-v1.2.6: `Qi=下次将开` + `Data=Qi-1 期` + `Week=Qi 期`
   - v1.2.7 第一次修正: `Data=Qi-2 期` (对) + `Week=Qi 期` (错) + `Qi=下次将开` (错)
-  - v1.2.7 第二次修正: **新增 `Week=Nq 期`** (对) — 完成 4 层坑全部修正
-- **完整正面 vs 错误**: 见 `references/v_xg-data-qi-2-pitfall.md` (2026-08-04 第三次修正)
-- **验证法**: 拿 `sol.2344a.cc` 挂牌帖时间戳对照 v_xg.json — 挂牌日 = 开彩日(硬规则)
+  - v1.2.7 第二次修正: `Week=Nq 期` (对) — 但 `Data=Qi-2` 仍错
+  - v1.2.8 (本次, 第 4 次): `Data=Qi 期真开彩` (对) — marksix6.com 验证 ✓
+- **验证法**: 拿 `marksix6.com` 真开彩对照 v_xg.json Data.1-7 — 完全一致 (083 期 37/7/16/1/32/22/23)
+- **不要去 hkjc.com**: 详见 references/hkjc-com-blocked.md (Browserbase 商业 IP 全拦)
+
+### CLI period 智能判别 (2026-08-04 修)
+- **CLI 传 period**: `python3 lottery_特码.py 084` (用户指定期号)
+- **CLI 不传**: `python3 lottery_特码.py` → 自动取 v_xg.json Qi 期 (最新已开)
+- **header 显示**:
+  - period == Qi (已开): "本期 (Qi) 开彩日: Nq 期开彩日 - 3 天 (周二/四/六规律)"
+  - period == Nq (未开): "本期 (Nq) 开彩日: 直接显示 Week/Day" (不 -3 天)
+
+### 084 期实战命中 (2026-08-04)
+- lottery_特码.py 跑 084 期 → Top 1 = **38** (权重 10)
+- 手填 084 期真开 special=38 (从 v_xg.json Data.1-7 第 7 位 + marksix6.com 验证) → check_hits: hit=✓
+- **金额 ¥5 中奖 → ¥210** (赔率 1:42)
+- **重要**: v_xg.json Data.1-7 第 7 位 就是特码, **可直接用** (marksix6.com 验证)
+
+### marksix6.com = 真开彩验证源 (2026-08-04 新)
+- `https://www.marksix6.com/` — **首选**真开彩查询 (browser 渲染)
+- 详见 `references/marksix6-com-verification-source.md`
+- **不要**: 试 hkjc.com / sol.2344a.cc/kj/ / 百度 / Wayback (全失败, 详见 hkjc-com-blocked.md)
 
 ## QQ 推送格式 (跨 skill 用户偏好)
 
@@ -77,6 +97,7 @@
 - `cn_dividend_buy_timing.py` (A股高息买入时机)
 - `daily_t_analysis.py` (做 T 分析)
 - `scan_cn.py` / `dca_scanner.py` / `analyze_cmb.py` (高息扫描)
+- `lottery_特码.py` (08-04 改横向表)
 
 ## cron agent 模式必用 no_agent + script (2026-08-02 实战)
 
@@ -95,4 +116,22 @@
 
 **复盘**: 当时已经知道 `lottery_4frame.py` 存在 + 改了 cron prompt + 改了 SKILL.md description, **但还是错**。真正的修复必须是 `no_agent: true` + script, 让模型没有推理空间。
 
-参考: `../../devops/cron-job-management/SKILL.md` §3 "Two Cron Job Modes" + §10 "Agent-Mode Cron + Provider Rate Limit" — 把这个规律扩展到新场景: **agent-mode cron + 任何"语义模糊源" (期号/日期/字段含义) = 编风险, 必 no_agent + script**。
+参考: `~/.hermes/skills/devops/cron-job-management/SKILL.md` §3 "Two Cron Job Modes" + §10 "Agent-Mode Cron + Provider Rate Limit" — 把这个规律扩展到新场景: **agent-mode cron + 任何"语义模糊源" (期号/日期/字段含义) = 编风险, 必 no_agent + script**。
+
+## 实战回顾 (跨 skill)
+
+### 082 期 (2026-07-30 凌晨, 第一次)
+- agent 编: "081 期 7/30 周四 21:30 开彩" (实际 081 = 7/28 周二)
+- agent 编: "082 期 = 8/1 周六" (实际 082 = 7/30 周四)
+- 用户反复纠正 → 真相: 挂牌日 = 开彩日
+
+### 083 期 (2026-08-04 上午)
+- agent 编: title "082 期" + Data 是 Qi-1 期 081 号码 + "周二" 时间错
+- 用户问"为什么统计的是上上期"
+- → 修正 Data = Qi-2 期
+
+### 084 期 (2026-08-04 下午, 第 4 次修正)
+- 用户问 "8 月 4 号不是 083 期" → 修正 Qi = 最新已开
+- 用户问 "Nq 是什么" → 修正 Nq = 未开下期
+- marksix6.com 验证: Data.1-7 = Qi 期真开彩 (不是 Qi-1/Qi-2)
+- **084 期 Top 1 = 38 → 真开 38 → 中奖 ¥5**