方案副本同步:数据基座收尾阶段开发方案与规格书(2026-09-15)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
zlt 2026-09-15 16:58:22 +08:00
parent 8688c8def9
commit 681e1ff06e
1 changed files with 654 additions and 0 deletions

View File

@ -0,0 +1,654 @@
# 数据基座收尾阶段开发方案与规格书(2026-09-15)
> 承接《下一阶段开发方案与规格书_2026-09-15》(下文称"上一阶段规格书")与《评审记录_2026-09-15》(下文称"评审记录")。
> 开发者可以是人,也可以是大模型。写法遵守 `.claude/output-styles/readable-chinese.md`。
> 第一到第十节是正文,读完就知道做什么、为什么、怎么验证、怎么评审。附录是实现细节,标了「可不读」,但开发者动手前必须读自己那个工作包的附录。
> 基线:本地分支 `nextphase-2026-09` 停在 5fef131(保运包 eae5dd1、判收读数包 7ea65c8、评析第二批 66a6dc1、评审记录 5fef131)。本地 `master` 停在 760b04a。基座机 `master` 停在 3f45294。选股系统仓库本地 `main` 停在 8688c8d,选股系统机器上停在 3d3f317。
> 本文件落盘为 `docs/收尾阶段开发方案与规格书_2026-09-15.md`,同步到选股系统仓库的 docs。
---
## 一、这件事为最终目标买什么
最终目标不变:系统模拟主观选股基金经理的六步工作流。四层定位不变。判收标准不变:只看系统逻辑、实现、设计目标三者是否一致,不看收益。
今天下午评审了上一阶段交付的三个工作包。结论是保运包与判收读数包有条件通过,评析第二批退回。三个包都没有部署,基座机的代码还停在 09-10。上一阶段还有四件事没做:评析第三批、选股系统两处小改、台账三条、交接文档同步。
评审之后我又在三台机器上核了几处,读数写在这里,开发者不用再探。
- 基座机四条队列现在全空,未确认消息也是零。登记了没跑的文档仍是五百八十一份。评析近一天跑了六十七家,全部成功。
- 环节投影表有七千零八十七行,其中四千一百七十行带股票代码,覆盖一千九百五十一个环节。贵州茅台所在的白酒环节,投影里只有它一家。环节评析有六十二个,产业评析有十个。
- 择时结论表近三个交易日:两个头都有数值的每天四百二十三、四百零二、四百一十六家;技术面对象每天二百八十四、三百八十三、四百零七家。两个头的键名是 h5 与 h20。
- 择时决策系统的判分表里,五日头的判分种类名是 pv_h5,期限五,只有六条记录。二十日头还没有任何判分记录。
- 选股系统机器上的触发钥匙已经配置。周报目录里最新一份是 08-28 的。仓库以目录挂载进容器,周报那一步是子进程跑的,所以改周报代码只要拉代码就生效;新增只读接口才要重启接口容器。
- 一处评审记录之外的缺陷:波特五力的四条集中度判据在生产上永远算不了。图谱取数带方向,材料层装配时把方向丢了,单测是直接造带方向的材料,所以没发现。这条归入评析第二批的返工。
这一阶段做六件事。一,把保运包与判收读数包修完、部署、拿到读数。二,把评析第二批返工到复审通过,再部署。三,做评析第三批。四,做选股系统两处小改。五,补齐台账、交接、文档同步、上游同步待办这些欠账。六,在到期日跑判收命令,把两条判收的读数交出来。
这一阶段买四样东西。
1. 三个工作包真正上线跑起来,每一处都能用读数证明它按拍板在跑。
2. 评析的研究深度补齐:定性视角与预期视角都进报告,买方论点能引用到视角与材料编号。
3. 判收有依据:两条判收共八条结论行,每条要么读数判、要么人核,不再有说错话的行。
4. 一条部署线:只有评审通过的代码进 master,基座机只从 master 拉。
---
## 二、原则
沿用上一阶段规格书第二节的十条。本阶段再加四条。
1. 修一处先写一例复现单测。单测先红后绿,提交里能看到这一例。
2. 修复提交只碰评审记录点名的文件与函数。顺手改别的,记不符项。
3. 只有评审通过的提交进 master,基座机只从 master 拉。评析第二批没有复审通过前,它的代码不能到基座机:它升了评析版本号,一到基座机就会触发全量重跑。
4. 上一阶段"开关关掉逐字回旧"这一条,对评析第二批改成三句:两期相同且不开定性时指纹逐字相同;第一批十个视角的判据不变;质地合成不变。报告与摘要只加不改。评审按这三句核。
---
## 三、做哪几件事
六个工作包,按动工顺序排。前四个在本仓库,第五个在选股系统仓库,第六个是收尾。
### 工作包一:保运包修复与部署
**做什么。** 修评审记录第四节保运包的条件级一到四,补三条建议级,然后部署。
**为什么。** 这四条不修,部署等于把四个已知的错放上线:无数据的公司每小时被投一次;七天后名次靠前的公司永久占满名额;入队过但没跑的文档永远不会被自动补投;日检那条四十八小时告警量错了对象。
**做哪几件。**
1. 无数据的公司不再归入重跑类。近期无数据的这一批七天内不动,七天后按陈旧类重跑一次。
2. 新鲜度的年龄改按核对时刻与运行时刻里更新的那个算。探针命中只更新核对时刻,从此也能让一家公司"新鲜"。
3. 补投任务自己算在飞集合。从 Redis 两条队列的列表与未确认消息的哈希里解析出文档号,传给投放计划函数。解析不到才传空值,空值时入队过的照旧整批压着。
4. 补投任务每轮末记一行运行记录到任务运行台账(工作包二里通用化的那张表),日检读它判"四十八小时没跑"。
5. 三条建议级一起修:年报口径的 SQL 与 Python 函数从同一组常量拼出,并加单测钉住;核销脚本取文档号那条查询加排序;花名册按队列分别限量。
6. 复审通过后并进 master,09-18 收盘后部署。部署当天跑假需求单核销与补投首批,都先干跑再经同意。
细节见附录甲。
### 工作包二:判收读数包修复与部署
**做什么。** 修评审记录第四节判收读数包的条件级一到四,把周报台账表通用化成任务运行台账,补四条建议级,与保运包同窗部署。
**为什么。** 结论行里两条在说错话,判收命令出的读数不能当依据。三个新定时任务都需要"最近一次跑是什么时候"这个读数,与其各记各的,不如一张任务运行台账。
**做哪几件。**
1. 任务运行台账通用化。表名从 `bridge_job_runs` 改成 `job_runs`,模块改名,列不变。周报触发、补投、材料需求单三个任务都往里记。表还没上生产,改名没有迁移成本。
2. "带技术面"那一列改读技术面对象,用类型判断而不是非空判断。退路模式下两个头那条结论行标"人核"。
3. 结论行改成四加四,逐条对应两份方案的判收条款。人核的条目照样打印读数,判定写"人核"。
4. 判收日期用北京日期,不用容器的世界协调时日期。
5. 周报台账记全:钥匙为空的跳过也落一行;任务号写进任务号那一列;干跑落一行。
6. 四条建议级一起修:轮询遇到认证错误或服务端错误要返回并记状态;运行中的行不写结束时刻;前端时刻格式用同文件已有的北京时间写法;选股系统地址的缺省值三处统一。
7. 判收命令第三节改读选股系统的只读接口拿周报标记行计数。接口还没上线时读数写"未实现"。
8. 复审通过后并进 master,与保运包同一窗口部署。部署当天先干跑一次周报触发留台账行,再由二十点十分的定时任务真跑一次。
细节见附录乙。
### 工作包三:评析第二批返工
**做什么。** 修两条退回级、一条新发现的缺陷、三条条件级,补单测,重新交评审。
**为什么。** 两条退回级让上一阶段拍板一在生产上不成立:编排层自写的盘中窗口与端点池不一致,九点零五与十二点零五两批会让本地档等槽位;定性没跑成也落带定性的指纹,本期永不再试还计入当日上限。新发现的集中度缺陷让波特五力八条判据里四条永远算不了。
**做哪几件。**
1. 盘中判定复用端点池的同一个函数,删掉自写窗口。单测钉住是同一个函数对象。
2. 只有定性状态是成功或半成品才落含定性的指纹并记"已做定性"。其余状态落不含定性的指纹,记原因。当日上限只数真跑成的。
3. 材料层的图谱关系带上方向。编号键与指纹也带方向。
4. 新鲜度认定性:开定性时,定性没跑成的公司归入待定性类,只在拿到定性名额时投递。材料太薄的不算待定性。
5. 主环节成员数从环节投影表取数。主环节取成员最少的那个。成员少于三家时竞争者数量判据算不了,写明原因。
6. 单家触发接口透传定性参数;手工脚本加档位覆盖参数。
7. 单测补到附录己的数量,加一条"不开定性时第一批判据与质地合成不变"。
8. 复审通过后变基到 master 并入,09-22 收盘后部署,开定性总开关。当晚预判费用与时长(见附录丙末尾)。
评审记录条件级六到十二留给工作包四一起修。细节见附录丙。
### 工作包四:评析第三批
**做什么。** 材料层补上环节评析与可比公司两路;指标层加十二个指标;四个数字视角(莫布森预期差、达摩达兰三情景对照、邱国鹭品质与估值、马克斯周期位置);云端评议扩展到引用视角编号与材料编号,并列出视角分歧;一并修评析第二批遗留的条件级六到十二。
**为什么。** 前两批回答"公司好不好",第三批回答"市场预期与价格已经反映了多少"。环节评析与可比公司两路材料在第二批是桩,第三批的邱国鹭与马克斯两个视角要用它们,所以在这里接上。
**做哪几件。**
1. 材料层两路:环节评析从逻辑评析表读公司所在环节的最新一版(核心矛盾、供需研判、采信倾向);可比公司取主环节成员,从日频基础表取最新市盈率与市净率。
2. 指标层加十四个,全部代码算,数据源都是现有取数:市盈率与市净率十年中位、十年最高净资产收益率与毛利率、市盈率对增速、自由现金流收益率、每股收益三年复合增速、一致预期隐含的每股收益增速、预期差、隐含市盈率对一致预期、市盈率对十年中位、主营第一大项占比及三年变动、同环节市盈率中位。
3. 四个视角全部代码判据。达摩达兰只做"叙事对应必须成立的数字"对照表,不产内在价值、不设折现率。邱国鹭的"时机"固定写"归择时决策系统"。
4. 评议扩展:喂入视角索引与被文本判据引用过的材料摘录,论点与反方每条带视角编号,新增视角分歧清单最多三条。评议版本升到 2026.09-2,评析版本升到 2026.09-4。
5. 摘要只加键:预期差、周期位置、论点引用的视角。原有"十视角好中差计数"语义不变。
6. 第二批遗留条件级六到十二:市场组的调用喂研报论断;数字回查允许集加上被引用材料里的数字;巴菲特文本展开成护城河四问加三条;单测数量补齐;年报选取排除标题含"摘要"的并加第二排序键;第六段写明缺哪一类章节;公司名取不到记错误。
7. 09-29 收盘后部署。当晚预判费用与时长。
细节见附录丁。
### 工作包五:选股系统小改(另一仓库,单独审批)
**做什么。** 一个只读接口 `GET /review/latest`;周报第七节择时决策系统那一行下面加"五日头""二十日头"两行;台账。
**为什么。** 判收读数包第三节与评析判收第三条要读周报的标记行计数;量价研判链判收第四条要那两行。
**做哪几件。**
1. 只读接口返回最新一份周报的文件名、日期、大小、前二十行与三个标记行计数("公司质地="、"五日头"、"二十日头")。没有周报回 404。
2. 周报两行读判分表里种类名 pv_h5 期限五、pv_h20 期限二十的方向命中率,查询与现有择时自评同款。没有记录时那一行写"本期无判分记录",不报错。今天的探针读数是 pv_h5 六条、pv_h20 零条,所以头几周二十日头那一行就是这句话,这是正常读数不是缺陷。
3. 两处都要离线单测,末行 ALL OK。
4. 生效方式分两种:周报两行拉代码即生效,不用重启;只读接口要重启接口容器,先经审批,避开七点到七点半与八点半到九点零五,重启后预热计划接口。
细节见附录戊。
### 工作包六:收尾与判收
**做什么。** 台账四条、交接文档一份并同步四仓库、评审记录与两份规格书同步、动工前探针读数入档、上游同步待办复核、到期日跑判收命令。
**做哪几件。**
1. 台账四条记进选股系统仓库 `docs/复盘决定台账.md`,编号接着 058:059 保运甲把质地证据线的报告期口径改为两表各自最新期;060 判收读数包与周报触发,含选股系统两处小改;061 评析第二批升评析版本到 2026.09-3 加五个定性视角;062 评析第三批升到 2026.09-4 加四个预期视角与评议引用。每条在对应工作包部署当天落笔,五段式,带预期与复核日。
2. 交接文档 `docs/交接_2026-09-16.md` 改成部署后的现状版,或另起一份,四仓库逐字同步,提交信息"交接副本同步"。评审记录与本文也同步。第一节的探针读数与上一阶段四个探针的读数写进交接的固定一节。
3. 上游同步待办第一条复核日 09-22:日检"财报期覆盖"那一行的读数写回交接。写表方仍未核实的,交接里写明"待用户向一百五十三库侧确认"。
4. 09-30 是评析判收第一条的到期日(半年报截止日后三十天)。当天跑判收命令,读数原文交回。上游没到的按"上游同步待办"处理,不算本仓库不达。
5. 十月长假后第一周做全部工作包的评审。人读记录攒到十份后判收第四条。
---
## 四、顺序与时间
按交易日排。部署一律收盘后,先经审批。工作进程与定时器一起重建。避开六点十分。09-25 是中秋节,是否休市以交易所日历为准,定时任务照跑。
| 日期 | 星期 | 做什么 |
|---|---|---|
| 09-16 | 三 | 开发者修工作包一与二,落在从 7ea65c8 分出的部署分支上,每包一个提交,本地单测全绿后交证据。同时开始工作包三的返工 |
| 09-17 | 四 | 我复审工作包一与二。通过的并进 master 并推送。工作包三继续 |
| 09-18 | 五 | 收盘后部署工作包一与二:基座机拉 master,重建四个工作进程与定时器,重建前端镜像,配置周报触发钥匙。干跑三条:补投花名册、假需求单核销、材料需求单。经同意后跑假需求单核销与补投首批(五百八十一份)。跑一次判收读数命令留基线,跑一次周报触发干跑。二十点十分第一次自动周报,二十一点前核台账行。若判收读数包复审没赶上,它退到 09-22 再部署 |
| 09-19 | 六 | 早上跑一次日检,看补投结果与新增的行。开发者交工作包三的返工证据 |
| 09-21 | 一 | 早上日检核上周五周报那一行。我复审工作包三。开发者开始工作包五 |
| 09-22 | 二 | 上游同步待办复核日。收盘后部署工作包三(复审通过的前提下):拉 master,重建工作进程与定时器,开定性总开关。十六点零五起全量重跑,盘后走本地档。开发者开始工作包四 |
| 09-23 | 三 | 第二批首日读数:定性状态分布、单家耗时、集中度判据非空的家数。工作包五提交,我评审。周报两行拉代码即生效;只读接口的重启另约窗口 |
| 09-24 到 09-26 | 四到六 | 工作包四开发。09-25 二十点十分第二次自动周报 |
| 09-28 | 一 | 我评审工作包四 |
| 09-29 | 二 | 收盘后部署工作包四。当晚看评议的视角引用与分歧清单 |
| 09-30 | 三 | 评析判收第一条到期。跑判收读数命令,读数原文交回。台账 062 落笔 |
| 十月长假后第一周 | | 全部工作包的评审。十份人读记录到齐后判收第四条 |
---
## 五、开关与参数
本阶段不新增环境变量。上一阶段规格书第五节的三十一个键全部沿用,默认值不变。改动只有三处。
| 键 | 变化 | 属于 |
|---|---|---|
| `AKG_COMPANY_REVIEW_QUAL` | 09-22 部署时在基座机置一 | 工作包三 |
| `AKG_BRIDGE_XXL_KEY` | 09-18 部署时在基座机配置,值与选股系统机器上的触发钥匙相同(那边已配置) | 工作包二 |
| `.env.example` | 补登记第二批的十三个键,逐条一句说明 | 工作包三 |
手工脚本新增一个参数 `--qual-tier`,只覆盖本次运行的定性档位,不进环境变量。
---
## 六、验证方式
每条命令标明在哪台机器上运行。一个命令块只放一台机器的命令。基座机指 `ssh -p 2280 tlai@192.168.16.178`,仓库在 `~/project/astock-kg`。选股系统机器指 `ssh -p 2280 factor@192.168.16.155`,仓库在 `~/project/akg-factor-bridge`。
### 复审时(部署前)
**本地。** 全量单测。预期最后两行是 `Ran N tests` 与 `OK`,N 等于九十加附录己新增的例数。
```bash
cd /Users/baobao/Documents/work/project/astock-kg && PYTHONPATH=backend python3 -m unittest discover -s backend/tests -t backend 2>&1 | tail -3
```
**本地。** 修复提交只碰点名的文件。预期文件清单落在附录己里。
```bash
cd /Users/baobao/Documents/work/project/astock-kg && git show --stat --format='%h %s' <提交号>
```
**本地。** 盘中判定是同一个函数对象。预期打印 True。
```bash
cd /Users/baobao/Documents/work/project/astock-kg && PYTHONPATH=backend python3 -c "from app.analysis.company_review import runner; from app.orchestration import judge; print(runner._pool_intraday is judge._intraday)"
```
### 部署日(09-18,基座机)
**基座机。** 拉代码并核提交号。预期打出并进 master 的那个提交。
```bash
cd ~/project/astock-kg && git pull && git log --format='%h %s' -1
```
**基座机。** 补投干跑。预期花名册约五百八十一份,`dispatch_by_queue` 两条队列都有数,`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
```
**基座机。** 假需求单核销干跑。预期打印约五千零四十一张单与各自匹配的年报文档号,不写库。
```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
```
**基座机。** 晚确认生效。预期 `worker_prefetch_multiplier` 为一,`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"
```
**基座机。** 判收读数基线。预期四节都出,第四节八行,每行标成立、不成立或人核,"周报含两行"与"周报有质地分组"两行在选股系统小改上线前写"未实现"。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/acceptance_readings.py
```
**基座机。** 周报触发干跑。预期返回 `state` 为 `dry_run`,任务运行台账多一行。
```bash
curl -s -X POST 'http://192.168.16.178:8000/admin/trigger_plan_review?dry_run=true&sync=true'
```
**基座机。** 人读记录。预期返回保存后的整行;再点一次相反的值,同一行被覆盖。
```bash
curl -s -X POST http://192.168.16.178:8000/company/601126.SH/review/feedback -H 'Content-Type: application/json' -d '{"useful":true,"note":"部署试点"}'
```
**基座机。** 当晚二十一点后核第一次自动周报。预期最近一行 `job` 是 plan_review、`state` 是 success、`task_id` 非空、`artifact` 以 .md 结尾。失败态也要如实交回。
```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
```
**基座机。** 补投的结果。预期第一条无运行记录数比五百八十一明显下降,第二条最近一次补投任务的运行行在两小时内。
```bash
cd ~/project/astock-kg && 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, note, triggered_at AT TIME ZONE 'Asia/Shanghai' AS bj FROM job_runs WHERE job='requeue_no_run' ORDER BY triggered_at DESC LIMIT 3;"
```
**基座机。** 名额不再被占满。预期 `counts` 里 `recent_no_data` 不在重跑类,同一家公司不会连续两个整点都出现在 `picked` 里。
```bash
curl -s -X POST 'http://192.168.16.178:8000/admin/company_review_batch?dry_run=true' | python3 -m json.tool | head -40
```
### 评析第二批(复审与部署后)
**基座机。** 单家定性试跑,盘后,不落库。预期 `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
```
**基座机。** 盘中用云端档试跑一家。预期日志里定性调用打的是云端溢出档,不出现"等槽位"。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/company_review_run.py --code <同上> --with-qual --qual-tier worker_large_cloud --no-save --print | head -20
```
**基座机。** 批任务干跑。预期 `counts` 里出现 `qual_pending`,`picked` 里 `reason` 为 `qual_pending` 的都带 `with_qual` 真。
```bash
curl -s -X POST 'http://192.168.16.178:8000/admin/company_review_batch?dry_run=true&max_n=30&with_qual=true' | python3 -m json.tool | head -60
```
**基座机。** 上线次日看分布。预期一天里定性状态 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;"
```
**基座机。** 集中度判据活了。预期有读数的家数大于零。
```bash
cd ~/project/astock-kg && docker compose exec -T postgres psql -U akg -d akg -c "SELECT count(*) FROM company_review_runs WHERE ran_at >= now() - interval '1 day' AND summary->'grade_counts_b23' IS NOT NULL AND (grades->>'porter') <> '证据不足';"
```
**人工判收。** 十份报告的定性判据逐条点回材料编号对照表核章节。
### 评析第三批(部署后)
**基座机。** 单家带评议,落库并忽略指纹。预期第五段有"引用视角"行,反方每条带视角编号,视角分歧非空或写"无";去掉 `--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 '7 days';"
```
### 选股系统小改
**选股系统机器。** 单测。预期末行 ALL OK。
```bash
cd ~/project/akg-factor-bridge && docker exec akg_factor_bridge python3 test_review_latest.py 2>&1 | tail -1
```
**选股系统机器。** 重启接口容器后。预期返回文件名、日期、前二十行与三个标记计数;周报没跑过则 404。
```bash
curl -s 'http://192.168.16.155:8300/review/latest' | python3 -m json.tool | head -30
```
**选股系统机器。** 周报两行到位。预期在最新一份周报里各命中一行,二十日头那一行含"本期无判分记录"。
```bash
cd ~/project/akg-factor-bridge && grep -n "五日头\|二十日头" $(ls -t data/review/复盘_*_next_close.md | head -1)
```
### 判收到期日(09-30,基座机)
预期第四节八行里,评析一按报告与评议两个比例判,评析三与量价四读的是选股系统接口的标记计数,量价一与量价二写"人核"。
```bash
cd ~/project/astock-kg && docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/acceptance_readings.py --asof 2026-09-30
```
---
## 七、回退
上一阶段规格书第七节的回退方式全部沿用。本阶段补充三条。
| 改动 | 回退方式 | 要不要重建 |
|---|---|---|
| 任务运行台账改名 | 表还没上生产,没有回退问题。上线后整张可删,日检那几行退化成"读不到" | 不用 |
| 在飞集合解析 | 解析函数任何异常都返回空值,行为退回"入队过的整批压着",与今天的代码一致 | 不用 |
| 定性指纹规则 | 与评议指纹规则同款,没有开关。要整体回退用 `git revert` 第二批那两个提交并重建工作进程 | 要重建 |
---
## 八、拍板点
上一阶段规格书第八节的十八条继续有效。本阶段代定十四条,动工前不再问。要改就在这里改。
1. master 是部署线。工作包一与二的修复提交落在从 7ea65c8 分出的部署分支上(名字由开发者定),复审通过后并进 master 并推送。工作包三在 `nextphase-2026-09` 上继续,复审通过后变基到 master 再并入。本地 master 比远端多两个只改文档的提交(CLAUDE.md 与上一阶段规格书),第一次并入前先推送。评审记录与本文这类只改文档的提交,在部署分支上重新提交一份随并入进 master,不要为它们挑单个提交。
2. 保运包与判收读数包 09-18 一起部署。理由是省一个维护窗口,且读数包的定时任务正好在当天二十点十分第一次跑。读数包复审没赶上就退到 09-22。
3. 任务运行台账通用化成一张表 `job_runs`。三个新定时任务每轮记一行,日检从它读"最近一次跑"。不另起心跳键、不写 Redis。
4. 在飞集合从 Redis 解析。两条队列的列表加未确认消息的哈希,解析出抽取任务的文档号。只在队列见底时才需要解析,所以最多几十条。任何异常返回空值。
5. 定性没跑成的三种原因进待定性类:当日上限、档位不可用、材料层报错。材料太薄的不进,按新鲜处理,等年报入库后由指纹变化触发。待定性的公司只在拿到定性名额时投递,没名额留到下一批,避免每小时无定性地重跑。
6. 盘中判定复用端点池的 `judge._intraday`,删掉自写窗口。
7. 波特"竞争者数量"在投影成员少于三家时算不了。投影只是下界,一家或两家不代表格局。
8. 判收结论行改为四加四,每行对应两份方案第七节的一条。人核项也打印读数,判定写"人核"。带技术面的条数保留为信息读数,不再是结论行。
9. 判收日期用北京日期。
10. 环节评析与可比公司两路材料在工作包四实现。工作包三只接成员数。
11. 版本号沿用上一阶段:第二批评析 2026.09-3,第三批评析 2026.09-4,评议 2026.09-2。两次全量重跑各预判费用。
12. 周报两行的判分种类名按今天的探针读数定:pv_h5 期限五,pv_h20 期限二十。没有记录写"本期无判分记录",不算不成立。
13. 台账编号 059 到 062,分配见工作包六。
14. 巴菲特文本判据展开成护城河四问加三条,与上一阶段附录丙一致。
一条不在本阶段改、留作以后拍板的事:评析报告里估值类读数(现价、市盈率、区间位置、一致预期)只在报告期或版本变化时刷新,因为价格日不进指纹。这是 09-09 的设计选择,本阶段不动。
---
## 九、交付要求
给开发者的硬要求,人和大模型一样。
1. 每个工作包一个提交。提交信息全中文、无前缀,格式是"主题:改了什么",正文写清修了评审记录第四节的哪几条,末尾带台账号。修复提交的主题词沿用工作包名,例如"保运包修复:……"。
2. 工作区里 `CLAUDE.md` 有用户未提交的改动,不要纳入任何提交。提交只加自己的文件。
3. 先写复现单测再改代码。每条评审记录的不符项对应至少一例单测,单测名列在交付证据里。
4. 本地单测只用标准库 unittest,跑法写进测试文件首行。不在容器里跑单测。
5. 加表加任务五处一起登记:存储模块的表定义与读写、任务定义与定时表并写清为什么是这个时刻、手工触发入口、日检一行读数、交接文档一段与台账一条。
6. 手工投任务显式指定队列。定时表按北京时间。盘中盘后一律用端点池那一个函数判。
7. 一百五十三代理库一条 SQL 只碰一张表。择时结论表只做聚合查询。
8. 推理型模型输出上限给足,截断不重试,非截断空答案只重试一次,单家有总额上限。
9. 部署先经审批。工作进程与定时器一起重建。前端改动要重建镜像。服务器上只做 `git pull`,不跑 `git stash`。
10. 每个工作包交付时附第十节的证据清单。修复类工作包多交一项:逐条不符项对应的单测名与修改位置。
---
## 十、评审方式
评审者逐条核,评审者可以是大模型。评审不看开发者的自述,只看证据。
### 每个工作包要交的证据
| 证据项 | 要交什么 | 怎么核 |
|---|---|---|
| 提交号 | 每仓库一个或多个短哈希,并说明落在哪条分支 | `git show --stat` 对照附录己的文件清单 |
| 离线单测输出 | 本地全量单测的最后两行;选股系统各测试文件的末行 | 评审者自己再跑一遍 |
| 不符项对照表 | 评审记录条目编号、修改位置、单测名,一条一行 | 逐条打开看 |
| 只读读数 | 第六节每条命令的原文输出,标机器与北京时间 | 评审者在同一台机器重跑 |
| 五处登记 | 逐处给文件路径与行号 | 逐处打开看,缺一处退回 |
| 上线读数 | 部署后次日日检新增行的原文、干跑输出、台账行 | 与第六节预期逐条对 |
### 评审者的核对步骤
1. 对修复类工作包,按评审记录第四节逐条核;对新开发的工作包,按本文附录逐条核。
2. 读 diff 对照附录己的文件清单。清单外的文件,或改了既有函数签名、既有表列、既有键语义,记不符项。
3. 本地跑全部离线单测,基座与选股系统各一次。
4. 部署后在基座机跑第六节标"基座机"的每一条命令,逐条对预期读数。
5. 核五处登记;跑一次日检,新加的行必须出现且分级正确。
6. 核时区与队列:定时表在北京时区之下;手工投任务用了 `apply_async(queue=...)`;新任务在路由表里。
7. 写评审记录到 `docs/评审记录_<日期>.md`,骨架与上一份相同。
### 判定三档
| 档 | 条件 |
|---|---|
| 通过 | 单测全绿;不符项逐条已修且有单测;第六节命令按预期;五处登记齐;diff 无清单外改动 |
| 有条件通过 | 只差运行样本类的读数。列出条件与复核日期 |
| 退回 | 任一:单测红;评审记录点名的不符项没修;改了既有签名或既有键语义;手工投任务没指定队列;定时表没写时刻理由;日检分级用错;代理查询联了表或把原始结论列整列拉回;钥匙走了查询串;模型调用没有截断不重试;盘中判定没有复用端点池函数 |
---
## 附录甲(可不读):保运包修复实现
行号按 5fef131。
**甲一、无数据不重跑。** `backend/app/analysis/company_review/freshness.py:21` 的 `REWORK_CATEGORIES` 去掉 `recent_no_data`。`classify` 的顺序不变:七天内且状态是无数据的仍归 `recent_no_data`,只是这一类不再进重跑名单;七天后它自然落到 `stale_run`。单测 `test_recent_no_data_not_reworked`:一家七天内无数据的公司,`pick_batch` 的 `picked` 里没有它,`counts["recent_no_data"]` 为一。
**甲二、年龄看更新的那个时刻。** `freshness.py:35` 的 `_age` 改成收整行:取 `ran_at` 与 `checked_at` 里是时间型且更新的那个再减。时区混用的处理照旧。`classify` 第 57 行改调新签名。单测 `test_age_uses_checked_at`:`ran_at` 十天前、`checked_at` 一天前的行判 `fresh`,不判 `stale_run`。
**甲三、在飞集合。** 两处改。
一,`backend/app/orchestration/dispatch_policy.py` 加纯函数,不导入 redis 与 celery:
```python
def inflight_doc_ids(raw_messages, *, task_name="akg.extract_and_fuse") -> set[str]:
"""从 Redis 里原样取出的消息串解析抽取任务的文档号。
队列列表里每项是一个消息字典的 JSON;未确认哈希里每项是 [消息字典, exchange, routing_key] 的 JSON。
消息字典:headers.task 是任务名,body 是 base64 的 JSON 三元组 [args, kwargs, embed],kwargs 里有 doc_id。
解析不了的单条跳过;整体不抛异常。"""
```
二,`backend/workers/tasks.py` 加 `_inflight_docs()`:对 `celery` 与 `targeted` 两条队列各做一次 `LRANGE 0 -1`,再做一次 `HVALS unacked`,全部交给上面的纯函数;任何异常返回 `None`。第 359 行附近 `plan_requeue(...)` 的 `inflight=None` 改成 `inflight=_inflight_docs()`。只在队列见底时才会真投,所以列表最多几十条,读全量不贵。返回值里加 `inflight_n`(空值写 `null`)。
单测 `test_inflight_from_v2_message`(手拼一条消息串:headers.task 为抽取任务名,body 是 base64 的 `[[], {"doc_id": "d1"}, {}]`,解析得 `{"d1"}`)、`test_inflight_unacked_wrapped`(列表包裹的那种)、`test_inflight_ignores_other_tasks`(headers.task 是别的任务名不计)、`test_stale_dispatched_when_inflight_known`(在飞集合非空值时入队过但陈旧的能被投)。
**甲四、四十八小时判据。** `requeue_no_run` 函数末尾(第 372 行 `logger.info` 之前)调 `job_run_store.record("requeue_no_run", state="dry_run" if dry_run else "success", note=<返回字典的 JSON>)`,写失败只告警。`review_material_demands` 同样在末尾记一行。`backend/scripts/daily_check.py:520-522` 改成读 `job_run_store.latest("requeue_no_run")`:没有行,信息级"补投任务还没跑过";行的时刻早于四十八小时前,警告;否则信息级带时刻。`extraction_dispatch.summary` 里的 `last_requeue_at` 保留为信息读数。
**甲五、建议级三条。**
- 年报口径:`backend/app/analysis/company_review/materials.py:31-38` 改成先定义 `ANNUAL_INCLUDE = "年度报告"` 与 `ANNUAL_EXCLUDE = ("半年度", "摘要")`,SQL 串与 `is_annual_title` 都从这两个常量拼出。单测 `test_annual_rule_single_source`:SQL 串里出现且只出现这三个词,Python 函数对六个标题的判定与预期一致。
- `backend/app/store/claim_store.py` 的 `annual_docs_by_company` 排序改成 `ORDER BY disclosure_date DESC, doc_id`。
- `backend/app/store/extraction_dispatch.py:89` 的 `roster` 改成按队列各取上限:靶向来源(研报与年报)与其余各查一次,各限 `limit`。`requeue_no_run` 传 `limit=cap * 2`。
**甲六、注释与文案。** `tasks.py:226,228` 的"交给 celery 重试"改成"抛异常的任务照常确认,只有进程丢失才重投"。`tasks.py:79` 那份重复的集合删掉,引用改到 `dispatch_policy.TARGETED_SOURCE_TYPES`。日检"财报期覆盖"那一行加分母,分母取 `company_master` 里在市的公司数。
---
## 附录乙(可不读):判收读数包修复实现
**乙一、任务运行台账。** `backend/app/store/bridge_job_store.py` 改名为 `job_run_store.py`,表名 `job_runs`,索引名跟着改,列不变。函数:`open_run`、`close_run`(加 `task_id` 参数;`state` 是 running 时不写 `ended_at`)、新增 `record(job, *, state, note=None, steps=None, task_id=None, http_status=None, artifact=None, tail=None) -> int`(一次写完一行,`triggered_at` 与 `ended_at` 都是现在)、`latest(job)`、`on_day(job, day)`、`summary(job, days=30)`。`job` 取值:`plan_review`、`requeue_no_run`、`review_material_demands`。`bridge_jobs.py`、`acceptance_readings.py`、`daily_check.py`、`main.py` 与单测的引用一起改。建议把 `job_runs` 与 `company_review_feedback` 的建表语句也同源追加到 `db/postgres/init.sql` 末尾,与调度台账表同款。
**乙二、技术面那一列。** `backend/scripts/acceptance_readings.py:33` 改成 `SUM(CASE WHEN JSON_TYPE(JSON_EXTRACT(raw_logic_json,'$.tech_view'))='OBJECT' THEN 1 ELSE 0 END) AS tech`。退路 SQL 第 38 行改成两列:`LOCATE('"pv_heads"', raw_logic_json) > 0` 算 heads,`LOCATE('"tech_view"', raw_logic_json) > 0` 算 tech,第 78 到 80 行分别赋值。退路模式下两个头那条结论行判"人核",值里标 heuristic。今天的读数:三日两个头 423、402、416,技术面 284、383、407,修完两列必须不相等。
**乙三、结论行四加四。** `backend/app/analysis/acceptance.py` 的 `verdict_lines` 改成下面八行。`review_readings` 多算两个数:`n_report_not_behind`(状态 ok 且报告期不落后地板期)与 `n_brain_not_behind`(在前者基础上评议状态是 ok 或 half),两个比例都以目标名单为分母。
| 键 | 条款 | 读数 | 判定 |
|---|---|---|---|
| review_period | 接入方案判收一:候选名单里的公司报告与评议不落后最新财报期一个月 | 报告不落后比例、评议不落后比例 | 前者不低于 0.90 且后者不低于 0.80 成立 |
| research_depth | 接入方案判收二:三处开关打开后一致性检查表第七行"研究深度"改为一致 | 基座侧能读到的开关值(评议开关、评议每日上限、定性开关) | 人核 |
| weekly_quality | 接入方案判收三:两周复盘周报有质地分组读数 | 最新周报里"公司质地="标记行数 | 大于零成立;接口 404 或未实现写"不成立(未实现)" |
| human_read | 接入方案判收四:人读十份评议至少七份 | 最近十份里说"多说了东西"的份数 | 不足十份人核,够十份按七份判 |
| pv_indicator_report | 量价方案判收一:十只票的指标报告与因子表逐项对得上 | 无 | 人核 |
| pv_chart_check | 量价方案判收二:识图报告的图数核验与代码算的五根 K 线一致 | 无 | 人核 |
| pv_heads | 量价方案判收三:连续五个交易日两个头都有值,信号分布没有整体偏移 | 五日每日两个头覆盖率、信号分布按日 | 覆盖率五日都不低于 0.90 成立;偏移部分在值里标"人核" |
| weekly_heads | 量价方案判收四:周报里择时那一行下面两行有读数 | 最新周报里"五日头"与"二十日头"标记行数 | 两者都大于零成立;接口未实现写"不成立(未实现)" |
`daily_all_positive` 与"带技术面"的规则函数保留,只出现在第二节的信息读数里,不进结论行。
**乙四、北京日期。** `acceptance_readings.py:112` 改成 `dt.datetime.now(dt.timezone(dt.timedelta(hours=8))).date()`。
**乙五、周报台账记全。** `backend/app/analysis/bridge_jobs.py:98-99` 钥匙为空时 `store.record(JOB, state="skipped_no_key", steps=STEPS, note=...)` 再返回。第 112 到 113 行改成 `store.close_run(run_id, state="running", http_status=200, task_id=task_id)`。`poll` 遇 401 或 403 返回 `auth_error`,遇 5xx 连续三次返回 `failed`,都带 `http_status`。`AKG_BRIDGE_BASE` 的缺省值三处统一成 `http://192.168.16.155:8300`。
**乙六、第三节改读选股系统接口。** `_weekly_section` 用 `urllib` 打 `{AKG_BRIDGE_BASE}/review/latest`,超时十秒。返回 200 时取 `date` 与 `marker_counts` 里三个标记的计数;404 记"没有周报";连不上或接口不存在记"未实现"。读到的计数进 `weekly.quality_lines` 与 `weekly.heads_lines`。台账里最近一次触发的状态照旧打印。
**乙七、前端与存储的建议级。** `frontend/src/views/StockView.jsx:352` 的时刻格式改用同文件 263 到 270 行的写法。人读表 `recent()` 改用数据库时间比较。索引表最新行是无数据行时,人读接口回 404 并写明"这家最新一行没有报告"。
---
## 附录丙(可不读):评析第二批返工实现
行号按 5fef131。
**丙一、盘中判定。** `backend/app/analysis/company_review/runner.py:51-57` 的 `_intraday_now` 删掉。模块顶部加 `from app.orchestration.judge import _intraday as _pool_intraday`(`judge.py` 只导入标准库,离线可导入)。第 85 行改成 `qualitative.client_for(_pool_intraday(dt.datetime.now(dt.timezone.utc)))`。单测 `test_intraday_is_pool_function`:`runner._pool_intraday is judge._intraday` 为真。
**丙二、定性指纹。** `runner.py:262-280` 的落库改成:
```python
qual_ok = with_qual and qual_status in ("ok", "half")
fp_save = fingerprint(key_fi, key_rf, with_brain and brain_ok,
with_qual=qual_ok, mat_fp=mat_fp if qual_ok else None)
store.save_run(..., fingerprint=fp_save, qual_used=qual_ok,
qual_status=qual_status if with_qual else None, materials_fp=mat_fp, ...)
```
第 269 行的注释改成一句:评议与定性同一规则,没成功就落不带它的指纹,下次再试;成功后指纹含版本,不重花钱。`materials_fp` 照样记,那是读数。单测 `test_qual_failed_keeps_plain_fingerprint`:用假存储收 `save_run` 的参数,定性状态是 daily_cap 时指纹等于 `fingerprint(key_fi, key_rf, False)`、`qual_used` 为假、`qual_status` 是 daily_cap;状态 ok 时指纹含定性版本、`qual_used` 为真。
**丙三、图谱关系带方向。** `backend/app/analysis/company_review/materials.py:329-335` 的图谱材料:键改成 `f"{g.get('direction')}:{g.get('predicate')}:{g.get('object')}"`,`meta` 加 `"direction": g.get("direction")`。`fingerprint` 里图谱项的哈希加方向。单测 `test_collect_keeps_edge_direction`:用注入的取数给两条出边一条入边(字典形状照 `graph_store.supply_edges` 的返回),`collect` 后 `by_kind["graph"]` 里每项 `meta["direction"]` 非空,波特视角的最大客户占比有读数。
**丙四、待定性类。** `freshness.classify` 加参数 `with_qual: bool = False`。`brain_pending` 之后加:开定性、行的 `qual_used` 为假、且 `qual_status` 不是 thin,判 `qual_pending`。`REWORK_CATEGORIES` 加 `qual_pending`。`pick_batch` 透传 `with_qual`。`tasks.py:1801` 的 `pick_batch` 传 `with_qual=bool(with_qual)`;第 1809 到 1818 行的名额循环里,`reason` 是 `qual_pending` 而没拿到定性名额的从 `picked` 里去掉,留到下一批。返回值 `counts` 自然带 `qual_pending`。单测 `test_qual_pending_picked_only_with_slot`(三家待定性、名额一,只投一家)与 `test_thin_not_pending`。
**丙五、主环节成员数。** `materials._default_fetch` 加一路 `segments`(在第三批之前先只取成员数):本地库两条查询,`SELECT DISTINCT segment_name FROM segment_members_projection WHERE ts_code=%s`,再对这些环节 `SELECT segment_name, count(DISTINCT coalesce(ts_code, member_name)) FROM segment_members_projection WHERE segment_name = ANY(%s) GROUP BY 1`。`member_count` 取最小值,`main_segment` 取对应环节名,都放进返回字典。`collect` 把 `main_segment` 也带出来。`lenses/porter.py:41-42` 改成成员数少于三家时值照记、`passed` 为空、备注"投影成员少于三家,不代表竞争格局"。单测 `test_porter_small_member_count_unknown`。
**丙六、单家入口。** `backend/app/main.py:617-630` 的 `/admin/company_review` 加 `with_qual: bool = False`,同步与投队列两条路都透传。`backend/scripts/company_review_run.py` 加 `--qual-tier`:给了就 `get_router().registry.client(tier)` 作为 `qual_client` 传入,首行说明加示例。
**丙七、单测与文案。** `test_lenses_batch2` 补到八例,`test_materials` 补"按标题选年报"与"缓存缺失记账不解析"两例,加 `test_qual_off_keeps_batch1_and_quality`(不传材料与定性时,第一批十个视角的判据字典与质地合成结果,同不开定性的旧路径逐字节相等)。不开定性时报告第一段那句"年报文本与研报论断在第二批接入"改成"定性阶段未开"。交接文档第十节那句"报告与摘要与旧版逐字一致"改成"指纹逐字一致、第一批判据与质地合成不变"。
**丙八、部署当晚的预判。** 全量重跑一百二十家。数字部分每批三十家、每小时一批,四批铺满。定性每批十家、当日上限二百,盘后本地档每家三到五分钟三次调用,零费用;09-23 盘中六批走云端溢出档约六十家,每家几分钱。评议随定性,每天上限一百五十家、三百万 token,一百二十家约一百九十万 token。预判写进交接,次日与实测对表。
---
## 附录丁(可不读):评析第三批实现
**丁一、材料层两路。**
环节评析(K):`materials._segment_reviews(code)` 用丙五取到的环节名,逐个 `claim_store.get_review("Segment::" + 名)`;有评析的取 `comparison` 里的 `core_contradiction.text`、`supply_demand.supply` 与 `supply_demand.demand` 拼成正文,`leaning` 进 `meta["stance"]`,`created_at` 进日期。材料指纹里环节项按环节名与倾向哈希。今天库里有六十二个环节评析。
可比公司(P):`materials._segment_peers(code)` 取主环节成员里带代码且不是本公司的,最多十家;市盈率与市净率从日频基础表取,一条单表查询 `SELECT symbol, timestamp, pe_ttm, pb, total_mv FROM gp_day_basic WHERE symbol IN (...) AND timestamp >= <十日前>`,Python 侧每家取最新一行。代码格式用前缀式,与 `fin_statements.day_basic_history` 同款。正文写"同环节 X,市盈率 a 倍,市净率 b 倍"。可比项的指纹按代码集合哈希,不按价格。开关 `AKG_COMPANY_REVIEW_PEERS_PX=0` 时不取价格,只列名单。
**丁二、指标层十四个。** 都放进 `metrics.compute`,自动进侧车与数字回查允许集合。
| 指标 | 算法 | 数据源 |
|---|---|---|
| pe_ttm_median_10y、pb_median_10y | `ds["px"]` 里正值的中位数 | 日频基础表 |
| roe_max_10y、gm_max_10y | 年度序列 `roe`、`grossprofit_margin` 的最大值 | 供应商指标表 |
| peg | 市盈率 ÷(一致预期隐含增速 × 100);增速不为正时空 | 现有 |
| fcf_yield | 最新年度企业自由现金流 ÷ 总市值 | 供应商指标表加日频基础表 |
| cons_eps_growth | 一致预期每股收益中位 ÷ 最新年度每股收益 − 1 | 券商预测加供应商指标表 |
| eps_cagr_3y | 每股收益三年复合增速,用 `periods.cagr` 在 eps 年度序列上算 | 供应商指标表 |
| expectation_gap_eps | cons_eps_growth − eps_cagr_3y,单位百分点 | 现有 |
| implied_pe_vs_cons | 现价隐含市盈率 ÷ 一致预期市盈率中位 | 现有 |
| pe_vs_hist_median | 市盈率 ÷ 十年中位 | 现有 |
| bz_top1_share、bz_top1_share_chg_3y | 最新年度主营第一大项 ÷ 收入;与三年前之差 | 主营构成表 |
| peers_pe_median | 可比公司市盈率中位 | 丁一的 P 材料 |
**丁三、四个视角。** 文件 `lenses/{mauboussin,damodaran,qiu,marks}.py`,`LENS["batch"] = 3`,需要材料的声明 `needs`。判据阈值与上一阶段附录丁相同,这里只写与数据源的对应。
- 莫布森:预期差不超过正十个百分点;隐含市盈率对一致预期不超过 1.2;市盈率对十年中位不超过 1.3;`price_pos_250` 不超过 0.70;投入资本回报率不低于十年平均净资产收益率。结论句写"一致预期要求下一年每股收益增长 x%,历史复合 y%,差 z 个点"。
- 达摩达兰:三情景各算所需增速(情景每股收益 ÷ 最新年度每股收益 − 1)、所需净资产收益率(情景每股收益 ÷ 每股净资产)、所需市盈率(情景市盈率)。判据:中性所需增速不超过历史三年复合加十个百分点;中性所需净资产收益率不超过十年最高;中性市盈率不超过 1.5 倍十年中位;乐观所需净资产收益率不超过 1.2 倍十年最高;悲观情景价不低于现价七成。无一致预期全部算不了。对照表进报告第四段。
- 邱国鹭:品质三条(十年里净资产收益率不低于 15% 的年份占七成以上、毛利率十年标准差不超过五个百分点、主环节成员不超过十五家且不少于三家);估值三条(市盈率与市净率十年分位不超过 0.50、市盈率不超过同环节中位、市盈率对增速不超过 1.5)。附注固定"时机不在本报告,归择时决策系统"。
- 马克斯:主环节评析倾向不是偏空(K 材料的 stance);市盈率与市净率十年分位不超过 0.70;资产负债率不超过 60%;`price_pos_250` 不超过 0.70;最新年度毛利率低于十年最高。多环节取成员最少的为主环节。
**丁四、评议扩展。** `runner.run` 在侧车里加 `material_excerpts`:被任何文本判据引用过的材料编号,各取标题与前四百字。`synthesis.build_input` 加两段:视角索引(`[L1] 薛云奎四维分析法 评价 好`,按 `lenses.ORDER` 编号)与材料摘录(只放 `material_excerpts` 里的)。判据行的能判计数改为按 `passed` 非空计。系统提示词加:论点与反方各带 `lens_refs`;预期字段须引用一致预期或预期视角的判据编号;第六项 `disagreements` 最多三条,各引两个视角编号。编号正则改 `^[MCSRGKPL]\d+$`。后处理校验 `lens_refs`,论点无视角引用记 `thesis_without_lens_ref` 并降为 half。渲染加"引用视角"行与 5.6 视角分歧。`SYNTHESIS_VERSION` 升 2026.09-2,`REVIEW_VERSION` 升 2026.09-4。
**丁五、摘要加键。** `summary.build` 加 `expectation`(含 `gap_pts`、`implied_pe_vs_cons`)、`cycle`(马克斯的评价与主环节倾向)、`thesis_lens_refs`。原有键语义不变。
**丁六、第二批遗留条件级六到十二。**
- 六:`qualitative.build_calls` 对市场组多喂研报论断(R 材料,最多二十条),其余两组不变。
- 七:`materials.allowed_numbers(mat, refs)` 改成返回被引用材料正文里的数字集合;`qualitative.validate` 的回查允许集是指标值并上这个集合。
- 八:`lenses/buffett_text.py` 的 `QUESTIONS` 展开成护城河四问(定价权、转换成本、成本优势、网络或规模)加三条(管理层坦承失误、资本配置理由、可核验目标)。
- 九:单测补到附录己的数量。
- 十:`materials.annual_report_docs` 的 SQL 加"标题不含摘要"作为并集之外的排除条件,排序加 `doc_id` 第二键。
- 十一:报告第六段按材料统计写"缺 <类别> 章节",类别名用中文。
- 十二:`materials._default_fetch` 取不到公司名时 `errors["names"]` 记一条,报告第一段材料行带"未脱敏"。
**丁七、部署当晚的预判。** 版本号再升一次,第二次全量重跑。评议一百二十家约一百九十万 token,定性因材料指纹不变而在指纹里复用(定性版本不变),只重算数字与评议。写进交接,次日对表。
---
## 附录戊(可不读):选股系统小改实现
**戊一、只读接口。** `config.py` 加 `REVIEW_DIR = os.environ.get("REVIEW_DIR", "data/review")`(今天机器上没有设这个变量,目录就是 `data/review`)。新 `review_latest.py`:`latest_report(dir, *, start="next_close")` 只认 `复盘_YYYY-MM-DD_{start}.md`,按日期倒序取第一;`head_lines(path, n=20)`;`marker_counts(path, markers)` 默认标记 `("公司质地=", "五日头", "二十日头")`;`payload(...)` 返回 `file`、`date`、`size`、`head`、`marker_counts`。`api.py` 末尾加路由 `GET /review/latest`,没有周报回 404。测试 `test_review_latest.py` 用临时目录三份文件,末行 ALL OK。README 接口表加一行。重启接口容器要审批、避开七点到七点半与八点半到九点零五、重启后预热计划接口。
**戊二、周报两行。** `plan_review.py` 加 `timing_head_eval(since, until, *, ref_type, horizon) -> str`,查询与 `timing_self_eval`(第 189 行)同款,只把 `ref_type` 与 `horizon` 换成参数。`compare_table`(第 573 行)在择时决策系统那一行之后插两行:系统列"择时决策系统·五日头"与"择时决策系统·二十日头",口径列各一句说明是两个头自己的判分,读数列分别调 `timing_head_eval(..., ref_type="pv_h5", horizon=5)` 与 `(..., ref_type="pv_h20", horizon=20)`。零条时返回"本期无判分记录(判分种类 pv_h20 尚未产生)"这一类句子,读不到时返回"读不到",两种要分开。加测试 `test_plan_review_heads.py`:注入假读数函数,表里多出两行且顺序正确。
**戊三、生效方式。** 选股系统机器上 `git pull` 后周报两行即生效,因为周报那一步是 `run.py plan-review` 子进程、读的是挂载目录里的代码。只读接口要重启接口容器。两件事可以分两次做:周报两行在 09-23 拉代码,只读接口另约窗口。
---
## 附录己(可不读):单测与文件清单
**单测新增(标准库 unittest,全部离线)。**
| 工作包 | 文件 | 新增例数 | 覆盖 |
|---|---|---|---|
| 一 | `tests/company_review/test_freshness.py` | 2 | 无数据不重跑、年龄看核对时刻 |
| 一 | `tests/ingest/test_dispatch_policy.py` | 4 | 消息解析三例、在飞集合已知时陈旧类可投 |
| 一 | `tests/company_review/test_materials.py` | 1 | 年报口径单一来源 |
| 二 | `tests/bridge/test_bridge_jobs.py`(改) | 3 | 无钥匙落跳过行、任务号进列、轮询遇认证错返回 |
| 二 | `tests/acceptance/test_acceptance.py`(改) | 4 | 八行对应条款、评析一双比例、周报两个标记计数、退路人核 |
| 三 | `tests/company_review/test_company_review.py`(改) | 2 | 盘中函数同一对象、定性失败指纹 |
| 三 | `tests/company_review/test_freshness.py` | 2 | 待定性只在有名额时投、材料太薄不待定性 |
| 三 | `tests/company_review/test_materials.py` | 3 | 图谱方向保留、按标题选年报、缓存缺失记账 |
| 三 | `tests/company_review/test_lenses_batch2.py` | 2 | 成员数少于三家算不了、不开定性第一批与质地不变 |
| 四 | `tests/company_review/test_lenses_batch3.py`(新) | 6 | 莫布森预期差、达摩达兰对照表、邱国鹭估值与可比、马克斯倾向、新指标、成员数边界 |
| 四 | `tests/company_review/test_synthesis.py`(改) | 5 | 视角索引、只放被引用摘录、论点须引视角、分歧校验、渲染 |
| 四 | `tests/company_review/test_qualitative.py`(改) | 3 | 市场组喂论断、材料数字进允许集、巴菲特七问分组 |
| 四 | `tests/company_review/test_materials.py` | 3 | 环节评析材料、可比公司材料、缺章节类别 |
| 五 | 选股系统 `test_review_latest.py`、`test_plan_review_heads.py` | 2 | 目录注入取最新;两行插入 |
预期本仓库总数:九十加约四十,本地一条命令 `OK`。
**文件清单(本仓库,按工作包)。**
工作包一:`backend/app/analysis/company_review/{freshness,materials}.py`、`backend/app/orchestration/dispatch_policy.py`、`backend/app/store/{extraction_dispatch,claim_store}.py`、`backend/workers/tasks.py`、`backend/scripts/daily_check.py`、对应单测。
工作包二:`backend/app/store/job_run_store.py`(由 `bridge_job_store.py` 改名)、`backend/app/analysis/{acceptance,bridge_jobs}.py`、`backend/scripts/acceptance_readings.py`、`backend/scripts/daily_check.py`、`backend/app/main.py`、`backend/app/store/company_review_feedback_store.py`、`frontend/src/views/StockView.jsx`、`db/postgres/init.sql`(建议)、对应单测。
工作包三:`backend/app/analysis/company_review/{runner,freshness,materials,report}.py`、`backend/app/analysis/company_review/lenses/porter.py`、`backend/workers/tasks.py`、`backend/app/main.py`、`backend/scripts/company_review_run.py`、`.env.example`、`docs/交接_2026-09-16.md`、对应单测。
工作包四:`backend/app/analysis/company_review/{metrics,synthesis,report,summary,runner,materials,qualitative,__init__}.py`、`backend/app/analysis/company_review/lenses/{buffett_text,__init__}.py`、新 `lenses/{mauboussin,damodaran,qiu,marks}.py`、`backend/app/store/claim_store.py`(可比公司取数若放这里)、对应单测。
工作包五(选股系统仓库):`config.py`、`api.py`、新 `review_latest.py`、`plan_review.py`、`README.md`、新 `test_review_latest.py`、新 `test_plan_review_heads.py`、`docs/复盘决定台账.md`。
文档:本文、评审记录、交接文档(部署后的现状版)、四仓库同步副本。
**台账四条的骨架(五段式)。**
- 059 · 部署日 · 保运甲:质地证据线的报告期口径改为两表各自最新期。依据:供应商指标表半年报只同步一百六十五家。预期:目标名单里报告期不落后应披露期的比例从今天的读数升到九成以上。复核日 09-30。
- 060 · 部署日 · 判收读数包与周报触发:一条命令出两条判收读数,周五二十点十分基座触发周报,周报加两个头两行与只读接口。预期:09-18 与 09-25 两次自动周报都有台账行。复核日 09-28。
- 061 · 部署日 · 评析第二批:评析版本升 2026.09-3,五个定性视角,本地为主盘中溢出云端。预期:上线次日定性状态 ok 不少于一百家。复核日 09-30。
- 062 · 部署日 · 评析第三批:评析版本升 2026.09-4,四个预期视角,评议引用视角与材料编号。预期:反方非空占比不低于七成。复核日十月长假后第一周。