npm - @clawos-dev/clawd - Versions diffs - 0.2.112-beta.225.5330d3a → 0.2.112-beta.227.cc9477f - Mend

@clawos-dev/clawd 0.2.112-beta.225.5330d3a → 0.2.112-beta.227.cc9477f

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

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

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { MessagesController } from './messages.controller';
+import { MessagesService } from './messages.service';
+@Module({
+  controllers: [MessagesController],
+  providers: [MessagesService],
+})
+export class MessagesModule {}

package/dist/persona-defaults/persona-app-builder/extension-kit/examples/nestjs-react/server/src/messages/messages.service.ts ADDED Viewed

@@ -0,0 +1,49 @@
+import { Injectable } from '@nestjs/common';
+import { createClient, SupabaseClient } from '@supabase/supabase-js';
+const TABLE = 'guestbook_messages';
+// 模板示例 service。Supabase client **lazy 初始化**：
+//   - constructor 不读 env / 不 throw —— 让整个 nest server 能起来即使 SUPABASE_URL/KEY 没配
+//     （比如 fresh project 还没接 Supabase，老板只想看个 welcome 页面）
+//   - 实际调 list / create 时再 require，缺 env 时只报给这条 API 的 caller，不阻塞 server 启动
+//
+// 老 bug：constructor 里硬 require + throw → 没配 env 时 NestApplication 启动直接 crash，
+// dev server 进 exit 1 → preview iframe upstream error 糊脸。
+@Injectable()
+export class MessagesService {
+  private _supabase: SupabaseClient | null = null;
+  private get supabase(): SupabaseClient {
+    if (this._supabase) return this._supabase;
+    const url = process.env.SUPABASE_URL;
+    const key = process.env.SUPABASE_KEY;
+    if (!url || !key) {
+      throw new Error(
+        'SUPABASE_URL / SUPABASE_KEY 未配置 —— 请先接 Supabase 后端再调 /api/messages',
+      );
+    }
+    this._supabase = createClient(url, key);
+    return this._supabase;
+  }
+  async list() {
+    const { data, error } = await this.supabase
+      .from(TABLE)
+      .select('*')
+      .order('created_at', { ascending: false })
+      .limit(100);
+    if (error) throw new Error(`读取留言失败: ${error.message}`);
+    return data;
+  }
+  async create(name: string, content: string) {
+    const { data, error } = await this.supabase
+      .from(TABLE)
+      .insert({ name: name || 'anonymous', content })
+      .select()
+      .single();
+    if (error) throw new Error(`写入留言失败: ${error.message}`);
+    return data;
+  }
+}

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

@@ -0,0 +1,8 @@
+// Node < 22 没有原生 WebSocket,而 @supabase/supabase-js 的 realtime 客户端
+// 初始化时需要它。在应用启动前补一个全局 WebSocket,使任意 Node 版本
+// (FC 运行时给的 node 可能是 18/20)下都能正常 createClient。
+// 注意:不要用 `WebSocket` 作为局部变量名,会与 DOM lib 的全局类型重声明冲突。
+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/tsconfig.json ADDED Viewed

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "ES2021",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "sourceMap": false,
+    "declaration": false
+  }
+}

package/dist/persona-defaults/persona-app-builder/extension-kit/examples/nestjs-react/web/index.html ADDED Viewed

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>留言板 · 全链路测试</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/dist/persona-defaults/persona-app-builder/extension-kit/examples/nestjs-react/web/package.json ADDED Viewed

@@ -0,0 +1,18 @@
+{
+  "name": "guestbook-web",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.4.0",
+    "vite": "^6.0.0"
+  }
+}

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

