@aiti-ai/aiti-folder 0.0.0-stage → 0.1.9

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@aiti-ai/aiti-folder",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.9",
+  "description": "pi-web 文件夹浏览器扩展（fileViewer folder 接管 + pathPicker 目录选择器）—— JSX + vite 构建 client bundle",
+  "type": "module",
+  "scripts": {
+    "build:client": "vite build --config vite.config.ts",
+    "watch": "vite build --watch --config vite.config.ts",
+    "deploy": "node tools/deploy.mjs"
+  },
+  "dependencies": {
+    "trash": "^10.1.1"
+  },
+  "devDependencies": {
+    "vite": "^6.4.3"
+  },
+  "soul": "目录树不是导航的终点，是操作的起点。",
+  "aitiExtProtocol": "1.0",
+  "license": "MIT",
+  "contentHash": "e8d68bdbd51a25e2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiti-ai/aiti-ai.git",
+    "directory": "extensions/aiti-folder"
+  },
+  "homepage": "https://github.com/aiti-ai/aiti-ai#readme",
+  "bugs": {
+    "url": "https://github.com/aiti-ai/aiti-ai/issues"
+  }
+}

package/reload-instances.mjs

@@ -0,0 +1,60 @@
+/**
+ * _shared/reload-instances.mjs · pi-web 双实例热重载（各扩展 deploy.mjs 共用）
+ *
+ * dev 3001 / 生产 3002；端口可经 AITI_DEV_PORT / AITI_PROD_PORT 覆盖；
+ * basePath 双 env（AITI_DEV_BASE_PATH / AITI_PROD_BASE_PATH）按机器设值，
+ *   推荐值不带斜杠（48：dev 与 空；155：系统级 wdev 与 win）——git-bash 启动
+ *   原生程序时会把 / 开头的 env 值做 MSYS 路径转换（/wdev → D:/apps/Git/wdev）
+ *   致 URL 非法；不带斜杠则不触发转换。此处自动补 /（旧 /xxx 格式仍兼容），
+ *   兼容不了时提示 MSYS_NO_PATHCONV=1。
+ * 避免「server 端代码改了、实例没 reload 导致跑旧逻辑」。
+ *
+ * 用法（静态 import 或顶层 await import 均可）：
+ *   import { reloadInstances } from "../../_shared/reload-instances.mjs";
+ *   await reloadInstances();              // 默认 "[deploy] " 前缀
+ */
+const BASE_PATH_RE = /^\/[A-Za-z0-9._-]*$/;
+
+function buildInstance(name, portEnv, portDefault, pathEnv, pathDefault) {
+  const origin = `http://127.0.0.1:${process.env[portEnv] || portDefault}`;
+  const raw = process.env[pathEnv];
+  if (raw === undefined || raw === null || String(raw).trim() === "") return { name, base: origin + pathDefault };
+  // 自动补 /：wdev → /wdev（推荐无斜杠格式，MSYS 不转换）；/wdev → /wdev（旧格式兼容）
+  const p = "/" + String(raw).trim().replace(/^\/+|\/+$/g, "");
+  if (BASE_PATH_RE.test(p)) return { name, base: origin + p };
+  return { name, base: null, raw };
+}
+
+/** 双实例清单（dev/prod 各 {name, base}）；reload-instances 与 reconcile-deps 等共用。 */
+export function buildInstances() {
+  return [
+    buildInstance("dev", "AITI_DEV_PORT", 3001, "AITI_DEV_BASE_PATH", "/dev"),
+    buildInstance("prod", "AITI_PROD_PORT", 3002, "AITI_PROD_BASE_PATH", ""),
+  ];
+}
+
+export async function reloadInstances(prefix = "[deploy] ") {
+  // 批次合并（deploy-all 场景）：子条目部署脚本被注入 PI_WEB_DEFER_RELOAD=1 时不各自 reload，
+  // 由 deploy-all 在全部条目完成后统一执行一轮（N 条目 × 2 实例 → 2 次 POST）。
+  // 避免批量部署时的 reload 风暴（2026-09-15 实测：65 条目逐个 reload 把 dev 实例打满）。
+  // 单独跑某个扩展 deploy.mjs 不带该 env → 行为不变（部署完立即 reload）。
+  if (process.env.PI_WEB_DEFER_RELOAD === "1") {
+    console.log(`${prefix}reload 已 defer（PI_WEB_DEFER_RELOAD=1，由 deploy-all 收尾统一执行）`);
+    return;
+  }
+  // 允许失败：网络异常/非 2xx/服务未启动/env 非法一律只打提示，永不 throw——不影响 deploy 退出码
+  for (const inst of buildInstances()) {
+    if (inst.base === null) {
+      const msysHint = /[\\:]/.test(inst.raw) ? "——疑似 git-bash MSYS 路径转换，用 MSYS_NO_PATHCONV=1 前缀重跑" : "";
+      console.log(`${prefix}reload ${inst.name} 跳过：AITI_${inst.name.toUpperCase()}_BASE_PATH="${inst.raw}" 非法（须形如 /xxx 或留空）${msysHint}`);
+      continue;
+    }
+    try {
+      const r = await fetch(inst.base + "/api/extensions/reload", { method: "POST" });
+      console.log(`${prefix}reload ${inst.name} → HTTP ${r.status} ${r.ok ? "✓" : "⚠ 失败（请手动 POST /api/extensions/reload）"}`);
+    } catch (e) {
+      const cause = e && e.cause ? String(e.cause.code || e.cause.message || e.cause) : String((e && e.message) || e);
+      console.log(`${prefix}reload ${inst.name} 不可达（${cause}）— 需手动 POST /api/extensions/reload`);
+    }
+  }
+}

