修复设备发布工程:build-feature-flags
现场症状:发布脚本通过环境传入版本与过滤开关,但产物仍显示默认值;启用过滤后同一记录修正为非负值再提交却被拒绝。
修复当前工程,使已有采集、构建和发布合同同时成立。修改范围为 Makefile 与 engine.c;其他源文件是公开工程上下文。使用已有宿主 C11 工具链,无硬件、网络或交叉编译依赖。
构建与发布合同 B
make 必须尊重环境 CFLAGS、CPPFLAGS 及命令行 CC/CFLAGS/LDFLAGS/LDLIBS;保留工程所需头文件路径。APP_FEATURE 默认为 0,可为 0 或 1;APP_VERSION 默认为 1,本题为 1..99。feature/version 输出编译进产物的值。feature=1 时负值记录返回 1,dropped 增 1,不占队列、不记入去重历史、accepted 不变。排空值为 value*(feature+1)+version,再加到该通道累计值。
make 默认目标为 app,make clean 可重复执行;构建须保留协议、队列和主程序。应用从 stdin 接受多条命令,逐行响应,不写输入文件。不会根据新增文件拒绝候选;最终只提交和评分 Makefile、engine.c。编译器、make、ar、ld、readelf 均已提供,不使用 cmake。
采集与队列合同 Q
device.h 定义 Request/Response、engine_reset(uint32_t epoch) 与 engine_execute(const Request*,Response*)。进程起始等同 RESET 0。RESET E 清空队列、全部计数、去重历史及各通道累计值,并设置 epoch=E。8 个通道编号为 0..7,FIFO 容量 32。
PUT sequence channel value 使用 uint32 序号、uint32 通道和 int32 值。非法通道返回 -1;在最近 64 条成功入队记录中出现过的序号返回 -2(跨通道、排空及 DROP 均有效);队列满返回 -3。检查顺序依次为通道、历史、可选过滤、容量。成功返回 0,accepted 增 1 并加入历史;历史满后移除最早的成功入队序号。失败不改变任何状态。序号 0 与 UINT32_MAX 均合法。
DRAIN limit:limit=0..32,按 FIFO 取至多 limit 条,按构建合同转换每条原值并累加到它所在通道的 int64 总值,每条输出更新后的该通道总值;limit>32 返回 -1 且不修改状态。累计值仅由排空推进。DROP channel 删除该通道所有待处理记录,dropped 增加删除数量,保持其他记录次序、历史及累计值;非法通道返回 -1。STATE 仅观察。
线格式与观察合同 W
WIRE hex 等同 PUT:16 字节为小端 uint32 sequence/channel、int32 value,末尾为前 12 字节的 IEEE CRC32(与 Python zlib.crc32 一致)。大小写十六进制均有效;长度、校验或通道错误与未知/格式错误命令返回 -1、不改状态。不会要求处理超过公开行缓冲区的输入。所有数值运算在不溢出 int64 的范围内。
每条命令(含错误)打印一行:R status epoch accepted dropped pending digest backend feature version count [values...]。digest 为待处理 FIFO 中各完整 16 字节线记录串联的 IEEE CRC32,空队列为 0。count 为本命令排空记录数;其余命令 count=0。backend 缺省为 1(构建合同另述除外),feature/version 默认 0/1(构建合同另述除外)。错误仍输出完整当前状态。stdout 仅包含协议行,诊断可写 stderr。
自测:make clean、make,再将 RESET 7、PUT 1 0 11、PUT 2 1 -12、DRAIN 1、STATE、DRAIN 32 逐行送入 ./app。发布/环境变量合同可在同一树或复制后的干净目录重复构建观察。隐藏验收只组合以上公开行为。