Files
void c1e883d67f refactor: 重组目录结构,脚本收进 scripts/,配置独立成 config/
根目录原来平铺了构建脚本、运行器配置、两个 .cmd 启动器和一份中文名的
实跑报告,四类东西混在一起,新人分不清哪个是源码、哪个是产物。这次按
职责分层重排:

- 构建与检查脚本收进 scripts/:build.mjs、check.mjs
- 一键启动器收进 scripts/:start-headless.cmd、start-dev.cmd
- 运行器配置独立成 config/runner.config.mjs(日常调参不用重新 build)
- 真机测试收进 dev/tests/:real-cdp / real-test / real-e2e / real-run
- 运行报告改成 ASCII 名并移入 docs/reports/run-report-v203.md
- v2.0.x 时期的 7 份原始抓取片段归档到 docs/archive/v2.0-snapshots/,
  docs/evidence/ 只留当前版本的有效证据
- 测试每次重新生成的 3 张截图(e2e-01-after-login、e2e-02-playing、
  real-chrome-login)移出仓库并加入 .gitignore,改写到 .run-tmp/screenshots/;
  docs/screenshots/ 只保留手工挑选的 5 张展示图

路径修正:build.mjs 的 ROOT 上跳一级;dev/tests/ 四个脚本 ROOT 上跳两级、
对 runner/browser.mjs 的引用改 ../../;runner/config.mjs 默认配置文件路径改
config/runner.config.mjs;两个 .cmd 的 cd 改为仓库根、start-dev.cmd 指向
dev/serve.mjs;package.json 全部 npm scripts 同步;README、dev/README、证据
文件与源码注释里的路径一并更新。

顺带修掉测试里硬编码的 v2.7.0 断言:版本号改为从 package.json 读取。

验证:npm run build(104798 字节 / 102.3 KB)、npm run check(24/24)、
npm run test:real:headless(24/24 通过)。
2026-10-25 23:21:59 +08:00

