amos 2f32624d3b Batch 18 (20261026-C-hwe-codegen-18): add 100 calibrated HWE code-gen tasks; pause production for rollout
100 tasks from the HWE arm-linux code-gen pool (outside the lk/man/pth
range given to batch 22), each with at least one independent
contract-edge defect and plain public docs. Claude reviewed 100/100
USABLE against current digests; no ID or source overlap with main or
batch 22. Difficulty is unmeasured.

progress.md records the wrap-up: all Codex sessions and Qwen schedulers
stopped for the user's rollout, Qwen results so far (57 HARD of 373),
and what is left on each batch branch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 17:52:13 +08:00

5.5 KiB
Raw Permalink Blame History

AQ 1 软件合同

本合同是完整验收范围,所有实现必须满足全部条款。aq::detail、private成员不是客户端接口;公开API是 quant.hpp 的 Bank public部分及其中使用的类型。实现为C++17离线普通用户态库,不向stdout或stderr写任何字节;输出由调用方负责。

数值和配置

R01 max_channels=8;通道索引0..7。Status整数固定:Ok=0,Index=1,Scale=2,Zero=3,Range=4,Value=5,Layout=6,Shape=7,Buffer=8,NotReady=9。 R02 Profile为{num,den,zero,low,high},scale=num/den,num与den各1..1000000;zero=-128..127;-128<=low<=zero<=high<=127。传入scale先按各原始分量检验,再约成最简正分数保存。 R03 Rational为有符号{num,den}。quantize输入num=-1000000000..1000000000、den=1..1000000,不要求已约分;反量化/转换输入code=-128..127,即使超出profile的low..high仍合法。反量化结果为最简分数、正分母,零为0/1。 R04 量化先求精确有符号分数 x/scale,按最近整数舍入、恰好半值向远离零方向,再加zero,最后夹到[low,high]。顺序不得交换,不允许浮点近似。只有夹前整数严格小于low或大于high才记对应clip;等于端点不记clip。 R05 反量化恰为(code-zero)*scale。convert(source,destination,code,out)将源反量化后的精确分数直接按目标规则量化,只记converted和可能的clip,不记quantized/dequantized;源目标相同仍执行规则,收窄区间会夹取。

Bank生命周期与直接查询

R06 Bank()初始全部未配置、count=0、revision=0、Counters五字段全0。configure(channel,profile)先Index,再Scale,再Zero,再Range;失败无任何改动。成功仅修改该通道,规范化后的配置改变(含从未配置变就绪)使revision加1;规范化后相同的重复配置为Ok且revision不变。 R07 replace(count,profiles)先检查count=1..8(Shape),再非空指针(Buffer),再按通道升序验证每个Profile(各自Scale/Zero/Range顺序)。成功整体替换0..count-1并清除更高通道;任一失败原子不变。整体规范化状态改变只加1次revision,重复相同整体状态不加。 R08 erase(channel)非法索引Index;就绪通道清除并revision加1;重复清除返回Ok且不加。reset()清除全部配置,非空时revision只加1,空时不加。configure/replace/erase/reset均不清计数。 R09 get(channel,Profile&out)先Index再NotReady,失败保留out所有字段,成功返回规范化配置;ready(channel)直接返回就绪布尔,非法索引为false;count()返回当前就绪通道数;revision()直接返回上述修订号。查询均无副作用。 R10 counters()直接返回{quantized,dequantized,converted,clipped_low,clipped_high}累计成功元素数;clear_counters()将其全置0、可重复调用,不影响配置、revision。任何失败操作不改Counters;成功空batch也不改。

标量与批量

R11 quantize(channel,Rational,int&out)、dequantize(channel,int,Rational&out)的错误优先级均为Index、NotReady、Value;成功按R03..R05计算并分别累计quantized或dequantized。失败保留out,配置与revision总是不变。 R12 convert(source,destination,int,int&out)先源Index、目标Index、源NotReady、目标NotReady、Value;失败保留out,配置与revision总是不变。成功按R05累计。 R13 批量API签名分别为quantize_many(Layout,channels,frames,block,const Rational*input,count,int*output,capacity)与dequantize_many(Layout,channels,frames,block,const int*input,count,Rational*output,capacity);所有尺寸类型为size_t,返回Status。仅布局0 Interleaved、1 Planar、2 Blocked合法,否则Layout。 R14 批量形状要求channels=1..8、frames=0..32,count=channels*frames。Blocked要求block=1..16;其他布局block必须1。任一不满足为Shape。capacity为output可容纳元素数,不足count为Buffer;count>0时input/output任一空指针也为Buffer。 R15 批量错误顺序为Layout、Shape、Buffer,再按通道升序NotReady,再按物理输入顺序Value。count=0且前三级合法时直接Ok,不要求任何就绪配置,允许空指针。非空时通道0..channels-1必须全就绪。必须先完整检验再修改输出和Counters,失败保留整个输出缓冲区及全部状态;成功只写count个元素,capacity多出的区间不变。 R16 Interleaved物理顺序是每帧内通道升序;Planar是每通道内帧升序;Blocked按连续block帧分组,每组按通道升序、再按帧升序存放;尾组只含剩余帧,无padding。三布局量化/反量化等于各物理元素使用其通道的标量结果,累计成功元素和clip;batch不改配置/revision。 R17 input/output指向各自足量、有效且互不重叠的数组;单个batch最多256元素。调用方可给capacity大于count的缓冲区,库不能改动count外任何元素。不要求支持重叠内存或无效地址。

构建与公开复现

R18 唯一交付文件为quant.hpp、numeric.cpp、bank.cpp、tensor.cpp;可修改其内部数据结构和算法,必须保留公开签名/类型/枚举值。新增文件不被评分收集。公开构建命令:c++ -std=c++17 -O2 numeric.cpp bank.cpp tensor.cpp demo.cpp -o demo,运行./demo,正常应退出0、stderr为空。 R19 demo配置两个通道Profile{1,1,0,-128,127}和Profile{2,1,0,-128,127},回放6个2/1采样;正确完整stdout为0 2 2 1 1 2 1\n。这是回放清单校验样例,其余合法场景仍须符合全部条款。