方案副本同步:部署与判收阶段方案与规格书、复审记录(2026-09-16)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
zlt 2026-09-16 11:42:52 +08:00
parent bb286c5e2e
commit dc94bbf42b
2 changed files with 726 additions and 0 deletions

View File

@ -0,0 +1,166 @@
# 评审记录(2026-09-16,复审):收尾阶段五个开发工作包
> 依据《收尾阶段开发方案与规格书_2026-09-15》第十节复审。评审者是大模型会话,只看证据不看自述。
> 评审对象是开发者交付的五个工作包,以及开发者自己写的《评审记录_2026-09-16》(提交 4bb7138)。本记录写给开发者复工与用户拍板两种读者。
> 写法遵守 `.claude/output-styles/readable-chinese.md`。
---
## 一、评审对象与提交号
| 工作包 | 提交 | 分支 · 仓库 | 提交时刻(北京) |
|---|---|---|---|
| 一 保运包修复 | 79abcf2 | deploy-2026-09-18 · 数据基座 | 09-15 18:03 |
| 二 判收读数包修复 | b08315d | deploy-2026-09-18 · 数据基座 | 09-15 17:47 |
| 三 评析第二批返工 | 3522662 | nextphase-2026-09 · 数据基座 | 09-16 09:36 |
| 四 评析第三批 | dfb96c3、85de98e | nextphase-2026-09 · 数据基座 | 09-16 10:25、11:12 |
| 五 选股系统小改 | bb286c5 | wp5-review-latest · 选股系统 | 09-16 10:42 |
分支拓扑与上一阶段拍板一致:部署分支从 7ea65c8 分出,只含保运包与判收读数包及其修复,不含评析第二批的版本号升级;开发分支在 66a6dc1 之后续接返工与第三批。两条分支的分叉点实测是 7ea65c8。五个包都没有部署,基座机代码仍停在 3f45294。
两处顺手要提醒用户的状态:本地 master 与选股系统本地 main 各比远端多两个只改文档的提交,还没推送;选股系统仓库的工作区被切到了小改分支上,没有切回 main。
## 二、证据核对表
| 证据项 | 核了 | 结论 |
|---|---|---|
| 提交号 | 逐个 `git show --stat` 对照附录己 | 一二两包二十一个文件、五包七个文件都在清单内;三四两包清单外三处(前端评析块、`.env.example`、一个假评议件)已在提交正文披露且必要 |
| 离线单测 | 在三棵游离检出树上各自实跑,不切分支 | 部署分支七十四例、开发分支一百一十六例,都是 OK;选股系统两个新测试本地各 ALL OK |
| 复审命令 | 第六节标"本地"的命令 | 编排层直接导入端点池的判定函数,同一对象 |
| 逐条不符项 | 对上一份评审记录第四节逐条 | 保运包四条、判收读数包四条、评析第二批退回级两条与条件级三到五全部落地,见第四节 |
| 第三批公式 | 另派一个只读会话逐条对附录丁 | 十四个指标、四个视角的阈值与方向都对;发现三处部署前要修的,见第四节 |
| 对外契约 | 查选股系统全部 Python 文件与持仓管理系统仓库 | 没有任何地方读摘要的预期键,改成对象对下游安全 |
| 分支整合 | 在临时工作树里试合并部署分支到开发分支,不落地 | 只有新鲜度模块与它的单测各一处冲突,可控 |
| 消息格式 | 在基座机容器里读消息库源码 | 队列列表项是 JSON 消息字典、正文是 base64;未确认哈希的值是列表包裹的消息。与在飞集合解析器的两个假设一致 |
| 入口文件编译 | 单测不覆盖的任务、接口、脚本文件逐个编译 | 三棵树都通过 |
| 上线读数 | 无 | 未部署,本轮不核 |
## 三、只读读数原文
**本地(09-16 上午)。**
```
部署分支 79abcf2:Ran 74 tests in 0.048s OK
开发分支 4bb7138:Ran 116 tests in 0.066s OK
选股系统 bb286c5:test_review_latest ALL OK;test_plan_review_heads ALL OK
试合并 79abcf2 到 4bb7138:冲突两个文件,freshness.py 一处、test_freshness.py 一处
```
**基座机(09-16 上午,容器内读消息库源码,只读)。**
```
kombu 5.4.0 / celery 5.6.2
prepare_message 返回 {'body','content-encoding','content-type','headers','properties'}
redis Channel._put:lpush(queue, dumps(message))
QoS.append:hset(unacked, delivery_tag, dumps([message._raw, exchange, routing_key]))
```
## 四、逐条核对与不符项
行号按各自分支的树。
### 工作包一:保运包修复
上一份评审记录条件级一到四逐条核:
1. 无数据不重跑。`freshness.py` 重跑类常量去掉了近期无数据,分类函数照旧返回这一类。单测 `test_recent_no_data_not_reworked`。
2. 年龄看核对时刻。`freshness.py` 的年龄函数收整行,取运行时刻与核对时刻里更新的那个。单测 `test_age_uses_checked_at`。
3. 在飞集合。`dispatch_policy.py` 新增纯函数解析消息,`tasks.py` 新增读 Redis 两条列表与未确认哈希的函数,异常返回未知。四例单测。解析器假设与容器里的消息库源码一致。
4. 四十八小时判据。补投与材料需求单每轮末各记一行任务运行台账,日检改读它,三档文案正确。日检里的当前时刻带时区,与台账列相减不会出错。
建议级三条与两处注释都改了。年报口径两个常量为单一事实源,花名册按队列各查一次且空来源类型归默认队列,核销脚本取文档号加了排序。删掉的重复常量在整棵树里没有残留引用。
不符项:无。
**判定:有条件通过。** 条件是运行样本类读数,按部署日交回。
### 工作包二:判收读数包修复
条件级一到四逐条核:
1. 技术面那一列改读技术面对象并按类型判;退路 SQL 拆成两列。
2. 八条结论行改成四加四,键与标签逐条对应两份方案第七节;人核项打印读数;周报两条按选股系统只读接口的标记计数判,接口不可用写"不成立(未实现)";退路模式下两个头那条写人核。评析一按报告不落后与评议不落后两个比例判。
3. 判收日期改东八区日期。
4. 周报台账通用化成 `job_runs`,无钥匙落跳过行,干跑落行,任务号进列,运行中的行不写结束时刻。轮询遇认证错立即返回、服务端错连续三次返回。两张台账表的建表语句同源追加进了初始化脚本。
建议级:判收命令第三节把选股系统接口的 404 一律写成"没有周报",但接口还没上线时 404 的含义是"路由不存在"。可以按响应体里的说明区分,不影响结论行(两种都判"不成立(未实现)")。
不符项:无。
**判定:有条件通过。** 条件同工作包一。
### 工作包三:评析第二批返工
上一份评审记录退回级两条、新发现的集中度缺陷、条件级三到五逐条核:
1. 盘中判定。`runner.py:15-17` 直接导入端点池的判定函数,`runner.py:79` 用它选档位,自写窗口已删。单测钉住同一对象。
2. 定性指纹。`runner.py:263-275` 只有定性状态是 ok 或 half 才落含定性的指纹并记已做定性,其余落素指纹、记原因。当日上限按已做定性计数,被挡下的不再计入。单测两种情形都有强断言。
3. 图谱带方向。`materials.py` 图谱材料的键、meta 与指纹都带方向,波特集中度可算。单测用注入的两出一入三条边。
4. 待定性类。`freshness.py:70-71` 加待定性,材料太薄按新鲜;`tasks.py:1819-1821` 待定性而没拿到定性名额的从投递名单去掉。单测两例。
5. 主环节成员数。`materials.py` 从环节投影表两条本地查询取成员数与主环节;波特成员少于三家值照记、判定留空、备注写明。
6. 单家入口。接口透传定性参数,脚本加档位覆盖参数并写进首行说明。
一处口径要写清:材料只在带定性的运行里收集。定性开着时每家每天轮到一次带定性的运行,最终落库的那一行有材料。这是上一阶段附录丙的设计,不算不符。
不符项:无。变基后 `freshness.py` 要与部署分支的改动调和,开发者在提交正文里已写明。
**判定:通过(复审级)。** 条件是变基后我重核一次 diff 与单测。
### 工作包四:评析第三批
指标与视角逐条核过附录丁,十四个指标的公式与单位都对:比率经百分数换小数,市值万元折元,预期差乘一百成百分点;除零与负基数有拦截;阈值方向没有写反。评议扩展、摘要三键、第二批遗留条件级六到十二全部落地。四例视角单测、五例评议单测、三例定性单测、三例材料单测数量与规格一致。
条件级,09-29 部署前修并补单测:
1. 可比公司价格查询在生产上必失败。`materials.py:365-366` 写的是 `symbol = ANY(%s)`,这是 Postgres 写法;代理库走 MySQL 协议(`market_snapshot.py:61-72` 用 pymysql),这句报语法错,被 `materials.py:371-372` 的裸 `except` 吞掉,价格全空,`peers_pe_median` 永远算不了,邱国鹭"市盈率不超过同环节中位"整条链路形同虚设,没有任何读数能暴露。离线单测注入假数据,覆盖不到这一路。同一处还有三件要一起改:游标原值没有过 `fin_statements` 的数值与日期归一,语法改对后可能拿到字符串或十进制类型,比较时抛错;`materials.py:351-353` 取成员的查询没有排序就截前十家,成员超过十家时可比代码集合会伪变,材料指纹跟着漂、定性白重跑;异常没有记进 `errors`。
2. 达摩达兰三情景对照表没有进报告。`lenses/damodaran.py:58` 只把表放在返回值里,`runner.py:231-232` 侧车不带它,`report.py:147-166` 第四段不渲染它。规格附录丁三明写"对照表进报告第四段"。人看不到,评议也拿不到。
3. 数字回查没有跟上新编号。`synthesis.py:189` 的剥离正则只认 M 与 C 两种编号,评议正文里的 L、S、R、G、K、P 编号会被剥成裸数字去回查,十二以上的编号一律记未核数字,计入未核比例,比例过三成会把评议误降成半成品。提示词又要求正文引用这些编号,所以是系统性误报。
建议级:
- 覆盖机构只有一家时,一致预期函数仍返回单家的三元组,`metrics.py:378-383` 照取中位,预期差、市盈率对增速、达摩达兰中性所需增速会按一家券商算出值,与同函数"两家以下不算"不一致。
- 马克斯的毛利判据用最新期年初至今毛利率对十年最高,规格写"最新年度";主环节没有评析时回退到任一环节的倾向,规格只写主环节。
- 评议的预期字段校验只认一致预期指标编号,引预期视角的判据编号会被记警告。
- 市盈率小于等于零时,市盈率对十年中位、市盈率对增速、市盈率对同环节中位会得负值并通过"不超过"型判据。上游对亏损公司通常给空值,风险小,加一行拦截更稳。
- 评议渲染 5.3 标题仍写"七字段",已是八字段。可比公司取价格的起始日用容器当天,不用数据截至日。
- 上一阶段规格书附录丁七写的"定性因材料指纹不变而复用"在代码里没有落点:版本号一升,每家的定性会再跑一遍,本地档零费用但占产能,盘中溢出云端有费用。这一条是我的预判写错了,不是开发者的问题,交接与新规格书按实际写。
**判定:有条件通过。** 条件级三处在 09-29 部署前修完并补单测,随变基树一起复审。
### 工作包五:选股系统小改
只读接口只做文件读取,目录缺省 `data/review` 相对容器工作目录,没有周报回 404;周报第七节在择时决策系统那一行之后插两行,查询与择时自评同款,种类名与期限按探针读数;两个新测试本地各 ALL OK。文件都在附录戊清单内。
不符项:无。
**判定:有条件通过。** 条件是拉代码后最新周报里两行各命中一行,重启接口后只读接口返回三个标记计数。
### 开发者的评审记录本身
两处结论要更正。一,工作包四里"材料两路 K 与 P 全部存在、端到端可用"不成立,P 那一路在生产上必失败。二,独立会话只跑了离线单测与探针,没有在基座机上试跑任何一条新增的代理库查询,所以查不出方言问题。教训写进新规格书的交付要求:凡新增打一百五十三代理库的查询,交付证据要含基座机上一次只读实跑的输出。
### 跨包
- 台账四条与交接同步留到部署日,与上一轮同口径。
- 两个仓库各有两个只改文档的提交没有推送,并入 master 前要先推。
- 选股系统仓库的工作区停在小改分支,等并入 main 后切回。
## 五、判定
| 工作包 | 判定 | 条件与复核日 |
|---|---|---|
| 一 保运包修复 | 有条件通过 | 09-18 部署当天交干跑与真跑输出,09-19 交日检与补投结果 |
| 二 判收读数包修复 | 有条件通过 | 同上,加判收读数基线与第一次自动周报的台账行 |
| 三 评析第二批返工 | 通过(复审级) | 变基后重核 diff 与单测;09-23 交定性状态分布与集中度非空家数 |
| 四 评析第三批 | 有条件通过 | 09-29 部署前修条件级三处并补单测;09-30 交预期差分布与反方非空占比 |
| 五 选股系统小改 | 有条件通过 | 09-18 拉代码与重启后交读数 |
总判定:五个包都可以按新规格书的部署日程推进。评析第三批的三处必须在变基树上修完、我复审过,才能在 09-29 并入 master。
## 六、复审办法
工作包一(分支整合与三处修复)交付后,我按《部署与判收阶段方案与规格书_2026-09-16》第六节"工作包一复审"三条命令核,再读变基树上两个包的 diff 与部署分支 diff 的差异。每个部署日按该规格书第十节核部署记录与读数。
## 七、评审者与时刻
评审者:大模型会话(Claude Fable 5.1),第三批公式核对另派一个只读会话完成。时刻:2026-09-16 上午到中午,北京时间。评审用到的读数命令与探针见第三节,可重跑;三棵游离检出树在临时目录,没有切换任何分支。

