@@ -263,6 +263,9 @@ export function createSummarizer(ctx, service, config) {
263263 // Issue #127:per-session 上一次实际开跑时刻(最小间隔闸门用)。与 inFlight
264264 // 同生命周期,dispose 时一并清空。
265265 const lastRunAt = new Map ( ) ;
266+ // Issue #239:per-session 已发起的蒸馏次数(有界检查点用)。只在实际发起 LLM
267+ // 调用时自增,因此被零 LLM 预判挡下的窗口不消耗预算。
268+ const runsUsed = new Map ( ) ;
266269 // Issue #210:只在一次蒸馏完整成功后记录已消费的最后事件 seq。
267270 const lastDistilledSeq = new Map ( ) ;
268271 let disposed = false ;
@@ -308,6 +311,24 @@ export function createSummarizer(ctx, service, config) {
308311 } ) ;
309312 return ;
310313 }
314+ // Issue #239(有界检查点):每会话 run 预算。放在间隔门之后,两者都命中时
315+ // 先报间隔——间隔是「刚刚跑过」,预算是「额度用尽」,前者信息量更大。skip
316+ // 仍写审计(沿用间隔门的 error_message 口径),否则「为什么不再蒸馏了」对
317+ // 用户不可观测。prevRuns 在这里捕获、finally 里按 aborted 回滚(同 lastRunAt)。
318+ // 游标刻意不消费:预算是「这个会话先不再蒸馏了」,把窗口留在原地,日后调高
319+ // 额度(或宿主重启)仍能蒸馏到它;这与 window-too-small 主动消费游标相反——
320+ // 后者是「这些事件不值得蒸馏」,留着只会每个 turn/end 重评一次。
321+ const prevRuns = runsUsed . get ( session . id ) ;
322+ const maxRuns = config . summarizeMaxRunsPerSession ?? 0 ;
323+ if ( maxRuns > 0 && ( prevRuns ?? 0 ) >= maxRuns ) {
324+ writeAudit ( {
325+ timestamp : new Date ( ) . toISOString ( ) ,
326+ model_id : route ? `${ route . provider } :${ route . model } ` : "unknown" ,
327+ status : "skipped" ,
328+ error_message : "max-runs-per-session"
329+ } ) ;
330+ return ;
331+ }
311332 const controller = new AbortController ( ) ;
312333 inFlight . set ( session . id , controller ) ;
313334 // audit state for the compression call. null = no audit for this run
@@ -342,9 +363,33 @@ export function createSummarizer(ctx, service, config) {
342363 return ;
343364 }
344365 const messages = collected . messages ;
345- // 只有真正准备发起一次 LLM 蒸馏时才占用最小间隔;失败路径仍按原语义
346- // 占用,aborted 则由 finally 回滚。
366+ // Issue #239(成本感知级联第一级):零 LLM 预判。窗口内可蒸馏文本不足阈值
367+ // 时直接跳过——短窗口交给模型的产出多是泛泛而谈,代价却是一次完整调用。
368+ // 判定纯规则(字符数),无模型参与;被挡下的窗口照常消费游标,否则每个
369+ // turn/end 都会重新评估同一段短文本。skip 原因进审计,作为后续按真实负载
370+ // 决定下一级规则的依据。
371+ const minWindowChars = config . summarizeMinWindowChars ?? 0 ;
372+ if ( minWindowChars > 0 ) {
373+ const distillChars = messages . reduce (
374+ ( total , message ) => total + ( Array . isArray ( message . content ) ? message . content : [ ] )
375+ . reduce ( ( n , part ) => n + ( typeof part ?. text === "string" ? part . text . length : 0 ) , 0 ) ,
376+ 0
377+ ) ;
378+ if ( distillChars < minWindowChars ) {
379+ if ( Number . isFinite ( nextSeq ) ) lastDistilledSeq . set ( session . id , nextSeq ) ;
380+ writeAudit ( {
381+ timestamp : new Date ( ) . toISOString ( ) ,
382+ model_id : route ? `${ route . provider } :${ route . model } ` : "unknown" ,
383+ status : "skipped" ,
384+ error_message : "window-too-small"
385+ } ) ;
386+ return ;
387+ }
388+ }
389+ // 只有真正准备发起一次 LLM 蒸馏时才占用最小间隔与 run 预算;失败路径仍按
390+ // 原语义占用(调用确实发生过),aborted 则由 finally 回滚。
347391 lastRunAt . set ( session . id , Date . now ( ) ) ;
392+ runsUsed . set ( session . id , ( prevRuns ?? 0 ) + 1 ) ;
348393
349394 if ( config ?. llmAudit ?. enabled !== false && typeof service . saveLlmAudit === "function" ) {
350395 audit = {
@@ -525,6 +570,10 @@ export function createSummarizer(ctx, service, config) {
525570 if ( abortedRun || controller . signal . aborted ) {
526571 if ( prevClaim === undefined ) lastRunAt . delete ( session . id ) ;
527572 else lastRunAt . set ( session . id , prevClaim ) ;
573+ // Issue #239:aborted 同样不占 run 预算——调用没有真正发生,占了会误伤
574+ // 该会话后续的蒸馏(与上面的间隔回滚同一口径)。
575+ if ( prevRuns === undefined ) runsUsed . delete ( session . id ) ;
576+ else runsUsed . set ( session . id , prevRuns ) ;
528577 }
529578 if ( audit ) {
530579 try {
0 commit comments