复盘月度故障共因并固化业务证据核验

This commit is contained in:
baobao 2026-11-18 09:29:52 +08:00
parent bf289f799f
commit 1cad2b37d7
20 changed files with 2856 additions and 0 deletions

View File

@ -0,0 +1,40 @@
---
name: pms-incident-review
description: 定位PMS及信号依赖的运行故障、重复返工或恢复验收,追溯业务约束并验证跨链路修复。普通文案、正常研究迭代和无故障的新功能不触发。
---
# 故障修复与恢复验收
授权和角色边界沿用根规则及本次会话。本技能不新增审批,也不授权上游写操作。先从[开发入口](../../../docs/开发入口.md)找到当前接续;历史镜像和过去的待办不代表今天的状态。
## 定义要恢复的业务能力
先用一句可验证的话说明受损能力和正确边界。例如“有效关注股应进入正式告警计算,但不因此取得建仓资格”,不能只写“补数据”或“服务恢复”。
区分当前用户决定、既定规则和实现事实。涉及预算、暂停、退出时,列出一项必须阻止的动作和一项仍应允许的动作,防止修复无意改变交易规则。有明确授权的正常动作不重复索要许可。
## 找到最早失效处及其影响
按需记录生产者、原始表或键、转换和缓存、最终消费者与输出。对每一项区分证券范围、数据时刻、计算时刻、有效日期、版本和单位。先从独立的应覆盖名单核对,再查实际输出,不能从“已有消息的股票”反推检查全集。
信号链路分别核对:进入监测、输入新鲜、历史资格与有效窗口、实际计算、触发或未触发、正式发布、消费应用。零条消息本身不能证明已计算。某一路无法计算,不得被其他来源的正常消息抵消。
保存最小可复查证据,保留检查机器和时点。找不到原始写入任务或生产日志时明确缺口,不把“表停更”直接归因为采集器故障。缓存文件存在不等于实际加载,源恢复不等于缓存和消费者恢复。
[业务证据核验工具](../../../docs/业务证据核验工具.md)可只读导出ITD历史准备、逐路核对并检查任务嵌套失败。该工具不核验实时信号全链路,不能据其READY给出全面恢复结论。
## 修复和验证共同约束
用`rg`追同一读数、状态或动作的全部调用方,包括旧入口、备用报价、缓存投影、页面和异步收取;不按文件改了多少判断范围完整。
按本次风险从[历史反例索引](references/failure-patterns.md)选择测试,不要求每次全跑所有场景。外部I/O可以用桩,实际入口、JSON编码、状态迁移和最终写入参数应保留。先证明反例能识别原故障,再验证修复后的正常路径、拒绝路径和恢复路径。已有合适回归直接复用,不复制测试凑数量。
对返回值检查到业务子结果;`ok=False`、非空errors、invalid或零影响行必须解释,调度成功不抵消它们。任务无报错但没有预期输出,仍属于未取得完成证据。
## 交付与复盘
部署时转用[pms-release](../pms-release/SKILL.md),QMT联调时转用[pms-qmt-diagnose](../pms-qmt-diagnose/SKILL.md),不为完成检查调用有副作用的tick或制造委托。
交付写清:直接触发原因、为什么原保护没拦住、为什么原验收没发现、预防措施对应的反例,以及仍缺的证据。区分代码修复、运行生效、自然场景判收。未判收项留下具体触发事件、读取位置和通过条件;不自动创建长期调度。
复盘中将功能需求变更、主动探索、候选阶段发现、上线后缺陷、实现偏离既定规则分别记账。cherry-pick、发布记录和回退预案不按故障次数重复计算。只把稳定且可验证的共性约束放入规则;机器能检查的优先落工具,不把运维责任转成交给交易员阅读的常驻说明。

View File

@ -0,0 +1,4 @@
interface:
display_name: "PMS故障修复复盘"
short_description: "从业务约束追溯信号和交易故障,核对完整链路并防止重复返工"
default_prompt: "使用 $pms-incident-review 定位本次故障,验证恢复边界,并将可预防的共因沉淀为回归或规则。"

View File

@ -0,0 +1,14 @@
# 按改动选择历史反例
本索引用于确定验证边界,不表示以下历史问题今天仍存在。完整因果分析见[月度复盘](../../../../docs/月度故障与返工根因复盘_2026-11-18.md)。测试通过也不替代自然判收。
| 改动触及 | 必须回答的边界问题 | 已有反例入口 |
| --- | --- | --- |
| 数据源、名单、计算缓存 | 某一路为0时其他来源能否掩盖?缺席证券是否仍在分母?文件被实际读取规则接受吗? | `scripts/test_business_evidence.py`;11月12日关注漏入告警池、11月16日资金分钟历史不足 |
| API、数据库输出、调度 | 实际调用入口和包装、Decimal/日期进入真实编码是否通过?嵌套失败是否被顶层吞掉? | `test_proposal_trader_view.py`、`test_execution_basis_decimal.py`、`test_batch57_units.py`、`test_business_evidence.py` |
| 委托、库存、预算 | 已成交未入账、撤单未确认、跨日和改参后,是否重复使用数量或预算?失败后意图还在吗? | `test_batch45_units.py`、`test_batch52_units.py`、`test_grid_execution.py`、`test_buy_budget.py`、`test_user_stop.py` |
| 技术读数或择时缓存 | 新旧调用方是否同口径?源数据更新或不可用恢复后能否重新计算?旧证据能否因刷新时间变新? | `test_proposal_trader_view.py`、`test_signal_recovery.py`、`test_timing_fusion.py`;11月16日代码审查的未修反例 |
| 资金或盈亏 | 可用余额是否已含回笼?负净成本、零值、费用未知是否保留真实含义? | `test_batch47_units.py`、`test_signal_recovery.py`、`test_cost_precision.py` |
| 页面判断与操作 | 同股列表与详情是否同一当前结论?信息变化与规则变化是否混淆?用户知道下一步且能完成吗? | 前端目录三道护栏及真实响应浏览器回放;11月5日接口包装、11月12日“当时未取得”返工 |
测试文件均位于仓库`scripts/`,通过`unit_test_guard.py`运行。新故障只按实际影响补缺口,不将表中所有检查强制套给无关改动。

View File

@ -27,6 +27,7 @@ docker run --rm --network none --cpus 1 --memory 512m --read-only --tmpfs /tmp:r
- 策略参数经ParamStore读写。版本、快照、目标数量与在手轮次需匹配;盘中改规则不倒填08:50冻结,不用旧版本快照执行新策略。接入档位遵循用户最新决定,不额外设置观察天数。
- 核验实际镜像、启动时间、配置、页面健康、自然调度和实际回执。交易链路还须检查连续确认、缺口、最新资金、在途、待入账及策略合计对账,不能只看容器运行或ONLINE。需要定位异常时再读[pms-qmt-diagnose](../pms-qmt-diagnose/SKILL.md)。
- 不注入虚假信号或测试委托制造验收。分开记录隔离回放、本地浏览器复现、真机实际发生与未判收;未出现自然切换就如实保留待办。
- 数据和任务链路按本次修复涉及的来源、证券及最终产出逐项判收,读取嵌套业务结果,不能用Celery成功或其他来源消息代替。可用[业务证据核验工具](../../../docs/业务证据核验工具.md)检查导出证据;历史准备通过不代表实时计算和消费通过。尚缺自然场景时在当前接续写出待观察的具体事件、读取位置及通过条件;不因此自动创建长期观察任务。
## 回退与交付

View File

@ -23,6 +23,12 @@
3. 按影响范围验证。单测必须隔离配置、禁止联网;部署前用候选镜像完成断网回归。页面改动跑三道护栏,布局与交互另做浏览器验收。纯文档修改检查内容和链接即可。
4. 在开发机修改,经Git提交后部署,提交说明用简短中文。交付说明改动、验证机器、实际结果和未完成事项。重要节点追加`DEVLOG.md`;当前状态写接续记录,注明核验时间。历史回执不等于当前健康,本地通过不等于真机判收。
## 故障修复与防止返工
- 修复前先写清违反的业务约束、规则来源和适用范围。错误实现不能成为新规则;补一个限制时,同时核对原来允许的动作仍然可达。
- 数据、信号或异步链路按应覆盖名单逐路判收,区分输入新鲜、具备计算资格、已计算未触发、无法计算、发布和消费。顶层成功、总消息数、其他来源正常不能替代本路证据。
- 修复须沿实际入口到最终保存或动作检查同一业务的其他调用方、缓存和版本,并以旧故障反例验证预防措施。线上故障定位、重复返工或恢复验收使用[pms-incident-review](.agents/skills/pms-incident-review/SKILL.md);不要求普通文案和研究试验走完整故障流程。
## 授权边界
- 按当前任务及会话已有授权推进,不因旧文档或技能重复索要许可。当前155模拟PMS的必要服务器、容器、数据库操作及PMS重启已获授权;不扩展为宿主机重启、新的破坏性清账或其他系统的写操作。

View File

@ -1,5 +1,15 @@
# 开发节点记录(三系统量化交易)
## 2026年11月18日 月度故障共因复盘与预防工具
按用户要求回看10月18日至今PMS及ITD、bionic、选股桥的422条本地提交记录,按问题族区分Bug、实施偏离、正常需求变化、候选返修和相同补丁重复提交。结论和具体因果链见[月度复盘](docs/月度故障与返工根因复盘_2026-11-18.md),没有把回退预案统计为生产回滚。
09:09在188上游只读确认三股`judge.stock_flow_data`末日已到11月17日;09:15对当时14只分钟准备名单用实际缓存校验入口重建,三路历史准备均14/14。日资金主文件为空但单票准备缓存有效,不能误报整路失败;盘前准备通过不代替盘中告警和消费。证据保存在`docs/evidence/*20261118.json`。
新增三条根规则、真实边界测试规则、`pms-incident-review`技能及只读采集/自动核验工具,补充发布技能的逐路和嵌套业务判收。21例工具回归已接入全量入口;最终版本开发机90组隔离禁网全量通过,包含工具21例专项,Skill格式通过。11月16日两组原始失败反例均被判FAILED;恢复快照通过;仅内存注入一股资金不足即被拦截。
本轮仅开发机规则、技能、文档和运维工具变更;未发布应用、改参数、补数据、触发业务任务或建立定时观察。188真实PMS未访问。独立分支`codex/recurrence-prevention-20261118`保留其他工作树修改;具体未完成运行项及关闭条件见复盘末节。
## 2026年11月16日14:18 技术读数保存修复发布155
按用户明确授权推送既有整改文档,进一步核验发现13:54自然提议任务的内部保存错误。代码`28abddf`已推送,并于14:14:45仅重建155 web与worker;交易规则与参数不变。开发机专项21项、全量88组,155候选web 88组、worker 87组断网回归通过。排空与再核对完成后切换,其他28容器和唯一WS不变,私有配置、环境和挂载保留。

View File

@ -0,0 +1,82 @@
{
"method": "offline original code-probe replay and explicitly labelled fault injection; no production writes",
"snapshot_file": "itd_preparation_verified_20261118.json",
"snapshot_sha256": "2d118404915436f52553f192c60e507b55016049e21136aa37308679d1b18ccb",
"original_code_probes": {
"fusion_nested_failure": {
"status": "FAILED",
"failure_paths": [
"$.timing_fusion.invalid",
"$.timing_fusion.source_errors"
],
"limit": "无显式失败不等于业务完成;仍须核对预期输出、覆盖与自然回执。"
},
"all_sources_failed": {
"status": "FAILED",
"failure_paths": [
"$.sources.alerts",
"$.sources.intraday",
"$.sources.metrics",
"$.sources.mr",
"$.sources.sell_actions"
],
"limit": "无显式失败不等于业务完成;仍须核对预期输出、覆盖与自然回执。"
}
},
"actual_preparation_snapshot": {
"status": "READY",
"scope": "historical_preparation_only",
"day": "2026-11-18",
"issues": [],
"lanes": {
"minute_archive": {
"expected": 14,
"ready": 14,
"unready": {}
},
"minute_fund": {
"expected": 14,
"ready": 14,
"unready": {}
},
"daily_fund": {
"expected": 14,
"ready": 14,
"unready": {}
}
},
"limit": "只读重建的历史准备资格;未验证进程内存、当日实时输入、实际计算、发布和消费。"
},
"fault_injection_only": {
"change": "one code history days 34 -> 13 and effective moneyflow minutes 240 -> 0; other lanes unchanged",
"verdict": {
"status": "INCOMPLETE",
"scope": "historical_preparation_only",
"day": "2026-11-18",
"issues": [],
"lanes": {
"minute_archive": {
"expected": 14,
"ready": 14,
"unready": {}
},
"minute_fund": {
"expected": 14,
"ready": 13,
"unready": {
"300133.SZ": [
"history_days_below_30",
"effective_money_flow_minutes_below_200"
]
}
},
"daily_fund": {
"expected": 14,
"ready": 14,
"unready": {}
}
},
"limit": "只读重建的历史准备资格;未验证进程内存、当日实时输入、实际计算、发布和消费。"
}
}
}

View File

@ -0,0 +1,32 @@
{
"at": "2026-11-18T09:09:28.146670+08:00",
"method": "read-only docker exec intraday_alerts; Mongo projection code,data.date max_time_ms=3000; three HS samples only",
"host": "tlaipro",
"container": "intraday_alerts",
"image": "intraday_timing:funds-alerts-f5a02b7",
"source": "192.168.18.75:27017/judge.stock_flow_data",
"samples": {
"300133.SZ": {
"documents": 1,
"dates": 112,
"first": "2026-06-03",
"last": "2026-11-17",
"new_dates_after_oct14": 24
},
"002979.SZ": {
"documents": 1,
"dates": 112,
"first": "2026-06-03",
"last": "2026-11-17",
"new_dates_after_oct14": 24
},
"601126.SH": {
"documents": 1,
"dates": 112,
"first": "2026-06-03",
"last": "2026-11-17",
"new_dates_after_oct14": 24
}
},
"limitation": "raw dates only; no claim all monitored stocks or intraday publication verified; writer root cause not established"
}

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,14 @@
{
"machine": "development macOS",
"python": "3.12",
"isolation": "scripts/unit_test_guard.py; config cleared, empty cwd, sockets blocked",
"full_suites": 90,
"full_result": "ALL SUITES PASS",
"full_log_sha256": "7831816009073221e9ff8fa68bd2d494ef0212490298b7e92b5a80873e97c4ba",
"final_tool_tests": 21,
"final_tool_result": "OK",
"skill_validation": "Skill is valid!",
"documentation_links": "8 affected rule/skill/entry/report files checked; no missing local links",
"runtime_collector": "188 intraday_alerts read-only, 2026-11-18T09:27:40.257085+08:00; collection_errors empty; three historical lanes 14/14",
"note": "No app runtime changes, deployment or scheduled automation"
}

View File

