本书(mdBook)讲解 move-stdlib 与 sui-framework,不含 sui-system。出版版目标不是复刻源码目录,而是把 Sui Framework 拆成 值世界、对象模型、资产协议、状态升级、测试密码学 五卷,帮助读者理解模块之间的取舍与不变量。
当前正文已按出版社审校口径完成 逐节学习化重写:每章从学习目标进入,补充模块定位、心智模型、失败边界、工程取舍、练习与自测题,避免只做源码摘要。
- 读者目录按卷组织:出版导读 + 五卷正文 + 项目附录,见
src/SUMMARY.md。 - 维护目录按篇保留:
src/part00-opening、part01-move-stdlib、part02-sui-object… 见docs/BOOK_STRUCTURE.md。 - 主题合并:例如
u8~u256合并为一章;链上table/bag/… 在集合章对照选型。 - 章节模板:每章优先覆盖定位、类型关系、常用路径、失败边界、实战取舍与练习验收。
- 学习化重写:正文逐节改为“先理解场景,再拆 API,再看失败和练习”的讲法。
- 实战附录:新增源码阅读工作簿、Coin Vault、NFT/Kiosk、大状态升级、审计清单与八周练习大纲,供正文之后深化训练。
出版策划说明:docs/PUBLISHER_EDITION.md。
- mdBook:
mdbook build - Move 示例:
examples/,执行cd examples && sui move test。Move.toml已锚定testnet-v1.71.0(commit 见src/part00-opening/02-conventions.md「修订记录」);升级依赖时请同步更新二者。
- 任务清单:
docs/BOOK_TODO.md - 出版版结构:
docs/BOOK_STRUCTURE.md - 出版策划:
docs/PUBLISHER_EDITION.md - 旧按文件拆章的目录与已停用的生成脚本已移除;篇目录 以
docs/BOOK_STRUCTURE.md为准。