dsh-pf-stream 0.0.0-stage → 0.1.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.
Files changed (92) hide show
  1. package/LICENSE +201 -0
  2. package/README.en.md +110 -0
  3. package/README.md +109 -2
  4. package/cordis.patch.yml +2 -0
  5. package/lib/entry/adapter.d.ts +21 -0
  6. package/lib/entry/adapter.js +112 -0
  7. package/lib/entry/adapter.js.map +1 -0
  8. package/lib/entry/legacyNormalizer.d.ts +16 -0
  9. package/lib/entry/legacyNormalizer.js +86 -0
  10. package/lib/entry/legacyNormalizer.js.map +1 -0
  11. package/lib/errors.d.ts +7 -0
  12. package/lib/errors.js +12 -0
  13. package/lib/errors.js.map +1 -0
  14. package/lib/index.d.ts +108 -0
  15. package/lib/index.js +109 -0
  16. package/lib/index.js.map +1 -0
  17. package/lib/session/state.d.ts +25 -0
  18. package/lib/session/state.js +255 -0
  19. package/lib/session/state.js.map +1 -0
  20. package/lib/stage0/decoder.d.ts +57 -0
  21. package/lib/stage0/decoder.js +229 -0
  22. package/lib/stage0/decoder.js.map +1 -0
  23. package/lib/stage0/ffmpeg.d.ts +34 -0
  24. package/lib/stage0/ffmpeg.js +90 -0
  25. package/lib/stage0/ffmpeg.js.map +1 -0
  26. package/lib/stage0/probe.d.ts +47 -0
  27. package/lib/stage0/probe.js +150 -0
  28. package/lib/stage0/probe.js.map +1 -0
  29. package/lib/stage1/gradient.d.ts +27 -0
  30. package/lib/stage1/gradient.js +85 -0
  31. package/lib/stage1/gradient.js.map +1 -0
  32. package/lib/stage1/perceive.d.ts +66 -0
  33. package/lib/stage1/perceive.js +233 -0
  34. package/lib/stage1/perceive.js.map +1 -0
  35. package/lib/stage2/stateMachine.d.ts +70 -0
  36. package/lib/stage2/stateMachine.js +180 -0
  37. package/lib/stage2/stateMachine.js.map +1 -0
  38. package/lib/stage2/switchDetector.d.ts +18 -0
  39. package/lib/stage2/switchDetector.js +34 -0
  40. package/lib/stage2/switchDetector.js.map +1 -0
  41. package/lib/stage3/deterministicRouter.d.ts +44 -0
  42. package/lib/stage3/deterministicRouter.js +203 -0
  43. package/lib/stage3/deterministicRouter.js.map +1 -0
  44. package/lib/stage3/streamSampler.d.ts +74 -0
  45. package/lib/stage3/streamSampler.js +497 -0
  46. package/lib/stage3/streamSampler.js.map +1 -0
  47. package/lib/stage4/canvasPacker.d.ts +60 -0
  48. package/lib/stage4/canvasPacker.js +161 -0
  49. package/lib/stage4/canvasPacker.js.map +1 -0
  50. package/lib/stage4/markers.d.ts +19 -0
  51. package/lib/stage4/markers.js +98 -0
  52. package/lib/stage4/markers.js.map +1 -0
  53. package/lib/stage4/viewport.d.ts +61 -0
  54. package/lib/stage4/viewport.js +151 -0
  55. package/lib/stage4/viewport.js.map +1 -0
  56. package/lib/stage5/controller.d.ts +61 -0
  57. package/lib/stage5/controller.js +260 -0
  58. package/lib/stage5/controller.js.map +1 -0
  59. package/lib/stage5/intent.d.ts +27 -0
  60. package/lib/stage5/intent.js +87 -0
  61. package/lib/stage5/intent.js.map +1 -0
  62. package/lib/stage6/history.d.ts +52 -0
  63. package/lib/stage6/history.js +155 -0
  64. package/lib/stage6/history.js.map +1 -0
  65. package/lib/stage6/precheck.d.ts +56 -0
  66. package/lib/stage6/precheck.js +86 -0
  67. package/lib/stage6/precheck.js.map +1 -0
  68. package/lib/tool/handler.d.ts +35 -0
  69. package/lib/tool/handler.js +56 -0
  70. package/lib/tool/handler.js.map +1 -0
  71. package/lib/tool/schema.d.ts +29 -0
  72. package/lib/tool/schema.js +59 -0
  73. package/lib/tool/schema.js.map +1 -0
  74. package/lib/tool/streamCall.d.ts +41 -0
  75. package/lib/tool/streamCall.js +105 -0
  76. package/lib/tool/streamCall.js.map +1 -0
  77. package/lib/types.d.ts +355 -0
  78. package/lib/types.js +11 -0
  79. package/lib/types.js.map +1 -0
  80. package/lib/utils/ffmpegBin.d.ts +20 -0
  81. package/lib/utils/ffmpegBin.js +62 -0
  82. package/lib/utils/ffmpegBin.js.map +1 -0
  83. package/lib/utils/hash.d.ts +13 -0
  84. package/lib/utils/hash.js +24 -0
  85. package/lib/utils/hash.js.map +1 -0
  86. package/lib/utils/image.d.ts +32 -0
  87. package/lib/utils/image.js +135 -0
  88. package/lib/utils/image.js.map +1 -0
  89. package/lib/utils/pts.d.ts +15 -0
  90. package/lib/utils/pts.js +50 -0
  91. package/lib/utils/pts.js.map +1 -0
  92. package/package.json +55 -4