@ -0,0 +1,50 @@
# 业务证据核验工具
这组工具用于修复验收,防止“其他来源有消息”“任务成功”掩盖本路失效。它们不写业务状态、不发消息、不调用模型、不补算或交易;当前没有安装定时调度。
## ITD历史准备
在已获只读授权的ITD容器中通过stdin执行仓库`scripts/collect_itd_preparation.py`,stdout保存到开发机。实际主机、端口和容器先核对;以下是本次授权范围的调用方式,不构成未来授权:
```bash
ssh -o BatchMode=yes -o ConnectTimeout=8 -p 2280 tlai@192.168.16.188 \
'docker exec -i intraday_alerts python -' \
< scripts/collect_itd_preparation.py > /tmp/itd-preparation.json
python3 scripts/check_business_evidence.py preparation /tmp/itd-preparation.json
```
采集只读分钟服务的独立应覆盖名单、当日准备状态和基线文件,复用ITD的`load_prepared`验证版本、配置及证券身份。它在独立进程内重建缓存,不读取告警进程的内存,也不访问Mongo/MySQL/Redis。采集失败退出2,不能用旧文件冒充本次结果。
判定按沪深股票逐路输出应有数、就绪数和缺口。分钟量价要求有效成交额分钟至少200、QRS分钟至少180;分钟资金要求历史至少30天、有效分钟至少200;日资金要求至少30天并存在接纳后的基线。这些阈值对应ITD `intake_preparation.HistoryBuilder` 的准备资格,样本数和标准差的判断复用当前配置与统计字段。上游资格规则或缓存协议变动后应同步此适配器;它不另定交易阈值。
`READY`仅表示**该份名单的历史准备层**通过,不能提升为全市场、全部告警股票或实时信号恢复。输出必须同时报告名单规模和采集时间。空名单、缺股、过期/未来证据、缓存拒绝或某一路不足都不能通过。默认按当前时间核验,证据和名单时间有效300秒;这是取证有效期,不是行情或交易容忍时间。
当日原始资金、实际计算、发布和消费仍须分别取证。盘前名单可能只有持仓及关注;开盘后扩池应重新采集,不以盘前14只代替此前129只告警池。历史准备允许的少量缺失分钟也不能证明某一具体交易分钟可计算。
## 任务业务子结果
将自然任务的完整业务返回值导出为JSON,保留嵌套结构后运行:
```bash
python3 scripts/check_business_evidence.py task /tmp/task-result.json
```
工具递归定位`ok/success=false`、非空`error/errors/invalid/failed`、以`_error/_errors`结尾的失败字段、`sources`下明确的false和明确失败status;顶层成功不能抵消它们。只输出字段路径,不输出错误正文。日志必须先核对为该次自然任务的完整返回值;不要用字符串摘要、被截断的日志或任意历史JSON冒充当前完整回执。
无显式失败返回`NO_REPORTED_FAILURE`,**不返回业务完成**。空结果为`INCOMPLETE`;没有预期输出仍需查名单、跳过原因和依赖。未计算、中性和未触发的区别不能仅从这个通用检查器推断。
## 退出码、重放和回归
- 0:历史准备层通过,或任务没有显式失败;含义由status与scope限定。
- 1:发现失败或证据不完整。
- 2:输入格式错误或采集失败。
历史证据用`--at '2026-11-18T09:15:30.370554+08:00'`在原时点重放,不能将此参数用于宣称当前健康。工具不修改输入,重复运行结果一致。文件、日期和字段类型不符合契约时必须失败。
开发机回归通过隔离入口执行;该专项已登记全量入口:
```bash
python scripts/unit_test_guard.py scripts/test_business_evidence.py
```
21例覆盖资金空而其他来源正常、应有证券缺席、样本不足、旧/未来证据、无效缓存、日资金缺失、嵌套失败、全部来源失败、空结果、无信号不冒充完成、输出脱敏和CLI退出码。另用11月18日188真实只读文件验证采集适配器,结果见[月度复盘](月度故障与返工根因复盘_2026-11-18.md)。

View File

@ -1,5 +1,7 @@
# 开发资料入口
11月18日最新:[近一个月故障与返工根因复盘](月度故障与返工根因复盘_2026-11-18.md)。已只读确认三股原始分钟资金历史补到11月17日,盘前14只分钟准备名单三路历史资格通过;不代表129只盘中告警池及自然发布消费已判收。复盘归并四类共因,新增[故障修复Skill](../.agents/skills/pms-incident-review/SKILL.md)和[业务证据核验工具](业务证据核验工具.md),保留明确的待闭环项。下方11月16日、17日的历史停更描述属于当时证据,不能继续当成当前原始数据状态。
11月16日资金监测最新整改见[漏检复盘与交易员提示](资金监测漏检复盘与交易员提示整改_2026-11-16.md):15:56已完成实时源切换;16:31仅发布155web的4814f9a,撤下历史准备常驻说明,保留内部诊断。16:32实际接口和对账正常,其他29容器不变。历史资金停更与自然告警验收仍需闭环。此前名称刷新修复保留。
11月16日14:14:45已按授权推送整改并发布155 web与worker的[技术读数保存修复](技术读数保存修复与发布_2026-11-16.md)。修复盘中核验发现的新提议与当日复核JSON保存错误;交易规则、参数及其他28容器不变。开发机88组、候选web 88组和worker 87组断网通过,14:18自然保存与运行核验完成。整体合理性分析仍属待讨论方案,下一步先与用户讨论,不自动转成策略实现;当前状态见[整改接续](交易计划与风险约束整改接续_2026-11-16.md)。
@ -56,6 +58,7 @@
| 任务 | 入口 |
| --- | --- |
| 运行故障、重复返工、数据恢复验收 | [pms-incident-review](../.agents/skills/pms-incident-review/SKILL.md);[月度共因复盘](月度故障与返工根因复盘_2026-11-18.md);[只读取证和自动判定](业务证据核验工具.md)。普通文案和正常研究迭代不触发完整故障流程 |
| 系统运行、逐路信号可用性与监控盲区 | [问题链路与数据位置](系统问题链路与数据位置细化_2026-11-17.md),明确表、Redis键、文件、消费者及最新补充状态;[全面检查与整改接续](系统全面检查与整改接续_2026-11-16.md)保留129只资金历史、技术新旧口径、行情完整性、任务子结果、时钟及155账本的当次实证;检查完成不等于问题已修复 |
| 选股到交易计划的预算、网格与退出整改 | [整改规格与验收用例](交易计划与风险约束整改规格_2026-11-16.md);[当前进展与未完成项](交易计划与风险约束整改接续_2026-11-16.md) |
| 持仓盈亏口径、雷赛综合盈亏空值与负成本截断 | [11月9日14:25只读核验](持仓盈亏与零成本边界核验_2026-11-09.md),已确认自然减仓及少计利润,计算修复尚未实施 |

View File

