zlt
/
tradingSystem
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

三源合议阶段评审与下一阶段开发方案规格书（只写文档，未动代码） 

评审对照方案逐包核对完成度与真机判收，155 只读读数、开发机全量单测，
十条发现里最要紧的两条是盘中确认没有落地、观察读数不落表复核做不了。
下一阶段定为观察与收尾，八个工作包、六个新参数、八个拍板点，
每个工作包带改动点、单测清单、验证命令与回退。DEVLOG 追加五段式节点。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
zlt 2026-09-14 09:22:15 +08:00
parent 969d189be0
commit 28347fcb00
3 changed files with 758 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
DEVLOG.md
View File

@ -1461,6 +1461,24 @@ app/services/strategy_runner.py（跟踪止盈评估器 _eval_trail 加盘中 SA
工作包三四部分全做完。剩：工作包四选股打分在 akg-factor-bridge 另一仓库，单独审批后再动；页面管理视图持仓总览「证据列印两遍」的显示错误与研究面列本轮未碰。真机判收要看真有弱基本面试探仓入场次日的紧止盈自动挂载、以及策略票 SAR 翻空当天的止损。
---
## 2026-09-14 · 三源合议阶段评审与下一阶段方案（只写文档，未动代码）
**做了什么**
对《技术面接入与三源合议方案_2026-09-11》落地后的代码、文档与运行状态做了一轮评审，并写了下一阶段的开发方案与规格书。评审读了方案、进度交接、台账 001 到 011、总览与真实仓部署方案；逐行读了合议四个纯逻辑模块、装配服务、技术面取数服务与动作引擎、提议服务里的接入段落；在开发机用旧虚拟环境跑了全量单测；在 155 只做只读检查。结论：工作包一、二、三、五完成并真机判收，代码与护栏纪律达标；合议链 09-11 收盘后部署，09-14 是它跑的第一个交易日，台账 006 到 011 的复核都未到期，而且系统没有留下可复核的读数。评审发现十条，最要紧的两条：方案第三节的盘中确认没有落地（三个参数无读取处、未登记）；观察读数不落表、日报不含，复核日期到了拿不出数。另有转空去重集清除条件过宽（缺读数被当翻多清出）、持仓行择时票无转多留痕、PMS_CONSENSUS_WEAK_CONFIRM 未登记、单票研究面接口只给技术面一块、候选栏芯片与管理视图研究面列未做、策略票网格买入腿不受技术面门（要拍板）、技术面立场整体偏空（153 只里看多 5 只）、README 影子模式说法过时、第二十四批一例依赖墙钟。下一阶段定为「观察与收尾」，八个工作包：观察读数包（新表 pms_consensus_stat、标签、检查点落表、复核脚本、日报小节）、盘中确认包（收口突破与开口确认两条规则、四个参数）、页面收尾包、加固包、分段启用包（只改参数）、选股打分包（另一仓库单独审批）、真实仓准备包（初始参数清单与自检脚本）、文档包。八个拍板点写在规格书第八节。
**动了哪些文件**
新增 docs/三源合议阶段评审_2026-09-14.md、docs/下一阶段开发方案与规格书_2026-09-14.md；本节点。没有动任何代码。
**部署方式**
无需部署。
**真机判收**
155 只读读数（09-14 08:55 到 09:18，北京时间）：代码 969d189，镜像指纹一致 d8ee35a4dfed，四容器健康；技术面读数日 20260911 共 4993 行，映射 08:40:06 重建 153 只全新鲜（看多 5、中性 101、看空 47）；09-11 16:29 部署之后零条新提议，转空去重集为空；关键开关：下发 ws、自主 full、新建仓 propose_only、技术面开、合议分流开、增持门开、质地排序开、转空离场 full、**策略层总开关开（与 09-11 节点写的「未开」不同，09-11 17:20 的策略层试算摘要里还是总开关关闭的跳过，之后被人打开）**、解锁重问开（代码默认即开，从 09-10 起在跑）。开发机全量单测：三十一批里三十批通过，第二十四批一例在 09:36 之前跑必失败（用例把今天 09:35 的告警当陈旧断言），属用例卫生问题。
**还欠着什么**
一，八个拍板点（规格书第八节），其中「策略层总开关是否有意打开」今天就要答，因为 09:40 那一跳会是工作包三后两部分的首次实弹。二，八个工作包一个都还没动工，建议顺序与交易日安排见规格书第四节；观察读数包要在 09-17 复核前部署。三，CLAUDE.md 仍未跟踪，按文档包入库。
---
<!--
下一条节点从这里往下写，格式照抄上面：

163
docs/三源合议阶段评审_2026-09-14.md Normal file
View File

