@my-life-buddies/cli 0.26.1 → 0.26.3

package/README.md

@@ -277,15 +277,9 @@ buddy-cli init --mode create --directory ./study-buddy \
          → 基础技术自测 → 打开真实预览 → 开发者体验并反馈
 ```
 
-CLI 0.15.0 起，Creator 使用独立 npm 包 `@my-life-buddies/buddy-creator-skill`。新项目首次创作查询稳定版，校验后缓存到 `~/.cache/buddy-cli/creator-skills/buddy-creator-skill/<版本>/`，在 `.buddy/creator/skill-lock.json` 记录准确版本与完整性摘要。恢复项目优先使用固定版本缓存，不自动升级，已有缓存时 Skill 准备无需联网（平台身份校验仍需联网）。Skill 负责人独立发包，不再要求重发 CLI。
+CLI 0.15.0 起，Creator 使用独立 npm 包 `@my-life-buddies/buddy-creator-skill`。每次进入或恢复创作都查询公共 npm latest 最新正式版，校验后缓存到 `~/.cache/buddy-cli/creator-skills/buddy-creator-skill/<版本>/`，在 `.buddy/creator/skill-lock.json` 记录本次准确版本与完整性摘要。只有查证缓存对应最新版后才复用；版本记录不会阻止升级，恢复时也需要联网。Skill 负责人独立发包，不再要求重发 CLI。
 
-显式升级某个项目：
-
-```bash
-buddy-cli init --mode create --directory ./study-buddy --creator-version 1.6.0
-```
-
-CLI 只接受协议兼容的准确稳定版本，保留原始背景、身份与作品。未改动的旧版生成接续说明会备份后迁移；开发者自定义说明不覆盖。新项目下载失败会报错并保留登记身份，可在同目录重试。
+不再提供 `--creator-version` 固定版本入口。CLI 查询 latest 后验证协议及完整性，保留原始背景、身份与作品。未改动的旧版生成接续说明会备份后迁移；开发者自定义说明不覆盖。查询、下载或协议校验失败都会报错，不退回旧缓存；已有资料和登记身份保留，可在同目录重试。
 
 维护者本地联调：
 
@@ -294,11 +288,11 @@ BUDDY_CREATOR_SKILL_PATH=/absolute/path/buddy-creator-skill \
   buddy-cli init --mode create --directory ./study-buddy
 ```
 
-本地来源同样记录在项目中，适合 Skill 开发，不要求发布。要切回 npm，清除环境变量并显式指定 `--creator-version`。Python 执行仍需 3.9+，不安装 Python 第三方依赖。阶段与创作规则由 Skill 的 `references/cli-workflow.md` 管理，CLI 只处理身份、目录和有效交付后的开发接续。
+本地来源同样记录在项目中，仅用于显式 Skill 联调，不要求发布。每次联调都需要提供该环境变量；清除后会查询公共 npm latest，不因旧的本地版本记录继续使用本地目录。Python 执行仍需 3.9+，不安装 Python 第三方依赖。阶段与创作规则由 Skill 的 `references/cli-workflow.md` 管理，CLI 只处理身份、目录和有效交付后的开发接续。
 
-创作资料保存在 `.buddy/creator/`。CLI 支持 Creator 接入协议 1 和 2；Creator 2.1 的新作品使用 `workflowVersion=2` 的三册，旧作品继续原工作流，不自动迁移。按该作品工作流完成手册、小挂件清单、当前原型和设计验收，并通过交付校验，Skill 才返回 `directive=creator_complete`、`completion.status=ready` 和有效的 `completion.manualPath`；明确确认不使用小挂件时无需制造原型。完整创建任务中，当前 Coding Agent 退出采访，在同一轮重新读取 `HANDOFF.md`、真实手册、同目录实际 manifest、来源映射及小挂件设计与验收产物，自动开始开发，无需再说“继续”。不按旧四册文件名硬编码交付清单；手册确认或文件存在不能单独触发开发。只有影响实现的关键缺口才补问；仅设计、流程测试和暂停仍遵守原范围。
+创作资料保存在 `.buddy/creator/`。CLI 支持 Creator 接入协议 1 和 2；最新版 Creator 统一使用 `workflowVersion=2` 的三册（定位、知识与方法、付费服务）；旧四册由 Creator 的 open 保存历史后迁移，复用资料与可用进度，补充缺口并重新确认发生变化的内容，不把旧完成标记直接当作新交付。按该作品工作流完成手册、小挂件清单、当前原型和设计验收，并通过交付校验，Skill 才返回 `directive=creator_complete`、`completion.status=ready` 和有效的 `completion.manualPath`；明确确认不使用小挂件时无需制造原型。完整创建任务中，当前 Coding Agent 退出采访，在同一轮重新读取 `HANDOFF.md`、真实手册、同目录实际 manifest、来源映射及小挂件设计与验收产物，自动开始开发，无需再说“继续”。不按旧四册文件名硬编码交付清单；手册确认或文件存在不能单独触发开发。只有影响实现的关键缺口才补问；仅设计、流程测试和暂停仍遵守原范围。
 