@ -0,0 +1,113 @@
# 近一个月故障、返工与重复修改的根因复盘
核验日期:2026年11月18日,北京时间。范围为2026年10月18日至本次取证时点的PMS及直接依赖ITD、bionic、选股桥。本次只读核对188上游,未访问188真实PMS,未改运行参数、源数据、服务或交易。本报告中的历史故障不是对今天运行状态的统一断言。
## 结论
这些问题存在共同根因:**业务约束没有完整地成为跨模块的输入、状态、输出和验收契约;修改与验证常停在局部入口,局部成功又被用来代表整条业务能力恢复。** 因而同一约束在另一个缓存、任务、页面或执行分支中再次失效。
这不是简单的“测试数量不足”。本月多次在数十组断网回归通过后仍发现真实边界问题;已有测试甚至曾断言错误的资金口径。增加相同假设下的测试不能纠正假设。也不能把所有问题归为这一个原因:外部资金原始写入为何停止、QMT某些缺失序号的原始报文,目前证据不足,不能虚构技术根因。
本次将稳定约束落入三条根规则、一条测试边界规则和一个故障修复Skill;实现可运行的只读取证及自动判定工具,用历史反例和恢复后的真实文件验证。没有把所有历史业务缺陷混入本次整改,也没有把新增文档当作运行系统已经具备持续监控。
## 复盘方法与证据范围
查阅本地全部引用中落在时间窗口内的提交标题,再按故障链追查相关差异、当日接续、实际回执和已有回归。清单为PMS 304条、ITD 19条、bionic 55条、选股桥44条,共422条提交记录。完整索引见[提交清单](evidence/monthly_commit_inventory_20261118.json)。这是本地可得记录,不是全部远程仓库审计,也不是422次事故。
已用稳定patch-id核对:`64af252/c725569`、`934d46f/5b75ade`、`47f5621/39d209a`各是一份相同补丁的不同提交,不能重复计为修复。发布回执、交接副本、研究方案调整也不按Bug计算。本报告按问题族归并,不用缺乏可靠工时和事故编号的数据计算“返工率”。
优先使用具体提交和运行回执,规则与历史解释发生冲突时回到当时有效的用户决定。保留原始历史,不以今天恢复后的数据改写过去。未额外读取、补齐或研究北交所数据。
## 从业务本质推导需要守住什么
交易系统首先要忠实执行授权,其次才是生成更多信号。一个动作有依据,要求相关事实属于正确对象和时点、必要输入足够计算、判断适用于当前规则、动作只发生一次且被真实账本承认。服务存活、消息存在或函数正常返回,只是这些条件中的一小部分。
系统异步运行,成交、入账、取消确认和源数据到达不会同时发生。因此“尚未入账”不等于“尚未成交”,“已发出”不等于“已完成”,“旧结果可读”不等于“当前仍有效”。持久化意图、真实事实和展示投影必须各有身份与有效期。
交易员通过产品作决策,需要的是当前判断、限制和可采取的动作。内部历史缺数、某次读缓存失败或运维处理过程,不能取代业务结论,更不能成为要求交易员自行排障的理由。
由此得到四类可验证的共性根因:
| 共因 | 本月反复出现的机制 | 为什么原保护和验收没有挡住 | 对应预防 |
| --- | --- | --- | --- |
| 完成标准没有贯穿依赖链 | 有数据行、能读旧批次、Celery成功、其他路有消息,被用于判断本路完成 | 缺独立应覆盖名单、目标日期、逐来源计算资格与最终产出;无触发和不能计算都沉默 | 按来源和证券核对输入、计算、发布、消费;自动暴露嵌套失败;取证结论保留层次 |
| 同一业务语义分散实现 | 资金重复加回笼;技术面新旧读法并存;关注研究与告警名单分离;网格核销与库存顺序不同 | 修复围绕当前文件或截图展开,没有枚举所有消费者与状态投影 | 修复前定义业务约束,沿调用方核对;复用同一账本或事实入口,不新增平行判断 |
| 时间、身份与恢复状态不完整 | 迟到成交被重复使用额度;跨日缓存不失效;数据恢复后任务不恢复;改参后旧库存被当新档位 | 测试主要覆盖同步首次成功,失败后重试、跨日、部分完成和版本变化缺少组合验证 | 按影响选择乱序、重放、恢复与跨版本反例;不能以刷新时间延长原事实有效期 |
| 验证模型偏离真实使用边界 | API包装层漏读、Decimal无法保存、调度入口缺导入、页面“当时未取得”反复返工 | 桩把关键包装/类型替换掉;只测服务函数和字段,未经过实际入口、输出编码或交易员任务 | 保留真实边界、只替换外部I/O;验证旧反例能失败;同时验证原允许路径仍可达 |
“要更仔细”不能操作化。每项预防都必须回答:它会阻止哪一个已发生的反例,放过哪个正常场景,在哪里执行,由什么证据证明。
## 具体问题族与因果链
以下“历史结果”仅代表对应记录时点。提交短号可在相应仓库核查。
| 问题族与证据 | 直接触发、返工或遗漏 | 共同原因及可提前阻止的检查 | 历史结果或边界 |
| --- | --- | --- | --- |
| 10月19日买卖冲突,PMS `fad1bb1 → 28053f3`,DEVLOG对应两轮发布 | 科士达旧建仓与清仓同时活跃;首次修复后又发现人工清仓在T+1无可卖量时不留任务 | 将“当前能卖”与“清仓意图存在”混同;应同时验证跨轮停止旧买入和不可卖时的持久意图 | 第二轮修复发布;不能把首轮24项以外的未测场景算已验 |
| 10月20日至21日提议确认,`0acf7b8、1df17e6、984e3d7、888a208` | 完整准备移出人工确认;随后补逐票快速核验、原子保存、重复确认幂等以及原数量可执行时不改承诺 | “最新数据”和“用户已经确认的内容”边界需明确,不能让刷新不断重新确认 | 包含正常产品演进与缺失边界补齐,不能全部归为Bug |
| 10月26日重复下发,`47bcea5`,DEVLOG“钧达股份成本口径与父指令重复下发” | 目标卖600股发出两笔600股;执行先于成交回放,父指令入账量尚未更新 | 将账本投影的暂时滞后当成可用额度;旧码反例13项失败,证明入口级测试能够提前拦住 | 修复综合出口累计成交、入账和未终态预留,不靠删账解决 |
| 10月26日账户资金,`f90d5e7`,[资金口径核查](账户资金口径核查_2026-10-26.md) | QMT可用已含卖出回笼,PMS再次相加;原测试桩还断言错误公式 | 权威字段含义没有落实为统一入口,测试与实现共用同一错误假设 | 修正入口、协议说明及桩;数量对账正确不能证明资金口径正确 |
| 10月27日QMT周期拒绝,DEVLOG同日联调记录 | 连接在线但出现拒绝与序号缺口;地址切换、补发时间与原事件时间容易混淆 | 连通性与连续确认、签名有效性不是一回事;必须核原报文及产生时间 | 当日QMT修改后取得连续135条证据;部分旧缺号内容仍未知,不编造归属 |
| 10月28日轮换,`316d31d` | 隔离演练发现撤单失败会回滚退出决定,零持仓也可能早于下游委托收尾 | 意图与外部动作处于错误事务边界,失败恢复没有独立持久状态 | 候选阶段发现并补修,是有效预防的正例;不是线上已发事故 |
| 10月30日当日限价,`64af252、2eaec70 → 47f5621`,[边界记录](限价单有效期与撤单成交边界_2026-10-30.md) | 改为当日有效后,15:00:16又生成截止15:00的续单,随后本地作废 | 新有效期与旧交易时段包含端点的语义不一致;应覆盖截止前、等于和之后 | 补两处截止检查;未发到QMT,不写成误成交 |
| 10月19日、11月5日、11月11日计划过期,桥 `ef873bb → 475bfec → 9f8224e`,PMS `e4bb782、41fb434` | 缺热度/传导时阻断正确,但源恢复后缺有限恢复;新就绪查询又因历史全表扫描返修 | 只设计失败保护,没有恢复转移;小桩不暴露生产查询规模 | 已加有界恢复和日期范围;重复源迟到不等于同一补丁失效 |
| 11月2日红利研究,`7fcae67、a7d1d55` | 旧“压力”标签被用于新策略方向;一般风险披露被解释成已发生风险 | 输出能解析、原文有词并不证明单位正确、因果成立或结论可跟踪 | 撤回旧标签推演,从原事实重建;属于研究产品验收纠偏,非运行代码回滚 |
| 11月3日真实调度入口,`9bc94eb → 56db0fd` | 服务函数已有测试,调度器实际调用时缺`param_store`导入 | 测到函数能力,未测实际接线 | 增加真实Celery任务入口测试;保留外围桩而不替换入口 |
| 11月3日至12日人工关注,PMS `bf5e3ed、6fddc50、71f8278`,bionic `963196a、a689c8f、4700ff5` | 先解决登记/研究,随后发现恢复、合法JSON、榜单截断和正式告警覆盖分别缺失;11月12日9只关注中8只未入ITD告警池 | 把研究池、交易候选、行情池、正式告警池当作同一“覆盖”;端到端角色没有明确分开 | 逐环节补齐;“关注即下单”从未被授权;缺券商或缺评析豁免的后续用户决定属于规则调整 |
| 11月4日导出费用,`484aa2a → f50449d → 017ead5` | 金额精度处理后仍需修手续费/退款方向及表格舍入口径 | 数值可格式化不等于会计语义、符号和外部成品一致 | 应用同一真实账例贯穿数据、公式和导出,不只比显示小数位 |
| 11月4日至5日信号页面,`34087b5 → 67b0277 → e672781 → e4a7424` | 多轮恢复原单行信息流及真实研究展示 | 界面实现偏离既有交易员任务与确认原型;并非每次都需要新标签或新分区 | 归为可避免的产品返工;布局、信息密度和操作任务需一并验收 |
| 11月5日ETF入口,`f6cf445 → 6c10116` | 页面把统一`{ok,data}`外层当成业务状态,真实接口有数据却展示不可用 | 测试响应没有穿过真实包装边界 | 用真实包装的只读响应回放即可提前发现 |
| 11月9日至16日网格,`2d673b0 → 5c30373 → 0ea114f`,[网格接续](网格档距与成交余量修复_2026-11-09.md) | 发指令就移除库存导致余量漏卖;补实际库存后又发现多批核销、零散成交、旧报价分支及改参后同价重复准入 | 多处各自解释库存、价格与完成;首次真机单批样本不能覆盖多批及版本变化 | 4%是用户决定;余量、核销和跨参数准入是缺陷修复,不能混计 |
| 11月9日至10日负净成本,`50b4dcd → 6fddc50` | 雷赛减仓后成本收回,旧逻辑截负值为零再存空,金额少计1968元 | 将不适合计算比例的分母误当利润不存在;状态压缩损失业务含义 | 保留真实金额,收益率说明不适用;未知费用不补零 |
| 11月11日ITD日线缓存,`2463a2e` | QRS跨日仍用旧日线,刷新时间可能掩盖事实日期 | 缓存生命周期没有绑定业务日,证据时间与发布时间混用 | 修复跨日失效及保留原证据时间;分钟缺口是另一问题 |
| 11月11日分钟缓存候选,ITD `5017bf1 → 2b9f96b` | 候选启动缺requests,临时Compose挂载YAML解析失败 | 本机环境不等于最终容器环境;候选入口和实际配置解析需要执行验证 | 在旧消费者切换前修正,属于候选阶段拦截;不计为生产回滚 |
| 11月12日提议页面至11月16日保存,`60440ad → 4d9818b → e4a77bf → 28abddf`,[保存故障](技术读数保存修复与发布_2026-11-16.md) | 先补标签与“当时未取得”,再发现应展示当前判断;统一读数后真实Decimal使8条新提议和1条复核保存失败 | 产品验收只看字段;边界桩过度简化;Celery成功遮蔽保存错误 | 真实JSON保存反例已补;11月16日审查另发现旧技术映射消费者,不能说所有路径已统一 |
| 11月12日至18日分钟资金,ITD `8ee1dd0、a217dac、25f199a、89b8424、f5a02b7`,[数据链路细化](系统问题链路与数据位置细化_2026-11-17.md) | 先保护过期拒发,实时副本仍旧;切到214后历史分钟资金仍不足;秒时间与已结算分钟又需对齐 | 修覆盖、实时和历史分别止于局部,缺逐路计算资格验收;其他信号掩盖资金失效 | 今天原始历史及当前准备名单已恢复,详见下节;原始写入者停更原因未证实 |
| 11月16日试探预算,`6c5afe2 → 35838b8、7c60cdc`,[规则纠偏](建平仓规则对齐与人工止损验收_2026-11-16.md) | 将本次OPEN预算保护扩成整轮新增禁令,阻断原可独立审批的后续策略 | 把“更保守”当成合法替代规则,未检验允许路径 | 明确是实施错误扩大约束,已纠正;必须同时验证不越原预算和后续合法动作可达 |
| 11月16日系统审查,[代码反例](系统全面检查代码审查_2026-11-16.md) | 嵌套业务失败未进入总状态;技术分页可混版本;旧不可用研判可复用;稀疏分钟被跨度当完整;Redis时钟影响时效判断 | 部分成功、暂时不可用、完整性与时钟分别缺少明确契约 | 属已证实风险或代码反例,不能冒充全部发生了错误交易,也未在本次统一修业务代码 |
| 11月17日吸筹阶段,bionic `dbc2d57、011d9bf` | `my_quant_db.gp_stock_factor_pro_202611`因子缺行,阶段连续推进停在11月3日;查询旧批次OK不能证明最新日完成 | 同一完成语义在另一条数据链再次缺失;失败回调、目标业务日和恢复补采没有贯穿 | 当日接续记录补采及阶段推进到11月16日;本次只读历史记录,未重新触发或验证全市场补采 |
| 11月13日研究跨环境复算,`2b09160` | 嵌套结果浮点比较仅顶层容差,跨版本微小差异导致校验失败 | 验证工具本身没有覆盖结果结构与数值语义 | 修递归容差;不是研究结论被证实错误,也不是交易事故 |
本窗口可以证实规则撤回、界面恢复原方案、遗漏边界后的补丁及候选返修。没有足够证据证明发生过生产镜像整体回滚;文档中的“回退条件”不是已执行回滚。模拟仓授权重置也不自动归为Bug回滚。
## 本次资金恢复的准确位置和边界
09:09:28从188 `intraday_alerts`只读抽查华策、雷赛、四方:Mongo `192.168.18.75:27017 / judge / stock_flow_data`每股112个日期,末日2026-11-17,较之前10月14日末日新增24个日期。该结论限三股原始日期投影,未宣称全池原始分钟完整。证据见[原始日期恢复摘要](evidence/fund_history_recovery_20261118.json)。
09:15:30从ITD现有文件取得独立分钟准备名单14只,名单时间09:15:26。使用实际`load_prepared`校验规则只读重建缓存,分钟量价、分钟资金、日资金各为14/14就绪;三只抽查股票分钟资金历史34天、有效分钟240。主基线文件`mf_daily=0`,但单票准备缓存接纳后14只日资金均存在,所以不能仅凭主文件判日资金链路故障。见[原始准备证据](evidence/itd_preparation_20261118.json)及[自动判定与反例重放](evidence/business_evidence_replay_20261118.json)。
09:27:40使用最终采集器再次只读核验,名单来源错误为空,三路仍各14/14,见[最终采集证据](evidence/itd_preparation_verified_20261118.json)。
这里的14只是当时分钟服务的准备名单,不等同11月16日盘中的129只告警池。检查发生在开盘前;当前证据没有覆盖今天正式告警的全部名单、当天实时输入、实际计算、发布和PMS消费。原始写入任务为什么曾停止,以及补数是否由哪个具体任务完成,本次未取得其写入日志,不推断责任服务。
资金的两条主要历史链仍应分别维护:分钟资金来自`judge.stock_flow_data → MongoMoneyFlowMinuteAdapter → 历史准备/seasonality.mf_minute → money_flow_in/out_intensity`;日资金来自`gp_moneyflow_ths → daily_fund准备`。分钟量价`gp_stk_mins_1min`和当日214 Redis快照不能互相替代上述历史资格。
## 已落地的预防措施与验证
| 措施 | 实际落点 | 已证明能防止什么 | 不能据此声称什么 |
| --- | --- | --- | --- |
| 明确业务约束、合法范围与逐路完成标准 | 根`AGENTS.md`新增三条;测试目录规则新增真实边界要求 | 对“预算限制扩成整轮禁买”“只看其他来源消息”等明确约束审查行为 | 文本规则不会自动消除现存代码缺陷 |
| 故障修复Skill | `.agents/skills/pms-incident-review/`,根规则及开发入口可发现 | 要求从独立名单、真实数据位置、全部消费者及失败/恢复路径核验;区分需求变化和返工 | 不新增授权、不触发所有普通修改、不另造交易规则 |
| 历史准备只读采集和自动判定 | `scripts/collect_itd_preparation.py`、`scripts/check_business_evidence.py preparation` | 空名单、缺股、资金基线为0、样本不足、过期证据、缓存未接纳会返回非零;其他来源正常不抵消 | 未监控实时计算、告警进程内存或自然发布消费;不是常驻监控 |
| 任务子结果自动检查 | `check_business_evidence.py task` | 11月16日两组原始代码反例均判FAILED,指出`timing_fusion.invalid/source_errors`及全部来源false | NO_REPORTED_FAILURE只表示没有显式失败,不是业务完成 |
| 真实边界反例接入常规回归 | `test_business_evidence.py`登记`run_tests.py` | 21例;真实14只快照通过;仅注入一股历史13日和资金有效分钟0就判INCOMPLETE,其他两路仍保留通过 | 注入仅开发机内存,不是线上事故或信号样本 |
| 发布闭环补充 | `pms-release/SKILL.md`新增逐路及子结果判收 | 把自然待办落实到具体事件、读取位置、通过条件,防止只记“以后观察” | 不自动新建定时任务或延续用户已取消的观察安排 |
最终版本在开发机Python3.12完成90组配置隔离、禁网全量回归,返回`ALL SUITES PASS`,其中包含本次工具21例专项。Skill的官方格式校验通过。188只读执行采集器成功,验证了实际ITD模块和文件的适配。文档、链接与差异检查纳入本次交付检查。
本轮不修改应用服务,没有应重建的业务容器;新脚本仅以stdin在已授权容器执行只读检查,没有安装到服务器或增加调度。独立工作树基于`bf289f7`,分支`codex/recurrence-prevention-20261118`,保护主研究工作树及其已有未提交文件。
## 仍需单独闭环的运行问题
本轮完成的是复盘与可执行预防机制,不将以下问题藏在“全面通过”后面。最新状态以重新取证为准,下面列的是明确的关闭条件。
| 项目 | 下一次应读取的位置与触发场景 | 关闭条件 |
| --- | --- | --- |
| 开盘后资金全链路恢复 | ITD实际告警池、逐源健康、当日资金时间、正式告警流、PMS逐源消费;自然开盘与真实满足阈值时 | 对当前完整应监测名单逐路证明可算;未触发有计算资格证据,触发时有发布与消费回执,不制造信号 |
| 原始资金历史停更直接根因 | `judge.stock_flow_data`实际写入任务的调度、最近成功、写入行数和失败日志 | 找到生产者及失败点,并验证下一自然批次;目前仅知道数据已经恢复 |
| 技术读数旧映射与分页一致性 | `pms_tech_daily`、`PMS_TECH_STATE_MAP`及持仓/网格/退出调用方;源数据换日或换版本 | 同时拒绝不完整跨版本拉取,并证明所有当前判断路径使用有效同口径数据 |
| 子任务状态及不可用缓存恢复 | `execution_basis_refresh.risk_reviews`、`signal_service.consume.timing_fusion`、异步研判持久请求;自然失败再恢复 | 聚合状态反映必要子步骤,暂时不可用在有效截止后可重评,保留人工和保守交易边界 |
| 分钟完整性与时钟 | PMS分钟Redis键、实际分钟集合、208 Redis TIME与业务主机时钟 | 价格/量比拒绝过期和稀疏窗口;流ID时间不能冒充无偏业务证据时间 |
| 上游新增补采的范围约束 | bionic `dbc2d57`的`factor_backfill.py`证券入口及任务覆盖契约,仅静态检查沪深范围 | 该历史补丁入口仍接受项目排除市场的代码;本项目调用须在读入入口限定沪深。本次未读取相关证券数据或运行补采,历史回执不能作为扩范围依据 |
这些关闭条件与本次预防工具的能力明确分开。后续修复优先处理会造成整路不可用却仍被称为正常的完成语义,以及旧数据/旧版本进入当前交易判断的问题;具体交易规则变化仍按用户决定执行。

