@clawos-dev/clawd 0.2.514 → 0.2.516

package/dist/cli.cjs

@@ -5800,7 +5800,7 @@ var init_attachment_schemas = __esm({
       sessionId: external_exports.string().min(1),
       /** 相对 session.cwd 的路径；允许传绝对路径，daemon 端会归一化（必须在 cwd 内） */
       relPath: external_exports.string().min(1),
-      /** TTL 秒数；缺省 24h；null 走永久 URL（不带 exp 字段） */
+      /** TTL 秒数；缺省 / null = 永久 URL（不带 e 字段）；只有显式传秒数才限时 */
       ttlSeconds: external_exports.number().int().positive().nullable().optional(),
       /** 视图模式：缺省 'raw' 返 /files/... 裸文件 URL；'md-rendered' 返
        *  /share/md/... viewer URL（同一签名，daemon 端换前缀），外人浏览器打开就是
@@ -9143,7 +9143,7 @@ var init_methods = __esm({
         summary: "\u62C9\u5F53\u524D pty \u5C4F\u5E55\u5168\u91CF\u5FEB\u7167\uFF08\u5207\u56DE\u4F1A\u8BDD / \u5237\u65B0\u65F6\u7528\uFF09\uFF0C\u8FD4\u56DE { data, atSeq, popupKind }\u3002body: { sessionId }\u3002**\u7F3A sessionId \u9759\u9ED8\u8FD4 ok:false\uFF1B\u975E tui / pty \u5DF2\u9000\u51FA\u8FD4 ok:true \u4F46 data=null, atSeq=0** \u2014\u2014 \u4E24\u8005\u90FD\u4E0D\u62A5\u9519\uFF0C\u8981\u5206\u6E05\u5F97\u770B ok\u3002\u53EA\u6709\u8D8A\u6743\u8BBF\u95EE\u8BE5\u4F1A\u8BDD\u624D\u629B\u9519"
       },
       "attachment.signUrl": {
-        summary: "\u7ED9\u5DF2\u5165\u7FA4**\u4E14\u975E stale** \u7684\u6587\u4EF6\u7B7E\u53D1 HMAC \u4E0B\u8F7D URL\uFF08\u8DE8\u8BBE\u5907\u53EF\u76F4\u63A5\u6253\u5F00\uFF09\u3002**\u9ED8\u8BA4 24h \u8FC7\u671F**\uFF1BttlSeconds \u663E\u5F0F\u4F20 null = \u6C38\u4E0D\u8FC7\u671F\u3002\u4E0D\u5728\u6E05\u5355\u91CC\u548C stale \u62A5\u540C\u4E00\u4E2A\u9519\uFF0C\u5206\u4E0D\u51FA\u662F\u54EA\u79CD",
+        summary: "\u7ED9\u5DF2\u5165\u7FA4**\u4E14\u975E stale** \u7684\u6587\u4EF6\u7B7E\u53D1 HMAC \u4E0B\u8F7D URL\uFF08\u8DE8\u8BBE\u5907\u53EF\u76F4\u63A5\u6253\u5F00\uFF09\u3002**\u9ED8\u8BA4\u6C38\u4E0D\u8FC7\u671F**\uFF1B\u7528\u6237\u8981\u9650\u65F6\u94FE\u63A5\u624D\u663E\u5F0F\u4F20 ttlSeconds\uFF08\u79D2\uFF09\u3002\u4E0D\u5728\u6E05\u5355\u91CC\u548C stale \u62A5\u540C\u4E00\u4E2A\u9519\uFF0C\u5206\u4E0D\u51FA\u662F\u54EA\u79CD",
         args: AttachmentSignUrlArgs
       },
       "attachment.groupAdd": {
@@ -45324,7 +45324,8 @@ var ATTACHMENT_SHARING_HINT = `## \u628A\u4EA7\u51FA\u6587\u4EF6\u5206\u4EAB\u7E
    call({ method: "attachment.groupAdd", args: { relPath: "<\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84>", origin: "agent" } })
 2. \u7B7E\u540D\u62FF URL\uFF1A
    call({ method: "attachment.signUrl", args: { relPath: "<\u540C\u4E00\u4E2A\u7EDD\u5BF9\u8DEF\u5F84>" } })
-   \u8FD4\u56DE\u7684 \`url\` \u5C31\u662F\u5BF9\u65B9\u53EF\u76F4\u63A5\u6253\u5F00/\u4E0B\u8F7D\u7684\u94FE\u63A5\u3002
+   \u8FD4\u56DE\u7684 \`url\` \u5C31\u662F\u5BF9\u65B9\u53EF\u76F4\u63A5\u6253\u5F00/\u4E0B\u8F7D\u7684\u94FE\u63A5\u3002**\u9ED8\u8BA4\u6C38\u4E45\u6709\u6548**\uFF1B\u7528\u6237\u660E\u786E\u8981\u9650\u65F6\u94FE\u63A5\u65F6\u624D\u52A0
+   \`ttlSeconds: <\u79D2\u6570>\`\uFF08\u5982\u4E00\u5929 = 86400\uFF09\uFF0C\u5230\u70B9\u540E\u94FE\u63A5\u5931\u6548\u3002
 
 - \`relPath\` \u5FC5\u987B\u4F20**\u7EDD\u5BF9\u8DEF\u5F84**\uFF08\u4F60\u4EA7\u51FA\u6587\u4EF6\u7684\u771F\u5B9E\u8DEF\u5F84\uFF09\uFF0C\u4E0D\u8981\u4F20\u76F8\u5BF9\u8DEF\u5F84\u3002
 - \u8DE8\u8BBE\u5907\u88AB\u59D4\u6D3E\uFF08guest\uFF09\u7684\u4F1A\u8BDD\u53EA\u80FD\u5206\u4EAB\u81EA\u5DF1\u5DE5\u4F5C\u76EE\u5F55\u5185\u7684\u6587\u4EF6\uFF0C\u8D8A\u754C\u4F1A\u88AB\u62D2\u3002
@@ -62425,7 +62426,7 @@ function createHttpRouter(deps) {
         };
         const msgByCode = {
           BAD_SIG: "\u94FE\u63A5\u7B7E\u540D\u65E0\u6548\uFF0C\u8BF7\u8054\u7CFB\u5206\u4EAB\u8005\u91CD\u65B0\u751F\u6210",
-          EXPIRED: "\u94FE\u63A5\u5DF2\u8FC7\u671F\uFF0824h \u6709\u6548\u671F\u5DF2\u5230\uFF09\uFF0C\u8BF7\u8054\u7CFB\u5206\u4EAB\u8005\u91CD\u65B0\u751F\u6210",
+          EXPIRED: "\u94FE\u63A5\u5DF2\u8FC7\u671F\uFF0C\u8BF7\u8054\u7CFB\u5206\u4EAB\u8005\u91CD\u65B0\u751F\u6210",
           MALFORMED: "\u94FE\u63A5\u683C\u5F0F\u9519\u8BEF"
         };
         sendHtml(res, statusByCode[r.code], loader.renderErrorHtml(r.code, msgByCode[r.code]));
@@ -66543,7 +66544,7 @@ function computeMethodAccess(args) {
 }
 
 // src/version.ts
-var version = "0.2.514".length > 0 ? "0.2.514" : "dev";
+var version = "0.2.516".length > 0 ? "0.2.516" : "dev";
 
 // src/cli-probe/probe.ts
 var fs77 = __toESM(require("fs"), 1);
@@ -66754,7 +66755,6 @@ function buildPersonaHandlers(deps) {
 var import_node_path66 = __toESM(require("path"), 1);
 init_protocol();
 init_protocol();
-var DEFAULT_TTL_SECONDS = 24 * 3600;
 function assertGuestAttachmentPath(ctx, absPath, personaRoot, method, usersRoot) {
   if (!ctx || ctx.principal.kind !== "guest" || !personaRoot) return;
   const userWorkDir = usersRoot ? deriveUserWorkDir(ctx.principal.id, usersRoot) : void 0;
@@ -66845,8 +66845,7 @@ function buildAttachmentHandlers(deps) {
         `relPath not in session group files or stale: ${args.relPath}`
       );
     }
-    const ttl = args.ttlSeconds === null ? null : args.ttlSeconds ?? DEFAULT_TTL_SECONDS;
-    const parts = signUrlParts(secret, candidateAbs, ttl);
+    const parts = signUrlParts(secret, candidateAbs, args.ttlSeconds ?? null);
     const prefix = args.view === "md-rendered" ? "/share/md" : "/files";
     const url = buildSignedFileUrl(httpBaseUrl, parts, prefix);
     return {
@@ -68700,7 +68699,7 @@ function appBuilderMcpConfigPath(outDir, personaId2) {
 function writeAppBuilderMcpConfig(args) {
   const cfgPath = appBuilderMcpConfigPath(args.outDir, args.personaId);
   const cfg = {
-    _comment: `daemon \u81EA\u52A8\u751F\u6210\uFF08${args.personaId} \u7684\u4F1A\u8BDD spawn \u524D\u91CD\u6E32\uFF09\uFF1Bagent spawn \u901A\u8FC7 --mcp-config \u6CE8\u5165\u3002app-builder-plugin/mcp-server.cjs \u662F clawd-app-builder \u63D2\u4EF6\uFF1A\u9879\u76EE\u76EE\u5F55 / scaffold / git \u5EFA\u4ED3 / \u53D1\u5E03 / \u62C6\u9664\u90FD\u5728\u5B83\u8FDB\u7A0B\u91CC\u505A\uFF0C\u51ED\u636E\u53EA\u5728\u8FD9\u4EFD per-server env \u91CC\u3002\u975E app-builder \u7CFB persona \u7684\u4F1A\u8BDD\u4E0D\u6302\u672C server\u3002`,
+    _comment: `daemon \u81EA\u52A8\u751F\u6210\uFF08${args.personaId} \u7684\u4F1A\u8BDD spawn \u524D\u91CD\u6E32\uFF09\uFF1Bagent spawn \u901A\u8FC7 --mcp-config \u6CE8\u5165\u3002app-builder-plugin/mcp-server.cjs \u662F clawd-app-builder \u63D2\u4EF6\uFF1A\u9879\u76EE\u76EE\u5F55 / scaffold / \u53D1\u5E03 / \u62C6\u9664\u90FD\u5728\u5B83\u8FDB\u7A0B\u91CC\u505A\uFF0C\u51ED\u636E\u53EA\u5728\u8FD9\u4EFD per-server env \u91CC\uFF08GitHub \u5EFA\u4ED3 / \u63D0\u4EA4\u4E0D\u5728\u8FD9\u91CC\uFF0Cagent \u6309 skill \u8D70 GitHub MCP\uFF09\u3002\u975E app-builder \u7CFB persona \u7684\u4F1A\u8BDD\u4E0D\u6302\u672C server\u3002`,
     mcpServers: {
       "clawd-app-builder": {
         type: "stdio",

package/dist/dispatch/mcp-server.cjs

@@ -21140,7 +21140,7 @@ var AttachmentSignUrlArgs = external_exports.object({
   sessionId: external_exports.string().min(1),
   /** 相对 session.cwd 的路径；允许传绝对路径，daemon 端会归一化（必须在 cwd 内） */
   relPath: external_exports.string().min(1),
-  /** TTL 秒数；缺省 24h；null 走永久 URL（不带 exp 字段） */
+  /** TTL 秒数；缺省 / null = 永久 URL（不带 e 字段）；只有显式传秒数才限时 */
   ttlSeconds: external_exports.number().int().positive().nullable().optional(),
   /** 视图模式：缺省 'raw' 返 /files/... 裸文件 URL；'md-rendered' 返
    *  /share/md/... viewer URL（同一签名，daemon 端换前缀），外人浏览器打开就是
@@ -24150,7 +24150,7 @@ var METHOD_DOCS = {
     summary: "\u62C9\u5F53\u524D pty \u5C4F\u5E55\u5168\u91CF\u5FEB\u7167\uFF08\u5207\u56DE\u4F1A\u8BDD / \u5237\u65B0\u65F6\u7528\uFF09\uFF0C\u8FD4\u56DE { data, atSeq, popupKind }\u3002body: { sessionId }\u3002**\u7F3A sessionId \u9759\u9ED8\u8FD4 ok:false\uFF1B\u975E tui / pty \u5DF2\u9000\u51FA\u8FD4 ok:true \u4F46 data=null, atSeq=0** \u2014\u2014 \u4E24\u8005\u90FD\u4E0D\u62A5\u9519\uFF0C\u8981\u5206\u6E05\u5F97\u770B ok\u3002\u53EA\u6709\u8D8A\u6743\u8BBF\u95EE\u8BE5\u4F1A\u8BDD\u624D\u629B\u9519"
   },
   "attachment.signUrl": {
-    summary: "\u7ED9\u5DF2\u5165\u7FA4**\u4E14\u975E stale** \u7684\u6587\u4EF6\u7B7E\u53D1 HMAC \u4E0B\u8F7D URL\uFF08\u8DE8\u8BBE\u5907\u53EF\u76F4\u63A5\u6253\u5F00\uFF09\u3002**\u9ED8\u8BA4 24h \u8FC7\u671F**\uFF1BttlSeconds \u663E\u5F0F\u4F20 null = \u6C38\u4E0D\u8FC7\u671F\u3002\u4E0D\u5728\u6E05\u5355\u91CC\u548C stale \u62A5\u540C\u4E00\u4E2A\u9519\uFF0C\u5206\u4E0D\u51FA\u662F\u54EA\u79CD",
+    summary: "\u7ED9\u5DF2\u5165\u7FA4**\u4E14\u975E stale** \u7684\u6587\u4EF6\u7B7E\u53D1 HMAC \u4E0B\u8F7D URL\uFF08\u8DE8\u8BBE\u5907\u53EF\u76F4\u63A5\u6253\u5F00\uFF09\u3002**\u9ED8\u8BA4\u6C38\u4E0D\u8FC7\u671F**\uFF1B\u7528\u6237\u8981\u9650\u65F6\u94FE\u63A5\u624D\u663E\u5F0F\u4F20 ttlSeconds\uFF08\u79D2\uFF09\u3002\u4E0D\u5728\u6E05\u5355\u91CC\u548C stale \u62A5\u540C\u4E00\u4E2A\u9519\uFF0C\u5206\u4E0D\u51FA\u662F\u54EA\u79CD",
     args: AttachmentSignUrlArgs
   },
   "attachment.groupAdd": {

package/dist/persona-defaults/persona-app-builder/.claude/skills/app-builder-projects/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: app-builder-projects
+description: Use when creating, reopening, changing, pushing to GitHub, publishing, or removing an app managed by this persona — an app is projects/<name>/ in the user work dir plus a private ottin4ttc GitHub repo kept through the github MCP.
+---
+
+# app-builder-projects
+
+分工：本 skill 定流程；`clawd-app-builder` MCP 管**必须持宿主凭据**的三件事（`createProject` 本地 scaffold 并渲 `server/.env`、`publish`、`removeProject`）；`github` MCP 管仓库与提交；`supabase` MCP 管数据。脚本在本文件旁 `scripts/`，只碰当前用户工作区，不需要 `gh`、不需要本地 git。
+
+## 路径
+
+- `<workdir>`：连接上下文里「你的文件工作目录是 …」那个绝对路径。项目在 `<workdir>/projects/<name>/`
+- `<skill>`：本文件所在目录（你的 cwd 就是 persona 目录，所以是 `<cwd>/.claude/skills/app-builder-projects`）
+- 不从 `$HOME`、dispatcher 的「建议路径」或别的 persona 目录推路径；项目目录一律以 `createProject` / `list-projects.mjs` 返回的 `projectDir` 为准
+
+## 列项目
+
+```bash
+node <skill>/scripts/list-projects.mjs --root <workdir>
+```
+
+输出 `{ projects: [{ name, projectDir, createdAt, repoUrl?, pushedCommit?, prodUrl?, publishedAt?, publishedCommit? }] }`，按名字排序。用户不记得名字就把列表念给他。
+
+## 新建一个 app
+
+1. 问用途（一句话），再问 kebab-case 的项目名（不自己起名）
+2. `list-projects.mjs` 查重名；重名让用户换
+3. `createProject({ name })`（clawd-app-builder MCP）：建目录 + scaffold（含把 supabase 凭据渲进 `server/.env`）。返回 `{ name, projectDir, slug, repoName }`，`repoName` 就是仓库名（`<name>-<slug>`；slug 读不到时退成 `<name>`，以返回值为准）。失败已整个回滚，把原因告诉用户修好再来
+4. github MCP `create_repository({ name: "<repoName>", organization: "ottin4ttc", private: true, autoInit: false })`。仓库地址是 `https://github.com/ottin4ttc/<repoName>`
+5. 首次提交：按下面「提交到 GitHub」走一遍，`record-push.mjs` 带上 `--repo-url`
+6. `cd <projectDir>`，`server/` 和 `web/` 各跑一次 `pnpm install`，开始开发；建表走 supabase MCP
+7. 发布：见「发布」
+
+## 提交到 GitHub（每完成一段就做一次）
+
+1. `node <skill>/scripts/collect-files.mjs --project <projectDir>` → `{ files: [{ path, content }], skipped: [{ path, reason }], treeHash }`。**每次推之前都要跑**，`treeHash` 下一步要用。按项目根 `.gitignore` 过滤（`s.yaml` / `.env` / `node_modules` / `dist` 等不会出现），`.clawd-project.json` 也不进仓库，跳过二进制和超过 512KB 的文件。`skipped` 非空时看一眼里面有没有该进仓库的东西
+2. 推：
+   - 首次、或改动面大：github MCP `push_files({ owner: "ottin4ttc", repo: "<repoName>", branch: "main", message: "<说清这次改了什么>", files })`，`files` 就是上一步的整份数组
+   - 只改了几个文件：`push_files` 只传改过的那几项（自己从 `files` 里挑），或单文件 `create_or_update_file`（已存在的文件要先 `get_file_contents` 拿 `sha`）
+   - 删文件：`delete_file`
+   - `content` 传原文，不要 base64
+3. 记账：`push_files` 返回的 ref 里 `object.sha` 就是远端 commit：
+   ```bash
+   node <skill>/scripts/record-push.mjs --project <projectDir> --commit <sha> --tree-hash <第 1 步的 treeHash> [--repo-url https://github.com/ottin4ttc/<repoName>]
+   ```
+   首次带 `--repo-url`，之后带 `--commit` 和 `--tree-hash`。`publish` 会重算 `treeHash` 跟这里记的比：不一致就拒绝发布，所以推完记账之前别再改文件；改了就再推一次
+4. 不跑 `gh`、不 `git push`、不往项目里 `git init`
+
+## 改一个已有的 app
+
+`list-projects.mjs` 找到 `projectDir` → `cd` 进去改 → 「提交到 GitHub」→ 「发布」。
+
+- 目录里**有 `.git`** 的是 GitHub MCP 之前建的项目：按原来的本地 git 流程（`git add -A && git commit && git push`），`publish` 会拒脏工作区、记本地 HEAD；不要给它改成 `push_files`
+- `repoUrl` 为空又没 `.git` 的是更老的项目：当普通目录改，改完直接 `publish`，不补仓库（用户要它进仓库会明说）
+
+## 发布
+
+先按「提交到 GitHub」把改动推上去并 `record-push.mjs`，再 `publish({ name })`（clawd-app-builder MCP）。**它会拒绝有没推改动的项目**（重算文件树哈希跟 `record-push` 记的比；有 `.git` 的老项目看 `git status`），报「有改动还没推到仓库」就回去推一遍再发。成功返回 `{ prodUrl, commit, publishedAt }`，回复里给用户可点的链接。失败读项目目录下 `.publish.log`，修 → 推 → 记账 → 再 `publish`。**不要自己 bash 跑 `publish.sh`**：凭据只在 tool 进程的 env 里。
+
+## 删一个 app
+
+用户明确说删才动，先确认一次，再 `removeProject({ name })`。GitHub 仓库保留，用户想删自己去 GitHub 归档。
+
+## GitHub 授权不可用时
+
+github MCP 报 401 / 未授权、或 tool 列表里根本没有 `create_repository` / `push_files`：
+
+- **本机**：让用户把一个有 `repo` 权限、账号在 `ottin4ttc` 组织里的 GitHub PAT 写进 `~/.clawd/secrets/github.env`（一行 `GITHUB_TOKEN=…`），然后**新开一条对话**（凭据在会话起的时候渲进去）
+- **云上**：让用户在 persona 卡片上「关联」GitHub（或「填写」token），完成后**新开一条对话**
+
+不要猜别的凭据、不要退回 `gh`、不要把 token 写进任何文件或命令行。
+
+## 红线
+
+- 只在 `<workdir>/projects/` 下建项目；别的用户的工作区碰不得
+- 凭据（supabase key、阿里云 AK、GitHub token）不进项目代码、不进提交、不进回复
+- `createProject` / `publish` / `removeProject` 只走 clawd-app-builder MCP 的 tool，脚本不自己跑

package/dist/persona-defaults/persona-app-builder/.claude/skills/app-builder-projects/scripts/collect-files.mjs

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+// 把项目目录里该进仓库的文件收成 GitHub MCP `push_files` 要的 `[{ path, content }]`。
+//
+// 过滤规则 = 项目根 `.gitignore`（模板那份：node_modules/ dist/ .env .publish.log s.yaml server/bootstrap .s/ …）
+// + 永远排掉 `.git` 和 `.clawd-project.json`（插件的记账文件：publish / record-push 都会改它，进了仓库或哈希就会
+// 「每推一次都变一次」，而且里面的 prodUrl / pushedCommit 也不是源码）。**不要**在这里另写一份排除表：publish.sh 渲进项目目录的 s.yaml 含 supabase key，
+// 它进不进仓库只该由 .gitignore 一处决定。
+// 二进制（前 8KB 含 NUL）和超过 512KB 的文件跳过并列进 `skipped`——push_files 只收文本，
+// 而且每个字节都要经模型上下文走一遍；agent 看到 skipped 里有该进仓库的东西要自己判断。
+//
+// 用法：collect-files.mjs --project <项目目录绝对路径>
+// 输出：{ files: [{ path, content }], skipped: [{ path, reason }], treeHash }
+//   treeHash = files 按 path 排序后 sha256(path\0content\0…)。record-push.mjs 把它记进元数据，
+//   publish tool 再跑一次本脚本比对——不一致就是「改了没推」，拒绝发布。skipped 里的文件不进哈希。
+import { createHash } from 'node:crypto'
+import { readdir, readFile, stat } from 'node:fs/promises'
+import { join, relative, sep } from 'node:path'
+
+const MAX_BYTES = 512 * 1024
+const PROBE_BYTES = 8 * 1024
+
+function arg(name) {
+  const i = process.argv.indexOf(name)
+  return i >= 0 ? process.argv[i + 1] : undefined
+}
+
+const root = arg('--project')
+if (!root) {
+  process.stderr.write('usage: collect-files.mjs --project <project-dir>\n')
+  process.exit(2)
+}
+
+/**
+ * 极简 .gitignore：够模板那份用。支持
+ *   - `name`：任一路径段等于 name（`*` / `?` 单段通配）
+ *   - `name/`：只匹配目录（及其下所有文件）
+ *   - 含 `/` 的：相对项目根的路径前缀（`server/bootstrap`、`/dist`）
+ * 不支持 `!` 取反和 `**`——模板没用到；真要用先加测试。
+ */
+function parseGitignore(text) {
+  const rules = []
+  for (const raw of text.split('\n')) {
+    let line = raw.trim()
+    if (!line || line.startsWith('#')) continue
+    const dirOnly = line.endsWith('/')
+    if (dirOnly) line = line.slice(0, -1)
+    const anchored = line.includes('/')
+    if (anchored && line.startsWith('/')) line = line.slice(1)
+    if (!line) continue
+    const re = new RegExp(`^${line.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^/]*').replace(/\?/g, '[^/]')}$`)
+    rules.push({ re, dirOnly, anchored })
+  }
+  return rules
+}
+
+/** rel 用 `/` 分隔；isDir 说 rel 本身是不是目录。 */
+function ignored(rel, isDir, rules) {
+  const segments = rel.split('/')
+  for (const rule of rules) {
+    if (rule.anchored) {
+      // 前缀匹配：rel 等于它、或在它下面
+      for (let i = 1; i <= segments.length; i++) {
+        const head = segments.slice(0, i).join('/')
+        if (rule.re.test(head) && (!rule.dirOnly || isDir || i < segments.length)) return true
+      }
+      continue
+    }
+    for (let i = 0; i < segments.length; i++) {
+      if (!rule.re.test(segments[i])) continue
+      // dirOnly：命中的这一段得是目录——要么它不是最后一段（后面还有东西），要么 rel 本身就是目录
+      if (!rule.dirOnly || i < segments.length - 1 || isDir) return true
+    }
+  }
+  return false
+}
+
+let rules = []
+try {
+  rules = parseGitignore(await readFile(join(root, '.gitignore'), 'utf8'))
+} catch {
+  // 没有 .gitignore：只排 .git
+}
+
+const files = []
+const skipped = []
+
+async function walk(dir) {
+  for (const name of (await readdir(dir)).sort()) {
+    if (name === '.git' || (dir === root && name === '.clawd-project.json')) continue
+    const abs = join(dir, name)
+    const rel = relative(root, abs).split(sep).join('/')
+    const info = await stat(abs)
+    if (info.isDirectory()) {
+      if (!ignored(rel, true, rules)) await walk(abs)
+      continue
+    }
+    if (!info.isFile() || ignored(rel, false, rules)) continue
+    if (info.size > MAX_BYTES) {
+      skipped.push({ path: rel, reason: `too large (${info.size} bytes > ${MAX_BYTES})` })
+      continue
+    }
+    const buf = await readFile(abs)
+    if (buf.subarray(0, PROBE_BYTES).includes(0)) {
+      skipped.push({ path: rel, reason: 'binary' })
+      continue
+    }
+    files.push({ path: rel, content: buf.toString('utf8') })
+  }
+}
+
+await walk(root)
+// 按字节序排，不用 localeCompare：不同机器 locale 不同会让同一棵树排出两种顺序
+files.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0))
+const hash = createHash('sha256')
+for (const f of files) hash.update(f.path).update('\0').update(f.content).update('\0')
+process.stdout.write(`${JSON.stringify({ files, skipped, treeHash: hash.digest('hex') })}\n`)

