# 任务规格:dev-input-frame-commit ## 1. 身份与来源 - task-id/version:dev-input-frame-commit / 1;family=peripheral-hal;language=C++17。 - 作者:lk-input-device 子 Agent;业务/独立评审:待 root;状态 DRAFT。 - 路线 C,原创用户态修复工程。来源 hwe/lk-input-device,原料为本批 hwe/arm-linux/code-gen/lk-input-device 的 metadata.yaml、prompt.md、prompt-explicit.md、reference/lk_input_device.c。未读 checks/behavior.py、未执行来源脚本。 - 来源公开 metadata visibility=public;用户授权本项目制题。无个人内容。split/source-group=hwe/lk-input-device。 - 原始目标为内核 input 注册/事件/撤销,重写为普通进程能力表、事件帧与代际账本。没有内核/板卡/权限/时钟依赖。 - 不同于 evdev 分片类:无 read、字节流、struct input_event 或分片边界;根因为通知分类、集合替换、无变化提交。 - 验证用户态状态转移和账本;不验证硬件、电气、内核实际 input 设备。难度 UNMEASURED,不能宣称 HARD。 ## 2. 初态与环境 公开工程 template 含五个候选文件、固定 input_console.cpp、Makefile、README、两份 docs、smoke.txt。私有 check.py 与 cases.json 仅评分侧;verify.py 原样复制 rollout/bos_verify.py。 C++17 标准库,g++,无下载与外部依赖;正式固定 trace6 manifest sha256:1519f8daa403998e5401eeb70b973e8aac8346e25a937033bc502dc5de1641a1。每次 compile 25 秒、程序 10 秒,整次 grade 120 秒;Docker 1CPU/512MiB。镜像 ID 与摘要由回执保存。 初态三个独立缺陷:reports.cpp 丢失 value=2 重复通知(smoke 可见);registry.cpp 对空能力替换保留旧集合;frames.cpp 对空 pending sync 创建空帧。后两项仅公开合法但 smoke 未覆盖场景触发,分别属于指定“空集合与无变化操作的精确语义”。无变化重复 detach/release、同值 report 也按公开合同覆盖。 ## 3. 公开题面与接口 prompt.md 为现场报告式原创场景,未指明根因文件/函数/类别;要求行为符合 docs 全部条款。构建 make,运行 ./input-console < smoke.txt,EOF exit0。最终交付 input.hpp、state.cpp、registry.cpp、reports.cpp、frames.cpp;其他材料固定。完整参数、错误优先级、顺序、无变化操作、副作用、观测格式见公开 docs。 ## 4. 判据检查项 ↔ 依据与合法解 | 判据检查项 | 公开依据(template/ 相对路径:行) | 输入/场景与观察 | 方法/范围/超时 | | --- | --- | --- | --- | | 初态/枚举/槽数/reset | docs/contract.md:3-4;input.hpp:9-13 | 构造、Z、重用后 Z 全清零 | Python 状态机,私有输入,10s | | 分配/名称/代际 | docs/contract.md:5 | 四槽、非法槽、空/32/33字节/非ASCII名称、重复分配 | 状态快照与直接 API,10s | | 能力合法域 | docs/contract.md:6 | key0/31/32,axis0/7/8,端点、反区间、错误类型/边界 | 独立 cap_valid,10s | | 能力排序/重复/原子性 | docs/contract.md:6 | 无序表、末尾非法/重复、失败保留输出 | N、C 及直接 helper 原始观察,10s | | normalize 空输入 | docs/contract.md:6 | N 0 清空原 output | Python 独立排序,10s | | normalize 别名 | docs/contract.md:6 | 同 vector 合法排序与重复失败 | 独立 API probe,10s | | 配置替换/空集合 | docs/contract.md:7 | 非空到空、同集合重配、失败不改变集合/计数 | 每步完整快照,10s | | 注册/注入失败/无能力 | docs/contract.md:8 | fail1后fail0、错误fail、空能力注册 | 独立初值与计数,10s | | 普通变化/相同值 | docs/contract.md:9 | 按键/轴变化与同值、单点轴上下界 | Python 事件分类,10s | | 重复通知 | docs/contract.md:9 | 按下/松开状态下连续value2 | 事件有序副本及不变values,10s | | pending容量/拒绝原子性 | docs/contract.md:9 | 64条后同值、变化、重复;sync后重用 | 每步状态/rc/计数,10s | | 合法帧/跨槽顺序 | docs/contract.md:10 | 多槽交错提交、非空事件批次 | Python独立serial及顺序,10s | | 无变化sync | docs/contract.md:10 | 空注册设备、刚sync后再次sync | 账本及counters不变,10s | | read/错误优先级 | docs/contract.md:11 | 未注册、无能力、合法含待提交值 | rc/value及完整状态,10s | | detach/无变化撤销 | docs/contract.md:12 | pending丢弃、重复detach、Empty detach | 保留能力/名称/历史,10s | | release/重用 | docs/contract.md:13 | Registered释放、重复空释放、代际重用 | 代际和历史Frame不变,10s | | 只读观察/计数 | docs/contract.md:14;docs/console.md:7 | slots/ledger/counters全部字段 | 递归JSON语义比较,10s | | helper直接覆盖 | docs/contract.md:15 | H及空名/长名/非ASCII helper;inspect与capability内容 | 原始指针所指数据,10s | | 整数/行边界/恢复 | docs/console.md:3 | TAB、符号、前导零、12k/65536/65537行长、int32外、VT/FF、EOF无LF | 固定控制台+独立词法,10s | | 命令数量/参数 | docs/console.md:4-5 | 所有命令、未知/缺失/多余、能力count边界 | 固定调用器,10s | | JSON结构/编码/顺序 | docs/console.md:6-8 | 每行单对象、空数组/null、精确类型及顺序 | UTF-8解码与递归比较;bool不作int,10s | | 交付/构建/直接调用 | README.md:5-7;docs/contract.md:16;prompt.md:5-7 | 标准C++17,五个候选+固定观察器编译 | g++ 两个可执行,25s/次 | Oracle 为 Python 独立状态机,不运行 gold 取得答案。固定 seed 变体覆盖正常/空集合/极限/错误组合/跨槽/撤销/重用;固定观察器只打印 API 原始状态,不含断言和期望。check 只在首个子进程前读取候选并写全部 scratch,随后不读写候选可写目录;stdout bytes 严格 UTF-8 JSON 解码且递归检查类型(bool 不作为整数),stderr replace 仅诊断。 合法替代解允许不同存储和算法,只要求公共 API 与语义;valid_rebuild 使用重建集合和独立 report 分类。硬编码 smoke、忽略重复、仅修复部分、只消除屏幕症状将失败;cheat_read_grader 读取评分文件受 Docker UID 边界拒绝。 ## 5. 样例与校准 计划 gold/valid_rebuild PASS;template/noop/cheat/cheat_read_grader/only_fix_repeat/only_fix_empty_set/only_fix_empty_sync/mask_symptom_repeat FAIL(该样例基于完整正确实现,只合并同批重复通知,公开 smoke 通过但连续重复场景失败)。每类各五次,默认次数不变;完整 load_task 后一次发布,再本地及 Docker 双门,最终回执与摘要记录于 report.json。若本地 reader 意外可读,保留原回执并按 BRIEF 许可例外记录。 ## 6. 真实试采与证据 未用任何模型、未真实试采、无轨迹归档。仅 CALIBRATED/UNMEASURED;当前任务不涉及训练。运行日志仅保留本题唯一 runs 路径,旧证据不覆盖;本题精确 PID 与 events/stderr 受监控,基础设施故障立即停止并报 root。 ## 7. 评审与准入 两门实际回执、最终摘要及清理事实见项目根目录下 factory/20261027-C-hwe-hard-22/subagents/lk-input-device/report.json;root 独立只读评审另记 review.json。交回前清除 template 本次构建二进制/缓存;不提交、不改平台/progress/其他题。report.json 写实际结果、摘要、统计方法和限制。 缺陷定位与独立性:D1 state.cpp 的 event_required 错误返回 false,经 reports.cpp 影响 pending;only_fix_repeat 仅改 state.cpp。D2 registry.cpp 的空 caps 早退未完成替换;only_fix_empty_set 仅改 registry.cpp。D3 frames.cpp 缺少无 pending 的提前返回;only_fix_empty_sync 仅改 frames.cpp。独立三条最小回放与 smoke 矩阵见项目根目录下 factory/20261027-C-hwe-hard-22/subagents/lk-input-device/self-check.json;各 only_fix 恰通过对应单缺陷回放、另两条失败。所有公开文档中边界条款均按普通合同句陈述一次,无内部陷阱标签或强化例子。