package/server/git-plan.test.mjs

@@ -0,0 +1,62 @@
+/**
+ * git-plan · 启发式分组/偏好学习/plan CRUD 测试（git-ops M4）。
+ */
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { groupHeuristic, learn, loadPlan, savePlan, newPlan } from "./git-plan.ts";
+
+const stateDir = mkdtempSync(join(tmpdir(), "gitplan-"));
+
+test("启发式：锁文件进 excluded；目录+类型聚类；conventional 前缀建议", () => {
+  const { groups, excluded } = groupHeuristic(stateDir, [
+    { path: "package-lock.json", status: "modified" },
+    { path: "README.md", status: "modified" },
+    { path: "docs/guide.md", status: "untracked" },
+    { path: "src/foo/a.ts", status: "untracked" },
+    { path: "src/foo/b.ts", status: "untracked" },
+    { path: "src/foo/a.test.ts", status: "untracked" },
+    { path: "lib/util.ts", status: "modified" },
+  ]);
+  assert.deepEqual(excluded, ["package-lock.json"]);
+  const byKey = Object.fromEntries(groups.map((g) => [g.key, g]));
+  // docs 聚合（README + docs/）
+  assert.ok(byKey["docs::docs"] || groups.some((g) => g.key.startsWith("docs")));
+  // src/foo 源码组（测试文件单独）
+  assert.ok(groups.some((g) => g.key === "src/foo::source" && g.files.includes("src/foo/a.ts")));
+  assert.ok(groups.some((g) => g.files.includes("src/foo/a.test.ts") && g.message.startsWith("test(")));
+  // 仅修改的源码组建议 fix:
+  const lib = groups.find((g) => g.key === "lib::source");
+  assert.ok(lib && lib.message.startsWith("fix("));
+  // 全新增组建议 feat:
+  const foo = groups.find((g) => g.key === "src/foo::source");
+  assert.ok(foo && foo.message.startsWith("feat("));
+});
+
+test("偏好学习：move 共现 ≥2 → dirKey 对合并为一组", () => {
+  learn(stateDir, "move", { file: "lib/util.ts", toKey: "src/foo" });
+  learn(stateDir, "move", { file: "lib/other.ts", toKey: "src/foo" });
+  const { groups } = groupHeuristic(stateDir, [
+    { path: "lib/util.ts", status: "modified" },
+    { path: "src/foo/a.ts", status: "untracked" },
+  ]);
+  assert.equal(groups.length, 1, "共现合并生效");
+});
+
+test("偏好学习：exclude 精确路径 → 建议剔除", () => {
+  learn(stateDir, "exclude", { path: "generated/bundle.js" });
+  const { excluded } = groupHeuristic(stateDir, [{ path: "generated/bundle.js", status: "untracked" }]);
+  assert.deepEqual(excluded, ["generated/bundle.js"]);
+});
+
+test("plan CRUD：roundtrip + cwd 哈希隔离", () => {
+  const cwdA = "/tmp/gitplan-a";
+  const plan = savePlan(stateDir, { ...newPlan(cwdA, "abc123"), groups: [{ id: "g1", files: ["a.ts"], message: "feat: a", state: "pending" }], excluded: [] });
+  assert.match(plan.id, /^plan-/);
+  const back = loadPlan(stateDir, cwdA);
+  assert.equal(back?.baseHEAD, "abc123");
+  assert.equal(back?.groups[0].message, "feat: a");
+  assert.equal(loadPlan(stateDir, "/tmp/gitplan-b"), null);
+});

