@clawos-dev/clawd 0.2.619 → 0.2.620

package/dist/dispatch/mcp-server.cjs

@@ -25354,10 +25354,8 @@ var CLAUDE_CAPABILITIES = {
       label: "Effort",
       description: "Reasoning effort level",
       scope: "tool-specific",
-      // CC `--effort` 值域（claude --help, 2.1.187）：low / medium / high / xhigh / max。
-      // 2026-08-12：删掉 '' 项（理由同 CLAUDE_MODELS）。default 取 high —— CC 出厂默认虽是
-      // xhigh，但不传 --effort 时实际生效的是 ~/.claude/settings.json 的 effortLevel，
-      // 而它的常见值就是 high；用 high 作 persona 补齐值对既有会话行为最中性。
+      // CC 2.1.187 --effort values. Use high when backfilling persona defaults to match common
+      // settings.json effortLevel; omitting --effort would instead follow that file.
       options: [
         { value: "low", label: "Low" },
         { value: "medium", label: "Medium" },
@@ -25426,25 +25424,14 @@ async function handlePersonaDispatchToolCall(input, ctx) {
       body: JSON.stringify({
         // sessionId 是普通 body 参数（run handler 用作 sourceSessionId 归因），鉴权只看 Bearer
         sessionId: ctx.sessionId,
-        // 续派时可省 targetPersona（daemon 从台账取）
         ...input.targetPersona ? { targetPersona: input.targetPersona } : {},
         prompt: input.prompt,
-        // brief（老板拍板 2026-08-25）：进台账 taskBrief + 任务包信封 <brief>
         ...input.brief ? { brief: input.brief } : {},
-        // 续派（spec 2026-07-21）：非空 = 把 prompt 打进该 dispatch 的原 worker session。
         ...input.dispatchId ? { dispatchId: input.dispatchId } : {},
-        // 跨设备：非空时透传，daemon run handler 据此走 A 角色转发分支。
         ...input.targetDeviceId ? { targetDeviceId: input.targetDeviceId } : {},
-        // T-20: 可选 override B session 使用的 claude 模型；MCP tool 层已 enum 校验，
-        // daemon handler 层还会再校验一次（fail-fast）。
         ...input.model ? { model: input.model } : {},
-        // 一次性 engine override（spec 2026-08-24）：换 codex 的 model 必须连 engine 一起换。
-        // 合法性 + 与 model 的匹配由 daemon handler 校验（错误消息列出 allowed 值）。
         ...input.tool ? { tool: input.tool } : {},
-        // butler 顶部入口：可选 sessionLabel 落到新 worker SessionFile.label。
-        // 长度 1-60 由 protocol schema 强约束；续派场景（dispatchId 非空）daemon 层静默丢弃。
         ...input.sessionLabel ? { sessionLabel: input.sessionLabel } : {},
-        // Master 话题/线语义：原样透传，daemon 不解释（新开写台账 / 续派 merge）。
         ...input.meta ? { meta: input.meta } : {}
       })
     });
@@ -25632,24 +25619,15 @@ async function main() {
         targetDeviceId: external_exports.string().optional().describe(
           "contact deviceId of the remote device when delegating cross-device (omit for a local persona)"
         ),
-        // T-20: dispatch model override。
-        // 2026-08-03 起不再用 enum 硬约束：codex 的模型表已运行时化（随安装的 codex 版本变），
-        // 没有编译期常量可枚举——硬 enum 的前提正是一张静态表，而静态表会过期并拒掉 UI 里
-        // 明明能选到的新模型。精确校验下沉到 daemon handler（按 target persona tool 查运行时
-        // capabilities，fail-fast 且错误消息列出 allowed 值，caller 据此自我纠正）。
+        // 模型列表随 engine 版本变化，不能编译期 enum 固定；daemon 按实际 engine capabilities 校验。
         model: external_exports.string().optional().describe(
           "override the target persona's default model for this one dispatch. New dispatches only (rejected together with dispatchId). Omit to use the persona default. The valid set depends on the engine that will actually run (see tool): claude \u2192 " + CLAUDE_MODEL_IDS.join(" / ") + "; codex \u2192 model ids vary by installed codex version (e.g. gpt-5.6-sol); pi \u2192 ids are '<provider>/<model>' from pi's own model table. Omit unless you know the exact id (invalid values are rejected with the allowed list)."
         ),
-        // 一次性 engine override (spec 2026-08-24)：model 的合法值集从属于 engine，所以
-        // 「这次用 codex 的某个模型干」必须能连 engine 一起换，否则 model 校验按 persona
-        // 绑定的 engine 选表直接拒。
+        // model 的合法值集属于 engine，跨 engine 换模型须同时指定对应 engine。
         tool: external_exports.string().optional().describe(
           "run this one dispatch on a specific engine instead of the persona's bound one: 'claude', 'codex' or 'pi'. One-off \u2014 the persona's own binding is untouched. Pass this whenever you pass a model that belongs to the other engine (e.g. tool='codex' + model='gpt-5.6-sol' for a persona bound to claude). New dispatches only: rejected together with dispatchId (follow-ups keep the worker session's engine) or with targetDeviceId (a remote persona keeps its owner's engine)."
         ),
-        // butler 顶部入口 (spec 2026-07-27)：butler 给新 worker session 起 label 用。
-        // Sidebar 直接显示这个 label（否则兜底 cwd-basename 都是 persona 目录名，同一
-        // persona 的 dispatched session 长得都一样）。仅新开 dispatch 生效；续派
-        // (dispatchId set) 时 daemon 静默丢弃，保 worker session 稳定命名。
+        // 只给新 worker 设置 label；续派保留既有命名。
         sessionLabel: external_exports.string().optional().describe(
           'short human-readable label for the new worker session (shown in sidebar, e.g. "\u4FEE sidebar \u9876\u90E8\u5165\u53E3" / "\u67E5\u6628\u665A SLS \u767B\u5F55\u5931\u8D25"). aim for 8-14 chars, verb-led. ignored when continuing an existing dispatch via dispatchId (worker session keeps its original label).'
         ),
@@ -25676,7 +25654,7 @@ async function main() {
         reason: external_exports.string().optional().describe("failure reason (required when isFailure=true)")
       }
     },
-    // sessionId 只是普通参数（complete schema 会 strip），鉴权走 Bearer。
+    // complete 的 sessionId 会被 schema strip；身份鉴权使用 Bearer。
     async (input) => handlePersonaDispatchCompleteToolCall(input, { daemonUrl, daemonToken, sessionId, dispatchId })
   );
   server.registerTool(

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

@@ -1,17 +1,10 @@
 #!/usr/bin/env node
-// 把项目目录里该进仓库的文件收成 GitHub MCP `push_files` 要的 `[{ path, content }]`。
-//
-// 过滤规则 = 项目根 `.gitignore`（模板那份：node_modules/ dist/ .env .publish.log s.yaml s.*.yaml server/bootstrap .s/ …）
-// + 永远排掉 `.git` 和 `.clawd-project.json`（插件的记账文件：publish / record-push 都会改它，进了仓库或哈希就会
-// 「每推一次都变一次」，而且里面的 deployments / pushedCommit 也不是源码）。**不要**在这里另写一份排除表：publish.sh 渲进项目目录的 s.int.yaml / s.prod.yaml 含 supabase key，
-// 它进不进仓库只该由 .gitignore 一处决定。
-// 二进制（前 8KB 含 NUL）和超过 512KB 的文件跳过并列进 `skipped`——push_files 只收文本，
-// 而且每个字节都要经模型上下文走一遍；agent 看到 skipped 里有该进仓库的东西要自己判断。
-//
+// 收集 GitHub MCP push_files 的文本文件；过滤以项目 .gitignore 为准，避免 s.*.yaml 中的 key 被提交。
+// 始终排除 .git 及根 .clawd-project.json，记账变化不属于源码，不能进入推送或树哈希。
+// 二进制（前 8KB 含 NUL）及超过 512KB 的文件列入 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 里的文件不进哈希。
+// treeHash 为按 path 排序的 sha256(path\0content\0…)；publish 重算后与 record-push 记账比较，拒绝未推的改动。
 import { createHash } from 'node:crypto'
 import { readdir, readFile, stat } from 'node:fs/promises'
 import { join, relative, sep } from 'node:path'
@@ -58,7 +51,6 @@ 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
@@ -67,7 +59,6 @@ function ignored(rel, isDir, rules) {
     }
     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
     }
   }
