Skip to content

docs(aeff): v0.2.0 标准草案 — 正文规范/附录拆分、目录树与 IEEE PAR - #23

Open
freeof123 wants to merge 7 commits into
YeeZTech:developfrom
freeof123:doc/v0.2.0
Open

docs(aeff): v0.2.0 标准草案 — 正文规范/附录拆分、目录树与 IEEE PAR#23
freeof123 wants to merge 7 commits into
YeeZTech:developfrom
freeof123:doc/v0.2.0

Conversation

@freeof123

Copy link
Copy Markdown
Member

Summary

提交 Analyzable Encrypted File Format(AEFF,.aeff 标准中文草案 v0.2.0 及相关文档,供 review。

主要变更:

  • 新增 doc/sealed-format-standard-zh.tex 主文档(xelatex 可编译,约 56 页 PDF)
  • v0.2.0 结构:80 字节 Header、tree_item_*、以 Item 为内容区最小单元;正文保留格式/密码学边界/目录树等规范性章节,封装·解封·多文件·v2 密码学套件迁入附录 F–H
  • 新增 doc/sealed-directory-tree.tex:目录树明文格式(第 7 章)
  • 新增 doc/sealed-crypto-normative.texsealed-crypto-appendix.tex 等拆分源文件
  • 新增 doc/ieee-par-aeff-zh.md:IEEE PAR 表单中文答复稿
  • 新增 doc/diagrams/ 封装/解封/批刷流程图(mmd + png/pdf)
  • 文案修订:§1.2 与现有方案对比表述、§4.1 读取要求收敛、§5.2.2 Header 兼容规则、Block Info 含/不含区间表述、附录标题去重编号等

文档结构(速览)

部分 内容
正文 1–5 引言、术语、格式总览、二进制布局
正文 6–7 密码学边界、目录树明文
正文 8–11 可恢复扩展、兼容性、安全、测试(部分占位)
附录 A–D 字段表、伪代码、错误码、参考实现映射
附录 E–H child.type 表、v2 套件、多文件编排、封装/解封流程

已知待补(草案内已标注)

  • §9.2:v0.1(64B Header)→ v0.2(80B)互操作细则
  • §11.2 / §11.3:二进制样例、互操作矩阵
  • §7 树头魔数/版本「暂定」参数
  • 附录 G:多文件流程图、扩展错误码

Test plan

  • cd doc && xelatex sealed-format-standard-zh.tex(跑 2–3 遍消交叉引用)
  • Manager / 文档审阅者通读引言、第 5/7 章及附录 A/H
  • 确认 PR 合并目标分支(developmain)与团队约定一致
  • 编译产物(.pdf / .aux 等)是否入库由 reviewer 决定(当前 PR 仅含 .tex / .md / 图源)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant