Qwen failed all 3 attempts of each (context limit, counted as failure). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.2 KiB
文件 API 与软件回放合同
R01. 本工作区模拟 64 KiB NOR flash,擦除块为 4096 字节,文件系统逻辑块为 4096 字节、页为 256 字节。写入只能把位从 1 变为 0,擦除把整块复位为 1。所有文件系统内容、索引和缓存操作由 SPIFFS 原实现完成。
R02. 使用原 mount 配置和相应内存 buffer。第一次 mount 用于配置实例,空白介质可以报告未格式化;若 mount 成功先 unmount,再 format,随后 mount。format 后没有文件,每个观察进程使用新介质。
R03. mount 传入的 descriptor 内存按本配置的完整 descriptor 类型分配,数量由观察输入给出。没有应用持有打开文件时,应能重新使用该容量;达到容量后,额外 open 返回 SPIFFS_ERR_OUT_OF_FILE_DESCS。关闭后资源可再用于文件操作。
R04. SPIFFS_open 按原头文件的创建、读、写、direct 等标志执行。新建文件长度为零。write 成功返回写入字节数,read 返回从当前文件位置读到的字节数和相同内容;请求超过文件剩余长度时返回实际剩余内容。每个新打开的 handle 从文件开头读写。
R05. close 完成该文件待写数据并关闭 handle,stat 返回已完成内容的长度;重新打开后可读回相同字节。direct 写和普通写均遵守这些内容与长度规则。
R06. remove 按名称、fremove 按可写 handle 删除文件。成功删除后,该名称的 stat 返回 SPIFFS_ERR_NOT_FOUND,原文件的打开 handle 结束使用,所占资源可供后继文件正常使用;其他文件的已写或待写数据保持不变。
R07. 文件名和内容来自操作输入。不同文件各自保存自己的字节;空文件、多次创建删除、多个 handle 及不同 descriptor/cache 容量也遵守上述规则。调用发生在单线程中,不在删除后继续使用旧 handle。
R08. 支持六种原开关组合:default 为读写 cache 和 temporal cache 均启用;readcache 只关闭写 cache;nocache 关闭读写 cache;notemporal、readcache_notemporal、nocache_notemporal 分别在前三种基础上关闭 temporal cache。保留原 HAL callback extra、filehandle offset 与 magic 配置,使用原 NO_TEST 单线程开关。
R09. 诊断输出保持原默认关闭;将来开启需补齐原版本依赖并重新验证,不沿用当前工作区的结论。
观察输入的首行为 descriptor数量 cache页数,范围分别为 1–64 和 1–16。后续每行是一条操作:
| 操作 | 含义 |
|---|---|
O tag name flags |
open,把返回 handle 保存到 0–95 的 tag;flags 为头文件数值组合 |
W tag hex |
write 十六进制字节,单次最多 4096 字节 |
R tag count |
read 至多 count 字节,count 为 0–4096 |
C tag |
close |
D name |
remove |
F tag |
fremove |
S name |
stat |
输出依次为 U uid gid 补充组数量、M 首次mount返回值 format返回值 mount返回值 descriptor数量、各操作的 tag/name 与返回值。read 还输出所得字节的十六进制串;stat 还输出长度。末行 P 给出物理读、写、擦除次数及物理边界/对齐错误次数。它们都是观察值,程序内没有预期结果或通过标志。