openxiangda 2.59.3-http.0 → 2.60.0

package/skills/openxiangda-v2/references/delivery.md

@@ -46,7 +46,26 @@ pnpm openxiangda logs <deployment-id> --json
 
 默认目标为 `test`，平台内部标识为 `preproduction`。只读预览不生成构建产物、不上传制品、不提交 DeploymentRun；因此预览成功不能证明代码已通过检查。正式检查使用本地完整校验，再通过目标平台的 `configurationCompatibility` 核对同源规则、密钥、已有物理模型和登录提供方等只读条件；失败时停止后续步骤。只有启用了自定义 Nest 后端的应用才需要构建后端镜像及对应 Docker 环境。
 
-平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
+平台启用镜像上传后，`deploy` 优先校验本机保存的同输入 OCI 制品，并用当前平台登录态取得原镜像的回执；没有有效制品时才用 Docker Buildx 构建并分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
+
+官方模板按实际后端输入匹配缓存：根 manifest、锁文件、workspace/tsconfig、后端目录、
+共享 contracts、vendor、Dockerfile 和有效 ignore 规则。只改前端源码或文档时可跳过
+Docker 构建，前端及配置仍重新检查、编译和发布。独立配置摘要变化不会直接使镜像失效；
+配置改变生成 contracts 时会重建。缓存只绑定当前账号、平台、应用、环境和工具版本，
+不会跨身份复用。自定义 Dockerfile 默认比较完整构建上下文；用
+`<后端目录>/Dockerfile.dockerignore` 明确限制实际 Docker 输入后，也可复用同输入制品。
+修改 Dockerfile 后不再推测其 shell 命令只读取哪些文件。
+
+成功镜像同样短期保留，不保存远端 ready 状态或 reference；每次复用都校验全部 OCI
+字节并由平台重新鉴权。平台没有原镜像时上传同一制品，不重新构建。缓存过期或被回收
+后需正常构建。需要重新执行本机构建时可用：
+
+```bash
+OPENXIANGDA_BACKEND_IMAGE_CACHE=false pnpm openxiangda deploy
+```
+
+此设置禁用成功制品复用和保留，仍恢复同输入的未完成上传；Docker 自身的层缓存继续
+生效。它不跳过检查、权限或平台回执。无需为普通前端改动手工指定旧镜像或平台管理员介入。
 
 上传失败后，本机保留原 OCI 制品，错误的 `details` 包含候选 ID、原 digest、失效时间及真实 `causeCode`。
 按错误的 `remediation` 处理后，在原工作区执行原 `pnpm openxiangda deploy` 命令（保留原环境等参数）：
@@ -63,6 +82,8 @@ pnpm openxiangda logs <deployment-id> --json
 
 缓存保留最多 24 小时、8 个候选、总预算 8 GiB；空间不足时仅回收未被使用的旧候选。
 仅当平台单镜像上限不超过 8 GiB 时启用本地恢复，较大的平台配额保留原上传路径，不降低平台允许的镜像大小。
+成功制品复用额外预留最多 516 KiB 的 OCI/缓存元数据；平台上限过于接近 8 GiB 时保留
+原上传失败恢复模式，成功后删除，不降低平台单镜像额度。
 缓存和登录凭据分开，位于本机用户私有目录。过期或已经回收的候选需重新构建；已有 DeploymentRun
 的未知结果仍查询原运行，镜像上传恢复不会重新发起已提交的部署。
 
@@ -76,7 +97,7 @@ pnpm openxiangda status <deployment-id> --watch
 
 网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
 
-新的发布使用当前源码构建；尚未完成的同输入镜像上传可复用上述短期原制品缓存。
+新的发布使用当前源码准备前端与配置，后端按实际输入复用或构建；同输入镜像可复用上述短期原制品缓存。
 该缓存不保存部署状态，平台仍唯一拥有 DeploymentRun。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
 
 ## 测试环境验收
@@ -156,3 +177,11 @@ MCP 的 check_app、deployment_plan、deploy_app 使用与 CLI 相同的环境
 先运行 `openxiangda deploy --environment test --strategy maintenance-replace --dry-run --json` 查看前驱版本、Head revision 和停止后的容量估算，再使用相同参数去掉 `--dry-run` 提交。计划不预留资源。只有已存在、身份匹配的单副本 TEST 后端才可使用；前端应用、新应用和 production 不支持。默认仍为 rolling，不会因配额不足自动停止实例。
 
 策略属于部署幂等请求。默认维护幂等键含策略，显式幂等键不能在不同策略之间复用。已有运行通过 status/retry 恢复；持续恢复中的运行保持 preparing/maintenance-recovery-required，平台会重试恢复，恢复失败时保留原运行与错误。
+
+## OSS 直传与静态分发
+
+平台管理员在「平台内置对象存储 → 应用构建与分发」启用「开发工具直传 OSS」后，新版 CLI 自动协商并直传构建包和镜像分块。开发者无需本机 OSS 密钥；平台从自己的存储读取，校验大小及摘要后封存或导入受管镜像仓库。中断后重新运行原 deploy，仍按原 digest/offset 恢复，不手工创建新镜像尝试。旧平台没有此能力时保持原通道；云端失败明确报告，不静默改用另一通道。
+
+「前端静态资源 → OSS / CDN」让 JS、CSS、字体等从 OSS 的不可变版本目录加载。HTML、登录、路由和 API 保留平台入口。Public Base URL 可配置已可用的 HTTPS CDN 域名；未配 CDN 时是 OSS 分发，不能据此承诺 CDN 加速。OSS GET/HEAD 的 CORS 需包含实际平台 origin。源码映射不公开。
+
+存储权限需覆盖隔离目录的 PutObject、GetObject、对象 ACL（暂存 private，校验后的静态资源 public-read）。不得更改整桶 ACL。建议为 `openxiangda/application-staging/` 配置 1 天生命周期；平台不自动覆盖现有生命周期。配置切换发生在直传和导入之间会明确拒绝，重新运行原部署即可按新配置恢复。关闭直传/切回平台静态分发可回退，不修改业务数据或环境版本。

package/skills/openxiangda-v2/references/getting-started.md

@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.59.3-http.0 skill install --force
-pnpm dlx openxiangda@2.59.3-http.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.59.3-http.0 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.59.3-http.0 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.60.0 skill install --force
+pnpm dlx openxiangda@2.60.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.60.0 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.60.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -204,9 +204,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.59.3-http.0 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.59.3-http.0 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.59.3-http.0 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.60.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.60.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.60.0 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回