edit | blame | history | raw

慧博 10 分钟快速采集工具真实性能测试方案 V001

创建人员：dev.developer.ana.cai
task：DEV-ANA-HIBOR-FAST-COLLECTION-20260729-001
plan_id：PERF-PLAN-ANA-HIBOR-FAST-COLLECTION-20260730-001
owner / reviewer：dev.developer.ana.cai / dev.reviewer.ana.cai
请求来源：HANDOFF-YANBAO-DEV-ANA-HIBOR-FAST-COLLECTION-TOOL-20260729-001、HANDOFF-YANBAO-DEV-ANA-HIBOR-REAL-TEST-SUBJECTS-20260729-001。
实现基线：CODE-DESIGN-ANA-HIBOR-FAST-COLLECTION-V011=PASS/0/0；AUDIT-DEV-ANA-HIBOR-FAST-COLLECTION-IMPLEMENTATION-V001-REREVIEW-003=PASS/0/0，audit snapshot=445118/7396c2b94345b40efe76a7e75c2c947966d6a7e6727acf1a251b648e5fb22d9a。

1. 目标与非目标

本阶段只验证已通过实现审核的工具在真实慧博 APP 环境中的性能与证据闭包：

  • 单份正常样本 median <=480000ms，nearest-rank P90 <=600000ms；
  • 每份到 600 秒必须以 TIME_BUDGET_STOP 收口，不得静默继续；
  • 同查询 batch 的 I01 <=600000ms，I02–I04 相邻 item terminal 增量各 <=240000ms；
  • 10/10 计入样本均需 PDF magic、remote/local bytes 与 SHA-256、openability、page count、manifest、quota ledger 通过；
  • 输出 UI/cache/copy/validation/manifest/terminal 分阶段耗时及失败 blocker。

本阶段不解析研报正文、不生成研究结论、目标价或交易建议；不执行数据库、网络抓取、账号操作、BATCH-001 或外部消息写入。

2. 固定环境与工具边界

对象 绑定
Python C:\Users\Cai\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe；91648/3c6a206b7d93cca823934a83732220dcffd413fd1036d9fb82eebb64599cf7f3
ADB D:\platform-tools\adb.exe；6641760/1e1c2280b90b3f01ad84cd8df4858b1b1995012814f3ca8893bcc3ba3848edec
pdfinfo C:\Users\Cai\.cache\codex-runtimes\codex-primary-runtime\dependencies\native\poppler\Library\bin\pdfinfo.exe；65536/bc2c0f980c9a2a29cd1e06aacd8d1c7b67a5304e9d1d6f75190bdeb9c81a4365
Android package cn.com.hibor
cache /sdcard/Android/data/cn.com.hibor/files/myfile/
project output root ana-data/tmp/HIBOR-FAST-PERFORMANCE-20260730-001/
current-day ledger ana-data/tmp/report-collection-control/daily_quota_<Asia-Shanghai-date>.csv
historical baseline daily_quota_2026-07-29.csv 必须保守登记中国中免 3 次已知 distinct trigger

仅允许顺序启动：一次 Python dry-run；一次历史账本基线登记（仅在该文件不存在时）；最多七次真实 CLI（六次 collect-one、一次 batch）；一次只读汇总/正式 performance package 写入。CLI 内部仅允许已审核的 ADB/pdfinfo 子进程。不得并发启动两个真实采集任务，不得使用额外 PowerShell/Node/浏览器作为候选采集或后处理工具，也不得手工复制绕开工具闭包；Codex host shell 仅用于启动上述已绑定 Python 命令。

3. 执行前门禁