-工作流 2 还需读取 `completion.capabilityContractPath` 指向的能力契约，按 Skill 的 `references/implementation-handoff.md` 保存 `implementation-report.json`，记录当前契约版本、逐需求实现和真实验证证据，再运行 `handoff-check`。该命令只核对报告结构、版本及覆盖，仍需实际 Runtime 验证；旧工作流不因升级 CLI 或 Skill 而强制补交新版契约和报告。「平台能力」中的方案来自 `service.blueprint.data.capabilityPlan`；旧作品仍可读取 `proactiveReminders`，方案展示不代表已经启用。
+新版三册还需读取 `completion.capabilityContractPath` 指向的能力契约，按 Skill 的 `references/implementation-handoff.md` 保存 `implementation-report.json`，记录当前契约版本、逐需求实现和真实验证证据，再运行 `handoff-check`。该命令只核对报告结构、版本及覆盖，仍需实际 Runtime 验证；迁移后的项目也须通过当前三册交付校验。「平台能力」中的方案来自 `service.blueprint.data.capabilityPlan`；旧资料迁移时可读取 `proactiveReminders`，方案展示不代表已经启用。
 
 手册中的角色、方法、处理路径和持续服务要求，都是开发依据。Coding Agent 按这些要求判断是否需要工具、专业方法、特定处理步骤、记忆与历史整理，技术选择不逐项交给开发者；完成后向开发者简要说明需求来源、实现位置、检查结果和缺口，不要求额外生成 README。已经明确的直接做，不能实现的如实说明；只有元数据或默认配置，不代表手册要求已经完成。
 
@@ -308,7 +302,7 @@ BUDDY_CREATOR_SKILL_PATH=/absolute/path/buddy-creator-skill \
 buddy-cli init --mode direct --directory ./study-buddy
 ```
 
-创作阶段的 `package.json` 只有顶层 `buddyId`；CLI 用它从平台读取最新资料并重新校验归属，不另建搭子。创作中断后可以在原目录重试 `--mode create`，继续使用原作品；手册完成后执行 `--mode direct`，保留已有业务代码与数据声明，补齐 npm 字段和缺失的工程文件；缺失 `data-access.json` 时生成空 requirements 数组。旧 `--mode interview` 已停止使用。
+创作阶段的 `package.json` 只有顶层 `buddyId`；CLI 用它从平台读取最新资料并重新校验归属，不另建搭子。创作中断后在原目录重试 `--mode create`，检查最新 Creator 后接续原作品；手册完成后执行 `--mode direct`，保留已有业务代码与数据声明，补齐 npm 字段和缺失的工程文件；缺失 `data-access.json` 时生成空 requirements 数组。旧 `--mode interview` 已停止使用。
 
 两条主线都遵循同一个登记规则：名称、`tagline`（一句话介绍）、`intro`（完整介绍）先同步到平台，返回的 ID 写入 `package.json.buddyId`。公开资料不在本地留副本。若平台已创建成功、本地写盘失败，可用 `--buddy-id <平台返回的 ID>` 恢复；它不是自定义 ID 的入口。
 
@@ -322,7 +316,7 @@ Creator 例外保留首次创作背景快照，用于接续同一作品；恢复
 
 你明确要求自动体验或多场景回归时，Coding Agent 再按指定范围执行。`push` 仍需要明确授权。若你只要求初始化、修改某段代码或完成设计，也不会因为这套默认流程就自动启动预览。
 
-这些规则通过 CLI 帮助、命令输出和 Creator 的 `HANDOFF.md` 交给 Coding Agent；CLI 不会在 `init` 内自动执行采访、编写业务代码或批量调用模型。重试创作时复用当前接续说明和作品，不覆盖开发者修改的文件。已有完整工程无需重新初始化，可从更新后的 CLI 帮助和 `preview` 输出读取交接规则。
+这些规则通过 CLI 帮助、命令输出和 Creator 的 `HANDOFF.md` 交给 Coding Agent；CLI 不会在 `init` 内自动执行采访、编写业务代码或批量调用模型。重试创作时查询最新 Creator 并刷新生成的接续说明，保留原作品和开发者修改的文件。已有完整工程且保留 Creator 记录时，也可执行 `init --mode create` 接续创作，业务文件不会重建；没有 Creator 历史的直接开发工程继续按已有需求开发。
 
 ## 查看和修改搭子资料
 
@@ -508,27 +502,15 @@ 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`，商品内容保持原样。读取回执失败或商品提交失败不会被自动当成空商品清单继续发布。也可以到后台“版本与发布”确认本次发布内容。
+CLI 负责上传代码、提交明确选中的商品以及查询或恢复这些操作。上传、审核和构建成功后，在开发者后台“版本与发布”核对本次版本与获批商品快照，再确认发布；CLI 不提供最终发布命令。
 
-```bash
-buddy-cli release --status <releaseId>
-buddy-cli release --resume <releaseId>
-buddy-cli release --retry <releaseId>
-buddy-cli release --cancel <releaseId>
-```
+首次商品必须随关联搭子版本一起发布。曾上架商品的修改可以在当前线上代码支持时，从后台单独发布；已下架商品发布修改后仍保持下架。只希望更新代码时，在后台明确选择仅发布代码，商品内容保持原样。
 
-发布结果未知时先查询或恢复原任务；明确失败后可重试。取消阻止本任务后续激活商品，但不回滚已经开始的代码部署。仅 `active` 表示本次发布与商品激活完成。状态和恢复记录按平台、账号、搭子隔离，保存在本机私有操作目录；记录不包含登录凭据，恢复使用当前账号重新鉴权。
+发布任务的状态查询、重试和取消也在后台操作。取消阻止本任务后续激活商品，但不回滚已经开始的代码部署。后台显示发布成功后，仍需确认实际服务体验。下架仍在后台操作。
 
-本期沿用平台已有的发布成功标准，没有新增 Runtime 初始化完成回报。页面或 CLI 显示发布成功，不等于实际服务已通过人工体验。下架仍在后台操作。
+CLI 的上传和商品补提恢复记录按平台、账号、搭子隔离，保存在本机私有操作目录；记录不包含登录凭据，恢复使用当前账号重新鉴权。
 
 ### 上传前检查