交接副本同步

This commit is contained in:
baobao 2026-10-28 15:26:14 +08:00
parent e337df608d
commit 875a9fc7cb
2 changed files with 190 additions and 0 deletions

View File

@ -0,0 +1,103 @@
# 个股评析全池覆盖开发规格
日期为2026年10月28日。本文时间均为北京时间。
## 目标与授权
用户要求本轮覆盖整个产业池和高股息池。
当前候选优先,未完成对象不因每日名单变化而丢失。
本轮补普通个股评析,不自动扩大分红专项研究。
股票资格、排序、模型判据和交易参数保持。
## 改前实测
178基座提交7ef107e,评析队列为零。
当前目标148家,全部已有报告、定性及评议。
产业池3833家,仅747家有报告。
桥高股息池169家,仅9家有报告。
两个池有交集,缺口不能直接相加。
本轮只读预览并集3885家,已有747家,首次报告缺口3138家。
高股息缺报告的160家均未进入留存的评析目标名单。
近72小时43次成功运行平均185.5秒。
第95百分位246.4秒,最大286.5秒。
近七天评议平均输出13465个token。
原每日上限为评议150家、定性200家、评议输出300万token。
## 具体工作
1. 复用原每小时批任务和review队列,不新增任务或表。
2. 自动读取全部产业池成员。
3. 从桥已发布的高股息研究接口读取研究对象。
不按投资资格eligible过滤,基座不重新计算股息筛选。
4. 在现有job_runs保存累计研究名单,名单变化才追加快照。
已纳入对象继续保留。来源读取失败保留旧名单并报告。
旧快照读失败时停止扩展投递,不能用空名单覆盖。
5. 新报告优先于名单外旧报告升级。
当前候选保留优先名额,剩余名额持续补名单外对象。
旧报告的复核不能无限挤占首次报告。
6. 每批完整运行最多30家。每日评议、定性各600家。
评议输出上限900万token,单次模型预算保持。
每日额度不足时不继续投递完整运行。
7. 用Redis短期凭据防止重复投递。
失败对象延后重试,队列积压时暂停增加整批任务。
重试不删除旧报告,不清空历史记录。
8. 名单外补齐避开06:00至08:00、20:00至23:00。
原候选任务仍按原调度执行。
晚间行业催化与分红专项使用原队列和时刻。
9. 日检分别显示有报告、定性、评议及首次报告缺口。
无财务数据、材料薄和失败不能宣称完整研究已完成。
## 偏差发现与撤销
新增配置文件控制覆盖开关和每日额度。
关闭覆盖开关即回到原目标集合与每日额度。
旧报告、固定引用和累计名单保留。
日检报告来源失败、剩余缺口和最近调度状态。
同一对象反复失败时先暂停其重试,不阻塞后面的对象。
按每日有效完成约450至550家估算,首次覆盖约需一周。
这只是按现有耗时计算的容量预估。
上游缺财务数据及缺年报的对象单列,不能承诺完整结论。
## 分批验收预期
### 本地
- 合并去重和排序确定,重复读取不改变名单。
- 高股息资格尚未通过的对象仍能进入研究。
- 来源暂不可用时累计待办不丢,旧快照损坏时不覆盖。
- 当前候选和首次报告均能获得名额。
- 预算不足、已有在途及失败冷却时不重复投递。
- 保护时段只运行原候选。
- 旧指纹、有效标志、固定报告引用和财务期口径不变。
- 全部离线unittest通过。
### 部署前只读预览
在178容器内核对两个池并集、首次报告缺口和首批代码。
预览不保存名单,不登记运行,不投递任务,不调用模型。
核对桥消费的company_review_runs及报告路径保持。
### 服务生效与生产判收
容器重建须取得用户同意。
按仓库规则统一重建四类worker。
beat调度不改,不需要重建。
首批显式投递review队列,核对报告增量与预算读数。
首批成功不等于全池覆盖完成。
后续按实际缺口下降和失败清单判收。
## 开发者参考
原targets.collect仍供材料需求单和旧入口使用。
扩大覆盖只在评析批任务启用,避免一次扩大数千张采集单。
累计名单使用job_runs的既有tail JSON字段。
临时投递凭据使用Redis,带过期和所有者校验。
同一凭据只能从待执行原子转为执行中一次。
失败冷却六小时;无数据沿用七天复查,三次评议失败沿用原放弃规则。
预算沿用索引表的当日登记口径,含失败状态。
每次模型调用仍受原单次输出上限约束。
这不是服务商账单的逐次计费审计,不能把登记量称为实际费用。
排序只决定研究先后,不形成证券评分。
报告内容及下游排序由现有逻辑继续处理。

