From 875a9fc7cbc79bd8ef2f571bb542961c19a3323d Mon Sep 17 00:00:00 2001 From: baobao Date: Wed, 28 Oct 2026 15:26:14 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BA=A4=E6=8E=A5=E5=89=AF=E6=9C=AC=E5=90=8C?= =?UTF-8?q?=E6=AD=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/个股评析全池覆盖开发规格_2026-10-28.md | 103 ++++++++++++++++++++ docs/交接_个股评析全池覆盖_2026-10-28.md | 87 +++++++++++++++++ 2 files changed, 190 insertions(+) create mode 100644 docs/个股评析全池覆盖开发规格_2026-10-28.md create mode 100644 docs/交接_个股评析全池覆盖_2026-10-28.md diff --git a/docs/个股评析全池覆盖开发规格_2026-10-28.md b/docs/个股评析全池覆盖开发规格_2026-10-28.md new file mode 100644 index 0000000..5bf2ada --- /dev/null +++ b/docs/个股评析全池覆盖开发规格_2026-10-28.md @@ -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,带过期和所有者校验。 +同一凭据只能从待执行原子转为执行中一次。 +失败冷却六小时;无数据沿用七天复查,三次评议失败沿用原放弃规则。 +预算沿用索引表的当日登记口径,含失败状态。 +每次模型调用仍受原单次输出上限约束。 +这不是服务商账单的逐次计费审计,不能把登记量称为实际费用。 +排序只决定研究先后,不形成证券评分。 +报告内容及下游排序由现有逻辑继续处理。 diff --git a/docs/交接_个股评析全池覆盖_2026-10-28.md b/docs/交接_个股评析全池覆盖_2026-10-28.md new file mode 100644 index 0000000..a0baaa3 --- /dev/null +++ b/docs/交接_个股评析全池覆盖_2026-10-28.md @@ -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应为空;无数据与材料薄须分开看。 +新增的日检行同时显示最近批次时刻及状态。