package/server/git-plan.ts

@@ -0,0 +1,196 @@
+/**
+ * git-plan · aiti-folder 提交计划（原 folder 案 §5/§6，git-ops 融合方案 M4）。
+ *
+ * - 启发式分组（两级的第一级，零成本离线）：目录前缀聚类 + 类型规则（锁文件/配置/文档/
+ *   测试/源码）+ 状态修饰（全新增组建议 feat:、仅修改组建议 fix:）；锁文件默认进 excluded 建议。
+ * - 偏好学习（纯本地统计，不上模型）：用户在对话框的纠偏（文件移组=dirKey 共现、剔除=pattern）
+ *   写入 state/grouping-prefs.json；启发式读入——共现 ≥2 的 dirKey 对合并为一组。
+ * - plan CRUD：state 层（不可再生）`<stateDir>/aiti-folder/plan-<hash(cwd)>.json`；
+ *   执行不走这里——客户端直调引擎 `/git/plan/execute`（断点语义）与 `/git/plan/rollback`。
+ *
+ * 服务端红线对照：纯 fs + 同步小 JSON（<8MB 千倍余量）；无 git 子进程（读面全走引擎）。
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+
+export interface PlanGroup {
+  id: string;
+  files: string[];
+  message: string;
+  state: "pending" | "committed" | "failed";
+}
+export interface CommitPlan {
+  id: string;
+  cwd: string;
+  baseHEAD: string;
+  groups: PlanGroup[];
+  excluded: string[];
+  createdAt: number;
+  updatedAt: number;
+}
+
+interface Prefs {
+  /** dirKey 共现权重：用户把两个 dirKey 的文件分进同组 → 计数 +1；≥CO_CHANGE_MIN 合并 */
+  coChange: Record<string, number>;
+  /** 用户剔除过的路径（精确）→ 启发式直接建议 excluded */
+  excludedPaths: string[];
+}
+
+const LOCK_RE = /(^|\/)(package-lock\.json|pnpm-lock\.yaml|yarn\.lock|Cargo\.lock|poetry\.lock|composer\.lock|Gemfile\.lock|go\.sum)$/i;
+const DOC_RE = /(^|\/)(docs?|README|CHANGELOG|LICENSE)|\.(md|mdx|txt)$/i;
+const CFG_RE = /\.(json|ya?ml|toml|ini|conf|env|rc)$/i;
+const TEST_RE = /(^|\/)(tests?|__tests__)(\/|$)|[.\-_](test|spec)\.[a-z]+$/i;
+const CO_CHANGE_MIN = 2;
+const PLAN_CAP = 20; // 计划文件体自防御上限（KB）：正常计划远小于此
+
+const dirKeyOf = (rel: string): string => {
+  const norm = rel.replace(/\\/g, "/");
+  const segs = norm.split("/");
+  if (segs.length <= 1) return "(root)";
+  // src/包名 二级；其余一级
+  if (/^(src|lib|app|packages)$/.test(segs[0]) && segs.length > 2) return `${segs[0]}/${segs[1]}`;
+  return segs[0];
+};
+
+const typeOf = (rel: string): "lock" | "docs" | "config" | "test" | "source" => {
+  if (LOCK_RE.test(rel)) return "lock";
+  if (DOC_RE.test(rel)) return "docs";
+  if (TEST_RE.test(rel)) return "test";
+  if (CFG_RE.test(rel)) return "config";
+  return "source";
+};
+
+const typeRank: Record<string, number> = { docs: 0, config: 1, test: 2, source: 3 };
+
+const suggestType = (rel: string, statuses: string[]): string => {
+  const t = typeOf(rel);
+  if (t === "docs") return "docs";
+  if (t === "config" || t === "lock") return "chore";
+  if (t === "test") return "test";
+  // 源码：组内全为新增 → feat:；含修改 → fix:（启发式猜测，用户可改）
+  return statuses.every((s) => s === "untracked" || s === "added") ? "feat" : "fix";
+};
+
+function loadPrefs(stateDir: string): Prefs {
+  try {
+    const p = JSON.parse(readFileSync(join(stateDir, "aiti-folder", "grouping-prefs.json"), "utf8"));
+    return { coChange: p.coChange ?? {}, excludedPaths: p.excludedPaths ?? [] };
+  } catch {
+    return { coChange: {}, excludedPaths: [] };
+  }
+}
+
+function savePrefs(stateDir: string, prefs: Prefs): void {
+  const f = join(stateDir, "aiti-folder", "grouping-prefs.json");
+  mkdirSync(dirname(f), { recursive: true });
+  writeFileSync(f, JSON.stringify(prefs, null, 2));
+}
+
+/** 启发式分组：输入变更文件（相对路径 + 宿主 status 分类），输出组与 excluded 建议 */
+export function groupHeuristic(
+  stateDir: string,
+  files: { path: string; status?: string }[],
+): { groups: { key: string; message: string; files: string[] }[]; excluded: string[] } {
+  const prefs = loadPrefs(stateDir);
+  const excluded: string[] = [];
+  const buckets = new Map<string, { type: string; files: string[]; statuses: string[] }>();
+
+  for (const f of files) {
+    const rel = String(f.path || "").replace(/\\/g, "/");
+    if (!rel) continue;
+    if (typeOf(rel) === "lock" || prefs.excludedPaths.includes(rel)) {
+      excluded.push(rel);
+      continue;
+    }
+    const dk = dirKeyOf(rel);
+    // 偏好：共现 ≥2 的 dirKey 对合并（合并到 key 排序在前的一方）
+    let key = `${dk}::${typeOf(rel)}`;
+    for (const [pair] of Object.entries(prefs.coChange)) {
+      const [a, b] = pair.split("→");
+      if ((a === dk || b === dk) && prefs.coChange[pair] >= CO_CHANGE_MIN) {
+        const other = a === dk ? b : a;
+        key = `${[dk, other].sort()[0]}::merged`;
+        break;
+      }
+    }
+    const hit = buckets.get(key);
+    if (hit) {
+      hit.files.push(rel);
+      hit.statuses.push(String(f.status ?? "modified"));
+    } else {
+      buckets.set(key, { type: typeOf(rel), files: [rel], statuses: [String(f.status ?? "modified")] });
+    }
+  }
+
+  const groups = [...buckets.entries()]
+    .map(([key, b]) => {
+      const type = b.type === "lock" ? "chore" : b.type;
+      const verb = suggestType(b.files[0], b.statuses);
+      const dirLabel = key.split("::")[0] === "(root)" ? "misc" : key.split("::")[0];
+      const message = `${verb}(${dirLabel}): ${b.files.length} file(s)`;
+      return { key, message, files: b.files.sort() };
+    })
+    .sort((x, y) => (typeRank[x.key.split("::")[1]] ?? 3) - (typeRank[y.key.split("::")[1]] ?? 3) || x.key.localeCompare(y.key));
+
+  return { groups, excluded: excluded.sort() };
+}
+
+/** 偏好学习：用户纠偏回写（move=共现；exclude=精确路径） */
+export function learn(stateDir: string, action: "move" | "exclude", payload: { file?: string; toKey?: string; path?: string }): void {
+  const prefs = loadPrefs(stateDir);
+  if (action === "move" && payload.file && payload.toKey) {
+    const dk = dirKeyOf(String(payload.file).replace(/\\/g, "/"));
+    if (dk !== payload.toKey) {
+      const pair = [dk, payload.toKey].sort().join("→");
+      prefs.coChange[pair] = (prefs.coChange[pair] ?? 0) + 1;
+    }
+  } else if (action === "exclude" && payload.path) {
+    const rel = String(payload.path).replace(/\\/g, "/");
+    if (!prefs.excludedPaths.includes(rel)) prefs.excludedPaths.push(rel);
+  } else {
+    return;
+  }
+  savePrefs(stateDir, prefs);
+}
+
+// ── plan CRUD（state 层；按 cwd 哈希一仓一份）──
+
+const planPath = (stateDir: string, cwd: string): string => {
+  const h = createHash("sha1").update(cwd).digest("hex").slice(0, 12);
+  return join(stateDir, "aiti-folder", `plan-${h}.json`);
+};
+
+export function loadPlan(stateDir: string, cwd: string): CommitPlan | null {
+  const f = planPath(stateDir, cwd);
+  try {
+    if (!existsSync(f)) return null;
+    if (readFileSync(f, "utf8").length > PLAN_CAP * 1024) return null; // 体积自防御：异常大计划拒读
+    const p = JSON.parse(readFileSync(f, "utf8")) as CommitPlan;
+    return p && Array.isArray(p.groups) ? p : null;
+  } catch {
+    return null;
+  }
+}
+
+export function savePlan(stateDir: string, plan: CommitPlan): CommitPlan {
+  if (!plan || plan.cwd !== undefined && typeof plan.cwd !== "string") throw new Error("bad plan");
+  if (!Array.isArray(plan.groups)) throw new Error("bad plan groups");
+  plan.updatedAt = Date.now();
+  const f = planPath(stateDir, plan.cwd);
+  mkdirSync(dirname(f), { recursive: true });
+  writeFileSync(f, JSON.stringify(plan, null, 2));
+  return plan;
+}
+
+export function newPlan(cwd: string, baseHEAD: string): CommitPlan {
+  return {
+    id: "plan-" + createHash("sha1").update(cwd + Date.now()).digest("hex").slice(0, 8),
+    cwd,
+    baseHEAD,
+    groups: [],
+    excluded: [],
+    createdAt: Date.now(),
+    updatedAt: Date.now(),
+  };
+}

