@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.
- package/LICENSE +21 -0
- package/README.md +36 -2
- package/agent-accounts.test.mjs +227 -0
- package/agent-accounts.ts +324 -0
- package/agent-capability-contract.test.mjs +129 -0
- package/agent-interaction.test.mjs +194 -0
- package/agent-interaction.ts +340 -0
- package/agent-launch.test.mjs +262 -0
- package/agent-spawn-env.test.mjs +169 -0
- package/agent-spawn-env.ts +548 -0
- package/aiti-editor-inject.mjs +49 -0
- package/backend-queue.test.mjs +336 -0
- package/backend-queue.ts +469 -0
- package/blob-save-route.ts +128 -0
- package/cbc-model-catalog.ts +86 -0
- package/check-client.mjs +273 -0
- package/check-ext-globals.mjs +144 -0
- package/controlled-login-dialog.mjs +270 -0
- package/controlled-login.mjs +398 -0
- package/controlled-login.test.mjs +466 -0
- package/convert-saveas.test.mjs +39 -0
- package/convert-saveas.ts +170 -0
- package/copy-client-bundle.mjs +39 -0
- package/cursor-cli-store.ts +377 -0
- package/dedupe-fetch.test.mjs +71 -0
- package/dedupe-fetch.ts +58 -0
- package/deploy-commit.mjs +52 -0
- package/dev-pack.mjs +246 -0
- package/dock-icons.ts +127 -0
- package/esbuild-bin.test.mjs +53 -0
- package/esbuild-bin.ts +66 -0
- package/exec-async.test.mjs +86 -0
- package/exec-async.ts +179 -0
- package/ext-display-names.ts +91 -0
- package/ext-entry-contracts.test.mjs +131 -0
- package/ext-float-dock-core.test.mjs +348 -0
- package/ext-float-dock-core.ts +783 -0
- package/ext-float-dock-lite.ts +52 -0
- package/ext-float-dock.test.mjs +286 -0
- package/ext-float-dock.ts +740 -0
- package/ext-icons-deploy.mjs +24 -0
- package/ext-lazy.test.mjs +186 -0
- package/ext-lazy.tsx +183 -0
- package/ext-model-state.test.mjs +272 -0
- package/ext-model-state.ts +324 -0
- package/ext-protocol.mjs +113 -0
- package/ext-protocol.test.mjs +88 -0
- package/ext-session-usage.test.mjs +219 -0
- package/ext-session-usage.ts +507 -0
- package/external-cli-governance.ts +153 -0
- package/git-ops-client/api.mjs +56 -0
- package/git-ops-client/branch-panel.tsx +987 -0
- package/git-ops-client/i18n.mjs +328 -0
- package/host-tools-allow.test.mjs +46 -0
- package/host-tools-allow.ts +84 -0
- package/icons/alert.svg +1 -0
- package/icons/bookmark.svg +1 -0
- package/icons/bot.svg +1 -0
- package/icons/chart-column.svg +1 -0
- package/icons/check-circle.svg +1 -0
- package/icons/clipboard-list.svg +1 -0
- package/icons/clock.svg +1 -0
- package/icons/coffee.svg +1 -0
- package/icons/edit.svg +1 -0
- package/icons/eye.svg +1 -0
- package/icons/git-branch.svg +1 -0
- package/icons/git-commit-horizontal.svg +1 -0
- package/icons/globe.svg +1 -0
- package/icons/history.svg +1 -0
- package/icons/import.svg +1 -0
- package/icons/inbox.svg +1 -0
- package/icons/key-round.svg +1 -0
- package/icons/layout-grid.svg +1 -0
- package/icons/mail.svg +1 -0
- package/icons/message-circle.svg +1 -0
- package/icons/message-square.svg +1 -0
- package/icons/meter-vertical.svg +1 -0
- package/icons/mic.svg +1 -0
- package/icons/monitor.svg +1 -0
- package/icons/pen-line.svg +1 -0
- package/icons/plug.svg +1 -0
- package/icons/radio-dot.svg +1 -0
- package/icons/radio.svg +1 -0
- package/icons/refresh.svg +1 -0
- package/icons/rocket.svg +1 -0
- package/icons/search.svg +1 -0
- package/icons/shield.svg +1 -0
- package/icons/sparkles.svg +1 -0
- package/icons/square-kanban.svg +1 -0
- package/icons/terminal.svg +1 -0
- package/icons/users.svg +1 -0
- package/icons/volume-2.svg +1 -0
- package/icons/wand.svg +1 -0
- package/icons/wrench.svg +1 -0
- package/icons/x-circle.svg +1 -0
- package/icons/x.svg +1 -0
- package/ignore-semantics.ts +76 -0
- package/lazy-loading-metrics.mjs +61 -0
- package/new-session-cwd.test.mjs +389 -0
- package/new-session-cwd.ts +253 -0
- package/open-viewer-window.ts +65 -0
- package/overlay-back-client.test.mjs +123 -0
- package/overlay-back-client.ts +87 -0
- package/package.json +65 -4
- package/pi-fork-rpc/README.md +12 -0
- package/pi-fork-rpc/cli-resolve.test.mjs +42 -0
- package/pi-fork-rpc/cli-resolve.ts +79 -0
- package/pi-fork-rpc/remote-queue.test.mjs +100 -0
- package/pi-fork-rpc/remote-queue.ts +140 -0
- package/pi-fork-rpc/spec.ts +106 -0
- package/pi-fork-rpc/wire.test.mjs +260 -0
- package/pi-fork-rpc/wire.ts +367 -0
- package/popup-anchor.ts +45 -0
- package/provider-priority-contract.test.mjs +55 -0
- package/reconcile-deps.mjs +41 -0
- package/reload-instances.mjs +60 -0
- package/seed-tool.test.mjs +95 -0
- package/seed-tool.ts +88 -0
- package/session-recycle.ts +109 -0
- package/shared-copy-sync.test.mjs +115 -0
- package/soffice-locate.ts +171 -0
- package/soffice-panel.ts +239 -0
- package/sync-dir.mjs +91 -0
- package/sync-dir.test.mjs +101 -0
- package/sync-gate.test.mjs +93 -0
- package/sync-mirror.test.mjs +85 -0
- package/task-list.test.mjs +91 -0
- package/task-list.ts +118 -0
- package/test-rm-rf.mjs +33 -0
- package/ui-dialogs.test.mjs +198 -0
- package/ui-dialogs.ts +310 -0
package/check-client.mjs
ADDED
|
@@ -0,0 +1,273 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* check-client —— 扩展 client .mjs/.js 的 TS 残留 tripwire(零依赖,纯 node)。
|
|
3
|
+
*
|
|
4
|
+
* 背景:aiti-plan-review 事故(docs/aiti-ext-client-hardening-plan.md §1)——
|
|
5
|
+
* `useState<any>(null)` 解析为合法 JS 比较表达式 `useState < any > (null)`,
|
|
6
|
+
* node --check / TS 解析器 / babel 全不报错,只有运行时才炸。纯语法检查
|
|
7
|
+
* 原理性无效,只能启发式规则 + 渲染期错误边界兜底。
|
|
8
|
+
*
|
|
9
|
+
* 用法:
|
|
10
|
+
* CLI node check-client.mjs <file|dir>... FAIL → exit 1
|
|
11
|
+
* 自测 node check-client.mjs --selftest fixtures 全过 → exit 0
|
|
12
|
+
* API lintClientSource(src) → violations[] { line, level, rule, text }
|
|
13
|
+
* lintPath(path) → { files, violations }(文件或目录,递归)
|
|
14
|
+
* checkClientDir(dir,{log}) FAIL → throw(deploy 脚本用)
|
|
15
|
+
*
|
|
16
|
+
* 词法:规则匹配前先剥离注释/字符串/模板字面量(${} 插值内代码保留检查)——
|
|
17
|
+
* aiti-editor 的 Monaco TS stub 模板串、JSDoc @return 都是合法内容,不剥全误报。
|
|
18
|
+
* 已知极限:regex 字面量含引号等 lexer 歧义允许漏报(tripwire 定位非编译器)。
|
|
19
|
+
*
|
|
20
|
+
* 豁免:目标行或其上一行含 `check-client:allow` 即跳过该行。
|
|
21
|
+
* 权威源:本文件;aiti-extman 部署副本由其 tools/deploy.mjs 拷贝(改动两处同步)。
|
|
22
|
+
*/
|
|
23
|
+
import { readdirSync, readFileSync, statSync } from "node:fs";
|
|
24
|
+
import { join, resolve } from "node:path";
|
|
25
|
+
|
|
26
|
+
// ── 规则(分级)──────────────────────────────────────────────────────────────
|
|
27
|
+
|
|
28
|
+
const RULES = [
|
|
29
|
+
// FAIL:合法 JS 但运行时必炸 / 纯 TS 语法
|
|
30
|
+
{ level: "FAIL", re: /\b(useState|useRef|useMemo|useCallback|useReducer|useImperativeHandle)\s*</, why: "React hook 泛型(运行时必炸)" },
|
|
31
|
+
// 注:含「any/unknown/string」字样的规则用字符串构 RegExp——本文件自身也
|
|
32
|
+
// 会被扫,正则字面量里的 (?:any 会被自己命中(词法器不处理 regex 字面量),
|
|
33
|
+
// 字符串字面量则会被词法遮蔽。
|
|
34
|
+
{ level: "FAIL", re: new RegExp("\\bas\\s+(?:" + "any|unknown|const)\\b"), why: "as 断言" },
|
|
35
|
+
{ level: "FAIL", re: new RegExp(":\\s*(?:" + "any|unknown)\\b"), why: ": any/: unknown 注解" },
|
|
36
|
+
{ level: "FAIL", re: /\b(?:import|export)\s+type\s/, why: "import/export type" },
|
|
37
|
+
{ level: "FAIL", re: /\b(?:interface|enum)\s+[A-Za-z_$]/, why: "interface/enum 声明" },
|
|
38
|
+
// warn:疑似残留,人工确认,不阻断
|
|
39
|
+
{ level: "warn", re: new RegExp(":\\s*(?:" + "string|number|boolean|void)\\b(?!\\s*[._\\w])"), why: "疑似类型注解" },
|
|
40
|
+
{ level: "warn", re: /\bsatisfies\s/, why: "satisfies" },
|
|
41
|
+
{ level: "warn", re: /\b(?:Record|Partial|Readonly|Omit|Pick)\s*</, why: "TS 工具类型" },
|
|
42
|
+
];
|
|
43
|
+
|
|
44
|
+
// ── 词法剥离:注释/字符串/模板字面量 → 空格(保留换行,行号不漂移)─────────
|
|
45
|
+
export function stripLiterals(src) {
|
|
46
|
+
const out = src.split("");
|
|
47
|
+
const n = src.length;
|
|
48
|
+
const mask = (from, to) => {
|
|
49
|
+
for (let k = from; k < to && k < n; k++) if (out[k] !== "\n") out[k] = " ";
|
|
50
|
+
};
|
|
51
|
+
let mode = "code";
|
|
52
|
+
let depth = 0;
|
|
53
|
+
const stack = []; // 模板 ${ 插值进入时的 brace 深度(支持嵌套模板)
|
|
54
|
+
let i = 0;
|
|
55
|
+
while (i < n) {
|
|
56
|
+
const c = src[i];
|
|
57
|
+
const d = i + 1 < n ? src[i + 1] : "";
|
|
58
|
+
if (mode === "code") {
|
|
59
|
+
if (c === "/" && d === "/") {
|
|
60
|
+
const j = src.indexOf("\n", i);
|
|
61
|
+
const end = j === -1 ? n : j;
|
|
62
|
+
mask(i, end);
|
|
63
|
+
i = end;
|
|
64
|
+
} else if (c === "/" && d === "*") {
|
|
65
|
+
const j = src.indexOf("*/", i + 2);
|
|
66
|
+
const end = j === -1 ? n : j + 2;
|
|
67
|
+
mask(i, end);
|
|
68
|
+
i = end;
|
|
69
|
+
} else if (c === "'" || c === '"') {
|
|
70
|
+
let j = i + 1;
|
|
71
|
+
while (j < n && src[j] !== c && src[j] !== "\n") j += src[j] === "\\" ? 2 : 1;
|
|
72
|
+
if (j < n && src[j] === c) {
|
|
73
|
+
mask(i, j + 1);
|
|
74
|
+
i = j + 1;
|
|
75
|
+
} else {
|
|
76
|
+
// 未闭合到行尾 → 可能是 regex 字面量歧义,只遮开引号,按代码继续
|
|
77
|
+
out[i] = " ";
|
|
78
|
+
i++;
|
|
79
|
+
}
|
|
80
|
+
} else if (c === "`") {
|
|
81
|
+
mode = "tpl";
|
|
82
|
+
out[i] = " ";
|
|
83
|
+
i++;
|
|
84
|
+
} else if (c === "{") {
|
|
85
|
+
depth++;
|
|
86
|
+
i++;
|
|
87
|
+
} else if (c === "}") {
|
|
88
|
+
if (stack.length && depth === stack[stack.length - 1]) {
|
|
89
|
+
stack.pop();
|
|
90
|
+
mode = "tpl"; // 插值结束回模板
|
|
91
|
+
out[i] = " ";
|
|
92
|
+
} else {
|
|
93
|
+
depth = Math.max(0, depth - 1);
|
|
94
|
+
}
|
|
95
|
+
i++;
|
|
96
|
+
} else i++;
|
|
97
|
+
} else if (mode === "tpl") {
|
|
98
|
+
if (c === "\\") {
|
|
99
|
+
mask(i, Math.min(i + 2, n));
|
|
100
|
+
i += 2;
|
|
101
|
+
} else if (c === "`") {
|
|
102
|
+
mode = "code";
|
|
103
|
+
out[i] = " ";
|
|
104
|
+
i++;
|
|
105
|
+
} else if (c === "$" && d === "{") {
|
|
106
|
+
stack.push(depth);
|
|
107
|
+
mode = "code";
|
|
108
|
+
mask(i, i + 2);
|
|
109
|
+
i += 2;
|
|
110
|
+
} else {
|
|
111
|
+
if (c !== "\n") out[i] = " ";
|
|
112
|
+
i++;
|
|
113
|
+
}
|
|
114
|
+
} else {
|
|
115
|
+
// 不可达:line/block/字符串均在 code 分支内联处理
|
|
116
|
+
i++;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
return out.join("");
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
// ── 单源检查 ────────────────────────────────────────────────────────────────
|
|
123
|
+
export function lintClientSource(src) {
|
|
124
|
+
const masked = stripLiterals(src);
|
|
125
|
+
const origLines = src.split("\n");
|
|
126
|
+
const maskedLines = masked.split("\n");
|
|
127
|
+
const violations = [];
|
|
128
|
+
for (let i = 0; i < maskedLines.length; i++) {
|
|
129
|
+
const prev = i > 0 ? origLines[i - 1] : "";
|
|
130
|
+
if (origLines[i].includes("check-client:allow") || prev.includes("check-client:allow")) continue;
|
|
131
|
+
for (const { level, re, why } of RULES) {
|
|
132
|
+
if (re.test(maskedLines[i])) {
|
|
133
|
+
violations.push({ line: i + 1, level, rule: why, text: origLines[i].trim().slice(0, 90) });
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
return violations;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
// ── 文件/目录检查 ───────────────────────────────────────────────────────────
|
|
141
|
+
const SKIP_DIR = new Set(["node_modules", ".git"]);
|
|
142
|
+
/** 超过此体积视为 vendored bundle(如 Monaco ts.worker,合法含 interface 字样),不查。 */
|
|
143
|
+
const MAX_BYTES = 512 * 1024;
|
|
144
|
+
const isClientFile = (name) => /\.(mjs|js|cjs)$/.test(name) && !/\.min\./.test(name) && !/\.test\./.test(name);
|
|
145
|
+
|
|
146
|
+
export function lintPath(p, out = { files: 0, violations: [] }) {
|
|
147
|
+
const st = statSync(p);
|
|
148
|
+
if (st.isDirectory()) {
|
|
149
|
+
for (const name of readdirSync(p)) {
|
|
150
|
+
if (SKIP_DIR.has(name)) continue;
|
|
151
|
+
lintPath(join(p, name), out);
|
|
152
|
+
}
|
|
153
|
+
return out;
|
|
154
|
+
}
|
|
155
|
+
const base = p.split("/").pop();
|
|
156
|
+
if (!isClientFile(base)) return out;
|
|
157
|
+
if (st.size > MAX_BYTES) return out; // vendored bundle 豁免
|
|
158
|
+
out.files++;
|
|
159
|
+
for (const v of lintClientSource(readFileSync(p, "utf8"))) out.violations.push({ file: p, ...v });
|
|
160
|
+
return out;
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
export function formatViolations(violations) {
|
|
164
|
+
return violations
|
|
165
|
+
.map((v) => ` ${v.level} ${v.file}:${v.line} [${v.rule}] ${v.text}`)
|
|
166
|
+
.join("\n");
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/** deploy 脚本用:检查目录,FAIL 抛错(消息含违规清单),warn 只打日志不阻断。 */
|
|
170
|
+
export function checkClientDir(dir, { log = console.log } = {}) {
|
|
171
|
+
const { files, violations } = lintPath(resolve(dir));
|
|
172
|
+
const fails = violations.filter((v) => v.level === "FAIL");
|
|
173
|
+
const warns = violations.filter((v) => v.level === "warn");
|
|
174
|
+
if (warns.length) log(`[check-client] ${warns.length} 处疑似 TS 残留(不阻断,建议人工确认):\n${formatViolations(warns)}`);
|
|
175
|
+
if (fails.length) {
|
|
176
|
+
throw new Error(
|
|
177
|
+
`client 检查未通过:${files} 个文件中 ${fails.length} 处 TS 残留(.mjs 里是合法 JS,语法检查不报,运行时必炸)。\n` +
|
|
178
|
+
formatViolations(fails) +
|
|
179
|
+
`\n修复或在该行加注释 // check-client:allow 豁免。详见 docs/aiti-ext-client-hardening-plan.md`,
|
|
180
|
+
);
|
|
181
|
+
}
|
|
182
|
+
if (files) log(`[check-client] ${files} 个 client 文件检查通过`);
|
|
183
|
+
return { files, fails: fails.length, warns: warns.length };
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* extman 安装用:扫整个扩展目录(含第三方,不遵循 client/ 约定)。
|
|
188
|
+
* 在 SKIP_DIR 之上额外跳过构建产物/vendored 目录(Monaco ts.worker、语言包等
|
|
189
|
+
* 合法包含 TS 字样,词法器对 minified 代码不提供保证);体积上限同上。
|
|
190
|
+
*/
|
|
191
|
+
export function lintExtensionDir(dir) {
|
|
192
|
+
const out = { files: 0, violations: [] };
|
|
193
|
+
const walk = (p) => {
|
|
194
|
+
const st = statSync(p);
|
|
195
|
+
if (st.isDirectory()) {
|
|
196
|
+
for (const name of readdirSync(p)) {
|
|
197
|
+
if (SKIP_DIR.has(name) || VENDORED_DIRS.has(name)) continue;
|
|
198
|
+
walk(join(p, name));
|
|
199
|
+
}
|
|
200
|
+
return;
|
|
201
|
+
}
|
|
202
|
+
const base = p.split("/").pop();
|
|
203
|
+
if (!isClientFile(base) || st.size > MAX_BYTES) return;
|
|
204
|
+
out.files++;
|
|
205
|
+
for (const v of lintClientSource(readFileSync(p, "utf8"))) out.violations.push({ file: p, ...v });
|
|
206
|
+
};
|
|
207
|
+
walk(resolve(dir));
|
|
208
|
+
return out;
|
|
209
|
+
}
|
|
210
|
+
const VENDORED_DIRS = new Set(["vendor", "monaco", "dist", "build", "assets", "static", "bundles", "chunks"]);
|
|
211
|
+
|
|
212
|
+
// ── CLI ─────────────────────────────────────────────────────────────────────
|
|
213
|
+
function selftest() {
|
|
214
|
+
const MUST_FAIL = [
|
|
215
|
+
"const [st, setSt] = useState<any>(null);",
|
|
216
|
+
"const r = useRef<number>(null);",
|
|
217
|
+
"const x = v as any;",
|
|
218
|
+
"function f(a: unknown) {}",
|
|
219
|
+
'import type { Foo } from "./x";',
|
|
220
|
+
"interface Foo { a: string }",
|
|
221
|
+
"enum Color { Red }",
|
|
222
|
+
"const y = v as const;",
|
|
223
|
+
];
|
|
224
|
+
const MUST_WARN = [
|
|
225
|
+
"const opts = { mode: string };",
|
|
226
|
+
"x satisfies Y;",
|
|
227
|
+
"const m: Record<string, any> = {};",
|
|
228
|
+
];
|
|
229
|
+
const MUST_PASS = [
|
|
230
|
+
'const REACT_TYPE_STUB = `\ndeclare module "react" {\n export function useState<T>(init: T): [T];\n export const Fragment: any;\n}\n`;',
|
|
231
|
+
"/** @return {{chars1: string, chars2: string}} */",
|
|
232
|
+
"const [s] = useState(null);",
|
|
233
|
+
"useState<any>(null); // check-client:allow",
|
|
234
|
+
"// check-client:allow\nuseState<never>(0);",
|
|
235
|
+
"const cmp = a < b && c > (d);",
|
|
236
|
+
"if (a // 注释里 as any 不算\n ) run();",
|
|
237
|
+
];
|
|
238
|
+
let bad = 0;
|
|
239
|
+
const check = (src, expect, desc) => {
|
|
240
|
+
const v = lintClientSource(src);
|
|
241
|
+
const fails = v.filter((x) => x.level === "FAIL");
|
|
242
|
+
const ok = expect === "FAIL" ? fails.length > 0 : expect === "PASS" ? v.length === 0 : v.length > 0 && fails.length === 0;
|
|
243
|
+
if (!ok) {
|
|
244
|
+
bad++;
|
|
245
|
+
console.log(`SELFTEST FAIL [${desc}] 期望 ${expect},实际 ${JSON.stringify(v)}`);
|
|
246
|
+
}
|
|
247
|
+
};
|
|
248
|
+
MUST_FAIL.forEach((s) => check(s, "FAIL", s.slice(0, 40)));
|
|
249
|
+
MUST_WARN.forEach((s) => check(s, "WARN", s.slice(0, 40)));
|
|
250
|
+
MUST_PASS.forEach((s) => check(s, "PASS", s.replace(/\n/g, "⏎").slice(0, 40)));
|
|
251
|
+
if (bad) {
|
|
252
|
+
console.log(`selftest: ${bad} 处未过`);
|
|
253
|
+
process.exit(1);
|
|
254
|
+
}
|
|
255
|
+
console.log("selftest: 全部通过(8 FAIL / 3 WARN / 7 PASS)");
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
if (process.argv[1] && resolve(process.argv[1]) === resolve(import.meta.filename)) {
|
|
259
|
+
if (process.argv.includes("--selftest")) {
|
|
260
|
+
selftest();
|
|
261
|
+
} else if (process.argv.length > 2) {
|
|
262
|
+
const all = { files: 0, violations: [] };
|
|
263
|
+
for (const p of process.argv.slice(2)) lintPath(resolve(p), all);
|
|
264
|
+
const fails = all.violations.filter((v) => v.level === "FAIL");
|
|
265
|
+
const warns = all.violations.filter((v) => v.level === "warn");
|
|
266
|
+
if (all.violations.length) console.log(formatViolations(all.violations));
|
|
267
|
+
console.log(`\n${all.files} 个文件:FAIL=${fails.length} warn=${warns.length}`);
|
|
268
|
+
process.exit(fails.length ? 1 : 0);
|
|
269
|
+
} else {
|
|
270
|
+
console.log("用法:node check-client.mjs <file|dir>... | --selftest");
|
|
271
|
+
process.exit(2);
|
|
272
|
+
}
|
|
273
|
+
}
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* 扩展全局量灰名单检查(DI 方案 P3,docs/pi-web-ext-dependency-injection-plan.md §8-R1)
|
|
4
|
+
*
|
|
5
|
+
* 用法:node pi-web-ext/_shared/check-ext-globals.mjs [--strict]
|
|
6
|
+
* 扫描 pi-web-ext/ 源码(排除 node_modules/ai-configs/构建产物):
|
|
7
|
+
* 1. 服务端 `__piWebExt.byId(...)` byId 穿透 / `featureValue|featureEnabled|setFeatureFlag` 直调
|
|
8
|
+
* 2. 客户端 `window.__<Name>` / `globalThis.__<Name>` ad-hoc 全局
|
|
9
|
+
* 已知量进灰名单(双轨兜底 / core 保留口 / 内部便道 / 框架聚合),**新出现的名字直接 FAIL**
|
|
10
|
+
* ——红线:新增全局量一律拒绝(AGENTS.md 常见坑)。存量收敛进度见 DI 方案 §5 台账。
|
|
11
|
+
* 已接入统一测试入口 scripts/test-web-ext.mjs(每次测试先跑,撞线整轮 FAIL)。
|
|
12
|
+
* --strict:dualtrack 双轨兜底也计 FAIL(评估兜底退役进度用,默认不开)。
|
|
13
|
+
*/
|
|
14
|
+
import { readdirSync, readFileSync, statSync } from "node:fs";
|
|
15
|
+
import { join, dirname, sep } from "node:path";
|
|
16
|
+
import { fileURLToPath } from "node:url";
|
|
17
|
+
|
|
18
|
+
const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
|
|
19
|
+
const STRICT = process.argv.includes("--strict");
|
|
20
|
+
|
|
21
|
+
/** ── 灰名单:已知且已文档化的全局量(DI 方案 §1.2 / §6 / 各扩展文档)────────
|
|
22
|
+
* 分类:core-保留口(§6 豁免清单)/ dualtrack(P1/P2 迁移后的旧通道兜底,生产同步后退役)
|
|
23
|
+
* / internal(同扩展内部便道,收敛为模块内单例另行批次)/ framework(框架级聚合机制) */
|
|
24
|
+
const GRAY_CLIENT = new Map([
|
|
25
|
+
// core 保留口(§6)
|
|
26
|
+
["__piPageEvents", "core-保留口"], ["__piPageEventsClient", "core-保留口(总线缺席兜底)"],
|
|
27
|
+
["__piWebPendingComposer", "core-保留口"], ["__runningEventsBroker", "core-保留口"],
|
|
28
|
+
["__PIBASE", "core-保留口"], ["__aitiTraceEmit", "core-保留口(pi 扩展生产者)"],
|
|
29
|
+
["__aitiInject", "core-保留口(middleware 跨 bundle)"],
|
|
30
|
+
// P2 双轨兜底(生产同步后随兜底代码退役)
|
|
31
|
+
["__aitiModelCheckOpen", "dualtrack"], ["__aitiModelCheckApp", "dualtrack"],
|
|
32
|
+
["__aitiModelWizardOpen", "dualtrack"], ["__aitiModelWizardOpenTab", "dualtrack"],
|
|
33
|
+
["__aitiModelWizardViewParams", "dualtrack"], ["__aitiModelWizardCleanupEdit", "dualtrack"],
|
|
34
|
+
["__aitiHelperInvoke", "dualtrack"], ["__aitiSuggestAiFallback", "dualtrack"],
|
|
35
|
+
["__aitiAiScheduleOpen", "dualtrack"], ["__aitiGitReviewOpen", "dualtrack"], ["__aitiGitReviewWork", "dualtrack"],
|
|
36
|
+
["__aitiCmd", "dualtrack(aiti-cmd.open-session/open-shell 服务兜底)"],
|
|
37
|
+
["__piEventBus", "dualtrack(event-bus 客户端槽:materialize 竞态下 topic 订阅等待通道,待 onExtServiceChange 收敛)"],
|
|
38
|
+
// 内部便道(同扩展自产自销;收敛为模块内单例另开批次,不阻断)
|
|
39
|
+
["__aitiEditor", "internal"], ["__aitiCpuMeter", "internal"], ["__speekScrollMode", "internal"],
|
|
40
|
+
["__speekListForHighlight", "internal"], ["__aitiDocCenterOpen", "internal"],
|
|
41
|
+
["__aitiAsrOpen", "internal"], ["__aitiConfigsOpen", "internal"], ["__aitiAppendSystemOpen", "internal"],
|
|
42
|
+
["__aitiGitTraceBanner", "internal"], ["__aitiGitTraceForkDialog", "internal"], ["__aitiGitTraceCtx", "internal"],
|
|
43
|
+
["__aitiEventBusDisposer", "internal(实例交接,draft-keeper 同款)"],
|
|
44
|
+
["__aitiCpuMeterOpts", "internal"], ["__AITI_AI_WIN__", "internal(AI 窗 window.open 名)"],
|
|
45
|
+
["__AitiCdpCore", "internal(devtools CDP 内核)"], ["__dbgLauncherInstalled", "internal(devtools dbg 家族)"],
|
|
46
|
+
["__aitiSuppressScroll", "internal"], ["__PIBASE__", "internal(basePath 便道)"],
|
|
47
|
+
["__AITI_FLOAT__", "internal(float 命名空间)"], ["__piweFloat", "internal"], ["__pfFrames", "internal(e2e 帧缓冲)"],
|
|
48
|
+
["__draftKeeperDisposer", "internal(实例交接)"], ["__aitiFolder", "internal"],
|
|
49
|
+
["__piFolderRevealLast", "internal"], ["__aitiSheetUniverApiUrl", "internal"],
|
|
50
|
+
["__aitiModelWizardViewParamsInternal", "internal"],
|
|
51
|
+
["__aitiVoiceInputL2", "internal(ai-input 语音 L2 单例)"],
|
|
52
|
+
["__aitiBridgeProbe", "internal(bridge-probe 自装幂等守卫)"],
|
|
53
|
+
["__dbgAiHostWin", "internal(devtools AI 窗 opener/parent 缓存)"],
|
|
54
|
+
]);
|
|
55
|
+
/** 框架级聚合(读全部扩展声明:configs.includes / schedules / ai.skills)——机制保留,另有治理计划 */
|
|
56
|
+
const GRAY_SERVER_AGG = ["aiti-configs", "aiti-ai-schedule", "aiti-helper"];
|
|
57
|
+
|
|
58
|
+
const SKIP_DIRS = new Set(["node_modules", "ai-configs", "templates", "sm-demo-source", "_shared", "shared", "demo", "demo-lazy"]);
|
|
59
|
+
/** 顶层只扫描真实扩展目录(排除备份/工具/共享目录) */
|
|
60
|
+
const TOP_SKIP = new Set(["ai-configs", "templates", "sm-demo-source", "_shared", "shared", "demo", "demo-lazy", "tools", "node_modules"]);
|
|
61
|
+
const SRC_EXT = /\.(ts|tsx|mjs)$/;
|
|
62
|
+
|
|
63
|
+
let HAS_SRC = false; // 当前扩展是否有 client/src(有则 client/*.mjs 视为构建产物跳过)
|
|
64
|
+
function* walk(dir) {
|
|
65
|
+
for (const e of readdirSync(dir, { withFileTypes: true })) {
|
|
66
|
+
const p = join(dir, e.name);
|
|
67
|
+
if (e.isDirectory()) { if (!SKIP_DIRS.has(e.name)) yield* walk(p); }
|
|
68
|
+
else if (SRC_EXT.test(e.name)) yield p;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const violations = [];
|
|
73
|
+
const knownHits = { client: 0, server: 0 };
|
|
74
|
+
const serverAggHits = new Map();
|
|
75
|
+
|
|
76
|
+
for (const extDir of readdirSync(ROOT, { withFileTypes: true }).filter((e) => e.isDirectory() && !TOP_SKIP.has(e.name)).map((e) => join(ROOT, e.name))) {
|
|
77
|
+
const extId = extDir.split(sep).pop();
|
|
78
|
+
try { HAS_SRC = statSync(join(extDir, "client", "src")).isDirectory(); } catch { HAS_SRC = false; }
|
|
79
|
+
for (const file of walk(extDir)) {
|
|
80
|
+
const rel = file.slice(ROOT.length + 1);
|
|
81
|
+
let src;
|
|
82
|
+
try { src = readFileSync(file, "utf8"); } catch { continue; }
|
|
83
|
+
const isClient = /[\\/]client[\\/]/.test(rel);
|
|
84
|
+
// 构建产物跳过(源码已扫描;产物里的压缩名/内部名不是新增来源)
|
|
85
|
+
if (HAS_SRC && isClient && file.endsWith(".mjs") && !rel.includes("src")) continue;
|
|
86
|
+
const lineOf = (idx) => src.slice(0, idx).split("\n").length;
|
|
87
|
+
const lineAt = (re) => { const m = src.match(re); return m ? lineOf(m.index) : 0; };
|
|
88
|
+
|
|
89
|
+
// 1) 服务端:byId 穿透 / feature 直调(排除注释行、兜底标注行)
|
|
90
|
+
if (!isClient && file.endsWith(".ts")) {
|
|
91
|
+
for (const m of src.matchAll(/byId\(/g)) {
|
|
92
|
+
const line = src.slice(0, m.index).split("\n").pop() ?? "";
|
|
93
|
+
const ctxWindow = src.slice(Math.max(0, m.index - 400), m.index + 200);
|
|
94
|
+
if (/双轨|兜底|dualtrack|DI 方案|注释|\/\/.*byId|\.test\.|legacy/.test(line) || /双轨|兜底|dualtrack|DI 方案/.test(ctxWindow)) { knownHits.server++; continue; }
|
|
95
|
+
violations.push(`[server byId] ${rel}:${lineOf(m.index)} ${line.trim().slice(0, 100)}`);
|
|
96
|
+
}
|
|
97
|
+
for (const m of src.matchAll(/__piWebExt[^;]*?\.(featureValue|featureEnabled|setFeatureFlag|setFeatureValue)\s*\(/g)) {
|
|
98
|
+
const line = src.slice(0, m.index).split("\n").pop() ?? "";
|
|
99
|
+
if (/兜底|dualtrack|DI 方案|写路径|legacy/.test(line)) { knownHits.server++; continue; }
|
|
100
|
+
violations.push(`[server feature 直调] ${rel}:${lineOf(m.index)} ${line.trim().slice(0, 100)}`);
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// 2) 客户端:window/globalThis.__Name ad-hoc 全局
|
|
105
|
+
if (isClient) {
|
|
106
|
+
for (const m of src.matchAll(/(?:window|globalThis)\.__([A-Za-z][A-Za-z0-9_]*)/g)) {
|
|
107
|
+
if (m[1].startsWith("piWeb")) { knownHits.client++; continue; } // core 平台全局(__piWeb* 命名收敛,§6)
|
|
108
|
+
const name = "__" + m[1];
|
|
109
|
+
const cat = GRAY_CLIENT.get(name);
|
|
110
|
+
if (cat) {
|
|
111
|
+
if (STRICT && cat.startsWith("dualtrack")) {
|
|
112
|
+
violations.push(`[strict·dualtrack] ${rel}:${lineOf(m.index)} ${name}(${cat})`);
|
|
113
|
+
} else {
|
|
114
|
+
knownHits.client++;
|
|
115
|
+
}
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
violations.push(`[client 全局·未登记] ${rel}:${lineOf(m.index)} ${name}(不在灰名单——新增全局一律拒绝;确需新增请先入文档并更新本脚本灰名单)`);
|
|
119
|
+
}
|
|
120
|
+
for (const m of src.matchAll(/(?:window|globalThis)\.__piWebExt\b/g)) {
|
|
121
|
+
knownHits.client++;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// 3) 框架聚合统计(豁免但可见)
|
|
126
|
+
if (!isClient && GRAY_SERVER_AGG.includes(extId)) {
|
|
127
|
+
const c = (src.match(/__piWebExt/g) ?? []).length;
|
|
128
|
+
if (c) serverAggHits.set(rel, c);
|
|
129
|
+
}
|
|
130
|
+
void lineAt;
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
console.log(`[globals] 灰名单命中:client=${knownHits.client} server(兜底注释行)=${knownHits.server}`);
|
|
135
|
+
if (serverAggHits.size) {
|
|
136
|
+
console.log(`[globals] 框架聚合豁免(机制保留):${[...serverAggHits.entries()].map(([f, c]) => `${f}×${c}`).join(", ")}`);
|
|
137
|
+
}
|
|
138
|
+
if (violations.length) {
|
|
139
|
+
console.error(`\n[globals] ❌ ${violations.length} 处违规(新出现的 byId 穿透 / feature 直调 / 未登记全局):`);
|
|
140
|
+
for (const v of violations.slice(0, 40)) console.error(" " + v);
|
|
141
|
+
if (violations.length > 40) console.error(` …共 ${violations.length} 处`);
|
|
142
|
+
process.exit(1);
|
|
143
|
+
}
|
|
144
|
+
console.log("[globals] ✅ 无新增违规。存量灰名单见 docs/pi-web-ext-dependency-injection-plan.md §5/§6。");
|