@clawos-dev/clawd 0.2.121 → 0.2.122-beta.241.0e144f4

package/dist/persona-defaults/persona-app-builder/CLAUDE.md

@@ -239,7 +239,18 @@ await app.listen(Number(process.env.CLAWD_PREVIEW_PORT));
 - **dev 预览**：UI 通过 session ↔ project ↔ port 数据流自动加载，daemon state 驱动
 - **prod 预览**：跑完 `publish.sh` 后调 `appBuilder.setProdUrl` RPC（见上文），daemon 写入 `.clawd-project.json.prodUrl` 后 UI 自动切线上 URL
 
-老板点右栏 header 的「发布上线」按钮时，会以普通消息发来"请发布上线（publish）"——收到就跑 `publish.sh` → `setProdUrl` 这条线。
+### 发布上线（脚手架化 2026-06-03）
+
+老板点 PreviewPane「发布上线」按钮走 **daemon RPC 脚手架**（`appBuilder.publish`），happy path 完全跳过你 —— daemon 自己 spawn `publish.sh`、解析 stage marker、调 `appBuilder.setProdUrl` 写 prodUrl，你不会收到任何 chat 消息。
+
+**只有发布失败时**，daemon 会以普通消息发来一条以 `发布失败：[<stage>]` 开头的文本（含 stderr 错误摘要 + `.publish.log` 路径）。**收到这种消息时，你接管完成本次发布**：
+
+1. 读项目目录下的 `.publish.log` 完整日志
+2. 定位并修复问题（改源码 / 改 `ext.conf` / 检查 `.secrets/aliyun.env` 等）
+3. 重跑 `bash extension-kit/scripts/publish.sh <projDir>` 直到 exit 0 且输出公网 URL
+4. 调 `appBuilder.setProdUrl` 把 URL 写入项目元数据（同上文）
+
+**注意**：重跑期间不要自己调 `appBuilder.publish` RPC（那是给 UI 按钮用的，会被 daemon 当作"已 in-flight"拒绝），手动跑脚本即可。失败回灌的消息开头固定是 `发布失败：[`，识别此前缀即触发接管流程。
 
 **dev server 起不来怎么排查**：daemon 把 supervisor 输出（`dev-server.start` / `.stdout` / `.stderr` / `.spawn-failed` / `.exit`）打进 `~/.clawd/clawd.log`，老板可以 `grep dev-server ~/.clawd/clawd.log` 看真凶。常见原因：
 - 端口 6XXX 被系统其他进程占了 → 右栏 header 齿轮菜单 → "Update Port..." 换段内另一个

package/dist/persona-defaults/persona-app-builder/extension-kit/examples/nestjs-react/server/src/main.ts

@@ -62,9 +62,24 @@ async function bootstrap() {
     app.use(vite.middlewares);
     console.log(`[clawd-dev] vite middleware mounted (root=${viteRoot}, base=${viteBase}, apiPrefix=${apiPrefix}, allowedHosts=${allowedHosts.join(',')})`);
   } else {
-    // prod / 脱离 clawd 跑：直接 serve web/dist 静态资源（build 时拷贝过来）
-    const staticDir = path.resolve(__dirname, '..', '..', 'web', 'dist');
+    // prod / 脱离 clawd 跑：直接 serve 前端静态资源。
+    //
+    // 路径解析两条路（覆盖 FC 部署与本地 monorepo 启动两种场景）：
+    //   1. FC（CODE_DIR=./server 只上传 server/，运行时 __dirname=dist/）
+    //      publish.sh BUILD_CMD 末尾会跑 `mkdir -p dist/public && cp -R ../web/dist/. dist/public/`
+    //      把前端打包产物塞进 dist/public，跟着 server 一起上传到 FC。所以 prod 优先用
+    //      __dirname/public 这条 FC 内可达的绝对路径。
+    //   2. 本地 monorepo `node dist/main.js`（极少用，但保留兼容）：__dirname/public 不存在
+    //      时 fallback 到 ../../web/dist（monorepo 相对路径）。
+    //
+    // 历史坑：spec 2026-06-03 前只有路径 2，FC 上 404 整个前端 —— 因为 ../../web/dist 在 FC
+    // 容器里压根不存在（CODE_DIR 只上传了 server/）。dev 时靠 vite middleware 走内存编译没暴露。
+    const fs = await import('node:fs');
+    const fcStaticDir = path.resolve(__dirname, 'public');
+    const monorepoStaticDir = path.resolve(__dirname, '..', '..', 'web', 'dist');
+    const staticDir = fs.existsSync(fcStaticDir) ? fcStaticDir : monorepoStaticDir;
     app.useStaticAssets(staticDir);
+    console.log(`[prod] serving static from ${staticDir}`);
   }
 
   await app.listen(port, '0.0.0.0');

package/dist/persona-defaults/persona-app-builder/extension-kit/scripts/new-extension.sh

@@ -34,7 +34,7 @@ cat > "$DEST/ext.conf" <<EOF
 APP_NAME=$NAME
 CODE_DIR=./server
 FC_ENTRY=dist/main.js
-BUILD_CMD="cd web && npm install && npm run build && cd ../server && npm install && npm run build"
+BUILD_CMD="cd web && pnpm install && pnpm build && cd ../server && pnpm install && pnpm build && mkdir -p dist/public && cp -R ../web/dist/. dist/public/"
 # 本 extension 拥有的 Supabase 表(空格分隔,必须 ${NAME}_ 前缀);remove-extension.sh 据此清理
 SUPABASE_TABLES=""
 EOF

package/dist/persona-defaults/persona-app-builder/extension-kit/scripts/publish.sh