@ -0,0 +1,163 @@
# 三源合议阶段评审（2026-09-14）
> 评审对象是《技术面接入与三源合议方案_2026-09-11》落地之后的代码、文档与运行状态。
> 写法遵守 `.claude/output-styles/readable-chinese.md`。
> 读完第一到第六节就知道现状与问题。第七节是结论。
> 下一阶段怎么做，展开在《下一阶段开发方案与规格书_2026-09-14.md》。
---
## 一、评审做了什么
1. 读了方案、进度交接、开发节点记录最近六条、复盘决定台账 001 到 011、总览文档、真实仓部署方案、九月十日的交接文档。
2. 逐行读了合议的四个纯逻辑模块、装配服务、技术面取数服务。也读了动作引擎与提议服务里的全部接入段落。
3. 在开发机用上一次会话留下的虚拟环境跑了全量单测。
4. 在模拟仓 155 只做了只读检查：代码版本、镜像指纹、容器状态、关键开关的实际值、技术面映射、部署之后的提议。没有改任何东西。
5. 看了两个兄弟仓库的最近提交与台账。一个是选股系统，一个是决策系统。目的是确认跨系统的事项各在什么状态。
## 二、一句话结论
方案的五个工作包里，工作包一、二、三、五已经做完，并在 155 真机判收。代码质量与护栏纪律达到本项目的标准。
但合议这条链是周五收盘后部署的，今天才是它跑的第一个交易日。台账 006 到 011 要求的复核一个都还没到期。而且系统目前没有留下能做复核的读数。
此外，方案里有一块设计没有落地，就是盘中确认。有一块在另一仓库等审批，就是选股打分。页面有三处收尾。代码有四个小的加固点。
建议下一阶段以「观察、补读数、收尾」为主，不上新的大功能。
## 三、对照方案的完成度
| 方案里的条目 | 内容 | 状态 | 真机判收 |
|---|---|---|---|
| 工作包一 | 技术面取数落表、相位合成、映射、三个接口、调度位、页面三项 | 完成 | 真机见过。映射覆盖、分页拉全、两个真机坑已修并加哨兵 |
| 工作包二 | 三源合议纯逻辑、装配、仓位矩阵、接入下单链路、增持门、质地排序、提议卡合议行 | 完成 | 真机见过试算：三只看空候选被跳过、一只等开口。合议行与增持门的实弹还没见过 |
| 工作包三 | 转空自动离场、策略票判据、跟踪止盈 SAR 线、弱基本面紧止盈 | 完成 | 真机见过部署与试算。实弹一次都没发生过 |
| 工作包四 | 选股系统打分改质地调整分 | 未做 | 在另一仓库，等单独审批 |
| 工作包五 | 台账 006 到 011、README 调度总表、接口契约技术面一节 | 完成 | 不适用 |
| 第三节的盘中确认 | 09:45 到 14:30 放量确认、收口当天突破就进候选 | 未做 | 无 |
| 工作包一第 6 点里的三处页面 | 候选栏质地与技术芯片、管理视图持仓总览研究面列、单票抽屉三源合议四芯片 | 未做 | 无 |
## 四、真机读数（2026-09-14 上午 08:55，模拟仓 155，只读）
运行状态如下。
| 项目 | 读数 |
|---|---|
| 代码版本 | 969d189，就是远程的最新提交 |
| 镜像指纹 | 与工作树一致（d8ee35a4dfed） |
| 容器 | pms-web 健康，pms-worker、pms-beat、pms-ws 都在跑，已运行两天 |
| 容器内时间 | 北京时间，与开发机一致 |
| 技术面读数日 | 20260911，也就是上一交易日 |
| 技术面行数 | 4993 |
| 技术面映射 | 08:40:06 重建，153 只，全部新鲜，没有错误 |
| 映射里的立场分布 | 看多 5 只，中性 101 只，看空 47 只 |
| 部署之后的新提议 | 零条。评审账本最后四条都是 09-11 上午的，不带合议六键 |
| 转空去重集 | 空，说明还没处理过任何一次翻空 |
关键开关的实际值如下。
| 参数 | 实际值 | 说明 |
|---|---|---|
| PMS_DISPATCH_MODE | ws | 真向模拟 QMT 发委托 |
| PMS_AUTONOMY | full | 持仓自主动作自动执行 |
| PMS_OPEN_AUTONOMY | propose_only | 新建仓交人 |
| PMS_TECH_ENABLED | 开 | 技术面总闸 |
| PMS_CONSENSUS_ROUTE | 开 | 合议参与分流 |
| PMS_TECH_GATE_INCREASE | 开 | 持仓增持门 |
| PMS_PLAN_RANK_BY_QUALITY | 开 | 候选按质地排序 |
| PMS_TECH_EXIT_AUTONOMY | full | 转空离场自动执行 |
| PMS_STRATEGY_ENABLED | 开 | 与 09-11 节点写的「未开」不同 |
| PMS_OPEN_REASK_ENABLED | 开 | 代码默认值就是开 |
| PMS_FUND_REQUIRED | 开 | 无买方评析不建仓 |
| PMS_TOTAL_SCALE | 2,000,000 | 总规模 |
两点要特别说明。
第一，策略层总开关现在是开的。09-11 收盘后的节点写的是「155 上没开，代码已部署但休眠」。现在读到开，说明 09-11 傍晚之后有人在页面上把它打开了。如果是有意的，那么今天 09:40 那一跳就是工作包三后两部分第一次实弹运行。后两部分指 SAR 止损线刷新与弱基本面紧止盈挂载。
第二，解锁重问的总开关是开的，因为它的代码默认值就是开。也就是说，九月十日交接文档第五节写的「第一段尚未开始」，其实从 09-10 部署起就已经在跑。到今天收盘它就跑满三个交易日，第一段的复核可以做了。
开发机全量单测的结果：三十一批里三十批通过，第二十四批有一例失败。失败原因是那条用例把「今天 09:35」的告警当作已陈旧来断言，而我在 09:0x 跑，年龄算成负数。服务器上都是收盘后跑测试，所以从没撞上。这是用例依赖墙上时钟，不是代码问题。
## 五、代码评审发现
按「先要紧后次要」排。每一条写清楚在哪里、影响什么、建议怎么办。
### 发现一、设计没有落地的一块：盘中确认
方案第三节最后两段写了盘中确认。方案第六节列了它的三个参数，分别是量比阈值、收口当天突破的开关、确认时段。这三个参数在代码里没有任何读取处，也没有登记。全仓库搜不到。
影响有两条。一，处在收口等待的票只能等到次日 06:30 拉到新读数才可能变成开口。「今天现价站上昨日上轨且放量，当天就视为开口进候选」这一条没有。二，昨天已开口的票不检查现价是否低于当日均价，也不看量比。
技术面对入场时点的盘中判断全部缺失。技术面这一票现在完全是昨夜数据。建议下一阶段补上。规格见规格书的盘中确认包。
### 发现二、观察读数没有留痕，台账的复核做不了
台账 006 到 011 的「预期」都是量化读数。技术面无读数占比要低于百分之三。每天被等技术面开口拦下的票要在一到十五只之间。转空退出每周零到三条。合议方向与人的判断对不上的要逐只记。
现在这些数只存在于每分钟扫描的返回值与页面即时快照里。它们不落任何表，日报也不含。复核日期到了拿不出数。
这是本次评审认为最该先做的事。规格见规格书的观察读数包。
### 发现三、转空去重集的清除条件过宽
位置在 `app/services/proposal_service.py` 第 150 到 154 行。去重集的作用是同一次翻空只处理一次。每轮扫描前，代码把映射里 SAR 方向不是「空」的代码从去重集里去掉。
问题在「不是空」包含了「映射里没有这只票」。某只持仓票某天缺读数，比如停牌，或者决策系统那晚漏算，它会被当成翻多而清出去重集。如果同一轮另有别的票处理了转空离场，清过的集合会被写回。第二天它的读数回来、翻空仍在两天内，会再减一次。
概率低，后果是多减三分之一。建议改成「映射里明确为多」才清除，缺读数保留。改动两行，加两例单测。
### 发现四、持仓行的择时票没带盘中转多留痕
装配服务给持仓行装配时，转多留痕表恒为空。候选行则从自带的买入信号取时刻。影响只在增持门的方向判断，程度小。规格书的加固包里作为小改动列入。
### 发现五、方案承诺的一个开关没有登记
方案第六节写了 PMS_CONSENSUS_WEAK_CONFIRM，含义是只有一方表态时交人。代码里没有这个参数，行为写死为交人。要么登记并让合议路由读它，要么在方案文档里划掉。建议登记，默认开。关掉时单方表态放行。
### 发现六、单票研究面接口只给了技术面一块
接口是 `GET /api/research/{ts_code}`，位置在 `app/web/main.py` 第 740 到 756 行。它的基本面、择时、合议三块都是空占位。页面单票抽屉那一节的标题也只写「研究面 · 技术面」。方案要求的是「研究面 · 三源合议」一节四枚芯片，点开能看全文。
### 发现七、页面还有两处没做
候选栏每行的质地芯片与技术芯片没做，只做了「等技术面开口」处置词。管理视图持仓总览只修了「证据列印两遍」并加了评析报告链接，研究面列没加。
### 发现八、策略层的网格买入腿不受技术面的门（要拍板）
动作引擎的三道增持门只管常规持仓。挂了交易方案的票，它的加仓腿由策略层管。策略层现在只认两样：决策系统风控预警的暂停买入，以及宏观闸。它不认技术面看空，也不认合议看空。
方案没有要求这一点，所以这不是缺陷，是一个未决的设计问题。要拍板：技术面看空时，策略票的网格低吸要不要也停。
### 发现九、技术面立场整体偏空，入场会明显收紧
今天 153 只相关票里，技术面看多只有 5 只。按三票多数的规则，技术面这一票绝大多数时候是中性或看空。看多要求 SAR 为多且多空布林线不在空头区，或者 SAR 两天内刚翻多。其余全归中性或看空。
这可能是市场状态，也可能是相位表偏严。台账 006 说阈值不按复盘读数回调，要回台账。建议先用观察读数包的数据看满三个交易日再议，现在不调。
### 发现十、文档与工作区的四处小事
1. README 第 173 到 207 行仍写「当前仍是影子模式」「依然没有任何系统会自动下单」。模拟仓从 8 月 3 日起就是 ws 模式，已经发出一百九十六笔真实委托。九月十日交接第九节已经提出，等拍板。安全相关的说法过时，比一般文档过时更危险。
2. CLAUDE.md 在工作区里是未跟踪状态，没有入库。
3. 第二十四批那条依赖墙上时钟的用例要改成相对当前时刻构造。
4. 真实仓 188 的代码停在 51bd6dc，落后六十九个提交。差异里有两张新表，分别是净值快照表与技术面日表。有两个新调度位，分别是 06:30 拉技术面与 15:20 净值快照。还有四十多个新参数。新参数的默认值是按模拟仓定的：转空离场默认自动执行，合议分流默认开。追平部署前必须先有一份「真实仓初始参数清单」。否则一部署就把 full 档位的自动离场带进真实账户。
## 六、做得好的地方
1. 每一处接入都守住「开关关掉逐字回旧」，并且先写这条单测再改。第二十九批与第三十批每一组都有这样一例。
2. 六个合议硬数字键不进送研判白名单，有机器证明，不靠口头。
3. 「无读数等于弃权，绝不折成看空」贯彻到每一层。相位合成、基本面、择时、合议、增持门、转空离场都是这样。
4. 两处脱库单测测不到的真机坑都补了哨兵。一处是 upsert 的绑定参数，一处是分页误判最后一页。
5. 台账 006 到 011 与方案逐条对应。README 调度总表与接口契约同步更新了。
6. 纯逻辑层零外部依赖。相位表的实现与方案第三节的表逐格对应，读起来能对上。
## 七、评审结论
进入「观察与收尾」阶段。下一阶段不上新的大功能，做四类事。
1. 补观察读数与复核工具。
2. 补盘中确认。
3. 页面与接口收尾，加四处加固。
4. 按顺序把已写好的功能分段启用，并为真实仓追平准备清单。
选股打分等审批。真实仓追平等 QMT 侧。具体见《下一阶段开发方案与规格书_2026-09-14.md》。

