@aiti-ai/ext-shared 0.0.0-stage → 0.1.11

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 (131) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +36 -2
  3. package/agent-accounts.test.mjs +227 -0
  4. package/agent-accounts.ts +324 -0
  5. package/agent-capability-contract.test.mjs +129 -0
  6. package/agent-interaction.test.mjs +194 -0
  7. package/agent-interaction.ts +340 -0
  8. package/agent-launch.test.mjs +262 -0
  9. package/agent-spawn-env.test.mjs +169 -0
  10. package/agent-spawn-env.ts +548 -0
  11. package/aiti-editor-inject.mjs +49 -0
  12. package/backend-queue.test.mjs +336 -0
  13. package/backend-queue.ts +469 -0
  14. package/blob-save-route.ts +128 -0
  15. package/cbc-model-catalog.ts +86 -0
  16. package/check-client.mjs +273 -0
  17. package/check-ext-globals.mjs +144 -0
  18. package/controlled-login-dialog.mjs +270 -0
  19. package/controlled-login.mjs +398 -0
  20. package/controlled-login.test.mjs +466 -0
  21. package/convert-saveas.test.mjs +39 -0
  22. package/convert-saveas.ts +170 -0
  23. package/copy-client-bundle.mjs +39 -0
  24. package/cursor-cli-store.ts +377 -0
  25. package/dedupe-fetch.test.mjs +71 -0
  26. package/dedupe-fetch.ts +58 -0
  27. package/deploy-commit.mjs +52 -0
  28. package/dev-pack.mjs +246 -0
  29. package/dock-icons.ts +127 -0
  30. package/esbuild-bin.test.mjs +53 -0
  31. package/esbuild-bin.ts +66 -0
  32. package/exec-async.test.mjs +86 -0
  33. package/exec-async.ts +179 -0
  34. package/ext-display-names.ts +91 -0
  35. package/ext-entry-contracts.test.mjs +131 -0
  36. package/ext-float-dock-core.test.mjs +348 -0
  37. package/ext-float-dock-core.ts +783 -0
  38. package/ext-float-dock-lite.ts +52 -0
  39. package/ext-float-dock.test.mjs +286 -0
  40. package/ext-float-dock.ts +740 -0
  41. package/ext-icons-deploy.mjs +24 -0
  42. package/ext-lazy.test.mjs +186 -0
  43. package/ext-lazy.tsx +183 -0
  44. package/ext-model-state.test.mjs +272 -0
  45. package/ext-model-state.ts +324 -0
  46. package/ext-protocol.mjs +113 -0
  47. package/ext-protocol.test.mjs +88 -0
  48. package/ext-session-usage.test.mjs +219 -0
  49. package/ext-session-usage.ts +507 -0
  50. package/external-cli-governance.ts +153 -0
  51. package/git-ops-client/api.mjs +56 -0
  52. package/git-ops-client/branch-panel.tsx +987 -0
  53. package/git-ops-client/i18n.mjs +328 -0
  54. package/host-tools-allow.test.mjs +46 -0
  55. package/host-tools-allow.ts +84 -0
  56. package/icons/alert.svg +1 -0
  57. package/icons/bookmark.svg +1 -0
  58. package/icons/bot.svg +1 -0
  59. package/icons/chart-column.svg +1 -0
  60. package/icons/check-circle.svg +1 -0
  61. package/icons/clipboard-list.svg +1 -0
  62. package/icons/clock.svg +1 -0
  63. package/icons/coffee.svg +1 -0
  64. package/icons/edit.svg +1 -0
  65. package/icons/eye.svg +1 -0
  66. package/icons/git-branch.svg +1 -0
  67. package/icons/git-commit-horizontal.svg +1 -0
  68. package/icons/globe.svg +1 -0
  69. package/icons/history.svg +1 -0
  70. package/icons/import.svg +1 -0
  71. package/icons/inbox.svg +1 -0
  72. package/icons/key-round.svg +1 -0
  73. package/icons/layout-grid.svg +1 -0
  74. package/icons/mail.svg +1 -0
  75. package/icons/message-circle.svg +1 -0
  76. package/icons/message-square.svg +1 -0
  77. package/icons/meter-vertical.svg +1 -0
  78. package/icons/mic.svg +1 -0
  79. package/icons/monitor.svg +1 -0
  80. package/icons/pen-line.svg +1 -0
  81. package/icons/plug.svg +1 -0
  82. package/icons/radio-dot.svg +1 -0
  83. package/icons/radio.svg +1 -0
  84. package/icons/refresh.svg +1 -0
  85. package/icons/rocket.svg +1 -0
  86. package/icons/search.svg +1 -0
  87. package/icons/shield.svg +1 -0
  88. package/icons/sparkles.svg +1 -0
  89. package/icons/square-kanban.svg +1 -0
  90. package/icons/terminal.svg +1 -0
  91. package/icons/users.svg +1 -0
  92. package/icons/volume-2.svg +1 -0
  93. package/icons/wand.svg +1 -0
  94. package/icons/wrench.svg +1 -0
  95. package/icons/x-circle.svg +1 -0
  96. package/icons/x.svg +1 -0
  97. package/ignore-semantics.ts +76 -0
  98. package/lazy-loading-metrics.mjs +61 -0
  99. package/new-session-cwd.test.mjs +389 -0
  100. package/new-session-cwd.ts +253 -0
  101. package/open-viewer-window.ts +65 -0
  102. package/overlay-back-client.test.mjs +123 -0
  103. package/overlay-back-client.ts +87 -0
  104. package/package.json +65 -4
  105. package/pi-fork-rpc/README.md +12 -0
  106. package/pi-fork-rpc/cli-resolve.test.mjs +42 -0
  107. package/pi-fork-rpc/cli-resolve.ts +79 -0
  108. package/pi-fork-rpc/remote-queue.test.mjs +100 -0
  109. package/pi-fork-rpc/remote-queue.ts +140 -0
  110. package/pi-fork-rpc/spec.ts +106 -0
  111. package/pi-fork-rpc/wire.test.mjs +260 -0
  112. package/pi-fork-rpc/wire.ts +367 -0
  113. package/popup-anchor.ts +45 -0
  114. package/provider-priority-contract.test.mjs +55 -0
  115. package/reconcile-deps.mjs +41 -0
  116. package/reload-instances.mjs +60 -0
  117. package/seed-tool.test.mjs +95 -0
  118. package/seed-tool.ts +88 -0
  119. package/session-recycle.ts +109 -0
  120. package/shared-copy-sync.test.mjs +115 -0
  121. package/soffice-locate.ts +171 -0
  122. package/soffice-panel.ts +239 -0
  123. package/sync-dir.mjs +91 -0
  124. package/sync-dir.test.mjs +101 -0
  125. package/sync-gate.test.mjs +93 -0
  126. package/sync-mirror.test.mjs +85 -0
  127. package/task-list.test.mjs +91 -0
  128. package/task-list.ts +118 -0
  129. package/test-rm-rf.mjs +33 -0
  130. package/ui-dialogs.test.mjs +198 -0
  131. package/ui-dialogs.ts +310 -0
