@my-life-buddies/cli 0.25.2 → 0.26.0

package/README.md

@@ -474,20 +474,59 @@ Preview 展示平台对话记录、发送与流式输出耗时、会话状态和
 
 正式 CLI 自动更新也只查询 `latest`；若该标签误指向预发布版本，停止并提示发布者修正，不跨到测试渠道。
 
-## 上传程序包，不等于发布
+## 上传、商品审核与发布
 
-上传后 CLI 显示构建状态，并最多等待 60 秒。构建失败显示原因；未完成或查询失败时用 `buddy-cli status` 重查，不重复上传。构建完成后仍需在后台手动发布。
+先在后台创建商品取得稳定 ID，完善资料后点击“保存”（体验截图选填）。从未上架商品必须随新搭子版本上传提审并一起发布，商品页不提供独立“提交审核”。搭子代码可以引用该 ID；无需创建 `product.json`，平台查询商品元数据的接口本期尚未实现。
 
 ```bash
 buddy-cli push --directory ./study-buddy --commit "根据完成情况调整练习难度"
+buddy-cli push --directory ./study-buddy --commit "增加写作陪伴" --product prd_12345678
 buddy-cli status --directory ./study-buddy
 ```
 
-`push` 收集包含顶层 `buddyId` 的 `package.json`、`data-access.json`、源码和依赖锁文件，生成 `tar.gz`，上传到 `/cli/buddies/:id/packages/push`。`commit` 是改动说明，与本地 Git 是否提交无关。版本由 MLB 返回，CLI 不上传自己生成的 tag 或提审时间戳。
+`--product` 可以重复，每次仅提交明确选中的商品当前已保存内容。新商品 ID 使用 `prd_` 加八位数字（如 `prd_12345678`），已有 `ps_` 商品 ID 继续兼容；复制后台返回的真实 ID，不要自行生成。未传该参数只上传代码，不扫描代码猜测商品，也不自动提交其他商品修改。CLI 在发送前固定本次上传 ID、源码包、商品审核 ID 和内容版本；平台为该上传生成唯一版本并自动通过代码和商品审核，构建状态单独显示。审核通过不会自动发布。
 
-审核状态以平台响应为准，可能已经是 `approved`，不能仅因命令名叫“提审”就假定一定进入等待审核。`status` 查询搭子资料和最近 5 次程序包记录，显示线上版本、运行状态、审核结果及说明。
+`push` 收集包含顶层 `buddyId` 的 `package.json`、`data-access.json`、源码和依赖锁文件，生成 `tar.gz`。`commit` 是改动说明，与本地 Git 是否提交无关。版本由 MLB 返回，CLI 不上传自己生成的 tag 或提审时间戳。构建未完成用 `status` 查询，不要重新上传。
 
-CLI 不提供 `release`、`publish`、`disable`、`enable` 或 `unpublish`。最终发布和下架留给 Web。上传成功只说明平台收到了这份包，不说明生产运行已经验证。
+### 恢复原上传
+
+```bash
+buddy-cli push --status <pushId>
+buddy-cli push --resume <pushId>
+```
+
+网络中断或结果未知时，按终端给出的 ID 查询或恢复原操作。恢复使用原包和原商品版本，不会把后来编辑的内容悄悄提交。代码已上传但商品提交失败时，先修正并保存商品，再对同一待发布版本发起一次补提。首次商品仅允许恢复原上传已明确携带且提交失败的项，由平台核验原上传凭证；不能补入其他首次商品或关联已经上线的版本。
+
+### 补提或单独提交商品
+
+```bash
+buddy-cli products submit --version <已上传版本> --product prd_12345678
+buddy-cli products submit --resume <submissionId>
+```
+
+提交结果包含准确的审核快照 ID。只有曾上架商品（包括已下架商品）才可独立选择已有版本提交修改；当前线上代码支持本次修改时，可以选择当前已发布版本，之后单独发布修改。首次商品仅可通过此命令恢复原上传的商品提交失败，仍须与关联搭子版本一起发布。
+
+### 确认发布
+
+```bash
+buddy-cli release --from-push <pushId>
+buddy-cli release --from-submission <submissionId>
+buddy-cli release --from-submission <submissionId> --products-only
+buddy-cli release --version <版本> --code-only
+```
+
+前两种方式使用原回执中的版本与获批快照。`--products-only` 仅用于曾上架商品的修改，要求目标仍为当前已发布搭子版本；首次商品不能使用此选项，必须随关联搭子版本一起发布。已下架商品发布修改后仍保持下架。只希望更新代码时，明确使用 `--code-only`，商品内容保持原样。读取回执失败或商品提交失败不会被自动当成空商品清单继续发布。也可以到后台“版本与发布”确认本次发布内容。
+
+```bash
+buddy-cli release --status <releaseId>
+buddy-cli release --resume <releaseId>
+buddy-cli release --retry <releaseId>
+buddy-cli release --cancel <releaseId>
+```
+
+发布结果未知时先查询或恢复原任务；明确失败后可重试。取消阻止本任务后续激活商品，但不回滚已经开始的代码部署。仅 `active` 表示本次发布与商品激活完成。状态和恢复记录按平台、账号、搭子隔离，保存在本机私有操作目录；记录不包含登录凭据，恢复使用当前账号重新鉴权。
+
+本期沿用平台已有的发布成功标准，没有新增 Runtime 初始化完成回报。页面或 CLI 显示发布成功，不等于实际服务已通过人工体验。下架仍在后台操作。
 
 ### 上传前检查