dsh-plugin-wallpaper-engine-media-bridge 1.4.0 → 1.4.2
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/cordis.patch.yml +5 -2
- package/lib/client.media-bridge.js +835 -0
- package/lib/index.js +119 -6
- package/lib/legacy.js +2 -0
- package/lib/occlusion/index.js +292 -0
- package/lib/routes/inventory.js +142 -0
- package/lib/routes/live-frame.js +97 -0
- package/lib/routes/media-bytes.js +90 -0
- package/lib/routes/media-derived.js +250 -0
- package/lib/routes/now-playing.js +2 -2
- package/lib/routes/occlusion.js +78 -0
- package/lib/routes/props.js +81 -0
- package/lib/routes/scene-frame.js +373 -0
- package/lib/routes/scene-media.js +174 -0
- package/lib/routes/scene-serve.js +195 -0
- package/lib/routes/slides.js +68 -0
- package/lib/routes/upload.js +355 -0
- package/lib/routes/we-assets.js +172 -0
- package/lib/supervisor.js +1 -1
- package/locale/en.json +2 -2
- package/locale/zh.json +2 -2
- package/package.json +8 -2
package/lib/index.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* `media-bridge` 子包宿主入口(P-
|
|
2
|
+
* `media-bridge` 子包宿主入口(P-D 阶段1:保留 media-bridge 包名,把壁纸域宿主路由族与浏览器半边并入本包;
|
|
3
|
+
* P-F 第三格:`lib/components/media-bridge/` → `packages/media-bridge/`)。
|
|
3
4
|
*
|
|
4
5
|
* 为什么这一格独立成行:这五条路由(`/media-status`、`/audio-spectrum`、`/now-playing`、
|
|
5
6
|
* `/now-playing/artwork`、`/media-control`)与它们的后端实现(media-bridge 子进程 + 内置回落)
|
|
@@ -45,6 +46,24 @@
|
|
|
45
46
|
* 键集见 `lib/kernel/component-session.js` 的 `COMPONENT_VIEW_KEYS['media-bridge']` 注释。
|
|
46
47
|
*/
|
|
47
48
|
import { registerNowPlayingRoutes } from './routes/now-playing.js';
|
|
49
|
+
import { registerWeAssetsRoutes } from './routes/we-assets.js';
|
|
50
|
+
// S5c 刀2:9 族宿主路由(21 条)从主包搬进本包 —— 实现在本包 `lib/routes/`,注册点只在
|
|
51
|
+
// `applyImpl` 里;c 面 = 键表(`...keys`:`kernel:` / `apply:` / `schema:` / `log:` 四种源型)
|
|
52
|
+
// + 本组件会话自己的 `disposers` + `http` 面(`sendJson`/`bodyReader`)。
|
|
53
|
+
import { registerInventoryRoutes } from './routes/inventory.js';
|
|
54
|
+
import { registerSlidesRoutes } from './routes/slides.js';
|
|
55
|
+
import { registerUploadRoutes } from './routes/upload.js';
|
|
56
|
+
import { registerPropsRoutes } from './routes/props.js';
|
|
57
|
+
import { registerMediaBytesRoutes } from './routes/media-bytes.js';
|
|
58
|
+
import { registerMediaDerivedRoutes } from './routes/media-derived.js';
|
|
59
|
+
import { registerSceneFrameRoutes } from './routes/scene-frame.js';
|
|
60
|
+
import { registerSceneServeRoutes } from './routes/scene-serve.js';
|
|
61
|
+
import { registerSceneMediaRoutes } from './routes/scene-media.js';
|
|
62
|
+
import { registerLiveFrameRoutes } from './routes/live-frame.js';
|
|
63
|
+
// S5d 刀3:遮挡/省电判据源整族入包 —— 生产端(x11 探针 + 心跳/降级)在本包
|
|
64
|
+
// `lib/occlusion/`,只读端点在本包 `lib/routes/occlusion.js`;hub 由本入口在行装载时现建。
|
|
65
|
+
import { createOcclusionHub } from './occlusion/index.js';
|
|
66
|
+
import { registerOcclusionRoutes } from './routes/occlusion.js';
|
|
48
67
|
|
|
49
68
|
/** patch 行 slug(`cordis.patch.yml` 里该行 `name` 的完整值,两处逐字相等)。 */
|
|
50
69
|
export const name = 'dsh-plugin-wallpaper-engine-media-bridge';
|
|
@@ -65,7 +84,7 @@ export function apply(ctx, config) {
|
|
|
65
84
|
const host = ctx.wallpaperEngineHost;
|
|
66
85
|
// 拿不到服务名就大声失败:静默 `undefined` 会让下面每一步都在 undefined 上取属性(半死态)。
|
|
67
86
|
if (!host) {
|
|
68
|
-
throw new Error('[wallpaper-engine]
|
|
87
|
+
throw new Error('[wallpaper-engine] wallpaper 没拿到 wallpaperEngineHost 服务'
|
|
69
88
|
+ '(inject 声明与宿主装载顺序不匹配)');
|
|
70
89
|
}
|
|
71
90
|
// 键视图 = `lib/subpackage-boot.js` 的 SUBPACKAGE_KEY_TABLE 里本包那一行(值全部来自主包模块级绑定)。
|
|
@@ -89,7 +108,7 @@ export function applyImpl(root, _rawConfig, c) {
|
|
|
89
108
|
// 两条装载路径都能这么读:① 子包行自己声明了 `inject = ['webServer', 'wallpaperEngineHost']`;
|
|
90
109
|
// ② 门面路径的 `root` 就是门面的 ctx,而门面同样声明了 `inject = ['webServer']`(主行
|
|
91
110
|
// `lib/index.js` 的 `inject` 声明)。
|
|
92
|
-
const webServer = root && root.webServer;
|
|
111
|
+
const webServer = keys.tolerantWebServer(root && root.webServer);
|
|
93
112
|
// 与门面 `apply()` 同款早退:服务在、但 register 面还没挂上(或换成了别的 webServer 实现)。
|
|
94
113
|
if (!webServer || typeof webServer.register !== 'function') return () => {};
|
|
95
114
|
|
|
@@ -103,13 +122,30 @@ export function applyImpl(root, _rawConfig, c) {
|
|
|
103
122
|
// 本组件自己要的两个键:后端启动决策每次现读设置(`readConfig`),缓存根传**访问器**。
|
|
104
123
|
const { readConfig, cacheBaseDir } = view;
|
|
105
124
|
|
|
106
|
-
//
|
|
107
|
-
// `disposers`
|
|
125
|
+
// S5d 刀3. 遮挡/省电判据源随本组件行装载:hub 在**本入口**现建(x11 探针 + 心跳 + 降级),
|
|
126
|
+
// dispose 推进**本组件会话**的 `disposers` —— 保 S7.1 行级开关(关包行 ⇒ hub 与 `/occlusion`
|
|
127
|
+
// 一起撤,不碰主包其它族)。日志/诊断走键表同源绑定:`log:` 源型与 `kernel:appendDiagLine`。
|
|
128
|
+
// 行为变化(有意):hub 生命周期从「主包 apply」变为「wallpaper 行装载」—— 这正是
|
|
129
|
+
// 「省电判据源 + 策略同包」的定义;浏览器侧仍只经 HTTP(`/occlusion`)消费,零跨包调用。
|
|
130
|
+
// 平台适配器 / 会话判定留在主包(`lib/occlusion/x11.js`),经键表 `schema:` 面注入 ——
|
|
131
|
+
// 缺键会让 `createOcclusionHub` 大声抛(不静默退化成"永远降级")。
|
|
132
|
+
const occlusionHub = createOcclusionHub({
|
|
133
|
+
log: keys.log.tag('occlusion'),
|
|
134
|
+
diag: (obj) => keys.appendDiagLine('occlusion', obj),
|
|
135
|
+
isX11CandidateEnv: keys.isX11CandidateEnv,
|
|
136
|
+
createX11Adapter: keys.createX11Adapter,
|
|
137
|
+
});
|
|
138
|
+
disposers.push(() => occlusionHub.dispose());
|
|
139
|
+
occlusionHub.start().catch(() => { /* hub.start 不外抛;兜底防 unhandled(主包原实现同款) */ });
|
|
140
|
+
|
|
141
|
+
// ⚠️ **注册期必须包 try**(P2-4):本组件一次性注册**二十九条**路由(媒体状态 5 + WE 素材源 2
|
|
142
|
+
// + S5c 刀2 的 9 族 21 条 + S5d 刀3 的遮挡 1 条),
|
|
143
|
+
// 中途抛错时已经推进 `disposers` 的那几条会留下(`mediaBackend.stop()` 也在同一个 disposer 列表里,一并丢)
|
|
108
144
|
// ⇒ 下一次启用撞 `webserver: duplicate … route`,且桥的子进程无人收。`teardown()` 自己吞异常,
|
|
109
145
|
// 原错照抛(装载失败必须仍然是红的)。
|
|
110
146
|
try {
|
|
111
147
|
// 3c-5. 媒体状态族路由(媒体后端懒启动 + /media-status、/audio-spectrum、/now-playing、
|
|
112
|
-
// /now-playing/artwork、/media-control)→ 本包
|
|
148
|
+
// /now-playing/artwork、/media-control)→ 本包 `./routes/now-playing.js`。
|
|
113
149
|
// 后端实例、启动决策与五条注册都在那个文件里;这里只声明它的依赖(与门面调用点逐键相同)。
|
|
114
150
|
registerNowPlayingRoutes(webServer, {
|
|
115
151
|
...keys, disposers, base, appendDiagLine, configPath, cacheBaseDir, readConfig, serveFile,
|
|
@@ -117,6 +153,83 @@ export function applyImpl(root, _rawConfig, c) {
|
|
|
117
153
|
// 媒体子系统的行统一带 `[media]` 标签(与终端既有形状逐字一致);级别由调用点标注。
|
|
118
154
|
log: log.tag('media'),
|
|
119
155
|
});
|
|
156
|
+
// 3c-3d/3c-3e. WE 官方素材源族(`/api/local-assets` + `/we-assets-dir`)→ 本包
|
|
157
|
+
// `lib/routes/we-assets.js`(S5b 刀1 出户)。两条注册、配置-消费共用可变真源
|
|
158
|
+
// `WE_ASSETS_DIR` 都在那个文件里;这里只声明它的依赖(与门面调用点逐键相同)。
|
|
159
|
+
registerWeAssetsRoutes(webServer, {
|
|
160
|
+
...keys, disposers, base, serveFile, CONTROL_JSON_MAX_BYTES, http: keys.http,
|
|
161
|
+
});
|
|
162
|
+
|
|
163
|
+
// ── S5c 刀2:9 族宿主路由(21 条;注册顺序与主包门面逐字一致)──────────────────
|
|
164
|
+
// `...keys` 提供键表里本包的**全部**键(kernel:/apply:/schema:/log: 四种源型同源);
|
|
165
|
+
// `disposers` **只用本组件会话的**(S7.1 行级开关:组件被关时只回滚它自己登记的这 21 条,
|
|
166
|
+
// 不碰主包其它族);`http` 面按需显式带上(S5b 同款,`verify-json-response` 来路 c)。
|
|
167
|
+
// ⚠️ 这里**不能**再显式覆盖 `serveFile` / `mediaMap` / `tokenFor`:它们来自 `...keys` 的
|
|
168
|
+
// `apply:` 面(= 主包本次 apply 会话的同一份实例,R1 token 域单主权);覆盖成本组件会话
|
|
169
|
+
// 那份会让 token 查不到(组件会话自建第二张 mediaMap)。
|
|
170
|
+
|
|
171
|
+
// 1. 壁纸清单 JSON(`/inventory`)→ 本包 `lib/routes/inventory.js`。
|
|
172
|
+
registerInventoryRoutes(webServer, {
|
|
173
|
+
...keys, disposers,
|
|
174
|
+
});
|
|
175
|
+
|
|
176
|
+
// 1b. 图片 / 幻灯片壁纸的图集清单(`/slides/<token>`)→ 本包 `./routes/slides.js`。
|
|
177
|
+
// `listImages` 走键表 `kernel:listImages`(内核扫描族),`mediaMap` / `tokenFor`
|
|
178
|
+
// 仍是 `...keys` 的 `apply:` 面(与 `/media` 同一张 token 表)。
|
|
179
|
+
registerSlidesRoutes(webServer, {
|
|
180
|
+
...keys, disposers, http: keys.http,
|
|
181
|
+
});
|
|
182
|
+
|
|
183
|
+
// 2/3a. 派生媒体族(源元信息 / 抽帧转码 + 进度 / 视频缩略图)→ 本包 `./routes/media-derived.js`。
|
|
184
|
+
registerMediaDerivedRoutes(webServer, {
|
|
185
|
+
...keys, disposers,
|
|
186
|
+
});
|
|
187
|
+
|
|
188
|
+
// 2/3. 媒体 + 预览原始字节(`/media`、`/preview`)→ 本包 `./routes/media-bytes.js`。
|
|
189
|
+
registerMediaBytesRoutes(webServer, {
|
|
190
|
+
...keys, disposers,
|
|
191
|
+
});
|
|
192
|
+
|
|
193
|
+
// 3c-3b/3c-5. 场景帧服务族(实时抓帧缓存 / 自定义画面)→ 本包 `./routes/scene-frame.js`。
|
|
194
|
+
registerSceneFrameRoutes(webServer, {
|
|
195
|
+
...keys, disposers, http: keys.http,
|
|
196
|
+
});
|
|
197
|
+
|
|
198
|
+
// 3c-2/3c-3. 场景载荷服务族(live 渲染页 / 场景文件 / 媒体源诊断)→ 本包 `./routes/scene-serve.js`。
|
|
199
|
+
registerSceneServeRoutes(webServer, {
|
|
200
|
+
...keys, disposers,
|
|
201
|
+
});
|
|
202
|
+
|
|
203
|
+
// 3c-3c. 壁纸属性(WE 用户属性)→ 本包 `./routes/props.js`。
|
|
204
|
+
registerPropsRoutes(webServer, {
|
|
205
|
+
...keys, disposers, http: keys.http,
|
|
206
|
+
});
|
|
207
|
+
|
|
208
|
+
// 3c-4. 网页壁纸首帧缓存(`__wp.capture` 回填的 JPEG)→ 本包 `./routes/live-frame.js`。
|
|
209
|
+
registerLiveFrameRoutes(webServer, {
|
|
210
|
+
...keys, disposers, http: keys.http,
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
// 3e. 场景内嵌媒资(动画 MP4 + 独立音频)→ 本包 `./routes/scene-media.js`。
|
|
214
|
+
registerSceneMediaRoutes(webServer, {
|
|
215
|
+
...keys, disposers,
|
|
216
|
+
});
|
|
217
|
+
|
|
218
|
+
// 4/5/6. 上传资产族(导入 / 删除 / 切换上传目录)→ 本包 `./routes/upload.js`。
|
|
219
|
+
registerUploadRoutes(webServer, {
|
|
220
|
+
...keys, disposers, http: keys.http,
|
|
221
|
+
});
|
|
222
|
+
|
|
223
|
+
// S5d 刀3. 遮挡快照族(`/occlusion`)→ 本包 `lib/routes/occlusion.js`(一族一条)。
|
|
224
|
+
// ⚠️ 调用点形态被判据钉住(test/verify-occlusion-hub.mjs 的 D3):`hub` 与 log/diag 必须
|
|
225
|
+
// 在这个字面量里逐键给到,引入中间变量/少给 `hub` 都判红。`diag` 用内核 `appendDiagLine`
|
|
226
|
+
// 的同源绑定(与主包原调用点同一份实现)。
|
|
227
|
+
registerOcclusionRoutes(webServer, {
|
|
228
|
+
...keys, disposers, base, hub: occlusionHub,
|
|
229
|
+
log: keys.log.tag('occlusion'),
|
|
230
|
+
diag: (obj) => keys.appendDiagLine('occlusion', obj),
|
|
231
|
+
http: keys.http,
|
|
232
|
+
});
|
|
120
233
|
} catch (error) {
|
|
121
234
|
teardown();
|
|
122
235
|
throw error;
|
package/lib/legacy.js
CHANGED
|
@@ -442,6 +442,8 @@ export function createMediaBridge({ dataDir, cacheBaseDir = join(dataDir, 'cache
|
|
|
442
442
|
else setAudio('off', '已在设置中关闭「系统音频反应」');
|
|
443
443
|
pollNowPlaying();
|
|
444
444
|
npTimer = setInterval(pollNowPlaying, 1000);
|
|
445
|
+
// #241:宿主优雅退出不等插件 unload ⇒ 定时器必须 unref,否则事件循环永远撑住、更新回滚。
|
|
446
|
+
try { npTimer.unref?.(); } catch { /* ignore */ }
|
|
445
447
|
},
|
|
446
448
|
stop() {
|
|
447
449
|
stopped = true;
|
|
@@ -0,0 +1,292 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* occlusion/index.js — 遮挡数据 **hub**:适配器之上的状态机与生命周期唯一持有者。
|
|
3
|
+
*
|
|
4
|
+
* ══ 为什么值得独立成文件 ══════════════════════════════════════════════════════
|
|
5
|
+
* 「采集」(x11.js)与「快照语义」(epoch/gen/降级/心跳)是两件事:前者是平台细节,
|
|
6
|
+
* 后者是**渲染器契约**(见本文件下方的「快照契约」段;消费端是 `lib/webwallgl/occlusion-bridge.js`)。
|
|
7
|
+
* 渲染器只认快照形状与
|
|
8
|
+
* `ts` 新鲜度,不关心底下是 X11 还是 Wayland —— hub 把这两件事隔开,让将来的
|
|
9
|
+
* Wayland 适配器(KWin 脚本 / sway IPC / portal)只是**换一个 createAdapter**。
|
|
10
|
+
*
|
|
11
|
+
* ══ 快照契约(消费方:packages/media-bridge/lib/routes/occlusion.js → 主包 src/occlusion.js → WebWallGL)═══
|
|
12
|
+
* `{ ok:1, backend:'x11', epoch, gen, own:{w,h}, rects:[[x,y,w,h]…], ts }`
|
|
13
|
+
* · `rects` 已**相对自窗客户区原点**、单位是自窗像素(客户端按 innerWidth/own.w
|
|
14
|
+
* 缩放到画布 CSS 像素);`epoch` 标识坐标系来源,变 epoch ⇒ 渲染器全量重置;
|
|
15
|
+
* · 降级(无 X11 会话 / 适配器死亡 / EWMH 缺失):`backend:'none'`、`own:null`、
|
|
16
|
+
* `rects:null` —— 客户端据此 postMessage `clearOcclusion`,渲染器回全速 run;
|
|
17
|
+
* · `gen` 只在 own/rects **内容**变化时递增(消费者拿它判「是不是旧一帧」);
|
|
18
|
+
* `ts` 每次**成功或降级重算**都刷新 —— 渲染器对 >3s 陈旧快照自动清遮挡,所以
|
|
19
|
+
* hub 的 1Hz 心跳是**硬性要求**,绝不允许「只在事件时才算」。
|
|
20
|
+
*
|
|
21
|
+
* ══ 生命周期与不变量 ══════════════════════════════════════════════════════════
|
|
22
|
+
* · `start()` 幂等;任何失败**不抛出**——记日志后进入降级态并按 30s 上限退避重试
|
|
23
|
+
* (X 会话可能在插件启动后才可用,比如用户从 Wayland 重登回 X11);
|
|
24
|
+
* · 1Hz 兜底轮询 + 适配器事件触发立即重算(合并间隔 200ms,防止 ConfigureNotify
|
|
25
|
+
* 拖动风暴);轮询失败 ⇒ 立即降级并重启重试循环;
|
|
26
|
+
* · `getSnapshot()` **永不抛错**、永不回 undefined —— 路由层据此可以零防御直发;
|
|
27
|
+
* · `dispose()` 幂等;清掉全部定时器与适配器连接(进 `c.disposers`)。
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
// ══ 平台适配器的来路(S5d 刀3:hub 随壁纸子包出户)══════════════════════════════
|
|
31
|
+
// 本文件不再 `import './x11.js'` —— 平台适配器与「是否 X11 会话」的判定留在主包
|
|
32
|
+
// (`lib/occlusion/{x11,rects}.js`,x11 只是取数适配器、不是省电判据本身),经键表
|
|
33
|
+
// `schema:` 面注入(`isX11CandidateEnv` / `createX11Adapter`)。两者都是**必需**输入:
|
|
34
|
+
// 缺了就是接线错误,构造时大声抛 —— 绝不静默退化成"永远降级"(那会让省电功能无声失效,
|
|
35
|
+
// 而不是红在测试里)。
|
|
36
|
+
|
|
37
|
+
const POLL_INTERVAL_MS = 1000; // 心跳:渲染器 3s 陈旧线的三倍余量。
|
|
38
|
+
const EVENT_COALESCE_MS = 200; // 事件触发的最小重算间隔(拖动风暴闸)。
|
|
39
|
+
const RETRY_START_MS = 30_000; // 降级后重建适配器的重试间隔(上限)。
|
|
40
|
+
const POLL_TIMEOUT_MS = 3_000; // 单次 poll 的看门狗:x11 断连可能让在途应答永不回来。
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* 造遮挡 hub(依赖全可注入:单测 / 探针)。
|
|
44
|
+
*
|
|
45
|
+
* `log` 的类型是**被调用面** `LogCall`(`log(msg, level?)`),不是 `LogFn`:hub 只调不读,
|
|
46
|
+
* 所以缺省空实现、单测/探针里的单参回调都合法(形状真源见 `lib/log.js`)。
|
|
47
|
+
*
|
|
48
|
+
* @param {object} [o]
|
|
49
|
+
* @param {import('../../../../lib/log.js').LogCall} [o.log] 日志被调用面(`log(msg, level?)`);缺省空实现。
|
|
50
|
+
* @param {(data:any) => void} [o.diag] 宿主注入 `appendDiagLine` 包装(**单参**:`diag({ ev, … })`)。可省。
|
|
51
|
+
* @param {Function} o.createX11Adapter **必需**:适配器工厂(主包 `lib/occlusion/x11.js`,经 `schema:` 面注入)。
|
|
52
|
+
* @param {(env?:any) => boolean} o.isX11CandidateEnv **必需**:候选环境判定(同上)。
|
|
53
|
+
* @param {number} [o.pollMs] 兜底轮询间隔(缺省 1000ms)。
|
|
54
|
+
* @param {number} [o.retryStartMs] 降级后重建适配器的重试间隔上限(缺省 30s)。
|
|
55
|
+
* @param {number} [o.pollTimeoutMs] 单次 poll 的看门狗(缺省 3s);0/负值 = 关闭。
|
|
56
|
+
* @param {() => number} [o.now] 时钟注入(缺省 `Date.now`)。
|
|
57
|
+
* @param {number} [o.ownPid] 仅透传给适配器(探针/单测注入);undefined ⇒ 适配器取 [pid, ppid]。
|
|
58
|
+
*/
|
|
59
|
+
export function createOcclusionHub({
|
|
60
|
+
log = () => {},
|
|
61
|
+
diag, // (obj) => void;宿主注入 appendDiagLine 包装。可省(单测/探针)。
|
|
62
|
+
isX11CandidateEnv: isCandidate, // 必需:见文件头「平台适配器的来路」。
|
|
63
|
+
createX11Adapter: createAdapter, // 必需:同上。
|
|
64
|
+
pollMs = POLL_INTERVAL_MS,
|
|
65
|
+
retryStartMs = RETRY_START_MS,
|
|
66
|
+
pollTimeoutMs = POLL_TIMEOUT_MS, // 单测可调小;0/负值 = 关闭看门狗
|
|
67
|
+
now = () => Date.now(),
|
|
68
|
+
ownPid, // 仅透传给适配器(探针/单测注入用);undefined ⇒ 适配器取 [pid, ppid]
|
|
69
|
+
} = /** @type {any} */ ({})) {
|
|
70
|
+
// 大声抛(不静默 undefined):hub 出户后平台能力只能经注入来,缺一个就会在
|
|
71
|
+
// `start()` 里变成 TypeError 被 catch 成"假降级"——省电功能无声失效,测试全绿。
|
|
72
|
+
const missing = [];
|
|
73
|
+
if (typeof isCandidate !== 'function') missing.push('isX11CandidateEnv');
|
|
74
|
+
if (typeof createAdapter !== 'function') missing.push('createX11Adapter');
|
|
75
|
+
if (missing.length) {
|
|
76
|
+
throw new Error('[wallpaper-engine] createOcclusionHub 缺少必需注入:' + missing.join('、')
|
|
77
|
+
+ '(hub 已随壁纸子包出户,平台适配器与会话判定经键表 schema: 面拿主包实现)');
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
let adapter = null;
|
|
81
|
+
let started = false;
|
|
82
|
+
let disposed = false;
|
|
83
|
+
let pollTimer = null;
|
|
84
|
+
let retryTimer = null;
|
|
85
|
+
let lastEventAt = 0;
|
|
86
|
+
// 事件触发重算只在「事件来的时机距上次计算足够远」时执行;事件风暴时退化为下一跳。
|
|
87
|
+
let busy = false;
|
|
88
|
+
let dirty = false; // 事件落在 busy/合并窗内被丢时置位 ⇒ finally 里补算一次(trailing)。
|
|
89
|
+
let snapshot = degradedSnapshot(0, now());
|
|
90
|
+
let lastContent = ''; // 上一次成功快照的内容指纹(gen 只在指纹变化时递增)。
|
|
91
|
+
const seenLogs = new Set(); // 同类告警只记一次(适配器重建后允许再记)。
|
|
92
|
+
|
|
93
|
+
// 日志回调的**安全包装**:hub 契约要求 log 抛错不得影响服务(与 diag 同等对待)。
|
|
94
|
+
// 否则成功路径里 log 抛错会被 recompute 的通用 catch 吞成「假降级 + 拆健康适配器」。
|
|
95
|
+
const safeLog = (msg) => {
|
|
96
|
+
try {
|
|
97
|
+
log(msg);
|
|
98
|
+
} catch {
|
|
99
|
+
/* 回调异常不是采集失败,绝不能触发降级 */
|
|
100
|
+
}
|
|
101
|
+
};
|
|
102
|
+
|
|
103
|
+
function degradedSnapshot(gen, ts) {
|
|
104
|
+
return { ok: 1, backend: 'none', epoch: '', gen, own: null, rects: null, ts };
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
function logOnce(key, msg) {
|
|
108
|
+
if (seenLogs.has(key)) return;
|
|
109
|
+
seenLogs.add(key);
|
|
110
|
+
safeLog(`[occlusion] ${msg}`);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** 内容变化比较:own/rects 都变才递增 gen;epoch 变化必然伴随内容变化。 */
|
|
114
|
+
function contentOf(core) {
|
|
115
|
+
return JSON.stringify([core.epoch, core.own, core.rects]);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
async function recompute() {
|
|
119
|
+
if (busy || disposed || !adapter) return;
|
|
120
|
+
busy = true;
|
|
121
|
+
// 看门狗:x11 断连时在途应答可能永不结算(client.replies 无清理)⇒ poll 永挂
|
|
122
|
+
// ⇒ busy 永久卡 true、hub 静默冻结。超时按失败走同一条降级路径。
|
|
123
|
+
let pollGuard = null;
|
|
124
|
+
try {
|
|
125
|
+
const pollPromise = adapter.poll();
|
|
126
|
+
const result = await (pollTimeoutMs > 0
|
|
127
|
+
? Promise.race([
|
|
128
|
+
pollPromise,
|
|
129
|
+
new Promise((_, reject) => {
|
|
130
|
+
pollGuard = setTimeout(() => reject(new Error(`x11 poll timeout (${pollTimeoutMs}ms; connection dead?)`)), pollTimeoutMs);
|
|
131
|
+
}),
|
|
132
|
+
])
|
|
133
|
+
: pollPromise);
|
|
134
|
+
if (!result) throw new Error('adapter returned null (connection dead)');
|
|
135
|
+
const ts = now();
|
|
136
|
+
const own = result.own
|
|
137
|
+
? { w: result.own.w, h: result.own.h }
|
|
138
|
+
: null;
|
|
139
|
+
const rects = result.own && result.own.w > 0 && result.own.h > 0
|
|
140
|
+
? result.occluders.map((r) => [r[0] - result.own.x, r[1] - result.own.y, r[2], r[3]])
|
|
141
|
+
: null;
|
|
142
|
+
const nextContent = contentOf({ epoch: result.epoch, own, rects });
|
|
143
|
+
const gen = nextContent !== lastContent ? snapshot.gen + 1 : snapshot.gen;
|
|
144
|
+
const changed = gen !== snapshot.gen;
|
|
145
|
+
lastContent = nextContent;
|
|
146
|
+
snapshot = {
|
|
147
|
+
ok: 1,
|
|
148
|
+
backend: 'x11',
|
|
149
|
+
epoch: result.epoch,
|
|
150
|
+
gen,
|
|
151
|
+
own,
|
|
152
|
+
rects,
|
|
153
|
+
ts,
|
|
154
|
+
};
|
|
155
|
+
// 内容变化日志(QA 契约:遮挡结果必须可观测)。gen 不变时静默 —— 1Hz 心跳
|
|
156
|
+
// 不刷屏;变化时一行给出 own 尺寸、矩形数与可见率估计(面积口径,供对账)。
|
|
157
|
+
if (changed) {
|
|
158
|
+
const areaOwn = own ? own.w * own.h : 0;
|
|
159
|
+
const areaOcc = rects ? rects.reduce((a, r) => a + r[2] * r[3], 0) : 0;
|
|
160
|
+
const visible = areaOwn > 0 ? Math.max(0, 1 - areaOcc / areaOwn) : 1;
|
|
161
|
+
const line = `[occlusion] snapshot gen=${gen} own=${own ? `${own.w}x${own.h}` : 'null'} rects=${rects ? rects.length : 'null'} visible=${visible.toFixed(2)} epoch=${result.epoch}`;
|
|
162
|
+
safeLog(line);
|
|
163
|
+
// 同一行落诊断档案(diag/http.jsonl,轮转):utility 子进程的 console 在本
|
|
164
|
+
// 架构里不回终端,档案是宿主侧唯一可靠落点。低频(仅内容变化)。
|
|
165
|
+
if (typeof diag === 'function') {
|
|
166
|
+
try {
|
|
167
|
+
diag({ ev: 'snapshot', gen, own, rects: rects ? rects.length : null, visible: Number(visible.toFixed(3)), epoch: result.epoch });
|
|
168
|
+
} catch { /* 诊断失败不影响服务 */ }
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
} catch (err) {
|
|
172
|
+
// 采集失败 ⇒ 降级(清遮挡,渲染器回全速),30s 后重建适配器重试。
|
|
173
|
+
const gen = snapshot.backend === 'none' ? snapshot.gen : snapshot.gen + 1;
|
|
174
|
+
lastContent = 'none';
|
|
175
|
+
snapshot = degradedSnapshot(gen, now());
|
|
176
|
+
logOnce('poll-failed', `x11 poll failed, degraded to backend=none: ${err && err.message}`);
|
|
177
|
+
if (typeof diag === 'function') {
|
|
178
|
+
try {
|
|
179
|
+
diag({ ev: 'degrade', gen, reason: String((err && err.message) || err).slice(0, 160) });
|
|
180
|
+
} catch { /* 诊断失败不影响服务 */ }
|
|
181
|
+
}
|
|
182
|
+
scheduleAdapterRestart();
|
|
183
|
+
} finally {
|
|
184
|
+
// require-atomic-updates(噪声,非竞态):`busy` 是重入锁 —— 函数开头 `if (busy || …) return;`
|
|
185
|
+
// 保证同一时刻至多一个 recompute 在飞,写者只有它自己(进入时置真、这里置假),事件回调只读它。
|
|
186
|
+
// eslint 报的是"读过后跨 await 再写"的形状,语义却是"我这一趟跑完了"。
|
|
187
|
+
busy = false;
|
|
188
|
+
if (pollGuard) clearTimeout(pollGuard);
|
|
189
|
+
// trailing 补算:busy 中 / 合并窗内被丢的事件在这里补上一拍,不让事件退化成
|
|
190
|
+
// "只能等下一跳心跳"(最坏 1s 延迟)。dirty 在进入补算前清位,防自递归。
|
|
191
|
+
if (dirty && !disposed && adapter) {
|
|
192
|
+
dirty = false;
|
|
193
|
+
recompute().catch(() => { /* 不外抛 */ });
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
function scheduleAdapterRestart() {
|
|
199
|
+
if (disposed || retryTimer) return;
|
|
200
|
+
if (adapter) {
|
|
201
|
+
try {
|
|
202
|
+
adapter.stop();
|
|
203
|
+
} catch {
|
|
204
|
+
/* stop 幂等,异常吞掉 */
|
|
205
|
+
}
|
|
206
|
+
adapter = null;
|
|
207
|
+
}
|
|
208
|
+
// ⚠️ 必须复位 started:start() 首行 `if (started || disposed) return` 会把
|
|
209
|
+
// 重试回调直接弹回去 —— 不复位的话重试循环是死代码,降级后永不恢复
|
|
210
|
+
// (评审 P1 实测复现:retry 到期 built 计数不涨)。
|
|
211
|
+
started = false;
|
|
212
|
+
retryTimer = setTimeout(() => {
|
|
213
|
+
retryTimer = null;
|
|
214
|
+
start().catch(() => { /* start 内部已降级并记录,不外抛 */ });
|
|
215
|
+
}, retryStartMs);
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
async function start() {
|
|
219
|
+
if (started || disposed) return;
|
|
220
|
+
started = true; // 无论成败都算「已启动」——重试走 retryTimer,不走重复 start。
|
|
221
|
+
if (!isCandidate()) {
|
|
222
|
+
logOnce('not-candidate', 'not an X11 session (non-linux, no DISPLAY, or Wayland), backend=none');
|
|
223
|
+
scheduleAdapterRestart(); // 会话可能在登录切换后出现 —— 低频重试兜底。
|
|
224
|
+
return;
|
|
225
|
+
}
|
|
226
|
+
try {
|
|
227
|
+
adapter = createAdapter(ownPid === undefined ? {} : { ownPid });
|
|
228
|
+
await adapter.start();
|
|
229
|
+
// dispose 可能恰好落在 start 挂起期间(stop 已把 adapter 置 null):
|
|
230
|
+
// 此时不得再挂 onChange,否则 TypeError 会被 catch 误判成 start-failed,
|
|
231
|
+
// 白 +1 gen 并打一条假降级日志污染 QA 时序。
|
|
232
|
+
if (disposed) return;
|
|
233
|
+
adapter.onChange(onAdapterEvent);
|
|
234
|
+
logOnce('started', `occlusion hub started (${snapshot.epoch || 'x11'})`);
|
|
235
|
+
await recompute();
|
|
236
|
+
pollTimer = setInterval(() => {
|
|
237
|
+
recompute().catch(() => { /* recompute 不外抛;这里兜底防 unhandled */ });
|
|
238
|
+
}, pollMs);
|
|
239
|
+
// #241:宿主优雅退出不等插件 unload ⇒ 轮询定时器必须 unref,否则事件循环永远撑住。
|
|
240
|
+
try { pollTimer.unref?.(); } catch { /* ignore */ }
|
|
241
|
+
} catch (err) {
|
|
242
|
+
snapshot = degradedSnapshot(snapshot.gen + 1, now());
|
|
243
|
+
logOnce('start-failed', `x11 adapter start failed, backend=none: ${err && err.message}`);
|
|
244
|
+
scheduleAdapterRestart();
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
function onAdapterEvent() {
|
|
249
|
+
const t = now();
|
|
250
|
+
// busy 中 / 合并窗内的事件不丢:置 dirty,由 recompute 的 finally 补算一拍。
|
|
251
|
+
if (busy) {
|
|
252
|
+
dirty = true;
|
|
253
|
+
return;
|
|
254
|
+
}
|
|
255
|
+
if (t - lastEventAt < EVENT_COALESCE_MS) {
|
|
256
|
+
dirty = true;
|
|
257
|
+
return;
|
|
258
|
+
}
|
|
259
|
+
lastEventAt = t;
|
|
260
|
+
recompute().catch(() => { /* 同上 */ });
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
return {
|
|
264
|
+
start,
|
|
265
|
+
/** 永不抛错、永不回空 —— 路由层零防御直发。返回**拷贝**:调用方原地改写
|
|
266
|
+
* (含 rects 数组)不得污染其他读者(getSnapshot 的"永不抛"契约不含防改写,
|
|
267
|
+
* 这里用复制把契约做实)。 */
|
|
268
|
+
getSnapshot() {
|
|
269
|
+
const s = snapshot;
|
|
270
|
+
return {
|
|
271
|
+
...s,
|
|
272
|
+
own: s.own ? { ...s.own } : null,
|
|
273
|
+
rects: s.rects ? s.rects.map((r) => [r[0], r[1], r[2], r[3]]) : null,
|
|
274
|
+
};
|
|
275
|
+
},
|
|
276
|
+
dispose() {
|
|
277
|
+
if (disposed) return;
|
|
278
|
+
disposed = true;
|
|
279
|
+
if (pollTimer) clearInterval(pollTimer);
|
|
280
|
+
if (retryTimer) clearTimeout(retryTimer);
|
|
281
|
+
pollTimer = retryTimer = null;
|
|
282
|
+
if (adapter) {
|
|
283
|
+
try {
|
|
284
|
+
adapter.stop();
|
|
285
|
+
} catch {
|
|
286
|
+
/* 幂等 */
|
|
287
|
+
}
|
|
288
|
+
adapter = null;
|
|
289
|
+
}
|
|
290
|
+
},
|
|
291
|
+
};
|
|
292
|
+
}
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 清单 JSON 路由 —— `GET ${BASE}/inventory`。
|
|
3
|
+
*
|
|
4
|
+
* 为什么独立成族:P0.2-D 把 `apply()` 里最后一条内联路由处理器搬了出来,门面只剩
|
|
5
|
+
* 「建 kit → 装路由 → 返回 disposer」的装配骨架。处理器体逐字搬来(原本就在 apply() 里
|
|
6
|
+
* 2 格缩进 ⇒ 本文件里的缩进逐字未变),路径 / 头 / 状态码 / 错误文案一律不变。
|
|
7
|
+
*
|
|
8
|
+
* 契约:registerInventoryRoutes(webServer, c);`c` 里是这一族要用、但不属于它的东西:
|
|
9
|
+
* - disposers apply() 的清理句柄台账(注册返回值**必须**推进去)
|
|
10
|
+
* - base URL 前缀(= 门面 BASE,这里本地别名为 BASE)
|
|
11
|
+
* - mediaOriginApi 媒体源访问器(`observeAdapter(req)`)
|
|
12
|
+
* - buildInventory 清单构建器(门面模块作用域的 3s TTL 缓存,生命周期 = 一次 apply)
|
|
13
|
+
* - componentsProbe 组件行**行状态**探针(门面 `componentProbe()`,只读;见下「组件行状态」)
|
|
14
|
+
*
|
|
15
|
+
* 不变量:
|
|
16
|
+
* - `mediaOriginApi.observeAdapter(req)` 必须在 `buildInventory()` **之前**:媒体源起不起
|
|
17
|
+
* 由本次请求的形态决定。
|
|
18
|
+
* - 成功响应头逐字保留:`application/json; charset=utf-8` + `Cache-Control: no-store`;
|
|
19
|
+
* 500 分支只有 `application/json`(**不带** charset),字面量按 P0 纪律原样搬来,
|
|
20
|
+
* 不要"顺手"改用 sendJson(那会多出 `; charset=utf-8`)。
|
|
21
|
+
* - 只 import `node:*` 与相对路径;**绝不** import `lib/index.js`。
|
|
22
|
+
*
|
|
23
|
+
* ── 组件行状态(`inventory.components`,ADR-0013 D3 的**状态面**)────────────────────
|
|
24
|
+
* 形状(跨半边契约,浏览器半边按它 gate 可见面):
|
|
25
|
+
* `{ "<组件名>": "started" | "failed:<错误文案>" | "missing" }`
|
|
26
|
+
* · `started`:该组件行的 apply 跑完、disposer 已交回宿主 —— **唯一算"可用"的值**;
|
|
27
|
+
* · `failed:<…>`:apply 抛错(文案随行,便于排障;判定不可用只该看前缀 `failed`);
|
|
28
|
+
* · `missing` :该行**存在**(本包内建)但运行时**没有**装载 —— 行被 `disabled`、或入口没走到。
|
|
29
|
+
* 键集 = 该次装载的**内建声明面**(探针的 `builtin`,即 `componentImpls()` 的键)。
|
|
30
|
+
* 为什么不用探针的 `declared`(同一个键集、且被 `test/verify-bundle-rows.mjs` 钉成"逐名等于 patch 子行"):
|
|
31
|
+
* 那个面表达的是**装载面**(这次到底装了什么),`/diag-log` 的买家要的是它;
|
|
32
|
+
* 行状态表要的是**代码内建面**(这个包写死了哪些组件行)—— 两者当前取值相同,但**读取方向必须有优先序**:
|
|
33
|
+
* 先 `builtin`、`declared` 只作"更老/更窄的宿主"的兜底。
|
|
34
|
+
* ⚠️ 别把这条读成"关掉的行会在 `declared` 里消失":`declared` 是调用点传进来的**同一个键集**
|
|
35
|
+
* (`lib/index.js` 现在把 `componentImpls()` 的键同时传给两个面),它 **不知道** patch 行的启停 ——
|
|
36
|
+
* "行被 disable"最终由**账本**表达:没装载 ⇒ 不在 `started` / `failed` 里 ⇒ 落到 `missing`。
|
|
37
|
+
* 两个面都保留在探针里,是为了让下游买家各自认自己那一面,且不放开 `declared` 的既有判据。
|
|
38
|
+
*
|
|
39
|
+
* ⚠️ **失效口径(D3③,跨半边纪律)**:整个 `components` 字段可能**缺席**
|
|
40
|
+
* (探针不可用 / 响应来自更老的宿主)⇒ 消费方必须**按"可用"渲染**(宁可显示,不可静默消失)。
|
|
41
|
+
* 这条与"内核缺键即抛"是不同场景的两条纪律:缺键 = 装错(响亮报错),探测失败 = 不许让功能凭空消失。
|
|
42
|
+
* ⇒ 本族因此在探针不可用时**不合成**一份"全 missing"的假地图,而是让字段缺席。
|
|
43
|
+
*
|
|
44
|
+
* 单一真源:三本账(loaded / started / failed)都在 `lib/host-boot.js`;
|
|
45
|
+
* 本文件只做**派生**(把三本账折叠成上面这张状态表),不持有任何组件状态。
|
|
46
|
+
*/
|
|
47
|
+
import { gzipSync } from 'node:zlib';
|
|
48
|
+
|
|
49
|
+
/** 注入契约(P2-7A / ADR-0013 D12):本族从 `c` 消费的**必需**键 —— 门面/组件行调用点必须逐键给到(判据 test/verify-inject-contracts.mjs 双向对账)。 */
|
|
50
|
+
export const DEPS = ['disposers', 'base', 'mediaOriginApi', 'buildInventory', 'componentsProbe'];
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* 探针三面 → 行状态表(形状见文件头「组件行状态」)。
|
|
54
|
+
* 纯派生,不改探针、不缓存。**先读内建面**(`builtin`:本包写死了哪些组件行)——
|
|
55
|
+
* 行被 disable 时它在 `declared` 里不出现、但在 `builtin` 里必然出现 ⇒ 才有一个值为 `missing`
|
|
56
|
+
* 的键可以表达"这一行被关掉了"。退一步用 `declared` 兜底(探针来自更老 / 更窄的宿主时)。
|
|
57
|
+
* 探针不可用(不是函数 / **抛错** / 返回非对象 / 两个面都读不出)时返回 `null` —— 调用方据此**不写**
|
|
58
|
+
* `components` 字段,而不是合成"全不可用"(失效口径:宁可显示)。
|
|
59
|
+
* ⚠️ **探针抛错必须在这里吞掉**:`components` 只是可选的状态面,它不该有能力把整条清单(壁纸库)
|
|
60
|
+
* 一起打成 500 —— 那等于让"可选面不可用"升级成"主功能不可用",与 D3③ 的方向相反。
|
|
61
|
+
* @param {unknown} probe 门面注入的 `componentProbe()`
|
|
62
|
+
* @returns {Record<string, string> | null}
|
|
63
|
+
*/
|
|
64
|
+
function rowStatusOf(probe) {
|
|
65
|
+
/** @type {any} */
|
|
66
|
+
let p;
|
|
67
|
+
try {
|
|
68
|
+
p = typeof probe === 'function' ? probe() : null;
|
|
69
|
+
} catch {
|
|
70
|
+
p = null; // 探针抛错 = 状态面不可用(不是"全都不在")⇒ 交给下面的失效口径
|
|
71
|
+
}
|
|
72
|
+
if (!p || typeof p !== 'object') return null;
|
|
73
|
+
const rows = Array.isArray(p.builtin) && p.builtin.length ? p.builtin
|
|
74
|
+
: (Array.isArray(p.declared) && p.declared.length ? p.declared : null);
|
|
75
|
+
if (!rows) return null;
|
|
76
|
+
const failed = (p.failed && typeof p.failed === 'object') ? p.failed : {};
|
|
77
|
+
const started = Array.isArray(p.started) ? p.started : [];
|
|
78
|
+
const out = {};
|
|
79
|
+
for (const name of rows) {
|
|
80
|
+
if (started.includes(name)) out[name] = 'started';
|
|
81
|
+
// `in` 而不是真值判断:空文案的失败也是失败(`failed:''` 折叠成 `missing` 会把"抛错"误报成"没装载")。
|
|
82
|
+
else if (name in failed) out[name] = `failed:${failed[name]}`;
|
|
83
|
+
else out[name] = 'missing';
|
|
84
|
+
}
|
|
85
|
+
return out;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** 压缩阈值与级别:与主包 `lib/json-response.js`(及宿主 webserver 默认值)逐条同口径。 */
|
|
89
|
+
const GZIP_MIN_BYTES = 1024;
|
|
90
|
+
const GZIP_LEVEL = 1;
|
|
91
|
+
|
|
92
|
+
/** 客户端是否接受 gzip(`gzip;q=0` = 明确不要)。口径与主包 `sendJson` 的协商逐字相同。 */
|
|
93
|
+
function acceptsGzip(req) {
|
|
94
|
+
const header = req && req.headers ? req.headers['accept-encoding'] : undefined;
|
|
95
|
+
if (typeof header !== 'string') return false;
|
|
96
|
+
const m = /(?:^|,)\s*gzip\s*(?:;\s*q=([0-9.]+))?\s*(?=,|$)/i.exec(header);
|
|
97
|
+
return !!m && (m[1] === undefined || Number(m[1]) > 0);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
export function registerInventoryRoutes(webServer, c) {
|
|
101
|
+
const { disposers, base: BASE, mediaOriginApi, buildInventory, componentsProbe } = c;
|
|
102
|
+
|
|
103
|
+
// 1. Inventory JSON.
|
|
104
|
+
disposers.push(webServer.register({
|
|
105
|
+
kind: 'exact',
|
|
106
|
+
path: `${BASE}/inventory`,
|
|
107
|
+
handler: async (req, res) => {
|
|
108
|
+
try {
|
|
109
|
+
mediaOriginApi.observeAdapter(req); // 先观测再建库:媒体源起不起由本次请求的形态决定
|
|
110
|
+
const payload = await buildInventory();
|
|
111
|
+
// 组件行状态(只读,形状与失效口径见文件头「组件行状态」):探针不可用时**不写**该字段 ——
|
|
112
|
+
// 消费方据此按"可用"渲染,而不是把"探测失败"渲染成"组件都没了"。
|
|
113
|
+
const components = rowStatusOf(componentsProbe);
|
|
114
|
+
const body = Buffer.from(JSON.stringify(components ? { ...payload, components } : payload), 'utf8');
|
|
115
|
+
res.setHeader('Content-Type', 'application/json; charset=utf-8');
|
|
116
|
+
res.setHeader('Cache-Control', 'no-store');
|
|
117
|
+
// ── 协商式 gzip(#158 回归)────────────────────────────────────────────────
|
|
118
|
+
// 1.4.0 时这条路由还在主包 `lib/index.js` 里、走 `sendJson`,大库 `/inventory`
|
|
119
|
+
// 是 MB 级载荷、按 Accept-Encoding 协商压缩;`0949e625` 加的就是这条。
|
|
120
|
+
// P0.2-D 把处理器逐字搬进本包后,序列化改成了裸 `JSON.stringify` + `res.end`
|
|
121
|
+
// ⇒ **恒 identity**:冷扫 1.86 MB 全量下行(实测 ~2 MB),是「启动/切页卡」的一条硬账。
|
|
122
|
+
// 本包不能 import 主包的 `sendJson`(跨包纪律:零主包 specifier)⇒ 就地实现同一份口径:
|
|
123
|
+
// · 只在客户端声明 gzip、载荷 ≥ 1 KB、且不是 HEAD 时压(与 lib/json-response.js 逐条同源);
|
|
124
|
+
// · 头逐字保留(含 charset;500 分支仍按原样不带 charset);
|
|
125
|
+
// · `Vary` 必须写 —— 同一 URL 对有无 gzip 的请求回不同字节,缓存不能混。
|
|
126
|
+
if (body.length >= GZIP_MIN_BYTES && req.method !== 'HEAD') {
|
|
127
|
+
res.setHeader('Vary', 'Accept-Encoding');
|
|
128
|
+
if (acceptsGzip(req)) {
|
|
129
|
+
res.setHeader('Content-Encoding', 'gzip');
|
|
130
|
+
res.end(gzipSync(body, { level: GZIP_LEVEL }));
|
|
131
|
+
return;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
res.end(body);
|
|
135
|
+
} catch (err) {
|
|
136
|
+
res.statusCode = 500;
|
|
137
|
+
res.setHeader('Content-Type', 'application/json');
|
|
138
|
+
res.end(JSON.stringify({ error: String(err && err.message ? err.message : err) }));
|
|
139
|
+
}
|
|
140
|
+
},
|
|
141
|
+
}));
|
|
142
|
+
}
|