@@ -0,0 +1,161 @@
+import React, { useEffect, useState } from 'react';
+const styles = {
+  page: {
+    minHeight: '100vh',
+    margin: 0,
+    background: 'linear-gradient(160deg, #0f172a 0%, #1e293b 100%)',
+    color: '#e2e8f0',
+    fontFamily: 'system-ui, -apple-system, "Segoe UI", sans-serif',
+    display: 'flex',
+    justifyContent: 'center',
+    padding: '48px 16px',
+  },
+  card: {
+    width: '100%',
+    maxWidth: 560,
+  },
+  title: { fontSize: 28, fontWeight: 700, margin: '0 0 4px' },
+  subtitle: { color: '#94a3b8', margin: '0 0 24px', fontSize: 14 },
+  form: { display: 'flex', flexDirection: 'column', gap: 10, marginBottom: 28 },
+  row: { display: 'flex', gap: 10 },
+  input: {
+    flex: 1,
+    padding: '10px 12px',
+    borderRadius: 8,
+    border: '1px solid #334155',
+    background: '#0f172a',
+    color: '#e2e8f0',
+    fontSize: 14,
+    outline: 'none',
+  },
+  textarea: {
+    padding: '10px 12px',
+    borderRadius: 8,
+    border: '1px solid #334155',
+    background: '#0f172a',
+    color: '#e2e8f0',
+    fontSize: 14,
+    outline: 'none',
+    resize: 'vertical',
+    minHeight: 64,
+  },
+  button: {
+    padding: '10px 20px',
+    borderRadius: 8,
+    border: 'none',
+    background: '#6366f1',
+    color: '#fff',
+    fontSize: 14,
+    fontWeight: 600,
+    cursor: 'pointer',
+  },
+  msg: {
+    padding: '12px 14px',
+    borderRadius: 10,
+    background: '#1e293b',
+    border: '1px solid #334155',
+    marginBottom: 10,
+  },
+  msgHead: { display: 'flex', justifyContent: 'space-between', marginBottom: 4 },
+  msgName: { fontWeight: 600, color: '#a5b4fc', fontSize: 14 },
+  msgTime: { color: '#64748b', fontSize: 12 },
+  msgBody: { fontSize: 14, lineHeight: 1.5, whiteSpace: 'pre-wrap' },
+  error: { color: '#f87171', fontSize: 13, marginBottom: 12 },
+  empty: { color: '#64748b', fontSize: 14, textAlign: 'center', padding: '24px 0' },
+};
+export default function App() {
+  const [messages, setMessages] = useState([]);
+  const [name, setName] = useState('');
+  const [content, setContent] = useState('');
+  const [error, setError] = useState('');
+  const [loading, setLoading] = useState(false);
+  async function load() {
+    try {
+      const res = await fetch(`${import.meta.env.BASE_URL}api/messages`);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      setMessages(await res.json());
+      setError('');
+    } catch (e) {
+      setError(`加载失败: ${e.message}`);
+    }
+  }
+  useEffect(() => {
+    load();
+  }, []);
+  async function submit(e) {
+    e.preventDefault();
+    if (!content.trim()) return;
+    setLoading(true);
+    try {
+      const res = await fetch(`${import.meta.env.BASE_URL}api/messages`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ name, content }),
+      });
+      if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.message || `HTTP ${res.status}`);
+      }
+      setContent('');
+      await load();
+    } catch (e) {
+      setError(`提交失败: ${e.message}`);
+    } finally {
+      setLoading(false);
+    }
+  }
+  return (
+    <div style={styles.page}>
+      <div style={styles.card}>
+        <h1 style={styles.title}>留言板</h1>
+        <p style={styles.subtitle}>
+          前端 React → NestJS → Supabase 全链路连通性测试
+        </p>
+        <form style={styles.form} onSubmit={submit}>
+          <input
+            style={styles.input}
+            placeholder="你的名字（可选）"
+            value={name}
+            onChange={(e) => setName(e.target.value)}
+          />
+          <textarea
+            style={styles.textarea}
+            placeholder="写点什么…"
+            value={content}
+            onChange={(e) => setContent(e.target.value)}
+          />
+          <div style={styles.row}>
+            <button style={styles.button} type="submit" disabled={loading}>
+              {loading ? '提交中…' : '提交留言'}
+            </button>
+          </div>
+        </form>
+        {error && <div style={styles.error}>{error}</div>}
+        {messages.length === 0 ? (
+          <div style={styles.empty}>还没有留言，来写第一条吧</div>
+        ) : (
+          messages.map((m) => (
+            <div key={m.id} style={styles.msg}>
+              <div style={styles.msgHead}>
+                <span style={styles.msgName}>{m.name}</span>
+                <span style={styles.msgTime}>
+                  {new Date(m.created_at).toLocaleString('zh-CN')}
+                </span>
+              </div>
+              <div style={styles.msgBody}>{m.content}</div>
+            </div>
+          ))
+        )}
+      </div>
+    </div>
+  );
+}

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

@@ -0,0 +1,5 @@
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import App from './App.jsx';
+createRoot(document.getElementById('root')).render(<App />);

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