任何真实 reserve/点击前必须全部通过：

  1. 重新校验上述 Python/ADB/pdfinfo 普通文件、bytes/hash，项目 cwd=E:\mb-ms-doc\project-info\dev\ana-dev。
  2. python -m hibor_fast_collection --task <dry-run-task.json> --dry-run 返回 V009 terminal、exit 0、ADB action=0、trigger=0、quota write=0。
  3. 只读确认单一可用 MEmu device、package=cn.com.hibor、cache 可读、APP 可见且无登录/验证码/付费/订阅/权限阻断；多设备或身份不确定立即 STOP。
  4. 若 daily_quota_2026-07-29.csv 不存在，使用已审核 QuotaLedger.initialize 仅追加 BASELINE_ESTIMATE=3，evidence_ref=HIBOR-CHINA-DUTYFREE-20260729-001；若存在则只读复核，不覆盖、不降低。
  5. 对执行当日先读取 APP visible remaining 并写 APP_RECONCILE。safe_available=max(0,27-confirmed-uncertain-active)；不足 10 时只允许执行实际安全子集并返回 INSUFFICIENT_PERFORMANCE_SAMPLES，不得越过 27。
  6. 在第一次 reserve 前完成只读候选发现，生成一次 performance_plan.json；CreateNew、不可覆盖。每行固定：plan_id,created_at_utc,slot_id,mode,batch_id,item_order,query,expected_report_identity,external_exclusion_allowed,selected_from_readonly_discovery。文件 bytes/hash 登记到 performance manifest。

门禁失败不消耗 trigger；保留已产生的普通预检证据并停止，不自授权修复环境或绕过访问控制。

4. 固定样本结构与候选规则

slot mode query pool 目标
PERF-S01,PERF-S02 collect-one 三环集团 两个不同 report identity
PERF-S03,PERF-S04 collect-one 国瓷材料 两个不同 report identity
PERF-S05,PERF-S06 collect-one MLCC 两个不同 report identity
PERF-B01-I01..I04 同一 batch(quantity=4) MLCC 四个不同 report identity
PERF-A01..A03 no-trigger alternate 三环集团 / 国瓷材料 / MLCC 各一 仅替换 reserve 前 external-excluded primary

候选必须使用正式硬过滤、评分、3–5 屏早停与 20 屏/100 候选硬上限。十个 primary 的 expected_report_identity 在只读 discovery 后锁定；重复、主体不唯一、字段不完整、已在本计划占用、需要登录/付费/权限的候选不得进入 primary。alternate 只能在 primary 尚未 reserve/点击时替换，且总 distinct new trigger 仍 <=10；不得触发第 11 份。

每个 slot 使用唯一 task_id、handoff_id、performance_slot_id，全部绑定本 plan_id。六次 collect-one 的后续任务通过已锁定 identity/exclude 约束避免 PROJECT_REUSE 冒充新性能样本；任何 pure reuse 记录为 NO_TRIGGER_REUSE_NOT_IN_SLA_POPULATION，不消耗 trigger，也不能补足 10 样本。

4.1 TaskSpec 生成合同

所有 dry-run/真实任务都使用 HIBOR_FAST_TASK_SPEC_V003 的既有 43 键顺序，不增删字段。公共值固定为：

  • project_id=project-info；source_role_instance_id=requester=case_analysis.report_collector；source_thread_id=reply_thread_id=019fa8b1-ba04-74a0-883a-e4451bc24503；target_role_instance_id=dev.developer.ana.cai；target_thread_id=019f8057-49c9-7410-8772-76429bed4909；review_owner=human_user_current_thread。
  • output_root=ana-data/tmp/HIBOR-FAST-PERFORMANCE-20260730-001/output；destination=ana-data/tmp/HIBOR-FAST-PERFORMANCE-20260730-001/archive；quota、tool、package、cache 使用第 2 节绑定。
  • minimum_pages=1，min_screens=3，normal_max_screens=5，hard_max_screens=20，hard_max_candidates=100，close_reserve_ms=30000，batch_increment_budget_ms=240000。
  • collect-one：quantity=1,total_budget_ms=600000；batch：quantity=4,total_budget_ms=1320000。performance_plan_id 固定为本 plan_id，performance_slot_id 为表中 slot/batch id。
  • observed_at_utc 在对应 CLI 启动前立即生成；task_id/handoff_id 唯一且不可复用于另一个 primary。query 仅来自三类授权池；aliases/institutions/analysts/date_range/exclude 只允许取自已锁定的只读 discovery 事实，用于命中 expected identity 与排除已占用 identity，不得扩展主题。

task JSON 是普通内部控制文件，按语义验收和 CreateNew 保存；一旦该 slot 已 reserve，不得修改该 task。run_id 继续由已审核实现从完整 TaskSpec 确定性派生。

