dsh-pf-stream 0.0.0-stage → 0.1.2

package/lib/stage1/gradient.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Stage 1 —— Sobel 梯度与灰度直方图（64×36 感知灰度图上的纯函数）。
+ *
+ * 规格《三、前端轻量感知与施密特四状态机》：
+ * - g_t 为整帧 3×3 Sobel 梯度幅值均值；
+ * - 分块 ḡ_{t,k} 为块内 Sobel 幅值均值（8×9 块）；
+ * - 硬切判据用相邻帧 16-bin 归一化灰度直方图 L1 距离。
+ *
+ * 边界处理：3×3 邻域在图像边缘按最近邻钳制（确定性，无随机性）。
+ */
+export declare const GRAY_W = 64;
+export declare const GRAY_H = 36;
+export declare const GRID_COLS = 8;
+export declare const GRID_ROWS = 4;
+export declare const BLOCK_W = 8;
+export declare const BLOCK_H = 9;
+export declare const BLOCK_COUNT: number;
+/** 整帧 Sobel 幅值图（长度 GRAY_W*GRAY_H）。 */
+export declare function sobelMagnitude(gray: Float64Array): Float64Array;
+/** 整帧梯度均值 g_t。 */
+export declare function frameSobelMean(mag: Float64Array): number;
+/** 32 分块的块内 Sobel 幅值均值 ḡ_k。 */
+export declare function blockSobelMeans(mag: Float64Array): Float64Array;
+/** 16-bin 归一化灰度直方图（总和为 1）。 */
+export declare function grayHistogram16(gray: Float64Array): Float64Array;
+/** 相邻帧直方图 L1 距离 D_hist。 */
+export declare function histL1Distance(a: Float64Array, b: Float64Array): number;

package/lib/stage1/gradient.js

@@ -0,0 +1,85 @@
+/**
+ * Stage 1 —— Sobel 梯度与灰度直方图（64×36 感知灰度图上的纯函数）。
+ *
+ * 规格《三、前端轻量感知与施密特四状态机》：
+ * - g_t 为整帧 3×3 Sobel 梯度幅值均值；
+ * - 分块 ḡ_{t,k} 为块内 Sobel 幅值均值（8×9 块）；
+ * - 硬切判据用相邻帧 16-bin 归一化灰度直方图 L1 距离。
+ *
+ * 边界处理：3×3 邻域在图像边缘按最近邻钳制（确定性，无随机性）。
+ */
+export const GRAY_W = 64;
+export const GRAY_H = 36;
+export const GRID_COLS = 8;
+export const GRID_ROWS = 4;
+export const BLOCK_W = 8;
+export const BLOCK_H = 9;
+export const BLOCK_COUNT = GRID_COLS * GRID_ROWS;
+/** 整帧 Sobel 幅值图（长度 GRAY_W*GRAY_H）。 */
+export function sobelMagnitude(gray) {
+    const out = new Float64Array(GRAY_W * GRAY_H);
+    for (let y = 0; y < GRAY_H; y++) {
+        for (let x = 0; x < GRAY_W; x++) {
+            const xm = x > 0 ? x - 1 : 0;
+            const xp = x < GRAY_W - 1 ? x + 1 : GRAY_W - 1;
+            const ym = y > 0 ? y - 1 : 0;
+            const yp = y < GRAY_H - 1 ? y + 1 : GRAY_H - 1;
+            const tl = gray[ym * GRAY_W + xm];
+            const tc = gray[ym * GRAY_W + x];
+            const tr = gray[ym * GRAY_W + xp];
+            const ml = gray[y * GRAY_W + xm];
+            const mr = gray[y * GRAY_W + xp];
+            const bl = gray[yp * GRAY_W + xm];
+            const bc = gray[yp * GRAY_W + x];
+            const br = gray[yp * GRAY_W + xp];
+            const gx = tr + 2 * mr + br - tl - 2 * ml - bl;
+            const gy = bl + 2 * bc + br - tl - 2 * tc - tr;
+            out[y * GRAY_W + x] = Math.hypot(gx, gy);
+        }
+    }
+    return out;
+}
+/** 整帧梯度均值 g_t。 */
+export function frameSobelMean(mag) {
+    let sum = 0;
+    for (let i = 0; i < mag.length; i++)
+        sum += mag[i];
+    return sum / mag.length;
+}
+/** 32 分块的块内 Sobel 幅值均值 ḡ_k。 */
+export function blockSobelMeans(mag) {
+    const out = new Float64Array(BLOCK_COUNT);
+    for (let br = 0; br < GRID_ROWS; br++) {
+        for (let bc = 0; bc < GRID_COLS; bc++) {
+            let sum = 0;
+            for (let y = 0; y < BLOCK_H; y++) {
+                for (let x = 0; x < BLOCK_W; x++) {
+                    sum += mag[(br * BLOCK_H + y) * GRAY_W + bc * BLOCK_W + x];
+                }
+            }
+            out[br * GRID_COLS + bc] = sum / (BLOCK_W * BLOCK_H);
+        }
+    }
+    return out;
+}
+/** 16-bin 归一化灰度直方图（总和为 1）。 */
+export function grayHistogram16(gray) {
+    const hist = new Float64Array(16);
+    for (let i = 0; i < gray.length; i++) {
+        const v = gray[i];
+        const bin = Math.min(15, Math.max(0, Math.floor(v * 16)));
+        hist[bin] += 1;
+    }
+    const total = gray.length;
+    for (let b = 0; b < 16; b++)
+        hist[b] = hist[b] / total;
+    return hist;
+}
+/** 相邻帧直方图 L1 距离 D_hist。 */
+export function histL1Distance(a, b) {
+    let sum = 0;
+    for (let i = 0; i < 16; i++)
+        sum += Math.abs(a[i] - b[i]);
+    return sum;
+}
+//# sourceMappingURL=gradient.js.map

