cco-config

CCO Config — 调整优化器的激进程度

CCO 的行为调节项过去是分散在四个模块中的神秘数字。 现在可以在 ~/.claude-context-optimizer/config.json 的 thresholds 下查看这些经过范围验证的配置项。

插件根目录是包含 src/config.js 的目录。所有操作都要 从该目录运行。

解析 $ARGUMENTS：

show（或不带参数）

node ${CLAUDE_PLUGIN_ROOT}/src/config.js

按原样打印表格。* 表示用户设置的值；! 表示存储的值未通过验证，因而被忽略并改用默认值。如果出现任何带 ! 的行，请指出它们——这里的拼写错误会导致某个调节项悄悄地无法按用户预期生效。

get <key>

node ${CLAUDE_PLUGIN_ROOT}/src/config.js get <key>

set <key> <value>

node ${CLAUDE_PLUGIN_ROOT}/src/config.js set <key> <value>

值无效或键未知时，以非零状态退出并显示有效范围——转告用户该消息，不要猜测如何修正。设置成功后，说明它会改变哪项行为（见下表），因为仅凭键名并不容易看出其作用。

reset [key]

node ${CLAUDE_PLUGIN_ROOT}/src/config.js reset <key>    # one key
node ${CLAUDE_PLUGIN_ROOT}/src/config.js reset          # everything back to defaults

重置所有配置会丢弃用户的全部调节设置——除非用户明确提出（“reset all”“вернуть всё по умолчанию”），否则请先确认。

各配置键

键	默认值	作用
rereadWarnAt	3	首次重新读取警告前，对未编辑文件的读取次数
rereadEscalateAt	5	出现“将其放入 CLAUDE.md”升级提示前的读取次数
bigFileLines	500	触发偏移量/限制警告的完整读取行数
mediumFileLines	200	触发柔性提示的完整读取行数
staleTokenRatio	0.10	文件读取后加载的预算占比，达到此比例后读取缓存才会重新允许读取该文件
staleFiles	8	在 200K 上下文中，读取该文件后加载的其他文件数；达到此数后，该文件会被视为已淘汰
staleTimeMs	600000	自上次读取以来经过的毫秒数；超过此时间后，缓存文件会被视为过期
promptMinWords	8	教练会将提示词判定为过于含糊的字数下限
promptIdealMaxWords	200	教练“理想长度”区间的上限
promptTooLongWords	500	超过此字数后，请求会被视为重点埋没
packBudgetPercent	25	/cco-pack 可占用的预算比例上限

调节建议

• 重新读取警告太多？ 将 rereadWarnAt 提高到 4–5。
• 读取缓存阻止了你仍需要的文件？ 降低 staleTimeMs（例如 300000 = 5 分钟）或 staleTokenRatio，让缓存条目更快过期。
• 读取缓存节省得不够？ 提高这两个值——条目会保持新鲜更久，更多重复读取会被阻止。
• 使用 1M 上下文模型并处理较长提示词？ 提高 promptTooLongWords；默认区间针对较短的请求进行了调优。
• 环境变量中的 CCO_STALE_TIME_MS 仍会覆盖 staleTimeMs，可用于进行一次性实验而不更改配置。