5. 额度、失败与恢复

  • reserve 前写 RESERVE；稳定新增 cache 后写 CONSUME_CONFIRMED；无法确认写 CONSUME_UNCERTAIN；确认未触发才写 RELEASE。
  • damaged/non-PDF/duplicate/failed-after-trigger/uncertain 均按正式规则消耗；active reservation 始终占用 safe limit。
  • slot 第一次成功 RESERVE 即进入 SLA 分母。触发后的 timeout、internal、validation、mapping、quota-state failure 不得排除或重跑成新样本。
  • 只有 reserve 前已证明的登录/验证码/付费/权限、模拟器离线、APP 服务不可用或报告不可访问可使用预登记 alternate；证据为开始/结果/详情/结束截图、UI dump 和 terminal。
  • 任务失败可重放同一 task/run 以验证幂等，但 terminalled reservation replay 不得再次点击；重放不算新样本。不得删除、改写或重命名远端缓存原件、账本事件、已发布 PDF 或正式 package。
  • 当日额度不足、候选不足或外部 blocker 导致少于 10 个有效样本时，返回有效子集并顺延；不得扩展到三个授权主题以外。

6. 逐项执行与时间定义

  1. 先依次执行 PERF-S01..S06；每项 observed_at 是正式 task 被当前执行观察的 UTC 时间，item close=observed+600s，work close reserve=30s。
  2. 再执行 PERF-B01；I01 从 batch observed 到 I01 terminal，I02–I04 从前一 item terminal monotonic 到当前 terminal；每项另记录自身 start-to-terminal。
  3. 所有 task 只通过 python -m hibor_fast_collection --task <task.json> --execute 执行一次。CLI stdout 保存为对应公开 terminal 的调用端副本；正式权威 terminal/manifest/delivery/timing 使用工具 CreateNew 文件。
  4. 任何 task 到时、process liveness unknown、终态不确定或访问控制出现时先终止本 task，按 terminal 决定是否允许继续下一尚未 reserve 的 slot；STATE_UNCERTAIN/27、额度不确定或进程仍存活时停止整个批次。

7. 证据包与验收算法

固定根：ana-data/tmp/HIBOR-FAST-PERFORMANCE-20260730-001/。正式 package 至少包含：

  • performance_plan.json 与 10 primary/最多 3 alternate 记录；
  • 每个 task 的 task spec、V009 terminal、manifest、delivery、timing 和必要截图；
  • 成功 PDF 原件副本及 remote/local bytes/hash、magic、openability、page count；
  • daily_quota_2026-07-29.csv baseline 证据、执行当日 quota ledger 和最终 snapshot；
  • performance_manifest.csv：逐文件 path/bytes/SHA-256/source slot/type/status；
  • performance_summary.json：固定字段 schema_version,plan_id,started_at_utc,ended_at_utc,primary_total,included_total,success_total,trigger_total,confirmed_total,uncertain_total,active_total,median_ms,p90_ms,batch_first_ms,batch_increment_ms,magic_pass,byte_match_pass,hash_match_pass,openability_pass,page_count_pass,manifest_pass,quota_pass,result,blockers。

统计算法继承 V002：10 个计入耗时排序，第 5/6 平均为 median，第 9 个为 nearest-rank P90。PERFORMANCE_PASS 必须同时满足：10/10 SUCCESS；trigger<=10；median<=480000；P90<=600000；batch I01<=600000；I02–I04 各<=240000；所有 PDF 与 manifest/quota 校验通过；最终 active=0；全程 effective consumed<=27。否则只能是 PERFORMANCE_FAILED 或 INSUFFICIENT_PERFORMANCE_SAMPLES，不得用排除项伪造 PASS。

8. 审核、授权与停止边界

本方案先提交 dev.reviewer.ana.cai 独立审核。只有 PASS/0/0 后，才可向 management.admin 申请一次针对本 plan 的真实 APP/ADB/最多 10 trigger 授权。管理授权应允许本方案内普通可恢复 UI/APP 操作与同一 slot 的幂等读取，不使用旧式每 URL/每命令一次性 A001；但额度、访问控制、账号与外部写边界保持 fail closed。

执行后由 dev.reviewer.ana.cai 独立复核 performance package 与统计结论；普通下载结果的 review_owner 仍为当前人工请求者/case_analysis.report_collector。实现 PASS 不等于性能 PASS，性能 PASS 也不授权研究正文、数据库或 BATCH-001。

当前状态：PENDING_INDEPENDENT_REAL_PERFORMANCE_PLAN_REVIEW。当前真实 APP/ADB/download trigger/quota increment=0/0/0/0。