View File

@ -9,6 +9,7 @@
- 新增`test_batch*.py`同时登记`run_tests.py`的`SUITES`和例数说明。缺失测试文件必须失败,不能当跳过。
- DDL、调度、API、密钥、动作求值顺序及仓储签名变化,检查`run_tests.py`顶部哨兵位置清单及实际断言,不照抄历史表数或测试总数。
- 合并分支时检查测试文件是否重名,不能让一批测试覆盖另一批;缺项不能靠删登记解决。
- 跨边界修复至少保留一个经过真实入口和真实输出编码的反例,只替换外部I/O。桩保留实际响应包装、Decimal/日期、空值、失败返回和版本字段;不要把待核验的序列化、路由或任务入口一起替换掉。涉及异步动作按影响选择迟到、重放、部分完成和恢复场景,并检查原来允许的正常路径。
开发机在安装了项目依赖的独立虚拟环境中、从仓库根目录执行:
@ -24,3 +25,5 @@ python scripts/unit_test_guard.py scripts/test_batch48_units.py
`make help`是命令目录,不能把每个目标都当只读探针。`make test`用于部署服务器,发布前还须对匹配的候选镜像断网验证,步骤见[pms-release](../.agents/skills/pms-release/SKILL.md)。
新脚本应区分只读检查和实际写入,并验证重复执行及失败后的状态。`tick`、回放、建表、清账和重建账本都有业务副作用,不在活跃交易账户上当作普通单测。隔离演练使用独立数据库与前缀,不使用会认领真实成交的shadow路径。历史探针文件和文档中的日期不自动构成今天的执行授权。
历史准备与任务回执的只读导出、自动判定见[业务证据核验工具](../docs/业务证据核验工具.md)。失败返回非零退出码;无显式错误不代表业务完成。工具不会触发业务任务,也没有安装定时调度。