@@ -0,0 +1,497 @@
1
+ /**
2
+ * Stage 3 —— 流式采样引擎(pf_stream 主体,规格《三》《四》《六》)。
3
+ *
4
+ * 单遍顺序解码(decodeRangeStreaming)+ 逐帧感知 + 施密特状态机驱动:
5
+ * - P 单元:MOTION 位移积分(A += α·d·ΔPTS/33.3,A ≥ S_eff 出一张 336 P);
6
+ * - F 单元:SETTLE 观察窗最清晰帧 / MOTION PEAK 擂台 / SWITCH 静态保底(黑场顺延 ≤300ms);
7
+ * - 四路流式发包:PATH_SETTLE / PEAK_FULL / PEAK_TIMEOUT / SWITCH_STATIC(DETERMINISTIC 在
8
+ * deterministicRouter);M2 阶段全部 history_mode = 'initial';
9
+ * - R4 快定格:SWITCH 时 T_settle_eff 直写 80ms,首个 MOTION 或静态稳定后恢复基准;
10
+ * - 近邻去重:<500ms 且期间 d < H_low 的未发出 F 原地覆盖;
11
+ * - 长静止心跳:每 5s(PTS)一条轻量 JSON,独立编号空间,不参与包龄计算;
12
+ * - 时间判定全部基于 PTS(契约 5);相同视频输入产出幂等事件流(case 19 断言)。
13
+ */
14
+ import { decodeRangeStreaming } from '../stage0/decoder.js';
15
+ import { blockGridPos, blockWeights, createPerceptionContext, perceiveFrame, resetTemporalContext, toGray64x36, } from '../stage1/perceive.js';
16
+ import { SchmittMachine, beatsArena, createClarityState, updateClarity, } from '../stage2/stateMachine.js';
17
+ import { classifySceneChange, isBlackOrBlownFrame } from '../stage2/switchDetector.js';
18
+ import { packCanvas, timelineHintLine } from '../stage4/canvasPacker.js';
19
+ import { applyViewport, planViewport } from '../stage4/viewport.js';
20
+ import { baselinesFromIntent } from '../stage5/intent.js';
21
+ import { StreamController } from '../stage5/controller.js';
22
+ export const STEP_MS = 33.3;
23
+ export const T_MERGE_MS = 50;
24
+ export const SWITCH_STATIC_MS = 250;
25
+ export const F_SWITCH_DEFER_MAX_MS = 300;
26
+ export const NEAR_DUP_MS = 500;
27
+ export const HEARTBEAT_INTERVAL_MS = 5000;
28
+ class StopIteration extends Error {
29
+ reason;
30
+ constructor(reason) {
31
+ super(reason);
32
+ this.reason = reason;
33
+ }
34
+ }
35
+ export async function runStreamPass(videoPath, probe, sessionIntent, cursor, options) {
36
+ const baselines = baselinesFromIntent(sessionIntent.mode, sessionIntent.focus);
37
+ const weights = blockWeights(sessionIntent.roiHint);
38
+ const w0 = Math.min(options.windowStartMs ?? cursor.lastConsumedPtsMs, probe.lastPtsMs);
39
+ const w1 = Math.min(w0 + options.windowMs, probe.lastPtsMs);
40
+ const ctrl = new StreamController(baselines, w0, cursor.snapshot.ctrl);
41
+ const packets = [];
42
+ const hintLines = [];
43
+ const heartbeats = [];
44
+ const counters = {
45
+ packetSeq: options.packetIdStart - 1,
46
+ globalUnitSeq: options.globalIdStart - 1,
47
+ heartbeatSeq: options.heartbeatSeqStart - 1,
48
+ };
49
+ if (w0 >= probe.lastPtsMs) {
50
+ return {
51
+ packets,
52
+ hintLines,
53
+ heartbeats,
54
+ telemetry: emptyTelemetry(baselines, [w0, w1], 'end_of_stream'),
55
+ nextCursor: cursor,
56
+ counters,
57
+ };
58
+ }
59
+ const rt = restoreRuntime(cursor);
60
+ const perception = createPerceptionContext();
61
+ const decodeStart = Date.now();
62
+ let perceiveMs = 0;
63
+ let packMs = 0;
64
+ let framesDecoded = 0;
65
+ let framesStepped = 0;
66
+ let ptsRealign = 0;
67
+ let stopReason = 'end_of_window';
68
+ let lastPtsOfWindow = null;
69
+ const ffmpegSpawns = [];
70
+ let arenaMaxHeld = 0;
71
+ const emit = (trigger, withF = true) => {
72
+ const t0 = performance.now();
73
+ const units = [];
74
+ const pUnits = rt.pendingP.splice(0);
75
+ for (const p of pUnits) {
76
+ counters.globalUnitSeq++;
77
+ units.push({
78
+ globalId: counters.globalUnitSeq,
79
+ ptsMs: p.ptsMs,
80
+ scale: '1x1_P',
81
+ eventType: 'MOTION',
82
+ image: p.image,
83
+ sourceCropBbox: p.sourceCropBbox,
84
+ });
85
+ }
86
+ let fUnit = null;
87
+ if (trigger === 'SETTLE' && rt.pendingF)
88
+ fUnit = rt.pendingF;
89
+ else if (trigger === 'PEAK_FULL' && withF && rt.motionArena) {
90
+ fUnit = {
91
+ ptsMs: rt.motionArena.ptsMs,
92
+ image: rt.motionArena.image,
93
+ sourceCropBbox: rt.motionArena.sourceCropBbox,
94
+ eventType: 'MOTION',
95
+ };
96
+ }
97
+ else if (trigger === 'PEAK_TIMEOUT' && (rt.motionArena ?? rt.settleArena)) {
98
+ const src = rt.motionArena ?? rt.settleArena;
99
+ fUnit = {
100
+ ptsMs: src.ptsMs,
101
+ image: src.image,
102
+ sourceCropBbox: src.sourceCropBbox,
103
+ eventType: 'MOTION',
104
+ };
105
+ }
106
+ else if (trigger === 'SWITCH_STATIC' && rt.fSwitchImage) {
107
+ fUnit = { ...rt.fSwitchImage, eventType: 'SWITCH_STATIC' };
108
+ }
109
+ let form;
110
+ if (trigger === 'SWITCH_STATIC')
111
+ form = 'FORM_3_COMPACT_1F';
112
+ else if (!fUnit)
113
+ form = 'FORM_2_COMPACT_4P';
114
+ else if (units.length >= 4)
115
+ form = 'FORM_1_STANDARD_STRIP';
116
+ else if (units.length >= 1)
117
+ form = 'FORM_4_PARTIAL_STRIP';
118
+ else
119
+ form = 'FORM_3_COMPACT_1F';
120
+ if (units.length === 0 && !fUnit) {
121
+ // 空包保护:无单元时跳过本包(清待发标记后返回)
122
+ if (trigger === 'SETTLE')
123
+ rt.pendingF = null;
124
+ return;
125
+ }
126
+ if (fUnit) {
127
+ counters.globalUnitSeq++;
128
+ units.push({
129
+ globalId: counters.globalUnitSeq,
130
+ ptsMs: fUnit.ptsMs,
131
+ scale: '2x2_F',
132
+ eventType: fUnit.eventType,
133
+ image: fUnit.image,
134
+ sourceCropBbox: fUnit.sourceCropBbox,
135
+ });
136
+ }
137
+ if (trigger === 'SETTLE')
138
+ rt.pendingF = null;
139
+ if (trigger === 'PEAK_FULL' && withF)
140
+ rt.motionArena = null;
141
+ if (trigger === 'PEAK_TIMEOUT') {
142
+ rt.motionArena = null;
143
+ rt.settleArena = null;
144
+ }
145
+ if (trigger === 'SWITCH_STATIC')
146
+ rt.fSwitchImage = null;
147
+ counters.packetSeq++;
148
+ const artifact = packCanvas(form, units, {
149
+ packetId: counters.packetSeq,
150
+ appliedIntentId: options.appliedIntentId,
151
+ appliedCtrlId: ctrl.activeCtrlIds(),
152
+ renderVisualId: options.renderVisualId,
153
+ triggerPath: trigger,
154
+ });
155
+ packets.push(artifact);
156
+ hintLines.push(timelineHintLine(artifact.packet, sessionIntent.roiHint ?? null));
157
+ if (fUnit) {
158
+ rt.lastFEmittedPtsMs = fUnit.ptsMs;
159
+ rt.maxDSinceLastF = 0;
160
+ }
161
+ rt.tokensUsed += form === 'FORM_1_STANDARD_STRIP' || form === 'FORM_4_PARTIAL_STRIP' ? 530 : 274;
162
+ packMs += performance.now() - t0;
163
+ };
164
+ const capture = (frame, ptsMs, slot, dLocal, topK) => {
165
+ let roi = sessionIntent.roiHint ?? null;
166
+ const fullFrame = sessionIntent.fullFrame;
167
+ if (!roi && !fullFrame && dLocal > 0 && topK.length > 0) {
168
+ // 运动极值块簇质心 → 1:1 正方形视窗(契约 4)
169
+ let cx = 0;
170
+ let cy = 0;
171
+ for (const k of topK) {
172
+ const p = blockGridPos(k);
173
+ cx += (p.col + 0.5) / 8;
174
+ cy += (p.row + 0.5) / 4;
175
+ }
176
+ cx /= topK.length;
177
+ cy /= topK.length;
178
+ const side = Math.min(frame.width, frame.height) / Math.max(frame.width, frame.height);
179
+ roi = { x: clamp01(cx - side / 2), y: clamp01(cy - side / 2), w: side, h: side };
180
+ }
181
+ const plan = planViewport({
182
+ displayWidth: frame.width,
183
+ displayHeight: frame.height,
184
+ roi: roi ?? undefined,
185
+ fullFrame,
186
+ slot,
187
+ });
188
+ // sourceCropBbox 回映射到源视频显示坐标系(工作副本等比缩放)
189
+ const sx = probe.displayWidth / frame.width;
190
+ const sy = probe.displayHeight / frame.height;
191
+ const [x, y, w, h] = plan.sourceCropBbox;
192
+ return {
193
+ image: applyViewport(frame, plan, slot),
194
+ ptsMs,
195
+ sourceCropBbox: [Math.round(x * sx), Math.round(y * sy), Math.round(w * sx), Math.round(h * sy)],
196
+ };
197
+ };
198
+ try {
199
+ const result = await decodeRangeStreaming(videoPath, w0, w1, {
200
+ ffmpegPath: options.ffmpegPath,
201
+ displayWidth: probe.displayWidth,
202
+ displayHeight: probe.displayHeight,
203
+ workMaxEdge: options.streamWorkMaxEdge,
204
+ onFfmpegSpawn: (argv) => ffmpegSpawns.push(argv.slice()),
205
+ signal: options.signal,
206
+ }, (frame, ptsMs) => {
207
+ framesDecoded++;
208
+ // 等效 30fps 步长门(契约 5):ΔPTS ≥ 33.3ms 才进入感知
209
+ if (rt.lastStepPtsMs !== null && ptsMs - rt.lastStepPtsMs < STEP_MS)
210
+ return;
211
+ framesStepped++;
212
+ const t0 = performance.now();
213
+ const gray = toGray64x36(frame.width, frame.height, frame.data);
214
+ const signal = perceiveFrame(perception, ptsMs, gray, weights, ctrl.live.HHighEff);
215
+ const verdict = classifySceneChange(signal.switchCandidateBlocks, signal.histL1);
216
+ const step = rt.machine.step(ptsMs, signal.d, {
217
+ hHighEff: ctrl.live.HHighEff,
218
+ tSettleEff: ctrl.live.TSettleEff,
219
+ tMergeMs: T_MERGE_MS,
220
+ switchStaticMs: SWITCH_STATIC_MS,
221
+ }, verdict);
222
+ const stepScale = rt.lastStepPtsMs === null ? 1 : (ptsMs - rt.lastStepPtsMs) / STEP_MS;
223
+ rt.lastStepPtsMs = ptsMs;
224
+ if (rt.lastHeartbeatPtsMs === null)
225
+ rt.lastHeartbeatPtsMs = ptsMs;
226
+ // 清晰度 EMA 与 ρ
227
+ const rho = updateClarity(rt.clarity, signal.g);
228
+ // ---- 状态机效果 ----
229
+ for (const effect of step.effects) {
230
+ switch (effect) {
231
+ case 'switch': {
232
+ // 原子步骤 1-5 在状态机内;采样器侧:清队列、废擂台、R4 直写、感知时序重置
233
+ rt.pendingP.length = 0;
234
+ rt.pendingF = null;
235
+ rt.motionArena = null;
236
+ rt.settleArena = null;
237
+ ctrl.onSwitch(ptsMs);
238
+ resetTemporalContext(perception);
239
+ updateClarity(rt.clarity, signal.g, { resetWarmup: true });
240
+ rt.fSwitchImage = null;
241
+ if (isBlackOrBlownFrame(gray)) {
242
+ rt.fSwitchWaitDeadline = ptsMs + F_SWITCH_DEFER_MAX_MS; // 黑场/过曝顺延
243
+ }
244
+ else {
245
+ rt.fSwitchWaitDeadline = null;
246
+ rt.fSwitchImage = capture(frame, ptsMs, 'F', signal.dLocal, signal.topK);
247
+ }
248
+ break;
249
+ }
250
+ case 'enter_motion': {
251
+ rt.motionArena = null;
252
+ // 合并确认窗内运动复发:已锁定的待发 F 保留,
253
+ // 留待与新 P 簇合并发出(状态机 merge_emit 路径);
254
+ // R4 恢复路径①由 controller.onFrameStepped 的状态迁移检测完成
255
+ rt.motionEnteredAtPtsMs = ptsMs;
256
+ updateClarity(rt.clarity, signal.g, { resetWarmup: true });
257
+ break;
258
+ }
259
+ case 'settle_enter':
260
+ rt.settleArena = null;
261
+ break;
262
+ case 'settle_cancel':
263
+ rt.motionEnteredAtPtsMs = ptsMs;
264
+ break;
265
+ case 'settle_lock': {
266
+ // 锁定观察窗最清晰帧为待发 F。近邻(<500ms 且期间 d < H_low)时为原地覆盖语义:
267
+ // 单槽位待发 F 直接被更清晰的停稳帧替换(M4 接入 FUnitCache 后补缓存条目清理)。
268
+ const source = rt.settleArena;
269
+ if (source) {
270
+ rt.pendingF = {
271
+ ptsMs: source.ptsMs,
272
+ image: source.image,
273
+ sourceCropBbox: source.sourceCropBbox,
274
+ eventType: 'SETTLE',
275
+ };
276
+ }
277
+ break;
278
+ }
279
+ case 'merge_emit':
280
+ emit('SETTLE');
281
+ break;
282
+ case 'switch_static_emit':
283
+ if (rt.fSwitchImage)
284
+ emit('SWITCH_STATIC');
285
+ break;
286
+ case 'switch_motion_void':
287
+ rt.fSwitchImage = null;
288
+ rt.fSwitchWaitDeadline = null;
289
+ break;
290
+ default:
291
+ break;
292
+ }
293
+ }
294
+ // ---- 自闭环节拍(500ms PTS;R3>R1>R2 求值 + 一阶平滑,R4 状态迁移恢复)----
295
+ ctrl.onFrameStepped(ptsMs, signal.d, signal.rFlip, rt.machine.state);
296
+ // ---- MOTION 段:位移积分采样 + PEAK 擂台 + 容量/超时边界 ----
297
+ if (rt.machine.state === 'MOTION') {
298
+ rt.machine.integratorA += ctrl.alphaFor(signal.alpha) * signal.d * stepScale;
299
+ while (rt.machine.integratorA >= ctrl.live.SEff) {
300
+ rt.machine.integratorA = Math.min(rt.machine.integratorA - ctrl.live.SEff, ctrl.live.SEff - 1e-4);
301
+ rt.pendingP.push(capture(frame, ptsMs, 'P', signal.dLocal, signal.topK));
302
+ }
303
+ if (rt.clarity.warmupLeft <= 0 && beatsArena(rt.motionArena, rho)) {
304
+ const f = capture(frame, ptsMs, 'F', signal.dLocal, signal.topK);
305
+ rt.motionArena = {
306
+ ptsMs,
307
+ rho,
308
+ g: signal.g,
309
+ image: f.image,
310
+ sourceCropBbox: f.sourceCropBbox,
311
+ };
312
+ }
313
+ if (rt.pendingP.length >= 4) {
314
+ const cooled = rt.lastFEmittedPtsMs === null ||
315
+ ptsMs - rt.lastFEmittedPtsMs >= ctrl.live.TCoolEff;
316
+ const withF = cooled && rt.clarity.warmupLeft <= 0 && rt.motionArena !== null;
317
+ if (withF)
318
+ emit('PEAK_FULL', true);
319
+ else
320
+ emit('PEAK_FULL', false); // 未满冷却/预热期 → 纯 4P(FORM_2)
321
+ }
322
+ if (rt.motionEnteredAtPtsMs !== null &&
323
+ ptsMs - rt.motionEnteredAtPtsMs >= ctrl.live.tMaxMEff &&
324
+ rt.pendingP.length >= 1 &&
325
+ rt.pendingP.length <= 3) {
326
+ emit('PEAK_TIMEOUT');
327
+ rt.motionEnteredAtPtsMs = ptsMs;
328
+ }
329
+ }
330
+ // ---- SETTLE 段:观察窗最清晰帧跟踪 ----
331
+ if (rt.machine.state === 'SETTLE' &&
332
+ (rt.settleArena === null || signal.g > rt.settleArena.g)) {
333
+ rt.settleArena = { ...capture(frame, ptsMs, 'F', signal.dLocal, signal.topK), g: signal.g };
334
+ }
335
+ // ---- F_switch 黑场顺延捕获 ----
336
+ if (rt.machine.fSwitchPending &&
337
+ !rt.fSwitchImage &&
338
+ rt.fSwitchWaitDeadline !== null &&
339
+ !isBlackOrBlownFrame(gray)) {
340
+ rt.fSwitchImage = capture(frame, ptsMs, 'F', signal.dLocal, signal.topK);
341
+ rt.fSwitchWaitDeadline = null;
342
+ }
343
+ else if (rt.machine.fSwitchPending &&
344
+ !rt.fSwitchImage &&
345
+ rt.fSwitchWaitDeadline !== null &&
346
+ ptsMs > rt.fSwitchWaitDeadline) {
347
+ rt.fSwitchImage = capture(frame, ptsMs, 'F', signal.dLocal, signal.topK); // 300ms 兜底
348
+ rt.fSwitchWaitDeadline = null;
349
+ }
350
+ // ---- 长静止心跳(5s PTS,独立编号空间)----
351
+ if (rt.machine.state === 'STATIC' &&
352
+ rt.lastHeartbeatPtsMs !== null &&
353
+ ptsMs - rt.lastHeartbeatPtsMs >= HEARTBEAT_INTERVAL_MS) {
354
+ counters.heartbeatSeq++;
355
+ heartbeats.push({ seq: counters.heartbeatSeq, ptsMs });
356
+ rt.lastHeartbeatPtsMs = ptsMs;
357
+ }
358
+ rt.maxDSinceLastF = Math.max(rt.maxDSinceLastF, signal.d);
359
+ // 擂台单槽不变量观测:同一时刻持有的 672 槽位数(MOTION 擂台 + SETTLE 观察窗各 1)
360
+ const arenaHeld = (rt.motionArena !== null ? 1 : 0) + (rt.settleArena !== null ? 1 : 0);
361
+ if (arenaHeld > arenaMaxHeld)
362
+ arenaMaxHeld = arenaHeld;
363
+ perceiveMs += performance.now() - t0;
364
+ lastPtsOfWindow = ptsMs;
365
+ // ---- 预算停止(意图层上限)----
366
+ if (packets.length >= options.maxPackets)
367
+ throw new StopIteration('budget_packets');
368
+ if (rt.tokensUsed + 274 > options.maxTokensBudget)
369
+ throw new StopIteration('budget_tokens');
370
+ });
371
+ ptsRealign = result.realigned;
372
+ }
373
+ catch (error) {
374
+ if (error instanceof StopIteration) {
375
+ stopReason = error.reason;
376
+ }
377
+ else {
378
+ throw error;
379
+ }
380
+ }
381
+ return {
382
+ packets,
383
+ hintLines,
384
+ heartbeats,
385
+ telemetry: {
386
+ decodeMs: Date.now() - decodeStart,
387
+ perceiveMs,
388
+ packMs,
389
+ pathLatencyMs: lastPtsOfWindow !== null ? lastPtsOfWindow - w0 : 0,
390
+ framesDecoded,
391
+ framesStepped,
392
+ ptsRealign,
393
+ ffmpegSpawns,
394
+ arenaMaxHeld,
395
+ window: [w0, w1],
396
+ stopReason,
397
+ ctrlParams: { ...ctrl.live },
398
+ ctrlTickLog: ctrl.tickLog.slice(),
399
+ },
400
+ nextCursor: buildCursor(rt, cursor, lastPtsOfWindow ?? w0, ctrl),
401
+ counters,
402
+ };
403
+ }
404
+ // ---------------------------------------------------------------------------
405
+ // 游标持久化
406
+ // ---------------------------------------------------------------------------
407
+ function restoreRuntime(cursor) {
408
+ const s = cursor.snapshot;
409
+ const machine = new SchmittMachine({
410
+ state: s.state,
411
+ enteredAtPtsMs: s.enteredAtPtsMs,
412
+ integratorA: s.integratorA,
413
+ settleStartPtsMs: s.settleStartPtsMs,
414
+ });
415
+ machine.mergeStartPtsMs = s.mergeStartPtsMs ?? null;
416
+ machine.switchStaticSincePtsMs = s.switchStaticSincePtsMs ?? null;
417
+ machine.fSwitchPending = s.fSwitchPending ?? false;
418
+ return {
419
+ machine,
420
+ clarity: {
421
+ gEma: s.gEma,
422
+ warmupLeft: s.clarityWarmupLeft ?? s.emaWarmupLeft,
423
+ rhoHistory: s.rhoHistory ?? [],
424
+ },
425
+ lastStepPtsMs: cursor.lastConsumedPtsMs,
426
+ pendingP: (cursor.pendingPUnits ?? []).map((p) => ({
427
+ ptsMs: p.ptsMs,
428
+ image: { width: 336, height: 336, data: p.image336 },
429
+ sourceCropBbox: p.sourceCropBbox,
430
+ })),
431
+ motionArena: null,
432
+ settleArena: null,
433
+ pendingF: null,
434
+ fSwitchWaitDeadline: null,
435
+ fSwitchImage: null,
436
+ motionEnteredAtPtsMs: s.motionEnteredAtPtsMs ?? null,
437
+ lastFEmittedPtsMs: cursor.lastEmittedPacketPtsMs,
438
+ maxDSinceLastF: s.maxDSinceLastF ?? 1,
439
+ lastHeartbeatPtsMs: s.lastHeartbeatPtsMs ?? null,
440
+ tokensUsed: 0,
441
+ };
442
+ }
443
+ function buildCursor(rt, cursor, lastPts, ctrl) {
444
+ const snapshot = {
445
+ state: rt.machine.state,
446
+ enteredAtPtsMs: rt.machine.enteredAtPtsMs,
447
+ integratorA: rt.machine.integratorA,
448
+ gEma: rt.clarity.gEma,
449
+ emaWarmupLeft: rt.clarity.warmupLeft,
450
+ settleStartPtsMs: rt.machine.settleStartPtsMs,
451
+ lastKCandidates: null,
452
+ lastMotionVec: null,
453
+ arena: null,
454
+ mergeStartPtsMs: rt.machine.mergeStartPtsMs,
455
+ switchStaticSincePtsMs: rt.machine.switchStaticSincePtsMs,
456
+ fSwitchPending: rt.machine.fSwitchPending,
457
+ clarityWarmupLeft: rt.clarity.warmupLeft,
458
+ rhoHistory: rt.clarity.rhoHistory.slice(-3),
459
+ motionEnteredAtPtsMs: rt.motionEnteredAtPtsMs,
460
+ maxDSinceLastF: rt.maxDSinceLastF,
461
+ lastHeartbeatPtsMs: rt.lastHeartbeatPtsMs,
462
+ ctrl: ctrl.snapshot(),
463
+ };
464
+ const pendingPUnits = rt.pendingP.map((p) => ({
465
+ ptsMs: p.ptsMs,
466
+ image336: p.image.data,
467
+ sourceCropBbox: p.sourceCropBbox,
468
+ }));
469
+ return {
470
+ ...cursor,
471
+ lastConsumedPtsMs: lastPts,
472
+ lastEmittedPacketPtsMs: rt.lastFEmittedPtsMs,
473
+ snapshot,
474
+ pendingPUnits,
475
+ };
476
+ }
477
+ function emptyTelemetry(baselines, window, stopReason) {
478
+ return {
479
+ decodeMs: 0,
480
+ perceiveMs: 0,
481
+ packMs: 0,
482
+ pathLatencyMs: 0,
483
+ framesDecoded: 0,
484
+ framesStepped: 0,
485
+ ptsRealign: 0,
486
+ ffmpegSpawns: [],
487
+ arenaMaxHeld: 0,
488
+ window,
489
+ stopReason,
490
+ ctrlParams: baselines,
491
+ ctrlTickLog: [],
492
+ };
493
+ }
494
+ function clamp01(v) {
495
+ return Math.min(1, Math.max(0, v));
496
+ }
497
+ //# sourceMappingURL=streamSampler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streamSampler.js","sourceRoot":"","sources":["../../src/stage3/streamSampler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Stage 4 —— 画布打包(FORM_1..4 拼合 + PNG 字节锁定)。
3
+ *
4
+ * 排版规则(《二、双尺度视觉单元与画布形态规范》§3):
5
+ * - FORM_1 1344×672:左半区 2×2 排列 4P(P1 左上/P2 右上/P3 左下/P4 右下),右半区 1F;
6
+ * - FORM_2 672×672:2×2 排列 4P;
7
+ * - FORM_3 672×672:1F 充满画布;
8
+ * - FORM_4 1344×672:1~3P 按象限顺序填入,空象限中性灰,右半区 1F。
9
+ *
10
+ * 单元视觉标记绘制在单元图像自身(含标记的 F 像素在双载体间逐位一致)。
11
+ */
12
+ import type { CanvasPacket } from '../types.js';
13
+ import { type RgbImage } from '../utils/image.js';
14
+ export type LayoutForm = CanvasPacket['layoutForm'];
15
+ export interface UnitInput {
16
+ globalId: number;
17
+ ptsMs: number;
18
+ scale: '1x1_P' | '2x2_F';
19
+ eventType: 'MOTION' | 'SETTLE' | 'SWITCH_STATIC' | 'DETERMINISTIC';
20
+ /** 已按视窗归一化的槽位图像(336 或 672)。 */
21
+ image: RgbImage;
22
+ /** 源视频显示坐标系采样区域。 */
23
+ sourceCropBbox: [number, number, number, number];
24
+ }
25
+ export interface PacketArtifact {
26
+ packet: CanvasPacket;
27
+ /** 画布 PNG 字节(FORM_1/2/4 = 条带载体;FORM_3 = 独立载体)。 */
28
+ imageBytes: Buffer;
29
+ /** F 独立载体 PNG 字节(FORM_1/4 含 F 时存在)。 */
30
+ anchorBytes: Buffer | null;
31
+ /** F 载体规范化像素内容哈希(§6 降级轨;不含 F 时为 null)。 */
32
+ anchorFContentHash: string | null;
33
+ }
34
+ export interface PackOptions {
35
+ packetId: number;
36
+ appliedIntentId: string;
37
+ renderVisualId: boolean;
38
+ /** 触发路径(确定性通道为 DETERMINISTIC)。 */
39
+ triggerPath: CanvasPacket['triggerPath'];
40
+ /** 发包时刻激活的自闭环规则 ctrl_id 列表(流式通道)。 */
41
+ appliedCtrlId?: string[];
42
+ }
43
+ /** 画布尺寸(宽, 高)。 */
44
+ export declare function canvasSizeOf(form: LayoutForm): [number, number];
45
+ /** 计费序列长度:r×(c+1)+2(画布尺寸为 42 倍数,整除精确)。 */
46
+ export declare function billTokens(width: number, height: number): number;
47
+ /**
48
+ * 打包一个画布包。调用方保证单元数量与形态匹配:
49
+ * FORM_1=4P+1F,FORM_2=4P,FORM_3=1F,FORM_4=1~3P+1F。
50
+ */
51
+ export declare function packCanvas(form: LayoutForm, units: UnitInput[], options: PackOptions): PacketArtifact;
52
+ /** 时序提示行位置标签。 */
53
+ export declare function slotLabel(form: LayoutForm, index: number, isF: boolean): string;
54
+ /** 生成结构化时序映射提示行(首次发包 / 确定性格式)。 */
55
+ export declare function timelineHintLine(packet: CanvasPacket, roi?: {
56
+ x: number;
57
+ y: number;
58
+ w: number;
59
+ h: number;
60
+ } | null): string;