package/lib/stage1/gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.js","sourceRoot":"","sources":["../../src/stage1/gradient.ts"],"names":[],"mappings":"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"}

package/lib/stage1/perceive.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Stage 1 —— 前端轻量感知：双通道变化标量 d_t 与频闪翻转率 r_flip。
+ *
+ * 规格《三》§1/§2：
+ * - 64×36 归一化灰度 → 32 分块（8 列 × 4 行，每块 8×9）；
+ * - δ_k = clamp(δ_raw/(ḡ_k+0.05) × 0.25, 0, 1)，ΔB_k = w_k·δ_k（roi_hint 命中 w=2.0，其余 0.5）；
+ * - d_global = ΣΔB/Σw；d_local = 前 3 极值块均值（空间 8-邻域连通 + 时间持续门控）；
+ * - d_t = max(d_global, d_local)；
+ * - r_flip：|M_t| ≥ 16 时连续两步差分符号翻转比例，> 0.6 → α=0.1，否则 α=1.0；
+ * - 等效 30fps 步长（ΔPTS ≥ 33.3ms）由流式引擎在送帧前保证，变帧率时间归一
+ *   （× ΔPTS/33.3）在积分侧执行（Stage 3）。
+ */
+import type { BlockSignal, RoiHint } from '../types.js';
+/** 分块网格坐标。 */
+export declare function blockGridPos(k: number): {
+    row: number;
+    col: number;
+};
+/** 切比雪夫距离 D∞。 */
+export declare function chebyshev(a: number, b: number): number;
+/** roi_hint → 32 分块权重（命中块 2.0，其余 0.5；无 roi 全 1.0）。 */
+export declare function blockWeights(roi: RoiHint | null | undefined): number[];
+export interface PerceptionContext {
+    /** 上一感知步灰度图（首帧为 null）。 */
+    prevGray: Float64Array | null;
+    /** 上一感知步有符号帧差 ΔI_{t-1}。 */
+    prevDelta: Float64Array | null;
+    /** 上一感知步前 3 极值块索引 K_{t-1}（d_local=0 或首帧后为 null）。 */
+    prevTopK: number[] | null;
+    /** 上一感知步极值块索引 k*_{t-1}。 */
+    prevArgmax: number | null;
+    /** 上一感知步位移向量 v_{t-1}（k* 网格位移）。 */
+    prevVec: [number, number] | null;
+    /** 上一感知步 16-bin 直方图。 */
+    prevHist: Float64Array | null;
+}
+export declare function createPerceptionContext(): PerceptionContext;
+/** 重置时间持续上下文（SWITCH 原子步骤 4 后调用）。 */
+export declare function resetTemporalContext(ctx: PerceptionContext): void;
+export interface PerceptionResult {
+    ptsMs: number;
+    blocks: BlockSignal[];
+    dGlobal: number;
+    dLocal: number;
+    d: number;
+    /** 整帧 Sobel 均值 g_t。 */
+    g: number;
+    rFlip: number;
+    alpha: number;
+    /** 硬切候选：δ_raw>0.30 或 δ>0.30 的分块数。 */
+    switchCandidateBlocks: number;
+    /** 与上一帧的直方图 L1 距离（上一帧缺失时为 0）。 */
+    histL1: number;
+    /** 本步前 3 极值块（未通过门控也为调用方保留上下文）。 */
+    topK: number[];
+    argmax: number;
+    vec: [number, number] | null;
+    hist: Float64Array;
+}
+/**
+ * 单感知步。调用方保证步进 ΔPTS ≥ 33.3ms。
+ * hHighEff 用于高速跨块补偿门控（位移 2 块时 δ_{k*} > 2×H_high_eff）。
+ */
+export declare function perceiveFrame(ctx: PerceptionContext, ptsMs: number, gray: Float64Array, weights: number[], hHighEff: number): PerceptionResult;
+/** RGB 图 → 64×36 归一化灰度（box 均值降采样）。 */
+export declare function toGray64x36(width: number, height: number, rgb: Uint8Array): Float64Array;

