dsh-git-push 2.9.4 → 2.10.1
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/README.md +42 -39
- package/lib/app/apply.js +8 -1
- package/lib/app/audit-api.js +4 -1
- package/lib/app/command-registry.js +18 -11
- package/lib/app/handlers/meta.js +38 -0
- package/lib/app/handlers/repo-actions.js +3 -1
- package/lib/app/handlers/repos.js +18 -2
- package/lib/app/handlers/settings.js +0 -0
- package/lib/app/http-handlers.js +3 -1
- package/lib/app/schema.js +0 -0
- package/lib/app/settings-bridge.js +0 -0
- package/lib/app/tool-call.js +32 -23
- package/lib/ast/brace.js +15 -0
- package/lib/ast/control-flow.js +12 -3
- package/lib/ast/size.js +73 -3
- package/lib/audit/audit-file.js +4 -2
- package/lib/audit/collector.js +13 -4
- package/lib/audit/file-context.js +89 -0
- package/lib/audit/finding.js +16 -2
- package/lib/audit/ignore-blind.js +5 -4
- package/lib/audit/index.js +2 -2
- package/lib/audit/orchestrate.js +2 -1
- package/lib/audit-rules/audit-rules-frontend.yml +4 -4
- package/lib/checks/button-bind.js +84 -13
- package/lib/checks/dispatch.js +1 -1
- package/lib/checks/private.js +2 -1
- package/lib/checks/structural.js +10 -3
- package/lib/client-parts/{10-account.js → account.js} +1 -1
- package/lib/client-parts/{41-actions.js → actions.js} +3 -2
- package/lib/client-parts/{99-apply.js → apply.js} +2 -1
- package/lib/client-parts/{21-audit.js → audit.js} +5 -5
- package/lib/client-parts/{11-browser.js → browser.js} +15 -4
- package/lib/client-parts/{01-const.js → const.js} +11 -5
- package/lib/client-parts/{40-controller.js → controller.js} +4 -4
- package/lib/client-parts/{03-icons.js → icons.js} +1 -1
- package/lib/client-parts/{00-loader.js → loader.js} +1 -0
- package/lib/client-parts/{23-npm.js → npm.js} +3 -2
- package/lib/client-parts/{30-page.js → page.js} +1 -1
- package/lib/client-parts/{20-repo.js → repo.js} +2 -2
- package/lib/client-parts/{22-settings.js → settings.js} +1 -1
- package/lib/client-parts/{02-utils.js → utils.js} +1 -1
- package/lib/client.js +51 -30
- package/lib/commit-push.js +20 -2
- package/lib/context/index.js +2 -1
- package/lib/core/atomic-json.js +1 -1
- package/lib/core/exec.js +6 -4
- package/lib/exempt/index.js +7 -2
- package/lib/exempt/tool.js +198 -0
- package/lib/git/clone-history-mode.js +24 -5
- package/lib/git/index-format.js +182 -0
- package/lib/git/index.js +1 -0
- package/lib/git/push.js +28 -13
- package/lib/git/repo-index.js +41 -30
- package/lib/git/scan-runner.js +1 -1
- package/lib/git/transport.js +49 -17
- package/lib/git/visibility.js +93 -9
- package/lib/npm/publish.js +30 -1
- package/lib/npm/registry.js +5 -2
- package/lib/self/index.js +1 -1
- package/package.json +2 -4
- package/scripts/build-client.mjs +19 -14
- package/scripts/picker-repro.mjs +115 -0
- package/skills/dev/dsh-git-push.md +1 -2
- package/skills/dsh-repo-index.md +1 -1
- package/skills/guide/guide-audit.md +77 -3
- package/skills/guide/guide-cli-scripts.md +4 -4
- package/skills/guide/guide-clone-repos.md +2 -2
- package/skills/guide/guide-inject-ui.md +6 -6
- package/skills/workflow/README.md +1 -1
- package/assets/minihost.sh +0 -35
- package/assets/preview.html +0 -36703
- package/lib/fs/edit-after-read.js +0 -142
- package/scripts/frontend-preview-check.mjs +0 -124
- package/scripts/preview-gen.mjs +0 -489
- package/scripts/preview-local-runner.mjs +0 -55
- package/scripts/preview-server-direct.mjs +0 -116
- package/scripts/preview-server.mjs +0 -305
- package/scripts/preview-slot-data.mjs +0 -123
- package/scripts/sync-plugin-install.mjs +0 -286
- package/scripts/sync-plugin.mjs +0 -284
|
@@ -1,305 +0,0 @@
|
|
|
1
|
-
// dsh-skip-sensitive: 本文件为预览反代服务器,含 token 认证逻辑(--token/环境变量/dsh-proxy.log 运行时解析),无硬编码凭据,安全类规则整文件豁免(文件头前 3 行生效)。
|
|
2
|
-
/**
|
|
3
|
-
* dsh-git-push 侧边栏独立预览服务(默认反代 DSH 真实后端;同入口还支持 --direct 直连插件 handleHttp、--local 免重启、--shot 截图)
|
|
4
|
-
*
|
|
5
|
-
* 用途:把任意 DSH 插件的预览页(preview.html,垫片执行真实 client 代码)独立跑起来,
|
|
6
|
-
* 并接 **DSH 真实后端**——预览页里的数据全部来自真后端(读与写都真实)。
|
|
7
|
-
*
|
|
8
|
-
* 复制到目标项目后,改「配置区」即可:
|
|
9
|
-
* - PROJECT_LABEL 启动横幅显示名(如 "dsh-git-push 设置侧边栏预览")
|
|
10
|
-
* - PREVIEW_FILE 预览页文件名(相对项目根;默认 preview.html,如 assets/preview.html)
|
|
11
|
-
* - SERVE_DIRS 本地静态服务目录(相对项目根;预览页相对资源走这里)
|
|
12
|
-
* - PROXY_PREFIX 转发到 DSH 后端的 URL 前缀(默认 /api/;插件后端前缀改如 /api/git-push/)
|
|
13
|
-
* - HEALTH_PATH 健康检查路径(默认 /preview-ping;配套 start.sh 用它判启动成功)
|
|
14
|
-
* - DSH_BASE 默认后端(可 --dsh 覆盖)
|
|
15
|
-
*
|
|
16
|
-
* 逻辑部分(勿改):token 认证(--token > 环境变量 DSH_PREVIEW_TOKEN > dsh-proxy.log 兜底,
|
|
17
|
-
* GET /?token= → dsh-auth cookie)+ 反向代理 + 静态服务 + playwright 自检骨架。
|
|
18
|
-
*
|
|
19
|
-
* 用法:
|
|
20
|
-
* node scripts/preview-server.mjs --port 30999 # 起本地反代服务器(默认模式:反代 DSH 真实后端)
|
|
21
|
-
* node scripts/preview-server.mjs --direct --port 8090 # 直连模式:不起 DSH 宿主,直接调插件 handleHttp
|
|
22
|
-
* #(原 scripts/preview-server.mjs,2026-10-13 并入本入口)
|
|
23
|
-
* node scripts/preview-server.mjs --local # 免重启:每个 /api 请求 fork 一次性子进程跑工作区最新代码
|
|
24
|
-
* node scripts/preview-server.mjs --dsh http://127.0.0.1:30800 --token <launch-token>
|
|
25
|
-
* node scripts/preview-server.mjs --shot preview.png # playwright 截图自检(需 pwviewer)
|
|
26
|
-
*/
|
|
27
|
-
import { createServer } from 'node:http';
|
|
28
|
-
import { request as httpRequest } from 'node:http';
|
|
29
|
-
import { spawn } from 'node:child_process';
|
|
30
|
-
import { createReadStream, existsSync, statSync, readFileSync } from 'node:fs';
|
|
31
|
-
import { access } from 'node:fs/promises';
|
|
32
|
-
import { join, normalize, extname, dirname } from 'node:path';
|
|
33
|
-
import { fileURLToPath } from 'node:url';
|
|
34
|
-
import os from 'node:os';
|
|
35
|
-
|
|
36
|
-
/* ─────────────── 配置区(各项目按需修改) ─────────────── */
|
|
37
|
-
const PROJECT_LABEL = 'dsh-git-push 设置侧边栏预览(接真实后端)';
|
|
38
|
-
const PREVIEW_FILE = 'assets/preview.html'; // 预览页文件名(相对项目根,preview-gen 生成)
|
|
39
|
-
const SERVE_DIRS = ['lib']; // 本地静态服务目录(相对项目根)
|
|
40
|
-
const PROXY_PREFIX = '/api/git-push/'; // 转发到 DSH 后端的 URL 前缀(插件后端)
|
|
41
|
-
const HEALTH_PATH = '/preview-ping'; // 健康检查路径(start.sh 启动判定用)
|
|
42
|
-
const DSH_BASE = process.env.DSH_PREVIEW_TARGET || 'http://127.0.0.1:30800'; // DSH 反代
|
|
43
|
-
const SHOT_ROOT_SELECTOR = '.dshgp_page'; // playwright 自检的根元素选择器(侧边栏页根)
|
|
44
|
-
/* ─────────────── 配置区结束 ─────────────── */
|
|
45
|
-
|
|
46
|
-
const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url)); // 本脚本所在目录
|
|
47
|
-
const PROJECT_ROOT = normalize(join(SCRIPT_DIR, '..')); // 项目根(脚本在 <根>/preview 或 <根>/assets 下一级)
|
|
48
|
-
const PROXY_LOG = process.env.DSH_PROXY_LOG || join(process.env.DSH_HOME || join(os.homedir(), '.dsh'), 'dsh-proxy.log');
|
|
49
|
-
|
|
50
|
-
const MIME = {
|
|
51
|
-
'.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8',
|
|
52
|
-
'.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.webp': 'image/webp',
|
|
53
|
-
'.gif': 'image/gif', '.svg': 'image/svg+xml', '.ico': 'image/x-icon',
|
|
54
|
-
'.json': 'application/json; charset=utf-8',
|
|
55
|
-
};
|
|
56
|
-
// 纯文本响应类型(脚本自身产生的 404/502 文本——修:此前三处引用该常量但未定义,
|
|
57
|
-
// 任何走 send() 的请求(如 favicon 404)都会抛 ReferenceError 使服务进程整体崩溃)。
|
|
58
|
-
const TEXT_PLAIN_UTF8 = 'text/plain; charset=utf-8';
|
|
59
|
-
/** playwright 自检参数(截图窗口 / 加载超时 / 渲染等待 / 错误消息截断长度)。 */
|
|
60
|
-
const SHOT_VIEWPORT = { width: 1400, height: 900 };
|
|
61
|
-
const SHOT_NAV_TIMEOUT_MS = 30_000;
|
|
62
|
-
const SHOT_SETTLE_MS = 4000;
|
|
63
|
-
const SHOT_ERR_SNIPPET = 80;
|
|
64
|
-
/** 启动横幅宽度(字符数,与 padEnd 对齐)。 */
|
|
65
|
-
const BANNER_WIDTH = 46;
|
|
66
|
-
|
|
67
|
-
// ── CLI 参数 ──
|
|
68
|
-
const args = process.argv.slice(2);
|
|
69
|
-
const PORT = parseInt(args.find(a => a.startsWith('--port'))?.split('=')[1] || args[args.indexOf('--port') + 1] || '30999', 10);
|
|
70
|
-
const noOpen = args.includes('--no-open');
|
|
71
|
-
const shotPath = args.find(a => a.startsWith('--shot'))?.split('=')[1] || (args.includes('--shot') ? args[args.indexOf('--shot') + 1] : null);
|
|
72
|
-
const dshArg = args.find(a => a.startsWith('--dsh'))?.split('=')[1] || (args.includes('--dsh') ? args[args.indexOf('--dsh') + 1] : null);
|
|
73
|
-
const tokenArg = args.find(a => a.startsWith('--token'))?.split('=')[1] || (args.includes('--token') ? args[args.indexOf('--token') + 1] : null);
|
|
74
|
-
// ── 本地模式(--local)──
|
|
75
|
-
// 不反代 DSH 宿主,改为**直接执行工作区当前的插件代码**(每个请求 fork 一次性子进程,
|
|
76
|
-
// 子进程模块天然新鲜)——这样改完代码刷新页面即生效,既不用重启宿主、也不用重启本服务。
|
|
77
|
-
// 用于开发自检;真实宿主 UI/工具仍需宿主重启才生效(DSH 插件在启动时 import 并注册路由)。
|
|
78
|
-
const LOCAL_MODE = args.includes('--local') || process.env.DSH_PREVIEW_LOCAL === '1';
|
|
79
|
-
|
|
80
|
-
// ── 直连模式(--direct,合并 2026-10-13)──
|
|
81
|
-
// 原 scripts/preview-server.mjs(不起 DSH 宿主,直接调插件 handleHttp 走真实代码路径)已并入本入口:
|
|
82
|
-
// 这里转交 scripts/preview-server-direct.mjs 子进程(stdio 透传 + 信号转发),
|
|
83
|
-
// 于是本入口一个命令两种模式:默认 = 反代 DSH 真实后端;--direct = 直连插件真实代码。
|
|
84
|
-
if (args.includes('--direct')) {
|
|
85
|
-
const { spawn } = await import('node:child_process');
|
|
86
|
-
const { existsSync } = await import('node:fs');
|
|
87
|
-
const direct = join(SCRIPT_DIR, 'preview-server-direct.mjs');
|
|
88
|
-
if (!existsSync(direct)) {
|
|
89
|
-
console.error(`找不到直连实现:${direct}`);
|
|
90
|
-
process.exit(2);
|
|
91
|
-
}
|
|
92
|
-
const rest = args.filter((a) => a !== '--direct');
|
|
93
|
-
console.log(`[preview] --direct 模式:转交 ${direct}`);
|
|
94
|
-
const child = spawn(process.execPath, [direct, ...rest], { cwd: PROJECT_ROOT, stdio: 'inherit' });
|
|
95
|
-
for (const sig of ['SIGINT', 'SIGTERM']) {
|
|
96
|
-
process.on(sig, () => { try { child.kill(sig); } catch { /* 子进程已退出 */ } });
|
|
97
|
-
}
|
|
98
|
-
child.on('exit', (code) => process.exit(code ?? 0));
|
|
99
|
-
await new Promise(() => {}); // 常驻:不继续走下面的反代流程
|
|
100
|
-
}
|
|
101
|
-
const LOCAL_WORKSPACE = process.env.DSH_PREVIEW_WORKSPACE || '';
|
|
102
|
-
const LOCAL_RUNNER = 'preview-local-runner.mjs';
|
|
103
|
-
const LOCAL_TIMEOUT_MS = 120_000;
|
|
104
|
-
const TARGET = dshArg || DSH_BASE;
|
|
105
|
-
|
|
106
|
-
// ── token 解析:--token > env > dsh-proxy.log ──
|
|
107
|
-
function resolveToken() {
|
|
108
|
-
if (tokenArg) return tokenArg;
|
|
109
|
-
if (process.env.DSH_PREVIEW_TOKEN) return process.env.DSH_PREVIEW_TOKEN;
|
|
110
|
-
try {
|
|
111
|
-
if (!existsSync(PROXY_LOG)) return null;
|
|
112
|
-
const txt = readFileSync(PROXY_LOG, 'utf8');
|
|
113
|
-
const matches = txt.match(/token=([a-zA-Z0-9_-]{20,})/g);
|
|
114
|
-
if (matches && matches.length) {
|
|
115
|
-
const last = matches[matches.length - 1].replace('token=', '');
|
|
116
|
-
return last;
|
|
117
|
-
}
|
|
118
|
-
} catch { /* 读不到就 null */ }
|
|
119
|
-
return null;
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
// ── DSH 会话:认证 cookie 缓存 ──
|
|
123
|
-
let authCookie = null; // 已认证的 cookie 串
|
|
124
|
-
const COOKIE_RE = /(dsh-auth|_DSH|dsh_)[^;]*/i;
|
|
125
|
-
|
|
126
|
-
async function ensureAuthCookie() {
|
|
127
|
-
if (authCookie) return authCookie;
|
|
128
|
-
const token = resolveToken();
|
|
129
|
-
if (!token) return null;
|
|
130
|
-
// GET /?token=xxx → 303 + Set-Cookie
|
|
131
|
-
return new Promise((resolve) => {
|
|
132
|
-
const target = new URL(TARGET);
|
|
133
|
-
// dsh-skip-sensitive(token 来自 --token 参数/环境变量/日志兜底,运行时解析,非硬编码凭据)
|
|
134
|
-
const req = httpRequest({
|
|
135
|
-
hostname: target.hostname, port: target.port, path: '/?token=' + encodeURIComponent(token), method: 'GET',
|
|
136
|
-
headers: { host: target.host, connection: 'close' }, // 强制新连接,避免复用反代坏 keep-alive
|
|
137
|
-
}, (res) => {
|
|
138
|
-
const setCookies = res.headers['set-cookie'] || [];
|
|
139
|
-
const cookieStr = setCookies.map(s => s.split(';')[0]).join('; ');
|
|
140
|
-
if (cookieStr) { authCookie = cookieStr; }
|
|
141
|
-
res.resume();
|
|
142
|
-
resolve(authCookie);
|
|
143
|
-
});
|
|
144
|
-
req.on('error', () => resolve(null));
|
|
145
|
-
req.end();
|
|
146
|
-
});
|
|
147
|
-
}
|
|
148
|
-
|
|
149
|
-
/** 转发一个浏览器请求到 DSH 真实后端。 */
|
|
150
|
-
function proxyToDsh(req, res, upstreamPath) {
|
|
151
|
-
const t0 = Date.now();
|
|
152
|
-
let bodyBytes = 0;
|
|
153
|
-
req.on('data', (c) => { bodyBytes += c.length; });
|
|
154
|
-
ensureAuthCookie().then((cookie) => {
|
|
155
|
-
if (!cookie) {
|
|
156
|
-
console.log(`[proxy] ${req.method} ${upstreamPath} → 502 no-cookie (${Date.now() - t0}ms)`);
|
|
157
|
-
res.writeHead(502, { 'content-type': TEXT_PLAIN_UTF8 });
|
|
158
|
-
res.end('preview: 无法认证 DSH 后端(未提供 --token 且 proxy.log 无 token)');
|
|
159
|
-
return;
|
|
160
|
-
}
|
|
161
|
-
const target = new URL(TARGET);
|
|
162
|
-
const headers = { ...req.headers, host: target.host, cookie, connection: 'close' };
|
|
163
|
-
// 流式转发:删除 content-length 让 Node 用 chunked 处理,避免长度不匹配挂起
|
|
164
|
-
delete headers['content-length'];
|
|
165
|
-
const upstream = httpRequest({
|
|
166
|
-
hostname: target.hostname, port: target.port, path: upstreamPath, method: req.method, headers,
|
|
167
|
-
}, (up) => {
|
|
168
|
-
const outHeaders = { ...up.headers };
|
|
169
|
-
delete outHeaders['set-cookie']; // 不把 DSH cookie 回给预览页
|
|
170
|
-
delete outHeaders['content-length'];
|
|
171
|
-
res.writeHead(up.statusCode || 502, outHeaders);
|
|
172
|
-
up.pipe(res);
|
|
173
|
-
up.on('end', () => {
|
|
174
|
-
console.log(`[proxy] ${req.method} ${upstreamPath} → ${up.statusCode} body=${bodyBytes}B ${Date.now() - t0}ms`);
|
|
175
|
-
});
|
|
176
|
-
up.on('close', () => {
|
|
177
|
-
console.log(`[proxy] ${req.method} ${upstreamPath} → CLOSE(no-response?) body=${bodyBytes}B ${Date.now() - t0}ms`);
|
|
178
|
-
});
|
|
179
|
-
});
|
|
180
|
-
upstream.on('error', (e) => {
|
|
181
|
-
console.log(`[proxy] ${req.method} ${upstreamPath} → ERROR ${e.message} body=${bodyBytes}B ${Date.now() - t0}ms`);
|
|
182
|
-
res.writeHead(502, { 'content-type': TEXT_PLAIN_UTF8 });
|
|
183
|
-
res.end('preview: 转发 DSH 失败 ' + e.message);
|
|
184
|
-
});
|
|
185
|
-
req.pipe(upstream);
|
|
186
|
-
});
|
|
187
|
-
}
|
|
188
|
-
|
|
189
|
-
function send(res, status, body, type) {
|
|
190
|
-
res.writeHead(status, { 'content-type': type || TEXT_PLAIN_UTF8, 'cache-control': 'no-cache' });
|
|
191
|
-
res.end(body);
|
|
192
|
-
}
|
|
193
|
-
|
|
194
|
-
function serveFile(res, file) {
|
|
195
|
-
if (!existsSync(file) || !statSync(file).isFile()) { send(res, 404, 'not found'); return; }
|
|
196
|
-
const mime = MIME[extname(file).toLowerCase()] || 'application/octet-stream';
|
|
197
|
-
res.writeHead(200, { 'content-type': mime, 'cache-control': 'no-cache' });
|
|
198
|
-
createReadStream(file).pipe(res);
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
const server = createServer((req, res) => {
|
|
202
|
-
const url = new URL(req.url ?? '/', 'http://x');
|
|
203
|
-
const pathname = decodeURIComponent(url.pathname);
|
|
204
|
-
|
|
205
|
-
// 健康检查(start.sh 启动判定用;不转发后端)
|
|
206
|
-
if (pathname === HEALTH_PATH) { send(res, 200, 'pong', 'text/plain'); return; }
|
|
207
|
-
|
|
208
|
-
// 根 → 预览页
|
|
209
|
-
if (pathname === '/' || pathname === '/index.html') { serveFile(res, join(PROJECT_ROOT, PREVIEW_FILE)); return; }
|
|
210
|
-
|
|
211
|
-
// 配置的本地静态目录(如 /lib/* → 项目根 lib/;预览页相对资源走这里)
|
|
212
|
-
for (const dir of SERVE_DIRS) {
|
|
213
|
-
if (pathname.startsWith('/' + dir + '/')) {
|
|
214
|
-
const file = normalize(join(PROJECT_ROOT, pathname.replace(new RegExp('^/' + dir + '/'), dir + '/')));
|
|
215
|
-
if (file.startsWith(join(PROJECT_ROOT, dir))) { serveFile(res, file); return; }
|
|
216
|
-
send(res, 403, 'forbidden'); return;
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
// 代理前缀 → --local 时直跑工作区插件代码,否则转发 DSH 真实后端(读与写都真实)
|
|
221
|
-
if (pathname.startsWith(PROXY_PREFIX)) {
|
|
222
|
-
if (LOCAL_MODE) { serveLocalApi(req, res); return; }
|
|
223
|
-
proxyToDsh(req, res, req.url); // 原样转发(保留 query)
|
|
224
|
-
return;
|
|
225
|
-
}
|
|
226
|
-
|
|
227
|
-
// 其余 → 404
|
|
228
|
-
send(res, 404, 'not found');
|
|
229
|
-
});
|
|
230
|
-
|
|
231
|
-
async function openBrowser() {
|
|
232
|
-
// 异步函数内同步 existsSync 改 fs.promises.access,消除阻塞事件循环
|
|
233
|
-
let hasPlaywright = false;
|
|
234
|
-
try { await access(join(PROJECT_ROOT, '..', '..', 'pwviewer', 'node_modules', 'playwright')); hasPlaywright = true; } catch { hasPlaywright = false; }
|
|
235
|
-
if (noOpen || !hasPlaywright) return;
|
|
236
|
-
try {
|
|
237
|
-
const { chromium } = await import('/volume1/VirtualDSM/DeepSeekHarness/pwviewer/node_modules/playwright/index.mjs');
|
|
238
|
-
const CHROME = '/volume1/VirtualDSM/DeepSeekHarness/pwviewer/browsers/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell';
|
|
239
|
-
const browser = await chromium.launch({ executablePath: CHROME, headless: true, args: ['--no-sandbox','--disable-dev-shm-usage','--disable-gpu','--disable-software-rasterizer','--no-zygote','--single-process','--disable-fontconfig'] });
|
|
240
|
-
const page = await browser.newPage({ viewport: SHOT_VIEWPORT });
|
|
241
|
-
await page.goto('http://127.0.0.1:' + PORT + '/', { waitUntil: 'load', timeout: SHOT_NAV_TIMEOUT_MS });
|
|
242
|
-
await page.waitForTimeout(SHOT_SETTLE_MS);
|
|
243
|
-
const state = await page.evaluate((sel) => ({
|
|
244
|
-
root: !!document.querySelector(sel),
|
|
245
|
-
buttons: document.querySelector(sel) ? document.querySelector(sel).querySelectorAll('button').length : 0,
|
|
246
|
-
}), SHOT_ROOT_SELECTOR);
|
|
247
|
-
console.log('[shot] 预览渲染:', JSON.stringify(state));
|
|
248
|
-
if (shotPath) await page.screenshot({ path: shotPath });
|
|
249
|
-
await browser.close();
|
|
250
|
-
if (shotPath) console.log('[shot] 截图已存:', shotPath);
|
|
251
|
-
} catch (e) {
|
|
252
|
-
console.log('[shot] playwright 自检跳过(', e.message?.slice(0, SHOT_ERR_SNIPPET), ')——真实浏览器打开即可预览');
|
|
253
|
-
}
|
|
254
|
-
}
|
|
255
|
-
|
|
256
|
-
server.listen(PORT, '0.0.0.0', async () => {
|
|
257
|
-
const token = resolveToken();
|
|
258
|
-
console.log('╔══════════════════════════════════════════════════╗');
|
|
259
|
-
console.log('║ ' + PROJECT_LABEL.padEnd(BANNER_WIDTH) + '║');
|
|
260
|
-
console.log('╚══════════════════════════════════════════════════╝');
|
|
261
|
-
console.log(' 预览页: http://127.0.0.1:' + PORT + '/');
|
|
262
|
-
console.log(' 后端: ' + TARGET + '(' + PROXY_PREFIX + '* 转发,数据真实)');
|
|
263
|
-
console.log(' token: ' + (token ? '已自动获取(' + token.slice(0, 8) + '…)' : '⚠ 未找到,预览将不可用(用 --token 指定)'));
|
|
264
|
-
console.log(' 停止: Ctrl+C 或 start.sh stop');
|
|
265
|
-
await openBrowser();
|
|
266
|
-
});
|
|
267
|
-
/**
|
|
268
|
-
* --local 模式:fork 一次性子进程执行**工作区当前的插件代码**,把 {status, body} 回写给浏览器。
|
|
269
|
-
*
|
|
270
|
-
* 为什么每次请求都 fork:子进程冷启动会让整个插件模块图(含 handlers/*、git/* 等子模块)都
|
|
271
|
-
* 从磁盘重新加载,天然绕开 ESM 模块缓存——于是「改代码 → 刷新页面」立即生效,
|
|
272
|
-
* 既不用重启 DSH 宿主,也不用重启本预览服务。代价是每请求约 100ms 进程启动开销。
|
|
273
|
-
*/
|
|
274
|
-
function serveLocalApi(req, res) {
|
|
275
|
-
const t0 = Date.now();
|
|
276
|
-
const child = spawn(process.execPath, [join(SCRIPT_DIR, LOCAL_RUNNER)], { stdio: ['pipe', 'pipe', 'pipe'] });
|
|
277
|
-
let out = '';
|
|
278
|
-
let err = '';
|
|
279
|
-
let settled = false;
|
|
280
|
-
const finish = (status, body, tag) => {
|
|
281
|
-
if (settled) return;
|
|
282
|
-
settled = true;
|
|
283
|
-
if (!res.writableEnded) {
|
|
284
|
-
res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-cache' });
|
|
285
|
-
res.end(typeof body === 'string' ? body : JSON.stringify(body));
|
|
286
|
-
}
|
|
287
|
-
console.log(`[local] ${req.method} ${req.url} → ${status} ${Date.now() - t0}ms${tag ? ' ' + tag : ''}`);
|
|
288
|
-
};
|
|
289
|
-
const timer = setTimeout(() => {
|
|
290
|
-
try { child.kill('SIGKILL'); } catch { /* 已退出 */ }
|
|
291
|
-
finish(504, { ok: false, error: `本地执行超时(${LOCAL_TIMEOUT_MS}ms)` }, 'timeout');
|
|
292
|
-
}, LOCAL_TIMEOUT_MS);
|
|
293
|
-
child.stdout.on('data', (d) => { out += d; });
|
|
294
|
-
child.stderr.on('data', (d) => { err += d; });
|
|
295
|
-
child.on('error', (e) => { clearTimeout(timer); finish(500, { ok: false, error: '本地执行器启动失败: ' + (e?.message || e) }); });
|
|
296
|
-
child.on('close', (code) => {
|
|
297
|
-
clearTimeout(timer);
|
|
298
|
-
if (settled) return;
|
|
299
|
-
if (code !== 0) { finish(500, { ok: false, error: `本地执行器退出码 ${code}${err ? ':' + err.slice(0, 300) : ''}` }); return; }
|
|
300
|
-
let parsed;
|
|
301
|
-
try { parsed = JSON.parse(out); } catch { finish(500, { ok: false, error: '本地执行器输出非 JSON:' + out.slice(0, 200) }); return; }
|
|
302
|
-
finish(parsed.status || 200, parsed.body ?? {});
|
|
303
|
-
});
|
|
304
|
-
child.stdin.end(JSON.stringify({ method: req.method, url: req.url, headers: req.headers, workspaceRoot: LOCAL_WORKSPACE }));
|
|
305
|
-
}
|
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* preview.html 数据自动生成器(新增——此前 __SLOTS__/__FAKE__ 数据手工维护,
|
|
3
|
-
* 每次新增规则槽位都要手改 33K 行的 JSON 串,漏改即 test-rule-slots-render 失败)。
|
|
4
|
-
*
|
|
5
|
-
* 数据契约:与 test/test-rule-slots-render.mjs 的「预览页:槽位数据取自真实规则文件」
|
|
6
|
-
* 断言一致——preview.html 的 __SLOTS__(槽位 meta)与 __FAKE__._order(槽位顺序)
|
|
7
|
-
* 必须等于真实 listRuleSlots() 的结果。本脚本从同一数据源(lib/app/handlers/meta.js
|
|
8
|
-
* 的 listRuleSlots)生成,保证永远一致。
|
|
9
|
-
*
|
|
10
|
-
* 命令:
|
|
11
|
-
* node scripts/gen-preview.mjs # 打印将生成的 __SLOTS__/__FAKE__(不写盘)
|
|
12
|
-
* node scripts/gen-preview.mjs --write # 同步 preview.html(替换两段数据)
|
|
13
|
-
* node scripts/gen-preview.mjs check # 查漂移:preview.html 与真实数据不一致则报错
|
|
14
|
-
*
|
|
15
|
-
* 什么时候跑:新增/删除/改名规则槽位(audit-rules-*.yml)后跑 --write;
|
|
16
|
-
* 提交前跑 check 防漏(门禁不拦,warning 提示)。
|
|
17
|
-
*/
|
|
18
|
-
import { readFileSync, writeFileSync, existsSync } from 'node:fs';
|
|
19
|
-
import { spawnSync } from 'node:child_process';
|
|
20
|
-
import { join, dirname } from 'node:path';
|
|
21
|
-
import { fileURLToPath } from 'node:url';
|
|
22
|
-
import { listRuleSlots } from '../lib/app/handlers/meta.js';
|
|
23
|
-
|
|
24
|
-
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
25
|
-
const ROOT = join(__dirname, '..');
|
|
26
|
-
const PREVIEW = join(ROOT, 'assets', 'preview.html');
|
|
27
|
-
|
|
28
|
-
/** 从真实规则文件生成槽位数据(与测试同一数据源)。 */
|
|
29
|
-
export function buildPreviewSlotData() {
|
|
30
|
-
const real = listRuleSlots(undefined, [], null);
|
|
31
|
-
const realOrder = real.order.filter((s) => s !== 'template');
|
|
32
|
-
const slotsJson = JSON.stringify(real.meta);
|
|
33
|
-
// __FAKE__ 保留原快照字段,只更新 _order(新槽位追加/顺序对齐真实生效顺序)
|
|
34
|
-
const fake = { _order: realOrder };
|
|
35
|
-
return { slotsJson, order: realOrder, fakeJson: JSON.stringify(fake), meta: real.meta, realOrder };
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
/** 读当前 preview.html 里的 __SLOTS__/__FAKE__(供 check 比对)。 */
|
|
39
|
-
export function readPreviewSlotData(html = readPreviewHtml()) {
|
|
40
|
-
const metaMatch = html.match(/window\.__SLOTS__ = (\{.*?\});/s);
|
|
41
|
-
const fakeMatch = html.match(/window\.__FAKE__ = (\{.*?\});/s);
|
|
42
|
-
if (!metaMatch || !fakeMatch) return null;
|
|
43
|
-
try {
|
|
44
|
-
return {
|
|
45
|
-
meta: JSON.parse(metaMatch[1]),
|
|
46
|
-
order: JSON.parse(fakeMatch[1])._order || [],
|
|
47
|
-
};
|
|
48
|
-
} catch { return null; }
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
/**
|
|
52
|
-
* 预览页不入库(见 .gitignore):缺失时先跑一次生成器,保证「漂移门禁 + 单元测试」
|
|
53
|
-
* 在**新克隆 / CI** 上同样可用(否则 readPreviewHtml 返回空 ⇒ 测试以“缺失”失败)。
|
|
54
|
-
* 只在首次缺失时尝试一次,避免每次调用都生成;生成失败按空处理并让调用方给出明确错误。
|
|
55
|
-
*/
|
|
56
|
-
let previewEnsureTried = false;
|
|
57
|
-
export function ensurePreviewHtml() {
|
|
58
|
-
if (existsSync(PREVIEW)) return { ok: true, generated: false };
|
|
59
|
-
if (!previewEnsureTried) {
|
|
60
|
-
previewEnsureTried = true;
|
|
61
|
-
const gen = join(ROOT, 'scripts', 'preview-gen.mjs');
|
|
62
|
-
if (existsSync(gen)) {
|
|
63
|
-
const r = spawnSync(process.execPath, [gen], { cwd: ROOT, timeout: 300000, encoding: 'utf8' });
|
|
64
|
-
if (r.status !== 0) {
|
|
65
|
-
return { ok: false, generated: true, error: `生成 assets/preview.html 失败:${String(r.stderr || r.stdout || '').slice(-400)}` };
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
return { ok: existsSync(PREVIEW), generated: true };
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
/** 读预览页正文(缺失则先自动生成一次)。导出供测试复用,避免测试直接 readFileSync 抛错。 */
|
|
73
|
-
export function readPreviewHtmlText() {
|
|
74
|
-
if (!existsSync(PREVIEW)) {
|
|
75
|
-
const e = ensurePreviewHtml();
|
|
76
|
-
if (!e.ok) return '';
|
|
77
|
-
}
|
|
78
|
-
return readFileSync(PREVIEW, 'utf8');
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
function readPreviewHtml() {
|
|
82
|
-
return readPreviewHtmlText();
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
/** 生成(打印)或写盘。 */
|
|
86
|
-
export function genPreview({ write = false } = {}) {
|
|
87
|
-
const slotData = buildPreviewSlotData();
|
|
88
|
-
const html = readPreviewHtml();
|
|
89
|
-
if (!html) return { ok: false, error: `preview.html 缺失: ${PREVIEW}` };
|
|
90
|
-
const cur = readPreviewSlotData(html);
|
|
91
|
-
const drift = cur && (JSON.stringify(cur.meta) !== slotData.slotsJson || JSON.stringify(cur.order) !== slotData.fakeJson);
|
|
92
|
-
if (write) {
|
|
93
|
-
const out = html
|
|
94
|
-
.replace(/window\.__SLOTS__ = \{.*?\};/s, 'window.__SLOTS__ = ' + slotData.slotsJson + ';')
|
|
95
|
-
.replace(/window\.__FAKE__ = \{.*?\};/s, 'window.__FAKE__ = ' + slotData.fakeJson + ';');
|
|
96
|
-
writeFileSync(PREVIEW, out, 'utf8');
|
|
97
|
-
}
|
|
98
|
-
return { ok: true, write, drift, order: slotData.realOrder, metaCount: Object.keys(slotData.meta).length };
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
/** check:preview.html 数据与真实规则文件是否漂移。 */
|
|
102
|
-
export function checkPreviewDrift() {
|
|
103
|
-
const html = readPreviewHtml();
|
|
104
|
-
if (!html) return { ok: false, drift: true, message: `preview.html 缺失: ${PREVIEW}` };
|
|
105
|
-
const cur = readPreviewSlotData(html);
|
|
106
|
-
if (!cur) return { ok: false, drift: true, message: 'preview.html 缺少 __SLOTS__/__FAKE__ 数据段' };
|
|
107
|
-
const slotData = buildPreviewSlotData();
|
|
108
|
-
const keysDrift = JSON.stringify(Object.keys(cur.meta).sort()) !== JSON.stringify(Object.keys(slotData.meta).sort());
|
|
109
|
-
const orderDrift = JSON.stringify(cur.order) !== JSON.stringify(slotData.realOrder);
|
|
110
|
-
const nameDrift = slotData.realOrder.some((s) => cur.meta[s]?.name !== slotData.meta[s]?.name);
|
|
111
|
-
if (keysDrift || orderDrift || nameDrift) {
|
|
112
|
-
const msg = `preview.html 槽位数据与真实规则文件漂移:`
|
|
113
|
-
+ `${keysDrift ? `槽位集合 ${Object.keys(cur.meta).length} vs ${Object.keys(slotData.meta).length};` : ''}`
|
|
114
|
-
+ `${orderDrift ? '顺序不一致;' : ''}${nameDrift ? '显示名不一致;' : ''}`
|
|
115
|
-
+ `运行 node scripts/gen-preview.mjs --write 重新生成`;
|
|
116
|
-
return { ok: false, drift: true, message: msg };
|
|
117
|
-
}
|
|
118
|
-
return { ok: true, drift: false, message: `preview.html 槽位数据与真实一致(${slotData.realOrder.length} 槽位)` };
|
|
119
|
-
}
|
|
120
|
-
|
|
121
|
-
// (合并 2026-10-13)本文件原来的 CLI 入口(`node scripts/gen-preview.mjs [check|--write]`)已并入
|
|
122
|
-
// 统一入口 scripts/preview-gen.mjs 的模式分发(check / --data-only);本文件只保留纯函数导出,
|
|
123
|
-
// 供统一入口与 test-rule-slots-render.mjs 复用。原 CLI 行为(打印/写盘/退出码)不变。
|