@@ -33,6 +33,10 @@ EOF
 chmod 600 ~/.s/access.yaml
 
 # 3) 构建产物(框架相关,由 ext.conf 的 BUILD_CMD 定义)
+# 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.4)：
+# echo ::stage::build 在 if 外，BUILD_CMD 为空时也通知 daemon 进入 build 阶段（即使啥也没构建）。
+# daemon 解析 stdout 命中此 marker 后 broadcast appBuilder:publish-progress 帧推 UI checklist。
+echo "::stage::build"
 if [ -n "$BUILD_CMD" ]; then
   echo "==> build: $BUILD_CMD"
   ( cd "$EXT_DIR" && eval "$BUILD_CMD" )
@@ -57,10 +61,12 @@ sed -e "s|__APP_NAME__|$APP_NAME|g" \
     "$KIT_DIR/contract/s.yaml.tmpl" > "$EXT_DIR/s.yaml"
 
 # 6) 部署
+echo "::stage::deploy"
 echo "==> s deploy ($APP_NAME)"
 ( cd "$EXT_DIR" && s deploy -y )
 
 # 7) 取自定义域名 + 验证
+echo "::stage::verify"
 DOM="$(aliyun fc GET /2023-03-30/custom-domains --region "$REGION" 2>/dev/null | python3 -c "
 import sys,json
 d=json.load(sys.stdin)
@@ -70,9 +76,19 @@ print(m[0] if m else '')")"
 echo ""
 echo "=================================================="
 if [ -n "$DOM" ]; then
+  # daemon runner 优先解析这个 marker 作为 prodUrl（避免抠到 s deploy 中间的 FC system_url
+  # fcapp.run，阿里云对它强制 Content-Disposition: attachment，iframe / 浏览器直访都会变成下载）。
+  # 必须用 custom domain（<app>.fcv3.<accountId>.cn-hangzhou.fc.devsapp.net）。
+  echo "::prod-url::http://$DOM"
   echo "  ✅ 发布完成: http://$DOM"
   echo "=================================================="
-  "$KIT_DIR/scripts/verify.sh" "http://$DOM" || true
+  # verify.sh 失败（非 200 / Content-Disposition）→ exit 非 0，由 set -e 让 publish.sh
+  # 整体失败 → daemon runner 走 publish-failed 路径 + 回灌 chat 让 assistant 接管修复。
+  # 之前的 `|| true` 兜底已去掉，理由：线上挂了 prodUrl 仍写盘 = 老板看到"打开线上"按钮
+  # 但点开 404，不如 fail-loud。
+  "$KIT_DIR/scripts/verify.sh" "http://$DOM"
 else
-  echo "  ⚠️ 部署完成但未取到自定义域名,检查 fc3-domain 是否成功"
+  # 域名没拿到 = 部署本身有问题（fc3-domain 未成功），也算失败
+  echo "❌ 部署完成但未取到自定义域名,检查 fc3-domain 是否成功" >&2
+  exit 1
 fi

package/dist/persona-defaults/persona-app-builder/extension-kit/scripts/verify.sh

@@ -1,6 +1,13 @@
 #!/usr/bin/env bash
 # 发布后健康检查:可达性 + Content-Type + 【是否被强制下载】
 # 用法: verify.sh <url>
+#
+# 失败语义（spec 2026-06-03-app-builder-publish-scaffold-design follow-up）：
+#   首页非 200 / 检测到 Content-Disposition 强制下载 → exit 1。
+#   publish.sh 不加 `|| true` 兜底，verify 失败会让 publish.sh 整体 exit 非 0，
+#   触发 daemon runner 的 publish-failed 路径：广播帧 + 回灌 chat user_text 让 assistant 接管修复。
+#
+# 信息原则：失败原因 echo 到 stderr（runner 的 errorSummary 抠 stderr 最后 20 行）。
 set -euo pipefail
 URL="${1:?用法: verify.sh <url>}"
 
@@ -11,10 +18,21 @@ echo "首页: HTTP $code  ($ctype)"
 
 # 关键检查: 有 Content-Disposition 说明会被浏览器当文件下载(没绑自定义域名的典型症状)
 hdr=$(curl -s -D - -o /dev/null --max-time 30 "$URL/" || true)
+has_cd=0
 if echo "$hdr" | grep -qi 'content-disposition'; then
-  echo "❌ 检测到 Content-Disposition —— 浏览器会下载而非渲染!确认走的是 fc3-domain 自定义域名,而不是 fcapp.run"
+  has_cd=1
+  echo "❌ 检测到 Content-Disposition —— 浏览器会下载而非渲染!确认走的是 fc3-domain 自定义域名,而不是 fcapp.run" >&2
 else
   echo "✓ 无 Content-Disposition,浏览器可正常渲染网页"
 fi
 
-[ "$code" = "200" ] && echo "✓ 全链路 OK" || echo "⚠️ 首页非 200,查 s logs"
+if [ "$code" = "200" ] && [ "$has_cd" = "0" ]; then
+  echo "✓ 全链路 OK"
+  exit 0
+fi
+
+# 失败：原因写 stderr 供 runner 抠成 errorSummary，UI / assistant 都能看清楚
+if [ "$code" != "200" ]; then
+  echo "❌ verify failed: 首页 HTTP $code (期望 200)；查 s logs 找原因" >&2
+fi
+exit 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawos-dev/clawd",
-  "version": "0.2.121",
+  "version": "0.2.122-beta.241.0e144f4",
   "description": "Standalone clawd daemon — Claude Code (and future Codex) session server over WebSocket",
   "type": "module",
   "license": "MIT",