Expand description
§STR 结构化树资源格式(.str)
规范见仓库根目录 STR-FORMAT-PROMPT.md(唯一真源);
本实现对应的规范版本见常量 SPEC_VERSION。
本 crate 提供:
meta:._meta(TOML)的解析、归一化(TOML → 规范 JSON,键序/表序固定)与保注释写回;bundle:分支树遍历、懒加载、id索引;validate:规范第 6 章全部错误码的实现;cmd:CLI 各子命令。
§校验链路
._meta(TOML)→ 解析 → 归一化为规范 JSON(meta::Meta::to_json)→ JSON Schema 2020-12 校验。
Modules§
- baseline
E_REVISION_STALE的历史基线(._cache/revisions.json)。- bundle
- bundle 遍历与索引。
- cmd
- CLI 子命令实现(规范第 9 章)。
- error
- 错误码与校验报告。
- meta
._meta的解析、类型化提取与归一化(TOML → 规范 JSON)。- meta_
edit ._meta的保注释写回与新建模板渲染。- util
- 通用工具:UUID v7、SHA-256、时间与命名判定。
- validate
- 规范第 6 章全部错误码的实现。
Constants§
- EMBEDDED_
SCHEMAS - 内嵌的三种档位 JSON Schema(bundle 未自带
._schema/时的兜底)。 - SPEC_
VERSION - 本实现对应的规范版本。
- STR_
MAJOR - 本实现对应的
str格式主版本。