577
docs/下一阶段开发方案与规格书_2026-09-14.md Normal file
View File

@ -0,0 +1,577 @@
# 下一阶段开发方案与规格书（2026-09-14）
> 供拍板与实施。开发者可以是人，也可以是大模型。
> 写法遵守 `.claude/output-styles/readable-chinese.md`。
> 第一到第九节是正文，读完就知道做什么、为什么、怎么验证。
> 附录是实现细节，标了「可不读」。但开发者动手前必须读自己那个工作包的附录。
> 评审依据见《三源合议阶段评审_2026-09-14.md》。
---
## 一、这件事为最终目标买什么
最终目标是持仓管理系统在真实仓上全自动运行。分工不变：选股系统出候选，决策系统出研判与择时，持仓管理系统定做什么与多少，下游只管执行。
到今天，模拟仓上三源合议的整条链已经部署，但一个交易日都还没跑过。真实仓卡在下游 QMT 侧，等对方。所以这一阶段不是再加功能。这一阶段做四件事。一，把已经上线的纪律变成能量化复核的纪律。二，把方案里欠的那块补齐。三，把写好的功能按不互相干扰的顺序开起来。四，为真实仓准备好追平清单。
这一阶段买三样东西。
1. 复核的依据。没有读数就没有复核，没有复核就不能把这套东西部署到真实仓。
2. 技术面对入场时点的盘中判断。现在技术面那一票全是昨夜数据，方案第三节的盘中确认没落地。
3. 真实仓上线的安全前提。一份初始参数清单加一个自检脚本，保证追平部署不会把模拟仓的默认值带进真实账户。
## 二、原则
沿用方案的三条设计原则。一是入场靠投票，离场靠纪律。二是无读数等于弃权。三是研判闸不当选票。本阶段再加四条。
1. 先观察后调参。台账 006 到 011 的阈值不按复盘读数回调。要调，先回台账写一条。
2. 一次只开一个会互相喂的开关。观察窗口不重叠。
3. 每一处改动都守「开关关掉逐字回旧」，并先写这条单测再改。
4. 判收只认真机。开发机单测绿只是进门票。
## 三、做哪几件事
八个工作包，按建议的动工顺序排。前四个是代码。第五个只改参数。第六个在另一仓库。第七个等 QMT 侧。第八个是文档。
每个工作包的名字就是它做的事，不另起代号。
### 观察读数包（最先做）
**做什么。** 把每轮扫描里合议相关的判定落表，一天最多写四次。给一个复核脚本与一个日报小节，把台账要的四个读数直接打出来。
**为什么先做。** 台账 006 到 009 的复核日期是合议分流上线后满三个交易日，也就是 09-17。到那天没有读数就复核不了。后面所有调参与上真实仓的决定都没有依据。
**做哪几件。**
1. 新表 pms_consensus_stat。一天一票一类一行，重复记到只加次数。
2. 动作引擎给合议相关的跳过项打上类别标签。只在开关开着时打，关掉时一个字都不多。
3. 新服务把一轮扫描的结果归类落表。只在四个检查点写，转空离场实弹随时写。试算不写。
4. 技术面映射重建时记下「相关票里没有读数的」和「覆盖只数」。
5. 复核脚本 `scripts/consensus_review.py`，外加 `make consensus-review` 目标。
6. 日报加「合议观察」小节。
细节见附录甲。
### 盘中确认包
**做什么。** 给技术面这一票加方案第三节写明的盘中确认，只用于入场。时段是 09:45 到 14:30。量比口径与解锁重问同源，也就是台账 003 的时段折算量比。
**两条规则。**
1. 收口突破。相位是收口等待的候选，盘中现价站上昨日布林上轨，且时段折算量比不低于 1.5，当轮视为开口向上。重新合议后进候选。
2. 开口确认。相位是开口向上的候选，盘中要求现价不低于当日均价，且量比不低于 1.5。不满足就当轮进观察，处置词是「等盘中确认」。下一轮再看。
**一个要拍板的读法。** 开口向上的候选在 09:45 之前与 14:30 之后进观察，等确认时段。收口等待的候选在时段之外照旧观察。
**为什么做。** 技术面决定「什么时候投」。没有盘中那一道，它只能说昨天。
细节见附录乙。
### 页面收尾包
1. 单票研究面接口补齐基本面、择时、合议、来源四块。页面抽屉那一节改成「研究面 · 三源合议」四枚芯片。
2. 候选栏每行加质地芯片与技术芯片。
3. 管理视图持仓总览加研究面列。
细节见附录丙。
### 加固包
1. 转空去重集只在映射明确为多时清除。
2. 持仓行的择时票带上盘中转多留痕。
3. 登记 PMS_CONSENSUS_WEAK_CONFIRM 并接进合议路由。
4. 第二十四批用例改成相对当前时刻构造陈旧告警。
细节见附录丁。
### 分段启用包（只改参数，不改代码）
**现状。** 今天 09-14 是合议分流跑的第一个交易日。策略层总开关已经是开的。解锁重问从 09-10 起就开着。这三样都在跑。
**顺序。**
| 段 | 做什么 | 前提 | 观察多久 |
|---|---|---|---|
| 零，进行中 | 合议分流、增持门、转空离场、策略层两道离场、解锁重问都开着。不再开任何新开关 | 无 | 到 09-16 收盘，三个交易日 |
| 一 | 09-17 用复核脚本做台账 006 到 009 的第一次复核。同时复核解锁重问，台账 001 已满三天 | 观察读数包已部署 | 一次 |
| 二 | 决策系统的强势扫描开观察档，只记不派 | 第一段复核无异常。动决策系统要先答三题并经审批 | 两个交易日 |
| 三 | 强势扫描真派单 | 第二段读数正常 | 三个交易日 |
| 四 | 资金流分发半开 | 必须单独一段 | 两个交易日 |
| 五 | 资金流分发全开 | 第四段全绿，且当日兜底卖出恒为零 | 两个交易日 |
| 六，候选 | 模拟仓新建仓自主档从 propose_only 提到 full | 合议链路两轮复核无系统性偏差。要拍板 | 三个交易日 |
**策略层那件事。** 如果总开关是有意打开的，今天 09:40 那一跳就是 SAR 止损线刷新与弱基本面紧止盈挂载的第一次实弹。今天盘后要看那一跳的摘要，命令在第六节。如果不是有意的，今天就关掉，等合议观察期过了再单独开一段。
### 选股打分包（另一仓库，单独审批）
按方案第五节工作包四执行，不改设计。质地好加 8 分，差减 8 分，在同一传导档内重排，不跨档。环境变量设为零即关。台账记到选股系统第 058 条。细节见附录戊。
### 真实仓准备包（准备件现在做，执行等 QMT 侧）
1. 一份真实仓初始参数清单，写进台账。
2. 一个自检脚本 `scripts/real_init_params.py`，只读比对当前值与清单，有偏差就报。表名前缀不是 real_ 时拒绝执行。
3. 一份追平差异清单，列清 188 落后的表、调度位、参数。
细节见附录己与附录庚。
### 文档包
1. README 第 173 到 207 行关于影子模式的过时说法改掉。改成「下发模式由参数决定，页面顶部横幅为准」，并写清模拟仓与真实仓各自现在是什么模式。
2. CLAUDE.md 入库。
3. 方案文档第六节加一句标注。PMS_CONSENSUS_WEAK_CONFIRM 在加固包登记，三个盘中确认参数在盘中确认包登记。
4. 台账追加 012 盘中确认阈值、013 观察读数与复核口径、014 真实仓初始参数清单。
5. 开发节点记录按五段式追加。
6. 接口契约文档补单票研究面接口的返回结构。
## 四、顺序与时间
按交易日排。部署一律收盘后，先经审批，看容器内时间判盘中盘后。
| 交易日 | 做什么 |
|---|---|
| 09-14 到 09-16 | 合议链路第一轮观察。期间只做不改行为的活：观察读数包、加固包、文档包。观察读数包要重建容器，安排在 09-14 或 09-15 收盘后 |
| 09-17 | 用复核脚本做台账 006 到 009 与 001 的第一次复核。决定要不要调阈值，要调先回台账 |
| 09-17 收盘后 | 部署盘中确认包与页面收尾包 |
| 09-18 到 09-22 | 盘中确认观察三个交易日。同时启动分段启用包第二段 |
| 09-23 | 盘中确认第一次复核，台账 012 |
| 等审批 | 选股打分包 |
| 等 QMT 侧 | 真实仓准备包的执行部分 |
## 五、开关与参数
全部经参数中心读，页面可改即时生效。每个键都有真实读取处，否则死参数扫描会红。
| 键 | 默认 | 属于 | 说明 |
|---|---|---|---|
| PMS_CONSENSUS_STAT_TIMES | 0935,1030,1330,1445 | 观察读数包 | 落表的检查点，四位时刻用逗号分隔。设为空串即不写检查点行，只写转空实弹行 |
| PMS_TECH_INTRADAY_CONFIRM | True | 盘中确认包 | 盘中确认总闸。关掉两条规则都不走，行为逐字如旧 |
| PMS_TECH_INTRADAY_BREAKOUT | True | 盘中确认包 | 收口突破规则的开关。关掉只剩开口确认规则 |
| PMS_TECH_VOL_CONFIRM | 1.5 | 盘中确认包 | 时段折算量比阈值。与解锁重问的 PMS_OPEN_REASK_VOL_MIN 同值同义 |
| PMS_TECH_INTRADAY_WINDOW | 0945-1430 | 盘中确认包 | 确认时段。与解锁重问的时段同义 |
| PMS_CONSENSUS_WEAK_CONFIRM | True | 加固包 | 只有一方表态时交人。关掉则放行 |
## 六、验证方式
每条命令标明在哪台机器上运行。一个命令块只放一台机器的命令。
### 观察读数包
**开发机。** 预期最后一行 ALL SUITES PASS。第二十四批那条时钟用例在加固包修掉之前，要在 09:36 之后跑。
```bash
cd /Users/baobao/Documents/work/project/tradingSystem && /private/tmp/claude-501/-Users-baobao-Documents-work-project-tradingSystem/f7c4a696-e3d8-4465-961a-04f82eb3e424/scratchpad/venv/bin/python scripts/run_tests.py
```
**模拟仓 155，收盘后，先经审批。** 预期 make test 最后一行 ALL SUITES PASS，建表输出 21 张表，其中有 pms_consensus_stat。
```bash
cd /home/factor/project/tradingSystem && git pull --ff-only && make deploy && make test
```
**模拟仓 155，下一个交易日 09:37 之后。** 预期打出当天的表：相关票数、无读数占比、等开口只数、跳过原因分布、增持门拦截次数、转空离场条数。第一天转空离场应为零。
```bash
cd /home/factor/project/tradingSystem && make consensus-review DAYS=1
```
### 盘中确认包
**模拟仓 155，交易日 09:45 到 14:30 之间，只读试算。** 预期跳过项里出现处置词 wait_confirm，或者出现「盘中收口突破」的候选。两种至少见到一种。若当天没有收口等待或开口向上的候选，就看不到，改天再看。
```bash
cd /home/factor/project/tradingSystem && docker compose run --rm --no-deps pms-web python -c "from app.services import proposal_service as p; import json; d=p.scan_and_route(dry_run=True); print(json.dumps([s for s in d.get('skipped',[]) if s.get('disp') in ('wait_confirm','wait_tech') or '盘中' in str(s.get('why'))], ensure_ascii=False)[:1500])"
```
**模拟仓 155，任意时间。** 预期四个参数都在快照里，且带范围。
```bash
cd /home/factor/project/tradingSystem && docker exec pms-web python -c "from app.services import param_store as ps; print({k: ps.get(k, None) for k in ('PMS_TECH_INTRADAY_CONFIRM','PMS_TECH_INTRADAY_BREAKOUT','PMS_TECH_VOL_CONFIRM','PMS_TECH_INTRADAY_WINDOW')})"
```
### 页面收尾包
**开发机。** 预期两道页面守卫都打 ALL OK。
```bash
cd /Users/baobao/Documents/work/project/tradingSystem && python3 scripts/test_page_wiring_guard.py && python3 scripts/test_page_enum_guard.py
```
**页面判收，模拟仓 155 部署后。** 点任一持仓，抽屉第一节标题是「研究面 · 三源合议」，有基本面、技术面、择时、合议四枚芯片。候选栏每行有质地与技术两枚芯片。管理视图持仓总览多一列研究面。
### 加固包
**开发机。** 预期第三十批与第二十八批新增用例全部通过，且第二十四批在任何时刻跑都通过。
```bash
cd /Users/baobao/Documents/work/project/tradingSystem && /private/tmp/claude-501/-Users-baobao-Documents-work-project-tradingSystem/f7c4a696-e3d8-4465-961a-04f82eb3e424/scratchpad/venv/bin/python scripts/test_batch30_units.py && /private/tmp/claude-501/-Users-baobao-Documents-work-project-tradingSystem/f7c4a696-e3d8-4465-961a-04f82eb3e424/scratchpad/venv/bin/python scripts/test_batch28_units.py && /private/tmp/claude-501/-Users-baobao-Documents-work-project-tradingSystem/f7c4a696-e3d8-4465-961a-04f82eb3e424/scratchpad/venv/bin/python scripts/test_batch24_units.py
```
### 分段启用包
**模拟仓 155，今天 09:40 之后，看策略层那一跳。** 预期摘要里的时刻是今天 09:4x，没有 error 字样。若策略层是有意打开的，这就是第一次实弹的读数。
```bash
cd /home/factor/project/tradingSystem && docker exec pms-web python -c "from app.services import param_store as ps; print((ps.get('PMS_AUTO_LAST_SCAN','') or '')[:1200])"
```
**模拟仓 155，任意时间，解锁重问的三天读数。** 预期打印当日被驳回的票数与逐只解锁判定。每天解锁一到五次是正常，零次说明太紧，超过八次说明太松。
```bash
cd /home/factor/project/tradingSystem && docker compose run --rm --no-deps pms-web python -c "from datetime import datetime; from app.services import proposal_service as ps, reask_service as rs; jk = ps._judge_rejected_open_keys(); print('当日被研判驳回:', len(jk), '只'); print('解锁:', rs.evaluate_all(jk, datetime.now()) or '(无)')"
```
### 选股打分包
**模拟仓 155，改之前先记基线。** 预期打印主榜前五十名里质地好的只数。今天的基线是前一百名里六只。
```bash
curl -s "http://192.168.16.155:8300/plan?top=50" | python3 -c "import sys,json; d=json.load(sys.stdin); rows=d.get('main') or []; print('前50质地好:', sum(1 for r in rows if (r.get('company_review') or {}).get('overall')=='好'), '/', len(rows))"
```
**模拟仓 155，重启桥容器后，避开 07:10，先经审批。** 预期同一条命令的读数上升，且每一行的 rank 连续。
### 真实仓准备包
**真实仓 188，只读，现在就能做。** 预期打印 51bd6dc 附近的提交与两个容器。这一步只是确认起点，不动任何东西。
```bash
cd /mnt/work/project/tradingSystem && git log -1 --format='%h %ad %s' --date=iso && docker ps --format '{{.Names}}\t{{.Status}}' | grep pms
```
**真实仓 188，追平部署之后，先经审批。** 预期打印表名前缀 real_ 与一张对照表，每一行都是「符合」。任何一行「偏差」都不许进阶段 B。
```bash
cd /mnt/work/project/tradingSystem && docker compose run --rm --no-deps pms-web python scripts/real_init_params.py --check
```
## 七、回退
每个工作包独立回退，互不牵连。
| 工作包 | 回退方式 | 要不要重启 |
|---|---|---|
| 观察读数包 | 页面把 PMS_CONSENSUS_STAT_TIMES 设为空串。要彻底撤，回滚提交再部署。表留着不删 | 改参数不用；回滚要重建容器 |
| 盘中确认包 | 页面把 PMS_TECH_INTRADAY_CONFIRM 设为关，行为逐字回旧 | 不用 |
| 页面收尾包 | 回滚提交再部署 | 要重建容器 |
| 加固包 | PMS_CONSENSUS_WEAK_CONFIRM 默认开就是旧行为。其余三处回滚提交 | 回滚要重建容器 |
| 分段启用包 | 每一段把对应开关改回去。决策系统侧的开关改环境文件后重建那一个容器 | 持仓管理系统侧不用 |
| 选股打分包 | 环境变量把加分设为零，或回滚提交，重启桥容器 | 要重启桥容器 |
| 真实仓准备包 | 自检脚本只读，无需回退 | 不用 |
## 八、拍板点
这八条要用户拍板，拍板前对应的活不动。
1. 策略层总开关现在是开的，是不是有意的。若不是，今天就关。
2. 盘中确认里，开口向上的候选在 09:45 之前与 14:30 之后进观察。这个读法认不认。
3. 策略票的网格买入腿，技术面看空时要不要也停。方案没写，现在不停。
4. 选股打分包动 akg-factor-bridge 仓库，批不批。
5. README 影子模式的过时说法按文档包第 1 条改，认不认。
6. 检查点默认四个时刻，认不认。多了写库多，少了读数粗。
7. 观察读数表用新表而不是运行参数承载。新表要改 DDL 表数哨兵。认不认。
8. 分段启用包第六段，新建仓自主档提到 full 的时机，等两轮复核后再议。
## 九、交付要求
给开发者的硬要求，人和大模型一样。
1. 每个工作包一个提交。提交信息用短中文说行为，带台账号。
2. 先写「开关关掉逐字回旧」的单测，再改代码。开关关掉时，输出的字典要用 JSON 序列化后逐字节相等。
3. 新批次同时登记进 `scripts/run_tests.py` 的 SUITES 清单与例数表。哨兵按附录辛逐条过一遍。
4. 开发机全量绿之后，才在模拟仓 155 收盘后部署。部署要重建容器，先经审批。判收命令在第六节，判收读数记进开发节点记录的五段式节点。
5. 不动真实仓 188。真实仓准备包的执行部分等 QMT 侧就绪后另开一轮。
6. 服务器上只做 git pull，不跑 git stash。
7. 判盘中盘后看容器内时间，不看宿主时间。宿主是世界协调时。
8. 业务参数一律经参数中心读。密钥只从 .env 注入。
9. 一条 SQL 只碰一张表。要联的数据在服务层分两次查再在内存里拼。
---
## 附录甲（可不读）：观察读数包的表、标签与落表规则
### 表
新表名 pms_consensus_stat，加进 `ddl_pms_v1.sql`，是第 21 张表。
```sql
CREATE TABLE IF NOT EXISTS pms_consensus_stat (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
stat_date INT NOT NULL, -- 北京日期 yyyymmdd
ts_code VARCHAR(16) NOT NULL, -- 代码; 全局行用 *
kind VARCHAR(24) NOT NULL, -- 类别, 见下表
reason VARCHAR(255) NULL, -- 一句原因, 取跳过原因原文截断
detail TEXT NULL, -- JSON: 三票 / 方向 / 强弱 / 相位 / 路由 / 盘中确认
first_at DATETIME NOT NULL, -- 北京时间, 首次记到
last_at DATETIME NOT NULL, -- 北京时间, 最近记到
rounds INT NOT NULL DEFAULT 1, -- 记到的次数
UNIQUE KEY uk_day_code_kind (stat_date, ts_code, kind),
KEY idx_day_kind (stat_date, kind)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```
### 类别
| kind | 含义 | 来源 |
|---|---|---|
| open_skip_fund | 新建仓因没有买方评析跳过 | 合议路由为跳过，原因是没有买方评析 |
| open_skip_bear | 新建仓因方向看空跳过 | 合议路由为跳过，其余原因 |
| open_wait_tech | 等技术面开口或转向 | 合议路由为观察 |
| open_wait_confirm | 等盘中确认 | 盘中确认包 |
| open_breakout | 盘中收口突破视为开口 | 盘中确认包 |
| open_confirm | 合议交人 | 合议路由为交人 |
| open_pass | 合议放行 | 合议路由为放行 |
| gate_block | 增持门拦下 | 持仓扫描的跳过项，detail 里记 fill、add、dca 三者之一 |
| tech_exit | 转空离场实弹，执行或入队 | 扫描后真处理过的集合 |
| tech_noread | 相关票没有技术面读数 | 映射重建时相关票减去有状态的票 |
| fund_noread | 基本面无读数 | 装配结果 |
| timing_noread | 择时无读数 | 装配结果 |
| map_cover | 映射覆盖只数，ts_code 为 * | 映射重建时，detail 记 codes 与 states 两个数 |
### 打标签
在 `app/core/action_engine.py` 里，合议分流与增持门产生的跳过项加一个 tag 键，值就是上表的 kind。只在 consensus_on 或 cblocks 为真的分支里加。开关关掉时这些分支一行不执行，所以 tag 键不会出现，逐字回旧成立。
增持门的跳过项 detail 里带 gate_kind，取值 fill、add、dca。
### 装配时留一份紧凑记录
`proposal_service._attach_consensus` 每装配一只候选，往 out["consensus_seen"] 追加一条紧凑记录：ts_code、fund、tech、timing、direction、route、phase。这份记录给落表用，也给候选处置快照用。
### 落表
新服务 `app/services/consensus_stats.py`，一个入口函数 record_round(out, scanned, params, now)。
1. 从 out["consensus_seen"] 生成 open_* 三类无读数行与 open_pass、open_confirm 行。
2. 从 out["skipped"] 里带 tag 的项生成 open_skip_*、open_wait_*、gate_block 行。
3. 从 scanned["candidates"] 里来源是 tech_exit 且没被闸拒的项生成 tech_exit 行。
4. 检查点判断：now 的时分在 PMS_CONSENSUS_STAT_TIMES 任一时刻或它的下一分钟之内才写第 1、2 类。tech_exit 行任何时候都写。dry_run 一律不写。
5. 写失败只记警告，返回 ok 为假，不影响扫描。这个函数登记进第十批 SOFT_FAIL 名单。
调用点在 `proposal_service.scan_and_route` 末尾，去重集写回之后。
`tech_service.build_map` 在写映射之后，写 tech_noread 行与 map_cover 行。失败只记日志。
### 仓库
新文件 `app/repo/consensus_stat_repo.py`，三个函数，每个只碰这一张表。
1. upsert_many(rows)。用 INSERT 加 ON DUPLICATE KEY UPDATE。更新子句用 VALUES(列) 引用插入值，rounds 写成 rounds 加一。绝不在更新子句里放绑定参数，那是 09-11 真机踩过的坑。
2. list_range(date_from, date_to, kinds=None)。
3. count_by_kind(date_from, date_to)。返回按日期与类别的计数字典。
### 复核脚本
`scripts/consensus_review.py --days N`，默认 3。打印四张表。
1. 逐日：相关票数、技术面无读数占比、基本面无读数只数、择时无读数只数。占比用 map_cover 行算。
2. 逐日：等开口只数、等盘中确认只数、跳过原因分布、交人只数、放行只数、增持门拦截次数。
3. 转空离场逐条：日期、代码、确认与否、数量。
4. 合议方向与人工裁决的比对：从提议表取这几天带合议六键且已被人裁决的提议。合议看多而人驳回，或合议交人而人采纳，逐只列出。终态的名字用提议服务里现有的枚举，不另造。
Makefile 加目标 consensus-review，接受 DAYS 变量，默认 3。
### 日报
`ledger_service.build_daily_report` 加一节 consensus，内容是当天按类别的计数。取不到就写空，不拖垮日报。
## 附录乙（可不读）：盘中确认包的判定函数与接线位置
### 纯函数
加在 `app/core/tech_rules.py`。
```python
def intraday_confirm(state, *, price, vwap, upper_prev, vol_ratio, now,
window="0945-1430", vol_min=1.5, breakout_on=True) -> dict:
"""返回 {"state": 新技术面块或原块, "changed": bool,
"kind": None | "breakout" | "opened_ok" | "opened_wait" | "outside_window",
"why": str, "reads": {"price", "vwap", "upper_prev", "vol_ratio", "at"}}"""
```
判定次序如下。
1. 相位不是收口等待也不是开口向上，原样返回，kind 为空。
2. 不在时段内。相位是开口向上，返回 outside_window。相位是收口等待，原样返回。
3. 相位是收口等待。breakout_on 为真，且 price、upper_prev、vol_ratio 三个都有值，且 price 大于 upper_prev，且 vol_ratio 不低于 vol_min，返回 breakout。新块的立场是看多，强弱是强，相位是「盘中开口向上」。任何一项不满足，原样返回。
4. 相位是开口向上。price、vwap、vol_ratio 三个都有值，且 price 不低于 vwap，且 vol_ratio 不低于 vol_min，返回 opened_ok，块不变。任何一项取不到或不满足，返回 opened_wait。取不到按等待处理而不是放行，因为这是入场的门，方向要保守。
时段判断复用 `app/core/reask_rules.py` 的 in_window。量比由调用方算，用 reask_rules.vol_ratio。单测要钉住是同一个函数对象，这是台账 003 三处同源的哨兵。
### 映射多带一个值
`tech_rules.synthesize` 的 base 加 boll_upper。`tech_service._compact` 加 boll_upper。收口突破要拿昨日上轨，从映射里取，不再回库。
### 接线
在 `proposal_service._attach_consensus` 里，每只候选装配完四块之后加一段。开关 PMS_TECH_INTRADAY_CONFIRM 关掉时整段不执行。
1. 相位不在收口等待与开口向上之内，跳过。
2. 取读数：price 与 vwap 来自 market.day_snapshot，vol_ratio 用与 reask_service 相同的算法，upper_prev 来自技术面块的 boll_upper。本轮用一个字典缓存，同一只票不取两次。任何取数失败按取不到，传 None。
3. 调 intraday_confirm。
4. 结果是 breakout：把新块写回 blocks["tech"]，用新立场重新调 consensus.decide，更新 blocks["consensus"]、c["consensus"]、硬数字六键。硬数字的 tech 块里加 intraday 一键记 reads 与 kind。
5. 结果是 opened_wait 或 outside_window：把 c["consensus"]["route"] 改成观察，route_reason 写 why，另加 disp 键为 wait_confirm。
6. 结果是 opened_ok：只在硬数字的 tech 块里记 intraday。
`_scan_open` 与 `_attach_consensus` 都要多接一个 now 参数，从 scan_and_route 传下来。
### 处置词
`action_engine` 加常量 DISP_WAIT_CONFIRM 为 wait_confirm。scan_open 里路由为观察时，con 带 disp 就用它，否则用 wait_tech。
页面 dispOf 加一行：wait_confirm 显示「等盘中确认」，样式与在盯那一档相同。页面文案守卫若登记了处置词枚举，补这一项。
### 参数登记
四个参数登记进 param_store 的 RUNTIME_EXTRA 与范围表。PMS_TECH_VOL_CONFIRM 范围 0.5 到 10。PMS_TECH_INTRADAY_WINDOW 的校验照 PMS_OPEN_REASK_WINDOW 的写法。
### 观察读数
open_breakout 每天零到三只。open_wait_confirm 每天零到十只。突破超过五只说明太松。这两条写进台账 012。
## 附录丙（可不读）：页面收尾包的接口字段
### 单票研究面接口
`GET /api/research/{ts_code}` 的返回结构改成六块。
| 键 | 内容 | 来源 |
|---|---|---|
| company | 质地档、估值、十视角计数、三类、硬疑点、报告日龄、报告链接、评析摘要 | 持仓票从逻辑状态映射取 company_review。候选票从当日计划的主榜与观察档取。都没有就是空 |
| fund | fund_rules 的结果块 | 用 company 算 |
| tech | 现有的技术面块 | 不变 |
| timing | 立场、昨夜定性、结论日期、盘中转多时刻 | consensus_service.nightly_map 取一只。转多时刻点击时不回扫，留空 |
| consensus | consensus.decide 的结果 | 用上面三票算 |
| sources | 每一路的状态：ok、无读数、或错误文字 | 逐路标 |
页面单票抽屉那一节标题改成「研究面 · 三源合议」。四枚芯片依次是基本面、技术面、择时、合议。每枚芯片悬停显示一句理由。芯片下面保留现有的三个指标块。有报告链接就显示「评析报告」。
### 候选栏
候选处置快照的每行加三小块：fund 带立场与质地档，tech 带立场与相位，consensus 带方向与路由。数据从 out["consensus_seen"] 来。页面每行加两枚芯片，颜色沿用 techStanceCls 与 propCompanyTag。
### 管理视图持仓总览
加一列研究面，内容与我的持仓那一列相同，用同一个渲染函数。
## 附录丁（可不读）：加固包的改动点
### 去重集清除条件
`app/services/proposal_service.py` 第 150 到 154 行，把「SAR 方向是空才保留」改成「SAR 方向明确是多才清除」。
```python
params["tech_exit_done"] = {c for c in _done
if (_tech_states.get(c) or {}).get("sar_side") != "多"}
```
第三十批加三例。映射里没有这只票则保留。明确为多则清除。明确为空则保留。
### 持仓行的转多留痕
decorate_positions 的 flip_map 由调用方传入。来源与候选相同，就是信号消化写在候选行上的当日转多时刻。持仓行没有这个字段时，按持仓代码从同一来源取。第二十八批加一例：持仓行昨夜中性、当日转多，择时票升为看多。
### 弱表态开关
consensus.decide 加参数 weak_confirm，默认真。_route 里「只有一方表态」那一行，weak_confirm 为真返回交人，为假返回放行。consensus_service._params 读 PMS_CONSENSUS_WEAK_CONFIRM 并传入。第二十八批加两例：开着交人，关着放行。
### 第二十四批用例
把 `_today_ms(9, 35)` 改成「当前时刻减十分钟」。断言里的时刻字符串从那个时间戳算，不写死 09:35。
## 附录戊（可不读）：选股打分包的规格
仓库是 akg-factor-bridge，文件是 `plan.py`。
1. 装配阶段已经读到评析字典。对主榜与观察档的每一行算质地调整分：质地好加 8，差减 8，其余 0。
2. 分数编码是主榜等于 200 加传导档位乘 20 加组内分，组内分夹在正负 9.9 之间。加 8 后最大 17.9，仍小于档步长 20，先档后分的次序不破。
3. 主榜与观察档按调整分重排并重编名次。原分数保留在 score 字段供档位解码。新字段 score_adj 进接口与快照。
4. 不动因子表。不在每早 07:10 的因子构建里读数据基座库。判决收敛仍只降不升。
5. 环境变量 PLAN_QUALITY_BONUS，默认 8，设为 0 即关。
6. 新测试文件 test_plan_quality_rank.py，守四条不变式。加分从不跨档。加分为 0 时次序与原来逐字相同。重编后名次连续。快照带 score_adj。
7. 台账记到选股系统第 058 条。
8. 部署：代码与自测本地做完并提交。155 上拉代码后重启桥容器，先经审批，避开 07:10。
顺带守一条既有不变式：POOL_TOP 不低于 PMS_PLAN_TOP_N。决策系统的夜间分析池从这份排名取前 50，质地进了排序，好公司才进得了分析池，择时那一票的覆盖才会上来。
## 附录己（可不读）：真实仓初始参数清单与自检脚本
### 清单
进阶段 B 之前必须是这些值。写进台账 014。
| 键 | 值 | 为什么 |
|---|---|---|
| PMS_DISPATCH_MODE | shadow | 影子期先不写下游 |
| PMS_AUTONOMY | propose_only | 持仓自主动作交人 |
| PMS_OPEN_AUTONOMY | off | 新建仓关 |
| PMS_TECH_EXIT_AUTONOMY | propose_only | 转空离场交人，不自动卖 |
| PMS_STRATEGY_ENABLED | false | 策略层关 |
| PMS_LOGIC_DOUBT_TRIM | false | 研究走弱减持关 |
| PMS_OPEN_REASK_ENABLED | false | 新建仓关着时无意义，明确关掉免误读 |
| PMS_CONSENSUS_ROUTE | true | 合议只拦不放，开着更保守 |
| PMS_TECH_GATE_INCREASE | true | 增持门只拦不放 |
| PMS_PLAN_RANK_BY_QUALITY | true | 排序无副作用 |
| PMS_TECH_ENABLED | true | 前提是接口根地址指向 188 的决策系统 |
| PMS_FUND_REQUIRED | true | 无评析不建仓 |
| PMS_TOTAL_SCALE | 按真实资金 | 与账户实际资金要对得上 |
### 脚本
`scripts/real_init_params.py`。
1. --check 只读。打印表名前缀，再打印一张对照表：键、期望值、当前值、符合或偏差。有偏差退出码为 1。
2. --apply 写入，必须同时带 --yes。写之前再打印一遍对照表。
3. 表名前缀不是 real_ 时拒绝执行，除非带 --allow-sim。这是防止在模拟仓上误跑。
4. Makefile 加目标 real-params-check。
单测三例。对照表算对。前缀为空时拒绝。有偏差时退出码为 1。
## 附录庚（可不读）：真实仓 188 追平差异清单
按开发机上 51bd6dc 到 969d189 的差异统计。
| 项目 | 差异 |
|---|---|
| 提交 | 落后 69 个 |
| 表 | 多两张：pms_nav_daily、pms_tech_daily。观察读数包之后再多一张 pms_consensus_stat |
| 调度位 | 多两个：06:30 tech_pull、15:20 nav_snapshot。188 阶段 A 不起调度器，暂不生效 |
| 参数 | 多四十多个键。默认值按模拟仓定，见附录己的清单 |
| 页面 | 登录与两角色不变。提议卡重构、研究面、合议行都是新的 |
| 接口 | 多技术面状态、手动拉取、单票研究面、按代码回扫信号四个 |
追平步骤，全部先经审批。
1. 按真实仓部署方案阶段 A 把 ws 协议判收完。
2. 在 188 拉代码到最新。
3. 用 ws 剖面重建容器，建表自动带 real_ 前缀。输出必须出现「表名前缀 real_ 生效」。
4. 跑 real_init_params.py --check，全部符合才继续。
5. 按真实仓部署方案阶段 B 进影子期。
## 附录辛（可不读）：哨兵同步与登记清单
改了对应的东西就得回到这里改断言，断言不动就是漏了。
| 哨兵 | 位置 | 本阶段要改什么 |
|---|---|---|
| DDL 表数 | scripts/test_batch6_units.py 约第 593 行 | 20 改 21 |
| 批次登记 | scripts/run_tests.py 的 SUITES 与例数表 | 加第三十一、三十二、三十三批，改总数 |
| 软失败函数 | scripts/test_batch10_units.py 顶部 SOFT_FAIL | 加 consensus_stats.record_round |
| 死参数名单 | scripts/test_batch10_units.py 的 KNOWN_DEAD | 不变。六个新参数都要有读取处 |
| 桩签名比对 | scripts/test_batch10_units.py 用例 M1 | 不改 pms_repo 签名就不用动。新仓库是独立文件 |
| 路由清单 | scripts/test_wiring.py 的 need 列表 | 不加新路由就不动 |
| 页面枚举名单 | scripts/test_page_enum_guard.py 的 ENUM_FIELDS | 处置词若在名单里，加 wait_confirm |
| 动作求值器次序 | scripts/test_batch12_units.py | 不变 |
| 密钥名单 | 两处 | 不变 |
新批次与例数估计。
| 批次 | 内容 | 例数 |
|---|---|---|
| 第三十一批 | 观察读数包：标签只在开关开着时出现；四种路由各打对应标签；增持门三种拦截打标签；归类落表；检查点窗口；转空实弹随时写；试算不写；upsert 用 VALUES 列；单表；映射重建记无读数与覆盖；复核脚本聚合；合议与人工裁决比对；参数登记与校验；日报小节失败不拖垮 | 约 14 |
| 第三十二批 | 盘中确认包：时段边界四点；收口突破要价与量同时满足；开口确认要均价与量；取不到按等待；突破开关关掉不升；总闸关掉时候选的合议块 JSON 逐字相同；接线后路由从观察变放行；开口未确认进观察带处置词；硬数字带 intraday；量比同源哨兵；映射带上轨；参数登记与范围 | 约 16 |
| 第三十三批 | 页面收尾包：研究面接口持仓票、候选票、都没有三情形；来源逐路标明；处置快照带三小块；页面守卫 | 约 6 |
| 第三十批加 | 去重集三例 | 3 |
| 第二十八批加 | 转多留痕一例、弱表态开关两例 | 3 |
| 第二十四批改 | 时钟用例改相对时刻 | 0 |
合计新增约四十二例，总数约 862。以实跑为准，例数表按实跑校正。