216 lines
7.7 KiB
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// ==UserScript==
// @name 云学堂助手 · 开发热加载器
// @namespace yxt.assistant.local
// @version 1.0.0
// @description 从本机 http://127.0.0.1:8899 拉取 yun-xue-tang-assistant.user.js,保存文件后约 1 秒内自动热替换,免复制粘贴
// @author local
// @match *://*.yunxuetang.cn/*
// @grant GM_xmlhttpRequest
// @grant GM_getValue
// @grant GM_setValue
// @grant unsafeWindow
// @connect 127.0.0.1
// @connect localhost
// @run-at document-idle
// ==/UserScript==
/*
* 这是「开发期」用的薄加载器,本身不含业务逻辑:
* 1. 页面加载时从本地开发服务拉取最新源码并注入页面主世界;
* 2. 每 1 秒问一次 /version,哈希变了就「先释放旧实例、再注入新实例」;
* 3. 服务没开时回退到上一次缓存的源码,保证照常可用;
* 4. 新源码语法错误时拒绝注入,旧实例继续运行(不会把页面搞挂)。
*
* 依赖:先运行 scripts/start-dev.cmd(或 node dev/serve.mjs)启动本地服务。
* 生效方式:MODE = 'hot' 不刷新页面;'reload' 变更后整页刷新。
*/
(function () {
'use strict';
const SERVER = 'http://127.0.0.1:8899';
const MODE = 'hot'; // 'hot' | 'reload'
const POLL_MS = 1000; // 轮询间隔
const RETRY_MS = 15000; // 服务不可用时的重试间隔
const CACHE_KEY = 'yun-xue-tang-dev-src'; // 最近一次成功拉取的源码
const TAG = '[云学堂·热加载]';
const isTop = (function () {
try { return window.top === window.self; } catch (e) { return true; }
})();
const page = (typeof unsafeWindow !== 'undefined' && unsafeWindow) ? unsafeWindow : window;
let appliedHash = '';
let failures = 0;
let timer = 0;
// ---------- 网络 ----------
function httpGet(url, timeoutMs) {
return new Promise(function (resolve, reject) {
if (typeof GM_xmlhttpRequest !== 'function') {
reject(new Error('GM_xmlhttpRequest 不可用(请检查脚本授权)'));
return;
}
GM_xmlhttpRequest({
method: 'GET',
url: url + (url.indexOf('?') < 0 ? '?' : '&') + '_=' + Date.now(),
timeout: timeoutMs || 8000,
headers: { 'Cache-Control': 'no-cache', Pragma: 'no-cache' },
onload: function (r) {
if (r.status >= 200 && r.status < 300) resolve(r.responseText || '');
else reject(new Error('HTTP ' + r.status));
},
onerror: function () { reject(new Error('无法连接 ' + SERVER)); },
ontimeout: function () { reject(new Error('请求超时')); },
});
});
}
// ---------- 注入 ----------
function syntaxErrorOf(src) {
try {
new Function(src); // 只编译不执行,用来提前发现语法错误
return null;
} catch (e) {
if (e && e.name === 'SyntaxError') return e;
return null; // 环境不允许 eval 时跳过校验
}
}
function disposePrevious() {
try {
if (page && typeof page.__yunXueTangDispose === 'function') {
page.__yunXueTangDispose();
return true;
}
} catch (e) {
console.warn(TAG, '旧实例释放失败', e);
}
return false;
}
function inject(src) {
const el = document.createElement('script');
el.type = 'text/javascript';
el.setAttribute('data-yun-xue-tang-dev-injected', '1');
el.textContent = src;
(document.head || document.documentElement).appendChild(el);
el.remove();
}
function apply(src) {
if (!src || src.length < 500) {
console.error(TAG, '拉到的源码异常(长度 ' + String(src && src.length) + '),已忽略');
return false;
}
const err = syntaxErrorOf(src);
if (err) {
console.error(TAG, '新源码有语法错误,保留旧实例:', err);
badge('新代码语法错误:' + err.message);
return false;
}
const hadInstance = !!(page && (page.__yunXueTangAuto || document.getElementById('yun-xue-tang-panel')));
const disposed = disposePrevious();
// 首次注入不存在旧实例,直接注入;之后若旧实例没有 __yunXueTangDispose 或指定了 reload 模式,才刷新整页
if (hadInstance && (MODE === 'reload' || !disposed)) {
console.log(TAG, MODE === 'reload' ? '源码变更,刷新页面' : '旧实例无 __yunXueTangDispose,刷新页面');
location.reload();
return false;
}
try {
inject(src);
GM_setValue(CACHE_KEY, src);
clearBadge();
console.log(TAG, '已注入 ' + src.length + ' 字节源码');
if (isTop && !page.__yunXueTangAuto && !document.getElementById('yun-xue-tang-panel')) {
// 站点 CSP 若禁掉 inline script,退一步用页面主世界的 eval(需要 unsafe-eval)
try { page.eval(src); } catch (e) { /* 两种方式都不行再看下一条 */ }
if (!page.__yunXueTangAuto && !document.getElementById('yun-xue-tang-panel')) {
badge('源码已注入但未生效:页面 CSP 可能拦截了注入,请查看控制台');
}
}
return true;
} catch (e) {
console.error(TAG, '注入失败:', e);
badge('注入失败:' + (e && e.message ? e.message : e));
return false;
}
}
// ---------- 失败提示 ----------
let badgeEl = null;
function badge(msg) {
if (!isTop) return;
try {
if (!badgeEl) {
badgeEl = document.createElement('div');
badgeEl.style.cssText = [
'position:fixed', 'left:12px', 'bottom:12px', 'z-index:2147483647',
'background:#7d2f2f', 'color:#fff', 'padding:6px 10px', 'border-radius:6px',
'font:12px/1.5 system-ui,"Microsoft YaHei",sans-serif', 'max-width:420px',
'box-shadow:0 4px 14px rgba(0,0,0,.35)', 'white-space:pre-wrap',
].join(';');
document.body.appendChild(badgeEl);
}
badgeEl.textContent = TAG + ' ' + msg;
} catch (e) { /* ignore */ }
}
function clearBadge() {
if (badgeEl && badgeEl.parentNode) badgeEl.parentNode.removeChild(badgeEl);
badgeEl = null;
}
// ---------- 轮询 ----------
function schedule(ms) {
clearTimeout(timer);
timer = setTimeout(poll, ms || (failures ? RETRY_MS : POLL_MS));
}
function poll() {
httpGet(SERVER + '/version', 4000).then(function (body) {
failures = 0;
let v;
try { v = JSON.parse(body); } catch (e) { return; }
if (!v || !v.hash || v.hash === appliedHash) return;
return httpGet(SERVER + '/src').then(function (src) {
if (apply(src)) {
appliedHash = v.hash;
console.log(TAG, '热更新 → ' + v.hash);
} else {
appliedHash = v.hash; // 坏版本不再反复重试,修好后再变哈希
}
});
}).catch(function (e) {
failures++;
if (failures === 1) console.warn(TAG, '开发服务不可用,稍后重试:', e.message);
}).then(function () {
schedule();
});
}
// ---------- 启动 ----------
function boot() {
httpGet(SERVER + '/version', 3000).then(function (body) {
const v = JSON.parse(body);
return httpGet(SERVER + '/src').then(function (src) {
appliedHash = v.hash || '';
return apply(src);
});
}).catch(function (e) {
const cached = GM_getValue(CACHE_KEY, '');
if (cached) {
console.warn(TAG, '开发服务不可用,使用缓存源码:', e.message);
apply(cached);
} else {
console.error(TAG, '开发服务不可用且无缓存。请先运行 scripts/start-dev.cmd');
badge('未连上本地开发服务(' + SERVER + ')\n请运行 scripts/start-dev.cmd');
}
}).then(function () {
if (isTop) schedule(POLL_MS);
});
}
boot();
})();