@@ -0,0 +1,30 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+// app-builder G 方案：dev 时 vite 不独立跑，而是被 server/src/main.ts 的
+// `createViteServer({ middlewareMode: true })` 当 middleware 挂进 nest，前端 HMR
+// 和 /api 都从 nest 监听的 CLAWD_PREVIEW_PORT 出（spec 2026-06-01 §5.6）。
+// 这个 config 仅用于：
+//   1. `vite build` 生成 web/dist 静态资源（prod 由 nest serve）
+//   2. 脱离 clawd 直接 `pnpm dev` 跑 vite 独立模式（本地调试）
+const tunnelHost = process.env.CLAWD_TUNNEL_HOST ?? '';
+const port = Number(process.env.CLAWD_PREVIEW_PORT ?? 5173);
+export default defineConfig({
+  plugins: [react()],
+  build: {
+    outDir: 'dist',
+    emptyOutDir: true,
+  },
+  // 隧道经 nest 主进程进来，vite middleware 自己识别 base。standalone 模式（无 tunnel）
+  // 走 base: '/' 方便本地直接打开。
+  base: tunnelHost ? `/preview/${port}/` : '/',
+  server: {
+    host: '127.0.0.1',
+    port,
+    strictPort: true,
+    hmr: tunnelHost
+      ? { protocol: 'wss', clientPort: 443, path: `/preview/${port}/`, host: tunnelHost }
+      : undefined,
+  },
+});

package/dist/persona-defaults/persona-app-builder/extension-kit/scripts/new-extension.sh ADDED Viewed

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# 从示例模板生成一个新 extension
+# 用法: new-extension.sh <name> [示例模板, 默认 nestjs-react]
+#
+# 目标目录解析：
+#   - picker 模式（推荐）：persona-app-builder/projects/<name>/ 已由 daemon createProject
+#     建好（含 .clawd-project.json）→ 把模板内容展开到此目录，保留 .clawd-project.json。
+#   - 老路径兼容：projects/<name>/ 不存在时回退到 persona-app-builder/<name>/。
+set -euo pipefail
+KIT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PERSONA_DIR="$(cd "$KIT_DIR/.." && pwd)"
+NAME="${1:?用法: new-extension.sh <name> [模板,默认 nestjs-react]}"
+TMPL="${2:-nestjs-react}"
+SRC="$KIT_DIR/examples/$TMPL"
+[ -d "$SRC" ]  || { echo "示例模板不存在: $SRC (现有: $(ls "$KIT_DIR/examples"))"; exit 1; }
+PICKER_DEST="$PERSONA_DIR/projects/$NAME"
+if [ -d "$PICKER_DEST" ] && [ -f "$PICKER_DEST/.clawd-project.json" ]; then
+  DEST="$PICKER_DEST"
+  # picker 模式：目录已存在且仅含 .clawd-project.json，把模板内容展开进去
+  REMAINING="$(find "$DEST" -mindepth 1 -maxdepth 1 ! -name '.clawd-project.json' -print -quit)"
+  [ -z "$REMAINING" ] || { echo "目标已有内容（非空目录）: $DEST"; exit 1; }
+  cp -R "$SRC/." "$DEST/"
+else
+  DEST="$PERSONA_DIR/$NAME"
+  [ -e "$DEST" ] && { echo "目标已存在: $DEST"; exit 1; }
+  cp -r "$SRC" "$DEST"
+fi
+# 写 ext.conf(框架相关配置,publish.sh 会读)
+cat > "$DEST/ext.conf" <<EOF
+APP_NAME=$NAME
+CODE_DIR=./server
+FC_ENTRY=dist/main.js
+BUILD_CMD="cd web && npm install && npm run build && cd ../server && npm install && npm run build"
+# 本 extension 拥有的 Supabase 表(空格分隔,必须 ${NAME}_ 前缀);remove-extension.sh 据此清理
+SUPABASE_TABLES=""
+EOF
+echo "✅ 新 extension: $DEST"
+echo ""
+echo "接下来:"
+echo "  1) 设计 Supabase 表(务必用 ${NAME}_ 前缀,别碰 clawos 已有表)"
+echo "  2) 改前端(web/)和后端(server/)业务逻辑"
+echo "  3) 本地验证后发布: extension-kit/scripts/publish.sh $DEST"
+echo ""
+echo "换框架/语言: 改 ext.conf 的 BUILD_CMD/FC_ENTRY;换语言再看 extension-kit/README.md"