View File

@ -0,0 +1,560 @@
# 数据基座部署与判收阶段方案与规格书(2026-09-16)
> 承接《收尾阶段开发方案与规格书_2026-09-15》与两份评审记录(开发者的《评审记录_2026-09-16》、评审者的《评审记录_2026-09-16_复审》)。
> 开发者可以是人,也可以是大模型。写法遵守 `.claude/output-styles/readable-chinese.md`。
> 第一到第十节是正文。附录是逐日操作单与实现细节,标了「可不读」,但动手的人当天必须照附录逐步做。
> 基线:数据基座部署分支 `deploy-2026-09-18` 停在 79abcf2,开发分支 `nextphase-2026-09` 停在 4bb7138,本地 `master` 停在 760b04a,远端与基座机 `master` 停在 3f45294。选股系统仓库分支 `wp5-review-latest` 停在 bb286c5,本地 `main` 停在 681e1ff,远端与选股系统机器 `main` 停在 3d3f317。
> 本文件落盘为 `docs/部署与判收阶段方案与规格书_2026-09-16.md`,同步到选股系统仓库的 docs。
---
## 一、这件事为最终目标买什么
最终目标不变。判收标准不变:只看系统逻辑、实现、设计目标三者是否一致,不看收益。
上一阶段的五个开发工作包今天全部交付,开发者做了内部评审,我做了复审。复审结论:保运包修复、判收读数包修复、评析第二批返工、选股系统小改四个包在代码与离线单测层面没有阻断问题;评析第三批有三处要在部署前修:可比公司的价格查询用了 Postgres 的写法去打 MySQL 协议的代理库,生产上那一路永远取不到价格;达摩达兰的三情景对照表没有进报告;评议的数字回查没有跟上新编号,会把评议误降成半成品。此外复审证实了两件事:在飞集合解析器对消息格式的两个假设与容器里装的消息库源码一致;开发分支并到部署分支只有两个文件冲突,都在新鲜度模块,可控。
所以这一阶段不开新功能。代码已经写完,剩下的全是"放到机器上并证明它按拍板在跑"。做五件事:一,整合分支并修那三处;二,09-18 部署保运包、判收读数包与选股系统小改;三,09-22 部署评析第二批;四,09-29 部署评析第三批;五,判收与收尾,包括台账四条、交接同步、上游同步待办复核、09-30 的判收读数、长假后的总评审。
这一阶段买四样东西。
1. 三个工作包在基座机上跑起来,每一处都有当天交回的读数原文。
2. 两条判收各出一份可重跑的读数:09-30 评析判收第一条到期那天一份,长假后总评审一份。
3. 一条干净的部署线:master 只前进不分叉,基座机只从 master 拉,每次部署都能说出机器上是哪个提交。
4. 下一阶段的拍板依据:每次部署的实测读数与费用,加上这一阶段结束时列出的候选方向。
---
## 二、原则
沿用前两份规格书的原则。本阶段再加五条,都是部署纪律。
1. 每一步先干跑再真跑。干跑输出不符合预期就停,不带着疑问往下走。
2. 一个维护窗口只做一件事。09-18 的窗口做三个包的上线,不顺手改别的。
3. 读数原文当天交回。部署当天与次日的读数是判收的证据,不能事后凭记忆补。
4. 出问题先回退不硬修。回退办法在第七节,每条都事先写好;机器上不改代码、不打补丁。
5. master 只做快进合并。合并前本地全量单测必须全绿;合并后立即推送;机器上只做 `git pull`。
---
## 三、做哪几件事
五个工作包,按时间排。
### 工作包一:分支整合与三处修复(09-16 到 09-17)
**做什么。** 修评析第三批的三处:可比公司的价格查询、达摩达兰对照表进报告、评议数字回查跟上新编号;把开发分支变基到部署分支之上;解决两处冲突;本地全量单测全绿;把两条分支推到远端。
**为什么。** 三个开发包分在两条分支上,这是上一阶段拍板定的部署线。现在要把它们按部署顺序排成一条直线,09-18 拉一段,09-22 拉一段,09-29 拉完。三处不修的后果:邱国鹭的"市盈率不超过同环节中位"永远算不了、可比公司材料全写"缺";达摩达兰只有判据没有对照表,人看不到情景反推的数字;评议正文里的视角与材料编号被当成数字回查,未核比例过三成就误降半成品。
**做哪几件。**
1. 修可比公司价格查询。代理库是 MySQL 协议,`symbol = ANY(%s)` 是 Postgres 写法,要改成显式占位符的 `IN (...)`;游标原值过数值与日期归一;取成员的查询加排序再截十家;异常记进材料错误字典。抽出一个拼 SQL 的纯函数,单测钉住它不含 `ANY(` 且占位符个数等于代码个数。改完在基座机用只读探针实跑一次这条查询,输出作为证据。
2. 达摩达兰的三情景对照表进侧车与报告第四段。单测钉住报告里有那张表的表头。
3. 评议的数字剥离正则从只认 M、C 扩到 M、C、L、S、R、G、K、P,与引用正则同源。单测钉住正文里出现 L13 之类的编号不算未核数字。
4. 三处各一个提交或合成一个提交都可以,都落在开发分支上。
5. 把开发分支变基到部署分支 79abcf2 之上。预期只有新鲜度模块与它的单测冲突,解法在附录丁:重跑类是五类(去掉近期无数据、加待定性),年龄函数收整行,分类函数带定性参数。
6. 变基后本地全量单测全绿,预期一百一十九例左右。把部署分支与变基后的开发分支都推到远端。
7. 交回四样:三处修复的提交号、变基后开发分支上对应"评析第二批返工"与"评析第三批"的新提交号、单测末两行、可比公司查询在基座机只读实跑的输出。我复审变基树:`git diff deploy-2026-09-18..nextphase-2026-09` 只能含三四两包与这三处修复。
细节见附录丁与附录戊。
### 工作包二:09-18 部署保运包、判收读数包、选股系统小改
**做什么。** 收盘后按附录甲的操作单做。基座机拉 master,重建四个工作进程与定时器,重建前端镜像,配置周报触发钥匙;选股系统机器拉 main,重启接口容器;干跑三条、真跑两条;当晚核第一次自动周报。
**为什么。** 三个包都是加法、都有开关,一起上省一个窗口;判收读数包的周五二十点十分定时任务正好当天第一次跑,选股系统的周报两行拉代码即生效,当晚的周报就带这两行。
**做哪几件。** 见附录甲的十四步。每一步都写了预期读数与不符合时怎么办。
### 工作包三:09-22 部署评析第二批
**做什么。** 收盘后按附录乙做。先跑材料探针当门槛,再拉 master 到评析第二批那个提交,开定性总开关,重建工作进程与定时器。十六点零五起全量重跑,当晚与次日看读数。
**为什么。** 评析版本升到 2026.09-3,一到基座机就是一次全量重跑,所以要独立一个窗口、事先预判费用与时长,并且只在材料探针过线后才开定性。
**做哪几件。** 见附录乙。
### 工作包四:09-29 部署评析第三批
**做什么。** 收盘后按附录丙做。拉 master 到开发分支末尾,重建工作进程与定时器,同一窗口重建前端镜像。当晚单家带评议试跑,次日看分布。
**为什么。** 评析版本升到 2026.09-4、评议版本升到 2026.09-2,又一次全量重跑。摘要里的预期键从字符串改成了对象,旧前端拿到对象会把评析块渲染崩掉,所以前端镜像必须同窗重建,不能拖到第二天。
**做哪几件。** 见附录丙。
### 工作包五:判收与收尾
**做什么。** 台账四条、交接文档、文档同步、上游同步待办复核、判收读数、总评审。
**做哪几件。**
1. 台账四条按部署日落笔,编号 059 到 062,骨架在附录己。记进选股系统仓库 `docs/复盘决定台账.md`,提交信息带台账号。
2. 交接文档写一份部署后的现状版 `docs/交接_2026-09-19.md`(保运包与判收读数包部署后),09-23 与 09-30 各补一节。四仓库逐字同步,提交信息"交接副本同步"。两份评审记录、三份规格书同步到其余仓库。
3. 交接固定一节"契约清单",登记这一阶段对下游可见的形状变化:摘要新增键(定性、材料数、第二三批计数、周期、论点引用视角),摘要预期键由字符串改为对象(原文本在对象的 text 子键),选股系统新增只读接口,周报第七节多两行。写法是"缺键就是空、旧字段照旧"。
4. 上游同步待办第一条复核日 09-22:日检"财报期覆盖"那一行的读数写回交接。写表方仍未核实的写明"待用户向一百五十三库侧确认"。
5. 09-30 跑判收读数命令,读数原文交回,台账 062 落笔。
6. 十月长假后第一周做总评审:三个部署日的读数、两条判收的八条结论行、人读记录、费用实测与预判的对表。评审记录写 `docs/评审记录_<日期>.md`。
---
## 四、顺序与时间
按交易日排。部署一律收盘后,先经审批。工作进程与定时器一起重建。避开六点十分。09-25 是中秋节,是否休市以交易所日历为准,定时任务照跑。
| 日期 | 星期 | 做什么 |
|---|---|---|
| 09-16 | 三 | 开发者做工作包一:修三处,变基,单测全绿,推远端,交四样证据 |
| 09-17 | 四 | 我复审变基树。通过后本地 master 快进到部署分支并推送;选股系统 main 快进到小改分支并推送。当天把两处推送的提交号写进交接 |
| 09-18 | 五 | 收盘后按附录甲部署。十六点前做完选股系统接口重启,二十点十分第一次自动周报,二十一点前核台账行 |
| 09-19 | 六 | 早上跑日检,看补投结果与新增的行。读数交回 |
| 09-21 | 一 | 早上日检核上周五周报那一行。跑判收读数命令看周报两条已成立。开发者交材料探针读数(附录乙第一步可以提前跑,只读) |
| 09-22 | 二 | 上游同步待办复核日。收盘后按附录乙部署评析第二批。十六点零五起全量重跑 |
| 09-23 | 三 | 第二批首日读数:定性状态分布、单家耗时、集中度判据非空家数。台账 061 落笔。交接补一节 |
| 09-25 | 五 | 二十点十分第二次自动周报 |
| 09-28 | 一 | 第二批一周读数。确认第三批部署条件:定性状态 ok 家数、评议费用实测 |
| 09-29 | 二 | 收盘后按附录丙部署评析第三批,前端镜像同窗重建。当晚单家带评议试跑 |
| 09-30 | 三 | 评析判收第一条到期。跑判收读数命令,读数原文交回。台账 062 落笔。交接补一节 |
| 十月长假后第一周 | | 总评审。人读记录到十份后判收第四条 |
---
## 五、开关与参数
本阶段不新增环境变量。基座机 `.env` 改三处,都在附录写明了在哪一步改、改完要不要重建。
| 键 | 值 | 什么时候 | 属于 |
|---|---|---|---|
| `AKG_BRIDGE_XXL_KEY` | 与选股系统机器上的触发钥匙相同 | 09-18 重建工作进程之前 | 判收读数包 |
| `AKG_COMPANY_REVIEW_QUAL` | 1 | 09-22 重建工作进程之前 | 评析第二批 |
| `AKG_COMPANY_REVIEW_MATERIALS` | 保持默认 1,不写进 `.env` | 不动 | 评析第二批 |
一条说明:`.env` 改了只对重建过的容器生效。接口容器不在重建清单里,所以依赖新键的手工操作一律走投队列的路(周报触发用 `sync=false`),不在接口容器里同步跑。
---
## 六、验证方式
每条命令标明在哪台机器上运行。一个命令块只放一台机器的命令。基座机指 `ssh -p 2280 tlai@192.168.16.178`,仓库在 `~/project/astock-kg`。选股系统机器指 `ssh -p 2280 factor@192.168.16.155`,仓库在 `~/project/akg-factor-bridge`。逐日的命令在附录甲乙丙里按步骤排好,这里只列复审与判收用的。
### 工作包一复审(本地)
**本地。** 变基后的开发分支只含三四两包与可比公司修复。预期文件都在附录己清单内,且 `freshness.py` 的重跑类常量是五类。
```bash
cd /Users/baobao/Documents/work/project/astock-kg && git diff --stat deploy-2026-09-18..nextphase-2026-09 | tail -3 && git show nextphase-2026-09:backend/app/analysis/company_review/freshness.py | grep -n "^REWORK_CATEGORIES"
```
**本地。** 全量单测。预期末两行 `Ran 11x tests` 与 `OK`。
```bash
cd /Users/baobao/Documents/work/project/astock-kg && git worktree add --detach /tmp/akg_review nextphase-2026-09 >/dev/null 2>&1; (cd /tmp/akg_review && PYTHONPATH=backend python3 -m unittest discover -s backend/tests -t backend 2>&1 | tail -3); git worktree remove --force /tmp/akg_review
```
**本地。** 三处修复都在。预期三行依次打出 0、大于 0、大于 0。
```bash
cd /Users/baobao/Documents/work/project/astock-kg && git show nextphase-2026-09:backend/app/analysis/company_review/materials.py | grep -c "ANY(%s) AND timestamp"; git show nextphase-2026-09:backend/app/analysis/company_review/report.py | grep -c "scenario_table"; git show nextphase-2026-09:backend/app/analysis/company_review/synthesis.py | grep -c 'MCSRGKPL\]\\d+\\]?'
```
**基座机(开发者在修复后跑,只读)。** 可比公司价格查询在代理库上真的能跑。预期打出三行,每行一个前缀式代码与两个数。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python -c "
from app.store.market_snapshot import _proxy_conn
sql = ('SELECT symbol, timestamp, pe_ttm, pb FROM gp_day_basic WHERE symbol IN (%s, %s, %s) AND timestamp >= %s ORDER BY symbol, timestamp')
c = _proxy_conn(); cur = c.cursor(); cur.execute(sql, ('SH600519', 'SZ000858', 'SH600809', '2026-09-10'))
rows = cur.fetchall(); print(len(rows)); [print(r) for r in rows[-3:]]"
```
### 判收读数(基座机,09-21、09-30 与长假后各一次)
预期四节都出;第四节八行里,09-21 起"周报有质地分组读数"与"周报有五日头二十日头两行"成立,"报告与评议不落后最新财报期"到 09-30 按两个比例判,"人读评议有增量"不足十份写人核。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/acceptance_readings.py
```
### 日检(基座机,每个部署日的次日)
预期新增的行都出现且分级正确:财报期覆盖四行、调度台账两行加补投任务运行行、采集需求一行、人读记录一行、周报触发一行。
```bash
cd ~/project/astock-kg && bash daily_check.sh
```
---
## 七、回退
每个部署日独立回退,事先写好,机器上不改代码。
| 部署日 | 回退方式 | 代价 |
|---|---|---|
| 09-18 基座 | 开关级:`AKG_EXTRACT_ACKS_LATE=0`、`AKG_REQUEUE_ENABLED=0`、`AKG_MATERIAL_DEMANDS_ENABLED=0`、`AKG_BRIDGE_XXL_KEY` 置空,重建工作进程与定时器。代码级:基座机 `git checkout 3f45294`(只在开关级不够时用,事后要回到 master) | 台账表留着无害;已补投的文档照常抽取 |
| 09-18 选股系统 | `git checkout 3d3f317` 后重启接口容器 | 周报少两行;只读接口 404,判收命令那两条回到"未实现" |
| 09-22 第二批 | `AKG_COMPANY_REVIEW_QUAL=0` 重建工作进程:文本判据全部算不了、六段齐。指纹不含定性后每家再算一次数字部分,评议随批次再跑一遍,费用约一次全量评议 | 不回退版本号,避免再一次全量重跑 |
| 09-29 第三批 | 基座机 `git checkout <第二批那个提交>` 并重建工作进程、定时器与前端。版本回到 2026.09-3 会再触发一次全量重跑 | 约一次全量评议的费用。只在第三批让报告出错时用 |
---
## 八、拍板点
前两份规格书的拍板点继续有效。本阶段代定十条,动工前不再问。要改就在这里改。
1. 可比公司查询的修复不另开评审轮次,随变基树一起复审。
2. 09-18 的窗口同时做基座部署与选股系统的拉代码加接口重启,十六点前做完,不撞二十点十分的周报。
3. 第二批与第三批仍分两次部署(沿用上一阶段拍板十六)。代价是两次全量重跑,各约一百九十万 token 的评议加一天的本地定性产能。如果要省一次,可以把两批合到 09-29 一起上,代价是失去第二批单独观察一周的机会。默认分两次。
4. master 只快进合并,不打合并提交。变基后的开发分支推到远端当备份,部署前机器只从 master 拉。
5. 09-29 第三批部署与前端镜像重建必须同一窗口。
6. 09-25 中秋的周报照常触发,休市与否不影响。
7. 摘要预期键由字符串改成对象,接受。理由是没有任何下游读它,原文本保留在 text 子键,前端已兼容两种形状。条件是写进交接的契约清单。
8. 在飞集合解析器不加"全部解析失败返回未知"的保护。消息格式已经与容器里的消息库源码核对一致;09-18 补投首批之后队列非空,用附录甲第十一步的探针实测一次。
9. 材料只在带定性的运行里收集,波特、马克斯、邱国鹭里靠材料的判据在不带定性的运行里算不了。这是上一阶段附录丙的设计,本阶段不改。定性开着时每家每天都会轮到一次带定性的运行,最终落库的那一行有材料。
10. 台账编号 059 到 062 沿用。
一条留给这一阶段之后拍板的清单,写在第十一节。
---
## 九、交付要求
给动手的人,人和大模型一样。
1. 每个部署日交一份部署记录,追加进当期交接文档:做了哪几步、每步的命令与输出原文、北京时刻、谁批的、机器上的提交号、`.env` 改了哪些键(不写值)。
2. 每个部署日次日交日检原文与第六节读数原文。
3. 工作包一交三样证据:修复提交号、变基后两个包的新提交号、单测末两行。附一句变基时怎么解决冲突的。
4. 机器上只做 `git pull` 与 `git checkout <提交号>`(回退时),不跑 `git stash`,不改代码。
5. 每一步失败就停,记下输出,按第七节回退,交回。不在机器上排查超过十分钟。
6. 工作区里 `CLAUDE.md` 有用户未提交的改动,任何提交都不纳入它。
7. 凡新增打一百五十三代理库的查询,交付证据要含基座机上一次只读实跑的输出。离线单测注入假数据,查不出方言与类型问题,本轮的可比公司查询就是这样漏网的。
---
## 十、评审方式
评审者逐条核,评审者可以是大模型。
### 工作包一(部署前)
按第六节"工作包一复审"三条命令核,再读变基树上两个包的 diff 与部署分支 diff 的差异:预期只有新鲜度模块的冲突解法与可比公司修复。判定只有两档:通过,或退回重新变基。
### 每个部署日(部署后)
| 证据项 | 要交什么 | 怎么核 |
|---|---|---|
| 部署记录 | 第九节第一条 | 与附录操作单逐步对,少一步记不符 |
| 机器提交号 | `git log -1` 原文 | 与 master 推送的提交号一致 |
| 干跑与真跑输出 | 原文 | 与附录里的预期逐条对 |
| 次日日检 | 原文 | 新增行都在、分级正确 |
| 判收读数 | 原文 | 与第六节预期对 |
| 台账与交接 | 提交号 | 打开看,五段式齐 |
判定三档同前:通过、有条件通过(只差样本类读数)、退回(部署记录与操作单不符、读数与预期量级不符、或机器上改了代码)。
---
## 十一、这一阶段之后
下面这些不在本阶段做,列出来供总评审时拍板。每条一句现状、一句为什么值得做。
1. 估值类读数的刷新。现价、市盈率、区间位置、一致预期只在报告期或版本变化时刷新,因为价格日不进指纹。可以考虑每周一次强制刷新数字部分而不动评议。
2. 定性结果按材料指纹复用。版本号一升,本地定性对同一份材料再跑一遍。可以把定性结果按材料指纹与定性版本缓存,升版时只重算数字与评议。
3. 环节投影成员数偏小。白酒环节投影里只有一家,竞争者数量判据对多数公司算不了。要么补投影,要么换数据源。
4. 二十日头的判分。择时决策系统的判分表里还没有 pv_h20,周报那一行长期是"本期无判分记录",要在择时决策系统那边补。
5. 上游供应商指标表的半年报同步。写表方还没核实,比率类指标停在一季报,判收第一条到期那天大概率靠重构报表那一键过线。
6. 人读记录的用法。十份之后除了判收,是否让"没有多说"的评议进入评议提示词的反例。
---
## 附录甲(可不读):09-18 操作单
北京时间十五点十分以后开始。做之前确认:本地 master 已快进到部署分支并推送;选股系统 main 已快进并推送;用户已批准重建四个工作进程、定时器、前端镜像与选股系统接口容器。
**第一步(基座机)。** 拉代码。预期打出 79abcf2 那一行,状态里只有 `data/whitelist_probe/tmp` 下几处旧文件的删除。
```bash
cd ~/project/astock-kg && git pull && git log --format='%h %s' -1 && git status --short | head -5
```
**第二步(基座机)。** 配置钥匙。把 `AKG_BRIDGE_XXL_KEY=<与选股系统相同的钥匙>` 追加进 `.env`。预期打出 1。
```bash
cd ~/project/astock-kg && grep -c '^AKG_BRIDGE_XXL_KEY=' .env
```
**第三步(基座机,经审批)。** 重建四个工作进程与定时器。预期五个服务都是 Started 或 Recreated。
```bash
cd ~/project/astock-kg && docker compose up -d --force-recreate worker worker-interactive worker-targeted worker-review beat
```
**第四步(基座机,经审批)。** 重建前端镜像。预期构建成功、容器 Started。
```bash
cd ~/project/astock-kg && docker compose up -d --build frontend
```
**第五步(基座机)。** 晚确认生效。预期 `worker_prefetch_multiplier` 为 1,`visibility_timeout` 为 21600。
```bash
cd ~/project/astock-kg && docker compose exec -T worker celery -A workers.tasks inspect conf 2>/dev/null | grep -i "prefetch_multiplier\|visibility"
```
**第六步(基座机)。** 补投干跑。预期花名册约五百八十一份,两条队列都有数,`inflight_n` 是 0(队列现在是空的),`withheld_by_reason` 里没有 `stale_unknown_inflight`。不符合就停。
```bash
curl -s -X POST 'http://192.168.16.178:8000/admin/requeue_no_run?dry_run=true' | python3 -m json.tool | head -30
```
**第七步(基座机)。** 假需求单核销干跑。预期约五千零四十一张单各带年报文档号,末尾计数,不写库。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/fulfill_annual_demands.py | tail -5
```
**第八步(基座机)。** 材料需求单干跑。预期目标约一百二十家,研报缺口几十家,理由含"主榜第 n 名"。
```bash
curl -s -X POST 'http://192.168.16.178:8000/admin/review_material_demands?dry_run=true' | python3 -m json.tool | head -40
```
**第九步(基座机,经用户同意)。** 假需求单核销真跑。预期写库前再打印一遍计数,末行是已核销张数。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/fulfill_annual_demands.py --apply | tail -5
```
**第十步(基座机,经用户同意)。** 补投首批真跑。走即时队列,不在接口容器里跑。预期返回 `status` 是 queued;两分钟后两条队列长度合计约五百八十一。
```bash
curl -s -X POST 'http://192.168.16.178:8000/admin/requeue_no_run'; sleep 120; cd ~/project/astock-kg && docker compose exec -T redis redis-cli LLEN celery && docker compose exec -T redis redis-cli LLEN targeted
```
**第十一步(基座机)。** 在飞集合解析实测。队列非空时取一条消息交给解析函数。预期打出一个集合,里面有一个文档号。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python -c "
import redis; from app.config import get_settings; from app.orchestration.dispatch_policy import inflight_doc_ids
r = redis.Redis.from_url(get_settings().redis_url); raw = r.lrange('celery', 0, 0) or r.lrange('targeted', 0, 0)
print(inflight_doc_ids([x.decode() for x in raw]))"
```
**第十二步(基座机)。** 判收读数基线与周报触发干跑。预期判收命令四节都出、八行结论;周报干跑返回 `state` 为 `dry_run`,任务运行台账多一行。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/acceptance_readings.py | tail -12 && curl -s -X POST 'http://192.168.16.178:8000/admin/trigger_plan_review?dry_run=true'
```
**第十三步(选股系统机器,经审批,十六点前)。** 拉代码并重启接口容器,再预热计划接口。预期打出 bb286c5 那一行;重启后计划接口在两秒内返回。
```bash
cd ~/project/akg-factor-bridge && git pull && git log --format='%h %s' -1 && docker compose restart akg-factor-bridge && sleep 5 && curl -s -o /dev/null -w '%{http_code} %{time_total}s\n' 'http://192.168.16.155:8300/plan/today' && curl -s 'http://192.168.16.155:8300/review/latest' | python3 -m json.tool | head -12
```
**第十四步(基座机,二十一点后)。** 核第一次自动周报。预期最近一行 `job` 是 plan_review、`state` 是 success、`task_id` 非空、`artifact` 以 .md 结尾。不是 success 就把整行交回,不重跑。
```bash
cd ~/project/astock-kg && docker compose exec -T postgres psql -U akg -d akg -c "SELECT job, state, task_id, artifact, triggered_at AT TIME ZONE 'Asia/Shanghai' AS bj FROM job_runs ORDER BY triggered_at DESC LIMIT 5;"
```
**次日与周一(基座机)。** 日检;无运行记录数与补投任务的运行行;批任务干跑看名额。
```bash
cd ~/project/astock-kg && bash daily_check.sh; docker compose exec -T postgres psql -U akg -d akg -c "SELECT count(*) AS no_run FROM documents d WHERE d.raw_uri IS NOT NULL AND NOT EXISTS (SELECT 1 FROM extraction_runs er WHERE er.doc_id=d.doc_id);" -c "SELECT job, state, triggered_at AT TIME ZONE 'Asia/Shanghai' AS bj FROM job_runs WHERE job='requeue_no_run' ORDER BY triggered_at DESC LIMIT 3;"; curl -s -X POST 'http://192.168.16.178:8000/admin/company_review_batch?dry_run=true' | python3 -m json.tool | head -20
```
预期:日检新增行都出现;无运行记录数比五百八十一明显下降;补投任务运行行在两小时内;批任务 `counts` 里 `recent_no_data` 不在重跑名单,同一家公司不连续两个整点出现在 `picked` 里。
---
## 附录乙(可不读):09-22 操作单
做之前确认:本地 master 已快进到变基后"评析第二批返工"那个提交并推送;用户已批准重建工作进程与定时器。
**第一步(基座机,可以提前到 09-21 跑,只读)。** 材料探针。预期二十家里至少十四家有年报且解析缓存命中,其中至少十二家三类章节各有一段。低于线不开定性,先补材料。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/company_review_materials_probe.py --top 20 | tail -8
```
**第二步(基座机)。** 拉代码。预期打出变基后"评析第二批返工"那个提交。
```bash
cd ~/project/astock-kg && git pull && git log --format='%h %s' -1
```
**第三步(基座机)。** 开定性总开关:`.env` 追加 `AKG_COMPANY_REVIEW_QUAL=1`。预期打出 1。
```bash
cd ~/project/astock-kg && grep -c '^AKG_COMPANY_REVIEW_QUAL=1' .env
```
**第四步(基座机,经审批)。** 重建工作进程与定时器。
```bash
cd ~/project/astock-kg && docker compose up -d --force-recreate worker worker-interactive worker-targeted worker-review beat
```
**第五步(基座机)。** 单家定性试跑,不落库,盘后走本地档。预期 `qual_status` 为 ok、三次调用、耗时低于六分钟;波特那张表里最大客户占比与最大供应商占比至少一条有读数;日志里三次 `finish=stop`。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/company_review_run.py --code <当天主榜第一只> --with-qual --no-save --print | head -80
```
**第六步(基座机)。** 批任务干跑。预期 `counts` 里几乎全部是 `version_changed`,`picked` 前十家带 `with_qual` 真。
```bash
curl -s -X POST 'http://192.168.16.178:8000/admin/company_review_batch?dry_run=true&max_n=30' | python3 -m json.tool | head -40
```
**第七步(基座机,次日早上)。** 定性状态分布与集中度判据。预期一天里定性状态 ok 不少于一百家;`qual_used` 为真的行里没有 daily_cap、no_tier、materials_error;波特不是"证据不足"的家数大于零。
```bash
cd ~/project/astock-kg && docker compose exec -T postgres psql -U akg -d akg -c "SELECT qual_used, qual_status, count(*) FROM company_review_runs WHERE ran_at >= now() - interval '1 day' GROUP BY 1,2 ORDER BY 1,2;" -c "SELECT count(*) FROM company_review_runs WHERE ran_at >= now() - interval '1 day' AND (grades->>'porter') <> '证据不足';" -c "SELECT count(*), sum(tokens) FROM company_review_runs WHERE brain_used AND ran_at >= now() - interval '1 day';"
```
**预判(写进交接,次日对表)。** 全量重跑一百二十家。数字部分每批三十家四批铺满;定性每批十家、当日上限二百,盘后本地档每家三到五分钟三次调用;09-23 盘中六批约六十家走云端溢出档。评议随定性,一百二十家约一百九十万 token。
---
## 附录丙(可不读):09-29 操作单
做之前确认:本地 master 已快进到开发分支末尾并推送;用户已批准重建工作进程、定时器与前端镜像。
**第一步(基座机)。** 拉代码。预期打出开发分支末尾那个提交。
```bash
cd ~/project/astock-kg && git pull && git log --format='%h %s' -1
```
**第二步(基座机,经审批)。** 重建工作进程与定时器,同一窗口重建前端镜像。前端不重建,旧页面拿到对象形状的预期键会把评析块渲染崩掉。
```bash
cd ~/project/astock-kg && docker compose up -d --force-recreate worker worker-interactive worker-targeted worker-review beat && docker compose up -d --build frontend
```
**第三步(基座机)。** 可比公司价格查询在代理库上真的能跑。预期打出一个非空字典,键是前缀式代码。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python -c "
from app.analysis.company_review import materials as M
print({p['code']: p.get('pe') for p in M._segment_peers('600519.SH')})"
```
**第四步(基座机)。** 单家带评议,落库并忽略指纹。预期第五段有"引用视角"行,反方每条带视角编号,视角分歧非空或写"无";去掉 `--force` 再跑返回 `skipped_fresh`。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/company_review_run.py --code <当天主榜第一只> --force --with-qual --with-brain --print | head -120
```
**第五步(基座机,次日早上)。** 预期差分布与反方非空占比;一家的自由现金流收益率量纲。预期反方非空占比不低于七成;自由现金流收益率在正负百分之三十以内。
```bash
cd ~/project/astock-kg && docker compose exec -T postgres psql -U akg -d akg -c "SELECT percentile_cont(ARRAY[0.1,0.5,0.9]) WITHIN GROUP (ORDER BY (summary->'expectation'->>'gap_pts')::float) FROM company_review_runs WHERE status='ok' AND summary->'expectation'->>'gap_pts' IS NOT NULL;" -c "SELECT count(*) FILTER (WHERE summary->>'antithesis' IS NOT NULL) AS anti, count(*) FROM company_review_runs WHERE brain_used AND ran_at >= now() - interval '1 day';" && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/company_review_run.py --code 600519.SH --no-save --print | grep -n "自由现金流收益率"
```
**页面判收。** 打开一家评议成功的个股页,评析块的"一致预期"一行末尾带"预期差 x 个点"。
**预判(写进交接,次日对表)。** 版本号再升一次,第二次全量重跑一百二十家。定性没有按材料指纹复用的机制,每家的定性会再跑一遍:盘后本地档零费用、每家三到五分钟,盘中溢出云端每家几分钱。评议一百二十家约一百九十万 token。上一阶段规格书附录丁七写的"定性复用"不成立,以这里为准。
---
## 附录丁(可不读):分支整合操作
在本地做,开发者执行。工作区里 `CLAUDE.md` 有用户未提交的改动,它在各分支上内容相同,切换分支会把改动带着走,不要动它,也不要 `git stash`。
**一、可比公司修复先提交到开发分支。** 见附录戊。
**二、变基。**
```bash
cd /Users/baobao/Documents/work/project/astock-kg && git checkout nextphase-2026-09 && git rebase deploy-2026-09-18
```
预期在"评析第二批返工"那个提交停下,冲突两个文件:`backend/app/analysis/company_review/freshness.py` 与 `backend/tests/company_review/test_freshness.py`。解法:
- 重跑类常量取五类:`("never_run", "stale_run", "version_changed", "brain_pending", "qual_pending")`。保留部署分支那段"近期无数据不进重跑类"的注释,再加一句待定性的注释。
- 年龄函数用部署分支的版本,收整行 `_age(row, now)`,取运行时刻与核对时刻里更新的那个。
- 分类函数用开发分支的签名(带 `with_qual`),里面调用 `_age(row, now)`。
- 单测两边都保留:无数据不重跑、年龄看核对时刻、待定性两例、材料太薄不待定性。
解完 `git add` 两个文件,`git rebase --continue`。后面的提交预期自动通过。
**三、验证并推送。**
```bash
cd /Users/baobao/Documents/work/project/astock-kg && PYTHONPATH=backend python3 -m unittest discover -s backend/tests -t backend 2>&1 | tail -3 && git push -u origin deploy-2026-09-18 && git push -u origin --force-with-lease nextphase-2026-09
```
预期末两行 `Ran 11x tests` 与 `OK`。开发分支变基后历史改写,推送用 `--force-with-lease`,只允许对这一条分支。
**四、09-17 并入 master(我复审通过后,开发者或我执行)。**
```bash
cd /Users/baobao/Documents/work/project/astock-kg && git checkout master && git merge --ff-only deploy-2026-09-18 && git push origin master && git log --format='%h %s' -1
```
选股系统仓库同样:`git checkout main && git merge --ff-only wp5-review-latest && git push origin main`。两处推送的提交号写进交接。
**五、09-22 与 09-29 的快进。** 09-22 把 master 快进到变基后"评析第二批返工"那个提交:`git merge --ff-only <该提交号>`,推送。09-29 快进到开发分支末尾:`git merge --ff-only nextphase-2026-09`,推送。两次都先在本地跑一遍全量单测。
---
## 附录戊(可不读):评析第三批的三处修复
行号按开发分支 4bb7138 的树。
### 戊一、可比公司查询
`backend/app/analysis/company_review/materials.py` 的 `_segment_peers`(约第 365 行):
```python
cur.execute("SELECT symbol, timestamp, pe_ttm, pb, total_mv FROM gp_day_basic "
"WHERE symbol = ANY(%s) AND timestamp >= %s", (symbols, since))
```
`symbol = ANY(数组)` 是 Postgres 写法。代理库走 MySQL 协议(`market_snapshot._proxy_conn` 用的是 pymysql),这句在代理上报语法错,被外层的 `except` 吞掉,`px` 为空,所有可比公司的市盈率都写"缺",`peers_pe_median` 永远算不了。离线单测注入的是假数据,所以没发现。
改法:抽一个纯函数拼 SQL,显式占位符。
```python
def _peer_px_sql(n: int) -> str:
"""可比公司价格查询:一张表、显式占位符,n 是代码个数。不用 ANY(),代理库是 MySQL 协议。"""
marks = ", ".join(["%s"] * n)
return ("SELECT symbol, timestamp, pe_ttm, pb, total_mv FROM gp_day_basic "
f"WHERE symbol IN ({marks}) AND timestamp >= %s")
```
调用处改成 `cur.execute(_peer_px_sql(len(symbols)), (*symbols, since))`。同一处再改四件:游标取回的市盈率、市净率过 `fin_statements._num`,日期过 `fin_statements._td`,不直接用原值(上游类型不可信,可能是十进制或字符串);`since` 用数据截至日 `asof` 减十天,不用容器当天;取成员的查询(约第 351 行)加 `ORDER BY ts_code` 再截前十家,让可比代码集合与材料指纹稳定;代理库异常不再裸吞,记 `errors["peers_px"]` 并写警告日志。顺手把 `_segment_peers` 里重复的一次 `_segment_member_counts` 去掉,主环节名从 `_default_fetch` 传进来。
单测 `test_peer_px_sql_no_any`:`_peer_px_sql(3)` 不含 `ANY(`,含三个 `%s` 加日期的一个,共四个占位符。修完在基座机跑第六节那条只读探针,输出进交付证据。
### 戊二、达摩达兰对照表进报告
`lenses/damodaran.py:58` 返回值里的 `scenario_table` 目前没人消费。两处改:`runner.py:231-232` 侧车的每个视角项加 `"table": r.get("scenario_table")`(其他视角没有就是空);`report.py` 第四段(约第 147 到 166 行)在一致预期之后渲染这张表,表头是情景、情景价、所需增速、所需净资产收益率、所需市盈率,三行悲观、中性、乐观,无一致预期时写"无一致预期,对照表算不了"。评议的输入不用改,判据行已经带了这些数。单测 `test_report_has_damodaran_table`:合成数据下报告第四段含表头那一行。
### 戊三、评议数字回查跟上新编号
`synthesis.py:189` 的剥离正则第一项 `\[?[MC]\d+\]?` 改成 `\[?[MCSRGKPL]\d+\]?`,与第 254 行的引用正则同源,最好从同一个前缀常量拼出。单测 `test_numbers_check_ignores_new_refs`:正文"[L13] 与 S14 支持这一点"经 `numbers_check` 后未核数字为零。
三处提交信息合成一条也可以:"评析第三批修复:可比公司查询改显式占位符并归一类型、达摩达兰对照表进报告、数字回查认新编号"。
---
## 附录己(可不读):台账骨架与文件清单
**台账四条的骨架(五段式,记进选股系统仓库 `docs/复盘决定台账.md`)。**
- 059 · 2026-09-18 · 保运甲:质地证据线的报告期口径改为两表各自最新期。依据:供应商指标表半年报只同步一百六十五家。预期:目标名单里报告期不落后应披露期的比例升到九成以上。复核日 09-30。
- 060 · 2026-09-18 · 判收读数包与周报触发:一条命令出两条判收读数,周五二十点十分基座触发周报,周报加两个头两行与只读接口。预期:09-18 与 09-25 两次自动周报都有台账行。复核日 09-28。
- 061 · 2026-09-22 · 评析第二批:评析版本升 2026.09-3,五个定性视角,本地为主盘中溢出云端。预期:上线次日定性状态 ok 不少于一百家。复核日 09-30。
- 062 · 2026-09-29 · 评析第三批:评析版本升 2026.09-4,四个预期视角,评议引用视角与材料编号。预期:反方非空占比不低于七成。复核日十月长假后第一周。
**本阶段会动的文件。**
工作包一:`backend/app/analysis/company_review/{materials,runner,report,synthesis}.py`、`backend/tests/company_review/{test_materials,test_company_review,test_synthesis}.py`(三处修复);`backend/app/analysis/company_review/freshness.py`、`backend/tests/company_review/test_freshness.py`(变基冲突解法)。清单外一律不动。
工作包五:`docs/交接_2026-09-19.md`(新)、`docs/评审记录_<日期>.md`(新)、四仓库的同步副本;选股系统仓库 `docs/复盘决定台账.md`。
机器上改动的只有 `.env` 的两个键,都在第五节。