#!/usr/bin/env node /** * patch-token-saver-engine.js · TSE v1.0 · 2026-04-27 * * 安装 Token Saver Engine (TSE) 三个 Hook: * 1. token-saver-read-guard.js — PreToolUse Read 大文件拦截 * 2. token-saver-bash-limiter.js — PreToolUse Bash 输出截断 * 3. token-saver-model-advisor.js — UserPromptSubmit 模型建议 * * 同时增强 context-pressure-monitor.js 添加 60% compact 指令阈值 * * 幂等: sentinel 检查, 重复运行安全 * 用法: node scripts/patches/patch-token-saver-engine.js */ 'use strict'; const fs = require('fs'); const path = require('path'); const CLAUDE_ROOT = path.join(process.env.HOME || process.env.USERPROFILE, '.claude'); const HOOKS_DIR = path.join(CLAUDE_ROOT, 'hooks'); const SETTINGS_PATH = path.join(CLAUDE_ROOT, 'settings.json'); const SENTINEL = 'TSE_V1_INSTALLED'; // ─── Hook 1: Read Guard ─── const READ_GUARD_CODE = `#!/usr/bin/env node /** * token-saver-read-guard.js · TSE Layer 3 · 2026-04-27 * PreToolUse (Read) · 大文件读取拦截, 引导 offset/limit 分段 * 行为: fail-open, 不阻断读取, 仅注入 additionalContext 建议 */ 'use strict'; const fs = require('fs'); const path = require('path'); const CLAUDE_ROOT = require('./lib/root.js'); const readStdin = require('./lib/read-stdin.js'); const STATE_DIR = path.join(CLAUDE_ROOT, 'session-state'); const STATE_PATH = path.join(STATE_DIR, 'tse-read-guard.json'); const WARN_BYTES = 10000; const CRIT_BYTES = 35000; const THROTTLE_MS = 3 * 60 * 1000; function loadState() { try { return fs.existsSync(STATE_PATH) ? JSON.parse(fs.readFileSync(STATE_PATH, 'utf8')) : {}; } catch { return {}; } } function saveState(s) { try { if (!fs.existsSync(STATE_DIR)) fs.mkdirSync(STATE_DIR, { recursive: true }); const tmp = STATE_PATH + '.tmp.' + process.pid; fs.writeFileSync(tmp, JSON.stringify(s, null, 2), 'utf8'); fs.renameSync(tmp, STATE_PATH); } catch {} } (async () => { try { const hookData = await readStdin(); if (hookData.tool_name !== 'Read') process.exit(0); const input = hookData.tool_input || {}; if (!input.file_path) process.exit(0); if (input.offset !== undefined || input.limit !== undefined || input.pages !== undefined) process.exit(0); let fileSize = 0; try { fileSize = fs.statSync(input.file_path).size; } catch { process.exit(0); } if (fileSize < WARN_BYTES) process.exit(0); const state = loadState(); const now = Date.now(); const key = input.file_path.replace(/[\\\\\\/\\:]/g, '_'); if (state[key] && (now - state[key]) < THROTTLE_MS) process.exit(0); state[key] = now; for (const k of Object.keys(state)) { if (state[k] < now - 600000) delete state[k]; } saveState(state); const estLines = Math.round(fileSize * 30 / 1000); const estTokens = Math.round(fileSize / 3.5); const bn = path.basename(input.file_path); let msg; if (fileSize >= CRIT_BYTES) { msg = '[TSE·READ_GUARD] ⚠️ 大文件: ' + bn + ' ≈' + estLines + '行 (' + estTokens + ' tokens)\\n' + '你必须使用 offset+limit 分段读取。如需全文分析, 委托 Agent 子进程。'; } else { msg = '[TSE·READ_GUARD] 提示: ' + bn + ' ≈' + estLines + '行 (' + estTokens + ' tokens). 建议用 offset+limit 分段。'; } process.stdout.write(JSON.stringify({ continue: true, hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: msg } })); process.exit(0); } catch { process.exit(0); } })(); `; // ─── Hook 2: Bash Output Limiter ─── const BASH_LIMITER_CODE = `#!/usr/bin/env node /** * token-saver-bash-limiter.js · TSE Layer 3 · 2026-04-27 * PreToolUse (Bash) · 查看型命令自动截断输出 * 仅截断 cat/find/tree/journalctl 等查看命令, 不动 build/git/ssh 执行命令 * 行为: fail-open, 通过 updatedInput 追加 | head -N */ 'use strict'; const readStdin = require('./lib/read-stdin.js'); const VIEW_RE = [ /\\bcat\\s+\\S+/, /\\bdocker\\s+logs\\b/, /\\bjournalctl\\b/, /\\bdmesg\\b/, /\\bps\\s+aux/, /\\bfind\\s+\\//, /\\bls\\s+-[^\\s]*R/, /\\btree\\b/, /\\bsqlite3\\b.*\\.dump/, /\\bnpm\\s+ls\\b/, /\\bpip\\s+(list|freeze)\\b/, /\\bdpkg\\s+-l/, /\\bsystemctl\\s+list/, ]; const SKIP_RE = [ /\\|\\s*head\\b/, /\\|\\s*tail\\b/, /\\|\\s*grep\\b/, /\\|\\s*awk\\b/, /\\|\\s*sed\\b/, /\\|\\s*wc\\b/, /[>]/, /\\bgit\\s+(push|pull|fetch|clone|rebase|merge|commit)/, /\\bnpm\\s+(install|run|build|test)/, /\\bpnpm\\s/, /\\bdocker\\s+(build|run|push|compose)/, /\\bssh\\b/, /\\bscp\\b/, /\\bcurl\\b/, /\\bwget\\b/, /\\bmake\\b/, /\\bcargo\\b/, /\\bgo\\s+(build|run|test)/, ]; (async () => { try { const hookData = await readStdin(); if (hookData.tool_name !== 'Bash') process.exit(0); const cmd = (hookData.tool_input || {}).command || ''; if (!cmd || cmd.length < 5) process.exit(0); for (const re of SKIP_RE) { if (re.test(cmd)) process.exit(0); } let match = false; for (const re of VIEW_RE) { if (re.test(cmd)) { match = true; break; } } if (!match) process.exit(0); const limit = /\\bfind\\s+\\/|journalctl|tree\\s+\\/|\\.dump/.test(cmd) ? 80 : 150; const newCmd = cmd + ' 2>&1 | head -' + limit; process.stdout.write(JSON.stringify({ continue: true, hookSpecificOutput: { hookEventName: 'PreToolUse', updatedInput: { command: newCmd, description: (hookData.tool_input || {}).description }, additionalContext: '[TSE·BASH_LIMITER] 输出已截断至 ' + limit + ' 行。需完整输出请 > file 重定向。' } })); process.exit(0); } catch { process.exit(0); } })(); `; // ─── Hook 3: Model Advisor ──�� const MODEL_ADVISOR_CODE = `#!/usr/bin/env node /** * token-saver-model-advisor.js · TSE Layer 1 · 2026-04-27 * UserPromptSubmit · 分析 prompt 复杂度, 建议模型选择 * 节流: 每会话每复杂度级别仅提醒 1 次 * 行为: fail-open */ 'use strict'; const fs = require('fs'); const path = require('path'); const CLAUDE_ROOT = require('./lib/root.js'); const readStdin = require('./lib/read-stdin.js'); const STATE_DIR = path.join(CLAUDE_ROOT, 'session-state'); const STATE_PATH = path.join(STATE_DIR, 'tse-model-advisor.json'); const SIMPLE = [ /^(查找|搜索|找到?|在哪|哪个文件)/, /^(翻译|translate)\\b/i, /^(格式化|format)\\b/i, /^(解释|explain|what is|what does)\\b/i, /^(列出|list|show)\\b/i, /^(帮我看|看一下|看看)/, /^(改个?名|rename)\\b/i, /^(运行|run|execute)\\s+(test|build|lint)\\b/i, ]; const COMPLEX = [ /(架构|architecture|设计方案|system design)/i, /(全面审计|comprehensive audit|全栈审计)/i, /(从零开始|from scratch|end.to.end)/i, /(重构整个|refactor the entire|重新设计)/i, /(安全审查|security review|红队|red.team)/i, /(性能优化方案|performance optimization plan)/i, /(对比分析|comparative analysis|trade.off)/i, ]; function classify(p) { if (!p || p.length < 3) return null; for (const re of SIMPLE) { if (re.test(p.trim())) return 'simple'; } for (const re of COMPLEX) { if (re.test(p.trim())) return 'complex'; } if (p.trim().length < 25) return 'simple'; return null; } function loadState() { try { return fs.existsSync(STATE_PATH) ? JSON.parse(fs.readFileSync(STATE_PATH, 'utf8')) : {}; } catch { return {}; } } function saveState(s) { try { if (!fs.existsSync(STATE_DIR)) fs.mkdirSync(STATE_DIR, { recursive: true }); const tmp = STATE_PATH + '.tmp.' + process.pid; fs.writeFileSync(tmp, JSON.stringify(s, null, 2), 'utf8'); fs.renameSync(tmp, STATE_PATH); } catch {} } (async () => { try { const hookData = await readStdin(); const prompt = hookData.prompt || ''; const sid = hookData.session_id || 'u'; const level = classify(prompt); if (!level) process.exit(0); const state = loadState(); const ss = state[sid] || { a: {}, ts: Date.now() }; if (ss.a[level]) process.exit(0); ss.a[level] = true; ss.ts = Date.now(); state[sid] = ss; const cutoff = Date.now() - 86400000; for (const k of Object.keys(state)) { if (state[k].ts < cutoff) delete state[k]; } saveState(state); const msg = level === 'simple' ? '[TSE·MODEL_ADVISOR] 简单任务检测。如当前是 Opus, 建议 /model sonnet 或 /model haiku 以节省 5 倍额度。子 Agent 请指定 model: "haiku"��' : '[TSE·MODEL_ADVISOR] 复杂任务检测。Opus 适合规划阶段。建议: 方案确定后切回 Sonnet 执行, 子 Agent 用 Sonnet/Haiku。'; process.stdout.write(JSON.stringify({ continue: true, suppressOutput: true, hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext: msg } })); process.exit(0); } catch { process.exit(0); } })(); `; // ─── 安装逻辑 ─── function writeHook(name, code) { const p = path.join(HOOKS_DIR, name); if (fs.existsSync(p)) { const existing = fs.readFileSync(p, 'utf8'); if (existing.includes('TSE Layer')) { console.log(' [skip] ' + name + ' (already installed)'); return; } const bak = p + '.bak.' + Date.now(); fs.copyFileSync(p, bak); console.log(' [backup] ' + name + ' → ' + path.basename(bak)); } fs.writeFileSync(p, code, 'utf8'); console.log(' [write] ' + name); } function patchSettings() { const raw = fs.readFileSync(SETTINGS_PATH, 'utf8'); const settings = JSON.parse(raw); if (raw.includes('token-saver-read-guard')) { console.log(' [skip] settings.json (TSE hooks already registered)'); return; } // Backup const bak = SETTINGS_PATH + '.bak.' + Date.now(); fs.copyFileSync(SETTINGS_PATH, bak); console.log(' [backup] settings.json → ' + path.basename(bak)); // Add Read guard to PreToolUse if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = []; settings.hooks.PreToolUse.push({ matcher: 'Read', hooks: [{ type: 'command', command: 'node C:/Users/leesu/.claude/hooks/token-saver-read-guard.js', timeout: 2000 }] }); // Add Bash limiter to PreToolUse (separate from existing bash-precheck) settings.hooks.PreToolUse.push({ matcher: 'Bash', hooks: [{ type: 'command', command: 'node C:/Users/leesu/.claude/hooks/token-saver-bash-limiter.js', timeout: 1500 }] }); // Add Model advisor to UserPromptSubmit if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = []; settings.hooks.UserPromptSubmit.push({ hooks: [{ type: 'command', command: 'node C:/Users/leesu/.claude/hooks/token-saver-model-advisor.js', timeout: 1500 }] }); const tmp = SETTINGS_PATH + '.tmp.' + process.pid; fs.writeFileSync(tmp, JSON.stringify(settings, null, 2), 'utf8'); fs.renameSync(tmp, SETTINGS_PATH); console.log(' [patch] settings.json (3 TSE hooks registered)'); } function patchPressureMonitor() { const p = path.join(HOOKS_DIR, 'context-pressure-monitor.js'); if (!fs.existsSync(p)) { console.log(' [skip] context-pressure-monitor.js not found'); return; } const code = fs.readFileSync(p, 'utf8'); if (code.includes('THRESHOLD_COMPACT') || code.includes('TSE_COMPACT')) { console.log(' [skip] context-pressure-monitor.js (already enhanced)'); return; } const bak = p + '.bak.' + Date.now(); fs.copyFileSync(p, bak); console.log(' [backup] context-pressure-monitor.js → ' + path.basename(bak)); // Insert COMPACT threshold between INFO and WARN let patched = code.replace( "const THRESHOLD_INFO = 0.50;", "const THRESHOLD_INFO = 0.50;\nconst THRESHOLD_COMPACT = 0.60; // TSE_COMPACT: auto-compact directive" ); // Enhance levelFor to include COMPACT patched = patched.replace( "if (ratio >= THRESHOLD_WARN) return 'WARN';", "if (ratio >= THRESHOLD_WARN) return 'WARN';\n if (ratio >= THRESHOLD_COMPACT) return 'COMPACT';" ); // Add COMPACT case to buildMessage patched = patched.replace( "case 'INFO':", "case 'COMPACT':\n" + " return head + '\\n[TSE·AUTO_COMPACT] 建议立即执行 /compact 以释放 context 空间。' +\n" + " '\\n推荐 compact 指令: /compact 保留: 当前任务目标、已确定的方案、关键文件路径和行号。' +\n" + " '\\n越早 compact 摘要质量越高 (60% 优于 83% 被动触发)。';\n" + " case 'INFO':" ); fs.writeFileSync(p, patched, 'utf8'); console.log(' [patch] context-pressure-monitor.js (+COMPACT @60%)'); } // ─── Main ─── console.log('\\n=== Token Saver Engine (TSE) v1.0 Installation ===\\n'); console.log('[Step 1] Writing hook files...'); writeHook('token-saver-read-guard.js', READ_GUARD_CODE); writeHook('token-saver-bash-limiter.js', BASH_LIMITER_CODE); writeHook('token-saver-model-advisor.js', MODEL_ADVISOR_CODE); console.log('\\n[Step 2] Enhancing context-pressure-monitor.js...'); patchPressureMonitor(); console.log('\\n[Step 3] Registering hooks in settings.json...'); patchSettings(); console.log('\\n=== TSE v1.0 Installation Complete ==='); console.log('New hooks: 3 (read-guard + bash-limiter + model-advisor)'); console.log('Enhanced: 1 (context-pressure-monitor +COMPACT@60%)'); console.log('\\nRestart Claude Code to activate.\\n');