SKILL.md · diff
git:20261018.fa38912 to git:20261019.41b3a41
29 added, 3 removed. Audit C to C.
# Audio Paper Digest 操作手册
本手册用于执行日更、官方会议和历史博客更新。先完成运行前检查,再进入对应流程;失败恢复与专项约束放在正常步骤之后。执行限制见 [AGENTS.md](AGENTS.md),实际代码与 Prompt 对应见 [三流程表](docs/three-workflows.md),配置参数见 [安装配置](docs/setup.md)。
## 持续授权与执行选择
用户已授权三条流程中为提高效率和效果所需的全部付费轮次,包括失败恢复、局部修复、必要的完整重生成和审查。不要再次逐篇、逐轮或逐阶段询问费用授权;仅用户后续明确撤销或另设限制才改变此授权。执行细则见 [AGENTS.md](AGENTS.md#持续授权以效率和效果为准)。
先全批正常处理,再集中续跑失败集合;优先复用合格来源、检查点、成功稿及已付响应。遇到持续无进展,判断应修共性规则、正常付费修复还是来源绑定人工收尾,选择更快获得合格结果的路径。旧清单的轮数和响应上限是单窗口技术限制,不是用户的总授权上限;必要时由执行者登记有完整前序历史的新窗口,实现不支持则修正验证后继续。旧许可、原计数和费用不得改写或清零,新增调用另记,正常来源、质量和发布核验仍须通过。
## 运行前
Reader 指面向初学研究者的解读长文;内部主分析、来源和发布凭证分别核验。常见术语见[写作约定](docs/writing-guide.md#术语先解释再统一称呼)。下列检查未通过时,先停止,不用生产任务测试配置。
1. 核对 `pwd`,统一工作区为 `/Users/francis7999/code/github_repos/audio-paper-digest`,执行 `npm run workspace:role -- status`;角色保持 `daily`。历史操作通过已配置跨角色开关运行,不进入废弃工作区。
2. Node、Python 和依赖有效,项目 `.env` 权限为 `0600`。主模型及启用的副模型按项目配置统一为 `muse-spark-1.3-contributor`;Muse 和 arXiv 强制使用项目 HTTP CONNECT 代理。
3. 确认真实博客仓库与目标页面没有人工修改冲突,检查其他生成、审查与发布进程,三流程错峰运行。
4. 所有脚本、检查和测试在沙箱外执行,不绕过环境、角色或来源检查,不把 `data/`、日志、缓存、密钥纳入 Git。
+ Node CONNECT/TLS 使用与模型请求相同的有效时间计量,握手总预算仍为 60 秒。“系统睡眠/长时间挂起”也可能来自本地同步核验阻塞,须按[连接排障](docs/troubleshooting.md#2-主模型请求失败超时或空响应)区分原因;共性故障先停稳、修复并验证,再沿同一清单与原账续跑。
+
认证故障先停止生产新派发并保存结果;配置了多个账号时,在独立诊断中逐个使用真实模型、路由和代理做最小请求,按正常方式保存用量,找出实际可用账号后备份并修复主副配置。不要把单账号 401 推断成全部凭据失效,也不要未核对完整账号池就让用户更新密钥。此诊断已获持续付费授权;不改原冷却记录、不显示密钥或稳定凭据指纹,不改变同一论文逻辑请求遇普通 401 即停止的规则。HTTP 200 截断不等于完整内容通过,恢复前确认所选账号能返回完整响应。
## 1. 日更
```bash
npm run digest:prepare -- YYYY-MM-DD
# 仅用户已明确取消视觉时:npm run digest:prepare -- YYYY-MM-DD --no-visuals
# digest:api 完全等价
```
仅北京时间当天允许从抓取开始。默认入口要求实际遇到各来源以前获取过的论文:保留已核验的原窗口,向前重叠覆盖旧编号及时间见证,完整处理每页与窗口后才进入模型流程。缺完整旧证明、时间漂移或未遇见证须停止,详见[抓取边界](docs/daily-fetch-boundary.md)。
入口执行候选抓取、关键词预筛、LLM 筛选、当次官方 HTML/PDF 封存、分析、Reader、评分、标签、生成、审查与推送;最后继续完成部署、网页及视觉验收。
当次封存位于 `data/runtime/daily-fresh-source-runs/<runId>/sources/<arxivId>/generation-000001/`;分析只读其中 TXT、PDF、元数据和清单。图片仅在当前调用的系统临时目录准备。来源缺失或 SHA 不符须在模型请求前停止。
```bash
npm run deep -- --date YYYY-MM-DD
npm run batch
npm run api:reader:refresh -- --all --date YYYY-MM-DD --concurrency 5 --scoring-and-reader
./run-daily-digest.sh YYYY-MM-DD --from generate
./run-daily-digest.sh YYYY-MM-DD --from review
./run-daily-digest.sh YYYY-MM-DD --from push
```
日更恢复命令不重新抓取历史日期,也不补建来源或读取旧缓存。日更分析和 Reader 刷新按后文的[批次恢复顺序](#批次与失败恢复顺序)执行。Reader 刷新未传 `--concurrency` 时使用配置并发,默认 5,显式范围 1–60;总轮数默认 3,可用 `--rounds N` 覆写为 1–10。Reader 只续明确可重试项,来源计划、运行级或存储故障停止新派发。
显式追加有限付费重试须使用绑定当前来源、失败草稿与额度的清单,见[恢复预算](docs/reader-explicit-retry.md)。人工修正只能使用已授权、来源绑定的受控恢复入口;不得把失败伪装成成功、清零费用或重试次数。
已签名日更稿的显式 `--reader-signed-corrections` 沿用原退休付费稿、完整父稿 CAS 和正常最终校验:v1 仅有界中文术语替换;v2 保存完整父稿,限定既有节点内受拒原句的逐字范围,并重放全部真实人工历史,不增加请求。表绑定修正另须完整原 DOM 表证明,详见[签名稿修正](docs/reader-explicit-retry.md#已签稿的有界事实修正-v2)。
`reanalyze` 是显式强制全量重分析,会保留归档并停用旧候选;本次每篇只在首次准备时执行获准的重置,后续失败轮继续原候选和预算,选定重分析同样不按轮重复重置。普通恢复优先同入口和原稿。
## 2. 官方会议
```text
conference:acquire → conference:discover → 全文证据与每会筛选
→ conference:process → conference:publish:generate
→ conference:publish:review → conference:publish:push
→ conference:publish:verify
```
参数、官方会议来源、账本、导入、并发、来源升级与断点恢复见 [会议工作流](docs/conference-workflow.md)。唯一分析入口是 `conference:process`,内部调用公共 `analysis-engine.js`,不再提供独立execution/analyze/postprocess旧CLI。
会议 `conference:process` 外层并发默认1、`conference:migrate-process` 默认3,均可显式设置 `--concurrency N`(1–60)。Reader 仍受原 `PD_API_READER_CONCURRENCY` 限制,正常完整分析修订最多占用原主分析配置下的3槽,每篇内部并发仍为1;调度并发不改变来源计划、模型、请求额度或整批轮次。
- 完成稿的实现迁移重暂存也使用该并发,私有工作线程最多5个。各线程独立核验实际状态、原计划与来源并执行原整篇资格及页面生成,全部禁止模型请求;主线程核实际页面/资产和原包SHA,最后统一CAS保存。普通单篇失败收集到批末,运行级故障停止新派发并等待在途保存,不以并行省略校验。
+ 完成稿的实现迁移重暂存和完整汇总默认沿用该并发,私有工作线程最多5个。迁移可显式加 `--postprocess-concurrency 1–5`,只单独控制这两个硬禁模型的阶段;例如 `--concurrency 1 --postprocess-concurrency 5` 保持单篇 Reader 调度,同时并行处理完成稿。各线程独立核验实际状态、原计划与来源并执行原整篇资格及页面生成;主线程核实际页面/资产和原包SHA,最后统一CAS保存。普通单篇失败收集到批末,运行级故障停止新派发并等待在途保存,不以并行省略校验。
固定本地 PDF 提取器或会议页面渲染器确实子进程超时时,保留原错误、先完成全部首轮,再把这组超时项各串行正常重试一次。成功稿不重跑,第二次仍失败则正常报告,不递归重试。重试仍核同一状态、实现、来源及原包,硬禁模型,不增加分析次数或费用;网络、认证、来源及运行级错误不适用,停止信号禁止重试派发。
完整会议汇总沿用该私有池,最多5线程,每篇只做一次正常完整 `loadStage`,复用已核验正文与页面。主线程仍在真实操作锁内核对完整计划、状态、来源、正文和全部页面资产,写汇总前再次核验;不能用可序列化JSON或子集结果授予完整汇总资格。旧同步来源升级接口同样消除重复正文资格检查。
准备人工收尾并需保留原失败稿时,可显式用 `--postprocess-only --preserve-failed-readers` 暂缓末尾的零请求重放与采纳,全体完成稿仍正常核验。不得混入重试、恢复许可、Reader人工清单或来源纠正;不改原候选、次数与费用,也不产生完成或发布资格。
仅更新完整会议的页面时,先核对原全成员状态,再正常恢复或显式实现迁移,重暂存单篇和汇总,复用原合格分析与费用。未发布 process 才继续上述发布三阶段;已有 `publish.json` 的 ID 不因重复 generate 更新,已有 URL 按历史维护入口处理,见[只更新会议页面](docs/conference-workflow.md#已有完整会议只更新页面)。
旧完成稿遇当前检查失败,迁移先统一处理全体并报告失败集合;同一命令显式加 `--retry-failed` 才恢复这些稿件。原父运行与费用保留,子运行绑定真实原来源并按公共失败轮次续跑;上游合格时按封存资源预检选择 Reader 或评分+Reader,旧 Unicode 输入或核心问题则正常完整分析。成功逐篇即时保存,中断仍须核验父子连续链,不能重签旧稿、变更原预检与模式或清零预算。
会议生成收尾和冷启动后处理须在已核验的真实来源上下文中重放 Reader 资源声明。中断后先复验确已在该子运行完成并保存的新稿,再决定是否请求模型;不能把继承父稿当作新修复成功。核心摘要修复使用同一公共修复器,诊断按真实会议身份与执行隔离,不编造 arXiv 编号,详见[会议页面恢复](docs/conference-workflow.md#已有完整会议只更新页面)。
+ 普通 Reader 维护的单篇同步冷核会合并同一历史材料断言的重复调用,每个已用断言首次及返回前仍完整重读;当前子稿、父稿、修订、种子和预检另核实际 SHA。公共完整修订读取器统一进入该范围,已付候选恢复在锁前、锁内及后续的读取各自开闭,不跨 `await`。来源、Reader、渲染及资产的正常资格检查保留,暂存输出与历史材料隔离。作用域在异步、保存与下一篇前结束;窗口和排除路径走原完整检查,不复用通过标记或增加额度。
+
+ 出版来源共同引用的文件在单次断言内按真实私有句柄批核,仍完整重读每份唯一文件;不能用 JSON、文件大小或修改时间充当核验。历史父包的不变守卫保护首次完整加载的四文件原 SHA 及成员身份,当前子稿和全部科学检查继续正常执行。实现改变时保留原证明,显式正常重算来源、几何和像素后另存当前重验记录,不能把旧实现 SHA 改成当前值。
+
资源预检从真实 PDF 导出脚注证明后,其即时复验与之后冷读取仍须绑定同篇原计划、来源文件和快照,不能在来源作用域外仅凭复制的证明对象核验。中断产生的已付局部响应先按原候选和费用重放,未收到响应的请求诊断不冒充新付费结果。
完成稿只有资源脚注、没有认证表格时,出版冷核和渲染同样保留原计划返回的PDF能力;脚注来源与链接可达状态继续分别核验。
会议原活跃付费候选只能在私有副本和硬禁新模型请求的独立异步作用域中提前复验;正常全资格通过才保存完成,原子运行轮次、失败和费用保留。process 重试窗口不能替代子运行上限,实现升级不新增付费许可。日更、会议和历史直改候选均按真实来源路线恢复。
必要的会议追加付费恢复已获持续授权,执行者显式加 `--retry-failed --recovery-manifest ABSOLUTE_PATH` 登记并执行,不再索要确认。每个窗口最多3轮、Reader累计6次内容响应及2次完整长文;后续窗口使用同合同的 `version: 2` 清单,每个成员以 `continuation` 绑定前 grantId/SHA、唯一最新失败窗口完整材料树 SHA 及原 Reader 账 SHA(确无账时为 null)。先正常采纳已经完成的子稿,再绑定停稳状态物理 SHA 和完整剩余失败集;旧 v1 不扩权,不能回退最早失败稿或平行重授。保留旧稿、旧额度和费用,已通过阶段核验后复用。完整分析模式从已绑定的原完成父稿重放原词表,未完成子稿的缺失或失配标签交正常分析修复,最终仍严格核验新稿自身标签。新旧窗口分账,中断继续同一窗口;冷发布核验禁止模型。清单格式及来源 CAS 见[会议追加恢复](docs/conference-workflow.md#原额度耗尽后的独立付费恢复)。
新增窗口内再次遇到已付核心摘要被拒时,沿公共路径重验该窗口自己的唯一最新原响应;不能因初始化时已重验原失败稿,就漏掉新子稿的付费响应,也不能借外层余额重付摘要。
独立会议正常恢复从第二轮起保存已失败非 Reader 阶段的请求禁令,跨轮只增不减。正常纯校验与原付费响应重验可以继续;不能因标签、摘要等阶段后来纯检查通过,便再次授予它们模型请求。新下游阶段沿原上限运行,Reader 仍由原累计账本控制。
原会议许可全轮结束后,少量完整失败集仍有真实活跃候选、上游与来源完整时,可使用同迁移入口的显式 `--reader-corrections`。每篇限1–8个已有节点,入口硬禁模型及网络,原包/候选/账本/资产均绑定;正常解析、整篇资格与暂存通过后才采纳,保留原计数及费用。该零请求入口自身不付费;需要付费时按持续授权选择正常恢复,不受“不得第四轮”的授权误读限制。旧签稿无候选或上游仍失败不能借此修正,见[会议零请求修正](docs/conference-workflow.md#最后失败集合的零请求-reader-修正)。
+ 同批少数人工子稿已保存但未全批采纳时,仍用原清单续跑;程序核验真实完成凭证、完整 before 包及当前 canonical,不重签清单或重复请求。实现变化只能由这种真实保存断点先续完原批,再执行全会正常迁移与汇总。资源阶段遗留父稿指针时,只能按同次已核预检及真实父稿恢复私有视图,评分+Reader 另核本次评分检查点;原主文、评分、标签和费用保留,冷热重放同一派生。
+
会议分析最终被拒时,仅在当前真实来源上下文、执行及认证 PDF 来源能力全部核验后保留本次返回正文和捕获的真实阶段检查点,仍记失败供正常续跑。不能补造已丢失的旧检查点或借原完成父稿替最新主文。
原正常分析仅因 Reader 失败而留下空主文时,人工入口只可使用同执行已完成、三份 SHA 相同且科学上游完整的评分检查点作为私有视图。原包、失败、计数和费用不变,不能借父稿填主文;缺失官方图阶段须由正常函数在新 Reader 绑定后收尾,并在冷核重放。
来源纠正中的旧作者签名从私有已核 Reader 父稿重放,先确认其作者全集及来源 SHA 与最新科学主文一致。主文尚无完成 Reader 时不要求它具有旧作者阶段,也不复制父稿阶段冒充主文已完成;原合法机构不可得提示保留,错误姓名、来源或签名仍拒绝。
新 Reader 和官方图收尾后,须先对仅去掉原 Reader 失败字段的临时视图运行正常整篇资格,通过后才解除当前对象的失败。两条错误通道分别核验,非 Reader 或运行级失败不适用;原失败包、事实义务、未知尝试字段、计数与费用保留,冷核重放同一有界投影。
唯一缺表可显式使用成员子类型 `single-source-table-append-v2`,固定原14节、1表/1绑定、4图、0式,仅在既有第11节尾追加一张原 PDF 五列表及第二绑定。原六文件 CAS、唯一来源表窗口及完整新旧稿须重放;原表与其他节点不改,v1继续拒结构增改。正常显示计划的派生引文须完整重放,不增加请求或提前授予完成资格。
最新付费 Reader 在外层保存失败前已退休、没有活跃候选时,只有 `latest_resolved_paid_reader` 成员可从唯一最新退休稿按 v1 修正。须重放登记账本、付费请求/响应/费用、Prompt、完整迁移链及正常归一,当前主文/来源/资源输入相同才成立。普通 reader-only 恢复可在请求前将这种已认证情况保留为单篇待本地纠正;原链或账本损坏仍停止整次运行,不能复活候选、清零次数或再授额度。
需先统一检查而不继续付费时,迁移显式加 `--postprocess-only`:保存正常后处理及迁移结果后返回,不派发分析、不释放重试、不聚合。认证 PDF 的资源归属或原完整稿唯一核心句确需零请求纠正时,使用独立物理清单及 `--postprocess-only --source-corrections ABSOLUTE_PATH`;资源与核心权限分开,保留最新主文、真实 Reader 父稿、原失败和费用,仍经正常整篇热核、保存冷核和暂存后原子采纳,详见[认证来源纠正](docs/conference-workflow.md#认证来源事实的零请求纠正)。
普通迁移和 `--postprocess-only` 在调度前检查普通修订及原许可派生的真实保存子稿:即使 process 尝试耗尽,也在操作锁及论文锁内硬禁模型,正常核验来源、整篇资格及页面后 CAS 采纳。唯一已有付费候选可先经同一适配器的 `replaySavedConferenceReaderRevision()` 纯恢复;没有通过时,须在尝试、失败和费用写入前返回,原包字节不变,不能用禁止模型后的异常增加次数。成功须真实保存并封存为完整子稿,再由正常页面核验及采纳记录进入 process。旧失败完整归档,次数、释放历史和费用保持不变;不准备新子稿、预检或许可,不为未完成稿请求模型。随后才以实际剩余失败集合准备新窗口,避免重复购买已经合格的稿件。
混合失败集合逐篇沿当前父稿和最后真实登记继续:未采纳窗口保留原许可及次数,已采纳完成子稿的新维护以当前完整稿为父稿。分析、来源及回执不符仍停止,不能回退祖父稿、追加无许可释放或重置原窗口预算。
实际完整尾集合同时需要初次追加和旧窗口延续时,显式使用同合同 `version: 3`:逐成员写 `continuation: null` 及普通失败完整树 `initialMaterialsSha256`,或写原严格延续对象。先正常采纳已经合格的保存稿,再绑定新的停稳全失败集;不能拆集合或把旧窗口冒称初次,旧v1/v2解释不变。详见[混合追加窗口](docs/conference-workflow.md#原额度耗尽后的独立付费恢复)。
- 已登记来源纠正稿再次维护时,来源祖先投影只证明真实原包、事务、来源和调度历史,不提前授予正文发布资格;占位表等正文问题留给正常页面检查收集。原纠正合同绑定整包、无法独立继承科学阶段时,使用原认证来源创建正常完整分析子稿,不复制旧纠正标记或补签旧阶段。原完整父稿、来源祖先链与费用保留,新稿仍通过全部正常分析、Reader、评分、页面及出版冷核。
+ 已登记来源纠正稿再次维护时,来源祖先投影只证明真实原包、事务、来源和调度历史,不提前授予正文发布资格;占位表等正文问题留给正常页面检查收集。除本节真实未签发的资源评分恢复外,原纠正合同绑定整包、无法独立继承科学阶段时,使用原认证来源创建正常完整分析子稿,不复制旧纠正标记或补签旧阶段。原完整父稿、来源祖先链与费用保留,新稿仍通过全部正常分析、Reader、评分、页面及出版冷核。
来源纠正的新 Reader 须使用正常 finalizer 当前五项 Reader 合同,原图持久化声明保持原样;旧稿缺少 Reader 声明不阻止正常补齐。其它科学合同及非 Reader 阶段继续逐字保护,不能通过删合同对象放宽检查。
论文必须有真实会议身份、官方PDF、来源SHA及能力记录。只有PDF时不能推断HTML DOM能力,不为会议补造arXiv ID。图像/公式仍按真实PDF像素核验。页面及JSON/BibTeX/RIS/上下文使用同一展示与导出核心,缺失摘要或公开URL如实标示。
+ 会议发布审查普通拒稿先等全批结束。汇总在原五个审查槽位中优先派发,论文原相对顺序不变,单页分块仍串行;最终记录恢复 generation 顺序。正文及共享格式清理仍不能解决的 Markdown 拒稿,以真实原阶段和完整集合进入正常 Reader 维护,不逐篇先精改:
+
+ ```bash
+ npm run conference:migrate-process -- --apply --catalog CATALOG.json --report REPORT.json --filter FILTER_UUID --from PROCESS_UUID --concurrency 5 --reader-review-feedback /absolute/process/review-reader-maintenance/BATCH_UUID/manifest.json
+ # 原独立维护窗口确已停止后,绑定完整实际失败集合追加下一窗:
+ npm run conference:migrate-process -- --apply --catalog CATALOG.json --report REPORT.json --filter FILTER_UUID --from PROCESS_UUID --concurrency 5 --reader-review-feedback /absolute/process/review-reader-maintenance/BATCH_UUID/manifest.json --reader-review-window /absolute/process/review-reader-maintenance/BATCH_UUID/windows/WINDOW_UUID/manifest.json
+ ```
+
+ 示例消费已核验并安装的真实清单,不能手填 UUID/CAS 或把 O 内准备器当公共 npm 命令。每窗固定最多3轮、Reader累计6次内容响应及2次全文,必要新窗已获持续授权;先全批后失败集合,保留原主文、核心、评分、标签、原候选和全部费用。完成后同次入口仍执行正常全会 stage 与汇总,再 generate/review/push/verify。pending 时不得另跑普通迁移使原基线漂移,详见[正常 Reader 维护](docs/conference-workflow.md#博客拒稿后的正常-reader-维护)。
+
+ 初始化可将符合原调度条件的普通 Reader-only partial 子稿交原正常入口统一恢复:要求原总轮数为3、显式无独立窗口、实际尝试少于3,并按正常入口确认同一父稿、来源、原标签及科学上游可复用。正常入口仍先在锁内重放保存稿和活跃付费候选,再决定是否增加尝试;其他模式、耗尽、原调度排除项或父预检不符仍走原初始化,不能把延后当通过。
+
+ 维护默认保留原评分;未签发的原资源模式失败若仍为零尝试、原五文件准备态,正常一次重探真实保存 `still-requires-scoring` 回执后,才可由私有能力首次签发评分+Reader。原 before、父包、来源、反馈和固定预检须全部闭合,评分不二次探测换身份;评分即时保存,后续仅续本次真实检查点。资源纠正父稿保留原来源祖先,新稿独立核验新评分与 Reader;已签模式、核心纠正父稿、窗口或已付请求不能套用。详细约束见同一维护章节。
+
+ 会议生成、审查及推送均重新批核完整作者来源,包含维护历史;该固定作者子进程允许3600秒且仍限制2 MiB输出。页面渲染外层600秒、普通资源核验和其他流程的原期限保持,真实超时、截断或来源失败继续阻断。
+
+ 图片拒稿可先统一绑定原认证 PDF 的完整页展示并正常重审;目标印刷图和页码须明确;完整图注缺失时,仅真实原 sourceRef 页能力可进入有限原页展示,完整图注字段为 null 并显式提示未完整抽取,不补造图注,也不把整页其他图认作配错。未解决图文语义再进入上述正常维护。换展示像素不会改变 Reader 原输入或授予通过;新视图清单、PDF、派生证明和页面字节仍在每次发布冷核,详见[独立出版视图](docs/conference-workflow.md#认证-pdf-的独立出版视图)。
+
## 3. 历史博客更新
```text
history:inventory / conference-local-sources → history:inputs
→ conference-projections → history:plan → history:sources
→ history:metadata → history:run → history:aggregate
→ history:publication: plan → generate → review → publish → status
```
完整参数见 [历史重写](docs/history-rewrite.md)与[独立历史发布](docs/history-direct-publication.md)。历史按冻结页面范围去重,同篇只分析一次;每轮arXiv重新获取官方TXT/PDF/运行元数据/清单,保留的会议元数据和PDF必须SHA核验。旧分析、旧博客、旧图片不进入写作输入。
独立发布要求完整来源/页面覆盖、当前Git基线、审查与精确差异证明。`publish --apply` 统一在共享博客锁内激活、提交、推送和OID验证。禁止用旧 `activate --apply` 绕过凭证。
暂停后 `history:resume -- --plan ...` 继续当前直接计划;旧已存在来源任务通过 `history:resume -- status|analyze --run-id ...` 恢复,不能新建旧任务、重新获取来源或重置预算。旧状态适配仅为已有断点核验,不是另一条生产链。
ICML/OpenReview替代PDF默认拒绝;唯一用户授权例外 `conference:icml:2026:openreview-forum-id:n1mAjfRDZ6` 仍核验固定SSRN标题、作者、DOI、获取凭证与PDF SHA,必须说明非camera-ready;不可推广。
## 批次与失败恢复顺序
先让本次选定论文全部按正常流程处理,等整轮结果保存后,再只处理仍可重试的失败集合;默认最多 3 轮。通过当前资格核验的成功项保留,原来源、阶段检查点、Reader 草稿与费用沿用。并发和批次轮数不增加单阶段或 Reader 的原预算;运行级故障和温和停止都会阻止新轮。
共性校验误报应在整轮结束、生产进程停止后统一修复。验证同时使用原付费失败稿、封存来源及正反回归;构造例须与真实原稿区分。修复后仍交回正常完整检查,额度用尽的稿件沿用受控恢复协议,不因改代码获得新次数。
正常候选完整重验后出现新的阻断问题,可在严格核对原问题双签名、旧组不再出现且原内容响应额度仍有余额时继续原余额。完整长文已用完 2 次时,仅全部新问题有明确路径、由 1–8 个旧 SHA 绑定的既有节点完整覆盖且无需来源整稿重试的安全局部补丁可继续;空目标、重叠、整组操作和任何全文回退仍阻断。历史次数和连续失败记录不清零,同组缺项或阈值变化不算新组;归一化、传输、来源及已耗尽预算仍阻断,见[原余额恢复](docs/reader-explicit-retry.md#正常候选中的原余额)。
PDF 表格的来源适配不改变这项原则。正常生成、候选恢复和发布冷核须使用同一认证 PDF 取证能力;只有原表表头或明确表注与目标行列唯一对应时才支持单位。原表缺少单位、重复列无法定位或跨表借证仍须失败,不能因补证适配而放宽。历史来源保持真实直改身份,旧完整会议的出版补证仍不能给未完成分析授予资格。
原表同名方法若以明确的 `Dim` 输入维度列区分,展示须保留全部原数值列并核对完整条件身份。平表中的维度、容量或微调行带由真实 PDF 几何、完整字形及分隔线重放;条件路径与原行名一并保留,不用结果值选行。共用资源校验逐项区分复现前待验证的条件、明确缺少公开证据、经核验的第三方链接与作者资源发布;局部否定或第三方归属不能替相邻的作者公开声明作证。
表格已有的逐字引文完整通过数字、单位与原 PDF 行列核验时,正常自动补证保留这些引文,不再加入数字相同的其他表片段。只有证据不完整时才派生补证;这项修复不增加候选额度,旧稿仍须正常完整重验。
来源绑定的定向事实反馈先在论文锁内核验并保存原包和未完成义务,再发模型请求。保留旧成功正文不表示新纠错已经完成;最新失败或未完成义务必须阻断完成与发布。只有真实正常恢复、付费响应重验或受控修正通过当前反馈和全部资格后才清除,状态查询和合并不能自行抹掉失败;保存故障按整次运行故障停止新请求。
多轮后只剩少量顽固项,才进行受控人工修正:核对真实来源、原失败稿、具体反馈和修改范围,再交回正常校验及博客审查。`manualHandoff` 只报告建议,不改状态或授予新请求额度。共享参数与三流程边界见 [批次规则](docs/three-workflows.md#全批轮次与失败集合),有界付费追加见 [Reader 恢复](docs/reader-explicit-retry.md)。
会议人工清单默认核对原窗口全部正常轮次;显式历史技术停止声明另核当前与直接前驱至少2次真实同源执行的内容响应、失败与材料树,不把单次多响应当作多轮。原完整付费JSON的版本4→3投影及原2个已绑定TABLE占位的0→2恢复,均须独立声明并保留原候选,合计最多8个已有节点;随后正常核验整稿及所有来源,不自动扩展日更或历史人工范围。详细字段与冷热回执见[会议人工收尾](docs/conference-workflow.md#最后失败集合的零请求-reader-修正)。
### 日更耗时控制与尾部收尾
10 月 16 日的逐阶段证据、返工原因和提速实测见 [性能审计](docs/daily-performance.md)。后续执行采用以下收尾顺序,不把同一顽固集合拆成反复试一篇、再看一篇的循环:
1. 生产期间冻结共享实现;一次正常轮次结束后收集完整当前失败集合。把内容错误、来源/格式问题、系统校验误报、身份/父稿问题和服务故障分清,再选择已有恢复入口。系统规则不能由当前正文补丁改变时,不为同一误报反复追加模型请求。
2. 恢复方案同时核对当前原稿 CAS、全部阻断问题、来源、父包/pending 义务、候选选择和原预算;identity/replay 工具只证明其声明的身份,不能当作实际下一请求的完整预检。正常执行的 `[reader-next-request-plan]` 报告真实 full/patch、问题集合指纹和剩余次数,但明确不是最终资格或请求许可,后续全部守卫继续生效。获准范围仅有局部响应时可在同一正常操作外使用 `withReaderLocalRequestsOnly` 减权,不能因预览预期为 patch 就容许实际 full。
3. 人工清单一次覆盖当前失败集合,逐篇说明具体原节点和来源。任务内新增付费已获持续授权,必要的新轮、清单或后续窗口由执行者准备并执行,不重复索取确认。保留新旧范围、来源与费用记录;用户明确改变目标或撤销授权时才按新指示调整,不把同一次收尾切成连续确认。
4. 进度更新读取实际阶段日志、请求记录和已保存检查点。`digest:status` 是完整冷核,不能当作秒级进度轮询;在发布、视觉登记/豁免等最终状态变化后按要求重新运行。入口日志记录各大阶段开始、结束及失败耗时,模型累计时间与本地等待分开报告。
5. 共性代码修正先以真实保存稿重现,再跑必要正反回归;稳定后完成一次完整工程验收。代码分批中文提交并及时推送;纯 CI 可以取消已被后续提交取代的执行,最终版本全部分片仍须通过。站点同一组模板/工作流改动在完整验证后合并一次推送,避免不可取消的旧全站部署排在最终版本前面。
6. 常规测试使用系统临时目录和独立夹具,不依赖会换日的 `data/current`;真实付费稿性能/恢复回放放在显式输入、SHA 绑定的运行证据中,与可移植单测区分。提速实验不改正式数据、不重置费用,也不把局部微基准比例宣称为全日更降幅。
### 已完成主文的专项恢复
Reader-only 纠错完成后,使用原父包与子包的实际签发上下文只读核验;此检查不能写包或发模型请求。旧父恢复先检查完整主分析,保存前阻断非 Reader 上游变化,错误则还原内存。不能为了恢复 Reader 删除或重签原摘要、评分和标签,详见[事实反馈恢复](docs/reader-explicit-retry.md#已完成主文的独立-reader-事实反馈)。
只修核心摘要时,使用 `reanalyzeSelected(ids, { coreFeedbackFiles })`:锁内先归档原反馈包,再独立进入核心单节范围。没有主文父反馈时,不能把核心包当成自己的父包;普通续跑仍恢复原单节范围,禁止主文模型。核心阶段逐字保护其余十二节,随后正常复核八维评分及必要 Reader,保留全部旧历史、次数和费用。成功稿已清理临时检查点时,先只读核验原完整父稿与真实来源,仅在核心恢复中保留原已完成上游;不把最终正文冒充各阶段的历史中间稿。
<a id="共享内容与prompt"></a>
## 共享内容与 Prompt
三条流程共用 `analysis-engine.js`、`deep-analyzer.js`、当前Prompt登记、Reader/评分/标签与来源守卫。正式分析13个一级标题用于机器解析;Reader使用 `beginner-researcher-v3` 与 `api-reader-source-bindings-v4`,要求12–18节、5000–18000中文字、4–10组机制术语解释。
标签从新版目录的386项九维词表选择。总目录保留完整;每篇只展示所选项及父级导航,不加入兄弟方向或空分面,祖先不写入直接标签。三种页面生成器使用同一多级展示函数,旧分类仅按真实归档原SHA重放。会议与历史发布先核验站点成对版本目录及本次快照,首次同步和旧记录兼容见[标签规则](docs/tag-display-policy.md#三条流程共用的目录与呈现)。
验收同时核对源Markdown保留的共享多级分类块和网页呈现:已核验的单篇页头分类只显示一次,正文去重须有唯一完整有序边界,汇总仍逐篇展示,旧无标记或异常标记不能用来手删Reader正文,详见[页面切换规则](docs/tag-display-policy.md#已发布页面切换到当前呈现)。
表格单元格对应原DOM或完整数字/单位引文,公式由结构化原TeX写入;作者机构逐项绑定来源,资源宣称与当前可达状态/类型一致。八维评分按文档类型判断,同一缺陷不重复扣分,总分代码重算封顶10。当前标签必须中文首选且含明确主任务/主方法,既定英文专名须有中文别名。
表格按真实来源保留条件、方法、指标与单位,原表只有3或4列时不凑5列。禁止从任意引文抽数字合成“来源句/量化值一”结果表,参考文献编号、年份、页码不能充作实验结果,少量数字重叠不能决定原表身份。缺真实表交正常 Reader 修复;已存稿经当前完整校验报告实际失败集合后统一恢复,保留合格上游和原费用。
这条语义检查同时适用于新响应和保存稿。日更、会议与历史共用保存稿资格门,旧正文、计划与阶段 SHA 一致也不能绕过;命中的 `reader_placeholder_result_table` 应作为当前失败保存,再集中正常恢复。来源身份重放不代替正文资格,也不应提前触发正文失败而中断全批检查。
日更内嵌SVG的绘图定义缺失或成环时,发布器只可按同篇四份封存来源、唯一图号与完整图注,从原PDF派生完整原页并明确标示页码。独立派生证明进入生成清单及审查、推送重验;保留原Reader和原模型像素身份,新像素仍须正常图片审查,不猜补SVG或裁图边界。旧清单仅按原来源与原像素身份只读兼容,不能用缺少新字段为新的替代资产签发凭证。
当前Prompt路径以 `scripts/lib/prompt-text-versions.js` 为准,读取第一个围栏代码块。旧提示词正文不再保存在工作树;`scripts/lib/git-prompt-evidence-index.json` 只登记原路径、Git blob OID 和整文件 SHA。旧记录通过受控读取器从 Git 取回原字节,复核整文件及首围栏模板 SHA,并保留原声明、来源、检查点和付费记录;缺失或不符就停止,不能用当前正文补签旧结果。新请求只读取当前登记的 18 份 Prompt。新共享代码变化进入传递依赖指纹,不靠手工漏项清单。
## 审查、发布与完成
日更发布顺序:
```bash
npm run blog:generate -- --date YYYY-MM-DD
npm run blog:review -- --date YYYY-MM-DD
npm run blog:push -- --date YYYY-MM-DD
```
- 审查只读最终文件,逐页通过记录按路径和内容SHA复用;当前批次仍执行程序与Hugo检查并生成新凭证。发布器变化后重新生成,但不强制重审字节未变的通过页。已完成的内容失败页仅在保存的旧协议与当前协议均为合法SHA且确实不同时,才进入正常整页重审;原失败、响应与费用保留,缺失或非法协议不能授权重审。单图审查不能根据局部输入推断整篇缺图,须核对图例、分组及计数与比例,并保留发现原文与图自身矛盾的能力。审查Git基线、远端身份、来源、页面清单或凭证不符必须阻断。
+ 审查只读最终文件,逐页通过记录按路径和内容SHA复用;当前批次仍执行程序与Hugo检查并生成新凭证。发布器变化后重新生成,但不强制重审字节未变的通过页。已完成的内容失败页仅在保存的旧协议与当前协议均为合法SHA且确实不同时,才进入正常整页重审;原失败、响应与费用保留,缺失或非法协议不能授权重审。单图审查不能根据局部输入推断整篇缺图,须核对图例、分组及计数与比例,并保留发现原文与图自身矛盾的能力。会议后续完整审查可含真实旧协议通过页;按 canonical 路径/页 SHA 缓存及 result 自哈希复用,不把通过项改签成当前协议,失败项仍绑定当前协议。审查Git基线、远端身份、来源、页面清单或凭证不符必须阻断。
已授权的独立人工审查只为文章记录真实语义及逐图结论;引用资料、词表和受控论文图以 `machineAssets` 沿用正常来源及已审引用页核验,完整并集仍必须等于生成清单。不得把二进制资产当 Markdown 或伪造其人工审查身份,具体声明和站内原图边界见[独立审查](manual/README.md)。
相邻原图共用解释/导读段时,单图审查输入须标明这段的双重归属,并保留完整原文及本图真实冲突的检查;独立上下文不变,不为审查误报改正确科学结论。
审查输入中的图片 K 是本次位置,论文图 N 是已核验封存 DOM 条目,Figure M 是作者印刷编号;三者可以不同,N 也可以不连续。共享说明只适用于当前签名与原来源映射均通过的文章,不能豁免实际配图或科学事实错误。新独立人工审查实际配置 `gpt-6.1-sol/high` 并如实登记 v4 身份;旧模型记录只读,详见[独立审查](manual/README.md)。
用户要求已发布完整日批只更新呈现时,生成命令显式增加 `--republish UUID`:`npm run blog:generate -- --date YYYY-MM-DD --republish UUID`,随后正常审查和推送。只允许当前正式完整日批;原发布及同来源/分析核验通过后,旧证据按UUID不可变备份,原通过缓存和检查点保留,不重跑付费分析。事务未完成时用同日期同UUID恢复,不能删旧凭证、混用all/选定子集/自定义数据,或冒用fresh提升;新提交仍需部署、逐页核验及当前发布视觉豁免,详见[重发布协议](docs/data-format.md#同来源同分析的日批重发布)。
普通内容拒稿先保存审计并继续本批其余页面,最后汇总阻断;服务、存储、字节变化或凭证损坏停止新派发并等待在途结果。修正后再正常审查,失败项不能写通过凭证;分析轮次参数不授权同次审查反复请求拒稿页。
推送仅提交凭证允许的精确差异,并核对远端main OID。宣告完成前,还须确认对应提交或保留本批已审字节的后续提交已成功build/deploy,逐页HTTP200、正式URL与标题一致,并保存核验记录。
视觉只在远端验证后规划。实际生成由内置image_gen完成,项目脚本只规划/登记/核验;调用前用 `visual:prepare` 输出的绝对参考路径,逐图目检后 `record --qa-attested true`。只有用户明确取消且记录仍有效的本次发布豁免,才省略视觉。
`--no-visuals` 只读核对发布和已签 Reader 身份、建立任务清单并登记当前发布豁免,不执行图片准备或生图。临时图片模式包含合法内联 SVG 的来源及渲染身份校验,但返回空参考图片列表,不取回像素或缓存。规划失败先按[恢复说明](docs/troubleshooting.md#11-视觉-pending-或-record-失败)恢复任务清单,再登记豁免,不重复发布字节未变的博客。
```bash
npm run digest:status -- --date YYYY-MM-DD
npm run verify
```
最后推送、图片登记或豁免后重读状态。状态报告不自动检查部署与网页;不能据其complete单独宣告上线。`verify` 执行固定Hugo、三流程和旧记录兼容全部JS/Python测试、语法和只读数据检查,只有CI/干净检出显式允许空数据。
整批Manual作者任务、旧拆分分析链和社交渠道发布已退役;单篇独立审查及旧记录来源/签名/正文核验留在 [兼容目录](manual/README.md)。