View File

@ -0,0 +1,135 @@
"""离线核对历史准备覆盖或任务子结果;不连接服务、不触发补算或交易。"""
import argparse
import datetime as dt
import json
from pathlib import Path
import re
from zoneinfo import ZoneInfo
TZ = ZoneInfo("Asia/Shanghai")
PARTS = ("minute_archive", "minute_fund", "daily_fund")
def count(value):
if type(value) is not int or value < 0:
raise ValueError("覆盖数和历史天数必须是非负整数")
return value
def timestamp(value):
result = dt.datetime.fromisoformat(value)
if result.tzinfo is None:
raise ValueError("时间缺少时区")
return result.astimezone(TZ)
def failure_paths(value, path="$", depth=0):
"""检查明确失败字段,保留路径,不输出可能含凭据的错误正文。"""
if depth > 40:
return [path + ":too_deep"]
failures = []
if isinstance(value, dict):
for key, child in value.items():
where = path + "." + str(key)
if ((key in ("ok", "success") and child is False)
or ((key in ("error", "errors", "invalid", "failed") or str(key).endswith(("_error", "_errors"))) and bool(child))
or (path.endswith(".sources") and child is False)
or (key == "status" and child in ("error", "failed", "FAILURE"))):
failures.append(where)
failures.extend(failure_paths(child, where, depth + 1))
elif isinstance(value, list):
for i, child in enumerate(value):
failures.extend(failure_paths(child, f"{path}[{i}]", depth + 1))
return sorted(set(failures))
def check_task(value):
if not isinstance(value, (dict, list)) or not value:
return {"status": "INCOMPLETE", "failure_paths": ["$:empty_or_invalid_result"]}
paths = failure_paths(value)
return {"status": "FAILED" if paths else "NO_REPORTED_FAILURE",
"failure_paths": paths,
"limit": "无显式失败不等于业务完成;仍须核对预期输出、覆盖与自然回执。"}
def check_preparation(doc, now, max_age=300):
"""只判断历史准备层,绝不把它提升为实时信号或交易可用。"""
if not isinstance(doc, dict) or doc.get("schema") != "itd-preparation-evidence-v1":
raise ValueError("不支持的证据格式")
if now.tzinfo is None or not 0 < max_age <= 86400:
raise ValueError("核验时间须带时区,证据有效秒数须在1至86400之间")
now = now.astimezone(TZ)
issues = []
for field, age_limit in (("collected_at", max_age), ("universe_at", max_age)):
age = (now - timestamp(doc[field])).total_seconds()
if not 0 <= age <= age_limit:
issues.append(field + ":stale_or_future")
if doc.get("day") != now.date().isoformat():
issues.append("day:mismatch")
if doc.get("collection_errors"):
issues.append("collection:incomplete")
codes = doc.get("expected_codes")
if not isinstance(codes, list) or not codes:
raise ValueError("缺少独立的应覆盖名单,不能把空集当作全部通过")
if any(not isinstance(c, str) or not re.fullmatch(r"(?:60\d{4}\.SH|68\d{4}\.SH|00\d{4}\.SZ|30\d{4}\.SZ)", c) for c in codes):
raise ValueError("应覆盖名单必须在入口规范化并限定沪深股票")
if len(codes) != len(set(codes)):
raise ValueError("应覆盖名单存在重复代码")
stocks = doc.get("stocks")
if not isinstance(stocks, dict):
raise ValueError("缺少逐股证据")
lanes = {p: {"expected": len(codes), "ready": 0, "unready": {}} for p in PARTS}
for code in codes:
row = stocks.get(code, {})
if not isinstance(row, dict):
raise ValueError("逐股证据类型错误")
for part in PARTS:
p = row.get("parts", {}).get(part, {})
e = row.get("effective", {})
reasons = []
if p.get("state") != "ready":
reasons.append("preparation_not_ready")
if part in row.get("errors", {}) or "build" in row.get("errors", {}):
reasons.append("preparation_error")
if row.get("day") != doc["day"] or row.get("loaded") is not True:
reasons.append("cache_not_accepted")
if part == "minute_fund":
if count(p.get("days", 0)) < 30:
reasons.append("history_days_below_30")
if count(e.get("money_flow_minutes", 0)) < 200:
reasons.append("effective_money_flow_minutes_below_200")
elif part == "minute_archive":
if count(e.get("volume_minutes", 0)) < 200 or count(e.get("qrs_minutes", 0)) < 180:
reasons.append("effective_price_volume_coverage_insufficient")
elif count(p.get("days", 0)) < 30 or e.get("daily_fund_present") is not True:
reasons.append("effective_daily_fund_missing")
if reasons:
lanes[part]["unready"][code] = reasons
else:
lanes[part]["ready"] += 1
return {"status": "READY" if not issues and all(x["ready"] == x["expected"] for x in lanes.values()) else "INCOMPLETE",
"scope": "historical_preparation_only", "day": doc["day"],
"issues": issues, "lanes": lanes,
"limit": "只读重建的历史准备资格;未验证进程内存、当日实时输入、实际计算、发布和消费。"}
def main(argv=None):
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("kind", choices=("preparation", "task"))
parser.add_argument("file", type=Path)
parser.add_argument("--at", help="历史重放时间,必须带时区;省略则核验当前证据")
parser.add_argument("--max-age", type=int, default=300)
args = parser.parse_args(argv)
try:
value = json.loads(args.file.read_text())
result = (check_task(value) if args.kind == "task" else check_preparation(
value, timestamp(args.at) if args.at else dt.datetime.now(TZ), args.max_age))
except (OSError, ValueError, TypeError, KeyError, AttributeError):
print(json.dumps({"status": "INVALID_EVIDENCE", "reason": "输入文件、字段类型或时间格式不符合契约"}, ensure_ascii=False))
return 2
print(json.dumps(result, ensure_ascii=False, indent=2))
return 0 if result["status"] in ("READY", "NO_REPORTED_FAILURE") else 1
if __name__ == "__main__":
raise SystemExit(main())