package/tools/build-client.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * 构建 aiti-folder JSX client bundle（Vite lib mode → client/aiti-folder-client.mjs）
+ *
+ * 源码：client/src/*.tsx；配置：vite.config.ts。
+ * 用法：node tools/build-client.mjs   （或 npm run watch 自动重建）
+ */
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+
+const root = resolve(fileURLToPath(new URL("..", import.meta.url)));
+
+const viteJs = resolve(root, "node_modules", "vite", "bin", "vite.js");
+const viteBin = existsSync(viteJs) ? viteJs : "vite";
+
+const r = spawnSync(process.execPath, [viteBin, "build", "--config", resolve(root, "vite.config.ts")], {
+  cwd: root,
+  stdio: "inherit",
+  shell: false,
+});
+if (r.status !== 0) {
+  console.error("[aiti-folder] vite build 失败（exit " + r.status + "）。若提示找不到 vite：cd pi-web-ext/aiti-folder && npm install");
+  process.exit(r.status ?? 1);
+}
+console.log("[aiti-folder] JSX client bundle → client/aiti-folder-client.mjs");

package/tools/deploy.mjs

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * aiti-folder · 部署到 ~/.pi/web/extensions/ 与 ~/.pi/web-dev/extensions/（pi-web 双实例）
+ * 构建 JSX client bundle → 拷贝 index.ts + package.json + icon.svg + client/ → 两个扩展目录，
+ * 并在目标目录 npm install（扩展自带依赖，loader 从扩展目录解析 node_modules），热重载双实例。
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, statSync, unlinkSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+import { deployCommit } from "../../_shared/deploy-commit.mjs";
+
+// client TS 残留检查（.mjs 里是合法 JS 语法检查不报、运行时必炸；FAIL 即部署失败）
+{
+  const { checkClientDir } = await import("../../_shared/check-client.mjs");
+  checkClientDir(fileURLToPath(new URL("../client", import.meta.url)), { log: (m) => console.log("[deploy] " + m) });
+}
+
+const root = resolve(import.meta.dirname, "..");
+
+// 0) 客户端 bundle 构建（client/src/*.tsx → client/aiti-folder-client.mjs）
+// 清理源目录陈旧 hash 分块（上次构建产物；emptyOutDir=false 不会自清）
+try {
+  const { readdirSync: rds, unlinkSync: us } = await import("node:fs");
+  for (const f of rds(resolve(root, "dist"))) {
+    if (/^[A-Za-z][\w-]*-[\w-]{8}\.js$/.test(f)) us(resolve(root, "dist", f));
+  }
+} catch { /* noop */ }
+console.log("[deploy] 构建 JSX client bundle…");
+try {
+  execSync("node tools/build-client.mjs", { cwd: root, stdio: "inherit" });
+} catch (e) {
+  console.error("[deploy] 构建失败，中止部署：", e.message);
+  process.exit(1);
+}
+
+const targets = [
+  resolve(homedir(), ".pi", "web", "extensions", "aiti-folder"),
+  resolve(homedir(), ".pi", "web-dev", "extensions", "aiti-folder"),
+];
+const extRepo = resolve(homedir(), ".pi", "web", "extensions");
+
+for (const extDir of targets) {
+  mkdirSync(extDir, { recursive: true });
+  for (const f of ["index.ts", "icon.svg", "package.json"]) {
+    if (existsSync(resolve(root, f))) copyFileSync(resolve(root, f), resolve(extDir, f));
+  }
+  // server/ 模块（git-plan.ts 等）：index.ts import 的服务端文件一并部署
+  if (existsSync(resolve(root, "server"))) {
+    const serverDir = resolve(extDir, "server");
+    mkdirSync(serverDir, { recursive: true });
+    for (const f of readdirSync(resolve(root, "server"))) {
+      if (f.endsWith(".ts") || f.endsWith(".mjs")) copyFileSync(resolve(root, "server", f), resolve(serverDir, f));
+    }
+  }
+  const clientDir = resolve(extDir, "dist");
+  mkdirSync(clientDir, { recursive: true });
+  // 拷贝主 bundle + 全部代码分块（懒加载 v2 D3：FolderBrowser 为独立 hash 分块）
+  for (const f of readdirSync(resolve(root, "dist"))) {
+    if (f.endsWith(".mjs") || f.endsWith(".js")) copyFileSync(resolve(root, "dist", f), resolve(clientDir, f));
+  }
+  // 清理目标目录陈旧 hash 分块（源目录已不含旧名——防历史分块累积）
+  for (const f of readdirSync(clientDir)) {
+    if (f.endsWith(".js") && !existsSync(resolve(root, "dist", f))) { try { unlinkSync(resolve(clientDir, f)); } catch { /* noop */ } }
+  }
+  // 扩展自带依赖（trash 等）：目标目录 npm install（离线优先；package.json 比 lock 新才重装）
+  const lockFile = resolve(extDir, "node_modules", ".package-lock.json");
+  const pkgFile = resolve(extDir, "package.json");
+  const pkgNewer = existsSync(pkgFile) && (!existsSync(lockFile) || statSync(pkgFile).mtimeMs > statSync(lockFile).mtimeMs);
+  if (pkgNewer) {
+    try {
+      execSync("npm install --omit=dev --no-audit --no-fund --prefer-offline", { cwd: extDir, stdio: "ignore" });
+      console.log("[deploy] npm install → " + extDir);
+    } catch (e) {
+      console.warn("[deploy] npm install 失败（" + extDir + "）: " + String(e?.message || e));
+    }
+  }
+  console.log("[deploy] 源码 → " + extDir);
+}
+
+// 双实例热重载：实现收敛到 _shared/reload-instances.mjs（env basePath 双变量按机器设值）——允许失败，不影响 deploy 退出码
+try {
+  const { reloadInstances } = await import("../../_shared/reload-instances.mjs");
+  await reloadInstances();
+} catch (e) {
+  console.log("[deploy] 自动 reload 未执行（" + String((e && e.message) || e) + "）— 需手动 POST /api/extensions/reload");
+}
+console.log("[deploy] 完成。client 刷新页面即新。");
+
+
+deployCommit({ repo: extRepo, name: "aiti-folder", paths: ["aiti-folder"], log: (m) => console.log("[deploy] " + m) });
+
+// ── dev-pack（方案 §3.2：源码+构建工具+AGENTS.md 直达部署目录，AI 可现场直改）——允许失败，不影响 deploy 退出码 ──
+try {
+  const { packDevPack } = await import("../../_shared/dev-pack.mjs");
+  packDevPack({ extRoot: resolve(import.meta.dirname, ".."), log: (m) => console.log("[deploy] " + m) });
+} catch (e) {
+  console.log("[deploy] dev-pack 未执行（" + String((e && e.message) || e) + "）");
+}