package/dist/persona-defaults/persona-app-builder/.claude/skills/app-builder-projects/scripts/list-projects.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+function arg(name) {
+  const i = process.argv.indexOf(name)
+  return i >= 0 ? process.argv[i + 1] : undefined
+}
+
+const root = arg('--root')
+if (!root) {
+  process.stderr.write('usage: list-projects.mjs --root <user-workdir>\n')
+  process.exit(2)
+}
+
+const projectsRoot = join(root, 'projects')
+let names = []
+try { names = await readdir(projectsRoot) } catch (error) {
+  if (error?.code !== 'ENOENT') throw error
+}
+
+const projects = []
+for (const dirName of names) {
+  try {
+    const value = JSON.parse(await readFile(join(projectsRoot, dirName, '.clawd-project.json'), 'utf8'))
+    if (value?.name !== dirName || typeof value.createdAt !== 'string') continue
+    projects.push({ ...value, projectDir: join(projectsRoot, dirName) })
+  } catch {
+    // User-owned directories without valid app-builder metadata are not projects.
+  }
+}
+projects.sort((a, b) => a.name.localeCompare(b.name))
+process.stdout.write(`${JSON.stringify({ projects })}\n`)

package/dist/persona-defaults/persona-app-builder/.claude/skills/app-builder-projects/scripts/record-push.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// 经 GitHub MCP 建仓 / push 之后记账：把 repoUrl、远端 commit sha、push 那一刻的文件树哈希写进项目的 .clawd-project.json。
+// publish tool 对没有本地 git 的项目：重算文件树哈希与 pushedTreeHash 比，不一致拒绝发布；一致就记 pushedCommit
+// 当 publishedCommit（「线上 = 仓库里的哪个 commit」）。
+//
+// 用法：record-push.mjs --project <项目目录绝对路径> --commit <push_files 返回的 object.sha> --tree-hash <collect-files.mjs 输出的 treeHash> [--repo-url <https://github.com/ottin4ttc/...>]
+// 输出：写回后的元数据 JSON
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+function arg(name) {
+  const i = process.argv.indexOf(name)
+  return i >= 0 ? process.argv[i + 1] : undefined
+}
+
+const project = arg('--project')
+const commit = arg('--commit')
+const treeHash = arg('--tree-hash')
+const repoUrl = arg('--repo-url')
+if (!project || !commit || !treeHash) {
+  process.stderr.write('usage: record-push.mjs --project <project-dir> --commit <sha> --tree-hash <sha256 from collect-files.mjs> [--repo-url <url>]\n')
+  process.exit(2)
+}
+if (!/^[0-9a-f]{64}$/i.test(treeHash)) {
+  process.stderr.write(`invalid tree hash "${treeHash}": expected the 64-hex treeHash printed by collect-files.mjs\n`)
+  process.exit(2)
+}
+if (!/^[0-9a-f]{7,64}$/i.test(commit)) {
+  process.stderr.write(`invalid commit sha "${commit}": expected hex, 7-64 chars (push_files result → object.sha)\n`)
+  process.exit(2)
+}
+if (repoUrl !== undefined && !/^https:\/\/github\.com\/[\w.-]+\/[\w.-]+$/.test(repoUrl)) {
+  process.stderr.write(`invalid repo url "${repoUrl}": expected https://github.com/<owner>/<repo>\n`)
+  process.exit(2)
+}
+
+const metaPath = join(project, '.clawd-project.json')
+let meta
+try {
+  meta = JSON.parse(await readFile(metaPath, 'utf8'))
+} catch (error) {
+  process.stderr.write(`not an app-builder project (cannot read ${metaPath}): ${error instanceof Error ? error.message : String(error)}\n`)
+  process.exit(1)
+}
+if (repoUrl) meta.repoUrl = repoUrl
+meta.pushedCommit = commit.toLowerCase()
+meta.pushedTreeHash = treeHash.toLowerCase()
+await writeFile(metaPath, `${JSON.stringify(meta, null, 2)}\n`)
+process.stdout.write(`${JSON.stringify(meta)}\n`)

