# concur-rtthread-dataqueue-wrap-reset 作者规格 - 路线:D,开源工程真实修复;状态:CALIBRATED,版本2平台固定镜像35/35预期匹配,等待主 Agent 独立审阅。 - family:state-machine-timing;语言:C;split_group:RT-Thread/rt-thread。 - source:oss/RT-Thread/rt-thread@44baf269f799。 - 上游:https://github.com/RT-Thread/rt-thread 。 - 冻结提交:8afb8b1e294883f50bc17a67cfa4321e61140681。 - 唯一修复提交:44baf269f79903d83359f23aab60ca17560e422c。 - 许可:Apache-2.0;37 个冻结完整文件逐文件核对 LICENSE 或 SPDX 头,所有版权声明保留。逐文件 SHA-256 和许可原件索引位于本题作者目录 `frozen-manifest.json`。 ## 修复与范围 这是一个上游真实的多函数修复:公开结构声明及初始化、push、pop、peak、reset、deinit 等接口都发生了实质变化,并新增 len。候选仅两个原始文件;上游 diff 为 header +6/-5、C +87/-30,总 128 行,小于 300。gold 的两个文件取修复提交完整 blob,未修改、未混入更旧修复,也没有额外补修 gold。 冻结初态的两个可独立观察失败是:普通 reset 后旧队首仍可读取;65534 次普通 push/pop 后再填满容量为 4 的队列,额外 push 本应返回超时却返回成功。所有计数通过公开 API 自然推进,未改写或观察 get/put/is_empty/is_full 等私有字段;原版一旦公开返回不符合抽象模型,就结束该失败会话,不继续消费错误数据。非二次幂容量、单项容量、长度查询、等待及释放重建属于同一合同的回归覆盖。 只有一项上游修复仍符合任务要求,因为它跨两个文件及多个实质函数;不将同一根因拆成伪独立提交,也不强凑第二个提交。 业务范围整体限定为单核任务上下文、容量 1..1024、合法低水位、NULL 事件回调、分配成功和稳定 payload。未测试 ISR、真实时序、SMP、硬件或任意大容量。上游结构使用 15 位槽位,因此大容量不在合同内;没有修补该范围外残留。回调通知细节不评分,不限制合法实现的字段、计数宽度或通知合并方式。 ## 冻结与补全 所有上游源码保持完整文件和原目录布局。未带 .git、历史测试、修复说明或外部依赖;未执行上游构建脚本。只在指定只读部分克隆中通过带禁用自动维护与 hooks 的 git show lazy-fetch 读取所需 blob。 | 文件 | 身份 | | --- | --- | | `LICENSE` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/completion.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/dataqueue.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/pipe.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/poll.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/ringblk_buf.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/ringbuffer.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/waitqueue.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/ipc/workqueue.h` | 上游冻结,Apache-2.0 | | `components/drivers/include/rtdevice.h` | 上游冻结,Apache-2.0 | | `components/drivers/src/dataqueue.c` | 上游冻结,Apache-2.0 | | `include/libc/libc_dirent.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_errno.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_fcntl.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_fdset.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_ioctl.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_limits.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_signal.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_stat.h` | 上游冻结,Apache-2.0 | | `include/libc/libc_stdio.h` | 上游冻结,Apache-2.0 | | `include/rtdbg.h` | 上游冻结,Apache-2.0 | | `include/rtdebug.h` | 上游冻结,Apache-2.0 | | `include/rtdef.h` | 上游冻结,Apache-2.0 | | `include/rthw.h` | 上游冻结,Apache-2.0 | | `include/rtlibc.h` | 上游冻结,Apache-2.0 | | `include/rtm.h` | 上游冻结,Apache-2.0 | | `include/rtservice.h` | 上游冻结,Apache-2.0 | | `include/rtthread.h` | 上游冻结,Apache-2.0 | | `src/clock.c` | 上游冻结,Apache-2.0 | | `src/idle.c` | 上游冻结,Apache-2.0 | | `src/ipc.c` | 上游冻结,Apache-2.0 | | `src/irq.c` | 上游冻结,Apache-2.0 | | `src/kservice.c` | 上游冻结,Apache-2.0 | | `src/object.c` | 上游冻结,Apache-2.0 | | `src/scheduler.c` | 上游冻结,Apache-2.0 | | `src/thread.c` | 上游冻结,Apache-2.0 | | `src/timer.c` | 上游冻结,Apache-2.0 | | `rtconfig.h` | 补全,主机编译配置及现有 libc 类型能力说明 | | `host/port.c` | 补全,通用 ucontext、IRQ 屏蔽值、堆和控制台 | | `host/smoke.c` | 补全,公开普通帧交接程序 | | `Makefile` | 补全,直接 gcc 构建普通路径 | | `README.md` | 补全,构建和交付范围 | | `docs/queue-contract.md` | 补全,整理公开 API 合同 | 移植层不实现队列、调度器、线程暂停恢复或定时器;真实原生 thread/scheduler/timer/clock/IRQ/object/IPC 实现参与构建。观察器通过 rt_thread_init/startup 与真实信号量 gate 调度阻塞任务,通过公开 rt_tick_increase 推进软件 tick。没有把调度替换成脚本或在桩里实现队列算法。 ## 规模与证据 冻结上游 37 个完整文件,加补全 6 个文件,template 共 43 个常规文件,均小于 1 MiB;候选 2 个,grader_files 3 个。以 gcc -E 行标记逐源文件去重统计启用的非空原行,包含括号行;只计 dataqueue、thread、timer、scheduler、clock、irq 和 IPC 信号量相关区,合计 1313 行。头文件、port、kservice、idle、object 和无关 IPC 均不计入。详细原行索引是作者目录 `enabled-original-lines.json`,其引用的原始 stdout/argv 回执保留在本题运行目录。 源码规模不是补全代码行数或预处理展开后的重复计数。实际运行链先核许可和规模,再完成 gold/不同 valid/template 预筛,之后才创建正式任务目录。 ## 判据检查项 ↔ 依据 以下依据路径均相对 template,文档条款在工作区公开。R02–R06 对应公开声明及原有成功/错误分支,R07 对应 reset 的公开重置语义和恢复错误,R08–R09 对应原有任务挂起/恢复/定时器行为,R10 是修复后新增的公开查询。题面要求模块满足全部文档条款。 | 检查项 | 公开依据 | 父进程判定 | | --- | --- | --- | | 任务上下文、合法容量和低水位、NULL 回调 | `docs/queue-contract.md:5` | 所有输入限制在该范围,使用真实 RT-Thread 任务 | | 初始化空队列,释放后重新初始化 | `docs/queue-contract.md:7` | init 返回值、空 peak/pop、重复 init/deinit | | 指针和任意长度、零长度保留 | `docs/queue-contract.md:9` | 抽象 deque 对比指针标识和长度 | | FIFO 顺序与长运行序列 | `docs/queue-contract.md:11` | 65534 轮普通操作、填满再排空及固定种子混合序列 | | 满/空立即超时且原项不变 | `docs/queue-contract.md:13` | 父模型确定容量及为空状态,逐操作判定 | | peak 返回队首而不消耗,空 peak 错误 | `docs/queue-contract.md:15` | 同一项重复 peak 后 pop,空队列错误码 | | reset 丢弃全部项并继续使用 | `docs/queue-contract.md:17` | reset 前后普通队列模型、重置后填满/排空 | | reset 结束等待者并取消旧超时 | `docs/queue-contract.md:17` | 真实阻塞 push/pop、正超时 reset 后推进 tick | | 等待者在可用数据/低水位后完成 | `docs/queue-contract.md:19` | 实际信号量 gate 与调度器,父进程检查返回观察 | | 正 timeout 到期返回,负 timeout 等待 | `docs/queue-contract.md:19` | 软件 tick 在期限前及期限时观测,非墙上时间 | | deinit 释放并结束等待者,可重建 | `docs/queue-contract.md:21` | 阻塞 push/pop 释放、随后重新初始化使用 | | len 返回当前占用且查询不改变队列 | `docs/queue-contract.md:23` | 父 deque 独立长度与后续 FIFO 对比 | | 结构与回调布局自由,无关事件顺序自由 | `docs/queue-contract.md:25` | 不访问队列字段;同一命令的独立事件按集合比较 | ## 判据与隔离 `verify.py` 原样复制平台 `rollout/bos_verify.py`,未修改。私有文件只有 `check.py`、非 Python 的 `observer.c` 和 `support.json`(公开非候选依赖的相同内容)。check 在可信父进程用 Python deque 独立计算期望;C 观察器只解析操作、调用公开队列/任务 API、打印返回值与输出参数,未嵌入断言或答案。payload 全部预先初始化为稳定存储,返回指针只做地址标识比较,不读取未知地址。 首个 compiler 启动前,check 将全部候选源码、移植层和观察器备齐;随后不读写、遍历或清理共享 scratch。所有编译与运行只在 UID65534 子进程中,期望不进入该进程;低 UID timeout 同 UID 看管观察器避免监督者缺 kill 能力。观察器 alarm 只是防挂死,不参与判分时间语义。原版缺 len 时弱符号只报告原始缺失标记,构建仍成功;reset/wrap 已分别证明原版失败,len 不是唯一判据。临时目录随容器 tmpfs 销毁,不由 check 的 TemporaryDirectory 隐式清理。 每个场景独立进程,父模型逐操作读回原始结果;失败即结束该场景,其他场景从新队列进程开始。无需实际机器负载、睡眠、网络、模型或硬件。 ## 校准样例 | 样例 | 期望 | 内容 | | --- | --- | --- | | gold | PASS | 上游修复两候选完整 blob | | valid_count | PASS | 明显不同的计数式实现:普通槽索引及独立占用计数,无 bitfield/empty/full 状态 | | template | FAIL | 原始冻结源码 | | noop | FAIL | push 无操作返回成功 | | cheat | FAIL | peak/pop 总读固定首槽,掩盖单帧普通 smoke | | symptom_reset | FAIL | 只将 reset 的索引清零,保留长期满队列错误 | | cheat_read_grader | FAIL | 仅用于隔离边界校准,无法读取私有判据时结束 | 正式必须固定 trace6 镜像无网隔离,每类 5 次,共 35 次。作者脚本只在本题内局部包装 core._process:真实 docker run 补 --rm、将同镜像身份换回固定 manifest 引用、写 actual argv 与 10/5 GiB 双盘检查并 fsync,再调用原 _process;core.calibrate 与 _calibration 本体保持原样。每次容器使用平台唯一精确名,由原平台逐对象确认清理,不做前缀清理或 prune。 ## 当前限制 没有真实 Agent 试采、模型难度、训练或硬件结论。题包完成和校准通过只支持等待主 Agent 独立审阅及后续准入。早期预筛中主机配置的 libc 类型冲突和期望错误码笔误均作为排除事实保留;修正后 gold/valid 已重新通过。首轮平台35次 FAIL 是缺少公开非候选依赖的装包错误,旧回执排除;版本2引入 support.json 在首compiler前重建依赖,并取消错误输出参数值约束。正式回执以作者 report.json 的当前 task/verifier/image 身份为准。 正式校准:`/home/ming01.wang/embedded-rollout/.tmp/wt-batch28/runs/20261103-D-oss-fix-28/rtthread-dataqueue-wrap-reset/calibration-610d37ecefc7467bba39d2105297342a/receipt.json`,PASS,35次,cleanup confirmed;当前身份由core._calibration核验。公开smoke记录:`runs/20261103-D-oss-fix-28/rtthread-dataqueue-wrap-reset/b28-rt-dq-smoke-20261105000426961701-result.json`。