package/vite.config.ts

@@ -0,0 +1,43 @@
+/**
+ * aiti-folder client 构建配置（Vite lib mode）——JSX 模板实例。
+ *
+ * client/src/entry.tsx（JSX + TS）→ 单个 ESM bundle：client/aiti-folder-client.mjs
+ * （与 index.ts 的 client 字段一致；产物覆盖原手写版，源码在 git 历史可回溯）。
+ *
+ * 模板与原理：pi-web-ext/templates/ext-jsx-client/ + docs/aiti-ext-jsx-vite-plan.md
+ * 三个必踩的坑（模板已修好，勿回退）：jsx automatic / 正则 alias / external []。
+ */
+import { defineConfig } from "vite";
+import { fileURLToPath } from "node:url";
+
+export default defineConfig({
+  esbuild: {
+    jsx: "automatic",
+    jsxImportSource: "react",
+  },
+  resolve: {
+    alias: [
+      // 正则精确匹配（字符串 alias 是前缀匹配，find 'react' 会吞掉 'react/jsx-runtime'）
+      { find: /^react\/jsx-dev-runtime$/, replacement: fileURLToPath(new URL("client/src/jsx-runtime.ts", import.meta.url)) },
+      { find: /^react\/jsx-runtime$/, replacement: fileURLToPath(new URL("client/src/jsx-runtime.ts", import.meta.url)) },
+      { find: /^react$/, replacement: fileURLToPath(new URL("client/src/host-shim.ts", import.meta.url)) },
+    ],
+  },
+  build: {
+    lib: {
+      entry: fileURLToPath(new URL("client/src/entry.tsx", import.meta.url)),
+      formats: ["es"],
+      fileName: () => "aiti-folder-client.mjs",
+    },
+    outDir: "dist",
+    emptyOutDir: true,
+    target: "es2020",
+    // 薄壳拆分（2026-09-14）：chunk 由浏览器按需直接拉取（不再经宿主批量包二次
+    // minify），必须自身压缩；entry 共享 chunk 同理。
+    minify: true,
+    sourcemap: false,
+    rollupOptions: {
+      external: [], // npm 包全部内联进单个 .mjs
+    },
+  },
+});