package/lib/stage1/perceive.js

@@ -0,0 +1,233 @@
+/**
+ * Stage 1 —— 前端轻量感知：双通道变化标量 d_t 与频闪翻转率 r_flip。
+ *
+ * 规格《三》§1/§2：
+ * - 64×36 归一化灰度 → 32 分块（8 列 × 4 行，每块 8×9）；
+ * - δ_k = clamp(δ_raw/(ḡ_k+0.05) × 0.25, 0, 1)，ΔB_k = w_k·δ_k（roi_hint 命中 w=2.0，其余 0.5）；
+ * - d_global = ΣΔB/Σw；d_local = 前 3 极值块均值（空间 8-邻域连通 + 时间持续门控）；
+ * - d_t = max(d_global, d_local)；
+ * - r_flip：|M_t| ≥ 16 时连续两步差分符号翻转比例，> 0.6 → α=0.1，否则 α=1.0；
+ * - 等效 30fps 步长（ΔPTS ≥ 33.3ms）由流式引擎在送帧前保证，变帧率时间归一
+ *   （× ΔPTS/33.3）在积分侧执行（Stage 3）。
+ */
+import { BLOCK_COUNT, BLOCK_H, BLOCK_W, GRAY_H, GRAY_W, GRID_COLS, blockSobelMeans, grayHistogram16, histL1Distance, sobelMagnitude, } from './gradient.js';
+const GAMMA_SCALE = 0.25;
+const GRAD_EPS = 0.05;
+const FLIP_PIXEL_THRESHOLD = 0.02;
+const FLIP_MIN_PIXELS = 16;
+const TOP_K = 3;
+/** 分块网格坐标。 */
+export function blockGridPos(k) {
+    return { row: Math.floor(k / GRID_COLS), col: k % GRID_COLS };
+}
+/** 切比雪夫距离 D∞。 */
+export function chebyshev(a, b) {
+    const pa = blockGridPos(a);
+    const pb = blockGridPos(b);
+    return Math.max(Math.abs(pa.row - pb.row), Math.abs(pa.col - pb.col));
+}
+/** roi_hint → 32 分块权重（命中块 2.0，其余 0.5；无 roi 全 1.0）。 */
+export function blockWeights(roi) {
+    const w = new Array(BLOCK_COUNT).fill(1);
+    if (!roi)
+        return w;
+    for (let br = 0; br < 4; br++) {
+        for (let bc = 0; bc < GRID_COLS; bc++) {
+            const x0 = bc / GRID_COLS;
+            const x1 = (bc + 1) / GRID_COLS;
+            const y0 = br / 4;
+            const y1 = (br + 1) / 4;
+            const overlap = Math.max(0, Math.min(x1, roi.x + roi.w) - Math.max(x0, roi.x)) *
+                Math.max(0, Math.min(y1, roi.y + roi.h) - Math.max(y0, roi.y));
+            w[br * GRID_COLS + bc] = overlap > 0 ? 2.0 : 0.5;
+        }
+    }
+    return w;
+}
+export function createPerceptionContext() {
+    return { prevGray: null, prevDelta: null, prevTopK: null, prevArgmax: null, prevHist: null, prevVec: null };
+}
+/** 重置时间持续上下文（SWITCH 原子步骤 4 后调用）。 */
+export function resetTemporalContext(ctx) {
+    ctx.prevTopK = null;
+    ctx.prevArgmax = null;
+    ctx.prevVec = null;
+}
+/**
+ * 单感知步。调用方保证步进 ΔPTS ≥ 33.3ms。
+ * hHighEff 用于高速跨块补偿门控（位移 2 块时 δ_{k*} > 2×H_high_eff）。
+ */
+export function perceiveFrame(ctx, ptsMs, gray, weights, hHighEff) {
+    const mag = sobelMagnitude(gray);
+    const blockSobel = blockSobelMeans(mag);
+    let g = 0;
+    for (let i = 0; i < mag.length; i++)
+        g += mag[i];
+    g /= mag.length;
+    const hist = grayHistogram16(gray);
+    const histL1 = ctx.prevHist ? histL1Distance(hist, ctx.prevHist) : 0;
+    const blocks = [];
+    const delta = new Float64Array(gray.length);
+    let flipCount = 0;
+    let mCount = 0;
+    if (ctx.prevGray) {
+        for (let i = 0; i < gray.length; i++) {
+            delta[i] = gray[i] - ctx.prevGray[i];
+        }
+        for (let y = 0; y < GRAY_H; y++) {
+            for (let x = 0; x < GRAY_W; x++) {
+                const i = y * GRAY_W + x;
+                const dt = delta[i];
+                if (Math.abs(dt) > FLIP_PIXEL_THRESHOLD) {
+                    mCount++;
+                    const dprev = ctx.prevDelta ? ctx.prevDelta[i] : 0;
+                    if (Math.abs(dprev) > FLIP_PIXEL_THRESHOLD && dt * dprev < 0)
+                        flipCount++;
+                }
+            }
+        }
+    }
+    let switchCandidateBlocks = 0;
+    const deltaB = new Float64Array(BLOCK_COUNT);
+    for (let br = 0; br < 4; br++) {
+        for (let bc = 0; bc < GRID_COLS; bc++) {
+            const k = br * GRID_COLS + bc;
+            let rawSum = 0;
+            for (let y = 0; y < BLOCK_H; y++) {
+                for (let x = 0; x < BLOCK_W; x++) {
+                    rawSum += Math.abs(delta[(br * BLOCK_H + y) * GRAY_W + bc * BLOCK_W + x]);
+                }
+            }
+            const deltaRaw = rawSum / (BLOCK_W * BLOCK_H);
+            const deltaNorm = Math.min(1, Math.max(0, (deltaRaw / (blockSobel[k] + GRAD_EPS)) * GAMMA_SCALE));
+            deltaB[k] = weights[k] * deltaNorm;
+            blocks.push({
+                row: br,
+                col: bc,
+                deltaRaw,
+                delta: deltaNorm,
+                weight: weights[k],
+                sobelMean: blockSobel[k],
+            });
+            if (deltaRaw > 0.3 || deltaNorm > 0.3)
+                switchCandidateBlocks++;
+        }
+    }
+    // 全局通道
+    let sumB = 0;
+    let sumW = 0;
+    for (let k = 0; k < BLOCK_COUNT; k++) {
+        sumB += deltaB[k];
+        sumW += weights[k];
+    }
+    const dGlobal = sumB / sumW;
+    // 前 3 极值块（稳定排序：值降序，索引升序）
+    const order = Array.from({ length: BLOCK_COUNT }, (_, k) => k).sort((a, b) => {
+        const diff = deltaB[b] - deltaB[a];
+        return diff !== 0 ? diff : a - b;
+    });
+    const topK = order.slice(0, TOP_K);
+    const argmax = topK[0];
+    // 空间连通：K_t 中至少 2 块互为 8-邻域
+    let spatial = false;
+    for (let i = 0; i < topK.length && !spatial; i++) {
+        for (let j = i + 1; j < topK.length; j++) {
+            if (chebyshev(topK[i], topK[j]) <= 1) {
+                spatial = true;
+                break;
+            }
+        }
+    }
+    // 位移向量 v_t
+    const pos = blockGridPos(argmax);
+    let vec = null;
+    if (ctx.prevArgmax !== null) {
+        const prev = blockGridPos(ctx.prevArgmax);
+        vec = [pos.row - prev.row, pos.col - prev.col];
+    }
+    // 时间持续与高速跨块补偿
+    let temporal = false;
+    if (ctx.prevTopK === null || ctx.prevTopK.length === 0) {
+        temporal = true; // 首帧 / 状态重置帧：仅由空间连通决定
+    }
+    else {
+        let minDist = Infinity;
+        for (const j of ctx.prevTopK)
+            minDist = Math.min(minDist, chebyshev(argmax, j));
+        if (minDist <= 1) {
+            temporal = true;
+        }
+        else if (minDist === 2) {
+            const strongEnough = blocks[argmax].delta > 2 * hHighEff;
+            const aligned = vec !== null && ctx.prevVec !== null && cosineSimilarity(vec, ctx.prevVec) >= 0.5;
+            temporal = strongEnough && aligned;
+        }
+    }
+    let dLocal = 0;
+    if (spatial && temporal) {
+        let s = 0;
+        for (const k of topK)
+            s += deltaB[k];
+        dLocal = s / TOP_K;
+    }
+    const rFlip = mCount < FLIP_MIN_PIXELS ? 0 : flipCount / mCount;
+    const alpha = rFlip > 0.6 ? 0.1 : 1.0;
+    // 上下文更新
+    ctx.prevGray = gray;
+    ctx.prevDelta = delta;
+    ctx.prevTopK = dLocal > 0 ? topK : null;
+    ctx.prevArgmax = argmax;
+    ctx.prevVec = vec;
+    ctx.prevHist = hist;
+    return {
+        ptsMs,
+        blocks,
+        dGlobal,
+        dLocal,
+        d: Math.max(dGlobal, dLocal),
+        g,
+        rFlip,
+        alpha,
+        switchCandidateBlocks,
+        histL1,
+        topK,
+        argmax,
+        vec,
+        hist,
+    };
+}
+function cosineSimilarity(a, b) {
+    const dot = a[0] * b[0] + a[1] * b[1];
+    const na = Math.hypot(a[0], a[1]);
+    const nb = Math.hypot(b[0], b[1]);
+    if (na === 0 || nb === 0)
+        return 0;
+    return dot / (na * nb);
+}
+/** RGB 图 → 64×36 归一化灰度（box 均值降采样）。 */
+export function toGray64x36(width, height, rgb) {
+    const out = new Float64Array(GRAY_W * GRAY_H);
+    for (let gy = 0; gy < GRAY_H; gy++) {
+        const y0 = Math.floor((gy * height) / GRAY_H);
+        const y1 = Math.max(y0 + 1, Math.floor(((gy + 1) * height) / GRAY_H));
+        for (let gx = 0; gx < GRAY_W; gx++) {
+            const x0 = Math.floor((gx * width) / GRAY_W);
+            const x1 = Math.max(x0 + 1, Math.floor(((gx + 1) * width) / GRAY_W));
+            let sum = 0;
+            let count = 0;
+            for (let y = y0; y < y1; y++) {
+                for (let x = x0; x < x1; x++) {
+                    const i = (y * width + x) * 3;
+                    const r = rgb[i];
+                    const gg = rgb[i + 1];
+                    const b = rgb[i + 2];
+                    sum += 0.299 * r + 0.587 * gg + 0.114 * b;
+                    count++;
+                }
+            }
+            out[gy * GRAY_W + gx] = count > 0 ? sum / count / 255 : 0;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=perceive.js.map

package/lib/stage1/perceive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perceive.js","sourceRoot":"","sources":["../../src/stage1/perceive.ts"],"names":[],"mappings":"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"}

package/lib/stage2/stateMachine.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Stage 2 —— 施密特四状态机（规格《三》§3）。
+ *
+ * STATIC / MOTION / SETTLE / SWITCH：
+ * - 高阈值 H_high_eff（动态，默认 0.10），低阈值联动 H_low_eff = 0.5×H_high_eff；
+ * - SETTLE 满 T_settle_eff（PTS 差值）→ 锁定 F、A←0、转 STATIC，再经 T_merge=50ms 打包；
+ * - SWITCH 原子抢占：清积分、清 P 队列、废擂台、EMA 重置 + 3 帧预热、R4 快定格、
+ *   捕获 F_switch（黑场顺延由流式引擎执行）、转 STATIC 观察 250ms。
+ *
+ * 所有时间判定基于 PTS（契约 5）。积分器 A 与擂台归状态机管，
+ * 待发 P 队列与 F 编码由 Stage 3 流式采样器执行。
+ */
+import type { StateKind, StateMachineSnapshot } from '../types.js';
+export interface SchmittThresholds {
+    hHighEff: number;
+    /** T_settle_eff 生效值（R4 时由流式引擎瞬时置 80ms）。 */
+    tSettleEff: number;
+    tMergeMs: number;
+    /** SWITCH 后静态观察窗口（250ms）。 */
+    switchStaticMs: number;
+}
+export type MachineEffect = 'enter_motion' | 'settle_enter' | 'settle_cancel' | 'settle_lock' | 'merge_emit' | 'switch' | 'switch_static_emit' | 'switch_motion_void';
+export interface MachineStep {
+    /** 本步生效的状态（无迁移时为当前态）。 */
+    state: StateKind;
+    effects: MachineEffect[];
+}
+export declare class SchmittMachine {
+    state: StateKind;
+    enteredAtPtsMs: number;
+    integratorA: number;
+    gEma: number;
+    emaWarmupLeft: number;
+    settleStartPtsMs: number | null;
+    /** SETTLE 锁定后的防碎合并窗起点。 */
+    mergeStartPtsMs: number | null;
+    lastAnchorGlobalId: number | null;
+    /** SWITCH 后静态观察起点与 F_switch 待发标志。 */
+    switchStaticSincePtsMs: number | null;
+    fSwitchPending: boolean;
+    constructor(init?: Partial<StateMachineSnapshot>);
+    snapshot(): StateMachineSnapshot;
+    /** H_low_eff 联动。 */
+    static hLowOf(hHighEff: number): number;
+    /**
+     * 单帧步进。switchVerdict 由 SwitchDetector 先行判定；
+     * settleArena 由流式引擎维护（观察窗内 g 最高帧），settle_lock 时取用。
+     */
+    step(ptsMs: number, d: number, th: SchmittThresholds, switchVerdict: 'none' | 'SWITCH' | 'WHIP'): MachineStep;
+    private toMotion;
+}
+export interface ClarityState {
+    gEma: number;
+    warmupLeft: number;
+    rhoHistory: number[];
+}
+export declare function createClarityState(): ClarityState;
+/** 更新 EMA（1/8 系数）与 ρ；预热期内用当前帧梯度初始化/推进。 */
+export declare function updateClarity(cs: ClarityState, g: number, opts?: {
+    resetWarmup?: boolean;
+}): number;
+/**
+ * PEAK 局部波峰判定：ρ_{t-1} ≥ ρ_{t-2} 且 ρ_{t-1} > ρ_t 且 ρ_{t-1} ≥ ρ_min。
+ * 预热期（warmupLeft > 0 或历史不足 3 帧）不判波峰（返回 false）。
+ */
+export declare function isLocalPeak(cs: ClarityState, rhoMin: number): boolean;
+/** 擂台比较：候选是否击败当前记录（ρ 更高；无记录时恒真）。 */
+export declare function beatsArena(candidate: {
+    rho: number;
+} | null, rho: number): boolean;