17 KiB
评审记录(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]))
四、逐条核对与不符项
行号按各自分支的树。
工作包一:保运包修复
上一份评审记录条件级一到四逐条核:
- 无数据不重跑。
freshness.py重跑类常量去掉了近期无数据,分类函数照旧返回这一类。单测test_recent_no_data_not_reworked。 - 年龄看核对时刻。
freshness.py的年龄函数收整行,取运行时刻与核对时刻里更新的那个。单测test_age_uses_checked_at。 - 在飞集合。
dispatch_policy.py新增纯函数解析消息,tasks.py新增读 Redis 两条列表与未确认哈希的函数,异常返回未知。四例单测。解析器假设与容器里的消息库源码一致。 - 四十八小时判据。补投与材料需求单每轮末各记一行任务运行台账,日检改读它,三档文案正确。日检里的当前时刻带时区,与台账列相减不会出错。
建议级三条与两处注释都改了。年报口径两个常量为单一事实源,花名册按队列各查一次且空来源类型归默认队列,核销脚本取文档号加了排序。删掉的重复常量在整棵树里没有残留引用。
不符项:无。
判定:有条件通过。 条件是运行样本类读数,按部署日交回。
工作包二:判收读数包修复
条件级一到四逐条核:
- 技术面那一列改读技术面对象并按类型判;退路 SQL 拆成两列。
- 八条结论行改成四加四,键与标签逐条对应两份方案第七节;人核项打印读数;周报两条按选股系统只读接口的标记计数判,接口不可用写"不成立(未实现)";退路模式下两个头那条写人核。评析一按报告不落后与评议不落后两个比例判。
- 判收日期改东八区日期。
- 周报台账通用化成
job_runs,无钥匙落跳过行,干跑落行,任务号进列,运行中的行不写结束时刻。轮询遇认证错立即返回、服务端错连续三次返回。两张台账表的建表语句同源追加进了初始化脚本。
建议级:判收命令第三节把选股系统接口的 404 一律写成"没有周报",但接口还没上线时 404 的含义是"路由不存在"。可以按响应体里的说明区分,不影响结论行(两种都判"不成立(未实现)")。
不符项:无。
判定:有条件通过。 条件同工作包一。
工作包三:评析第二批返工
上一份评审记录退回级两条、新发现的集中度缺陷、条件级三到五逐条核:
- 盘中判定。
runner.py:15-17直接导入端点池的判定函数,runner.py:79用它选档位,自写窗口已删。单测钉住同一对象。 - 定性指纹。
runner.py:263-275只有定性状态是 ok 或 half 才落含定性的指纹并记已做定性,其余落素指纹、记原因。当日上限按已做定性计数,被挡下的不再计入。单测两种情形都有强断言。 - 图谱带方向。
materials.py图谱材料的键、meta 与指纹都带方向,波特集中度可算。单测用注入的两出一入三条边。 - 待定性类。
freshness.py:70-71加待定性,材料太薄按新鲜;tasks.py:1819-1821待定性而没拿到定性名额的从投递名单去掉。单测两例。 - 主环节成员数。
materials.py从环节投影表两条本地查询取成员数与主环节;波特成员少于三家值照记、判定留空、备注写明。 - 单家入口。接口透传定性参数,脚本加档位覆盖参数并写进首行说明。
一处口径要写清:材料只在带定性的运行里收集。定性开着时每家每天轮到一次带定性的运行,最终落库的那一行有材料。这是上一阶段附录丙的设计,不算不符。
不符项:无。变基后 freshness.py 要与部署分支的改动调和,开发者在提交正文里已写明。
判定:通过(复审级)。 条件是变基后我重核一次 diff 与单测。
工作包四:评析第三批
指标与视角逐条核过附录丁,十四个指标的公式与单位都对:比率经百分数换小数,市值万元折元,预期差乘一百成百分点;除零与负基数有拦截;阈值方向没有写反。评议扩展、摘要三键、第二批遗留条件级六到十二全部落地。四例视角单测、五例评议单测、三例定性单测、三例材料单测数量与规格一致。
条件级,09-29 部署前修并补单测:
- 可比公司价格查询在生产上必失败。
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。 - 达摩达兰三情景对照表没有进报告。
lenses/damodaran.py:58只把表放在返回值里,runner.py:231-232侧车不带它,report.py:147-166第四段不渲染它。规格附录丁三明写"对照表进报告第四段"。人看不到,评议也拿不到。 - 数字回查没有跟上新编号。
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 上午到中午,北京时间。评审用到的读数命令与探针见第三节,可重跑;三棵游离检出树在临时目录,没有切换任何分支。
八、工作包一复审补记(09-16 下午)
开发者当天下午做完《部署与判收阶段方案与规格书_2026-09-16》的工作包一:三处修复提交 1f98743,开发分支变基到 master 之上并推送,master 快进到部署分支 79abcf2 并推送。我按该规格书第六节复审。
证据。
- 拓扑:远端 master 与本地 master、部署分支同在 79abcf2,历史从 3f45294 起线性;master 是开发分支的祖先;开发分支远端与本地同在 1f98743。09-22 快进点是 0eafe41(评析第二批返工),09-29 快进点是开发分支末尾。
- 变基保真:用
git range-diff逐个比较八个重放的提交,七个与原补丁逐字相同,只有评析第二批返工那一个因冲突解法不同,正是预判的那处。 - 冲突解法:新鲜度模块的重跑类是五类(去掉近期无数据、加待定性),年龄函数收整行取运行时刻与核对时刻里更新的那个,分类函数带定性参数;单测取并集共十二例。
- 单测:开发分支末尾一百三十四例 OK,等于原开发分支一百二十加保运与判收的十四例。
- 三处修复的读数:可比公司查询里 Postgres 写法零处,报告模块渲染达摩达兰表两处,评议剥离正则含全集字母四处。diff 逐行读过:可比公司查询改成逐个占位符的 IN、市盈率与市净率过数值归一、时间戳过日期归一、成员查询加排序、代理异常记进材料错误字典;达摩达兰表进侧车与报告第四段;剥离正则与引用正则同字母集。四例新单测名为 test_scenario_table_in_report、test_peer_query_mysql_dialect_and_norm、test_peer_proxy_error_records_and_degrades、test_ref_codes_stripped_before_recheck。
- 方言探针(基座机,只读,09-16 下午):修复后的写法在代理库上返回十二行,市盈率与市净率的类型是十进制数,时间戳是日期时间型,所以数值与日期归一是必需的;原来的
ANY(%s)写法在代理库上报 MySQL 语法错 1064。这条补上了工作包一唯一缺的证据。 - 用户未提交的
CLAUDE.md改动仍在工作区,内容是流程纪律那一段,没有进任何提交。
判定:通过。 09-18 可以按附录甲部署。
顺手做的一件事。 选股系统仓库的 main 快进到小改分支末尾 dc94bbf 并推送,工作区切回 main。这是规格书附录丁第四步,09-18 选股系统机器拉代码的前提。
留给部署日之后的建议级(可作为可选小包,见规格书拍板点十一)。 覆盖机构只有一家时不算预期差与市盈率对增速;马克斯毛利判据用最新年度;市盈率小于等于零时三条市盈率比值算不了;评议预期字段校验认预期视角判据编号;可比公司取价的起始日用数据截至日;可比公司函数里重复的一次成员数查询;判收命令把路由不存在的 404 与"没有周报"分开;评议渲染 5.3 标题改"八字段"。