@clawos-dev/clawd 0.2.619 → 0.2.621

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'

package/dist/persona-defaults/persona-dataclaw-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-dataclaw-builder/extension-kit/examples/nestjs-react/server/src/app.module.ts

@@ -1,12 +1,8 @@
 import { Module } from '@nestjs/common';
 import { DataclawModule } from './dataclaw/dataclaw.module';
 
-// dataclaw 只读后端 BFF 起手骨架：默认只注册 DataclawModule（schema / performance / ppl /
-// consultants / intent 五个只读端点，用建页人提供的 apikey 以 Bearer 调公网 dataclaw service）。
-// 业务逻辑由 assistant 按用户需求从零加（添 controller/module 进 imports 即可）。
-//
-// vite middleware / 静态资源 serve 路径仍由 main.ts 处理（dev mount vite，prod express.static），
-// 不需要 ServeStaticModule。
+// 起手注册 DataclawModule 的五个只读端点；apikey 只由后端以 Bearer 发往 dataclaw。
+// 静态资源由 main.ts 托管，无需 ServeStaticModule。
 @Module({
   imports: [DataclawModule],
 })

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

@@ -1,8 +1,7 @@
 import { Injectable, HttpException, OnModuleInit } from '@nestjs/common'
 import { DataclawConfig, loadDataclawConfig } from './dataclaw.config'
 
-// dataclaw 公网 service 用自签证书（文档要求 curl -k）。Node fetch(undici) 默认校验 TLS 会握手失败。
-// 本 app 唯一出站目标就是 dataclaw 这一个自签 https，进程级放开 TLS 校验即可（最小改动、零依赖）。
+// dataclaw 服务使用自签证书；这里关闭整个进程的 TLS 证书验证，会影响所有出站 HTTPS。
 process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0'
 
 // 端点超时：schema / 固定查询走默认；intent-execute 可能跑 LLM 编排，给 90s。