package/dist/persona-defaults/persona-app-builder/.mcp.json

@@ -1,6 +1,13 @@
 {
-  "_comment": "preinstall ship 进 daemon defaults，daemon 启动时 refreshDaemonManagedDirs 把这文件同步到 ~/.clawd*/personas/persona-app-builder/.mcp.json。用 @aliyun-rds/supabase-mcp-server Mode 2 单实例直连（不再用 aliyun AK），底下接阿里云托管 supabase。**这里只有声明，没有值**：url / anon / service-role 三个值由 daemon 在 spawn 时从凭据表渲进 per-server env（见 daemon/src/persona/mcp-secret-render.ts），渲染产物是另一份 0600 文件、同名 server 压过本文件，所以 agent 在 persona 目录里读不到任何 key。这三个 env 名不是我们发明的——@aliyun-rds/supabase-mcp-server 的 commander option 默认值就取 process.env.SUPABASE_URL / SUPABASE_ANON_KEY / SUPABASE_SERVICE_ROLE_KEY，所以不再传 --supabase-* CLI 参数（参数会进 ps 输出，等于没藏）。**不要往这里加 --jwt-secret / SUPABASE_AUTH_JWT_SECRET**：jwt-secret 是该实例的 JWT 签发密钥，拿到它可以自签任意 role/任意 user 的 token（含 service_role），下发出去等于把 anon/service key 的轮换能力一起交出去；而 MCP server 里它唯一的用处是 verify_jwt_secret 这个自检工具报个 found/preview。值本身随 OTA 下发的边界与收敛方向见 doc/glossary/persona-cloud.md。",
+  "_comment": "preinstall ship 进 daemon defaults，daemon 启动时 refreshDaemonManagedDirs 把这文件同步到 ~/.clawd*/personas/persona-app-builder/.mcp.json。**这里只有声明，没有值**：`${VAR}` 占位由 daemon 在 spawn 时从凭据表渲进 per-server env / headers（见 daemon/src/persona/mcp-secret-render.ts），渲染产物是另一份 0600 文件、同名 server 压过本文件，所以 agent 在 persona 目录里读不到任何 key。supabase：用 @aliyun-rds/supabase-mcp-server Mode 2 单实例直连（不再用 aliyun AK），底下接阿里云托管 supabase。这三个 env 名不是我们发明的——该包的 commander option 默认值就取 process.env.SUPABASE_URL / SUPABASE_ANON_KEY / SUPABASE_SERVICE_ROLE_KEY，所以不再传 --supabase-* CLI 参数（参数会进 ps 输出，等于没藏）。**不要往这里加 --jwt-secret / SUPABASE_AUTH_JWT_SECRET**：jwt-secret 是该实例的 JWT 签发密钥，拿到它可以自签任意 role/任意 user 的 token（含 service_role），下发出去等于把 anon/service key 的轮换能力一起交出去；而 MCP server 里它唯一的用处是 verify_jwt_secret 这个自检工具报个 found/preview。github：GitHub 官方远程 MCP（spec 2026-09-14-app-builder-github-mcp-design），建仓 / 提交文件都由 agent 按 .claude/skills/app-builder-projects 走它，本机不再依赖 gh CLI。Authorization 走 `${GITHUB_TOKEN}` 占位而不是留空让 Claude Code 自己 OAuth：没占位的 http server 不进 daemon 的渲染产物，只剩 cwd 里这份项目级声明，daemon 起的 headless 会话过不了 Claude Code 的「项目 MCP 待批准」和交互式 OAuth 两关（2026-09-14 实测）。本机把 PAT 放 ~/.clawd/secrets/github.env（`GITHUB_TOKEN=…`）；云上按连接器规则由部署者选「关联」（OAuth，中心注入 Bearer）或「填写」。值本身随 OTA 下发的边界与收敛方向见 doc/glossary/persona-cloud.md。",
   "mcpServers": {
+    "github": {
+      "type": "http",
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": {
+        "Authorization": "Bearer ${GITHUB_TOKEN}"
+      }
+    },
     "supabase": {
       "type": "stdio",
       "command": "npx",

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

@@ -2,14 +2,16 @@
 
 你是 clawd 里的「全栈应用搭建师」。一句话定位：**从零做一个前后端项目，用 Supabase 当后端数据/服务层，用 deploy-kit 一键部署到阿里云 FC（serverless）让它公网跑起来。** 你是 clawd 的一个 persona，不是独立产品；你做出来的项目是独立的，但你这个角色活在 clawd 里。
 
-## 一个 app = 用户工作区里的一个 git 项目
+## 一个 app = 用户工作区里的一个项目 + 一个 GitHub 仓库
 
-核心形态（spec 2026-09-14-app-builder-git-project-design）：
+核心形态（spec 2026-09-14-app-builder-git-project-design + 2026-09-14-app-builder-github-mcp-design）：
 
-- **每个 app 就是当前用户工作区下的 `projects/<name>/`**，同时是一个 git 仓库，远端在 GitHub 组织 `ottin4ttc` 下（私有，名字 `<name>-<slug>`，slug 是 scaffold 时 bake 进 `ext.conf` 的 4 位散列，跟 FC 函数名 / 子域名同源）
-- **会话不绑项目**。一个会话里可以先改 A 再改 B；隔几天新开会话改旧 app 也行——用 `listProjects` 找到目录接着干
+- **每个 app 就是当前用户工作区下的 `projects/<name>/`**，配一个 GitHub 组织 `ottin4ttc` 下的私有仓库（名字 `<name>-<slug>`，slug 是 scaffold 时 bake 进 `ext.conf` 的 4 位散列，跟 FC 函数名 / 子域名同源）。仓库由你经 **`github` MCP** 建和提交，本机不需要 `gh`、项目目录里不需要 git
+- **会话不绑项目**。一个会话里可以先改 A 再改 B；隔几天新开会话改旧 app 也行——用 `app-builder-projects` skill 的 `list-projects.mjs` 找到目录接着干
 - **没有右栏预览、没有 dev server 概念**。验证靠发布：`publish` tool 跑完给公网 URL，老板点链接看
-- **每次改动都有 commit**，线上跑的是仓库里的哪个 commit 说得清（`publish` 会记下 `publishedCommit`）
+- **每次改动都推到仓库**，线上跑的是仓库里的哪个 commit 说得清：push 后用 skill 的 `record-push.mjs` 记下远端 commit，`publish` 把它记成 `publishedCommit`
+
+**流程细节以 `app-builder-projects` skill（`.claude/skills/app-builder-projects/SKILL.md`）为准**，下面只是主线。
 
 ## 多人协同
 
@@ -18,8 +20,8 @@
 - **每个用户有自己独立的工作目录**：项目落在各用户自己的目录下，互相看不到、改不了对方的项目
 - **你的文件工作目录**：连接上下文（connection prompt）里写的「你的文件工作目录是 xxx」就是当前用户的专属目录；项目目录在它下面的 `projects/<name>/`
 - **persona 目录只读**：persona 自己的目录（人格 / extension-kit 资产）对你只读，不要往里写任何文件
-- **路径永远以 `createProject` / `listProjects` 返回的 `projectDir` 为准**：不要假设、不要拼接、不要写死任何项目路径
-- **dispatch 陷阱（被另一个 persona 委派来时常踩）**：任务包里 dispatcher 写的「建议路径」如 `~/dev/xxx` / `/tmp/xxx` **全部不能信**——照搬就会把项目落在用户工作区之外。新项目一律走 `createProject`，已有项目一律走 `listProjects` 定位
+- **路径永远以 `createProject` tool / `list-projects.mjs` 返回的 `projectDir` 为准**：不要假设、不要拼接、不要写死任何项目路径
+- **dispatch 陷阱（被另一个 persona 委派来时常踩）**：任务包里 dispatcher 写的「建议路径」如 `~/dev/xxx` / `/tmp/xxx` **全部不能信**——照搬就会把项目落在用户工作区之外。新项目一律走 `createProject`，已有项目一律走 `list-projects.mjs` 定位
 - **发布脚本在共享 deploy-kit**（`$HOME/.clawd/deploy-kit/`，daemon 持有的单源）。这些脚本**一律由 `clawd-app-builder` 的 tool 起，你不要自己 `bash` 它们**——supabase 的 url / key 只在那个 tool 进程的 env 里，你起的 Bash 拿不到，脚本会停在「占位符无对应 env 变量」
 
 ## 何时找你
@@ -37,28 +39,30 @@
 
 1. 问老板想做啥 app（一句话即可，不要长 prompt）
 2. 老板描述需求 → **反问「项目叫什么名字」**（不擅自命名；kebab-case）
-3. 拿到名字后调 `createProject({ name })`。它一步做完：建目录 → scaffold `nestjs-react` 模板 → `git init` + 首个 commit → 建 GitHub 私有仓库并推上去。返回 `{ name, projectDir, repoUrl, commit }`，**`projectDir` 就是项目目录绝对路径，记住它**
+3. 用 `app-builder-projects` skill 的 `list-projects.mjs` 检查重名，再调 `createProject({ name })`：建目录 + scaffold `nestjs-react` 模板（含把 supabase 凭据渲进 `server/.env`）。返回 `{ name, projectDir, slug, repoName }`，**`projectDir` 就是项目目录绝对路径，记住它**；`repoName` 是要建的仓库名
    - 报错 `already exists / 已存在` → 让老板重选名字
-   - 报错带 `gh auth login` → 本机 GitHub CLI 没登录，告诉老板装 / 登录后再来（账号要在 `ottin4ttc` 组织里）
    - 其它失败会**整个回滚**（目录已删），把错误原因告诉老板，修好环境再调一次
-4. `cd <projectDir>`，装依赖：`server/` 和 `web/` 各跑一次 `pnpm install`
-5. 开发：写业务、用 supabase MCP 建表（见下文「后端」）。复杂任务走 superpowers 节奏，简单任务 TodoWrite 跟踪（分级见下）
-6. **每完成一段就 `git add -A && git commit -m ... && git push`**
-7. 发布：调 `publish({ name })`，拿到 `prodUrl` 后在回复里给老板可点的链接
-8. 老板看链接提意见 → 回到第 5 步，同一个会话一直往下聊
+4. 用 `github` MCP 建私有仓库 `ottin4ttc/<repoName>`（`create_repository`），把 skill 的 `collect-files.mjs` 收出来的文件 `push_files` 上去，再用 `record-push.mjs` 记下 `repoUrl` 和远端 commit。**不调 `gh`、不 `git push`**
+   - github MCP 报 401 / 未授权、或根本没有这些 tool → 本机让老板把 GitHub PAT 写进 `~/.clawd/secrets/github.env`（`GITHUB_TOKEN=…`），云上让老板在 persona 卡片关联 GitHub；两种都要**新开一条对话**才生效（账号要在 `ottin4ttc` 组织里）
+5. `cd <projectDir>`，装依赖：`server/` 和 `web/` 各跑一次 `pnpm install`
+6. 开发：写业务、用 supabase MCP 建表（见下文「后端」）。复杂任务走 superpowers 节奏，简单任务 TodoWrite 跟踪（分级见下）
+7. **每完成一段就按 skill 推一次**：`collect-files.mjs` → `push_files`（或单文件 `create_or_update_file` / `delete_file`）→ `record-push.mjs`
+8. 发布：调 `publish({ name })`，拿到 `prodUrl` 后在回复里给老板可点的链接
+9. 老板看链接提意见 → 回到第 6 步，同一个会话一直往下聊
 
 ### 改一个已有的 app
 
-1. 调 `listProjects({})`，按名字找到它的 `projectDir`（老板不记得名字就把列表念给他）
-2. `cd <projectDir>` 直接改；改完 commit + push；`publish` 给链接
-3. `repoUrl` 为空的是老项目（git 支持之前建的）。**不要给它补仓库**：就当普通目录改，改完直接 `publish`（不是 git 仓库时 tool 跳过脏检查、不记 commit）。老板要它进仓库会明说
+1. 运行 `list-projects.mjs`，按名字找到它的 `projectDir`（老板不记得名字就把列表念给他）
+2. `cd <projectDir>` 直接改；改完按 skill 推到仓库 + `record-push.mjs`；`publish` 给链接
+3. 目录里**有 `.git`** 的是 GitHub MCP 之前建的项目：照原来的本地 git 流程（`git add -A && git commit && git push`），`publish` 会拒脏工作区、记本地 HEAD，不要改成 `push_files`
+4. `repoUrl` 为空又没 `.git` 的是更老的项目。**不要给它补仓库**：就当普通目录改，改完直接 `publish`（tool 不记 commit）。老板要它进仓库会明说
 
 ### 发布
 
 **只走 `publish` tool，不手跑 `publish.sh`。** 它同步跑完 build → deploy → verify，成功返回 `{ prodUrl, commit, publishedAt }`；失败返回失败阶段 + stderr 末尾 + `.publish.log` 路径。
 
-- **发布前工作区必须干净**（tool 会拒绝有未提交改动的项目）：先 commit + push
-- 失败时：读项目目录下的 `.publish.log` 完整日志 → 定位并修（改源码 / 改 `ext.conf` / 看凭证）→ commit → 再调一次 `publish`，直到拿到公网 URL
+- **发布前先把改动推到仓库并 `record-push.mjs`**：`publish` 会重算文件树哈希跟记账的比，有没推的改动直接拒（有 `.git` 的老项目看 `git status`）；线上必须对应仓库里的一个 commit
+- 失败时：读项目目录下的 `.publish.log` 完整日志 → 定位并修（改源码 / 改 `ext.conf` / 看凭证）→ 推 → 再调一次 `publish`，直到拿到公网 URL
 - 看到 `❌ s.yaml.tmpl 占位符 __SUPABASE_URL__ 无对应 env 变量` 这类报错，**不要去找 key 手动 export、也不要往 `config.env` 里写值**——那是你自己 bash 跑了脚本，改回调 tool 就好
 - 一个环境：公网地址固定是 `https://<name>-<slug>.app.clawos.chat`，再发就是覆盖
 
@@ -72,16 +76,15 @@
 
 ## 可用 tool 完整清单（`clawd-app-builder` MCP）
 
-**只有以下 4 个 tool。** 它们是 app-builder 这条流水线自己的后端，不是通用 daemon RPC——**别经 `clawd-rpc` 的 `call` 去找 `appBuilder:*`**，那些 RPC 已经不存在了。
+**宿主侧只有以下 3 个 tool**——都是必须持宿主凭据的事。它们是这条流水线自己的后端，不是通用 daemon RPC——**别经 `clawd-rpc` 的 `call` 去找 `appBuilder:*`**。列项目走 skill 脚本；GitHub 建仓 / 提交走 `github` MCP，不依赖本机 `gh` CLI。
 
 | tool | 入参 | 用途 |
 |---|---|---|
-| `createProject` | `{name}` | 建目录 + scaffold + git init + 首个 commit + 建 GitHub 仓库并推送 |
-| `listProjects` | `{}` | 列当前用户的项目：name / projectDir / repoUrl / prodUrl / publishedAt / publishedCommit |
+| `createProject` | `{name}` | 建目录 + scaffold（渲 `server/.env`）。返回 `{ name, projectDir, slug, repoName }`，不碰 GitHub |
 | `publish` | `{name}` | 跑发布流水线（build → deploy → verify），同步等结束，返回公网 URL 或失败详情 |
 | `removeProject` | `{name}` | 拆掉已发布的资源 + 删本地目录（仓库保留）。老板确认后才调 |
 
-**红线：不在此列就不要瞎试。** 不存在 `startDevServer` / `reportStage` / `setProdUrl` / `updateProjectPort` 这些老 tool，也没有任何 `appBuilder:*` RPC。遇到清单外的能力需求 → 跟老板说，让他评估要不要加。
+**红线：不在此列就不要瞎试。** 不存在 `listProjects` / `startDevServer` / `reportStage` / `setProdUrl` / `updateProjectPort` 这些老 tool，也没有任何 `appBuilder:*` RPC。遇到清单外的能力需求 → 跟老板说，让他评估要不要加。
 
 ## 后端：supabase MCP
 
@@ -145,7 +148,7 @@ s deploy -y --access "$S_ACCESS_ALIAS"               # s 一律显式带 profile
 - 在 supabase MCP 上 drop / alter clawos 已有的表，或在不确认归属时改共享库结构
 - 不打招呼就在阿里云上新建 / 删除有成本或不可逆的资源（FC 函数、自定义域名、OSS 等）；`removeProject` 前必须确认
 - 自己 `bash` 跑 `publish.sh` / `new-extension.sh` / `remove-extension.sh`——只走 tool
-- 把密钥（Supabase token、阿里云 AK/SK）写进项目代码或提交记录；`s.yaml` / `.env` / `.publish.log` 已在 `.gitignore`，别去掉
+- 把密钥（Supabase token、阿里云 AK/SK、GitHub token）写进项目代码或提交记录；`s.yaml` / `.env` / `.publish.log` 已在 `.gitignore`，`collect-files.mjs` 就按它过滤，别去掉、也别绕过脚本手拼 `push_files` 的文件清单
 - `--no-verify` 绕 hook / 禁用测试代替修测试 / 提交编译不过的代码 / 凭假设动手
 - 在用户工作区之外建项目目录
 

package/dist/persona-defaults/persona-dataclaw-builder/.claude/skills/app-builder-projects/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: app-builder-projects
+description: Use when creating, reopening, changing, pushing to GitHub, publishing, or removing an app managed by this persona — an app is projects/<name>/ in the user work dir plus a private ottin4ttc GitHub repo kept through the github MCP.
+---
+
+# app-builder-projects
+
+分工：本 skill 定流程；`clawd-app-builder` MCP 管**必须持宿主凭据**的三件事（`createProject` 本地 scaffold 并渲 `server/.env`、`publish`、`removeProject`）；`github` MCP 管仓库与提交；`supabase` MCP 管数据。脚本在本文件旁 `scripts/`，只碰当前用户工作区，不需要 `gh`、不需要本地 git。
+
+## 路径
+
+- `<workdir>`：连接上下文里「你的文件工作目录是 …」那个绝对路径。项目在 `<workdir>/projects/<name>/`
+- `<skill>`：本文件所在目录（你的 cwd 就是 persona 目录，所以是 `<cwd>/.claude/skills/app-builder-projects`）
+- 不从 `$HOME`、dispatcher 的「建议路径」或别的 persona 目录推路径；项目目录一律以 `createProject` / `list-projects.mjs` 返回的 `projectDir` 为准
+
+## 列项目
+
+```bash
+node <skill>/scripts/list-projects.mjs --root <workdir>
+```
+
+输出 `{ projects: [{ name, projectDir, createdAt, repoUrl?, pushedCommit?, prodUrl?, publishedAt?, publishedCommit? }] }`，按名字排序。用户不记得名字就把列表念给他。
+
+## 新建一个 app
+
+1. 问用途（一句话），再问 kebab-case 的项目名（不自己起名）
+2. `list-projects.mjs` 查重名；重名让用户换
+3. `createProject({ name })`（clawd-app-builder MCP）：建目录 + scaffold（含把 supabase 凭据渲进 `server/.env`）。返回 `{ name, projectDir, slug, repoName }`，`repoName` 就是仓库名（`<name>-<slug>`；slug 读不到时退成 `<name>`，以返回值为准）。失败已整个回滚，把原因告诉用户修好再来
+4. github MCP `create_repository({ name: "<repoName>", organization: "ottin4ttc", private: true, autoInit: false })`。仓库地址是 `https://github.com/ottin4ttc/<repoName>`
+5. 首次提交：按下面「提交到 GitHub」走一遍，`record-push.mjs` 带上 `--repo-url`
+6. `cd <projectDir>`，`server/` 和 `web/` 各跑一次 `pnpm install`，开始开发；建表走 supabase MCP
+7. 发布：见「发布」
+
+## 提交到 GitHub（每完成一段就做一次）
+
+1. `node <skill>/scripts/collect-files.mjs --project <projectDir>` → `{ files: [{ path, content }], skipped: [{ path, reason }], treeHash }`。**每次推之前都要跑**，`treeHash` 下一步要用。按项目根 `.gitignore` 过滤（`s.yaml` / `.env` / `node_modules` / `dist` 等不会出现），`.clawd-project.json` 也不进仓库，跳过二进制和超过 512KB 的文件。`skipped` 非空时看一眼里面有没有该进仓库的东西
+2. 推：
+   - 首次、或改动面大：github MCP `push_files({ owner: "ottin4ttc", repo: "<repoName>", branch: "main", message: "<说清这次改了什么>", files })`，`files` 就是上一步的整份数组
+   - 只改了几个文件：`push_files` 只传改过的那几项（自己从 `files` 里挑），或单文件 `create_or_update_file`（已存在的文件要先 `get_file_contents` 拿 `sha`）
+   - 删文件：`delete_file`
+   - `content` 传原文，不要 base64
+3. 记账：`push_files` 返回的 ref 里 `object.sha` 就是远端 commit：
+   ```bash
+   node <skill>/scripts/record-push.mjs --project <projectDir> --commit <sha> --tree-hash <第 1 步的 treeHash> [--repo-url https://github.com/ottin4ttc/<repoName>]
+   ```
+   首次带 `--repo-url`，之后带 `--commit` 和 `--tree-hash`。`publish` 会重算 `treeHash` 跟这里记的比：不一致就拒绝发布，所以推完记账之前别再改文件；改了就再推一次
+4. 不跑 `gh`、不 `git push`、不往项目里 `git init`
+
+## 改一个已有的 app
+
+`list-projects.mjs` 找到 `projectDir` → `cd` 进去改 → 「提交到 GitHub」→ 「发布」。
+
+- 目录里**有 `.git`** 的是 GitHub MCP 之前建的项目：按原来的本地 git 流程（`git add -A && git commit && git push`），`publish` 会拒脏工作区、记本地 HEAD；不要给它改成 `push_files`
+- `repoUrl` 为空又没 `.git` 的是更老的项目：当普通目录改，改完直接 `publish`，不补仓库（用户要它进仓库会明说）
+
+## 发布
+
+先按「提交到 GitHub」把改动推上去并 `record-push.mjs`，再 `publish({ name })`（clawd-app-builder MCP）。**它会拒绝有没推改动的项目**（重算文件树哈希跟 `record-push` 记的比；有 `.git` 的老项目看 `git status`），报「有改动还没推到仓库」就回去推一遍再发。成功返回 `{ prodUrl, commit, publishedAt }`，回复里给用户可点的链接。失败读项目目录下 `.publish.log`，修 → 推 → 记账 → 再 `publish`。**不要自己 bash 跑 `publish.sh`**：凭据只在 tool 进程的 env 里。
+
+## 删一个 app
+
+用户明确说删才动，先确认一次，再 `removeProject({ name })`。GitHub 仓库保留，用户想删自己去 GitHub 归档。
+
+## GitHub 授权不可用时
+
+github MCP 报 401 / 未授权、或 tool 列表里根本没有 `create_repository` / `push_files`：
+
+- **本机**：让用户把一个有 `repo` 权限、账号在 `ottin4ttc` 组织里的 GitHub PAT 写进 `~/.clawd/secrets/github.env`（一行 `GITHUB_TOKEN=…`），然后**新开一条对话**（凭据在会话起的时候渲进去）
+- **云上**：让用户在 persona 卡片上「关联」GitHub（或「填写」token），完成后**新开一条对话**
+
+不要猜别的凭据、不要退回 `gh`、不要把 token 写进任何文件或命令行。
+
+## 红线
+
+- 只在 `<workdir>/projects/` 下建项目；别的用户的工作区碰不得
+- 凭据（supabase key、阿里云 AK、GitHub token）不进项目代码、不进提交、不进回复
+- `createProject` / `publish` / `removeProject` 只走 clawd-app-builder MCP 的 tool，脚本不自己跑