From the 101 lk/man/pth code-gen sources: 63 tasks (C11 36, C++17 27, 11 canonical families), 38 skipped for scope or duplication. Each task has at least one independent contract-edge defect, boundary types rotate, and public docs state trap clauses as plain contract prose. Claude reviewed 63/63 USABLE against current digests. Difficulty is unmeasured. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
io-vector-progress 任务规格
1. 身份与来源
| 字段 | 内容 |
|---|---|
| task-id / version | io-vector-progress / 1 |
| 作者 / 独立评审 | Codex 单题作者 / 待 root 只读审阅 |
| 审核状态 | DRAFT;校准后记 CALIBRATED / UNMEASURED |
| 原项目与冻结材料 | 本批 factory/20261027-C-hwe-hard-22/hwe/arm-linux/code-gen/lk-fops-writev/ |
| 来源路线 / ID | C,原创软件工程;hwe/lk-fops-writev |
| 来源与授权 | BRIEF 已完成 public、未占用与非保留筛选;只阅读 metadata、两份 prompt 与 reference,不读 checks、不执行来源脚本 |
| 隐私 | 无真实会话、个人数据、凭据或网络端点 |
| 替身测试 | 多 iovec 接受前缀、跨段位置与累计接收量在普通进程回调下完整保留,结论 software |
| split / 来源组 / 根因族 | hwe/lk-fops-writev / HWE基础ID / 跨段前缀推进与部分完成结算 |
| 与已有任务的关系 | 原创多 iovec 窗口协议,保留原段界、最大窗口宽度、quota和可复用游标;不是单buffer write-loop重命名 |
| 验证 / 未验证 | C11用户态精确字节、调用与累计行为 / 内核模块、真实writev系统调用、电气硬件、并发和真实时序 |
原素材要求内核 write_iter 与累计字节。这里只取多段串接与实际接受量方向;源码、接口、故障、测试与正负例全部重新编写,不宣称复现真实事故或复制原内核代码。
2. 初态与环境
完整工程为 template 下的 include/vector.h、src/{main,console,device,job,cursor,ledger,submit}.c、Makefile、replay.txt、README.md、docs/contract.md;无外部依赖。模板中原创C/头文件共543个非空、非注释行,统计每个源文件一次,不计fixture重复、文档、脚本、空白、注释或填充数据。职责包括输入解码、对象初始化、分段窗口、接受推进、请求结算、受控接收器和观察输出。
两处独立缺陷:
src/cursor.c跨越段尾后丢弃本次仍需推进的剩余字节;done 正常增加但 index/offset 落后,后续窗口重发后缀。公开 replay 的4字节接受跨过3字节段即可复现。仅修此处的 only_fix_cursor 保留结算错误。src/ledger.c以终止错误优先结算,丢弃同次已接受字节,并返回负错误而非正的部分完成量。须出现“先正接受,后错误”才触发;公开 smoke 不含错误,文档合法域覆盖该场景。only_fix_settlement 仅修本处,仍被跨段用例拒绝。
两者分别违反独立状态不变量;修复一处不能修复另一处,原始观察同时覆盖后端实际字节、游标、返回值、累计book,不能互相掩盖。
指定精确边界类型为 短读短写与部分完成的处理:包括短返回停在段内/恰好段尾/跨过多个段,空段前后,额度等于/小于/大于剩余量,先短成功再零/错误/过量返回,错误后重用。此题仅有发送方向,不声称测试read路径。
固定镜像为 ccr-29eug8s3-pub.cnc.bj.baidubce.com/algo/bench-runtime@sha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1;实际image_id以Docker原始回执为准。普通Linux、gcc C11、Python3标准库,离线构建。grade 512MiB/1CPU、总期限120秒,单编译35秒、单程序25秒。Agent采样未运行。
公开复现 make smoke,正常EOF退出0。根因分布在cursor/ledger,报告症状与格式代码位于console/device,跨文件调用由submit与job衔接。
3. 公开题面与接口
prompt.md只写接收重复后缀和计数异常、公开复现命令与完整交付文件,不点名根因函数或修复方法。题面明确要求符合docs文档全部条款。全部类型、API参数、返回、副作用、对象生命周期、合法/非法边界、文本输入输出和交付范围在template中公开。README:9声明唯一7个candidate_files,新增文件不会被收集;固定的main与构建上下文由验收端提供。
4. 判据检查项 ↔ 依据与合法解
下列行号均相对 template;表的每一行对应一个完整公开条款。隐藏组合不隐藏正确行为。Python答案来自字节前缀与计数模型,不运行gold取答案。
| 检查项 | 精确公开依据 | 输入与观察方法 |
|---|---|---|
| 段数、长度、总量与窗口端点 | docs/contract.md:5;include/vector.h:9 | 0/1/12段、0/1/256长、总3072、width1..4,二进制包含全部256值 |
| 描述符复制、载荷保持与重新open | docs/contract.md:6 | harness在open后清除原描述符,再实际发送;复用book/device |
| NULL、非法count/长度/open原子性 | docs/contract.md:7 | NULL job/array/base、13段、257字节、空数组,旧状态和后续字节不变 |
| 规范游标、空与全空清单 | docs/contract.md:8 | 前中后空段、完成与重新open,逐步观察index/offset/done/total |
| book重置及独立生命周期 | docs/contract.md:9 | NULL reset、独立reset、跨open累计与多次finish |
| submit非法参数无副作用、NULL context | docs/contract.md:13 | NULL job/book/sender、未open、quota0/3073、width0/5、NULL context回调 |
| quota与空/已完成请求 | docs/contract.md:14 | 1/2/3/7/31/256/3072额度与重复完成submit |
| 保留原段界的确定性窗口 | docs/contract.md:15 | 固定只记录CALL的回调输出各段长度和实际字节,Python按绝对前缀切片独算 |
| 短接受、跨段与过量返回EPROTO | docs/contract.md:16 | 返回1/2/3/4/17及3073,比较下一个窗口、实际接收字节与游标 |
| EINTR重试、零暂停、错误和恢复 | docs/contract.md:17 | 有限连续中断、三类错误、零与后续submit组合 |
| 精确调用与累计计数 | docs/contract.md:18 | 每一步完整snapshot、空请求、错误前接受、完成仅一次 |
| 部分成功返回优先与last_error | docs/contract.md:19 | 成功后错误/零、无进度错误、额度耗尽、错误后新请求 |
| cursor低层接口独立使用 | docs/contract.md:20 | 直接reset/window/advance,budget0与amount0、跨段推进与不变性 |
| book低层结算独立使用 | docs/contract.md:21 | 直接finish接受0/2/7/13、终止错误、暂停、新完成;不是只通过submit测 |
| device reset及NULL观察流 | docs/contract.md:25 | 固定原始harness直接reset、发送并打印device字段,NULL流无CALL |
| device script替换、NULL与非法原子性 | docs/contract.md:26 | 0/64/65项、NULL非空/空、非法负数和3074、脚本消费及用尽默认 |
| device真实前缀接受及拒绝错误/过量 | docs/contract.md:27 | Console重放与独立device原始记录,比较真实缓存字节与调用次数 |
| hex与CALL观察格式 | docs/contract.md:28 | 空hex、00/ff/05二进制、调用段界;按数值和bytes语义解析,允许空白 |
| 完整STATE字段与历史接收缓存 | docs/contract.md:29 | 每一步16数值字段和实际bytes,追加而非仅打印本次数据 |
| ASCII文本合法域和解析拒绝 | docs/contract.md:33 | 空stdin、空行、未知/缺失/多余/溢出/非法hex、VT/FF数词/尾部junk/size负号拒绝、8191字节含长前导0/+、大小写hex、无LF尾行 |
| R/O/P/S/Q及解析失败不变性 | docs/contract.md:34 | 公开replay、随机重放、非法open后继续用旧载荷、非法P不消费旧脚本 |
| 输出顺序、step与退出码 | docs/contract.md:35;README.md:5 | CALL后RESULT/STATE、R保持step;正常EOF与/dev/null写端输入错误、/dev/full输出错误原始IOSTATUS |
| 完整ABI和离线构建/交付 | docs/contract.md:39;README.md:9 | 固定main及不同C11调用者分别编译,7文件均收集;构建失败拒绝 |
原始harness.c只接收输入、调用公开API、记录调用参数/返回/状态;不含断言、期望结果或gold。check.py先生成两个固定seed的用例、期望和完整输入,再读取候选与私有固定资料,在平台cwd下mkdtemp写完全部文件。首个子进程之后不再读写候选可写目录。两个程序均以argv编译执行,捕获bytes;stdout按公开ASCII协议单独解析,stderr仅replace解码诊断,不用诊断字节判失败。
固定随机矩阵有90组API清单与30组文本重放,再加逐项边界和错误前缀;精确实际用例/观察总数由自检实录记录。低层对象与device、I/O错误单独调用,空stdin及8191边界另起进程。JSON仅用于可信上下文配置,不用bool替代整数进行结果比较。
合法替代解valid_absolute以绝对done坐标与前缀区间扫描定位和构窗,submit拆成request状态对象与单步转换;gold使用index/offset递增推进与单函数循环。判据接受两种明显不同结构,不以源码或某补丁判断。无硬编码种子答案;cheat被无后端调用与真实缓存检查拒绝。cheat_read_grader只有读到私有判据时才解题,正式隔离必须拒绝。
verify.py逐字复制rollout/bos_verify.py;候选及编译器仅在子进程运行,Docker评分由平台以UID65534隔离并先探测/ grader不可读。private资产是check.py、context.json和harness.c,gold不在工作区。可信本地不能证明正式隔离。
5. 样例与校准
| 样例 | 预期 | 作用 |
|---|---|---|
| gold | PASS | 完整实现所有合同 |
| template | FAIL | 两处独立原始错误 |
| noop | FAIL | submit仅返回0、无行为 |
| cheat | FAIL | 不调用后端,按请求额度凭空计接受 |
| cheat_read_grader | Docker FAIL | 判据读取隔离对照;可信本地可读PASS属于已公开许可例外 |
| only_fix_cursor | FAIL | 跨段修复但部分完成结算仍错 |
| only_fix_settlement | FAIL | 结算修复但跨段推进仍错 |
| mask_symptom_skip | FAIL | 把提供量当接受量推进,表面不重复但跳过未接收字节 |
| mask_symptom_stats | FAIL | 对错误请求固定补1估计接受量,真实多种部分量不匹配 |
| valid_absolute | PASS | 绝对字节坐标/区间扫描和单步请求状态转换 |
双门均使用现成 python3 -m rollout calibrate,每类5次、每门50次,不改重复次数。门1加--trusted-local;门2加上述固定--image。唯一输出位于runs/20261027-C-hwe-hard-22/lk-fops-writev。原件、最终task_digest、每类真实5次与清理以report.json为索引;若本地reader可读导致总FAIL,保留原件并单列例外,不篡改。
6. 真实试采与证据
未运行任何模型、Qwen、Pi或真实Agent。无controller/原生轨迹/broker/归档/Salty交付;难度为UNMEASURED,不能宣称HARD。只有可信样例与Docker隔离行为校准。运行记录和回执只留在本题唯一runs目录;不覆盖历史,不改平台和其他题,不碰凭据或冷盘。
7. 评审与准入
单题作者完成合同、源码、两处独立only_fix、两个mask、替代解与分离Oracle自检。最终双门后报DRAFT_READY,root独审并确认首组提交完成后才允许一次性发布tasks/io-vector-progress。发布屏障等待不是授权。当前不运行全库unittest,由root统一回归;不提交git。最终限制、清理与真实校准写report.json,review由root独立填写;修改任何digest覆盖资产均重过双门。