@@ -50,8 +49,7 @@ export class DataclawClient implements OnModuleInit {
         throw new HttpException({ ok: false, error: `dataclaw 非 JSON 响应: ${text.slice(0, 200)}` }, 502)
       }
       if (!res.ok || json?.ok === false) {
-        // HTTP 非 2xx → 映射上游状态（5xx 归 502）；HTTP 2xx 但应用层 {ok:false} → 502
-        // （别把 200 当错误码抛——对前端是"成功码带错误体"的矛盾态）。
+        // 2xx 的应用层 ok:false 及上游 5xx 统一映射为 502，避免以成功状态返回错误体。
         const status = res.ok ? 502 : res.status >= 500 ? 502 : res.status || 400
         throw new HttpException(
           { ok: false, error: json?.error || `dataclaw ${res.status}`, upstreamStatus: res.status },

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

@@ -1,8 +1,7 @@
 import { Body, Controller, Get, Post, Query } from '@nestjs/common'
 import { DataclawClient } from './dataclaw.client'
 
-// app 自己的只读 BFF。main.ts 已 setGlobalPrefix（'api' 或子路径 'preview/<port>/api'），
-// 故这里的路径不带 /api。前端只调本 app 的 /api/*，apikey 由后端注入，绝不下发浏览器。
+// main.ts 统一添加 /api 前缀；路由不重复写它。apikey 只在后端，不下发浏览器。
 @Controller()
 export class DataclawController {
   constructor(private readonly dc: DataclawClient) {}

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

@@ -5,11 +5,8 @@ import { NestExpressApplication } from '@nestjs/platform-express';
 import { AppModule } from './app.module';
 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,13 +15,9 @@ async function bootstrap() {
 
   app.setGlobalPrefix('api', { exclude: ['/'] });
 
-  // 无登录门禁：页面打开即用。数据访问鉴权由后端用 DATACLAW_API_KEY（建页人提供的 apikey）注入，
-  // 见 dataclaw.client —— key 绝不下发浏览器。
+  // 页面无登录门禁，apikey 仅由后端使用。
 
-  // 静态资源两条路（覆盖 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-dataclaw-builder/extension-kit/examples/nestjs-react/server/src/polyfill.ts

@@ -1,6 +1,2 @@
-// Dev 模式 .env loader：`nest start --watch` 不会经过 `node --env-file=.env`，
-// server 拿不到 DATACLAW_* env → loadDataclawConfig 会 fail-loud。
-// 这里在 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');

package/dist/persona-defaults/persona-dataclaw-builder/extension-kit/examples/nestjs-react/web/src/api.js

@@ -1,7 +1,4 @@
-// 只调 app 自己的 BFF（/api/*），绝不直连 dataclaw —— apikey 在 server 侧注入，不进浏览器。
-//
-// dev 隧道模式下页面挂在子路径 /preview/<port>/ 下（见 vite.config.js base），
-// 所以 API_BASE 要拼上 import.meta.env.BASE_URL，否则 fetch 会打到错误的绝对路径。
+// 只调本 app 的 BFF，apikey 留在后端；API 路径相对 Vite BASE_URL（默认 /）。
 const API_BASE = (import.meta.env.BASE_URL || '/').replace(/\/+$/, '') + '/api';
 
 async function req(path, opts = {}) {

package/dist/persona-defaults/persona-dataclaw-builder/extension-kit/examples/nestjs-react/web/src/components/BarChart.jsx

@@ -1,4 +1,3 @@
-// 纯 SVG 横向柱状图，不引第三方依赖。props { rows, labelField, valueField }。
 export default function BarChart({ rows, labelField, valueField }) {
   if (!rows || rows.length === 0) return null;
 

package/dist/persona-defaults/persona-dataclaw-builder/extension-kit/examples/nestjs-react/web/src/components/ResultCards.jsx

@@ -1,4 +1,3 @@
-// 结果卡片。props { rows, titleField, valueField }。数字按 zh-CN 千分位展示。
 export default function ResultCards({ rows, titleField, valueField }) {
   if (!rows || rows.length === 0) return <div className="empty">无数据</div>;
   return (

package/dist/persona-defaults/persona-dataclaw-builder/extension-kit/examples/nestjs-react/web/src/components/ResultTable.jsx

@@ -1,6 +1,5 @@
 import { INTERNAL_FIELDS } from '../enums';
 
-// 结果表格。列取 rows[0] 的 key（过滤 _provenance 等内部字段），数字按 zh-CN 千分位展示，空数组显示「无数据」。
 export default function ResultTable({ rows }) {
   if (!rows || rows.length === 0) return <div className="empty">无数据</div>;
   const cols = Object.keys(rows[0]).filter((c) => !INTERNAL_FIELDS.has(c));

package/dist/persona-defaults/persona-dataclaw-builder/extension-kit/examples/nestjs-react/web/src/enums.js

@@ -1,7 +1,6 @@
-// 内部字段：dataclaw 返回里不展示给用户的列（编号 / ID / 溯源元数据等）。
-// ResultTable 渲染时按此 Set 过滤掉对应列。
+// 渲染结果时隐藏内部编号、ID 及溯源元数据。
 export const INTERNAL_FIELDS = new Set([
   'ID', 'unique_id', '链接', 'SourceID', '发票ID', '客户ID', '职位ID',
   '业绩所属一级团队编号', '业绩所属二级团队编号', '业绩所属三级团队编号', '所属OP名称', '候选人ID',
-  '_provenance', // dataclaw 每条返回都带的溯源元数据（source/record_type/fetched_at/trace_id），不展示
+  '_provenance',
 ]);

package/dist/persona-defaults/persona-dataclaw-builder/extension-kit/hooks/pre-deploy.sh

@@ -2,7 +2,6 @@
 # dataclaw 发布前置：从生成 app 的 server/.env 读出建页人填的 apikey，export 供 s.yaml 占位符替换。
 # 由 deploy-kit/publish.sh 在渲染 s.yaml 前 source（共享 EXT_DIR/APP_NAME/PERSONA_KIT 等作用域）。
 
-# 建页人提供的 dataclaw apikey 写在生成 app 的 server/.env（DATACLAW_API_KEY）。
 # .env 被 server/.fcignore 排除、不进部署包，所以这里读出来、经 s.yaml 注入 FC 环境变量。
 ENV_FILE="$EXT_DIR/server/.env"
 if [ -f "$ENV_FILE" ]; then
@@ -17,5 +16,4 @@ if [ -z "${DATACLAW_API_KEY:-}" ]; then
 fi
 export DATACLAW_API_KEY
 
-# service url：config.env / ext.conf 已 source 进来；兜底公网地址。
 export DATACLAW_SERVICE_URL="${DATACLAW_SERVICE_URL:-https://120.48.21.36}"

package/dist/persona-defaults/persona-dataclaw-builder/mcp/clawd-app-builder/deploy-kit/scripts/ensure-credentials.sh

@@ -1,30 +1,11 @@
 #!/usr/bin/env bash
-# ============================================================
-# 发布/清理动手前把阿里云凭证准备好（publish.sh / remove-extension.sh 共用）。
-# 被 `source` 进来，再调 ensure_credentials。跟 ensure-toolchain.sh 是一对：
-# 那个管「命令在不在」，这个管「命令拿什么身份跑」。
-#
-# 硬约束：**全程不碰用户全局 ~/.s，凭证不落盘**。clawd 发布用的是 clawd 自己那份 AK（本机 ~/.clawd/secrets/aliyun.env 经 daemon 渲进
-# MCP server env，云上是 pod-setup 渲的 env），而 ~/.s/access.yaml 里的 default 是用户自己账号的
-# Serverless Devs 凭证——它是用户的东西，不是我们的。做法对齐本 kit 处理 aliyun CLI 的方式（凭证只进本次进程的 env）：
-# s v3 的 @serverless-devs/credential 有 getEnvKeyPair——进程 env 里同时有 AccountID / AccessKeyID / AccessKeySecret 三个变量，
-# 就自动合成一个叫 `$system_environment_access` 的 access（实测 s 3.1.10 源码），不需要任何 access.yaml。
-# Serverless Devs 的配置家目录仍指到 deploy-kit 名下，但那里只剩组件缓存和日志，没有凭证。
-# ============================================================
+# Source this file and call ensure_credentials before publish/remove.
+# Credentials stay in process env; never overwrite the user global Serverless Devs credentials.
 
-# s 的 access 名 = s 自己给「从 env 合成的那份」起的固定名字（字面量，$ 不是 shell 变量）。刻意不用 default：
-# env 没齐时 s 找不到这个名字就 `Not found access: $system_environment_access` 硬报错，而不是默默拿用户
-# ~/.s/access.yaml 里的 default 凭证把 extension 部署进别人的账号。调 s 时都显式带 `--access "$S_ACCESS_ALIAS"`：
-# 命令行参数覆盖 s.yaml 里的 access 字段，老项目（s.yaml 写着 clawd-fc / default）照样走这条。
+# Use the literal environment access alias so missing env cannot silently fall back to the user profile.
 S_ACCESS_ALIAS='$system_environment_access'
 
-# 阿里云 AK 只从进程 env 来（design 2026-09-19-persona-mcp-single-source §3.2）：本脚本由 clawd-app-builder MCP server 起，
-# AK 在那个进程的 env 里——本机由 daemon 从凭据表（~/.clawd/secrets/aliyun.env）渲进 .mcp.json 声明的 per-server env，
-# 云上由 pod-setup 从仓库 Secrets 渲进 config.toml 的 [mcp_servers.clawd-app-builder].env。不落盘是有意的：
-# 写成文件的话 agent 一个 `cat` 就看见了。deploy-kit 目录下曾经的 `.secrets/aliyun.env[.local]` 两条读法已删。
-#
-# clawd **不随包 ship 任何一把 AK**（2026-09-18 起，见 specs/2026-09-18-aliyun-ak-leak-rotate-design.md：
-# 上一把随 npm 包发出去 69 秒就被 TruffleHog 收割，主账号被风控锁）。env 里没有 = 使用者还没配，fail-loud。
+# Require caller-injected AK values; never ship credentials or read fallback kit credential files.
 ensure_aliyun_env() {
   if [ -z "${ALIBABA_CLOUD_ACCESS_KEY_ID:-}" ] || [ -z "${ALIBABA_CLOUD_ACCESS_KEY_SECRET:-}" ]; then
     echo "❌ 没有阿里云 AK：本机把 ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET 两行写进 ~/.clawd/secrets/aliyun.env（daemon 起 clawd-app-builder 时渲进它的 env）；云上由 gateway 注入。" >&2
@@ -33,17 +14,7 @@ ensure_aliyun_env() {
   export ALIBABA_CLOUD_REGION_ID="${REGION:?config.env 缺 REGION}"
 }
 
-# 调 aliyun CLI 的**唯一入口**：把凭证和 region 作为显式参数交出去，不依赖环境变量的隐式优先级。
-#
-# 为什么非这样不可（实测 aliyun 3.3.17，`--mode AK`）：`ALIBABA_CLOUD_ACCESS_KEY_ID` /
-# `_SECRET` / `_REGION_ID` 这三个环境变量在这个模式下**根本不被消费**，于是
-#   - 机器上没有 `~/.aliyun/config.json`（全新用户的常态，ensure_toolchain 只装 CLI、
-#     从不跑 `aliyun configure`）→ `ERROR: region can't be empty`，第一次发布就跑不起来；
-#   - 机器上有 profile（比如用户自己配过阿里云）→ **静默走用户自己的 profile**，等于拿
-#     用户的阿里云身份去部署 extension，跟 access.yaml 那个坑是同一类。
-# 补 `--region` 一个 flag 不够，AK 也必须是 flag——两者都试过。
-#
-# 用法跟 aliyun 一样，省掉 `--mode AK` 和三个凭证参数：aliyun_ak sts GetCallerIdentity
+# Pass AK and region explicitly: aliyun AK mode can otherwise fall back to the user profile.
 aliyun_ak() {
   aliyun --mode AK \
     --access-key-id "${ALIBABA_CLOUD_ACCESS_KEY_ID:?aliyun_ak 需要先 ensure_aliyun_env}" \
@@ -52,41 +23,33 @@ aliyun_ak() {
     "$@"
 }
 
-# 把 s 要的三个变量放进本进程 env（AccountID 从 GetCallerIdentity 现取），并把 Serverless Devs 的配置家目录
-# （组件缓存 / 日志）指到 deploy-kit 名下——不写 access.yaml，凭证不落盘。
-# s v3 的 rootHome = `$serverless_devs_config_home/.s`（默认 `$HOME/.s`），`s -v` 打印的 s-home 就是它。
-# 前置：ensure_toolchain（aliyun 可执行）+ ensure_aliyun_env（AK 进 env）。
-# 家目录放 $KIT_DIR 下（= persona 目录的 mcp/clawd-app-builder/deploy-kit/.s-home/）：只有缓存、没有秘密；
-# persona 仓库的 gitignore 模板（daemon deploy/templates.ts GITIGNORE_LINES）忽略 .s-home/（缓存不该进仓库）；
-# 本机每次 daemon 启动 mcp/ 整份换新，组件缓存跟着清，下次 publish 重装一次。
+# Derive AccountID through STS and isolate Serverless Devs cache/config under KIT_DIR; do not write credentials.
 ensure_s_access() {
   local kit="${KIT_DIR:?ensure_s_access 需要调用方先设 KIT_DIR}"
   local s_home="$kit/.s-home"
   local ident acc
 
   ident="$(aliyun_ak sts GetCallerIdentity 2>&1)" || {
-    # 别只说「检查凭证」——凭证不对只是可能之一，region 缺失 / CLI 装坏 / 网络不通报的是别的话。
-    # 把 CLI 原文摆出来，让读的人按原文判断。
+    # Preserve CLI diagnostics: identity failures are not necessarily bad credentials.
     echo "❌ aliyun sts GetCallerIdentity 失败，拿不到 AccountId。aliyun 原文：" >&2
     echo "$ident" >&2
     echo "   排查顺序：① 上面这行 CLI 原文说的是什么 ② 进程 env 里的 AK 是否有效（本机 ~/.clawd/secrets/aliyun.env、云上仓库 Secrets）——2026-09-18 之前 OTA 发的那把已泄露、不可再用，得换自己的 ③ config.env 的 REGION" >&2
     return 1
   }
-  # 用 node 不用 python3：目标机器保证有 node（clawd 本身就是 node 跑的），不保证有 python
-  # —— 清理路径尤其不该多一个装不上就跑不了的依赖。
+  # Node is guaranteed by clawd; do not add a Python runtime prerequisite.
   acc="$(printf '%s' "$ident" | node -e 'console.log(JSON.parse(require("fs").readFileSync(0,"utf8")).AccountId)')" || {
     echo "❌ 解析 AccountId 失败,aliyun 输出非 JSON:" >&2
     echo "$ident" >&2
     return 1
   }
 
-  # s 认的三个变量名就是它 access.yaml 里的键名（KEY_PAIR_IMPORTANT），大小写照它的
+  # Serverless Devs credential environment keys are case-sensitive.
   export AccountID="$acc"
   export AccessKeyID="$ALIBABA_CLOUD_ACCESS_KEY_ID"
   export AccessKeySecret="$ALIBABA_CLOUD_ACCESS_KEY_SECRET"
   export serverless_devs_config_home="$s_home"
   mkdir -p "$s_home/.s"
-  # 老版本脚本（2026-09-19 之前）把凭证写在这里；本机残留的顺手删掉，别让一份过期 AK 躺在 persona 目录里
+  # Remove legacy persisted credentials from the kit cache.
   rm -f "$s_home/.s/access.yaml"
 }
 

package/dist/persona-defaults/persona-dataclaw-builder/mcp/clawd-app-builder/deploy-kit/scripts/ensure-toolchain.sh

@@ -1,19 +1,7 @@
 #!/usr/bin/env bash
-# ============================================================
-# 确保发布/清理用到的工具链就绪：Serverless Devs (s) + 阿里云 CLI (aliyun)。
-# 检测环境、缺啥装啥、已装则跳过（幂等）。被 publish.sh / remove-extension.sh
-# 在调用 aliyun/s 之前 `source` 进来，再调 ensure_toolchain。
-#
-# 为什么需要它：FC 发布全靠 aliyun CLI + s 两个外部命令，二者都不随 clawd 安装。
-# 新机器上它们不在 PATH → ensure-credentials.sh 的 `aliyun_ak sts ...` stdout 为空 →
-# JSON.parse 空串报错，且死在第一个 ::stage:: marker 之前 → daemon 只能报 [unknown] 阶段。
-# 这个脚本补的就是这一环。
-#
-# 注意它**只装不配**：不会跑 `aliyun configure`，所以机器上不会因此有 `~/.aliyun/config.json`
-# ——凭证由 ensure-credentials.sh 的 aliyun_ak 每次显式传参，不依赖任何本机 profile。
-# ============================================================
+# Source and call ensure_toolchain before credential setup; install missing CLI tools without configuring user profiles.
 
-# aliyun CLI 官方 release 兜底版本（仅在无 brew、走二进制下载时用；brew 路径不读它）。
+# Pinned fallback applies only to direct binary download, not Homebrew.
 CLAWD_ALIYUN_CLI_VERSION="${CLAWD_ALIYUN_CLI_VERSION:-3.3.21}"
 
 ensure_s() {
@@ -26,12 +14,10 @@ ensure_s() {
 ensure_aliyun() {
   command -v aliyun >/dev/null 2>&1 && return 0
   echo "==> 安装阿里云 CLI (aliyun)…"
-  # 优先 brew（有 brew 的 mac 最省事，装到已在 PATH 的 /opt/homebrew/bin | /usr/local/bin）
   if command -v brew >/dev/null 2>&1; then
     brew install aliyun-cli
     return 0
   fi
-  # 兜底：官方 release 二进制（没装 brew 的新机器 / Linux server）。
   local os arch bindir="$HOME/.clawd/bin"
   case "$(uname -s)" in
     Darwin) os=macosx ;;
@@ -57,7 +43,7 @@ ensure_toolchain() {
   ensure_aliyun
 }
 
-# 直接执行（bash ensure-toolchain.sh）= 自检；被 source 时不自动跑，留给调用方显式 ensure_toolchain。
+# Direct execution checks the toolchain; sourcing leaves execution to the caller.
 if [ "${BASH_SOURCE[0]}" = "${0}" ]; then
   set -euo pipefail
   ensure_toolchain