尧图网站建设 
Token Optimizer配置完全参考92个TOKEN_OPTIMIZER_*环境变量与自定义TOML过滤器详解【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer 本文为 Token Optimizer 配置完全参考系统讲解92 个TOKEN_OPTIMIZER_*环境变量外加少量内部测试用变量的默认值与生效方式并详解如何用自定义 TOML 过滤器扩展命令压缩白名单、排除不想压缩的命令——面向新手看完即可完成日常调参。图片说明这是 Token Optimizer 的仪表盘所有TOKEN_OPTIMIZER_HOST、TOKEN_OPTIMIZER_DAEMON_PORT等变量控制的就是这一类本地服务。一、先搞懂配置优先级环境变量怎么生效 ⚙️Token Optimizer 的配置来自两层环境变量~/.claude/token-optimizer/config.json。生效优先级从高到低命令行参数如--context-size只对当次命令生效TOKEN_OPTIMIZER_*环境变量本次运行覆盖 config.jsonconfig.json持久化默认值由measure.py v5 enable|disable等命令写入引擎内置默认值什么都没设时兜底。 记住一条黄金法则临时调参用环境变量长期生效用命令写 config.json不要手工编辑 JSON。完整官方配置表见 configuration.mdxBash 压缩与 TOML 过滤器见 bash-compression.mdx。二、92 个 Token Optimizer 环境变量分类速查2.1 活跃压缩功能开关最常用的一组⭐变量默认值作用TOKEN_OPTIMIZER_BASH_COMPRESS开启设为0禁用 Bash 输出压缩TOKEN_OPTIMIZER_COMMAND_FILTERSruntime-home/token-optimizer/command-filters.toml自定义 TOML 过滤器路径详解见第四节TOKEN_OPTIMIZER_READ_CACHE开启设为0完全禁用读缓存无 delta、无骨架替换TOKEN_OPTIMIZER_READ_CACHE_DELTA开启设为0仅禁用 delta 模式TOKEN_OPTIMIZER_QUALITY_NUDGES开启设为0禁用上下文质量下降提醒TOKEN_OPTIMIZER_LOOP_DETECTION开启设为0禁用重试循环检测TOKEN_OPTIMIZER_FIRST_READ_SHADOW/FIRST_READ_ACTIVE开启控制首次读取骨架的度量 / 实际投放TOKEN_OPTIMIZER_VERBOSITY_MIN_FILL25上下文填充率超过该百分比时触发精简输出提醒2.2 读缓存模式一个变量四种行为TOKEN_OPTIMIZER_READ_CACHE_MODE默认soft_block决定重复读文件时的处理策略模式行为soft_block默认。重复读未变更文件时替换为紧凑结果delta 或结构图始终放行warn放行完整重读但提示文件已读过shadow只统计若替换能省多少不改变模型看到的内容适合验证block直接拒绝冗余重读最激进仅支持读拦截的平台2.3 上下文窗口与质量信号变量默认值作用TOKEN_OPTIMIZER_CONTEXT_SIZE自动检测覆盖假设的上下文窗口大小TOKEN_OPTIMIZER_QUALITY_WINDOW20比率类质量信号的滚动窗口TOKEN_OPTIMIZER_TOOL_CALL_WARN/CRITICAL自动工具调用次数告警/危险阈值TOKEN_OPTIMIZER_RELEVANCE_THRESHOLD0.3检查点被选为连续性候选的最低相关分TOKEN_OPTIMIZER_RELEVANCE_FULL_THRESHOLD0.5输出完整恢复数据块而非一行摘要的分数线TOKEN_OPTIMIZER_DENSITY_MIN_MESSAGES6消息数达到该值前保持决策密度评分中性2.4 检查点与会话连续性防压缩失忆关键项变量默认值作用TOKEN_OPTIMIZER_CHECKPOINT_RETENTION_DAYS7检查点保留天数TOKEN_OPTIMIZER_CHECKPOINT_RETENTION_MAX50参与恢复扫描的检查点上限TOKEN_OPTIMIZER_PROGRESSIVE_CHECKPOINTS开启设为0关闭 20/35/50/65/80% 填充分带的渐进检查点TOKEN_OPTIMIZER_CHECKPOINT_COOLDOWN_SECONDS90两次检查点触发的最小间隔TOKEN_OPTIMIZER_EDIT_BATCH_WRITE_THRESHOLD4触发编辑批量检查点的写入数增量TOKEN_OPTIMIZER_CONTINUITY_MAX_SESSIONS5连续性提示中最多回溯的历史会话数TOKEN_OPTIMIZER_CHECKPOINT_RELEVANCE_THRESHOLD0.25续写时恢复哪个检查点的最低分自动钳制在 0.1–0.9相关评分器变量TOKEN_OPTIMIZER_RELEVANCE_IDF_CAP、TOKEN_OPTIMIZER_RELEVANCE_PATH_TF_WEIGHT等在加载时会硬钳制到安全区间设错只会回落不会破坏行为。2.5 仪表盘与守护进程变量默认值作用TOKEN_OPTIMIZER_HOST127.0.0.1仪表盘服务绑定主机TOKEN_OPTIMIZER_DASHBOARD_HOST127.0.0.1专用于仪表盘的绑定主机局域网访问前可设0.0.0.0TOKEN_OPTIMIZER_DASHBOARD_TIMEOUT30秒打开仪表盘服务的重试总预算TOKEN_OPTIMIZER_DAEMON_PORT按运行时固定覆盖仪表盘守护进程端口多运行时各有固定端口TOKEN_OPTIMIZER_TURN_PRELOAD_MAX40静态仪表盘内嵌的最近会话数上限2.6 数据保留与归档变量默认值作用TOKEN_OPTIMIZER_ARCHIVE_RETENTION_HOURS24工具结果归档保留小时数TOKEN_OPTIMIZER_ARCHIVE_RETENTION_MAX_FILES1000归档文件总数上限先删最旧TOKEN_OPTIMIZER_ARCHIVE_RETENTION_MAX_BYTES100 MiB归档总字节上限TOKEN_OPTIMIZER_QUALITY_CACHE_RETENTION_DAYS7质量缓存快照保留天数0为不限TOKEN_OPTIMIZER_TRENDS_RETENTION_DAYS不限历史数据库行保留天数TOKEN_OPTIMIZER_ARCHIVE_EXEMPT_TOOLS未设追加输出保持内联不归档的 MCP 工具 glob2.7 安装、运行时与平台适配 变量默认值作用TOKEN_OPTIMIZER_RUNTIMEclaude强制指定平台适配器claude/codex/opencode/copilot/hermes/antigravityTOKEN_OPTIMIZER_PYTHON自动探测指定可信的绝对 Python 路径安装脚本依赖它TOKEN_OPTIMIZER_SKIP_VERIFY关闭设为1跳过安装校验不推荐TOKEN_OPTIMIZER_DEBUG关闭向 stderr 输出运行时检测诊断TOKEN_OPTIMIZER_NO_PROC_SCAN关闭跳过进程树扫描兜底检测TOKEN_OPTIMIZER_COPILOT_HOME/CURSOR_HOME/ANTIGRAVITY_HOME等自动各平台 home 目录覆盖使用前会校验TOKEN_OPTIMIZER_COPILOT_USD_PER_CREDIT0.01Copilot 一个 AI credit 的美元价值TOKEN_OPTIMIZER_COPILOT_PREMIUM_RATE0.04每次 premium 请求的美元计价2.8 高级测量与基线调优进阶用户用于验证与大规模部署的 20 余个变量例如TOKEN_OPTIMIZER_AVG_READ_TOKENS默认2500每次避免读取的 token 估算TOKEN_OPTIMIZER_BASELINE_WINDOW_DAYS默认30构建早期基线的历史窗口TOKEN_OPTIMIZER_COLLECT_MAX_PER_RUN默认150单次采集最多解析的会话数TOKEN_OPTIMIZER_ROUTABLE_OPUS_FRACTION默认0.3路由机会计算中视为可路由的 Opus 占比。2.9 内部与测试专用变量请勿设置⚠️TOKEN_OPTIMIZER_SNAPSHOT_DIR、TOKEN_OPTIMIZER_UTF8_REEXEC、TOKEN_OPTIMIZER_DAEMON_PULSE_PROBE、TOKEN_OPTIMIZER_VERSION等十余个名字是子进程哨兵、生成脚本常量或测试桩文档列出仅为覆盖完整不属于用户调参项。三、自定义 TOML 过滤器3 步扩展压缩白名单 内置约 111 条命令覆盖 90% 的啰嗦 CLI 输出想压缩cargo test、ruff check这类新命令或排除某些命令完全不用改代码。加载器实现见 command_filters.py。第 1 步创建文件。默认位置runtime-home/token-optimizer/command-filters.toml也可用TOKEN_OPTIMIZER_COMMAND_FILTERS指向任意路径。第 2 步写规则add加入白名单exclude排除支持 glob# 把只读命令挂到已有的压缩处理器上 [filters.add] my-tests { command cargo test, handler pytest } my-lint { command ruff check, handler lint } # 排除不想被压缩的命令 [filters.exclude] commands [git status, ls -la]第 3 步理解安全闸门。handler必须是内置处理器之一git_status、pytest、lint、ls、logs、build等 18 种见 command_filters.py加载器会拒绝任何含 shell 解释器bash/python/node、提权前缀sudo/su、破坏性写子命令rm/chmod/dd或 shell 元字符;、|、$…的add条目——安全模型不可被用户配置放宽。️ 失败即放行fail-open文件缺失 空配置TOML 写错 跳过过滤器并给一次性 stderr 警告内置压缩照常工作。四、新手最实用的 3 个配置场景 ✅临时关闭 Bash 压缩如 CI 中要原始输出TOKEN_OPTIMIZER_BASH_COMPRESS0 python3 measure.py report长期关闭用measure.py v5 disable bash_compress。先验证读缓存再全量开启TOKEN_OPTIMIZER_READ_CACHE_MODEshadow运行几天看仪表盘统计后再切回默认soft_block。强制指定运行时多平台共存时设TOKEN_OPTIMIZER_RUNTIMEcodex或copilot/cursor/antigravity避免自动探测错乱安装脚本与 hook 桥接均依赖该变量入口在 run.py 与各*_install.py中。五、参考资料 完整配置参考含默认值与优先级configuration.mdxBash 压缩与 TOML 过滤器详解bash-compression.mdx过滤器加载器源码command_filters.pyHook 运行时与预算控制TOKEN_OPTIMIZER_HOOK_BUDGET_MS等hook_runtime.py主脚本与子命令清单measure.py【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Token Optimizer配置完全参考：92个TOKEN_OPTIMIZER_*环境变量与自定义TOML过滤器详解
Token Optimizer配置完全参考92个TOKEN_OPTIMIZER_*环境变量与自定义TOML过滤器详解【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer 本文为 Token Optimizer 配置完全参考系统讲解92 个TOKEN_OPTIMIZER_*环境变量外加少量内部测试用变量的默认值与生效方式并详解如何用自定义 TOML 过滤器扩展命令压缩白名单、排除不想压缩的命令——面向新手看完即可完成日常调参。图片说明这是 Token Optimizer 的仪表盘所有TOKEN_OPTIMIZER_HOST、TOKEN_OPTIMIZER_DAEMON_PORT等变量控制的就是这一类本地服务。一、先搞懂配置优先级环境变量怎么生效 ⚙️Token Optimizer 的配置来自两层环境变量~/.claude/token-optimizer/config.json。生效优先级从高到低命令行参数如--context-size只对当次命令生效TOKEN_OPTIMIZER_*环境变量本次运行覆盖 config.jsonconfig.json持久化默认值由measure.py v5 enable|disable等命令写入引擎内置默认值什么都没设时兜底。 记住一条黄金法则临时调参用环境变量长期生效用命令写 config.json不要手工编辑 JSON。完整官方配置表见 configuration.mdxBash 压缩与 TOML 过滤器见 bash-compression.mdx。二、92 个 Token Optimizer 环境变量分类速查2.1 活跃压缩功能开关最常用的一组⭐变量默认值作用TOKEN_OPTIMIZER_BASH_COMPRESS开启设为0禁用 Bash 输出压缩TOKEN_OPTIMIZER_COMMAND_FILTERSruntime-home/token-optimizer/command-filters.toml自定义 TOML 过滤器路径详解见第四节TOKEN_OPTIMIZER_READ_CACHE开启设为0完全禁用读缓存无 delta、无骨架替换TOKEN_OPTIMIZER_READ_CACHE_DELTA开启设为0仅禁用 delta 模式TOKEN_OPTIMIZER_QUALITY_NUDGES开启设为0禁用上下文质量下降提醒TOKEN_OPTIMIZER_LOOP_DETECTION开启设为0禁用重试循环检测TOKEN_OPTIMIZER_FIRST_READ_SHADOW/FIRST_READ_ACTIVE开启控制首次读取骨架的度量 / 实际投放TOKEN_OPTIMIZER_VERBOSITY_MIN_FILL25上下文填充率超过该百分比时触发精简输出提醒2.2 读缓存模式一个变量四种行为TOKEN_OPTIMIZER_READ_CACHE_MODE默认soft_block决定重复读文件时的处理策略模式行为soft_block默认。重复读未变更文件时替换为紧凑结果delta 或结构图始终放行warn放行完整重读但提示文件已读过shadow只统计若替换能省多少不改变模型看到的内容适合验证block直接拒绝冗余重读最激进仅支持读拦截的平台2.3 上下文窗口与质量信号变量默认值作用TOKEN_OPTIMIZER_CONTEXT_SIZE自动检测覆盖假设的上下文窗口大小TOKEN_OPTIMIZER_QUALITY_WINDOW20比率类质量信号的滚动窗口TOKEN_OPTIMIZER_TOOL_CALL_WARN/CRITICAL自动工具调用次数告警/危险阈值TOKEN_OPTIMIZER_RELEVANCE_THRESHOLD0.3检查点被选为连续性候选的最低相关分TOKEN_OPTIMIZER_RELEVANCE_FULL_THRESHOLD0.5输出完整恢复数据块而非一行摘要的分数线TOKEN_OPTIMIZER_DENSITY_MIN_MESSAGES6消息数达到该值前保持决策密度评分中性2.4 检查点与会话连续性防压缩失忆关键项变量默认值作用TOKEN_OPTIMIZER_CHECKPOINT_RETENTION_DAYS7检查点保留天数TOKEN_OPTIMIZER_CHECKPOINT_RETENTION_MAX50参与恢复扫描的检查点上限TOKEN_OPTIMIZER_PROGRESSIVE_CHECKPOINTS开启设为0关闭 20/35/50/65/80% 填充分带的渐进检查点TOKEN_OPTIMIZER_CHECKPOINT_COOLDOWN_SECONDS90两次检查点触发的最小间隔TOKEN_OPTIMIZER_EDIT_BATCH_WRITE_THRESHOLD4触发编辑批量检查点的写入数增量TOKEN_OPTIMIZER_CONTINUITY_MAX_SESSIONS5连续性提示中最多回溯的历史会话数TOKEN_OPTIMIZER_CHECKPOINT_RELEVANCE_THRESHOLD0.25续写时恢复哪个检查点的最低分自动钳制在 0.1–0.9相关评分器变量TOKEN_OPTIMIZER_RELEVANCE_IDF_CAP、TOKEN_OPTIMIZER_RELEVANCE_PATH_TF_WEIGHT等在加载时会硬钳制到安全区间设错只会回落不会破坏行为。2.5 仪表盘与守护进程变量默认值作用TOKEN_OPTIMIZER_HOST127.0.0.1仪表盘服务绑定主机TOKEN_OPTIMIZER_DASHBOARD_HOST127.0.0.1专用于仪表盘的绑定主机局域网访问前可设0.0.0.0TOKEN_OPTIMIZER_DASHBOARD_TIMEOUT30秒打开仪表盘服务的重试总预算TOKEN_OPTIMIZER_DAEMON_PORT按运行时固定覆盖仪表盘守护进程端口多运行时各有固定端口TOKEN_OPTIMIZER_TURN_PRELOAD_MAX40静态仪表盘内嵌的最近会话数上限2.6 数据保留与归档变量默认值作用TOKEN_OPTIMIZER_ARCHIVE_RETENTION_HOURS24工具结果归档保留小时数TOKEN_OPTIMIZER_ARCHIVE_RETENTION_MAX_FILES1000归档文件总数上限先删最旧TOKEN_OPTIMIZER_ARCHIVE_RETENTION_MAX_BYTES100 MiB归档总字节上限TOKEN_OPTIMIZER_QUALITY_CACHE_RETENTION_DAYS7质量缓存快照保留天数0为不限TOKEN_OPTIMIZER_TRENDS_RETENTION_DAYS不限历史数据库行保留天数TOKEN_OPTIMIZER_ARCHIVE_EXEMPT_TOOLS未设追加输出保持内联不归档的 MCP 工具 glob2.7 安装、运行时与平台适配 变量默认值作用TOKEN_OPTIMIZER_RUNTIMEclaude强制指定平台适配器claude/codex/opencode/copilot/hermes/antigravityTOKEN_OPTIMIZER_PYTHON自动探测指定可信的绝对 Python 路径安装脚本依赖它TOKEN_OPTIMIZER_SKIP_VERIFY关闭设为1跳过安装校验不推荐TOKEN_OPTIMIZER_DEBUG关闭向 stderr 输出运行时检测诊断TOKEN_OPTIMIZER_NO_PROC_SCAN关闭跳过进程树扫描兜底检测TOKEN_OPTIMIZER_COPILOT_HOME/CURSOR_HOME/ANTIGRAVITY_HOME等自动各平台 home 目录覆盖使用前会校验TOKEN_OPTIMIZER_COPILOT_USD_PER_CREDIT0.01Copilot 一个 AI credit 的美元价值TOKEN_OPTIMIZER_COPILOT_PREMIUM_RATE0.04每次 premium 请求的美元计价2.8 高级测量与基线调优进阶用户用于验证与大规模部署的 20 余个变量例如TOKEN_OPTIMIZER_AVG_READ_TOKENS默认2500每次避免读取的 token 估算TOKEN_OPTIMIZER_BASELINE_WINDOW_DAYS默认30构建早期基线的历史窗口TOKEN_OPTIMIZER_COLLECT_MAX_PER_RUN默认150单次采集最多解析的会话数TOKEN_OPTIMIZER_ROUTABLE_OPUS_FRACTION默认0.3路由机会计算中视为可路由的 Opus 占比。2.9 内部与测试专用变量请勿设置⚠️TOKEN_OPTIMIZER_SNAPSHOT_DIR、TOKEN_OPTIMIZER_UTF8_REEXEC、TOKEN_OPTIMIZER_DAEMON_PULSE_PROBE、TOKEN_OPTIMIZER_VERSION等十余个名字是子进程哨兵、生成脚本常量或测试桩文档列出仅为覆盖完整不属于用户调参项。三、自定义 TOML 过滤器3 步扩展压缩白名单 内置约 111 条命令覆盖 90% 的啰嗦 CLI 输出想压缩cargo test、ruff check这类新命令或排除某些命令完全不用改代码。加载器实现见 command_filters.py。第 1 步创建文件。默认位置runtime-home/token-optimizer/command-filters.toml也可用TOKEN_OPTIMIZER_COMMAND_FILTERS指向任意路径。第 2 步写规则add加入白名单exclude排除支持 glob# 把只读命令挂到已有的压缩处理器上 [filters.add] my-tests { command cargo test, handler pytest } my-lint { command ruff check, handler lint } # 排除不想被压缩的命令 [filters.exclude] commands [git status, ls -la]第 3 步理解安全闸门。handler必须是内置处理器之一git_status、pytest、lint、ls、logs、build等 18 种见 command_filters.py加载器会拒绝任何含 shell 解释器bash/python/node、提权前缀sudo/su、破坏性写子命令rm/chmod/dd或 shell 元字符;、|、$…的add条目——安全模型不可被用户配置放宽。️ 失败即放行fail-open文件缺失 空配置TOML 写错 跳过过滤器并给一次性 stderr 警告内置压缩照常工作。四、新手最实用的 3 个配置场景 ✅临时关闭 Bash 压缩如 CI 中要原始输出TOKEN_OPTIMIZER_BASH_COMPRESS0 python3 measure.py report长期关闭用measure.py v5 disable bash_compress。先验证读缓存再全量开启TOKEN_OPTIMIZER_READ_CACHE_MODEshadow运行几天看仪表盘统计后再切回默认soft_block。强制指定运行时多平台共存时设TOKEN_OPTIMIZER_RUNTIMEcodex或copilot/cursor/antigravity避免自动探测错乱安装脚本与 hook 桥接均依赖该变量入口在 run.py 与各*_install.py中。五、参考资料 完整配置参考含默认值与优先级configuration.mdxBash 压缩与 TOML 过滤器详解bash-compression.mdx过滤器加载器源码command_filters.pyHook 运行时与预算控制TOKEN_OPTIMIZER_HOOK_BUDGET_MS等hook_runtime.py主脚本与子命令清单measure.py【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考