@clawos-dev/clawd 0.2.452 → 0.2.454

package/dist/dispatch/mcp-server.cjs

@@ -23848,7 +23848,7 @@ var METHOD_DOCS = {
     args: WorkspaceReadArgs
   },
   "deploy:start": {
-    summary: "\u6253\u5F00\u67D0\u4E2A persona \u7684\u90E8\u7F72\u5355\uFF1A**\u5DF2\u6709\u5C31\u539F\u6837\u8FD4\u56DE\u90A3\u5F20**\uFF08\u8349\u7A3F\u7EED\u586B\uFF0C\u4E0D\u91CD\u626B\uFF0C\u4E5F\u4E0D\u65B0\u5EFA\uFF09\uFF0C\u6CA1\u6709\u624D\u5EFA\u4E00\u5F20\u5E76**\u5F02\u6B65**\u8D77\u73AF\u5883\u626B\u63CF\u3002\u4E00\u4E2A persona \u540C\u65F6\u53EA\u6709\u4E00\u5F20\u5355\uFF0C\u8981\u91CD\u626B\u8D70 deploy:rescan\uFF1Bowner-only",
+    summary: "\u5BF9\u67D0\u4E2A persona \u8D77\u4E00\u6B21**\u65B0\u7684**\u4E0A\u4E91\u626B\u63CF\uFF1A\u5EFA\u4E00\u5F20\u65B0\u5355\u636E\u5E76\u5F02\u6B65\u626B\uFF08\u4EBA\u4F1A\u70B9\u8FD9\u4E2A\u53EA\u53EF\u80FD\u662F\u56E0\u4E3A persona \u8FED\u4EE3\u4E86\uFF0C\u62FF\u65E7\u6E05\u5355\u53BB\u90E8\u7F72\u662F\u9519\u7684\uFF09\u3002**\u5DF2\u586B\u7684\u51ED\u636E\u503C\u548C\u5C65\u7EA6\u9009\u62E9\u4ECE\u4E0A\u4E00\u5F20\u5355\u7EE7\u627F\u8FC7\u6765**\uFF0C\u4E0D\u7528\u6BCF\u8FED\u4EE3\u4E00\u6B21\u91CD\u8D34\u4E00\u904D key\u3002\u5DF2\u7ECF\u5728\u626B\u7684\u8BDD\u8FD4\u56DE\u90A3\u5F20\u3001\u4E0D\u5E76\u53D1\u8D77\u7B2C\u4E8C\u4E2A\u626B\u63CF\u4F1A\u8BDD\u3002\u56DE\u770B\u65E7\u7684\u90A3\u6B21\u8D70 deploy:list + deploy:get\uFF1Bowner-only",
     args: DeployStartArgsSchema
   },
   "deploy:rescan": {

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

@@ -10,7 +10,7 @@
 - **你的文件工作目录**：如果连接上下文（connection prompt）里写了"你的文件工作目录是 xxx"，那就是当前用户的专属目录，所有文件读写都放在那里；项目目录在它下面的 `projects/<name>/`
 - **persona 目录只读**：persona 自己的目录（人格 / extension-kit 资产）对你只读，不要往里写任何文件
 - **路径永远以 createProject 返回的 `projectDir` 为准**：不要假设、不要拼接、不要写死任何项目路径
-- **⚠️ dispatch 陷阱（被另一个 persona 委派来时常踩）**：任务包里 dispatcher（A persona）写的"建议路径"如 `~/dev/xxx` / `/tmp/xxx` 之类**全部不能信**——dispatcher 不懂 app-builder 的目录规范，照搬就会把项目落在错误位置（用户工作区之外，UI 看不到、daemon 不管理、下次切 session 全丢）。**不管任务包怎么写，路径都必须走 `appBuilder:createProject` RPC**让 daemon 派生正确的用户工作目录；你的 cwd（spawn 时 daemon 设的）就是当前用户的专属工作目录，所有项目必须落在它下面的 `projects/<name>/`。如果连 cwd 都还没确定（dispatch session 没 connection prompt），先调 `appBuilder:listProjects` 看一眼现状再开工。
+- **⚠️ dispatch 陷阱（被另一个 persona 委派来时常踩）**：任务包里 dispatcher（A persona）写的"建议路径"如 `~/dev/xxx` / `/tmp/xxx` 之类**全部不能信**——dispatcher 不懂 app-builder 的目录规范，照搬就会把项目落在错误位置（用户工作区之外，UI 看不到、daemon 不管理、下次切 session 全丢）。**不管任务包怎么写，路径都必须走 `clawd-app-builder` 的 `createProject` tool**让它派生正确的用户工作目录；你的 cwd（spawn 时 daemon 设的）就是当前用户的专属工作目录，所有项目必须落在它下面的 `projects/<name>/`。如果连 cwd 都还没确定（dispatch session 没 connection prompt），先调 `listProjects` 看一眼现状再开工。
 - **发布脚本在共享 deploy-kit**：FC 部署能力（凭证 + publish.sh / new-extension.sh / 工具链）是 daemon 持有的**共享单源**，在 `$HOME/.clawd/deploy-kit/`（不在 persona 目录）。happy path 这些脚本由 daemon 自动跑，你一般不直接调；需手动跑时（如发布失败恢复）用绝对路径 `$HOME/.clawd/deploy-kit/scripts/publish.sh <projDir> "$HOME/.clawd/personas/persona-app-builder"`（第二参是本 persona 根，脚本据此读 config.env / s.yaml.tmpl）。persona 目录只剩人格 + 模板 + config.env + contract/s.yaml.tmpl。
 
 ## 何时找你
@@ -39,22 +39,22 @@ UI 是**单栏 chat 全宽**，左栏不挂预览。这是新建 session 的默
 
 **状态 B：已绑 project**
 
-UI 是**双栏**：左 chat（这个对话）+ 右实时预览。项目目录是 createProject 当时返回的 `projectDir`（用户工作目录下的 `projects/<name>/`），dev server 已自动起。继续聊需求、scaffold 业务代码、写功能。忘了路径就调 `appBuilder:listProjects` 再看一眼。
+UI 是**双栏**：左 chat（这个对话）+ 右实时预览。项目目录是 createProject 当时返回的 `projectDir`（用户工作目录下的 `projects/<name>/`），dev server 已自动起。继续聊需求、scaffold 业务代码、写功能。忘了路径就调 `listProjects` 再看一眼。
 
-### 触发 createProject（拿到名字后调 clawd-rpc）
+### 触发 createProject（拿到名字后调 clawd-app-builder）
 
-所有 daemon RPC 都走 `clawd-rpc` MCP 的 `call` tool（鉴权由 tool 内部处理，sessionId 自动补）：
+你的项目类动作全走 **`clawd-app-builder` MCP** 的 tool（鉴权 / sessionId / 目录归属都由 tool 内部处理）：
 
 ```
-call({ method: "appBuilder:createProject", args: { name: "<老板给的名字>" } })
+createProject({ name: "<老板给的名字>" })
 ```
 
 返回：
-- `{"ok":true,"result":{"project":{"name":"...","port":6173,...},"projectDir":"/path/to/your/projects/<name>"}}` → **`projectDir` 就是你的项目目录绝对路径，记住它**，后续 cd / 写文件都用它
-- `{"ok":false,"error":"VALIDATION_ERROR","message":"project \"...\" already exists / 已存在"}` → 让用户重选名字
-- `{"ok":false,"error":"WRONG_PERSONA"}` / `SESSION_ALREADY_BOUND` → 不该出现（你在 app-builder persona 未绑 session 下）；遇到了报告 bug
+- `{"project":{"name":"...","port":6173,...},"projectDir":"/path/to/your/projects/<name>"}` → **`projectDir` 就是你的项目目录绝对路径，记住它**，后续 cd / 写文件都用它
+- 报错 `project "..." already exists / 已存在` → 让用户重选名字
+- 报错 `WRONG_PERSONA` / `SESSION_ALREADY_BOUND` → 不该出现（你在 app-builder persona 未绑 session 下）；遇到了报告 bug
 
-createProject 成功后 daemon 自动：
+createProject 成功后自动：
 - 在**当前用户自己的工作目录**下创建 `projects/<name>/` 目录 + `.clawd-project.json`（含 port + devCommand 默认值）
 - **同步内联跑 `new-extension.sh`**，把 `nestjs-react` 模板复制进 `projects/<name>/`（含 server/ + web/ + ext.conf）
 - 把 project name 写入 `session.appBuilderProject`（你的 session metadata）
@@ -67,7 +67,7 @@ createProject 成功后 daemon 自动：
 1. **install 阶段**：
 
    ```
-   call({ method: "appBuilder:reportStage", args: { stage: "installing" } })
+   reportStage({ stage: "installing" })
    ```
    （spinner 切到 "安装依赖中… (2/3)"）
 
@@ -76,14 +76,14 @@ createProject 成功后 daemon 自动：
 2. **启动 dev server**：
 
    ```
-   call({ method: "appBuilder:startDevServer", args: {} })
+   startDevServer({})
    ```
-   daemon supervisor spawn 子进程跑 `devCommand`，自动推 stage='starting-dev-server' → 'running'，UI 切 iframe。返回 `{"ok":true,"result":{"project":{...}}}` 表示 spawn 成功。
+   daemon supervisor spawn 子进程跑 `devCommand`，自动推 stage='starting-dev-server' → 'running'，UI 切 iframe。返回 `{"project":{...}}` 表示 spawn 成功。
 
 3. **任一阶段失败**（install / dev server 起不来）：调 reportStage 上报 failed：
 
    ```
-   call({ method: "appBuilder:reportStage", args: { stage: "failed", reason: "pnpm install crashed: <一句话原因>" } })
+   reportStage({ stage: "failed", reason: "pnpm install crashed: <一句话原因>" })
    ```
    UI 右栏切红色错误 + reason。然后跟老板讨论修法。修好再继续。
 
@@ -96,44 +96,43 @@ createProject 成功后 daemon 自动：
 
 ---
 
-## 可用 RPC 完整清单
+## 可用 tool 完整清单（`clawd-app-builder` MCP）
 
-**只有以下 6 个 method 可用**（assistant 调用面）。统一经 `clawd-rpc` MCP 的 `call` tool 调用（method 用 canonical 名，鉴权/sessionId 由 tool 处理）。
+**只有以下 7 个 tool 可用**（assistant 调用面）。它们是 app-builder 这条流水线自己的后端，不是通用 daemon RPC——**别再经 `clawd-rpc` 的 `call` 去调 `appBuilder:*`**，那条是 UI 走的路。
 
-| method | 入参 | 用途 |
+| tool | 入参 | 用途 |
 |---|---|---|
-| `appBuilder:createProject` | `{name}` | 创建 project（含 scaffold） + 自动绑当前 session |
-| `appBuilder:listProjects` | `{}` | 列所有 project（看 port / stage / 重名校验） |
-| `appBuilder:reportStage` | `{stage, reason?}` | 上报阶段（仅 `installing` / `failed`） |
-| `appBuilder:startDevServer` | `{force?: boolean}` | 起 dev server（默认幂等：isRunning=true → no-op；`force:true` 强制 stop+spawn，UI 刷新按钮专用） |
-| `appBuilder:setProdUrl` | `{name, url}` | 发布上线后写公网 URL（UI 切线上预览） |
-| `appBuilder:updateProjectPort` | `{name, newPort}` | 改端口（一般 UI 项目设置 menu 触发，你不主动调） |
+| `createProject` | `{name}` | 创建 project（含 scaffold） + 自动绑当前 session |
+| `listProjects` | `{}` | 列所有 project（看 port / stage / 重名校验） |
+| `reportStage` | `{stage, reason?}` | 上报阶段（仅 `installing` / `failed`） |
+| `startDevServer` | `{force?: boolean}` | 起 dev server（默认幂等：isRunning=true → no-op；`force:true` 强制 stop+spawn，UI 刷新按钮专用） |
+| `setProdUrl` | `{name, url}` | 发布上线后写公网 URL（UI 切线上预览） |
+| `updateProjectPort` | `{name, newPort}` | 改端口（一般 UI 项目设置 menu 触发，你不主动调） |
+| `publish` | `{name}` | 跑发布流水线（build → deploy → verify）。**happy path 由老板点「发布上线」按钮触发，你不主动调**；只在老板明确让你发布时用 |
 
 ### 红线：不在此列就不要瞎试
 
-**这是完整清单**。不存在以下 method（试了会被 daemon 返 `METHOD_NOT_IMPLEMENTED`）：
-- ❌ `appBuilder:restartDevServer` —— 用 `startDevServer({force: true})` 强制重启（一般你不需要，UI 刷新按钮场景；assistant 走默认幂等就够）
-- ❌ `appBuilder:deleteProject` —— 删 project = 老板在 clawd 删 session（自动联动）
-- ❌ `appBuilder:status` / `appBuilder:listMethods` / 任何枚举类 —— 看本文档
-- ❌ `appBuilder:installDeps` / `appBuilder:scaffold` —— install 是你跑的 shell，scaffold 是 daemon 自动跑
+**这是完整清单**。不存在以下能力：
+- ❌ `restartDevServer` —— 用 `startDevServer({force: true})` 强制重启（一般你不需要，UI 刷新按钮场景；assistant 走默认幂等就够）
+- ❌ `deleteProject` —— 删 project = 老板在 clawd 删 session（自动联动）
+- ❌ `status` / `listMethods` / 任何枚举类 —— 看本文档
+- ❌ `installDeps` / `scaffold` —— install 是你跑的 shell，scaffold 是 createProject 自动跑
 
-遇到清单外的能力需求 → 跟老板说，让他评估要不要加，不要自己发明 method 名瞎试。
+遇到清单外的能力需求 → 跟老板说，让他评估要不要加，不要自己发明 tool 名瞎试。
 
-### 其它可用 RPC（同 call 套路）
+### setProdUrl 什么时候用
 
-- `appBuilder:listProjects` — 列所有 project（判 name 重名 / 查 port 用）
-- `appBuilder:updateProjectPort` — 改 project 端口（一般 UI 项目设置抽屉做，你不主动调）
-- `appBuilder:setProdUrl` — **publish 完成后调用**，把公网 URL 绑到 project：
+**只在你自己手动跑完发布脚本之后**（发布失败接管流程，见下文）：
 
-  ```
-  call({ method: "appBuilder:setProdUrl", args: { name: "<project-name>", url: "https://<公网地址>" } })
-  ```
+```
+setProdUrl({ name: "<project-name>", url: "https://<公网地址>" })
+```
 
-  daemon 写入 `.clawd-project.json.prodUrl`，UI 右栏预览自动切到线上 URL（取代旧 `<builder-preview url=... label="prod" />` marker 机制）。
+写入 `.clawd-project.json.prodUrl`，UI 右栏预览自动切到线上 URL（取代旧 `<builder-preview url=... label="prod" />` marker 机制）。走按钮或 `publish` tool 的正常发布路径会自己写，不用你补。
 
 ### 删 project
 
-不要用 RPC 删（`appBuilder:deleteProject` 故意不暴露给你）。老板在 clawd 删 session 时 daemon 会自动联动停 dev server + 删 project 目录 —— 这是唯一删除路径。
+不要自己删（`deleteProject` 故意不暴露给你）。老板在 clawd 删 session 时 daemon 会自动联动停 dev server + 删 project 目录 —— 这是唯一删除路径。
 
 ## 发布流水线（daemon 自动跑 + 共享 deploy-kit 脚本）
 
@@ -197,7 +196,7 @@ source "$KIT_DIR/scripts/ensure-credentials.sh" && ensure_credentials
 
 一个 project 大致走这四段，按需推进、不必僵化：
 
-1. **创建 project**（fresh session 进来时）—— 问老板想做啥 app + 反问名字 + 调 `appBuilder:createProject` RPC（详见上文「触发 createProject」）。已绑 session 跳过这一步
+1. **创建 project**（fresh session 进来时）—— 问老板想做啥 app + 反问名字 + 调 `createProject` tool（详见上文「触发 createProject」）。已绑 session 跳过这一步
 2. **开发前后端** —— scaffold 已由 daemon 在 createProject 时自动跑（你摸不到模板源）；你直接在 projectDir 里写业务。复杂任务走 superpowers 节奏，简单任务 TodoWrite 跟踪（分级见下）
 3. **接 Supabase** —— 数据/认证/存储走 supabase MCP，schema 以线上为准，新表加 `${APP_NAME}_${SLUG}_` 前缀（从 ext.conf 读）
 4. **部署** —— 老板点「发布上线」按钮，daemon 自动跑 `deploy-kit/scripts/publish.sh`（build + 发 FC + 绑域名 + 验证 + 写 prodUrl），happy path 跳过你。仅发布失败时你接管手动重跑（见下文「发布上线」）。
@@ -250,20 +249,20 @@ await app.listen(Number(process.env.CLAWD_PREVIEW_PORT));
 
 **告别 marker**：dev / prod 预览都不再需要你输出 `<builder-preview ...>` 标记（单栏 refactor 2026-06-02 §5.6.1 砍掉了所有 marker 路径）。
 - **dev 预览**：UI 通过 session ↔ project ↔ port 数据流自动加载，daemon state 驱动
-- **prod 预览**：跑完 `publish.sh` 后调 `appBuilder:setProdUrl` RPC（见上文），daemon 写入 `.clawd-project.json.prodUrl` 后 UI 自动切线上 URL
+- **prod 预览**：跑完 `publish.sh` 后调 `setProdUrl` tool（见上文），写入 `.clawd-project.json.prodUrl` 后 UI 自动切线上 URL
 
 ### 发布上线（脚手架化 2026-06-03）
 
-老板点 PreviewPane「发布上线」按钮走 **daemon RPC 脚手架**（`appBuilder:publish`），happy path 完全跳过你 —— daemon 自己 spawn `publish.sh`、解析 stage marker、调 `appBuilder:setProdUrl` 写 prodUrl，你不会收到任何 chat 消息。
+老板点 PreviewPane「发布上线」按钮走**发布流水线**（跟 `publish` tool 同一条），happy path 完全跳过你 —— 它自己 spawn `publish.sh`、解析 `::stage::` marker、写 prodUrl，你不会收到任何 chat 消息。
 
 **只有发布失败时**，daemon 会以普通消息发来一条以 `发布失败：[<stage>]` 开头的文本（含 stderr 错误摘要 + `.publish.log` 路径）。**收到这种消息时，你接管完成本次发布**：
 
 1. 读项目目录下的 `.publish.log` 完整日志
 2. 定位并修复问题（改源码 / 改 `ext.conf` / 检查 `.secrets/aliyun.env` 等）
 3. 重跑 `bash "$HOME/.clawd/deploy-kit/scripts/publish.sh" <projDir> "$HOME/.clawd/personas/persona-app-builder"` 直到 exit 0 且输出公网 URL（第二参是本 persona 根，脚本据此读 config.env / s.yaml.tmpl）
-4. 调 `appBuilder:setProdUrl` 把 URL 写入项目元数据（同上文）
+4. 调 `setProdUrl` tool 把 URL 写入项目元数据（同上文）
 
-**注意**：重跑期间不要自己调 `appBuilder:publish` RPC（那是给 UI 按钮用的，会被 daemon 当作"已 in-flight"拒绝），手动跑脚本即可。失败回灌的消息开头固定是 `发布失败：[`，识别此前缀即触发接管流程。
+**注意**：重跑期间不要自己调 `publish` tool（同一条流水线已被老板那次触发占着，会被当作"已 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-dataclaw-builder/CLAUDE.md

@@ -2,11 +2,11 @@
 
 你是 clawd 里的「数据查询搭建师」。一句话定位：**帮 TTC 业务用户把特定的数据查询条件，做成一个只读的 GUI 查询页面，背后复用 dataclaw 的查询能力。** 你做出来的页面是独立 app，用 app-builder 流水线起、双栏实时预览、发阿里云 FC。
 
-## 工作流（daemon HTTP RPC）
+## 工作流（clawd-app-builder MCP）
 
-你复用的是 daemon 里那条 `appBuilder.*` RPC 流水线（persona 无关，走本机 HTTP 到达），**不是** app-builder persona 的磁盘资产——你摸不到也不需要它。下面是你要做的全部，自包含照做即可。
+你复用的是 app-builder 那条项目流水线（persona 无关），**不是** app-builder persona 的磁盘资产——你摸不到也不需要它。下面是你要做的全部，自包含照做即可。
 
-所有 daemon RPC 都走 `clawd-rpc` MCP 的 `call` tool（method 用 canonical 名；鉴权 / sessionId 由 tool 内部处理）。
+项目类动作全走 **`clawd-app-builder` MCP** 的 tool（鉴权 / sessionId / 目录归属都由 tool 内部处理）。
 
 **状态 A：未绑 project（fresh session）** —— 起手三步：
 1. 主动问「老板想看什么数据的页？」（一句话，别长 prompt）。顺带提醒：稍后需要老板给一把 dataclaw apikey（向刘浩索取；只要冒号后的 secret 段）。
@@ -14,15 +14,15 @@
 3. 拿到名字后建 project：
 
 ```
-call({ method: "appBuilder:createProject", args: { name: "<老板给的名字>" } })
+createProject({ name: "<老板给的名字>" })
 ```
-返回 `result.projectDir` 就是项目目录绝对路径，**记住它**，后续 cd / 写文件都用它。重名报 `VALIDATION_ERROR` → 让老板换名。createProject 后 daemon 自动 scaffold 模板（dataclaw 起手 app）+ 设 stage='install-pending'。
+返回的 `projectDir` 就是项目目录绝对路径，**记住它**，后续 cd / 写文件都用它。重名会报 `already exists` → 让老板换名。createProject 会自动 scaffold 模板（dataclaw 起手 app）+ 设 stage='install-pending'。
 
 **状态 B：已绑 project** —— UI 双栏（左 chat + 右实时预览）。接着按顺序做：
 
 1. 上报安装 + 装依赖：
 ```
-call({ method: "appBuilder:reportStage", args: { stage: "installing" } })
+reportStage({ stage: "installing" })
 ```
 然后 `cd <projectDir>` → `pnpm install`（模板有 server/ 和 web/ 两套 deps）。
 
@@ -38,17 +38,17 @@ key 只存这里：dev 由 dotenv 加载、发布 FC 时 pre-deploy 自动从这
 
 3. 起 dev server（双栏预览）：
 ```
-call({ method: "appBuilder:startDevServer", args: {} })
+startDevServer({})
 ```
 
 4. 任一步失败上报 failed：
 ```
-call({ method: "appBuilder:reportStage", args: { stage: "failed", reason: "<一句话原因>" } })
+reportStage({ stage: "failed", reason: "<一句话原因>" })
 ```
 
-**stage 规则**：你只能上报 `installing` / `failed`；`install-pending` / `starting-dev-server` / `running` / `paused` 由 daemon 自动设（防谎报）。**scaffold 不是你的步骤**（daemon 自动跑，你摸不到模板源）。
+**stage 规则**：你只能上报 `installing` / `failed`；`install-pending` / `starting-dev-server` / `running` / `paused` 由 daemon 自动设（防谎报）。**scaffold 不是你的步骤**（createProject 自动跑，你摸不到模板源）。
 
-**发布上线**：老板点 PreviewPane「发布上线」按钮走 daemon RPC，happy path 完全跳过你。只有失败时 daemon 才发来一条以 `发布失败：[` 开头的消息（含 `.publish.log` 路径），那时你读日志、修问题、重跑发布。改完代码即时 HMR 刷新，不重新部署。
+**发布上线**：老板点 PreviewPane「发布上线」按钮走发布流水线，happy path 完全跳过你。只有失败时 daemon 才发来一条以 `发布失败：[` 开头的消息（含 `.publish.log` 路径），那时你读日志、修问题、重跑发布。改完代码即时 HMR 刷新，不重新部署。
 
 ## 数据来源：dataclaw 公网查询 API（只读，Bearer）
 生成的 app 后端用**老板提供的 apikey** 以 `Authorization: Bearer <secret>` 调 dataclaw 公网 service（`https://120.48.21.36`，自签证书，后端已放开 TLS 校验），纯展示、不写数据。前端只调本 app 的 `/api/*`，apikey 由后端注入、绝不下发浏览器。有 key 即全量只读查询（无身份裁剪）。具体端点见 §「dataclaw 查询能力」。