package/dist/persona-defaults/persona-app-builder/extension-kit/scripts/publish.sh ADDED Viewed

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# ============================================================
+# 一键发布 extension 到阿里云 FC(框架无关)
+# 用法: publish.sh <extension目录>
+# extension 目录里可放 ext.conf 声明框架相关的: APP_NAME/CODE_DIR/FC_ENTRY/BUILD_CMD
+# ============================================================
+set -euo pipefail
+KIT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PERSONA_DIR="$(cd "$KIT_DIR/.." && pwd)"
+EXT_DIR="${1:?用法: publish.sh <extension目录>}"
+EXT_DIR="$(cd "$EXT_DIR" && pwd)"
+# 1) 平台变量 + extension 自身配置(后者覆盖前者)
+source "$KIT_DIR/config.env"
+[ -f "$EXT_DIR/ext.conf" ] && source "$EXT_DIR/ext.conf"
+APP_NAME="${APP_NAME:-$(basename "$EXT_DIR")}"
+CODE_DIR="${CODE_DIR:-./server}"
+FC_ENTRY="${FC_ENTRY:-dist/main.js}"
+BUILD_CMD="${BUILD_CMD:-}"
+# 2) 阿里云凭证(现读)+ Serverless Devs 认证(必须含 AccountID,SK 走 heredoc 不进命令行)
+set -a; . "$PERSONA_DIR/.secrets/aliyun.env"; set +a
+ACC="$(aliyun sts GetCallerIdentity 2>/dev/null | python3 -c 'import sys,json;print(json.load(sys.stdin)["AccountId"])')"
+mkdir -p ~/.s
+cat > ~/.s/access.yaml <<EOF
+default:
+  AccountID: '$ACC'
+  AccessKeyID: $ALIBABA_CLOUD_ACCESS_KEY_ID
+  AccessKeySecret: $ALIBABA_CLOUD_ACCESS_KEY_SECRET
+EOF
+chmod 600 ~/.s/access.yaml
+# 3) 构建产物(框架相关,由 ext.conf 的 BUILD_CMD 定义)
+if [ -n "$BUILD_CMD" ]; then
+  echo "==> build: $BUILD_CMD"
+  ( cd "$EXT_DIR" && eval "$BUILD_CMD" )
+fi
+# 4) 放置框架无关的 bootstrap 到 code 目录
+cp "$KIT_DIR/contract/bootstrap" "$EXT_DIR/$CODE_DIR/bootstrap"
+chmod +x "$EXT_DIR/$CODE_DIR/bootstrap"
+# 5) 渲染 s.yaml(| 作分隔符,避免 URL/层 ARN 里的 / : 冲突)
+sed -e "s|__APP_NAME__|$APP_NAME|g" \
+    -e "s|__REGION__|$REGION|g" \
+    -e "s|__FC_RUNTIME__|$FC_RUNTIME|g" \
+    -e "s|__NODE_LAYER__|$NODE_LAYER|g" \
+    -e "s|__FC_CPU__|$FC_CPU|g" \
+    -e "s|__FC_MEMORY__|$FC_MEMORY|g" \
+    -e "s|__FC_TIMEOUT__|$FC_TIMEOUT|g" \
+    -e "s|__CODE_DIR__|$CODE_DIR|g" \
+    -e "s|__FC_ENTRY__|$FC_ENTRY|g" \
+    -e "s|__SUPABASE_URL__|$SUPABASE_URL|g" \
+    -e "s|__SUPABASE_KEY__|$SUPABASE_KEY|g" \
+    "$KIT_DIR/contract/s.yaml.tmpl" > "$EXT_DIR/s.yaml"
+# 6) 部署
+echo "==> s deploy ($APP_NAME)"
+( cd "$EXT_DIR" && s deploy -y )
+# 7) 取自定义域名 + 验证
+DOM="$(aliyun fc GET /2023-03-30/custom-domains --region "$REGION" 2>/dev/null | python3 -c "
+import sys,json
+d=json.load(sys.stdin)
+m=[c['domainName'] for c in d.get('customDomains',[]) if '$APP_NAME' in c.get('domainName','')]
+print(m[0] if m else '')")"
+echo ""
+echo "=================================================="
+if [ -n "$DOM" ]; then
+  echo "  ✅ 发布完成: http://$DOM"
+  echo "=================================================="
+  "$KIT_DIR/scripts/verify.sh" "http://$DOM" || true
+else
+  echo "  ⚠️ 部署完成但未取到自定义域名,检查 fc3-domain 是否成功"
+fi

