41 KiB
数据基座部署与判收阶段方案与规格书(2026-09-16)
承接《收尾阶段开发方案与规格书_2026-09-15》与两份评审记录(开发者的《评审记录_2026-09-16》、评审者的《评审记录_2026-09-16_复审》)。 开发者可以是人,也可以是大模型。写法遵守
.claude/output-styles/readable-chinese.md。 第一到第十节是正文。附录是逐日操作单与实现细节,标了「可不读」,但动手的人当天必须照附录逐步做。 基线(09-16 下午更新,工作包一已完成并复审通过):数据基座master本地与远端同在 79abcf2,基座机master停在 3f45294 等 09-18 拉;开发分支nextphase-2026-09已变基到 master 之上并推送,09-22 快进点是 0eafe41,09-29 快进点是开发分支末尾(写本节时是三处修复 1f98743)。选股系统仓库main本地与远端同在 dc94bbf(含小改 bb286c5),选股系统机器停在3d3f317等 09-18 拉。 本文件落盘为docs/部署与判收阶段方案与规格书_2026-09-16.md,同步到选股系统仓库的 docs。
一、这件事为最终目标买什么
最终目标不变。判收标准不变:只看系统逻辑、实现、设计目标三者是否一致,不看收益。
上一阶段的五个开发工作包今天全部交付,开发者做了内部评审,我做了复审。复审结论:保运包修复、判收读数包修复、评析第二批返工、选股系统小改四个包在代码与离线单测层面没有阻断问题;评析第三批有三处要在部署前修:可比公司的价格查询用了 Postgres 的写法去打 MySQL 协议的代理库,生产上那一路永远取不到价格;达摩达兰的三情景对照表没有进报告;评议的数字回查没有跟上新编号,会把评议误降成半成品。此外复审证实了两件事:在飞集合解析器对消息格式的两个假设与容器里装的消息库源码一致;开发分支并到部署分支只有两个文件冲突,都在新鲜度模块,可控。
所以这一阶段不开新功能。代码已经写完,剩下的全是"放到机器上并证明它按拍板在跑"。做五件事:一,整合分支并修那三处;二,09-18 部署保运包、判收读数包与选股系统小改;三,09-22 部署评析第二批;四,09-29 部署评析第三批;五,判收与收尾,包括台账四条、交接同步、上游同步待办复核、09-30 的判收读数、长假后的总评审。
这一阶段买四样东西。
- 三个工作包在基座机上跑起来,每一处都有当天交回的读数原文。
- 两条判收各出一份可重跑的读数:09-30 评析判收第一条到期那天一份,长假后总评审一份。
- 一条干净的部署线:master 只前进不分叉,基座机只从 master 拉,每次部署都能说出机器上是哪个提交。
- 下一阶段的拍板依据:每次部署的实测读数与费用,加上这一阶段结束时列出的候选方向。
二、原则
沿用前两份规格书的原则。本阶段再加五条,都是部署纪律。
- 每一步先干跑再真跑。干跑输出不符合预期就停,不带着疑问往下走。
- 一个维护窗口只做一件事。09-18 的窗口做三个包的上线,不顺手改别的。
- 读数原文当天交回。部署当天与次日的读数是判收的证据,不能事后凭记忆补。
- 出问题先回退不硬修。回退办法在第七节,每条都事先写好;机器上不改代码、不打补丁。
- master 只做快进合并。合并前本地全量单测必须全绿;合并后立即推送;机器上只做
git pull。
三、做哪几件事
五个工作包,按时间排。
工作包一:分支整合与三处修复(09-16 到 09-17)
做什么。 修评析第三批的三处:可比公司的价格查询、达摩达兰对照表进报告、评议数字回查跟上新编号;把开发分支变基到部署分支之上;解决两处冲突;本地全量单测全绿;把两条分支推到远端。
为什么。 三个开发包分在两条分支上,这是上一阶段拍板定的部署线。现在要把它们按部署顺序排成一条直线,09-18 拉一段,09-22 拉一段,09-29 拉完。三处不修的后果:邱国鹭的"市盈率不超过同环节中位"永远算不了、可比公司材料全写"缺";达摩达兰只有判据没有对照表,人看不到情景反推的数字;评议正文里的视角与材料编号被当成数字回查,未核比例过三成就误降半成品。
做哪几件。
- 修可比公司价格查询。代理库是 MySQL 协议,
symbol = ANY(%s)是 Postgres 写法,要改成显式占位符的IN (...);游标原值过数值与日期归一;取成员的查询加排序再截十家;异常记进材料错误字典。抽出一个拼 SQL 的纯函数,单测钉住它不含ANY(且占位符个数等于代码个数。改完在基座机用只读探针实跑一次这条查询,输出作为证据。 - 达摩达兰的三情景对照表进侧车与报告第四段。单测钉住报告里有那张表的表头。
- 评议的数字剥离正则从只认 M、C 扩到 M、C、L、S、R、G、K、P,与引用正则同源。单测钉住正文里出现 L13 之类的编号不算未核数字。
- 三处各一个提交或合成一个提交都可以,都落在开发分支上。
- 把开发分支变基到部署分支 79abcf2 之上。预期只有新鲜度模块与它的单测冲突,解法在附录丁:重跑类是五类(去掉近期无数据、加待定性),年龄函数收整行,分类函数带定性参数。
- 变基后本地全量单测全绿,预期一百一十九例左右。把部署分支与变基后的开发分支都推到远端。
- 交回四样:三处修复的提交号、变基后开发分支上对应"评析第二批返工"与"评析第三批"的新提交号、单测末两行、可比公司查询在基座机只读实跑的输出。我复审变基树:
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,又一次全量重跑。摘要里的预期键从字符串改成了对象,旧前端拿到对象会把评析块渲染崩掉,所以前端镜像必须同窗重建,不能拖到第二天。
做哪几件。 见附录丙。
工作包五:判收与收尾
做什么。 台账四条、交接文档、文档同步、上游同步待办复核、判收读数、总评审。
做哪几件。
- 台账四条按部署日落笔,编号 059 到 062,骨架在附录己。记进选股系统仓库
docs/复盘决定台账.md,提交信息带台账号。 - 交接文档写一份部署后的现状版
docs/交接_2026-09-19.md(保运包与判收读数包部署后),09-23 与 09-30 各补一节。四仓库逐字同步,提交信息"交接副本同步"。两份评审记录、三份规格书同步到其余仓库。 - 交接固定一节"契约清单",登记这一阶段对下游可见的形状变化:摘要新增键(定性、材料数、第二三批计数、周期、论点引用视角),摘要预期键由字符串改为对象(原文本在对象的 text 子键),选股系统新增只读接口,周报第七节多两行。写法是"缺键就是空、旧字段照旧"。
- 上游同步待办第一条复核日 09-22:日检"财报期覆盖"那一行的读数写回交接。写表方仍未核实的写明"待用户向一百五十三库侧确认"。
- 09-30 跑判收读数命令,读数原文交回,台账 062 落笔。
- 十月长假后第一周做总评审:三个部署日的读数、两条判收的八条结论行、人读记录、费用实测与预判的对表。评审记录写
docs/评审记录_<日期>.md。
四、顺序与时间
按交易日排。部署一律收盘后,先经审批。工作进程与定时器一起重建。避开六点十分。09-25 是中秋节,是否休市以交易所日历为准,定时任务照跑。
| 日期 | 星期 | 做什么 |
|---|---|---|
| 09-16 | 三 | 已完成:工作包一修三处、变基、单测一百三十四例全绿、推远端;复审通过,方言探针在基座机实跑过;master 快进到 79abcf2 并推送;选股系统 main 快进到 dc94bbf 并推送 |
| 09-17 | 四 | 空档。开发者可以开始可选小包(拍板点十一),或者什么都不做。把两处推送的提交号写进交接 |
| 09-18 | 五 | 收盘后按附录甲部署。十六点前做完选股系统接口重启,二十点十分第一次自动周报,二十一点前核台账行 |
| 09-19 | 六 | 早上跑日检,看补投结果与新增的行。读数交回 |
| 09-21 | 一 | 早上日检核上周五周报那一行。跑判收读数命令看周报两条已成立。开发者交材料探针读数(附录乙第一步可以提前跑,只读) |
| 09-22 | 二 | 上游同步待办复核日。收盘后按附录乙部署评析第二批。十六点零五起全量重跑 |
| 09-23 | 三 | 第二批首日读数:定性状态分布、单家耗时、集中度判据非空家数。台账 061 落笔。交接补一节 |
| 09-23 到 09-26 | 三到六 | 可选小包(拍板点十一)开发。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 的重跑类常量是五类。
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。
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。
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+\\]?'
基座机(开发者在修复后跑,只读)。 可比公司价格查询在代理库上真的能跑。预期打出三行,每行一个前缀式代码与两个数。
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 按两个比例判,"人读评议有增量"不足十份写人核。
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/acceptance_readings.py
日检(基座机,每个部署日的次日)
预期新增的行都出现且分级正确:财报期覆盖四行、调度台账两行加补投任务运行行、采集需求一行、人读记录一行、周报触发一行。
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 会再触发一次全量重跑 |
约一次全量评议的费用。只在第三批让报告出错时用 |
八、拍板点
前两份规格书的拍板点继续有效。本阶段代定十条,动工前不再问。要改就在这里改。
- 可比公司查询的修复不另开评审轮次,随变基树一起复审。
- 09-18 的窗口同时做基座部署与选股系统的拉代码加接口重启,十六点前做完,不撞二十点十分的周报。
- 第二批与第三批仍分两次部署(沿用上一阶段拍板十六)。代价是两次全量重跑,各约一百九十万 token 的评议加一天的本地定性产能。如果要省一次,可以把两批合到 09-29 一起上,代价是失去第二批单独观察一周的机会。默认分两次。
- master 只快进合并,不打合并提交。变基后的开发分支推到远端当备份,部署前机器只从 master 拉。
- 09-29 第三批部署与前端镜像重建必须同一窗口。
- 09-25 中秋的周报照常触发,休市与否不影响。
- 摘要预期键由字符串改成对象,接受。理由是没有任何下游读它,原文本保留在 text 子键,前端已兼容两种形状。条件是写进交接的契约清单。
- 在飞集合解析器不加"全部解析失败返回未知"的保护。消息格式已经与容器里的消息库源码核对一致;09-18 补投首批之后队列非空,用附录甲第十一步的探针实测一次。
- 材料只在带定性的运行里收集,波特、马克斯、邱国鹭里靠材料的判据在不带定性的运行里算不了。这是上一阶段附录丙的设计,本阶段不改。定性开着时每家每天都会轮到一次带定性的运行,最终落库的那一行有材料。
- 台账编号 059 到 062 沿用。
- 复审留下的八条建议级合成一个可选小包,09-23 到 09-26 做,随 09-29 一起部署;每条一例单测,一个提交,我在 09-28 复审。清单:覆盖机构只有一家时不算预期差与市盈率对增速;马克斯毛利判据用最新年度毛利率;市盈率小于等于零时三条市盈率比值算不了;评议预期字段校验认预期视角的判据编号与新指标编号;可比公司取价的起始日用数据截至日减十天;去掉可比公司函数里重复的一次成员数查询;判收命令把路由不存在的 404 与"没有周报"分开写;评议渲染 5.3 标题改"八字段"。默认做,开发者空档期做完为止;做不完的留到下一阶段,不因此推迟 09-29。
一条留给这一阶段之后拍板的清单,写在第十一节。
九、交付要求
给动手的人,人和大模型一样。
- 每个部署日交一份部署记录,追加进当期交接文档:做了哪几步、每步的命令与输出原文、北京时刻、谁批的、机器上的提交号、
.env改了哪些键(不写值)。 - 每个部署日次日交日检原文与第六节读数原文。
- 工作包一交三样证据:修复提交号、变基后两个包的新提交号、单测末两行。附一句变基时怎么解决冲突的。
- 机器上只做
git pull与git checkout <提交号>(回退时),不跑git stash,不改代码。 - 每一步失败就停,记下输出,按第七节回退,交回。不在机器上排查超过十分钟。
- 工作区里
CLAUDE.md有用户未提交的改动,任何提交都不纳入它。 - 凡新增打一百五十三代理库的查询,交付证据要含基座机上一次只读实跑的输出。离线单测注入假数据,查不出方言与类型问题,本轮的可比公司查询就是这样漏网的。
十、评审方式
评审者逐条核,评审者可以是大模型。
工作包一(部署前)
按第六节"工作包一复审"三条命令核,再读变基树上两个包的 diff 与部署分支 diff 的差异:预期只有新鲜度模块的冲突解法与可比公司修复。判定只有两档:通过,或退回重新变基。
每个部署日(部署后)
| 证据项 | 要交什么 | 怎么核 |
|---|---|---|
| 部署记录 | 第九节第一条 | 与附录操作单逐步对,少一步记不符 |
| 机器提交号 | git log -1 原文 |
与 master 推送的提交号一致 |
| 干跑与真跑输出 | 原文 | 与附录里的预期逐条对 |
| 次日日检 | 原文 | 新增行都在、分级正确 |
| 判收读数 | 原文 | 与第六节预期对 |
| 台账与交接 | 提交号 | 打开看,五段式齐 |
判定三档同前:通过、有条件通过(只差样本类读数)、退回(部署记录与操作单不符、读数与预期量级不符、或机器上改了代码)。
十一、这一阶段之后
下面这些不在本阶段做,列出来供总评审时拍板。每条一句现状、一句为什么值得做。
- 估值类读数的刷新。现价、市盈率、区间位置、一致预期只在报告期或版本变化时刷新,因为价格日不进指纹。可以考虑每周一次强制刷新数字部分而不动评议。
- 定性结果按材料指纹复用。版本号一升,本地定性对同一份材料再跑一遍。可以把定性结果按材料指纹与定性版本缓存,升版时只重算数字与评议。
- 环节投影成员数偏小。白酒环节投影里只有一家,竞争者数量判据对多数公司算不了。要么补投影,要么换数据源。
- 二十日头的判分。择时决策系统的判分表里还没有 pv_h20,周报那一行长期是"本期无判分记录",要在择时决策系统那边补。
- 上游供应商指标表的半年报同步。写表方还没核实,比率类指标停在一季报,判收第一条到期那天大概率靠重构报表那一键过线。
- 人读记录的用法。十份之后除了判收,是否让"没有多说"的评议进入评议提示词的反例。
附录甲(可不读):09-18 操作单
北京时间十五点十分以后开始。做之前确认:本地 master 已快进到部署分支并推送;选股系统 main 已快进并推送;用户已批准重建四个工作进程、定时器、前端镜像与选股系统接口容器。
第一步(基座机)。 拉代码。预期打出 79abcf2 那一行,状态里只有 data/whitelist_probe/tmp 下几处旧文件的删除。
cd ~/project/astock-kg && git pull && git log --format='%h %s' -1 && git status --short | head -5
第二步(基座机)。 配置钥匙。把 AKG_BRIDGE_XXL_KEY=<与选股系统相同的钥匙> 追加进 .env。预期打出 1。
cd ~/project/astock-kg && grep -c '^AKG_BRIDGE_XXL_KEY=' .env
第三步(基座机,经审批)。 重建四个工作进程与定时器。预期五个服务都是 Started 或 Recreated。
cd ~/project/astock-kg && docker compose up -d --force-recreate worker worker-interactive worker-targeted worker-review beat
第四步(基座机,经审批)。 重建前端镜像。预期构建成功、容器 Started。
cd ~/project/astock-kg && docker compose up -d --build frontend
第五步(基座机)。 晚确认生效。预期 worker_prefetch_multiplier 为 1,visibility_timeout 为 21600。
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。不符合就停。
curl -s -X POST 'http://192.168.16.178:8000/admin/requeue_no_run?dry_run=true' | python3 -m json.tool | head -30
第七步(基座机)。 假需求单核销干跑。预期约五千零四十一张单各带年报文档号,末尾计数,不写库。
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/fulfill_annual_demands.py | tail -5
第八步(基座机)。 材料需求单干跑。预期目标约一百二十家,研报缺口几十家,理由含"主榜第 n 名"。
curl -s -X POST 'http://192.168.16.178:8000/admin/review_material_demands?dry_run=true' | python3 -m json.tool | head -40
第九步(基座机,经用户同意)。 假需求单核销真跑。预期写库前再打印一遍计数,末行是已核销张数。
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/fulfill_annual_demands.py --apply | tail -5
第十步(基座机,经用户同意)。 补投首批真跑。走即时队列,不在接口容器里跑。预期返回 status 是 queued;两分钟后两条队列长度合计约五百八十一。
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
第十一步(基座机)。 在飞集合解析实测。队列非空时取一条消息交给解析函数。预期打出一个集合,里面有一个文档号。
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,任务运行台账多一行。
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 那一行;重启后计划接口在两秒内返回。
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
预期第一行打出 dc94bbf(远端 main 的末尾,含小改 bb286c5),不是 bb286c5 本身。
第十四步(基座机,二十一点后)。 核第一次自动周报。预期最近一行 job 是 plan_review、state 是 success、task_id 非空、artifact 以 .md 结尾。不是 success 就把整行交回,不重跑。
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;"
次日与周一(基座机)。 日检;无运行记录数与补投任务的运行行;批任务干跑看名额。
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 跑,只读)。 材料探针。预期二十家里至少十四家有年报且解析缓存命中,其中至少十二家三类章节各有一段。低于线不开定性,先补材料。
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/company_review_materials_probe.py --top 20 | tail -8
第二步(基座机)。 拉代码。预期打出 0eafe41(变基后的"评析第二批返工")。
cd ~/project/astock-kg && git pull && git log --format='%h %s' -1
第三步(基座机)。 开定性总开关:.env 追加 AKG_COMPANY_REVIEW_QUAL=1。预期打出 1。
cd ~/project/astock-kg && grep -c '^AKG_COMPANY_REVIEW_QUAL=1' .env
第四步(基座机,经审批)。 重建工作进程与定时器。
cd ~/project/astock-kg && docker compose up -d --force-recreate worker worker-interactive worker-targeted worker-review beat
第五步(基座机)。 单家定性试跑,不落库,盘后走本地档。预期 qual_status 为 ok、三次调用、耗时低于六分钟;波特那张表里最大客户占比与最大供应商占比至少一条有读数;日志里三次 finish=stop。
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 真。
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;波特不是"证据不足"的家数大于零。
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 已快进到开发分支末尾并推送;用户已批准重建工作进程、定时器与前端镜像。
第一步(基座机)。 拉代码。预期打出开发分支末尾那个提交。
cd ~/project/astock-kg && git pull && git log --format='%h %s' -1
第二步(基座机,经审批)。 重建工作进程与定时器,同一窗口重建前端镜像。前端不重建,旧页面拿到对象形状的预期键会把评析块渲染崩掉。
cd ~/project/astock-kg && docker compose up -d --force-recreate worker worker-interactive worker-targeted worker-review beat && docker compose up -d --build frontend
第三步(基座机)。 可比公司价格查询在代理库上真的能跑。预期打出一个非空字典,键是前缀式代码。
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。
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
第五步(基座机,次日早上)。 预期差分布与反方非空占比;一家的自由现金流收益率量纲。预期反方非空占比不低于七成;自由现金流收益率在正负百分之三十以内。
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。上一阶段规格书附录丁七写的"定性复用"不成立,以这里为准。
附录丁(可不读):分支整合操作
第一到第四步已在 09-16 执行完毕并复审通过:三处修复 1f98743,变基后开发分支已推送,master 快进到 79abcf2 并推送,选股系统 main 快进到 dc94bbf 并推送。留在这里作为记录与第五步的依据。
在本地做,开发者执行。工作区里 CLAUDE.md 有用户未提交的改动,它在各分支上内容相同,切换分支会把改动带着走,不要动它,也不要 git stash。
一、可比公司修复先提交到开发分支。 见附录戊。
二、变基。
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。后面的提交预期自动通过。
三、验证并推送。
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(我复审通过后,开发者或我执行)。
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 行):
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,显式占位符。
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 的两个键,都在第五节。