# dev-stream-map 作者规格 ## 身份、来源与范围 - task_id: dev-stream-map;version: 1;family: device-memory;language: C++17。 - 路线 C 原创,source: hwe/gi-cache-dma-streaming-map;来源组、split 分组键均为 gi-cache-dma-streaming-map。素材仅给流式映射每次交接的可靠性方向;本工程、初态、判据、样例均新写,不称真实事故。 - root 已完成来源预筛、基础/变体 heldout 与未用来源核验、本地/冷盘逐文件 SHA 核验。作者只读本题六个来源文件,未执行来源脚本,不从其他新题取代码。 - 状态 CALIBRATED;难度 UNMEASURED。双门后至多标 CALIBRATED,不含真实 Agent 试采或硬件验证。 ## 软件替身准入与工程 确定性 Port 具有分离的 CPU/设备字节视图。固定方向决定两个交接的数据传播,设备操作只作用于设备视图,CPU 操作只作用于 CPU 视图。复用映射不会自动复制数据。端口所有权与原始视图共同观察每个 handoff、每次复用及最终释放,因此保留流式 DMA 的方向与每次生命周期知识点,不靠 printf 固定字符串、函数命名或源码模式判分。无真板、真实缓存指令、电气状态、真实时序、线程竞争、网络或性能依赖。 唯一提交文件 src/session.cpp。公开支撑包括稳定接口 include/stream.hpp、软件端口 src/port.cpp、只输出观测的 src/main.cpp、Makefile、合同和演示输入;它们逐字节冻结于私有 support.json。正式评分仅接收 candidate_files,在干净目录重新编译,绝不拿工作区构建产物作证据。替代实现可自由选择内部算法和数据结构。 模板独有有效代码按“非空且非注释行”的通常逻辑行计数,包含正常语法、声明和构建规则,不含样例复制倍数、纯数据、公开文档、判据或作者生成器:src/session.cpp 198、src/port.cpp 189、src/main.cpp 130、include/stream.hpp 118、Makefile 14,共 649 行。各模块分别提供服务生命周期、独立双视图/设备运算、请求解析/原始观测和公共接口;没有为行数加入填充逻辑。 ## 缺陷与独立性 1. D1 复用交接遗漏:初态仅 completed==0 时将映射交给设备。第一轮 TX 可成功,第二轮 patch 后 B 返回 PORT,port.errors 增加且设备视图仍旧。默认 --demo 暴露此问题。only_fix_reuse 修复此条件但保留 D2,在首个 RX 完成时失败。 2. D2 RX 完成回收遗漏:初态在 FromDevice 方向跳过 CPU 回收,随后读取端口失败,设备视图已更新但 CPU 仍旧且所有权不归 CPU。默认 --demo 只有 TX,不触发 D2;公开 --receive-demo 和 examples/mixed.txt 暴露。only_fix_receive 修复回收但保留 D1,在默认第二次提交即失败。 两缺陷分别改变 begin 与 finish,分别有独立触发和只修一处的可构建反例。不是同一检查的参数变体。 ## 判据检查项与公开依据 以下路径均相对 template/。证据表 20 行,逐条支持必需观察;隐藏的只是输入组合。所有 successful values、metadata 与 byte view 均只比较公开有效范围,未定义尾部不检查,stderr 不作为失败条件。 | # | 判据行为 | 精确公开依据 | | --- | --- | --- | | 1 | C++17 重建、单一候选、固定支撑、允许 stderr | docs/stream-contract.md:7;Makefile:1 | | 2 | 四槽、96字节、整数域、新进程隔离与多槽并行 pending | docs/stream-contract.md:11;include/stream.hpp:11 | | 3 | TX/RX/Both 方向、map 两视图初值、CPU idle 初态 | docs/stream-contract.md:13 | | 4 | 每槽 generation/maps 与跨 remap 累计计数、全局 ticket | docs/stream-contract.md:13 | | 5 | 字节生成公式及 32 位 FNV-1a | docs/stream-contract.md:15 | | 6 | 每轮 begin/finish 所有权对、复用不重映射 | docs/stream-contract.md:17 | | 7 | 两次 handoff 均使用原方向、按方向整区传播、计数/传播量 | docs/stream-contract.md:19 | | 8 | TX只读、RX覆盖、Both先读再异或及范围外不被设备改写 | docs/stream-contract.md:21 | | 9 | 六字段收据、前后摘要、禁用摘要为零、ticket仅成功消耗 | docs/stream-contract.md:21 | | 10 | 状态码、错误无副作用、invalid-before-port 与 errors==0 | docs/stream-contract.md:25 | | 11 | M 校验优先级、成功 generation values | docs/stream-contract.md:27 | | 12 | W 绝对偏移、零长/终点、所有方向可写及优先级 | docs/stream-contract.md:29 | | 13 | R 字节序列、边界、无副作用和优先级 | docs/stream-contract.md:31 | | 14 | B 正长度、BUSY 优先、pending 限制及返回收据 | docs/stream-contract.md:33 | | 15 | F 精确 ticket、跨代/重复/错误拒绝、保留 pending、返回CPU摘要与完成数 | docs/stream-contract.md:35 | | 16 | U 仅 idle、计数保留、服务元数据归 absent | docs/stream-contract.md:37 | | 17 | X 先完成再释放、返回数量、幂等空reset、ticket不重置 | docs/stream-contract.md:39 | | 18 | manager/port字段布局、owner、absent清空与累计计数 | docs/stream-contract.md:43 | | 19 | 只观察有效 length 字节、十六进制编码、unused尾部自由 | docs/stream-contract.md:43 | | 20 | 原始端口与服务分别观测,不能用正确回复掩盖错误生命周期 | docs/stream-contract.md:45 | 判据 Python Model 独立从公开公式与状态机计算 917 条请求的期望,不调用 gold。包含默认演示、三方向×三长度×四轮复用、错票/旧代票/重复完成、零长度边界、部分范围、四槽交错、各状态错误优先级、反复映射释放、固定随机种子 0x5DA2026 的 420 个混合请求和最终 drain。公开 C++ driver 只解析输入、调用服务、打印返回与原始 Port 观测,没有隐藏断言或期望。 ## 样例机制 | fixture | 预期 | 行为机制 | | --- | --- | --- | | gold | PASS | 固定槽数组保存完整映射状态及收据,完整遵循每轮方向交接 | | template | FAIL | 两处独立缺陷原样初态 | | noop | FAIL | B 直接成功但不执行工作;原始视图/收据立即揭示遗漏 | | cheat | FAIL | 将 CPU patch seed 硬编码为默认演示的55;非演示数据捕获 | | cheat_read_grader | FAIL | 仅能读父进程命令行中的私有check或/grader/check.py时执行gold,否则B不工作;本地无隔离可意外PASS | | only_fix_reuse | FAIL | 只修 D1,RX方向完成仍失败 | | only_fix_receive | FAIL | 只修 D2,第二轮映射复用仍失败 | | mask_symptom | FAIL | 初态PORT错误改报OK;原始端口字节、计数、owner与收据照旧不符 | | valid_table | PASS | 两张std::map分别管理映射ledger与活动收据,缺席即absent/pending,统一reap消费收据;reset逐表排空,区别于gold四槽数组+布尔状态;允许stderr诊断 | 所有fixture只有 src/session.cpp。正式校准检查每个样例均完成真实编译,负例不能以编译/链接失败充数。 ## 执行边界与自审 verify.py 与 rollout/bos_verify.py 逐字节相同。grader_files 仅 check.py 与 support.json,无 isolation-blocked.txt。候选及编译器只能通过 subprocess argv 启动。所有输入、公开支撑与候选源码在第一个子进程前写完;之后父check只在内存中读取子进程输出,不触及候选可控目录。scratch根由包装器赋UID65534,不chmod该根;仅预先chmod自己新建子目录。最后用候选身份的/bin/rm清理,检查真实返回码,任何失败不输出PASS。没有 root 身份执行候选、导入候选、对共享目录执行隐式TemporaryDirectory清理或隐藏断言进入候选进程。 只读自审确认题面为现象报告,未点明根因;全部项目约定公开,判据与题面同口径;同源固定字符串/源码名检测未沿用。固定镜像内 gcc/g++/make 实际存在,未安装依赖。公开 make 与模板默认演示已实跑,模板在第二轮 B 暴露实际PORT错误。gold 正式包装器单次预检 PASS。本批全库unittest由root统一安排,本作者未执行。 ## 校准事实与限制 正式本地回执:runs/20261023-C-hwe-scale-15/gi-cache-dma-streaming-map/local/calibration-16eb7296016b48f9b29d20f139d32c93/receipt.json。45次中仅cheat_read_grader无隔离而5次PASS为合同允许例外,整体真实FAIL原样保留;gold/valid各5PASS,其余各5FAIL;cleanup confirmed。 正式Docker回执:runs/20261023-C-hwe-scale-15/gi-cache-dma-streaming-map/docker/calibration-0a01010c415b4140b495c5ce14bd6c82/receipt.json。9类各5次,gold/valid各5PASS,全部7类负例各5FAIL,整体PASS;每次进程exit、cleanup confirmed。全部负例均因行为差异拒绝,无编译/链接失败。读取判据样例在Docker第1条B即被拒绝。core._calibration已按当前task/verifier/image与全部候选摘要核验通过。 当前task_digest:37d6becec76cfcc6c44f79527aa581a9f083c4fc92cbac321ae68592cb3cb6d6;image_id:sha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1。逐个inspect本题45个container_requested名称均已不存在;未建网络。当前/home约87GiB可用,本题runs约2.3MiB,无disk_low/attempt_size事件。 无硬件验证、无Qwen/Pi、无真实Agent轨迹,难度仍UNMEASURED;root独立评审与集中全库unittest尚未进行。作者完成自审后停止供root审阅。 族名规范化:device-memory → device-io(2026-10-27)