View File

@ -0,0 +1,87 @@
# 个股评析全池覆盖交接
本轮日期为2026年10月28日,时间按北京时间。
规格见《个股评析全池覆盖开发规格_2026-10-28.md》。
## 用户决定
用户要求本轮直接覆盖整个产业池和高股息池。
本轮扩大普通个股评析,不扩大分红专项研究,也不改交易参数。
## 已实现
复用原每小时批任务、review队列及两个工作并发。
每批最多30家,当前候选保留10个优先名额。
没有候选待办时,30个名额均可补首次报告。
高股息研究对象取桥已发布的现有接口。
基座不重新计算股息筛选,也不按投资资格过滤研究。
累计范围沿用job_runs的tail字段,仅名单变化时追加快照。
来源失败保留旧名单;旧名单损坏时停止扩展。
在途凭据有所有者校验和六小时过期。
失败冷却六小时,任务不反复抢同一批名额。
每日评议和定性上限各600家,评议输出上限900万token。
开关和额度由config/company_review_coverage.json热读。
06:00至08:00、20:00至23:00仅处理原候选。
其余时段允许补齐全池,原beat时刻保持。
材料需求单仍使用原targets.collect。
本轮没有一次扩开数千张采集需求单。
报告判据、财务期、幂等指纹和固定引用保持。
批任务返回保留原有字段,新增覆盖和来源读数。
## 实测证据
178原代码为7ef107e,旧服务正在运行。
当前候选148家,全部已有评析、定性与评议。
产业池3833家,高股息研究池169家。
新范围去重后3885家,已有747家,缺3138家。
首批只读预览为30家首次报告与60家原候选轻量复核。
两路范围来源读取成功,review队列为零。
预览未保存累计名单,未投任务,未调用模型。
本地全部离线unittest为264项,通过。
新增26项覆盖轮转、预算、来源失败、在途及任务收尾测试。
已有指纹、报告与财务历史边界测试保持通过。
桥sources.company_reviews仍直接读原索引字段。
报告路径与输出格式未改变。
## 当前部署边界
代码尚未在178拉取,工作容器尚未重建。
新范围尚未投递,不能把只读预览称为覆盖完成。
服务器现有未提交文件保留。
其他仓库只同步本文和规格副本,并追加桥决定台账。
桥现有未提交台账与其他工作保持。
## 上线及撤销
用户同意后,在review队列与在途任务为空时统一重建四类worker。
保留原worker副本数,不调整并发,不重建beat或前端。
核验热读配置与只读预览后,显式向review队列投递首批。
首批成功后,按自然小时批次继续推进。
首次覆盖容量预估约一周,不保证缺材料对象得到完整结论。
撤销时在本地将配置enabled改为false,再提交并由178拉取。
下一批恢复原名单和每日额度。
已在途任务可完成,旧报告与累计名单保留。
## 可运行验证
```bash
# 本地 · /Users/baobao/Documents/work/project/astock-kg
PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=backend python3 -m unittest discover -s backend/tests -t backend
git diff --check
```
预期264项通过,差异检查无输出。
```bash
# 基座机 · ~/project/astock-kg,部署后
docker compose exec -T -e PYTHONPATH=/app backend python /app/scripts/company_review_coverage.py
```
预期dry_run为true,dispatched为空。
初始targets为3885、missing_reports为3138,后续随真实产出改变。
source_errors应为空;无数据与材料薄须分开看。
新增的日检行同时显示最近批次时刻及状态。