package/dist/persona-defaults/persona-app-builder/extension-kit/scripts/remove-extension.sh ADDED Viewed

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# ============================================================
+# 清理一个 extension:删 FC 资源(函数+触发器+域名)+ 可选删它的 Supabase 表
+# 用法: remove-extension.sh <extension目录>
+# 删哪些表:读 ext.conf 的 SUPABASE_TABLES(extension 自己声明的)
+# 安全:① 校验 <app>_ 前缀防误删 clawos ② 列出+二次确认 ③ 数据不可逆
+# ============================================================
+set -euo pipefail
+KIT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PERSONA_DIR="$(cd "$KIT_DIR/.." && pwd)"
+EXT_DIR="${1:?用法: remove-extension.sh <extension目录>}"
+EXT_DIR="$(cd "$EXT_DIR" && pwd)"
+source "$KIT_DIR/config.env"
+[ -f "$EXT_DIR/ext.conf" ] && source "$EXT_DIR/ext.conf"
+APP_NAME="${APP_NAME:-$(basename "$EXT_DIR")}"
+SUPABASE_TABLES="${SUPABASE_TABLES:-}"
+set -a; . "$PERSONA_DIR/.secrets/aliyun.env"; set +a
+# 1) 删 FC 侧(函数 + 触发器 + 自定义域名)
+echo "==> 删 FC 资源: $APP_NAME"
+( cd "$EXT_DIR" && s remove -y )
+# 2) 删 Supabase 表(仅当 ext.conf 声明了 SUPABASE_TABLES)
+if [ -n "$SUPABASE_TABLES" ]; then
+  echo ""
+  echo "⚠️  即将删除以下 Supabase 表(数据不可逆):"
+  for t in $SUPABASE_TABLES; do echo "    - public.$t"; done
+  # 安全锁:每个表必须 <app>_ 前缀,否则拒绝(防误伤 clawos 共享库)
+  for t in $SUPABASE_TABLES; do
+    case "$t" in
+      ${APP_NAME}_*) ;;
+      *) echo "❌ 表 '$t' 不是 '${APP_NAME}_' 前缀,拒绝删除(可能误伤 clawos)"; exit 1 ;;
+    esac
+  done
+  read -r -p "确认删表? 输入 yes 继续: " ans
+  if [ "$ans" = "yes" ]; then
+    TOKEN="$(python3 -c "import json;print(json.load(open('$PERSONA_DIR/.mcp.json'))['mcpServers']['supabase']['env']['SUPABASE_ACCESS_TOKEN'])")"
+    for t in $SUPABASE_TABLES; do
+      curl -s -X POST "https://api.supabase.com/v1/projects/$SUPABASE_PROJECT_REF/database/query" \
+        -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+        -d "{\"query\":\"drop table if exists public.$t cascade;\"}" >/dev/null \
+        && echo "  ✓ dropped public.$t"
+    done
+  else
+    echo "跳过删表(FC 已删;表保留)。"
+  fi
+else
+  echo "ext.conf 未声明 SUPABASE_TABLES,跳过删表。如有表请手动确认清理。"
+fi
+echo "✅ $APP_NAME 清理完成。"

package/dist/persona-defaults/persona-app-builder/extension-kit/scripts/verify.sh ADDED Viewed

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# 发布后健康检查:可达性 + Content-Type + 【是否被强制下载】
+# 用法: verify.sh <url>
+set -euo pipefail
+URL="${1:?用法: verify.sh <url>}"
+echo "== 健康检查: $URL =="
+code=$(curl -s -o /dev/null -w "%{http_code}" --max-time 30 "$URL/" || echo 000)
+ctype=$(curl -s -o /dev/null -w "%{content_type}" --max-time 30 "$URL/" || echo "")
+echo "首页: HTTP $code  ($ctype)"
+# 关键检查: 有 Content-Disposition 说明会被浏览器当文件下载(没绑自定义域名的典型症状)
+hdr=$(curl -s -D - -o /dev/null --max-time 30 "$URL/" || true)
+if echo "$hdr" | grep -qi 'content-disposition'; then
+  echo "❌ 检测到 Content-Disposition —— 浏览器会下载而非渲染!确认走的是 fc3-domain 自定义域名,而不是 fcapp.run"
+else
+  echo "✓ 无 Content-Disposition,浏览器可正常渲染网页"
+fi
+[ "$code" = "200" ] && echo "✓ 全链路 OK" || echo "⚠️ 首页非 200,查 s logs"

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

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

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

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

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

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