View File

@ -0,0 +1,69 @@
"""在已授权ITD容器内只读导出历史准备证据;不访问数据库,不补算、不发布。
从开发机透传给容器的 python - 执行;输出仅有统计、证券代码和错误类型。
使用ITD现有缓存校验入口,未验证告警进程内存或实时资金、信号消费。
"""
import datetime as dt
import json
from pathlib import Path
from zoneinfo import ZoneInfo
def collect():
from intraday_timing.config.loader import load_config_bundle
from intraday_timing.minute_recovery.core import load_settings, hs_stock, VERSION
from intraday_timing.state.intake_preparation import load_prepared
from intraday_timing.state.seasonality_cache import SeasonalityCache
now = dt.datetime.now(ZoneInfo("Asia/Shanghai"))
day = now.date().isoformat()
settings = load_settings()
bundle = load_config_bundle(Path("/app/configs"))
root = Path(settings.directory)
universe = json.loads((root / "status.json").read_text())
if universe.get("version") != VERSION or universe.get("config_hash") != settings.fingerprint:
raise ValueError("universe_identity")
codes = sorted({c for c in universe["codes"] if hs_stock(c)})
prep_root = root / "preparation" / day
prep = json.loads((prep_root / "status.json").read_text())
baseline = json.loads((Path("/app/data/seasonality") / (day + ".json")).read_text())
if baseline.get("as_of_date") != day:
raise ValueError("baseline_day")
cache = SeasonalityCache.from_dict(baseline)
accepted = load_prepared(settings, bundle.runtime, codes, now.date(), cache)
errors = ["universe_reported_errors"] if universe.get("errors") else []
rows = {}
alerts = bundle.runtime.get("alerts", {})
capital_min = int(alerts.get("capital_anomaly", {}).get("min_sample_count", 10))
flow_min = int(alerts.get("money_flow_out_intensity", {}).get("min_sample_count", 10))
for code in codes:
row = prep.get("stocks", {}).get(code, {})
volumes = [cache.get_vol(code, m) for m in range(240)]
flows = [cache.get_mf_minute(code, m) for m in range(240)]
qrs = [cache.get_qrs_min(code, m) for m in range(240)]
rows[code] = {
"day": prep.get("day"), "loaded": code in accepted and accepted[code] in ("ready", "partial"),
"parts": row.get("parts", {}),
"errors": {k: "reported" for k in row.get("errors", {})},
"effective": {
"volume_minutes": sum(bool(v and v.sample_count >= capital_min and v.log_amt_std >= 1e-9) for v in volumes),
"money_flow_minutes": sum(bool(v and v.sample_count >= flow_min and v.main_cum_std >= 1e-3) for v in flows),
"qrs_minutes": sum(bool(v and v.sample_count >= 10 and v.beta_std > 0) for v in qrs),
"daily_fund_present": cache.get_mf_daily(code) is not None,
}}
if prep.get("day") != day or not settings.enabled:
errors.append("preparation_identity_or_disabled")
return {"schema": "itd-preparation-evidence-v1", "collected_at": now.isoformat(),
"day": day, "universe_at": universe["at"], "expected_codes": codes,
"collection_errors": errors, "stocks": rows,
"baseline_file_rows": {k: len(baseline.get(k, [])) for k in ("mf_minute", "mf_daily", "vol", "qrs_min")},
"scope": "read_only_cache_reconstruction_not_live_process"}
if __name__ == "__main__":
try:
print(json.dumps(collect(), ensure_ascii=False))
except Exception as exc:
# 禁止打印异常正文,可能包含连接或配置路径;采集不全必须失败。
print(json.dumps({"collection_failed": type(exc).__name__}))
raise SystemExit(2)

View File

