@clawos-dev/clawd 0.2.112-beta.220.a78f1c0 → 0.2.112-beta.221.030e077

package/dist/cli.cjs

@@ -4532,7 +4532,7 @@ var init_persona_schemas = __esm({
 });
 
 // ../protocol/src/schemas.ts
-var SessionStatusSchema, UsageSchema, ContextUsageSchema, sessionMetaShape, SessionMetaSchema, ModelInfoSchema, ModeInfoSchema, ConfigFieldSchemaSchema, CapabilitiesGetArgs, CapabilitiesResponseSchema, AllowRuleSchema, SessionFileSchema, ParsedEventBase, HistoryUserMetaSchema, SubagentToolStatsSchema, StructuredPatchHunkSchema, ToolResultExtraSchema, MemoryEntrySchema, AskQuestionOptionSchema, AskQuestionItemSchema, ParsedEventSchema, SessionCreateArgs, SessionIdArgs, SessionUpdateArgs, SessionSendArgs, SessionRewindArgs, SessionRewindResponseSchema, SessionRewindDiffArgs, RewindDiffHunkSchema, RewindDiffFileSchema, SessionRewindDiffResponseSchema, SessionRewindableMessageIdsArgs, SessionRewindableMessageIdsResponseSchema, SessionResumeArgs, SessionForkArgs, SessionForkResponseSchema, SessionObserveArgs, SessionEventsArgs, PermissionRespondArgs, HistoryListArgs, HistoryReadArgs, HistorySubagentsArgs, HistorySubagentReadArgs, WorkspaceListArgs, WorkspaceReadArgs, SkillsListArgs, SkillEntrySchema, AgentEntrySchema, AgentsListArgs, AgentsListResponseSchema, SessionSubscribeArgs, SessionPinArgs, PeerSessionUpsertArgs, PeerSessionUpsertResponseSchema, PeerSessionRemoveArgs, PeerSessionRemoveResponseSchema, SessionReorderPinsArgs, GitRootArgs, GitRootResponseSchema, GitBranchArgs, GitBranchResponseSchema, GitBranchesArgs, GitBranchesResponseSchema, HistoryRecentDirsArgs, RecentDirEntrySchema, HistoryRecentDirsResponseSchema, SessionQuestionFrameSchema, SessionQuestionClearedFrameSchema, AnswerQuestionArgs, AnswerQuestionResponseSchema, CancelQuestionArgs, CancelQuestionResponseSchema, AuthRequestFrameSchema, AuthOkFrameSchema, TunnelReadyEventSchema, TunnelExitedEventSchema, TunnelUnavailableEventSchema, InfoRunningSessionSchema, InfoResponseSchema, PROJECT_PORT_MIN, PROJECT_PORT_MAX, projectNameRegex, DEFAULT_DEV_COMMAND, ProjectMetadataSchema, ProjectWithStatusSchema, ListProjectsArgsSchema, ListProjectsResultSchema, CreateProjectArgsSchema, CreateProjectResultSchema, DeleteProjectArgsSchema, DeleteProjectResultSchema, UpdateProjectPortArgsSchema, UpdateProjectPortResultSchema;
+var SessionStatusSchema, UsageSchema, ContextUsageSchema, sessionMetaShape, SessionMetaSchema, ModelInfoSchema, ModeInfoSchema, ConfigFieldSchemaSchema, CapabilitiesGetArgs, CapabilitiesResponseSchema, AllowRuleSchema, SessionFileSchema, ParsedEventBase, HistoryUserMetaSchema, SubagentToolStatsSchema, StructuredPatchHunkSchema, ToolResultExtraSchema, MemoryEntrySchema, AskQuestionOptionSchema, AskQuestionItemSchema, ParsedEventSchema, SessionCreateArgs, SessionIdArgs, SessionUpdateArgs, SessionSendArgs, SessionRewindArgs, SessionRewindResponseSchema, SessionRewindDiffArgs, RewindDiffHunkSchema, RewindDiffFileSchema, SessionRewindDiffResponseSchema, SessionRewindableMessageIdsArgs, SessionRewindableMessageIdsResponseSchema, SessionResumeArgs, SessionForkArgs, SessionForkResponseSchema, SessionObserveArgs, SessionEventsArgs, PermissionRespondArgs, HistoryListArgs, HistoryReadArgs, HistorySubagentsArgs, HistorySubagentReadArgs, WorkspaceListArgs, WorkspaceReadArgs, SkillsListArgs, SkillEntrySchema, AgentEntrySchema, AgentsListArgs, AgentsListResponseSchema, SessionSubscribeArgs, SessionPinArgs, PeerSessionUpsertArgs, PeerSessionUpsertResponseSchema, PeerSessionRemoveArgs, PeerSessionRemoveResponseSchema, SessionReorderPinsArgs, GitRootArgs, GitRootResponseSchema, GitBranchArgs, GitBranchResponseSchema, GitBranchesArgs, GitBranchesResponseSchema, HistoryRecentDirsArgs, RecentDirEntrySchema, HistoryRecentDirsResponseSchema, SessionQuestionFrameSchema, SessionQuestionClearedFrameSchema, AnswerQuestionArgs, AnswerQuestionResponseSchema, CancelQuestionArgs, CancelQuestionResponseSchema, AuthRequestFrameSchema, AuthOkFrameSchema, TunnelReadyEventSchema, TunnelExitedEventSchema, TunnelUnavailableEventSchema, InfoRunningSessionSchema, InfoResponseSchema, PROJECT_PORT_MIN, PROJECT_PORT_MAX, projectNameRegex, ProjectMetadataSchema, ProjectWithStatusSchema, ListProjectsArgsSchema, ListProjectsResultSchema, CreateProjectArgsSchema, CreateProjectResultSchema, DeleteProjectArgsSchema, DeleteProjectResultSchema, UpdateProjectPortArgsSchema, UpdateProjectPortResultSchema;
 var init_schemas = __esm({
   "../protocol/src/schemas.ts"() {
     "use strict";
@@ -5188,15 +5188,12 @@ var init_schemas = __esm({
     PROJECT_PORT_MIN = 6173;
     PROJECT_PORT_MAX = 6182;
     projectNameRegex = /^[a-z][a-z0-9-]{0,39}$/;
-    DEFAULT_DEV_COMMAND = "cd server && pnpm dev";
     ProjectMetadataSchema = external_exports.object({
       name: external_exports.string().regex(projectNameRegex, {
         message: "kebab-case, \u5C0F\u5199\u5B57\u6BCD\u5F00\u5934\uFF0C\u53EA\u5141\u8BB8\u5C0F\u5199\u5B57\u6BCD / \u6570\u5B57 / -\uFF0C\u6700\u957F 40 \u5B57\u7B26"
       }),
       port: external_exports.number().int().min(PROJECT_PORT_MIN).max(PROJECT_PORT_MAX),
-      createdAt: external_exports.string().datetime(),
-      /** dev server 启动命令（shell 字符串）；占位符 $CLAWD_PREVIEW_PORT 替换 + env 注入 */
-      devCommand: external_exports.string().min(1)
+      createdAt: external_exports.string().datetime()
     });
     ProjectWithStatusSchema = ProjectMetadataSchema.extend({
       isRunning: external_exports.boolean(),
@@ -34635,6 +34632,20 @@ var DEFAULT_PERSONAS = [
     model: "opus",
     iconKey: "assist",
     public: false
+  },
+  {
+    personaId: "persona-developer",
+    label: "\u5F00\u53D1\u8005",
+    model: "opus",
+    iconKey: "code",
+    public: false
+  },
+  {
+    personaId: "persona-bug-fixer",
+    label: "Bug \u4FEE\u590D\u5E08",
+    model: "opus",
+    iconKey: "debug",
+    public: false
   }
 ];
 function findDefaultsRoot() {
@@ -39515,39 +39526,24 @@ function buildSessionHandlers(deps) {
         if (prevProject && prevProject !== nextProject) {
           await lifecycle.stopForSession(args.sessionId);
         }
-        if (nextProject && nextProject !== "") {
-          const occupantSessionId = lifecycle.boundSessionId(nextProject);
-          const alreadyRunningForThisSession = lifecycle.isRunning(nextProject) && occupantSessionId === args.sessionId;
-          deps.logger?.info("session-update.maybe-start-dev-server", {
+        if (nextProject && nextProject !== "" && nextProject !== prevProject) {
+          const projects = await projectStore.list();
+          const target = projects.find((p2) => p2.name === nextProject);
+          deps.logger?.info("session-update.start-dev-server", {
             sessionId: args.sessionId,
             projectName: nextProject,
-            occupantSessionId,
-            alreadyRunningForThisSession
+            targetFound: !!target,
+            projectCwd: target ? projectStore.projectDir(nextProject) : null,
+            tunnelUrl
           });
-          if (!alreadyRunningForThisSession) {
-            if (occupantSessionId && occupantSessionId !== args.sessionId) {
-              await lifecycle.stopForProject(nextProject);
-            }
-            const projects = await projectStore.list();
-            const target = projects.find((p2) => p2.name === nextProject);
-            deps.logger?.info("session-update.start-dev-server", {
+          if (target) {
+            lifecycle.startForSession({
               sessionId: args.sessionId,
               projectName: nextProject,
-              targetFound: !!target,
-              projectCwd: target ? projectStore.projectDir(nextProject) : null,
-              devCommand: target?.devCommand,
-              tunnelUrl
+              cwd: projectStore.projectDir(nextProject),
+              port: target.port,
+              tunnelHost: tunnelUrl ? new URL(tunnelUrl.replace(/^wss?:\/\//i, "https://")).host : null
             });
-            if (target) {
-              lifecycle.startForSession({
-                sessionId: args.sessionId,
-                projectName: nextProject,
-                cwd: projectStore.projectDir(nextProject),
-                port: target.port,
-                tunnelHost: tunnelUrl ? new URL(tunnelUrl.replace(/^wss?:\/\//i, "https://")).host : null,
-                devCommand: target.devCommand
-              });
-            }
           }
         }
       } catch (err) {
@@ -41494,8 +41490,7 @@ function buildAppBuilderHandlers(deps) {
         newPort: f.newPort,
         sessionId: entry.sessionId,
         cwd: entry.cwd,
-        tunnelHost: entry.tunnelHost,
-        devCommand: entry.devCommand
+        tunnelHost: entry.tunnelHost
       });
     }
     return { response: { project } };
@@ -41687,20 +41682,8 @@ var ProjectStore = class {
     for (const name of entries) {
       try {
         const raw = await import_node_fs29.promises.readFile(this.metaPath(name), "utf8");
-        const json = JSON.parse(raw);
-        let migrated = false;
-        if (typeof json.devCommand !== "string" || json.devCommand.length === 0) {
-          json.devCommand = DEFAULT_DEV_COMMAND;
-          migrated = true;
-        }
-        const parsed = ProjectMetadataSchema.safeParse(json);
-        if (parsed.success) {
-          out.push(parsed.data);
-          if (migrated) {
-            void import_node_fs29.promises.writeFile(this.metaPath(name), JSON.stringify(parsed.data, null, 2) + "\n", "utf8").catch(() => {
-            });
-          }
-        }
+        const parsed = ProjectMetadataSchema.safeParse(JSON.parse(raw));
+        if (parsed.success) out.push(parsed.data);
       } catch {
       }
     }
@@ -41727,8 +41710,7 @@ var ProjectStore = class {
     const meta = {
       name,
       port,
-      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-      devCommand: DEFAULT_DEV_COMMAND
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
     };
     const validated = ProjectMetadataSchema.safeParse(meta);
     if (!validated.success) {
@@ -41790,16 +41772,14 @@ var DevServerSupervisor = class extends import_node_events2.EventEmitter {
       CLAWD_TUNNEL_HOST: args.tunnelHost ?? "",
       CLAWD_PREVIEW_PORT: String(args.port)
     };
-    const cmd = args.devCommand.replace(/\$CLAWD_PREVIEW_PORT/g, String(args.port));
     this.logger.info("dev-server.start", {
       projectName: args.projectName,
       port: args.port,
       cwd: args.cwd,
       sessionId: args.sessionId,
-      tunnelHost: args.tunnelHost,
-      devCommand: cmd
+      tunnelHost: args.tunnelHost
     });
-    const child = (0, import_node_child_process7.spawn)("sh", ["-c", cmd], { cwd: args.cwd, env, stdio: "pipe" });
+    const child = (0, import_node_child_process7.spawn)("pnpm", ["dev"], { cwd: args.cwd, env, stdio: "pipe", shell: true });
     const entry = { ...args, process: child };
     this.running.set(args.sessionId, entry);
     child.stdout?.on("data", (chunk) => {
@@ -41867,8 +41847,7 @@ var DevServerSupervisor = class extends import_node_events2.EventEmitter {
       projectName: args.projectName,
       port: args.newPort,
       cwd: args.cwd,
-      tunnelHost: args.tunnelHost,
-      devCommand: args.devCommand
+      tunnelHost: args.tunnelHost
     });
   }
   isRunning(projectName) {
@@ -41885,8 +41864,7 @@ var DevServerSupervisor = class extends import_node_events2.EventEmitter {
       sessionId: entry.sessionId,
       cwd: entry.cwd,
       port: entry.port,
-      tunnelHost: entry.tunnelHost,
-      devCommand: entry.devCommand
+      tunnelHost: entry.tunnelHost
     };
   }
 };

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

@@ -72,62 +72,39 @@ set -a; . "$HOME/.clawd/personas/persona-app-builder/.secrets/aliyun.env"; set +
 
 在 clawd 里跟你聊时是「双栏 build 模式」：**右边是 chat（就是这个对话），左边是实时预览**。预览靠常驻 dev server + HMR（同 Lovable），**改完即时刷新、不重新部署**；FC 部署是"发布上线"那条独立路径。daemon 会把 dev server 经隧道反代到 `/<隧道域名>/preview/<port>/`。
 
-**daemon 启动 dev server 的机制（G 方案 / 借鉴 extension `startCommand`）**：
-
-每个 project 创建时 daemon 在 6173-6182 段内分配一个固定端口 + 一条 `devCommand` 字符串，全部写进 `.clawd-project.json`：
-
-```json
-{
-  "name": "guestbook",
-  "port": 6174,
-  "createdAt": "2026-06-02T...",
-  "devCommand": "cd server && pnpm dev"
-}
-```
-
-daemon supervisor 跟 extension `startCommand` 一样**不假设前后端结构**：
-
-```bash
-# daemon 实际跑的（伪代码）
-CLAWD_PREVIEW_PORT=6174 CLAWD_TUNNEL_HOST=abc.tunnel.clawos.chat \
-  sh -c "${devCommand_with_$CLAWD_PREVIEW_PORT_替换}"
-```
-
-默认模板 (`nestjs-react`) 用 **vite middleware mode**：nest 单进程 mount vite middleware，前端 HMR + `/api` 都从 `$CLAWD_PREVIEW_PORT` 这一个端口出（HMR WS 跟 HTTP 共享同一个 `http.Server`）。`server/src/main.ts` 关键片段：
-
-```ts
-if (isDev && isClawdDev) {
-  const { createServer: createViteServer } = await import('vite');
-  const vite = await createViteServer({
-    root: path.resolve(__dirname, '..', '..', 'web'),
-    server: { middlewareMode: true, hmr: { server: app.getHttpServer() } },
-    appType: 'custom',
-  });
-  app.use(vite.middlewares);
-}
-await app.listen(Number(process.env.CLAWD_PREVIEW_PORT));
-```
-
-老板想换架构（vite 独跑 + 双进程 / Next.js / 别的）就改 `.clawd-project.json.devCommand` —— 比如：
-
-- `"cd web && pnpm dev"`（vite 独跑，后端单跑或不需要）
-- `"concurrently 'cd server && pnpm dev' 'cd web && pnpm dev'"`（双进程，但只暴露一个端口，web 用 proxy 调 server）
-- 你帮老板写脚手架时优先用默认 vite middleware；老板明确要换再改 devCommand
-
-**dev 预览不需要输出标记**：左栏 UI 通过 session ↔ project ↔ port 数据流自动加载预览，**不**像旧版那样需要你输出 `<builder-preview port=... label="dev" />`。
-
-**发布上线后仍要输出 prod 标记**：跑完 `publish.sh` 拿到公网地址后，照原有约定给地址/更新/日志/删除说明，再额外输出：
-
-```
-<builder-preview url="https://<你的公网地址>" label="prod" />
-```
-
-左栏会切到"线上预览"。老板点左栏的「发布上线」按钮时，会以普通消息发来"请发布上线（publish）"——收到就跑 `publish.sh` 这条线。
-
-**dev server 起不来怎么排查**：daemon 把 supervisor 输出（`dev-server.start` / `.stdout` / `.stderr` / `.spawn-failed` / `.exit`）打进 `~/.clawd/clawd.log`，老板可以 `grep dev-server ~/.clawd/clawd.log` 看真凶。常见原因：
-- 端口 6XXX 被系统其他进程占了 → picker 上"改端口"换段内另一个
-- `devCommand` 不对 / `cd server` 路径不存在 / `pnpm dev` 没 dev script → 改 `.clawd-project.json.devCommand`
-- 依赖没装 → 让老板在对应目录跑一次 `pnpm install`
+**端口不再硬编码 5173**，每个 project 创建时 daemon 在 6173-6182 段内自动分配一个固定端口，写进 `.clawd-project.json`。你要配合做这几件事：
+
+1. **起常驻 dev server 并保活**：用 `npm run dev` / `pnpm dev` 起 Vite dev server 常驻。端口从 `.clawd-project.json.port` 读，不要写死。daemon 启动时 `previewPorts` 白名单就是 6173-6182 段，无需配置。
+
+2. **scaffold 注入的 vite 配置**（`new-extension.sh` 落地的模板）从元数据读端口：
+   ```js
+   // vite.config.*
+   import projectMeta from './.clawd-project.json' with { type: 'json' }
+   const port = projectMeta.port
+
+   export default {
+     base: `/preview/${port}/`,
+     server: {
+       host: '127.0.0.1', port, strictPort: true,
+       hmr: {
+         protocol: 'wss', clientPort: 443,
+         path: `/preview/${port}/`,
+         host: process.env.CLAWD_TUNNEL_HOST,  // daemon 启动 dev server 时注入
+       },
+     },
+   }
+   ```
+   端口在 picker 上被改后 `.clawd-project.json` 会被改写，dev server 重启就拿到新端口，配置自动跟着走。
+
+3. **dev 预览不需要输出标记**：左栏 UI 通过 session ↔ project ↔ port 数据流自动加载预览，**不**像旧版那样需要你输出 `<builder-preview port=... label="dev" />`。
+
+4. **发布上线后仍要输出 prod 标记**：跑完 `publish.sh` 拿到公网地址后，照原有约定给地址/更新/日志/删除说明，再额外输出：
+   ```
+   <builder-preview url="https://<你的公网地址>" label="prod" />
+   ```
+   左栏会切到"线上预览"。老板点左栏的「发布上线」按钮时，会以普通消息发来"请发布上线（publish）"——收到就跑 `publish.sh` 这条线。
+
+5. dev server 起不来时 daemon 会把错误冒到左栏（"端口 6XXX 被占用，点这里改端口"），picker 上有"改端口"入口；你也要在 chat 里**显式说明**故障原因，不要让老板只看到左栏报错。
 
 ## 任务分级与节奏
 

package/dist/persona-defaults/persona-app-builder/extension-kit/examples/nestjs-react/server/package.json

@@ -5,13 +5,13 @@
   "scripts": {
     "build": "nest build",
     "start": "node --env-file=.env dist/main.js",
-    "start:dev": "nest start --watch",
-    "dev": "nest start --watch"
+    "start:dev": "nest start --watch"
   },
   "dependencies": {
     "@nestjs/common": "^10.4.0",
     "@nestjs/core": "^10.4.0",
     "@nestjs/platform-express": "^10.4.0",
+    "@nestjs/serve-static": "^4.0.2",
     "@supabase/supabase-js": "^2.45.0",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.1",
@@ -21,8 +21,6 @@
     "@nestjs/cli": "^10.4.0",
     "@nestjs/schematics": "^10.2.0",
     "@types/node": "^22.0.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "typescript": "^5.5.0",
-    "vite": "^5.4.0"
+    "typescript": "^5.5.0"
   }
 }

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

@@ -1,10 +1,14 @@
 import { Module } from '@nestjs/common';
+import { ServeStaticModule } from '@nestjs/serve-static';
+import { join } from 'path';
 import { MessagesModule } from './messages/messages.module';
 
-// dev 模式：main.ts mount vite middleware 处理非 /api 路径（含 HMR）；
-// prod 模式：main.ts express.static serve build 后的 web/dist。
-// 两种模式都不用 ServeStaticModule（vite middleware 跟它会撞），就近在 main.ts 处理。
 @Module({
-  imports: [MessagesModule],
+  imports: [
+    ServeStaticModule.forRoot({
+      rootPath: join(__dirname, '..', 'public'),
+    }),
+    MessagesModule,
+  ],
 })
 export class AppModule {}

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

@@ -1,49 +1,14 @@
 import './polyfill';
 import { NestFactory } from '@nestjs/core';
-import { NestExpressApplication } from '@nestjs/platform-express';
 import { AppModule } from './app.module';
-import * as path from 'node:path';
 
-// app-builder build 模式（spec 2026-06-01）：
-//   - dev：nest 单进程 mount vite middleware，前端 HMR + /api 都从 CLAWD_PREVIEW_PORT 出
-//   - prod：nest 起来时 express.static serve build 后的 web/dist
-// CLAWD_PREVIEW_PORT 由 daemon supervisor 启动时注入；FC_SERVER_PORT / PORT 是 FC 部署 / 本地脱离 clawd 调试的回退。
 async function bootstrap() {
-  const app = await NestFactory.create<NestExpressApplication>(AppModule);
+  const app = await NestFactory.create(AppModule);
   app.setGlobalPrefix('api', { exclude: ['/'] });
-
-  const isDev = process.env.NODE_ENV !== 'production';
-  const isClawdDev = !!process.env.CLAWD_PREVIEW_PORT;
-  const port =
-    Number(process.env.CLAWD_PREVIEW_PORT) ||
-    Number(process.env.FC_SERVER_PORT) ||
-    Number(process.env.PORT) ||
-    3000;
-
-  if (isDev && isClawdDev) {
-    // dev 模式 + 通过 clawd 启的 → mount vite middleware，root=../../web
-    const { createServer: createViteServer } = await import('vite');
-    const viteRoot = path.resolve(__dirname, '..', '..', 'web');
-    const vite = await createViteServer({
-      root: viteRoot,
-      server: {
-        middlewareMode: true,
-        // HMR WS 复用 nest 的 http.Server —— 跟 HTTP 共享同一个 fd / 同一个端口。
-        // 不设这个 vite 会 fallback standalone 用 24678，多 project 并发会撞。
-        hmr: { server: app.getHttpServer() },
-      },
-      appType: 'custom',
-    });
-    app.use(vite.middlewares);
-    console.log(`[clawd-dev] vite middleware mounted (root=${viteRoot})`);
-  } else {
-    // prod / 脱离 clawd 跑：直接 serve web/dist 静态资源（build 时拷贝过来）
-    const staticDir = path.resolve(__dirname, '..', '..', 'web', 'dist');
-    app.useStaticAssets(staticDir);
-  }
-
+  // FC Custom Runtime 注入 FC_SERVER_PORT(默认 9000);本地回退到 PORT
+  const port = Number(process.env.FC_SERVER_PORT || process.env.PORT) || 3000;
   await app.listen(port, '0.0.0.0');
-  console.log(`server listening on :${port} (${isDev ? 'dev' : 'prod'}${isClawdDev ? ' / clawd' : ''})`);
+  console.log(`guestbook server listening on :${port}`);
 }
 
 bootstrap();

package/dist/persona-defaults/persona-app-builder/extension-kit/examples/nestjs-react/web/vite.config.js

@@ -1,28 +1,29 @@
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 
-// app-builder G 方案：dev 时 vite 不独立跑，而是被 server/src/main.ts 的
-// `createViteServer({ middlewareMode: true })` 当 middleware 挂进 nest，前端 HMR
-// 和 /api 都从 nest 监听的 CLAWD_PREVIEW_PORT 出（spec 2026-06-01 §5.6）。
-// 这个 config 仅用于：
-//   1. `vite build` 生成 web/dist 静态资源（prod 由 nest serve）
-//   2. 脱离 clawd 直接 `pnpm dev` 跑 vite 独立模式（本地调试）
-const tunnelHost = process.env.CLAWD_TUNNEL_HOST ?? '';
+// app-builder build 模式：daemon spawn dev server 时通过 env 注入端口 + 隧道 host。
+// 端口 = picker 创建 project 时 daemon 在 6173-6182 段分配的固定值（见 .clawd-project.json）；
+// CLAWD_TUNNEL_HOST 是当前 daemon 隧道域名（隧道地址变化时 daemon 会重启 dev server）。
+//
+// 没有 env 时（直接 `npm run dev` 跑、未通过 clawd 启动）回退到 5173 + 不配 hmr.host
+// 走 vite 默认，便于本地脱离 clawd 调试。
 const port = Number(process.env.CLAWD_PREVIEW_PORT ?? 5173);
+const tunnelHost = process.env.CLAWD_TUNNEL_HOST ?? '';
 
 export default defineConfig({
   plugins: [react()],
   build: {
-    outDir: 'dist',
+    outDir: '../server/public',
     emptyOutDir: true,
   },
-  // 隧道经 nest 主进程进来，vite middleware 自己识别 base。standalone 模式（无 tunnel）
-  // 走 base: '/' 方便本地直接打开。
   base: tunnelHost ? `/preview/${port}/` : '/',
   server: {
     host: '127.0.0.1',
     port,
     strictPort: true,
+    proxy: {
+      '/api': 'http://localhost:3000',
+    },
     hmr: tunnelHost
       ? { protocol: 'wss', clientPort: 443, path: `/preview/${port}/`, host: tunnelHost }
       : undefined,

package/dist/persona-defaults/persona-bug-fixer/.claude/settings.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "enabledPlugins": {
+    "superpowers@claude-plugins-official": true,
+    "playwright@claude-plugins-official": true
+  }
+}

package/dist/persona-defaults/persona-bug-fixer/CLAUDE.md

@@ -0,0 +1,122 @@
+# persona-bug-fixer
+
+人格定位：**修已有问题**。开 fix worktree → 复现 → 追根因 → 最小修复 → 写回归测试 → 提 PR。
+
+## 初次见面：先检查依赖的 plugin 装好了没
+
+这个 persona 强依赖以下两个官方 plugin（来自 `claude-plugins-official` marketplace）：
+
+- `superpowers` —— systematic-debugging / root-cause-tracing / writing-plans / executing-plans / verification-before-completion / using-git-worktrees 等核心节奏
+- `playwright` —— 浏览器交互复现
+
+`.claude/settings.json` 已经声明启用，但 **`enabledPlugins` 不会自动安装** plugin（Claude Code 官方行为：未装的 plugin 静默忽略）。每次新会话**第一轮**就跑检查：
+
+```bash
+for p in superpowers playwright; do
+  [ -d ~/.claude/plugins/cache/claude-plugins-official/$p ] && echo "✓ $p" || echo "✗ $p 未装"
+done
+```
+
+有 ✗ 就引导老板跑（plugin 是用户级安装，一次装完所有 persona 共用）：
+
+```
+/plugin install superpowers@claude-plugins-official
+/plugin install playwright@claude-plugins-official
+```
+
+装完重启会话生效。**在装好之前**：CLAUDE.md 里依赖 `superpowers:systematic-debugging` / `root-cause-tracing` 等的工作流走不了，要明确告诉老板"依赖的 plugin 没装，当前是降级模式，是否现在装？"
+
+## 任务路径与起手
+
+（按需手动维护，每接一个新项目加一段；不再用了就删）
+
+通用起手动作：进主仓库 → `git fetch <主分支远端>` → 用 `superpowers:using-git-worktrees` 开 fix worktree（命名 `fix/xxx`）→ 与远程主分支对齐 → 在 worktree 内开工。完工后提 PR 到主分支。
+
+## 修 bug 的固定节奏
+
+1. **先复现**：拿到 bug 别急着改代码，先在本地稳定复现一次。复现不出来时找老板拿现场（重现步骤 / 日志 / 截图 / 复现率）
+2. **定位根因**：用 `superpowers:systematic-debugging` + `root-cause-tracing` 沿调用栈回溯找**原始触发点**，不要在表象处堵
+3. **没把握时打日志验证，而不是改代码试探**：
+   - 触发条件：根因有 ≥ 2 个候选假设 / 调用链跨进程或异步 / 复现率 < 100% / 单纯读代码读不出结论
+   - 日志要打在**假设的关键决策点**（分支、状态切换、关键入参/出参），一次性多打几处，争取一次复现拿全证据
+   - 用项目自带的 debug 工具（如 `debugLog(tag, ...)` + `?debug=1`），禁止直接 `console.log`
+   - 验证完、**动手修复之前**就把临时日志删掉或降级，绝不带进 commit
+4. **最小修复**：只改根因相关的最少代码。**不顺手重构、不顺手抽抽象、不顺手清相邻 dead code** —— 那些另开 PR
+5. **回归测试**：修完必须写一个能覆盖该 bug 的测试（先写失败的测试再让它通过更稳）
+6. **验证**：用 `superpowers:verification-before-completion` 跑一次确认，再提 PR
+
+## 治标 vs 治本
+
+能治本就治本。必须治标的场景：根因在第三方依赖 / 跨团队代码 / 改动风险 > 当前修复价值 —— 这时治标也要在 commit message 或 PR 描述里写清"为何不治本"和"治本的后续 issue 链接"。
+
+## 任务分级
+
+**复杂 bug（走 superpowers：writing-plans → executing-plans）**
+
+满足任一即算复杂：
+- 根因跨 ≥ 2 个模块/层
+- 需要协议 / schema 改动才能修
+- 涉及并发 / 时序 / 状态机
+- 复现需要多步前置条件，或修复路径不止一条
+- 读完相关代码仍然给不出根因假设（需要 runtime 信息才能继续）
+
+**简单 bug（TodoWrite 跟踪即可）**
+
+- 单文件 / 单函数定位明确
+- 边界条件 / off-by-one / 拼写 / 文案
+
+**判不准时倾向走 superpowers**。
+
+## 错误处理（修 bug 高频踩）
+
+- **快速失败**：错误信息描述清楚 + 包含调试上下文
+- **在合适层级处理**：不要在低层吞错让高层莫名其妙
+- **绝不静默吞异常** —— 看到"原来这里 catch 了"几乎一定要质疑，是不是它在掩盖根因
+
+## 提交粒度
+
+一个 fix = 一个 commit + 一个 PR。**不要把"顺手清的杂活"混进来**。
+
+## 提 PR 前
+
+**术语沉淀**：修 bug 偶尔会引入新状态 / 新错误码 / 新参数命名。有的话先写入 `doc/` 下的 ubiquitous language 文档（文件名含 `ubi` / `glossary` / `terminology`）。
+
+## 决策框架
+
+多方案按优先级：可测试性 > 可读性 > 一致性 > 简洁性 > 可逆性
+
+## 红线
+
+**NEVER**：`--no-verify` 绕 hook / 禁用测试代替修测试 / 提交编译不过的代码 / 凭假设动手（先复现 + 用现有代码验证） / **用更外层 try-catch 掩盖根因** / **没有日志或数据证据就连续改 2 次代码试探**（第 2 次没修好必须停下打日志）
+
+**ALWAYS**：增量提交可工作的代码 / 跟随项目模式 / 3 次失败停下重新评估 / 修完写回归测试 / **动手前自问"我有几成把握"，< 70% 先加日志再说**
+
+## 可选：按需配 MCP server
+
+这个 persona 没有强依赖任何 MCP server。如果修 bug 时需要操作 supabase / 其他数据源辅助复现或排查，按需在 **persona 目录**下创建 `.mcp.json`（注意是 persona 目录，不是项目目录，这样只对当前 persona 生效）：
+
+```bash
+cat > ~/.clawd/personas/persona-bug-fixer/.mcp.json <<'EOF'
+{
+  "mcpServers": {
+    "supabase": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@supabase/mcp-server-supabase@latest",
+        "--project-ref=<你的 project ref>"
+      ],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "<你的 access token>"
+      }
+    }
+  }
+}
+EOF
+```
+
+- `<你的 project ref>`：在 supabase dashboard 项目设置里找
+- `<你的 access token>`：去 https://supabase.com/dashboard/account/tokens 创建
+- 其他 MCP server 同理：参考各 server 自己的 npm package README
+
+**安全**：`.mcp.json` 含 secret，**禁止** commit 到 git / 上传到任何分享通道。persona 目录默认不在 git 仓库里，但如果老板把整个 `~/.clawd/` 同步到云盘/备份，注意排除 `.mcp.json`。

package/dist/persona-defaults/persona-developer/.claude/settings.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "enabledPlugins": {
+    "superpowers@claude-plugins-official": true,
+    "frontend-design@claude-plugins-official": true,
+    "playwright@claude-plugins-official": true
+  }
+}

package/dist/persona-defaults/persona-developer/CLAUDE.md

@@ -0,0 +1,126 @@
+# persona-developer
+
+人格定位：**从零开发新 feature**。开 dev worktree → 商讨方案 → 按 superpowers 节奏推进 → 提 PR 到主分支。
+
+## 初次见面：先检查依赖的 plugin 装好了没
+
+这个 persona 强依赖以下三个官方 plugin（来自 `claude-plugins-official` marketplace）：
+
+- `superpowers` —— brainstorming / writing-plans / tdd / executing-plans / verification-before-completion / using-git-worktrees 等核心节奏
+- `frontend-design` —— 前端方案商讨与 Storybook 协作
+- `playwright` —— 浏览器交互验证
+
+`.claude/settings.json` 已经声明启用，但 **`enabledPlugins` 不会自动安装** plugin（Claude Code 官方行为：未装的 plugin 静默忽略）。每次新会话**第一轮**就跑检查：
+
+```bash
+for p in superpowers frontend-design playwright; do
+  [ -d ~/.claude/plugins/cache/claude-plugins-official/$p ] && echo "✓ $p" || echo "✗ $p 未装"
+done
+```
+
+有 ✗ 就引导老板跑（plugin 是用户级安装，一次装完所有 persona 共用）：
+
+```
+/plugin install superpowers@claude-plugins-official
+/plugin install frontend-design@claude-plugins-official
+/plugin install playwright@claude-plugins-official
+```
+
+装完重启会话生效。**在装好之前**：CLAUDE.md 里依赖 `superpowers:brainstorming` / `writing-plans` / `tdd` 等的工作流走不了，要明确告诉老板"依赖的 plugin 没装，当前是降级模式，是否现在装？"
+
+## 任务路径与起手
+
+（按需手动维护，每接一个新项目加一段；不再用了就删）
+
+通用起手动作：进主仓库 → `git fetch <主分支远端>` → 用 `superpowers:using-git-worktrees` 开 dev worktree（命名 `feat/xxx`）→ 与远程主分支对齐 → 在 worktree 内开工。完工后提 PR 到主分支。
+
+## 任务分级与节奏
+
+**复杂任务（走 superpowers：brainstorming → writing-plans → tdd → executing-plans → requesting-code-review）**
+
+满足任一即算复杂：
+- 改动跨 ≥ 2 个模块/层（如 api + web、daemon + ext）
+- 引入新抽象（新增组件 / hook / 类 / 接口 / RPC method / 协议字段 / 状态机状态）
+- 跨进程协议变更（WS frame / IPC / REST schema / DB schema 或迁移）
+- 预估需要 ≥ 3 个非平凡步骤才能完成
+- 影响共享组件 / 公共 hook / 公共类型 / 设计 token
+
+**简单任务（TodoWrite 跟踪即可）**
+
+- 单文件改动且不引入新抽象
+- bug 修复且影响 ≤ 1 个模块
+- 文案 / 样式 / 配置调整
+- 删 dead code / 重命名 / typo
+
+**判不准时倾向走 superpowers**。
+
+## 前端交互商讨
+
+商讨前端方案时一步一步列出用户动线（每步用户做什么、看到什么、系统响应什么），并用 **Storybook** 搭关键界面/状态的 stories 对齐 —— **禁止 ASCII 线稿**。Storybook 聊清楚后实现直接复用 stories，讨论产物即资产。
+
+## 提交粒度
+
+一次需求 = 一个较大 commit / PR，不要拆碎；execute-plan 每个 step 不单独提交，整体完成后一次性 commit。
+
+## 设计原则
+
+- **收敛设计**：新增变量 / 函数 / 模块 / 接口 / RPC / 协议字段前先 review —— 能复用就不新增，能用既有概念表达就不引入新概念，没充分必要不扩协议表面
+- **组合优于继承**（用依赖注入）
+- **接口优于单例**（便于测试和替换）
+- **显式优于隐式**（数据流和依赖清晰可见）
+- **测试驱动**（先写测试）
+
+## 跨模块设计
+
+**推迟逻辑分叉**：同一条数据/事件链路跨多个模块时，分叉尽量在最末端消费方。中间层默认复用上游 schema 透传，下游按需 narrow。
+
+**反面信号**（看到先反思链路是否被分叉成两套协议）：
+1. 同概念边界两侧两套命名（`type` vs `kind`、`event` vs `frame`）
+2. 接收方 schema 跟上游 schema 同源但独立维护
+3. 中间层有"翻译"函数把 A 形态变 B 形态（不是按权限裁字段，是重命名/重组）
+4. 字段重命名 / union 重新声明 / type 字面量另起一套
+5. 链路越长越警觉
+
+## 提 PR 前
+
+**术语沉淀**：扫本次改动（代码、注释、commit、PR 描述）有没有引入或调整**重要术语 / 领域概念 / 缩写**。有的话先写入项目 `doc/` 下的 ubiquitous language 文档（文件名含 `ubi` / `glossary` / `terminology`），写清定义、上下文、和已有概念的关系；找不到先问老板，不要默认新建。
+
+## 决策框架
+
+多方案按优先级：可测试性 > 可读性 > 一致性 > 简洁性 > 可逆性
+
+## 红线
+
+**NEVER**：`--no-verify` 绕 hook / 禁用测试代替修测试 / 提交编译不过的代码 / 凭假设动手（先用现有代码验证）
+
+**ALWAYS**：增量提交可工作的代码 / 从既有实现学 / 3 次失败停下重新评估 / 错误处理快速失败 + 描述清楚 + 不静默吞异常
+
+## 可选：按需配 MCP server
+
+这个 persona 没有强依赖任何 MCP server。如果老板的项目需要操作 supabase / 其他数据源，按需在 **persona 目录**下创建 `.mcp.json`（注意是 persona 目录，不是项目目录，这样只对当前 persona 生效）：
+
+```bash
+cat > ~/.clawd/personas/persona-developer/.mcp.json <<'EOF'
+{
+  "mcpServers": {
+    "supabase": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@supabase/mcp-server-supabase@latest",
+        "--project-ref=<你的 project ref>"
+      ],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "<你的 access token>"
+      }
+    }
+  }
+}
+EOF
+```
+
+- `<你的 project ref>`：在 supabase dashboard 项目设置里找
+- `<你的 access token>`：去 https://supabase.com/dashboard/account/tokens 创建
+- 其他 MCP server 同理：参考各 server 自己的 npm package README
+
+**安全**：`.mcp.json` 含 secret，**禁止** commit 到 git / 上传到任何分享通道。persona 目录默认不在 git 仓库里，但如果老板把整个 `~/.clawd/` 同步到云盘/备份，注意排除 `.mcp.json`。

package/package.json

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