跳转到主要内容

参考

配置 Schema、包引用、磁盘布局、退出码、JSON 输出、平台与集成。

这一部分记录配置字段、包引用、路径、退出码、JSON、平台与集成等稳定契约。CLI 语法和状态变化 见命令,使用模型见上手

输出示例只说明形态;标识符、路径、哈希、时间戳与计数会随工作区变化。二进制自带的 sow help 始终是精确语法权威。

完整配置 schema:工作区、仓库、Dist、成员策略、签名与发布目标。

命令行上指代一个软件包的五种写法、歧义如何裁决,以及 rm / show / where 各自接受哪些形态。

Plain 与 Managed 两种模式下 SOW 创建的每一条路径、包池分组规则、名称约束, 以及绝对不能通过 HTTP 暴露的目录。

七个退出码分别代表什么。

sow.cli/v1 Envelope、各顶层字段含义与主要命令族的 Result 形态。

Release 目标、文件系统要求、仓库客户端检查、发布 Provider,以及各项自动化集成的确切范围。

约定

命令示例不带 $ 提示符,方便整块复制。输出块只代表结构,可变值与长结构会在标注处省略。 二进制自带的 sow help 始终是精确语法权威。

语法块中占位符用大写(NAMEDIRPACKAGE),字面量用小写。方括号表示可选参数, ... 表示可重复,竖线分隔互斥项 —— 与 sow help 的写法一致。

sow.yml 配置参考

工作区配置文件的全部字段、校验规则,以及一份完整可用的示例。

包引用

命令行上指代一个软件包的五种写法,以及歧义如何裁决。

仓库布局

SOW 的公共与私有路径,包括唯一规范包池与纯元数据视图。

退出码

七个退出码分别代表什么,以及每个码一条可复现的触发命令。

JSON 输出

sow.cli/v1 Envelope、字段含义与主要命令族的 Result 形态。

平台与集成

Release 目标、文件系统要求、仓库客户端、发布 Provider 与自动化集成覆盖。