@aiti-ai/aiti-claude-code-agent 0.0.0-stage → 0.1.8

package/client/src/controlled-login-dialog.mjs

@@ -0,0 +1,270 @@
+/**
+ * controlled-login — 外部 Agent 受控登录标准 · 前端统一弹窗（原生 h() 渲染，零构建步骤）。
+ *
+ * ⚠ 副本同步（字节级拷贝，改动须同步到全部副本；测试 `_shared/controlled-login.test.mjs` 钉住一致性）。
+ * 权威源：pi-web-ext/_shared/controlled-login-dialog.mjs
+ * 部署副本（client 侧走部署树内相对导入 —— 零构建 client 无法像 vite 客户端那样在构建期
+ * 内联 ../../_shared（资产路由拒绝越目录穿越），与 draft-keeper 的 ./core.mjs 同一惯例）：
+ *   pi-web-ext/aiti-{zcode,cursor,qoder,claude-code,codex}-agent/client/controlled-login-dialog.mjs
+ *
+ * 契约（docs/ext-controlled-login-standard.md §3.5）：
+ *   🔗「打开授权页」按钮（target=_blank）+ URL 文本可复制 + 模式说明行
+ *   + 状态区（waiting 转圈 / success ✅ 用户名 / failed / timeout / cancelled，均带重试）
+ *   + B 模式（paste）专属 code 输入框+提交。
+ * 状态刷新：弹窗打开期间每 2s 轮询 GET /login/status，关闭即停
+ * （方案 §3.6 已论证并拍板的轮询例外：登录是分钟级一次性交互）。
+ *
+ * 浮动契约：面板根节点 data-ext-float="1" + data-ext-float-w/-h + data-ext-float-full="1"
+ * （aiti-float 接管拖拽/缩放/持久化/小屏全屏；未装时自身 style 居中兜底）。
+ *
+ * 接入（各扩展 client/controlled-login-client.mjs，两行）：
+ *   import { registerControlledLoginClient } from "./controlled-login-dialog.mjs";
+ *   export default function register(ctx) { registerControlledLoginClient(ctx, { … }); }
+ */
+
+// ---------- 模块内 open 状态（toolbar 入口与 dialogs 条目同模块共享，不落 window 全局） ----------
+let moduleSetOpen = null;
+// 懒加载（clientImmediately:false）下 toolbar 静态条目点击时弹窗组件可能尚未挂载：
+// 记 pending，挂载 effect 消费——避免首点失效。
+let pendingOpen = false;
+
+/** 打开本扩展的受控登录弹窗（toolbar 🔑 按钮 / 静态条目 meta.onClick 用）。 */
+export function openControlledLogin() {
+  if (moduleSetOpen) moduleSetOpen(true);
+  else pendingOpen = true;
+}
+
+// ---------- 自持样式层（幂等注入；clg- 前缀 + var(--x, 兜底)，零宿主耦合） ----------
+const STYLE_ID = "aiti-controlled-login-styles";
+const STYLES = `
+.clg-mask { position: fixed; inset: 0; z-index: 2147483000; background: rgba(0,0,0,.32); display: flex; align-items: center; justify-content: center; }
+.clg-panel { width: 520px; max-width: calc(100vw - 16px); display: flex; flex-direction: column; overflow: hidden;
+  background: var(--bg,#fff); color: var(--text,#1a1a1a); border: 1px solid var(--border,#e0e0e0); border-radius: 12px;
+  box-shadow: 0 16px 64px rgba(0,0,0,.25); font-size: 13px; line-height: 1.55; }
+.clg-head { display: flex; align-items: center; gap: 10px; padding: 11px 16px; border-bottom: 1px solid var(--border,#e0e0e0); flex-shrink: 0; background: var(--bg-subtle,#f7f7f7); }
+.clg-title { font-size: 14px; font-weight: 700; display: flex; align-items: center; gap: 6px; }
+.clg-x { margin-left: auto; border: none; background: none; cursor: pointer; color: var(--text-muted,#888); font-size: 16px; line-height: 1; padding: 4px 6px; border-radius: 6px; }
+.clg-x:hover { background: var(--bg-hover,#eee); color: var(--text,#1a1a1a); }
+.clg-body { padding: 14px 16px 16px; display: flex; flex-direction: column; gap: 10px; }
+.clg-intro { color: var(--text-muted,#777); font-size: 12.5px; }
+.clg-urlrow { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.clg-open { display: inline-flex; align-items: center; gap: 6px; padding: 7px 16px; border: 1px solid var(--accent,#2563eb); border-radius: 8px;
+  cursor: pointer; background: var(--accent,#2563eb); color: #fff; font-size: 13px; font-weight: 600; text-decoration: none; white-space: nowrap; }
+.clg-open:hover { background: var(--accent-hover,#1d4ed8); }
+.clg-url { flex: 1; min-width: 200px; font: 11.5px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; color: var(--text-muted,#777);
+  word-break: break-all; cursor: pointer; padding: 5px 8px; border: 1px dashed var(--border,#d8d8d8); border-radius: 6px; }
+.clg-url:hover { border-color: var(--accent,#2563eb); color: var(--text,#1a1a1a); }
+.clg-copied { color: #16a34a; font-size: 11.5px; }
+.clg-status { display: flex; align-items: center; gap: 8px; padding: 9px 12px; border-radius: 8px; font-size: 12.5px; flex-wrap: wrap; }
+.clg-status.waiting { background: rgba(37,99,235,.08); color: var(--accent,#2563eb); }
+.clg-status.success { background: color-mix(in srgb, var(--ok, #22c55e) 12%, transparent); color: #16a34a; }
+.clg-status.failed, .clg-status.timeout, .clg-status.cancelled { background: color-mix(in srgb, var(--danger, #ef4444) 8%, transparent); color: #dc2626; }
+.clg-spin { width: 14px; height: 14px; flex-shrink: 0; border: 2px solid color-mix(in srgb, currentColor 25%, transparent); border-top-color: currentColor;
+  border-radius: 50%; animation: clg-rotate .9s linear infinite; }
+@keyframes clg-rotate { to { transform: rotate(360deg); } }
+.clg-errline { font-size: 12px; color: #dc2626; word-break: break-all; }
+.clg-tail { font: 11px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; color: var(--text-muted,#888); background: var(--bg-subtle,#f5f5f5);
+  border: 1px solid var(--border,#e0e0e0); border-radius: 8px; padding: 8px 10px; max-height: 140px; overflow: auto; white-space: pre-wrap; word-break: break-all; }
+.clg-coderow { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
+.clg-input { flex: 1; min-width: 180px; padding: 7px 10px; border: 1px solid var(--border,#d8d8d8); border-radius: 8px;
+  background: var(--bg,#fff); color: var(--text,#1a1a1a); font-size: 12.5px; outline: none; }
+.clg-input:focus { border-color: var(--accent,#2563eb); box-shadow: 0 0 0 2px color-mix(in srgb, var(--accent,#2563eb) 18%, transparent); }
+.clg-btn { display: inline-flex; align-items: center; gap: 5px; padding: 6px 14px; border: 1px solid var(--border,#d8d8d8); border-radius: 7px;
+  cursor: pointer; background: var(--bg,#fff); color: var(--text,#1a1a1a); font-size: 12.5px; font-weight: 500; white-space: nowrap; }
+.clg-btn:hover { background: var(--bg-hover,#f0f0f0); }
+.clg-btn:disabled { opacity: .5; cursor: not-allowed; }
+.clg-btn.primary { background: var(--accent,#2563eb); border-color: var(--accent,#2563eb); color: #fff; }
+.clg-btn.primary:hover { background: var(--accent-hover,#1d4ed8); }
+.clg-foot { display: flex; align-items: center; gap: 8px; margin-top: 2px; }
+.clg-hint { color: var(--text-dim,#999); font-size: 11.5px; }
+`;
+
+let stylesInjected = false;
+function ensureStyles() {
+  if (stylesInjected) return;
+  if (typeof document === "undefined") return;
+  if (!document.getElementById(STYLE_ID)) {
+    const el = document.createElement("style");
+    el.id = STYLE_ID;
+    el.textContent = STYLES;
+    document.head.appendChild(el);
+  }
+  stylesInjected = true;
+}
+
+/**
+ * 统一弹窗注册（每扩展 client 的薄壳调用一次）。
+ *
+ * @param {*} ctx 宿主 client 上下文（h/useState/useEffect/apiUrl/registerItems）
+ * @param {object} config
+ * @param {string} config.extId        扩展 id（API 前缀 / toolbar item id 用）
+ * @param {string} config.toolbarLabel 工具条按钮 title/label（如 "登录 ZCode"）
+ * @param {string} config.title        弹窗标题
+ * @param {string} [config.urlHint]    A url-only 模式说明行
+ * @param {string} [config.pasteHint]  B paste-relay 模式说明行
+ * @param {string} [config.successHint] 成功后的补充说明（如凭据换 key 提示）
+ */
+export function registerControlledLoginClient(ctx, config) {
+  ensureStyles();
+  const h = (...a) => ctx.h(...a);
+  const useState = (v) => ctx.useState(v);
+  const useEffect = (fn, deps) => ctx.useEffect(fn, deps);
+  const api = (p, init) => fetch(ctx.apiUrl("/api/extensions/" + config.extId + p), { cache: "no-store", ...init });
+  const jsonInit = (body) => ({ method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
+
+  // ---- 工具条入口：声明式图标按钮（meta.icon + meta.onClick、无 render —— 宿主统一渲染 36×36 线图按钮，禁 emoji） ----
+  ctx.registerItems("toolbar", [{
+    id: `${config.extId}-controlled-login`,
+    meta: {
+      label: config.toolbarLabel,
+      title: config.toolbarLabel,
+      icon: "icons/key-round.svg",
+      onClick: () => openControlledLogin(),
+    },
+  }]);
+  // ---- 弹窗条目（dialogs slot；宿主包 display:contents 壳，float 持久化键认它） ----
+  ctx.registerItems("dialogs", [{
+    id: `${config.extId}-controlled-login-dialog`,
+    render: () => h(ControlledLoginDialog),
+  }]);
+
+  function ControlledLoginDialog() {
+    const [open, setOpen] = useState(false);
+    const [status, setStatus] = useState(null);   // /login/status 响应（{state,...}）
+    const [busy, setBusy] = useState(false);
+    const [reqError, setReqError] = useState(null); // 请求层错误（网络/400）
+    const [code, setCode] = useState("");
+    const [copied, setCopied] = useState(false);
+
+    useEffect(() => {
+      moduleSetOpen = setOpen;
+      if (pendingOpen) { pendingOpen = false; setOpen(true); }
+      return () => { if (moduleSetOpen === setOpen) moduleSetOpen = null; };
+    }, []);
+
+    // 打开期间 2s 轮询 /login/status（§3.6 拍板例外）；关闭即停
+    useEffect(() => {
+      if (!open) return;
+      let stopped = false;
+      let timer = null;
+      const tick = async () => {
+        try {
+          const r = await api("/login/status");
+          const d = await r.json();
+          if (!stopped) { setStatus(d); setReqError(null); }
+        } catch { /* 网络抖动忽略，下轮再试 */ }
+        if (!stopped) timer = setTimeout(tick, 2000);
+      };
+      tick();
+      return () => { stopped = true; if (timer) clearTimeout(timer); };
+    }, [open]);
+
+    if (!open) return null;
+
+    const st = status?.state ?? "idle";
+    const mode = status?.mode ?? "url";
+    const pasteMode = mode === "paste";
+
+    async function call(p, init) {
+      setBusy(true); setReqError(null);
+      try {
+        const r = await api(p, init);
+        const d = await r.json();
+        if (d && d.error) setReqError(d.error);
+        if (d) setStatus(d);
+      } catch (e) {
+        setReqError(e?.message || String(e));
+      }
+      setBusy(false);
+    }
+    const startLogin = () => call("/login/start", jsonInit({}));
+    const cancelLogin = () => call("/login/cancel", jsonInit({}));
+    const submitCode = () => { if (code.trim()) call("/login/submit", jsonInit({ code })); };
+
+    async function copyUrl() {
+      const url = status?.url || "";
+      if (!url) return;
+      try { await navigator.clipboard.writeText(url); setCopied(true); setTimeout(() => setCopied(false), 1500); } catch { /* 剪贴板不可用：URL 文本本身可选中复制 */ }
+    }
+
+    // ---- 状态区 ----
+    let statusLine = null;
+    if (st === "idle") {
+      statusLine = h("div", { className: "clg-status waiting" }, "尚未发起登录");
+    } else if (st === "waiting") {
+      statusLine = h("div", { className: "clg-status waiting" },
+        h("span", { className: "clg-spin" }),
+        status?.url ? "等待你在浏览器完成授权…（本页自动感知，约 2s 内）" : "正在启动官方登录进程，等待授权链接…",
+        h("button", { className: "clg-btn", disabled: busy, style: { marginLeft: "auto" }, onClick: cancelLogin }, "取消"),
+      );
+    } else if (st === "success") {
+      statusLine = h("div", { className: "clg-status success" },
+        "登录成功", status?.user ? h("span", { style: { fontWeight: 700 } }, status.user) : null,
+        config.successHint ? h("span", { className: "clg-hint", style: { color: "inherit" } }, config.successHint) : null,
+      );
+    } else if (st === "failed" || st === "timeout" || st === "cancelled") {
+      const label = st === "failed" ? "登录失败" : st === "timeout" ? "登录超时" : "已取消";
+      statusLine = h("div", { className: "clg-status " + st },
+        h("span", null, (st === "timeout" ? "⏱ " : st === "cancelled" ? "⚪ " : "❌ ") + label),
+        status?.error ? h("span", { className: "clg-errline" }, status.error) : null,
+      );
+    }
+
+    return h("div", { className: "clg-mask", onClick: () => setOpen(false) },
+      h("div", {
+        className: "clg-panel",
+        "data-ext-float": "1", "data-ext-float-w": 520, "data-ext-float-h": 380, "data-ext-float-full": "1",
+        onClick: (e) => e.stopPropagation(),
+      },
+        // ── 标题栏（首个子元素 = float 拖拽把手）──
+        h("div", { className: "clg-head" },
+          h("span", { className: "clg-title" }, "🔑 " + config.title),
+          h("button", { className: "clg-x", title: "关闭", onClick: () => setOpen(false) }, "✕"),
+        ),
+        h("div", { className: "clg-body" },
+          config.urlHint && !pasteMode ? h("div", { className: "clg-intro" }, config.urlHint) : null,
+          pasteMode && config.pasteHint ? h("div", { className: "clg-intro" }, config.pasteHint) : null,
+
+          // ── URL 区（waiting 且已抓到链接）──
+          st === "waiting" && status?.url
+            ? h("div", { className: "clg-urlrow" },
+                h("a", { className: "clg-open", href: status.url, target: "_blank", rel: "noopener noreferrer" }, "打开授权页"),
+                h("span", { className: "clg-url", title: "点击复制链接", onClick: copyUrl }, status.url),
+                copied ? h("span", { className: "clg-copied" }, "已复制") : null,
+              )
+            : null,
+
+          // ── B 模式 code 输入（paste 且 waiting）──
+          pasteMode && st === "waiting"
+            ? h("div", { className: "clg-coderow" },
+                h("input", {
+                  className: "clg-input",
+                  placeholder: "粘贴授权完成页显示的 code（或完整回调链接）",
+                  value: code,
+                  onChange: (e) => setCode(e.target.value),
+                  onKeyDown: (e) => { if (e.key === "Enter") submitCode(); },
+                }),
+                h("button", { className: "clg-btn primary", disabled: busy || !code.trim(), onClick: submitCode }, busy ? "…" : "提交 code"),
+              )
+            : null,
+
+          statusLine,
+          reqError ? h("div", { className: "clg-errline" }, reqError) : null,
+
+          // CLI 升级改输出格式导致 URL 抓取失败时：原文透出（人工可读可复制，方案 §7）
+          (st === "failed" || st === "timeout") && status?.outputTail
+            ? h("div", { className: "clg-tail" }, status.outputTail)
+            : null,
+
+          // ── 底部动作：idle/终态带（重）试 ──
+          h("div", { className: "clg-foot" },
+            st === "idle" || st === "failed" || st === "timeout" || st === "cancelled" || st === "success"
+              ? h("button", { className: "clg-btn primary", disabled: busy, onClick: startLogin }, busy ? "…" : st === "idle" ? "发起登录" : "重试")
+              : null,
+            h("span", { className: "clg-hint" }, "授权在浏览器完成，凭据由官方 CLI 落盘；本页关闭不影响进行中的登录。"),
+          ),
+        ),
+      ),
+    );
+  }
+}

package/dev-pack.mjs

@@ -0,0 +1,246 @@
+/**
+ * pi-web-ext · dev-pack 共享实现（方案 §3.2 / M5：扩展 dev-pack——src + 构建工具 + AGENTS.md 直达部署目录）
+ *
+ * 目标：用户在 AI 窗对 AI 说「帮我改一下 xxx 扩展」时，AI 能在**部署目录**直接：
+ *   读 AGENTS.md → 改 src/ → node tools/build.mjs → curl reload → 浏览器生效，不等回开发机。
+ *
+ * 各扩展 tools/deploy.mjs 末尾统一追加一段（见本文件同级各 deploy.mjs 模式）：
+ *   const { packDevPack } = await import("../../_shared/dev-pack.mjs");
+ *   packDevPack({ extRoot: <扩展源码根>, log: console.log });
+ *
+ * packDevPack 向每个已存在的部署目录（~/.pi/web{,-dev}/extensions/<extId>）写入：
+ *   AGENTS.md        源码目录有则拷，无则由模板生成（§3.4）
+ *   src/             client/src/**、根级服务端源码 *.ts/*.cjs/*.mjs、lib/（跳 vendor）、server/、sched/、worker-src/
+ *   tools/build.mjs  现场构建入口（扩展自带则拷真身，否则生成 esbuild 默认版）
+ *   tools/deploy.mjs 部署脚本本身（大改后回源码仓重部署的入口）
+ *   package.json     含 aitiConfigs 声明与 build 脚本
+ *   vite.config.ts   有则拷
+ *
+ * 幂等：重复部署整目录覆盖；允许失败：任何异常只 log 不影响 deploy 退出码（调用方 try/catch）。
+ */
+"use strict";
+import { homedir } from "node:os";
+import { join, resolve, dirname, basename, sep as pathSep } from "node:path";
+import {
+  existsSync, readdirSync, statSync, mkdirSync, cpSync, rmSync, writeFileSync, readFileSync,
+} from "node:fs";
+
+// 根级服务端源码文件：拷进 src/（运行时平铺文件在部署根不动，宿主 loader 路径不变）
+const ROOT_SRC_EXTS = new Set([".ts", ".tsx", ".cjs", ".mjs"]);
+const ROOT_SRC_SKIP = new Set(["dist", "node_modules"]);
+// 源码子目录：整目录拷（vendor 类大资产跳过——部署目录本就有运行时副本）
+const SRC_DIRS = ["client/src", "server", "lib", "sched", "worker-src"];
+const DIR_SKIP = new Set(["vendor", "__pycache__", "node_modules"]);
+
+function copyTree(src, dest, skip) {
+  mkdirSync(dest, { recursive: true });
+  for (const en of readdirSync(src, { withFileTypes: true })) {
+    if (skip && skip.has(en.name)) continue;
+    const s = join(src, en.name), d = join(dest, en.name);
+    if (en.isDirectory()) copyTree(s, d, skip);
+    else if (en.isFile()) cpSync(s, d);
+  }
+}
+
+/** AGENTS.md 默认模板（§3.4；扩展自带 AGENTS.md 则不走到这里）。供 CLI 批量生成源码目录版复用。 */
+export function agentsMdTemplate(extId) {
+  return `# ${extId} 扩展（部署目录直改指南）
+
+## 结构
+- 运行时文件平铺在本目录根（index.ts / core.cjs …，宿主 loader 按相对路径加载——**禁手改运行时平铺文件**，改 src/ 再 build）
+- \`src/\` 源码（client/src + 服务端 ts/cjs）· \`dist/\` 构建产物（禁手改）· \`tools/\` 构建/部署脚本
+- npm 包形态的扩展：本目录 package.json 含 version 与 aitiConfigs 声明
+
+## 小改现场流程（改文案/样式/小逻辑）
+1. 改 \`src/\` 下对应源码
+2. \`node tools/build.mjs\`（client 有构建产物的扩展；纯服务端改动跳过）
+3. \`curl -X POST http://127.0.0.1:3001/api/extensions/reload\`（dev；prod 3002；外部经 nginx 带 basePath：/dev、/mac、/mdev、/win、/wdev → \`/xxx/api/extensions/reload\`）
+4. 浏览器刷新页面验证
+
+## 大改回源码仓
+- 源码仓：\`extensions/${extId}/\`（git 管理，deploy 同步回本目录）
+- 改完在源码仓跑 \`node tools/deploy.mjs\`（或仓库根 \`node scripts/deploy-all.mjs --only ${extId}\`）
+
+## 数据目录（数据分层：config / cache）
+- \`ctx.configDir\` 根级 = 配置与关键小状态（aiti-configs 备份范围；小、珍贵、人可读）
+- \`ctx.cacheDir\`（= \`<configDir>/cache/\`）= 可删缓存：db/venv/日志/大文件；rm -rf 后扩展下次访问自动重建
+- \`ctx.dataDir\` 已移除（访问即抛）——新代码禁用
+- 本扩展白名单（永不为 cache 的配置文件）见 package.json \`aitiConfigs.configFiles\`
+
+## 红线
+- 禁轮询（setInterval 拉取）；需要等待用事件/回调/SSE（桥的 SSE、aiti-event-bus topics）
+- 禁重启生产服务（pi-web 3002 等 restart 须用户明确同意）
+- 禁手改 dist/ 与运行时平铺文件；跨扩展通信走 ctx.services（禁 globalThis.__ext 直穿）
+- 服务端：SQLite 一律 WAL + 分批小事务（批间 setImmediate 让步）；禁 execFileSync 调 >1s 外部程序；>8MB 文件禁同步读
+`;
+}
+
+/** 默认 tools/build.mjs（esbuild 单包零配置；扩展自带 tools/build.mjs 则不走到这里）。 */
+function buildMjsTemplate(extId, extRoot, clientOut, entryRel) {
+  const repoHint = "/home/pi/workspace/pi-work"; // 现场构建探测源码仓 node_modules 用（三机各不同，缺失时走 npm exec）
+  return `/**
+ * ${extId} · 现场构建入口（dev-pack 默认模板，esbuild 单包零配置）
+ * 用法：node tools/build.mjs
+ * 本文件由 dev-pack 生成；复杂构建（多入口/插件链）请参照 src/vite.config.ts 改写本文件或回源码仓构建。
+ */
+"use strict";
+import { existsSync, readdirSync, constants as fsConstants, accessSync } from "node:fs";
+import { join, resolve, dirname, basename, sep as pathSep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const extRoot = resolve(here, "..");
+const clientOut = ${JSON.stringify(clientOut || "dist/client-bundle.mjs")};
+const entryRel = ${JSON.stringify(entryRel || "")};
+
+// esbuild 解析：部署目录 node_modules → 源码仓 node_modules（本机开发场景）→ PATH 上的 esbuild → npm exec 现拉。
+// 注意：node_modules/esbuild/bin/esbuild 是原生二进制（ELF/Mach-O），必须直接执行（不能当 JS 跑）。
+function findEsbuild() {
+  const home = (process.env.HOME || process.env.USERPROFILE || "").split(pathSep).join("/");
+  const candidates = [
+    extRoot + "/node_modules/esbuild/bin/esbuild",
+    home + "/workspace/pi-work/node_modules/esbuild/bin/esbuild",
+    "D:/workspace/pi-work/node_modules/esbuild/bin/esbuild", // 155 win（源码在 D 盘）
+  ];
+  for (const c of candidates) {
+    if (!existsSync(c)) continue;
+    try { accessSync(c, fsConstants.X_OK); return [c]; } catch (e) { /* 无执行位 → 下一个来源 */ }
+  }
+  const r = spawnSync("esbuild", ["--version"], { encoding: "utf8" });
+  if (r.status === 0) return ["esbuild"];
+  return ["npm", "exec", "--yes", "esbuild", "--"];
+}
+
+function pickEntry() {
+  if (entryRel) return entryRel;
+  const srcDir = join(extRoot, "src", "client", "src");
+  if (!existsSync(srcDir)) throw new Error("找不到 client 源码目录 src/client/src");
+  for (const name of ["entry.tsx", "entry.ts", "entry.jsx", "entry.js", "index.tsx", "index.ts"]) {
+    if (existsSync(join(srcDir, name))) return "client/src/" + name;
+  }
+  const first = readdirSync(srcDir).find((f) => /\\.(tsx?|jsx?)$/.test(f));
+  if (!first) throw new Error("client/src 下没有可构建入口");
+  return "client/src/" + first;
+}
+
+// 服务端源码同步：src/ 根级文件（index.ts/core.cjs/package.json/vite.config.ts 等）→ 部署根
+// （服务端没有构建产物——jiti 直接加载部署根文件；不 sync 则「改 src → reload」永远不生效）
+import { readdirSync as _rd, copyFileSync as _cp, statSync as _st } from "node:fs";
+const srcRoot = join(extRoot, "src");
+if (existsSync(srcRoot)) {
+  for (const f of _rd(srcRoot)) {
+    const fp = join(srcRoot, f);
+    if (!_st(fp).isFile()) continue;
+    _cp(fp, join(extRoot, f));
+  }
+  console.log("[build] 服务端源码已从 src/ 同步到部署根");
+}
+
+const entry = pickEntry();
+const args = [join(extRoot, "src", entry), "--bundle", "--format=esm",
+  "--outfile=" + join(extRoot, clientOut), "--jsx=automatic"];
+// pi-web host-shim 委托（react → 本地 shim；jsx-runtime 同理）——与各扩展 vite.config 同款
+const shim = join(extRoot, "src", "client", "src", "host-shim.ts");
+const jsxRuntime = ["jsx-runtime.ts", "jsx-runtime.tsx", "jsx-dev-runtime.ts"].map((f) => join(extRoot, "src", "client", "src", f)).find(existsSync);
+if (existsSync(shim)) args.push("--alias:react=" + shim);
+if (jsxRuntime) args.push("--alias:react/jsx-runtime=" + jsxRuntime);
+args.push("--log-level=info");
+
+const [cmd, ...pre] = findEsbuild();
+console.log("[build] esbuild:", cmd, ...pre);
+const r = spawnSync(cmd, [...pre, ...args], { stdio: "inherit", cwd: extRoot });
+if (r.status !== 0) { console.error("[build] 失败——可参照 src/vite.config.ts 调整本文件后重试，或回源码仓构建"); process.exit(r.status ?? 1); }
+console.log("[build] ✓ " + clientOut + "（reload 后浏览器刷新生效）");
+`;
+}
+
+/**
+ * 主入口：向已存在的部署目录写 dev-pack。
+ * @param {object} opts
+ * @param {string} opts.extRoot   扩展源码根（pi-web-ext/<extId>）
+ * @param {string[]} [opts.targets] 显式部署目录；缺省 = ~/.pi/web{,-dev}/extensions/<extId>（存在的才写）
+ * @param {(m: string) => void} [opts.log]
+ */
+export function packDevPack(opts) {
+  const extRoot = resolve(opts.extRoot);
+  const extId = basename(extRoot);
+  const log = opts.log || (() => {});
+  const targets = (opts.targets || [
+    join(homedir(), ".pi", "web", "extensions", extId),
+    join(homedir(), ".pi", "web-dev", "extensions", extId),
+  ]).filter((t) => existsSync(t));
+  if (!targets.length) return;
+
+  // 1) 打包源码到临时区（staging）→ 逐目标 cpSync（多部署目录零重复扫描）
+  const stage = join(extRoot, "dist", ".dev-pack-staging");
+  rmSync(stage, { recursive: true, force: true });
+  mkdirSync(stage, { recursive: true });
+  try {
+    // src/：根级源码文件 + 源码子目录
+    const srcDir = join(stage, "src");
+    mkdirSync(srcDir, { recursive: true });
+    for (const en of readdirSync(extRoot, { withFileTypes: true })) {
+      if (en.isDirectory()) continue;
+      if (ROOT_SRC_SKIP.has(en.name)) continue;
+      if (!ROOT_SRC_EXTS.has(en.name.slice(en.name.lastIndexOf(".") || 0)) && en.name !== "package.json") continue;
+      cpSync(join(extRoot, en.name), join(srcDir, en.name));
+    }
+    for (const d of SRC_DIRS) {
+      const s = join(extRoot, d);
+      if (!existsSync(s)) continue;
+      copyTree(s, join(srcDir, ...d.split("/")), DIR_SKIP);
+    }
+    for (const f of ["vite.config.ts", "package.json"]) {
+      if (existsSync(join(extRoot, f))) cpSync(join(extRoot, f), join(srcDir, f));
+    }
+    // tools/build.mjs：扩展自带拷真身，否则生成默认 esbuild 版
+    mkdirSync(join(stage, "tools"), { recursive: true });
+    if (existsSync(join(extRoot, "tools", "build.mjs"))) {
+      cpSync(join(extRoot, "tools", "build.mjs"), join(stage, "tools", "build.mjs"));
+    } else {
+      let clientOut = "";
+      try {
+        const pkg = JSON.parse(readFileSync(join(extRoot, "package.json"), "utf8"));
+        if (pkg.client && String(pkg.client).startsWith("dist/")) clientOut = pkg.client;
+      } catch (e) {}
+      if (!clientOut) {
+        // 回退：client 产物名常声明在 entry 的 client: "dist/<id>-client.mjs"（index.ts）——从 staging 的 src 里解析
+        try {
+          for (const f of readdirSync(srcDir)) {
+            if (!/\.tsx?$/.test(f)) continue;
+            const m = readFileSync(join(srcDir, f), "utf8").match(/client\s*:\s*["'`](dist\/[\w.-]+\.mjs)["'`]/);
+            if (m) { clientOut = m[1]; break; }
+          }
+        } catch (e) {}
+      }
+      writeFileSync(join(stage, "tools", "build.mjs"), buildMjsTemplate(extId, extRoot, clientOut, ""));
+    }
+    // tools/deploy.mjs 本身
+    if (existsSync(join(extRoot, "tools", "deploy.mjs"))) {
+      cpSync(join(extRoot, "tools", "deploy.mjs"), join(stage, "tools", "deploy.mjs"));
+    }
+    // AGENTS.md：自带优先，否则模板生成
+    if (existsSync(join(extRoot, "AGENTS.md"))) cpSync(join(extRoot, "AGENTS.md"), join(stage, "AGENTS.md"));
+    else writeFileSync(join(stage, "AGENTS.md"), agentsMdTemplate(extId));
+
+    // 1.5) _shared 依赖：部署 src 里的源码可能相对引用 ../../../_shared/*（源仓出仓路径）——
+    // 部署根放一份 _shared（小体量、纯源码），让现场 build 的模块解析与源仓一致
+    const sharedSrc = resolve(extRoot, "..", "_shared");
+    if (existsSync(sharedSrc)) {
+      const sharedStage = join(stage, "_shared");
+      copyTree(sharedSrc, sharedStage, DIR_SKIP);
+    }
+
+    // 2) 落位（staging → 部署目录；package.json/vite.config.ts 双放：根级按 §3.2 结构，src 内供现场阅读）
+    for (const t of targets) {
+      cpSync(stage, t, { recursive: true });
+      for (const f of ["package.json", "vite.config.ts"]) {
+        if (existsSync(join(stage, f))) cpSync(join(stage, f), join(t, f));
+      }
+    }
+    log(`dev-pack → ${targets.map((t) => t.replace(homedir(), "~")).join(", ")}（AGENTS.md + src/ + tools/）`);
+  } finally {
+    rmSync(stage, { recursive: true, force: true });
+  }
+}

package/dist/controlled-login-client.mjs

@@ -0,0 +1,22 @@
+/**
+ * aiti-claude-code-agent · 受控登录 client（薄壳，paste-relay 模式）。
+ *
+ * 全部 UI/轮询/文案模板在 ./controlled-login-dialog.mjs
+ * （权威源 pi-web-ext/_shared/controlled-login-dialog.mjs 的部署副本，改动须双向同步）——
+ * 本文件只传扩展专属配置。
+ */
+import { registerControlledLoginClient } from "./controlled-login-dialog.mjs";
+
+export default function register(ctx) {
+  registerControlledLoginClient(ctx, {
+    extId: "aiti-claude-code-agent",
+    toolbarLabel: "登录 Claude Code",
+    title: "登录 Claude Code",
+    pasteHint:
+      "后端发起官方 claude auth login（Claude 订阅档），把授权链接交给你——" +
+      "在任意设备的浏览器打开并登录授权后，Claude 的完成页会显示一段一次性 code：" +
+      "把它（或整个回调链接）复制到下方输入框提交，后端原样喂给 login 进程即完成登录。" +
+      "code 一次性且时效短，请拿到后尽快提交。",
+    successHint: null,
+  });
+}