One user-space repair task per eligible HWE debug-diag / compile-deploy base ID: 320 admitted (C 218, C++ 97, build scripts 5), 1 skipped by the content filter. Each ships a public spec with a check-to-basis table, at least two defects with single-fix fixtures, a symptom-masking fixture and an alternative correct implementation. Claude re-checked all 320: structure, the HWE quality items and trace6 Docker calibration receipts against current digests (320/320 USABLE). Difficulty is unmeasured. Known follow-up: 212 tasks use 120 ad-hoc family names; the next batch maps them to the canonical list. The batch's 1,256-line progress log stays in its factory report and the 36-local branch batch15-hwe. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.2 KiB
dev-rx-window 制作规格
状态:CALIBRATED;等待 root 独立审阅;路线 C 原创,难度 UNMEASURED。来源 hwe/gi-cache-dma-rx-invalidate,原料仅提供 DMA 接收的 CPU 可见范围和资源可靠性方向,不代表真实现场事故回放。独立新写的接收工程没有复用其他新题业务骨架。
替身准入
设备内存、CPU cache 是 backend 内互相独立的字节视图。提交时窗口对应 cache 保持旧快照;设备完成只改 device memory。CPU 读取返回 cache 字节,只有失效的 cache line 才从 device memory 重新填入。完成、错误、取消均由输入事件驱动,无真实时间、网络、线程竞争、真实硬件或板卡依赖。窗口起点不对齐时仍需覆盖实际接收的首尾 cache line,完成后交还描述符的知识保留,因此通过软件替身预筛。不能据此宣称验证了 ARM cache 指令、屏障、电气、真实 DMA 或硬件性能。
纵向范围和验收
公开固定工程:C11 四槽接收器、带 CRC16 的长度报文、独立 cache/device port、命令驱动。仅提交 rx_window.c,冻结公开支持源码重新构建。独有有效 C/必要构建代码目标 >=500 行。公开合同先行;实现与校准后补确切行号、计数和回执。
独立缺陷:
- 非对齐窗口跨 cache line 时失效长度未包含起点在首行内的偏移,尾部字节仍旧,默认 demo 可复现。
only_fix_visibility仅修此缺陷。 - 设备错误完成时保留接收条目和 port 描述符,槽位无法复用。仅在默认成功 demo 以外、公开允许的设备错误事件下暴露。
only_fix_terminal仅修此缺陷。
行为判据与公开依据
以下行号均为 template/docs/contract.md,除显式列出的头文件 ABI。判据不比较失效/读取的调用次数;分行、合并、重复失效和任意分段读取均可。失败 result 和 unused 尾部不定义,不比较;stderr 允许诊断。
| 判据行为 | 精确公开依据 |
|---|---|
| C11 编译、固定支撑源码重建、只冻结 rx_window.c、允许 stderr | docs/contract.md:5;template/Makefile:1;rx_window.h:19 |
| create/destroy/outstanding 和 Z 重建 | docs/contract.md:7、37、39、43;rx_window.h:19 |
| slot、offset、capacity、tag 和不改变资源的无效/重复提交 | docs/contract.md:11、13;rx_window.h:22 |
| pending 返回、保留槽/描述符、不可提前读取;终态后二次 collect | docs/contract.md:17、21、29;rx_window.h:24 |
| DONE 使用 actual 而非 capacity、成功 tag/flags/size/有效 payload | docs/contract.md:19、21、33 |
| 不对齐窗口、line 首末覆盖、不得错误范围失效、每次完成重新失效 | docs/contract.md:25、27、29;port.h:6 |
| CRC、magic、version、flags、长度、尾部、tag 不匹配为格式错误 | docs/contract.md:19、33;wire.h:5 |
| actual=0 的格式错误、短帧、payload 0/1/96 边界和 uint32 极值 | docs/contract.md:19、21、33 |
| FAILED 不读报文且结束/交还、同槽立即复用 | docs/contract.md:17、39 |
| pending/terminal 取消、销毁、四槽交错不影响其他槽 | docs/contract.md:37、39、47;rx_window.h:25 |
| 每事件 outstanding/acquired/returned/aborted/completed/live/violations 对账 | docs/contract.md:27、29、37、39、45、47 |
| D 的 producer 返回状态;seed/命令格式和原始 O/A 输出结构 | docs/contract.md:25、43、47;template/demo.c:47 |
| 成功收取全部 actual 字节、格式失败可只读前缀;重复读取去重且不强制调用次数 | docs/contract.md:21、45;port.h:21 |
| 固定随机、多槽交错和连续复用组合 | docs/contract.md:47;以上各语义的组合,不增加其他要求 |
独立期望模型只用 Python 标准库 binascii.crc_hqx 和字节/状态计算,绝不调用 gold 计算期望。harness 是完整公开 demo.c,只打印 API 和 audit 的原始观测,不含私有断言。构建和候选只有 subprocess argv;首次 child 之前写齐支持源码/候选/输入,此后父 check 不接触候选可控树;finally 中以候选身份 subprocess 删除 scratch 并检查退出码,失败拒绝 PASS。verify.py 原样复制 rollout/bos_verify.py。
样例计划
gold PASS:链表管理活动请求;valid_table PASS:固定槽表、先以单字节读聚合再解包,且分行失效,与 gold 数据组织和收取方式不同。负例:template、noop、cheat(固化公开 demo)、cheat_read_grader(仅判据可读才工作)、only_fix_visibility、only_fix_terminal、mask_symptom(把正常完成伪装成格式错误)。每类正式本地和 Docker 各五次。真实 Agent 试采未做,不称 ADMITTED。
本题工程规模与预检
计数口径:template 中每个原创 C 文件与必要 Makefile 去空白、去 C 注释后的非空行,仅计一次;不计任何样例副本、Python 判据、文档、纯输入数据。rx_window.c 158、port.c 213、wire.c 77、demo.c 117、Makefile 11,共 576。公开头文件另 82 行,未用于达标计算。
预检:9 类均编译成功;gold 和 valid_table PASS;template/only_fix_terminal/mask_symptom 在事件5行为拒绝,noop 事件2资源拒绝,cheat 在首轮事件13拒绝;审阅补强后事件5仅因 CPU byte coverage 拒绝,only_fix_visibility 在事件10错误完成资源未交还而拒绝;cheat_read_grader 本地例外 PASS。独立模型 4 项 unittest PASS。每次判据 1461 事件、2922 原始观测行。
限制:真实 Agent/Pi/Qwen 未运行;仅校准无法给出 HARD 成功率。资源泄漏主要通过可观察的 port/槽位生命期对账;未声称进行真实硬件或分配器级别泄漏工具验证。
审阅补强:增加公开 cpu_distinct 去重实际读取覆盖观测,成功必须覆盖 actual;合法前缀早拒绝与重复读取均允许。valid_table 实现坏长度零读取、坏 header 前缀停止,且输出非零 unused 尾部和 stderr 诊断。固定 demo 的 cheat 在正确报文/资源之外跳过 CPU port,因此 event5 被 coverage 门拒绝。独立 port probe 观察到失效前旧字节、失效后设备新字节,重复读取覆盖仍只计一次。首轮回执保留;最终以新 digest 双门为准。
最终正式校准(当前摘要)
- task digest:
a7eb929c2e8ab7bc9109e71a66d9870ba839452a289c79e0a3962bc0d68e7b76。 - 本地:
runs/20261023-C-hwe-scale-15/gi-cache-dma-rx-invalidate/local/calibration-d0394978c90141d883d408b010b1fa99,45 次,cleanup confirmed;gold/valid_table 各 5 PASS,其他负例各 5 FAIL,只有 cheat_read_grader 本地 5 PASS(无隔离的许可例外),回执整体 FAIL 原样保留。 - Docker:
runs/20261023-C-hwe-scale-15/gi-cache-dma-rx-invalidate/docker/calibration-4467208af83d4b9088788ad98cb75760,45 次全部符合预期、总体 PASS、cleanup confirmed;image IDsha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1,gold/valid_table 各5 PASS,其余各5 FAIL。 - 首轮旧摘要回执完整保留于 report.json 的 earlier_attempts_preserved,不能用于当前候选身份。
- 本题独立模型4测试与 cache 替身探针均 PASS;全库 unittest 由 root 统一检查点运行。真实 Agent 试采和难度分池未做。