@ -4,6 +4,8 @@
======================================
运行: docker compose run --rm pms-web python scripts/run_tests.py
历史准备逐路覆盖、旧证据拒绝及嵌套业务失败核验专项21例。
test_batch54_units.py 用户候选来源、到期核验、权限、显式取用、技术面补读及评级排序透传 (10例)
4%网格真实批次、核销顺序、报价边界、迁移事务与跨版本库存重复准入专项62例。
@ -205,6 +207,7 @@ HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)
# 退出纪律专项:两次独立清仓信号、评级下降、事务、双策略隔离及撤单收尾。
SUITES = [
"test_business_evidence.py", # 历史准备覆盖与嵌套业务失败(21例)
"test_signal_health.py", # 资金监测可用性与交易员提示,7例
"test_proposal_trader_view.py", # 当前分析、数据库读数保存及旧确认保护(21例)
"test_watch_missing_fund.py",

View File

@ -0,0 +1,139 @@
"""业务证据核验:失效来源不能被其他来源、顶层成功或旧回执掩盖(21例)。"""
import unit_test_guard
import copy
import datetime as dt
import io
import json
from pathlib import Path
import tempfile
import unittest
from contextlib import redirect_stdout
from check_business_evidence import check_preparation, check_task, main
NOW = dt.datetime.fromisoformat("2026-11-18T10:00:00+08:00")
CODE = "300133.SZ"
def prepared():
return {"schema": "itd-preparation-evidence-v1", "day": "2026-11-18",
"collected_at": NOW.isoformat(), "universe_at": NOW.isoformat(),
"expected_codes": [CODE], "collection_errors": [], "stocks": {CODE: {
"day": "2026-11-18", "loaded": True, "errors": {},
"parts": {"minute_archive": {"state": "ready"},
"minute_fund": {"state": "ready", "days": 34},
"daily_fund": {"state": "ready", "days": 35}},
"effective": {"volume_minutes": 240, "qrs_minutes": 240,
"money_flow_minutes": 240, "daily_fund_present": True}}}}
class PreparationEvidenceTests(unittest.TestCase):
def test_nonfinite_boolean_or_string_count_cannot_be_ready(self):
for value in (float('nan'), float('inf'), True, "240", -1):
d = prepared(); d["stocks"][CODE]["effective"]["money_flow_minutes"] = value
with self.assertRaises(ValueError): check_preparation(d, NOW)
def test_ready_is_limited_to_historical_layer(self):
out = check_preparation(prepared(), NOW)
self.assertEqual(out["status"], "READY")
self.assertEqual(out["scope"], "historical_preparation_only")
def test_other_sources_cannot_mask_empty_moneyflow(self):
d = prepared(); d["stocks"][CODE]["effective"]["money_flow_minutes"] = 0
out = check_preparation(d, NOW)
self.assertEqual(out["status"], "INCOMPLETE")
self.assertEqual(out["lanes"]["minute_archive"]["ready"], 1)
self.assertEqual(out["lanes"]["minute_fund"]["ready"], 0)
def test_preparation_claim_cannot_mask_too_few_history_days(self):
d = prepared(); d["stocks"][CODE]["parts"]["minute_fund"]["days"] = 13
self.assertEqual(check_preparation(d, NOW)["status"], "INCOMPLETE")
def test_missing_stock_is_counted_in_denominator(self):
d = prepared(); d["expected_codes"].append("002979.SZ")
out = check_preparation(d, NOW)
self.assertEqual(out["lanes"]["minute_fund"]["expected"], 2)
self.assertIn("002979.SZ", out["lanes"]["minute_fund"]["unready"])
def test_empty_universe_cannot_pass(self):
d = prepared(); d["expected_codes"] = []
with self.assertRaises(ValueError): check_preparation(d, NOW)
def test_duplicate_or_outside_universe_is_rejected(self):
for codes in ([CODE, CODE], ["INVALID"]):
d = prepared(); d["expected_codes"] = codes
with self.assertRaises(ValueError): check_preparation(d, NOW)
def test_old_snapshot_and_future_timestamp_cannot_pass(self):
for timestamp in ("2026-11-18T09:00:00+08:00", "2026-11-18T10:01:00+08:00"):
d = prepared(); d["collected_at"] = timestamp
self.assertEqual(check_preparation(d, NOW)["status"], "INCOMPLETE")
def test_stale_independent_universe_cannot_pass(self):
d = prepared(); d["universe_at"] = "2026-11-17T10:00:00+08:00"
self.assertEqual(check_preparation(d, NOW)["status"], "INCOMPLETE")
def test_rejected_cache_is_not_ready_even_if_file_has_rows(self):
d = prepared(); d["stocks"][CODE]["loaded"] = False
self.assertEqual(check_preparation(d, NOW)["status"], "INCOMPLETE")
def test_previous_day_cache_is_not_current(self):
d = prepared(); d["stocks"][CODE]["day"] = "2026-11-17"
self.assertEqual(check_preparation(d, NOW)["status"], "INCOMPLETE")
def test_daily_fund_failure_does_not_disappear_when_minute_recovers(self):
d = prepared(); d["stocks"][CODE]["effective"]["daily_fund_present"] = False
out = check_preparation(d, NOW)
self.assertEqual(out["lanes"]["minute_fund"]["ready"], 1)
self.assertEqual(out["lanes"]["daily_fund"]["ready"], 0)
def test_reported_error_dominates_old_ready_state(self):
d = prepared(); d["stocks"][CODE]["errors"] = {"minute_fund": "reported"}
self.assertEqual(check_preparation(d, NOW)["status"], "INCOMPLETE")
def test_unknown_collection_state_cannot_pass(self):
d = prepared(); d["collection_errors"] = ["identity"]
self.assertEqual(check_preparation(d, NOW)["status"], "INCOMPLETE")
def test_input_remains_unchanged(self):
d = prepared(); old = copy.deepcopy(d); check_preparation(d, NOW)
self.assertEqual(d, old)
class TaskEvidenceTests(unittest.TestCase):
def test_source_error_without_invalid_counter_is_detected(self):
self.assertEqual(check_task({"ok": True, "timing_fusion": {"invalid": 0, "source_errors": ["unavailable"]}})["status"], "FAILED")
self.assertEqual(check_task({"status": "SUCCESS", "business_error": "data_missing"})["status"], "FAILED")
def test_all_sources_failed_cannot_hide_under_top_ok(self):
out = check_task({"top_ok": True, "sources": {"intraday": False, "alerts": False}})
self.assertEqual(out["status"], "FAILED")
self.assertEqual(check_task({"ok": True, "enabled": False})["status"], "NO_REPORTED_FAILURE")
def test_nested_failure_dominates_celery_success(self):
out = check_task({"status": "SUCCESS", "result": {"ok": True, "risk_reviews": {"ok": False, "errors": ["timeout"]}}})
self.assertEqual(out["status"], "FAILED")
self.assertIn("$.result.risk_reviews.ok", out["failure_paths"])
def test_errors_without_exception_are_detected(self):
out = check_task({"ok": True, "timing_fusion": {"invalid": 3}})
self.assertEqual(out["status"], "FAILED")
out = check_task({"ok": True, "new_proposals": [{"errors": ["do-not-print-secret"]}]})
self.assertNotIn("do-not-print-secret", json.dumps(out))
def test_no_message_and_no_reported_failure_do_not_claim_completion(self):
self.assertEqual(check_task({})["status"], "INCOMPLETE")
self.assertEqual(check_task({"ok": True, "signals": [], "errors": []})["status"], "NO_REPORTED_FAILURE")
def test_cli_exit_codes_and_malformed_input(self):
with tempfile.TemporaryDirectory() as folder:
path = Path(folder) / "input.json"
for value, expected in (({"ok": True}, 0), ({"ok": False}, 1), (None, 1)):
path.write_text(json.dumps(value))
with redirect_stdout(io.StringIO()): self.assertEqual(main(["task", str(path)]), expected)
path.write_text('{')
with redirect_stdout(io.StringIO()): self.assertEqual(main(["task", str(path)]), 2)
if __name__ == "__main__":
unittest.main()