@@ -0,0 +1,58 @@
1
+ // 加载窗口级 fetch 去重(方案 docs/pi-web-load-duplicate-requests-analysis.md §3.1/§3.4;pi-web 宿主侧同款在 pi-web lib/dedupe-fetch.ts)。
2
+ //
3
+ // 只读 GET 的「单飞 + 微缓存」:同 URL 并发请求共享 in-flight promise;成功响应在
4
+ // ttlMs 内直接复用。覆盖的是组件重挂/桌面移动双实例/多消费面在秒级窗口内的重复
5
+ // 请求——不改变任何轮询/SSE 契约(SSE 仍是权威源,兜底快照旧 2~3s 无碍)。
6
+ //
7
+ // 只套「只读、no-store、幂等」的 GET(/api/home、/api/agent/running、*/status 类);
8
+ // 带写语义或每次必须新鲜的请求不要走这里。
9
+
10
+ const DEFAULT_TTL_MS = 2_500;
11
+
12
+ interface CacheEntry {
13
+ /** 解决到**未消费**的原始 Response——clone 分支从这里 tee 出去 */
14
+ promise: Promise<Response>;
15
+ /** 缓存过期时刻(成功响应才设置;0 = 还在飞/失败不缓存) */
16
+ freshUntil: number;
17
+ }
18
+
19
+ const inflight = new Map<string, CacheEntry>();
20
+
21
+ export interface DedupeFetchOptions extends RequestInit {
22
+ /** 成功响应的微缓存时长(默认 2.5s,仅覆盖加载窗口) */
23
+ ttlMs?: number;
24
+ }
25
+
26
+ /**
27
+ * dedupeFetch(url, {ttlMs}):同 URL 并发共享一次网络请求,每个调用方拿各自的
28
+ * Response 克隆(原始 body 永不直接外泄,谁先 .json() 都不影响别人)。
29
+ * - in-flight 合流:第二个并发调用者与首个共享同一次网络往返;
30
+ * - TTL 微缓存:成功(res.ok)响应在 ttlMs 内的新调用零网络直接复用;
31
+ * - 失败响应不缓存(下一个调用者立即重试),只解除 in-flight。
32
+ */
33
+ export function dedupeFetch(url: string, options?: DedupeFetchOptions): Promise<Response> {
34
+ const ttlMs = options?.ttlMs ?? DEFAULT_TTL_MS;
35
+ const hit = inflight.get(url);
36
+ // 仍在飞(freshUntil=0)或缓存新鲜 → 共享;过期才真拉新请求
37
+ if (hit && (hit.freshUntil === 0 || Date.now() < hit.freshUntil)) return hit.promise.then((r) => r.clone());
38
+ const promise = fetch(url, options).then((res) => {
39
+ const entry = inflight.get(url);
40
+ if (entry && entry.promise === promise) {
41
+ // 成功:标记缓存到期时刻;失败:不留缓存(下次调用真拉)
42
+ if (res.ok) entry.freshUntil = Date.now() + ttlMs;
43
+ else inflight.delete(url);
44
+ }
45
+ return res;
46
+ }).catch((err) => {
47
+ const entry = inflight.get(url);
48
+ if (entry && entry.promise === promise) inflight.delete(url);
49
+ throw err;
50
+ });
51
+ inflight.set(url, { promise, freshUntil: 0 });
52
+ return promise.then((r) => r.clone());
53
+ }
54
+
55
+ /** 测试钩子:清空全部缓存态。 */
56
+ export function resetDedupeFetch(): void {
57
+ inflight.clear();
58
+ }
@@ -0,0 +1,52 @@
1
+ /**
2
+ * deploy 脚本共享「部署状态 commit」助手(pi-web-ext 各扩展 tools/deploy.mjs 统一用)。
3
+ *
4
+ * 背景(2026-08-30 排障,session 0cc6ad47 op264):重复部署同内容时
5
+ * `git add -A && git commit` 以 "nothing to commit" exit 1,而 stdio:"ignore" 吞掉
6
+ * stderr,输出「提交失败(忽略):Command failed: …」假报警(msg-smart 实证);
7
+ * 另有 --allow-empty 族每次部署都造空 commit 噪音。本助手统一三态语义:
8
+ * committed → 有暂存变更,已提交
9
+ * clean → 无变更,跳过(不算失败)
10
+ * failed → git 真失败(带 stderr 首行,不阻断部署——部署本体永远优先)
11
+ *
12
+ * 用法:
13
+ * import { deployCommit } from "../../_shared/deploy-commit.mjs";
14
+ * deployCommit({ repo: extRepo, name: "aiti-msg-smart", paths: ["aiti-msg-smart"],
15
+ * log: (m) => console.log("[deploy] " + m) });
16
+ *
17
+ * 红线:本助手永不 throw、不触碰部署产物路径之外的任何东西;只对 <repo> 做
18
+ * add/diff/commit(默认 --no-verify,extRepo 无 hooks,防未来误挂)。
19
+ */
20
+ import { execFileSync } from "node:child_process";
21
+
22
+ export function deployCommit({ repo, name, paths = null, extraMsg = "", ident = false, log = console.log }) {
23
+ const git = (args) =>
24
+ execFileSync("git", args, { cwd: repo, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
25
+ const firstLine = (s) => String(s || "").trim().split("\n")[0];
26
+ try {
27
+ // 暂存:默认只收本扩展子目录(与 add <ext> 行为对齐;避免把别的扩展的
28
+ // 未提交改动卷进本扩展的部署 commit);paths=null 时退回 add -A 全仓。
29
+ git(["add", ...(paths && paths.length ? ["--", ...paths] : ["-A"])]);
30
+ let dirty;
31
+ try {
32
+ git(["diff", "--cached", "--quiet"]);
33
+ dirty = false; // exit 0 = 暂存区与 HEAD 一致
34
+ } catch (e) {
35
+ if (e.status !== 1) throw e; // 1 = 有变更;其他才是真错误
36
+ dirty = true;
37
+ }
38
+ if (!dirty) {
39
+ log("扩展仓库无变化(跳过提交)");
40
+ return { status: "clean" };
41
+ }
42
+ const stamp = new Date().toISOString().replace("T", " ").slice(0, 19);
43
+ const msg = `[deploy] ${name} · ${stamp}${extraMsg ? " · " + extraMsg : ""}`;
44
+ git([...(ident ? ["-c", "user.name=deploy", "-c", "user.email=deploy@local"] : []), "commit", "--no-verify", "-m", msg]);
45
+ log("扩展仓库已提交:" + msg);
46
+ return { status: "committed", msg };
47
+ } catch (e) {
48
+ const reason = firstLine(e.stderr) || firstLine(e.message) || "git error";
49
+ log("提交失败(忽略,不影响部署):" + reason);
50
+ return { status: "failed", reason };
51
+ }
52
+ }
package/dev-pack.mjs ADDED
@@ -0,0 +1,246 @@
1
+ /**
2
+ * pi-web-ext · dev-pack 共享实现(方案 §3.2 / M5:扩展 dev-pack——src + 构建工具 + AGENTS.md 直达部署目录)
3
+ *
4
+ * 目标:用户在 AI 窗对 AI 说「帮我改一下 xxx 扩展」时,AI 能在**部署目录**直接:
5
+ * 读 AGENTS.md → 改 src/ → node tools/build.mjs → curl reload → 浏览器生效,不等回开发机。
6
+ *
7
+ * 各扩展 tools/deploy.mjs 末尾统一追加一段(见本文件同级各 deploy.mjs 模式):
8
+ * const { packDevPack } = await import("../../_shared/dev-pack.mjs");
9
+ * packDevPack({ extRoot: <扩展源码根>, log: console.log });
10
+ *
11
+ * packDevPack 向每个已存在的部署目录(~/.pi/web{,-dev}/extensions/<extId>)写入:
12
+ * AGENTS.md 源码目录有则拷,无则由模板生成(§3.4)
13
+ * src/ client/src/**、根级服务端源码 *.ts/*.cjs/*.mjs、lib/(跳 vendor)、server/、sched/、worker-src/
14
+ * tools/build.mjs 现场构建入口(扩展自带则拷真身,否则生成 esbuild 默认版)
15
+ * tools/deploy.mjs 部署脚本本身(大改后回源码仓重部署的入口)
16
+ * package.json 含 aitiConfigs 声明与 build 脚本
17
+ * vite.config.ts 有则拷
18
+ *
19
+ * 幂等:重复部署整目录覆盖;允许失败:任何异常只 log 不影响 deploy 退出码(调用方 try/catch)。
20
+ */
21
+ "use strict";
22
+ import { homedir } from "node:os";
23
+ import { join, resolve, dirname, basename, sep as pathSep } from "node:path";
24
+ import {
25
+ existsSync, readdirSync, statSync, mkdirSync, cpSync, rmSync, writeFileSync, readFileSync,
26
+ } from "node:fs";
27
+
28
+ // 根级服务端源码文件:拷进 src/(运行时平铺文件在部署根不动,宿主 loader 路径不变)
29
+ const ROOT_SRC_EXTS = new Set([".ts", ".tsx", ".cjs", ".mjs"]);
30
+ const ROOT_SRC_SKIP = new Set(["dist", "node_modules"]);
31
+ // 源码子目录:整目录拷(vendor 类大资产跳过——部署目录本就有运行时副本)
32
+ const SRC_DIRS = ["client/src", "server", "lib", "sched", "worker-src"];
33
+ const DIR_SKIP = new Set(["vendor", "__pycache__", "node_modules"]);
34
+
35
+ function copyTree(src, dest, skip) {
36
+ mkdirSync(dest, { recursive: true });
37
+ for (const en of readdirSync(src, { withFileTypes: true })) {
38
+ if (skip && skip.has(en.name)) continue;
39
+ const s = join(src, en.name), d = join(dest, en.name);
40
+ if (en.isDirectory()) copyTree(s, d, skip);
41
+ else if (en.isFile()) cpSync(s, d);
42
+ }
43
+ }
44
+
45
+ /** AGENTS.md 默认模板(§3.4;扩展自带 AGENTS.md 则不走到这里)。供 CLI 批量生成源码目录版复用。 */
46
+ export function agentsMdTemplate(extId) {
47
+ return `# ${extId} 扩展(部署目录直改指南)
48
+
49
+ ## 结构
50
+ - 运行时文件平铺在本目录根(index.ts / core.cjs …,宿主 loader 按相对路径加载——**禁手改运行时平铺文件**,改 src/ 再 build)
51
+ - \`src/\` 源码(client/src + 服务端 ts/cjs)· \`dist/\` 构建产物(禁手改)· \`tools/\` 构建/部署脚本
52
+ - npm 包形态的扩展:本目录 package.json 含 version 与 aitiConfigs 声明
53
+
54
+ ## 小改现场流程(改文案/样式/小逻辑)
55
+ 1. 改 \`src/\` 下对应源码
56
+ 2. \`node tools/build.mjs\`(client 有构建产物的扩展;纯服务端改动跳过)
57
+ 3. \`curl -X POST http://127.0.0.1:30142/api/extensions/reload\`(dev;prod 20341;外部经 nginx 带 basePath:/dev、/mac、/mdev、/win、/wdev → \`/xxx/api/extensions/reload\`)
58
+ 4. 浏览器刷新页面验证
59
+
60
+ ## 大改回源码仓
61
+ - 源码仓:\`~/workspace/pi-work/pi-web-ext/${extId}/\`(git 管理,deploy 同步回本目录)
62
+ - 改完在源码仓跑 \`node tools/deploy.mjs\`(或仓库根 \`node scripts/deploy-all.mjs --only ${extId}\`)
63
+
64
+ ## 数据目录(数据分层:config / cache)
65
+ - \`ctx.configDir\` 根级 = 配置与关键小状态(aiti-configs 备份范围;小、珍贵、人可读)
66
+ - \`ctx.cacheDir\`(= \`<configDir>/cache/\`)= 可删缓存:db/venv/日志/大文件;rm -rf 后扩展下次访问自动重建
67
+ - \`ctx.dataDir\` 已移除(访问即抛)——新代码禁用
68
+ - 本扩展白名单(永不为 cache 的配置文件)见 package.json \`aitiConfigs.configFiles\`
69
+
70
+ ## 红线
71
+ - 禁轮询(setInterval 拉取);需要等待用事件/回调/SSE(桥的 SSE、aiti-event-bus topics)
72
+ - 禁重启生产服务(pi-web 20341 等 restart 须用户明确同意)
73
+ - 禁手改 dist/ 与运行时平铺文件;跨扩展通信走 ctx.services(禁 globalThis.__ext 直穿)
74
+ - 服务端:SQLite 一律 WAL + 分批小事务(批间 setImmediate 让步);禁 execFileSync 调 >1s 外部程序;>8MB 文件禁同步读
75
+ `;
76
+ }
77
+
78
+ /** 默认 tools/build.mjs(esbuild 单包零配置;扩展自带 tools/build.mjs 则不走到这里)。 */
79
+ function buildMjsTemplate(extId, extRoot, clientOut, entryRel) {
80
+ const repoHint = "/home/pi/workspace/pi-work"; // 现场构建探测源码仓 node_modules 用(三机各不同,缺失时走 npm exec)
81
+ return `/**
82
+ * ${extId} · 现场构建入口(dev-pack 默认模板,esbuild 单包零配置)
83
+ * 用法:node tools/build.mjs
84
+ * 本文件由 dev-pack 生成;复杂构建(多入口/插件链)请参照 src/vite.config.ts 改写本文件或回源码仓构建。
85
+ */
86
+ "use strict";
87
+ import { existsSync, readdirSync, constants as fsConstants, accessSync } from "node:fs";
88
+ import { join, resolve, dirname, basename, sep as pathSep } from "node:path";
89
+ import { fileURLToPath } from "node:url";
90
+ import { spawnSync } from "node:child_process";
91
+
92
+ const here = dirname(fileURLToPath(import.meta.url));
93
+ const extRoot = resolve(here, "..");
94
+ const clientOut = ${JSON.stringify(clientOut || "dist/client-bundle.mjs")};
95
+ const entryRel = ${JSON.stringify(entryRel || "")};
96
+
97
+ // esbuild 解析:部署目录 node_modules → 源码仓 node_modules(本机开发场景)→ PATH 上的 esbuild → npm exec 现拉。
98
+ // 注意:node_modules/esbuild/bin/esbuild 是原生二进制(ELF/Mach-O),必须直接执行(不能当 JS 跑)。
99
+ function findEsbuild() {
100
+ const home = (process.env.HOME || process.env.USERPROFILE || "").split(pathSep).join("/");
101
+ const candidates = [
102
+ extRoot + "/node_modules/esbuild/bin/esbuild",
103
+ home + "/workspace/pi-work/node_modules/esbuild/bin/esbuild",
104
+ "D:/workspace/pi-work/node_modules/esbuild/bin/esbuild", // 155 win(源码在 D 盘)
105
+ ];
106
+ for (const c of candidates) {
107
+ if (!existsSync(c)) continue;
108
+ try { accessSync(c, fsConstants.X_OK); return [c]; } catch (e) { /* 无执行位 → 下一个来源 */ }
109
+ }
110
+ const r = spawnSync("esbuild", ["--version"], { encoding: "utf8" });
111
+ if (r.status === 0) return ["esbuild"];
112
+ return ["npm", "exec", "--yes", "esbuild", "--"];
113
+ }
114
+
115
+ function pickEntry() {
116
+ if (entryRel) return entryRel;
117
+ const srcDir = join(extRoot, "src", "client", "src");
118
+ if (!existsSync(srcDir)) throw new Error("找不到 client 源码目录 src/client/src");
119
+ for (const name of ["entry.tsx", "entry.ts", "entry.jsx", "entry.js", "index.tsx", "index.ts"]) {
120
+ if (existsSync(join(srcDir, name))) return "client/src/" + name;
121
+ }
122
+ const first = readdirSync(srcDir).find((f) => /\\.(tsx?|jsx?)$/.test(f));
123
+ if (!first) throw new Error("client/src 下没有可构建入口");
124
+ return "client/src/" + first;
125
+ }
126
+
127
+ // 服务端源码同步:src/ 根级文件(index.ts/core.cjs/package.json/vite.config.ts 等)→ 部署根
128
+ // (服务端没有构建产物——jiti 直接加载部署根文件;不 sync 则「改 src → reload」永远不生效)
129
+ import { readdirSync as _rd, copyFileSync as _cp, statSync as _st } from "node:fs";
130
+ const srcRoot = join(extRoot, "src");
131
+ if (existsSync(srcRoot)) {
132
+ for (const f of _rd(srcRoot)) {
133
+ const fp = join(srcRoot, f);
134
+ if (!_st(fp).isFile()) continue;
135
+ _cp(fp, join(extRoot, f));
136
+ }
137
+ console.log("[build] 服务端源码已从 src/ 同步到部署根");
138
+ }
139
+
140
+ const entry = pickEntry();
141
+ const args = [join(extRoot, "src", entry), "--bundle", "--format=esm",
142
+ "--outfile=" + join(extRoot, clientOut), "--jsx=automatic"];
143
+ // pi-web host-shim 委托(react → 本地 shim;jsx-runtime 同理)——与各扩展 vite.config 同款
144
+ const shim = join(extRoot, "src", "client", "src", "host-shim.ts");
145
+ const jsxRuntime = ["jsx-runtime.ts", "jsx-runtime.tsx", "jsx-dev-runtime.ts"].map((f) => join(extRoot, "src", "client", "src", f)).find(existsSync);
146
+ if (existsSync(shim)) args.push("--alias:react=" + shim);
147
+ if (jsxRuntime) args.push("--alias:react/jsx-runtime=" + jsxRuntime);
148
+ args.push("--log-level=info");
149
+
150
+ const [cmd, ...pre] = findEsbuild();
151
+ console.log("[build] esbuild:", cmd, ...pre);
152
+ const r = spawnSync(cmd, [...pre, ...args], { stdio: "inherit", cwd: extRoot });
153
+ if (r.status !== 0) { console.error("[build] 失败——可参照 src/vite.config.ts 调整本文件后重试,或回源码仓构建"); process.exit(r.status ?? 1); }
154
+ console.log("[build] ✓ " + clientOut + "(reload 后浏览器刷新生效)");
155
+ `;
156
+ }
157
+
158
+ /**
159
+ * 主入口:向已存在的部署目录写 dev-pack。
160
+ * @param {object} opts
161
+ * @param {string} opts.extRoot 扩展源码根(pi-web-ext/<extId>)
162
+ * @param {string[]} [opts.targets] 显式部署目录;缺省 = ~/.pi/web{,-dev}/extensions/<extId>(存在的才写)
163
+ * @param {(m: string) => void} [opts.log]
164
+ */
165
+ export function packDevPack(opts) {
166
+ const extRoot = resolve(opts.extRoot);
167
+ const extId = basename(extRoot);
168
+ const log = opts.log || (() => {});
169
+ const targets = (opts.targets || [
170
+ join(homedir(), ".pi", "web", "extensions", extId),
171
+ join(homedir(), ".pi", "web-dev", "extensions", extId),
172
+ ]).filter((t) => existsSync(t));
173
+ if (!targets.length) return;
174
+
175
+ // 1) 打包源码到临时区(staging)→ 逐目标 cpSync(多部署目录零重复扫描)
176
+ const stage = join(extRoot, "dist", ".dev-pack-staging");
177
+ rmSync(stage, { recursive: true, force: true });
178
+ mkdirSync(stage, { recursive: true });
179
+ try {
180
+ // src/:根级源码文件 + 源码子目录
181
+ const srcDir = join(stage, "src");
182
+ mkdirSync(srcDir, { recursive: true });
183
+ for (const en of readdirSync(extRoot, { withFileTypes: true })) {
184
+ if (en.isDirectory()) continue;
185
+ if (ROOT_SRC_SKIP.has(en.name)) continue;
186
+ if (!ROOT_SRC_EXTS.has(en.name.slice(en.name.lastIndexOf(".") || 0)) && en.name !== "package.json") continue;
187
+ cpSync(join(extRoot, en.name), join(srcDir, en.name));
188
+ }
189
+ for (const d of SRC_DIRS) {
190
+ const s = join(extRoot, d);
191
+ if (!existsSync(s)) continue;
192
+ copyTree(s, join(srcDir, ...d.split("/")), DIR_SKIP);
193
+ }
194
+ for (const f of ["vite.config.ts", "package.json"]) {
195
+ if (existsSync(join(extRoot, f))) cpSync(join(extRoot, f), join(srcDir, f));
196
+ }
197
+ // tools/build.mjs:扩展自带拷真身,否则生成默认 esbuild 版
198
+ mkdirSync(join(stage, "tools"), { recursive: true });
199
+ if (existsSync(join(extRoot, "tools", "build.mjs"))) {
200
+ cpSync(join(extRoot, "tools", "build.mjs"), join(stage, "tools", "build.mjs"));
201
+ } else {
202
+ let clientOut = "";
203
+ try {
204
+ const pkg = JSON.parse(readFileSync(join(extRoot, "package.json"), "utf8"));
205
+ if (pkg.client && String(pkg.client).startsWith("dist/")) clientOut = pkg.client;
206
+ } catch (e) {}
207
+ if (!clientOut) {
208
+ // 回退:client 产物名常声明在 entry 的 client: "dist/<id>-client.mjs"(index.ts)——从 staging 的 src 里解析
209
+ try {
210
+ for (const f of readdirSync(srcDir)) {
211
+ if (!/\.tsx?$/.test(f)) continue;
212
+ const m = readFileSync(join(srcDir, f), "utf8").match(/client\s*:\s*["'`](dist\/[\w.-]+\.mjs)["'`]/);
213
+ if (m) { clientOut = m[1]; break; }
214
+ }
215
+ } catch (e) {}
216
+ }
217
+ writeFileSync(join(stage, "tools", "build.mjs"), buildMjsTemplate(extId, extRoot, clientOut, ""));
218
+ }
219
+ // tools/deploy.mjs 本身
220
+ if (existsSync(join(extRoot, "tools", "deploy.mjs"))) {
221
+ cpSync(join(extRoot, "tools", "deploy.mjs"), join(stage, "tools", "deploy.mjs"));
222
+ }
223
+ // AGENTS.md:自带优先,否则模板生成
224
+ if (existsSync(join(extRoot, "AGENTS.md"))) cpSync(join(extRoot, "AGENTS.md"), join(stage, "AGENTS.md"));
225
+ else writeFileSync(join(stage, "AGENTS.md"), agentsMdTemplate(extId));
226
+
227
+ // 1.5) _shared 依赖:部署 src 里的源码可能相对引用 ../../../_shared/*(源仓出仓路径)——
228
+ // 部署根放一份 _shared(小体量、纯源码),让现场 build 的模块解析与源仓一致
229
+ const sharedSrc = resolve(extRoot, "..", "_shared");
230
+ if (existsSync(sharedSrc)) {
231
+ const sharedStage = join(stage, "_shared");
232
+ copyTree(sharedSrc, sharedStage, DIR_SKIP);
233
+ }
234
+
235
+ // 2) 落位(staging → 部署目录;package.json/vite.config.ts 双放:根级按 §3.2 结构,src 内供现场阅读)
236
+ for (const t of targets) {
237
+ cpSync(stage, t, { recursive: true });
238
+ for (const f of ["package.json", "vite.config.ts"]) {
239
+ if (existsSync(join(stage, f))) cpSync(join(stage, f), join(t, f));
240
+ }
241
+ }
242
+ log(`dev-pack → ${targets.map((t) => t.replace(homedir(), "~")).join(", ")}(AGENTS.md + src/ + tools/)`);
243
+ } finally {
244
+ rmSync(stage, { recursive: true, force: true });
245
+ }
246
+ }
package/dock-icons.ts ADDED
@@ -0,0 +1,127 @@
1
+ /**
2
+ * _shared/dock-icons.ts — dock 体系操作图标(方位 / 移动 / 导航)的**单一数据源**。
3
+ *
4
+ * 用途(方案 docs/pi-web-dock-icon-row-plan.md):
5
+ * · 位置菜单「方位图标排」(浮窗 / 左栏 / 右栏 / 预留底部)——D1 React / D2·D3 DOM 多端一致;
6
+ * · DockBody ⋮「上移 / 下移」移动图标;
7
+ * · 导航类字符按钮图标化(chevron-left/right、arrow-up)。
8
+ *
9
+ * 设计约定:
10
+ * · 不依赖 react、不读部署资产——区别于 `_shared/icons/*.svg`(扩展条目图标契约,需宿主
11
+ * loader/copyIcons 部署);本文件是纯节点数据 + 双端渲染 helper,构建时按现有机制内联进
12
+ * 各消费 bundle,零部署资产、零运行时请求。
13
+ * · 图形规范(与现有头行内联 SVG 一致):viewBox 0 0 24 24、stroke=2、round 线稿(lucide 同款)。
14
+ * · 节点用数据描述(tag + attrs)而非字符串,React 端 `h(tag, attrs)` 与 DOM 端
15
+ * `createElementNS` 各自组装,无 innerHTML / dangerouslySetInnerHTML。
16
+ */
17
+
18
+ export type DockIconName =
19
+ | "float" | "new-window" | "panel-left" | "panel-right" | "panel-bottom"
20
+ | "chevron-up" | "chevron-down" | "chevron-left" | "chevron-right" | "arrow-up"
21
+ | "pin" | "x" | "trash" | "move-diagonal-2";
22
+
23
+ /** 单个 SVG 子节点(attrs 用 SVG 原生名;全部小写、React/DOM 双兼容)。 */
24
+ export interface DockIconNode {
25
+ tag: "path" | "rect" | "circle" | "line" | "polyline";
26
+ attrs: Record<string, string | number>;
27
+ }
28
+
29
+ const P = (d: string): DockIconNode => ({ tag: "path", attrs: { d } });
30
+ const R = (x: number, y: number, width: number, height: number, rx = 2): DockIconNode =>
31
+ ({ tag: "rect", attrs: { x, y, width, height, rx } });
32
+
33
+ /** 图标节点表(lucide 图形;「方框+粗边」= panel-* 家族,与截图同款语言)。 */
34
+ export const DOCK_ICON_NODES: Record<DockIconName, DockIconNode[]> = {
35
+ /** 浮窗:圆角框 + 标题栏 + 圆点(app-window;用户 2026-09-15 定稿 C)。 */
36
+ float: [
37
+ R(2, 4, 20, 16, 2),
38
+ P("M10 4v4"),
39
+ P("M2 8h20"),
40
+ P("M6 4v4"),
41
+ ],
42
+ /** 新窗口打开:方框 + 右上外斜箭头(square-arrow-out-up-right;
43
+ * 用户 2026-09-15 拍板:B 图形用作「新窗口打开」,且仅支持的面板(文件/文件夹)显示)。 */
44
+ "new-window": [
45
+ P("M21 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h6"),
46
+ P("m21 3-9 9"),
47
+ P("M15 3h6v6"),
48
+ ],
49
+ /** 左栏:方框 + 左缘粗边。 */
50
+ "panel-left": [R(3, 3, 18, 18), P("M9 3v18")],
51
+ /** 右栏:方框 + 右缘粗边。 */
52
+ "panel-right": [R(3, 3, 18, 18), P("M15 3v18")],
53
+ /** 底部(预留位):方框 + 下缘粗边。 */
54
+ "panel-bottom": [R(3, 3, 18, 18), P("M3 15h18")],
55
+ "chevron-up": [P("m18 15-6-6-6 6")],
56
+ "chevron-down": [P("m6 9 6 6 6-6")],
57
+ "chevron-left": [P("m15 18-6-6 6-6")],
58
+ "chevron-right": [P("m9 18 6-6-6-6")],
59
+ "arrow-up": [P("m5 12 7-7 7 7"), P("M12 19V5")],
60
+ /** 钉住:图钉(lucide pin;⋮ 区块操作「钉住」,与 aiti-folder MiPin 同形)。 */
61
+ pin: [
62
+ { tag: "line", attrs: { x1: 12, y1: 17, x2: 12, y2: 22 } },
63
+ P("M5 17h14v-1.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V6h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1v4.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24Z"),
64
+ ],
65
+ /** 关闭:×(lucide x;⋮ 区块操作「关闭」)。 */
66
+ x: [P("M18 6 6 18"), P("m6 6 12 12")],
67
+ /** 移除本实例:垃圾桶(lucide trash;多实例区块 ⋮「移除本实例」,与 aiti-folder MiTrash 同形)。 */
68
+ trash: [
69
+ { tag: "polyline", attrs: { points: "3 6 5 6 21 6" } },
70
+ P("M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"),
71
+ { tag: "line", attrs: { x1: 10, y1: 11, x2: 10, y2: 17 } },
72
+ { tag: "line", attrs: { x1: 14, y1: 11, x2: 14, y2: 17 } },
73
+ ],
74
+ /** 移动:对角双箭头(lucide move-diagonal-2;⋮「移动」行首图标——左上 + 右下,用户 2026-09-15 指定)。 */
75
+ "move-diagonal-2": [
76
+ P("M5 11V5h6"),
77
+ P("M19 13v6h-6"),
78
+ P("M5 5l14 14"),
79
+ ],
80
+ };
81
+
82
+ /** zone / 位置 → 方位图标名(D1/D2/D3 位置菜单数据共用)。 */
83
+ export function dockIconOfZone(zone: string): DockIconName {
84
+ if (zone === "float" || zone === "floating") return "float";
85
+ if (zone === "sidebar-explorer" || zone.startsWith("sidebar:")) return "panel-left";
86
+ if (zone === "bottom-panel" || zone.startsWith("bottom:")) return "panel-bottom";
87
+ return "panel-right";
88
+ }
89
+
90
+ /* ── DOM 端(D2 aiti-float / D3 降级菜单;core 亦可 re-export)── */
91
+
92
+ const SVG_NS = "http://www.w3.org/2000/svg";
93
+
94
+ /** 构造一个完整 svg 元素(currentColor / stroke=2 / round;aria-hidden)。 */
95
+ export function createDockIconSvg(name: DockIconName, size = 16): SVGElement {
96
+ const svg = document.createElementNS(SVG_NS, "svg");
97
+ svg.setAttribute("viewBox", "0 0 24 24");
98
+ svg.setAttribute("width", String(size));
99
+ svg.setAttribute("height", String(size));
100
+ svg.setAttribute("fill", "none");
101
+ svg.setAttribute("stroke", "currentColor");
102
+ svg.setAttribute("stroke-width", "2");
103
+ svg.setAttribute("stroke-linecap", "round");
104
+ svg.setAttribute("stroke-linejoin", "round");
105
+ svg.setAttribute("aria-hidden", "true");
106
+ for (const node of DOCK_ICON_NODES[name] ?? []) {
107
+ const el = document.createElementNS(SVG_NS, node.tag);
108
+ for (const [k, v] of Object.entries(node.attrs)) el.setAttribute(k, String(v));
109
+ svg.appendChild(el);
110
+ }
111
+ return svg;
112
+ }
113
+
114
+ /* ── React 端(D1 ext-float-dock.ts 与各扩展):消费方以 ctx.h / JSX 组装 ──
115
+ * 用法(h 版):
116
+ * h("svg", { width: 16, height: 16, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor",
117
+ * strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true" },
118
+ * ...DOCK_ICON_NODES[name].map((n, i) => h(n.tag, { key: i, ...n.attrs })))
119
+ * 此处提供 SVG 根属性常量,避免两端漂移。 */
120
+ export const DOCK_ICON_SVG_ROOT_PROPS = {
121
+ viewBox: "0 0 24 24",
122
+ fill: "none",
123
+ stroke: "currentColor",
124
+ strokeWidth: 2,
125
+ strokeLinecap: "round",
126
+ strokeLinejoin: "round",
127
+ } as const;
@@ -0,0 +1,53 @@
1
+ /**
2
+ * esbuild-bin 共享层用例——钉死「派生形态按平台解析」这条契约。
3
+ *
4
+ * 回归背景:esbuild 的 `bin/esbuild` 在 Linux/macOS 被 postinstall 换成原生二进制(`node <bin>` 必炸),
5
+ * 在 Windows 是带 shebang 的 JS 包装(CreateProcess 不认,直接 exec 报 ENOENT),
6
+ * `.bin/esbuild` 在 Windows 又是 /bin/sh 垫片(spawn 必 ENOENT)。两侧各修一次的 ping-pong
7
+ * 发生过两回(本仓 node 直跑 → 48 端改直接 exec 2026-09-19),收口到本层后由这里把关。
8
+ *
9
+ * Run: node scripts/test-web-ext.mjs --only _shared
10
+ */
11
+ import { test } from "node:test";
12
+ import assert from "node:assert/strict";
13
+ import { existsSync, readFileSync } from "node:fs";
14
+ import { dirname, join } from "node:path";
15
+ import { fileURLToPath } from "node:url";
16
+ import { resolveEsbuildSpawn, runEsbuild } from "./esbuild-bin.ts";
17
+
18
+ const here = dirname(fileURLToPath(import.meta.url));
19
+ const nm = join(here, "..", "aiti-float", "node_modules");
20
+ const pkgEntry = join(nm, "esbuild", "bin", "esbuild");
21
+ const shimEntry = join(nm, ".bin", "esbuild");
22
+ const expectedVersion = existsSync(join(nm, "esbuild", "package.json"))
23
+ ? JSON.parse(readFileSync(join(nm, "esbuild", "package.json"), "utf8")).version
24
+ : null;
25
+
26
+ const cases = [
27
+ ["包内入口 esbuild/bin/esbuild", pkgEntry],
28
+ [".bin 垫片(Windows 上是 sh 脚本)", shimEntry],
29
+ ];
30
+
31
+ // 官方平台包在位时,两种入口都必须解析到它(曾经写死「上溯两级」,对三级深度的
32
+ // esbuild/bin/esbuild 恒不命中,平台分支形同虚设)。
33
+ const platformPkg = join(nm, "@esbuild", `${process.platform}-${process.arch}`);
34
+ const wantPlatformBin = existsSync(platformPkg);
35
+
36
+ for (const [label, bin] of cases) {
37
+ if (!existsSync(bin)) continue; // 未装该扩展依赖的环境干净跳过
38
+ test(`esbuild 派生可跑通:${label}`, async () => {
39
+ const { cmd } = resolveEsbuildSpawn(bin);
40
+ assert.ok(existsSync(cmd), `解析出的 cmd 必须真实存在:${cmd}`);
41
+ if (wantPlatformBin) {
42
+ assert.ok(cmd.startsWith(platformPkg), `平台包在位时必须走它,实际 ${cmd}`);
43
+ }
44
+ // 派生的本体不能是「要 shell 才认」的脚本(Windows CreateProcess 会 ENOENT):
45
+ // 要么原生二进制,要么走 node 直跑(prefix 非空)。
46
+ if (process.platform === "win32") {
47
+ const head = readFileSync(cmd).subarray(0, 2).toString("utf8");
48
+ assert.notEqual(head, "#!", `win32 上直接 exec 的目标不能是 shebang 文本:${cmd}`);
49
+ }
50
+ const out = await runEsbuild(bin, ["--version"]);
51
+ assert.equal(out.trim(), expectedVersion, "两种写法必须解析到同一个 esbuild");
52
+ });
53
+ }
package/esbuild-bin.ts ADDED
@@ -0,0 +1,66 @@
1
+ /**
2
+ * esbuild 派生的平台形态差异收口(测试打包范式唯一入口,勿在调用侧再判平台)。
3
+ *
4
+ * esbuild 在三种位置上的 `bin/esbuild` 不是同一种东西:
5
+ * - Linux/macOS 安装后 postinstall 把它换成**原生二进制**(ELF/Mach-O)→ 只能直接 exec,
6
+ * `node <bin>` 必炸 SyntaxError(2026-09-19 48 端实测,上游为此把 9 个用例改成直接 exec);
7
+ * - 未跑 postinstall / Windows 装的是**带 node shebang 的 JS 包装**→ Windows 的
8
+ * CreateProcess 不认 shebang 文本文件,直接 exec 报 ENOENT(本机实测),只能 `node <bin>`;
9
+ * - `node_modules/.bin/esbuild` 在 Windows 是 /bin/sh 的脚本垫片(还有 .cmd/.ps1 两份),
10
+ * 从原生 Node spawn 一律 ENOENT(§0.1 硬规则)。
11
+ *
12
+ * 首选各平台都有的官方二进制包 `@esbuild/<platform>-<arch>`(esbuild 自己的 JS API 也这么找),
13
+ * 落空再按文件头两字节判 shebang 决定直接 exec 还是 `node` 直跑。
14
+ */
15
+ import { existsSync, closeSync, openSync, readSync, statSync } from "node:fs";
16
+ import { dirname, join } from "node:path";
17
+ import { execFileAsync, type ExecAsyncOpts } from "./exec-async.ts";
18
+
19
+ /** 文件头是不是 `#!`(shebang 文本文件在 Windows 不可 exec)。 */
20
+ function shebangLine(p: string): string | null {
21
+ const fd = openSync(p, "r");
22
+ try {
23
+ const buf = Buffer.alloc(64);
24
+ const n = readSync(fd, buf, 0, buf.length, 0);
25
+ if (n < 2 || buf[0] !== 0x23 || buf[1] !== 0x21) return null;
26
+ const end = buf.subarray(0, n).indexOf(0x0a);
27
+ return buf.subarray(2, end < 0 ? n : end).toString("utf8").trim();
28
+ } finally {
29
+ closeSync(fd);
30
+ }
31
+ }
32
+
33
+ /**
34
+ * 官方平台二进制:从给定路径逐级上溯找 `node_modules/@esbuild/<platform>-<arch>`。
35
+ * 两种入口深度不同(`<nm>/esbuild/bin/esbuild` 三级、`<nm>/.bin/esbuild` 两级),
36
+ * 且 pnpm/hoisted 安装还可能命中更上层的 node_modules,故不写死级数。
37
+ */
38
+ function platformBin(esbuildPath: string): string | null {
39
+ const tail = process.platform === "win32" ? ["esbuild.exe"] : ["bin", "esbuild"];
40
+ for (let dir = dirname(esbuildPath); ; dir = dirname(dir)) {
41
+ const cand = join(dir, "@esbuild", `${process.platform}-${process.arch}`, ...tail);
42
+ if (existsSync(cand) && statSync(cand).isFile()) return cand;
43
+ if (dirname(dir) === dir) return null; // 到盘根/根目录即止
44
+ }
45
+ }
46
+
47
+ /**
48
+ * 解析出可直接 spawn 的 `[cmd, 前置参数]`(前置参数非空即 `node <JS 入口>` 形态)。
49
+ * 传参用调用侧原有路径(`.../esbuild/bin/esbuild` 或 `.../.bin/esbuild`),本函数自行改判。
50
+ */
51
+ export function resolveEsbuildSpawn(esbuildPath: string): { cmd: string; prefix: string[] } {
52
+ const native = platformBin(esbuildPath);
53
+ if (native) return { cmd: native, prefix: [] };
54
+ if (existsSync(esbuildPath)) {
55
+ const head = shebangLine(esbuildPath);
56
+ if (head === null) return { cmd: esbuildPath, prefix: [] }; // 原生二进制
57
+ if (/node(\s|$)/.test(head)) return { cmd: process.execPath, prefix: [esbuildPath] };
58
+ }
59
+ return { cmd: esbuildPath, prefix: [] }; // 原样交给 spawn,报真实 ENOENT 而不是这里编造原因
60
+ }
61
+
62
+ /** 跑一次 esbuild CLI(args 原样透传,如 `["entry.ts", "--bundle", "--outfile=..."]`)。 */
63
+ export function runEsbuild(esbuildPath: string, args: string[], opts: ExecAsyncOpts = {}): Promise<string> {
64
+ const { cmd, prefix } = resolveEsbuildSpawn(esbuildPath);
65
+ return execFileAsync(cmd, [...prefix, ...args], opts);
66
+ }