@@ -78,7 +69,7 @@ let rules = []
 try {
   rules = parseGitignore(await readFile(join(root, '.gitignore'), 'utf8'))
 } catch {
-  // 没有 .gitignore：只排 .git
+  // 无法读取 .gitignore 时仍排除 .git 和根 .clawd-project.json。
 }
 
 const files = []
@@ -109,7 +100,7 @@ async function walk(dir) {
 }
 
 await walk(root)
-// 按字节序排，不用 localeCompare：不同机器 locale 不同会让同一棵树排出两种顺序
+// 按字符串序而非 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')

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

@@ -24,8 +24,7 @@ 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
-    // 双环境后发布记录在 deployments.{integration,prod}；prodUrl 保留作兼容字段 = prod 那份的 url。
-    // 插件还没读写过的老文件顶层就有 prodUrl，原样带出。
+    // prodUrl 兼容字段优先取 deployments.prod.url，缺席时保留 legacy 顶层值。
     const prodUrl = value.deployments?.prod?.url
     projects.push({ ...value, ...(prodUrl ? { prodUrl } : {}), projectDir: join(projectsRoot, dirName) })
   } catch {

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

@@ -1,9 +1,7 @@
 #!/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/...>]
+// GitHub MCP push 后记 repoUrl、pushedCommit 和 pushedTreeHash 到 .clawd-project.json。
+// 无本地 git 的项目发布时重算树哈希；一致才以 pushedCommit 记 publishedCommit。
+// 用法：record-push.mjs --project <项目目录绝对路径> --commit <object.sha> --tree-hash <treeHash> [--repo-url <https://github.com/ottin4ttc/...>]
 // 输出：写回后的元数据 JSON
 import { readFile, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'

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

@@ -1,9 +1,7 @@
 #!/usr/bin/env node
-// 把项目的 server/db/schema.sql 渲成某个环境的 SQL 打到 stdout：`__TABLE_PREFIX__` → 该环境的表前缀。
-// 表结构只有这一份源，integration / prod 各渲一次再喂给 supabase MCP 的 execute_sql——两套表结构
-// 不会漂移。前缀口径与 publish.sh / remove-extension.sh 相同：
-//   integration → <APP_NAME>_<SLUG>_int_    prod → <APP_NAME>_<SLUG>_
-// ext.conf 没 SLUG 的老项目退成 <APP_NAME>_int_ / <APP_NAME>_。
+// 渲 server/db/schema.sql 的 __TABLE_PREFIX__ 到 stdout，共用一份 DDL。
+// 前缀与 publish/remove 一致：integration 为 <APP_NAME>_<SLUG>_int_，prod 为 <APP_NAME>_<SLUG>_。
+// legacy 无 SLUG 时分别退为 <APP_NAME>_int_ / <APP_NAME>_。
 import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
@@ -27,7 +25,7 @@ function fail(msg) {
   process.exit(1)
 }
 
-/** ext.conf 是 bash 赋值文件；这里只认 `KEY=value` / `KEY="value"` 单行，够 APP_NAME / SLUG 用。 */
+/** 只解析单行 KEY=value 及单/双引号，不执行 ext.conf 的 shell 内容。 */
 function readConf(text) {
   const out = {}
   for (const line of text.split('\n')) {

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

@@ -1,12 +1,6 @@
 import { Module } from '@nestjs/common';
 
-// 默认空白骨架 —— 没有任何业务 controller / service / module 注册。
-// 历史背景：之前导入 MessagesModule 自带留言板 API + Supabase repo，用户起 dev server 时 nest
-// 启动会初始化 supabase 模块（控制台 noise + 旁边业务代码会暗示 assistant 沿用留言板风格）。
-// 瘦身后只留启动骨架，业务逻辑由 assistant 按用户需求从零加（添 controller/module 进 imports 即可）。
-//
-// vite middleware / 静态资源 serve 路径仍由 main.ts 处理（dev mount vite，prod express.static），
-// 不需要 ServeStaticModule。
+// 留空启动骨架，由项目按需求注册业务模块；静态资源由 main.ts 托管，无需 ServeStaticModule。
 @Module({
   imports: [],
 })

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

@@ -5,11 +5,8 @@ import { AppModule } from './app.module';
 import { TABLE_PREFIX } from './table-name';
 import * as path from 'node:path';
 
-// 两种跑法：
-//   - dev：`cd server && pnpm dev`（nest watch）+ 另开一个终端 `cd web && pnpm dev`（vite 独跑，
-//     /api 走 web/vite.config.js 的 proxy 转到本进程）
-//   - prod / FC：nest 直接 serve web 的打包产物（publish.sh 的 BUILD_CMD 把 web/dist 拷进 dist/public）
-// FC_SERVER_PORT 是 FC 运行时注入的端口；PORT 给本地调试。
+// dev 由 Vite 独跑并代理 /api；FC 托管拷入 dist/public 的 web 产物。
+// 端口优先 FC_SERVER_PORT，其次本地 PORT。
 async function bootstrap() {
   const app = await NestFactory.create<NestExpressApplication>(AppModule);
 
@@ -18,10 +15,7 @@ async function bootstrap() {
 
   app.setGlobalPrefix('api', { exclude: ['/'] });
 
-  // 静态资源两条路（覆盖 FC 部署与本地 monorepo 启动两种场景）：
-  //   1. FC（CODE_DIR=./server 只上传 server/，运行时 __dirname=dist/）：publish.sh BUILD_CMD 末尾
-  //      把 ../web/dist 拷进 dist/public，跟着 server 一起上传，所以优先用 __dirname/public
-  //   2. 本地 `node dist/main.js`：__dirname/public 不存在时 fallback 到 ../../web/dist
+  // FC 仅上传 server/，优先托管 dist/public；本地构建可回落到 web/dist。
   const fs = await import('node:fs');
   const fcStaticDir = path.resolve(__dirname, 'public');
   const monorepoStaticDir = path.resolve(__dirname, '..', '..', 'web', 'dist');

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

@@ -1,14 +1,8 @@
-// Dev 模式 .env loader：`nest start --watch` 不会经过 `node --env-file=.env`，
-// server 拿不到 SUPABASE_URL/KEY → createClient 跑了但 process.env 是空 → PGRST 系列错码。
-// 这里在 nest bootstrap 之前显式 require dotenv 把 .env 填进 process.env。
-// prod 路径（node --env-file=.env dist/main.js）Node 自带 loader 已经填了，dotenv 看到
-// 已存在的 env 不会覆盖（默认行为），行为对齐。
+// nest watch 不经过 Node --env-file；bootstrap 前加载 .env，dotenv 不覆盖已注入的 env。
 require('dotenv/config');
 
-// Node < 22 没有原生 WebSocket,而 @supabase/supabase-js 的 realtime 客户端
-// 初始化时需要它。在应用启动前补一个全局 WebSocket,使任意 Node 版本
-// (FC 运行时给的 node 可能是 18/20)下都能正常 createClient。
-// 注意:不要用 `WebSocket` 作为局部变量名,会与 DOM lib 的全局类型重声明冲突。
+// Supabase Realtime 初始化需要 WebSocket；缺原生实现时（如 Node 18/20）用 ws 补全。
+// 局部构造器避免命名为 WebSocket，以免与 DOM 全局类型冲突。
 const WsCtor = require('ws');
 if (!(globalThis as any).WebSocket) {
   (globalThis as any).WebSocket = WsCtor;

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

@@ -1,7 +1,5 @@
-// Supabase 表名的唯一入口：表名 = TABLE_PREFIX + 基础名。
-// 两个环境（integration / prod）两套表，靠前缀区分：本地 dev 由 server/.env 给 <APP_NAME>_<SLUG>_int_，
-// 线上由 publish 按 env 注进 FC 的环境变量。代码里凡碰表的地方都走 tableName('visits')，不写死前缀。
-// 表结构写在 server/db/schema.sql（同样用 __TABLE_PREFIX__ 占位），见那边注释。
+// Supabase 表名统一为 TABLE_PREFIX + 基础名，按 integration / prod 隔离。
+// prefix 从 dev .env 或 FC env 注入；DDL 使用同源 __TABLE_PREFIX__ 占位。
 
 const prefix = process.env.TABLE_PREFIX;
 if (!prefix) {
@@ -13,7 +11,6 @@ if (!prefix) {
 
 export const TABLE_PREFIX: string = prefix;
 
-/** `tableName('visits')` → `<APP_NAME>_<SLUG>_int_visits`（integration）/ `<APP_NAME>_<SLUG>_visits`（prod） */
 export function tableName(base: string): string {
   return `${TABLE_PREFIX}${base}`;
 }

package/dist/persona-defaults/persona-app-builder/extension-kit/examples/nestjs-react/web/src/App.jsx

@@ -1,11 +1,4 @@
-// 默认空白页骨架 —— 让 createProject + startDevServer 起来时 iframe 第一帧就是干净白板，
-// 不会闪一下 demo 内容再被 assistant 改成用户实际想要的页面。
-//
-// 历史背景：之前模板自带留言板 demo（App.jsx + messages controller），用户从「新建项目 →
-// 起 dev server → 假设 assistant 改 App.jsx 成 hello world」整个流程里第一眼看到的是留言板
-// UI，HMR 替换后才变成真正的内容 —— 视觉闪动 + 业务代码被模板暗示带偏（spec follow-up
-// 2026-06-03 老板拍）。瘦身后骨架只保留 vite + nest + react 可启动结构，内容由 assistant
-// 按用户需求从零写。
+// 空白起手页，避免模板 demo 暗示业务方向；内容由项目按需求补充。
 export default function App() {
   return <div />;
 }

package/dist/persona-defaults/persona-app-builder/mcp/clawd-app-builder/mcp-server.cjs

@@ -21229,17 +21229,12 @@ var ProjectStore = class {
     await this.write(validated.data);
     return validated.data;
   }
-  /**
-   * 同步内联 scaffold：spawn `new-extension.sh <name> <模板源> <项目目录>` 等 exit。
-   * 必须在 `create()` 之后调（脚本要求目标目录已存在且只含 .clawd-project.json）。
-   * 失败抛错；上层（core.createProject）catch 后回滚。
-   */
+  /** create 后才 scaffold；目标仅含元数据，失败抛给 core 尝试回滚。 */
   async scaffold(name, templateSrcDir, scaffoldScriptPath, extraEnv) {
     const destDir = this.projectDir(name);
     return await new Promise((resolve, reject) => {
       const child = (0, import_node_child_process.spawn)("bash", [scaffoldScriptPath, name, templateSrcDir, destDir], {
-        // extraEnv 排在 PATH **之前**：凭据表里若混进一条名叫 PATH 的条目，顶掉 PATH 会让
-        // 脚本以「命令找不到」的形态崩在离现场很远的地方。
+        // 恢复宿主 PATH，避免 extraEnv 的同名值破坏脚本命令查找。
         env: { ...process.env, ...extraEnv ?? {}, PATH: process.env.PATH ?? "" },
         stdio: ["ignore", "pipe", "pipe"]
       });
@@ -25065,13 +25060,11 @@ var L = [
   "",
   "jobs:",
   "  build:",
-  // name 就是段 key：daemon 按 jobs API 回的 name 认段（那接口不返回 job 的 key）。
-  // 中文说明归 clawd 的上云页面，这里保持机器好认。
+  // jobs API 只返 name 不返 key，故 name 必须用段 key。
   "    name: build",
   "    runs-on: ubuntu-latest",
-  // ACR 个人版的构建按账号串行：底座（8 分钟）/ api 在前面排着时要等它们先构完。
+  // ACR 账号内串行构建，需给其他镜像排队留时间。
   "    timeout-minutes: 40",
-  // 没有 outputs:——smoke / deploy 段自己读契约、自己解析 digest（文件头）。
   "    steps:",
   ...CONTRACT_STEPS,
   "      - name: \u51ED\u636E\u9F50\u4E0D\u9F50\uFF08\u7F3A\u54EA\u51E0\u4E2A\u540D\u5B57\u4E00\u6B21\u5217\u5168\uFF09",
@@ -25108,7 +25101,7 @@ var L = [
   "          ALIBABA_CLOUD_ACCESS_KEY_ID: ${{ secrets.ALI_ACS_ACCESS_KEY_ID }}",
   "          ALIBABA_CLOUD_ACCESS_KEY_SECRET: ${{ secrets.ALI_ACS_ACCESS_KEY_SECRET }}",
   "        run: |",
-  // pipefail：ls-remote 那条管道里 cut 永远退 0，没有 pipefail 的话 ls-remote 挂了 TIP 是空串、红在「main 已经推进到 」这句误导人的话上
+  // pipefail 让 ls-remote 失败正确传播，避免被 cut 的成功状态掩盖。
   "          set -eo pipefail",
   '          REPO="$ACR_NAMESPACE/${{ steps.plan.outputs.persona_id }}"',
   '          node clawos/cloud-host/pipeline/acr.mjs ensure-repo --repo "$REPO" \\',
@@ -25135,9 +25128,7 @@ var L = [
   "      - name: \u4E34\u65F6\u767B\u8BB0 \u2192 \u8D77\u4E00\u6B21 Pod \u2192 \u64A4\u9500",
   "        # \u767B\u8BB0\u6B63\u5F0F\u53EA\u662F\u5F80 gateway \u5199\u4E00\u884C\uFF0Cgateway \u4E0D\u78B0\u955C\u50CF\uFF1B\u96C6\u7FA4\u62C9\u955C\u50CF\u53D1\u751F\u5728\u7B2C\u4E00\u4E2A\u4EFB\u52A1\u5230\u6765\u65F6\u3002",
   "        # \u6CA1\u6709\u8FD9\u4E00\u6B65\uFF0C\u6D41\u6C34\u7EBF\u7EFF\u4E86\u53EA\u4EE3\u8868\u300C\u767B\u8BB0\u4E86\u300D\u3002\u955C\u50CF\u7528 digest\uFF08\u96C6\u7FA4 Job \u662F IfNotPresent\uFF0C\u79FB\u52A8 tag \u4F1A\u4E00\u76F4\u8DD1\u65E7\u7684\uFF09\u3002",
-  // 模型 / 档位 / 连接器 smoke 也要：试跑那次要跟正式那次拿到同一份，否则验的不是将要上线的东西。
-  // 名字形状 deploy-file.mjs 已卡死（persona_id [a-z0-9-]、model / effort [A-Za-z0-9._/-]（`/` 是 pi 的 provider/id，不是元字符）、size 四档枚举、task_concurrency 正整数、connectors 无单引号
-  // 无换行），所以单引号包住直接拼进命令行是安全的。
+  // smoke 与正式发布用同份模型/档位/连接器；deploy-file.mjs 拒绝单引号/换行等危险值，方可单引号拼参。
   "        env:",
   "          CLAWD_GATEWAY_URL: ${{ vars.CLAWD_GATEWAY_URL }}",
   "          CLAWD_GATEWAY_ADMIN_KEY: ${{ secrets.CLAWD_GATEWAY_ADMIN_KEY }}",

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/clawd-session-import/scripts/link-sessions.mjs

@@ -41,7 +41,6 @@ function die(msg) {
   process.exit(1)
 }
 
-// ---------------------------------------------------------------- 小工具
 
 function clip(text, n) {
   const s = String(text ?? '').split(/\s+/).filter(Boolean).join(' ')
@@ -121,7 +120,6 @@ function* jsonLines(file) {
   }
 }
 
-// ---------------------------------------------------------------- RPC
 
 function rpcConfig() {
   try {
@@ -164,9 +162,7 @@ async function rpc(method, args = {}) {
   return body
 }
 
-// ---------------------------------------------------------------- Claude Code 扫描
-
-// 真实用户输入的文本；tool_result / 图片等块返回空串
+// 真实用户文本；tool_result / 图片等块返回空串。
 function userText(msg) {
   const content = msg && typeof msg === 'object' ? msg.content : null
   if (typeof content === 'string') return content
@@ -176,7 +172,6 @@ function userText(msg) {
   return ''
 }
 
-// ~/.claude/projects/<编码后的 cwd>/<toolSessionId>.jsonl —— 文件名即 CC session id
 function scanClaude(cutoffMs) {
   const out = []
   let dirs
@@ -210,7 +205,7 @@ function scanClaude(cutoffMs) {
       let turns = 0
       let firstTs = 0
       let lastTs = 0
-      let hasMainLine = false // 有非 sidechain 的正文行 = 不是 subagent 支线文件
+      let hasMainLine = false
 
       for (const rec of jsonLines(file)) {
         if (!cwd && typeof rec.cwd === 'string') cwd = rec.cwd
@@ -222,7 +217,7 @@ function scanClaude(cutoffMs) {
           }
         }
         if (rec.type === 'ai-title' && rec.aiTitle) {
-          title = rec.aiTitle // CC 自己生成的标题，最适合当 label
+          title = rec.aiTitle
           continue
         }
         if (rec.type !== 'user' && rec.type !== 'assistant') continue
@@ -238,7 +233,6 @@ function scanClaude(cutoffMs) {
         tool: 'claude',
         toolSessionId: name.slice(0, -'.jsonl'.length),
         cwd,
-        // 优先 CC 生成的 ai-title，没有就拿第一句用户发言硬截
         label: clipW(title || firstUser, 56),
         turns,
         createdMs: firstTs || st.mtimeMs,
@@ -255,9 +249,7 @@ function scanClaude(cutoffMs) {
   return out
 }
 
-// ---------------------------------------------------------------- Codex 扫描
-
-// 从 rollout jsonl 数真实用户轮次，顺带取第一条用户发言
+// 从 rollout jsonl 统计用户轮次并取第一条用户文本。
 function countCodexTurns(rolloutPath) {
   if (!rolloutPath || !fs.existsSync(rolloutPath)) return { turns: 0, first: '' }
   let turns = 0
@@ -334,7 +326,7 @@ function codexFromRows(rows, cutoffMs) {
     const updatedMs = toMs(r.updated_at)
     if (updatedMs < cutoffMs) continue
     const { turns, first } = countCodexTurns(r.rollout_path || '')
-    // codex 这几列全是用户原话（name 疑似手动命名字段，本机数据全空），硬截
+    // 标签可能是用户原话，按显示宽度截断。
     const label = clipW(r.name || r.title || r.preview || r.first_user_message || first, 56)
     const cand = {
       tool: 'codex',
@@ -394,7 +386,6 @@ function scanCodexRollouts(cutoffMs) {
   return out
 }
 
-// ---------------------------------------------------------------- 过滤 / 关联
 
 async function existingToolSessionIds() {
   const res = await rpc('session:list', { limit: 100000 })
@@ -457,7 +448,6 @@ async function link(cand, icon, ownerPersonaId = '') {
   return { sessionId, linked: !imported.alreadyLinked }
 }
 
-// ---------------------------------------------------------------- 台账 / 撤销
 
 function ledgerRead() {
   try {
@@ -485,9 +475,7 @@ async function doUndo(applyIt) {
   const res = await rpc('session:list', { limit: 100000 })
   const alive = new Set((res.sessions || []).map((s) => s.sessionId))
   const todo = entries.filter((e) => alive.has(e.sessionId))
-  // 台账里 session 已经不在了（多半是用户直接在 clawd UI 里删的）：没什么可删，只需
-  // 把账清掉。扫盘去重会读这本台账（spec 2026-08-19 §4），条目留着就等于该会话永久
-  // 无法重新导入，而 undo 的语义本就是「撤销我的导入记录」。
+  // 不存在的 session 也需清台账，否则去重会阻止重新导入；删除失败项保留供重试。
   const stale = entries.filter((e) => !alive.has(e.sessionId))
   console.log(`台账 ${entries.length} 条，其中 ${todo.length} 条还在` +
     (stale.length ? `，${stale.length} 条已不存在（只清账）` : '') + '。' +
@@ -515,10 +503,7 @@ async function doUndo(applyIt) {
   console.log(`已删除 ${removed} 条，清账 ${doneIds.size} 条。原 Claude Code / Codex 的会话文件没有任何改动。`)
 }
 
-// ---------------------------------------------------------------- 参数
-
-// clawd UI 认得的图标 key（源：ui/src/lib/session-icons.ts）。协议侧 iconKey 是自由字符串，
-// daemon 不拒绝拼错的值，UI 查不到就不画图标——零提示，所以在参数层拦。
+// iconKey 协议允许任意字符串，但 UI 未识别就不显示；在参数层校验已知值。
 const ICON_KEYS = ['research', 'code', 'loop', 'qa', 'reading', 'debug', 'idea', 'doc', 'assist']
 
 function parseArgs(argv) {
@@ -573,7 +558,6 @@ const HELP = `把本机 Claude Code / Codex 历史会话关联进 clawd
   --undo            撤销本工具关联过的会话（配 --apply 才真删）
   --json            输出 JSON（含被跳过的和原因）`
 
-// ---------------------------------------------------------------- main
 
 async function main() {
   const args = parseArgs(process.argv.slice(2))

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/scan-sessions-suggest-personas/scripts/extract-signals.mjs

@@ -26,7 +26,7 @@ const CLAUDE_PROJECTS = path.join(HOME, '.claude', 'projects');
 const CODEX_DIR = path.join(HOME, '.codex');
 const PERSONAS_DIR = path.join(HOME, '.clawd', 'personas');
 
-// ---------- 系统回填识别：这些不是人在表达需求 ----------
+// 系统注入文本不计用户需求。
 const DROP_PREFIX = [
   '<system-reminder', '<command-name', '<command-message', '<command-args',
   '<local-command-stdout', '<local-command-stderr', '<user-prompt-submit-hook',
@@ -42,8 +42,7 @@ const B64 = /data:image\/[a-z]+;base64,[A-Za-z0-9+/=]+/g;
 
 const clean = (t) => t.replace(B64, '[图片]').replace(/[ \t]+/g, ' ').trim();
 
-/** 结构上能判定的噪音在这里滤干净。语义噪音（agent 自造的探针指令等）正则救不了，
- *  交给下游聚类稀释——占比极低，不值得为它引入一层判断。 */
+/** 只滤结构可识别的噪音，语义噪音交给下游聚类。 */
 function isRealQuery(t) {
   if (!t || t.length < 6) return false;
   if (DROP_PREFIX.some((p) => t.startsWith(p))) return false;
@@ -71,7 +70,6 @@ function textOf(content) {
   return parts.join(' ');
 }
 
-// ---------- 小工具 ----------
 const bump = (m, k, n = 1) => m.set(k, (m.get(k) || 0) + n);
 // 计数相同时按名字排——否则并列项谁进前 N 随遍历顺序漂移，同样输入得不到同样输出
 const topN = (m, n) =>
@@ -123,7 +121,7 @@ async function eachLine(file, fn) {
   }
 }
 
-// ---------- 已有 persona：这些目录下的活已经有人干了，默认跳过 ----------
+// 已有 persona 覆盖的目录一律跳过，无开关。
 function knownPersonaDirs() {
   const out = new Map();
   let ents;
@@ -167,7 +165,6 @@ const profOf = (prof, k) => {
   return prof.get(k);
 };
 
-// ---------- Claude Code ----------
 async function scanClaude(cutMs, sig, prof) {
   let dirs;
   try {
@@ -200,8 +197,7 @@ async function scanClaude(cutMs, sig, prof) {
         const typ = d.type;
         const cwd = d.cwd || '';
 
-        // Claude Code 自己生成的会话标题：一句已抽象好的任务摘要，
-        // 比任何启发式取样都准，是画像的首选信号（约 9 成会话有）
+        // CC 生成的 ai-title 优先作为任务摘要信号。
         if (typ === 'ai-title' && d.aiTitle) {
           p.titles.push(d.aiTitle);
           return;
@@ -234,9 +230,7 @@ async function scanClaude(cutMs, sig, prof) {
   }
 }
 
-// ---------- Codex ----------
-/** threads 表是 codex 的权威索引，比解析 rollout 准，还带 git/model 信息。
- *  node:sqlite 要 node>=22.5 且是实验特性——拿不到就返回空，由 rollout 扫描兜底。 */
+/** 可用时从 Codex threads 表取 cwd / branch；旧 Node 或缺数据库时仍扫描 rollout。 */
 async function codexMetaFromDb() {
   const out = new Map();
   let dbs;
@@ -331,7 +325,6 @@ async function scanCodex(cutMs, sig, prof) {
   }
 }
 
-// ---------- 主流程 ----------
 function parseArgs(argv) {
   const a = { days: 7, out: '.', samples: 12, minQueries: 5, minDays: 2 };
   for (let i = 0; i < argv.length; i++) {
@@ -393,8 +386,7 @@ async function main() {
     const qs = byProj.get(k);
     if (!qs || !qs.length) continue;
 
-    // 已经有 persona 管着的目录整个略过：本脚本的意义是找**没人管的活**，
-    // 这里的活已经有人干了。不给开关——「要不要看已覆盖目录」不是每次运行要重想的问题。
+    // 已覆盖目录不产生候选，不提供开关，避免把既有 persona 的工作再次推荐。
     const owner = coveredBy(v.cwd, known);
     if (owner) {
       skipped.push([k, owner, qs.length]);

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

@@ -1,17 +1,10 @@
 #!/usr/bin/env node
-// 把项目目录里该进仓库的文件收成 GitHub MCP `push_files` 要的 `[{ path, content }]`。
-//
-// 过滤规则 = 项目根 `.gitignore`（模板那份：node_modules/ dist/ .env .publish.log s.yaml s.*.yaml server/bootstrap .s/ …）
-// + 永远排掉 `.git` 和 `.clawd-project.json`（插件的记账文件：publish / record-push 都会改它，进了仓库或哈希就会
-// 「每推一次都变一次」，而且里面的 deployments / pushedCommit 也不是源码）。**不要**在这里另写一份排除表：publish.sh 渲进项目目录的 s.int.yaml / s.prod.yaml 含 supabase key，
-// 它进不进仓库只该由 .gitignore 一处决定。
-// 二进制（前 8KB 含 NUL）和超过 512KB 的文件跳过并列进 `skipped`——push_files 只收文本，
-// 而且每个字节都要经模型上下文走一遍；agent 看到 skipped 里有该进仓库的东西要自己判断。
-//
+// 收集 GitHub MCP push_files 的文本文件；过滤以项目 .gitignore 为准，避免 s.*.yaml 中的 key 被提交。
+// 始终排除 .git 及根 .clawd-project.json，记账变化不属于源码，不能进入推送或树哈希。
+// 二进制（前 8KB 含 NUL）及超过 512KB 的文件列入 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 里的文件不进哈希。
+// treeHash 为按 path 排序的 sha256(path\0content\0…)；publish 重算后与 record-push 记账比较，拒绝未推的改动。
 import { createHash } from 'node:crypto'
 import { readdir, readFile, stat } from 'node:fs/promises'
 import { join, relative, sep } from 'node:path'
@@ -58,7 +51,6 @@ 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
@@ -67,7 +59,6 @@ function ignored(rel, isDir, rules) {
     }
     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
     }
   }
@@ -78,7 +69,7 @@ let rules = []
 try {
   rules = parseGitignore(await readFile(join(root, '.gitignore'), 'utf8'))
 } catch {
-  // 没有 .gitignore：只排 .git
+  // 无法读取 .gitignore 时仍排除 .git 和根 .clawd-project.json。
 }
 
 const files = []
@@ -109,7 +100,7 @@ async function walk(dir) {
 }
 
 await walk(root)
-// 按字节序排，不用 localeCompare：不同机器 locale 不同会让同一棵树排出两种顺序
+// 按字符串序而非 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')

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

@@ -24,8 +24,7 @@ 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
-    // 双环境后发布记录在 deployments.{integration,prod}；prodUrl 保留作兼容字段 = prod 那份的 url。
-    // 插件还没读写过的老文件顶层就有 prodUrl，原样带出。
+    // prodUrl 兼容字段优先取 deployments.prod.url，缺席时保留 legacy 顶层值。
     const prodUrl = value.deployments?.prod?.url
     projects.push({ ...value, ...(prodUrl ? { prodUrl } : {}), projectDir: join(projectsRoot, dirName) })
   } catch {

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

@@ -1,9 +1,7 @@
 #!/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/...>]
+// GitHub MCP push 后记 repoUrl、pushedCommit 和 pushedTreeHash 到 .clawd-project.json。
+// 无本地 git 的项目发布时重算树哈希；一致才以 pushedCommit 记 publishedCommit。
+// 用法：record-push.mjs --project <项目目录绝对路径> --commit <object.sha> --tree-hash <treeHash> [--repo-url <https://github.com/ottin4ttc/...>]
 // 输出：写回后的元数据 JSON
 import { readFile, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'