Context Switch Token Optimizer#

技能描述#

通过关键词相似度、弱关联子串与时间衰减判断「连续 / 渐变漂移压缩 / 硬切换」，并可监控 Token、触发压缩与清理。实现见 context_manager.py、 token_optimizer.py；详细算法见 docs/TOPIC_AND_CONTINUITY.md。

上下文动作（与代码一致）#

动作条件行为load_memory无当前主题且无历史建主题、可选加载 memory/topic 下记忆continuous与上一轮相似度 ≥ similarity_threshold追加历史，不压缩drift_compress相似度 ∈ [ continuity_threshold, similarity_threshold)对话仍连续；压缩与当前弱相关的历史轮（ is_compressed，保留短摘要）switch_context相似度 < continuity_threshold硬切换，换记忆、增 switch_count

相似度计算： calculate_topic_similarity()（关键词 Jaccard 式重叠 × 时间衰减 + 2 字子串/首字弱关联 + continuity_bonus_for_partial，弱关联封顶 drift_similarity_cap）。

持久化状态格式（ memory/context_switch_state.json）#

与 ContextState / TopicSummary 一致，主题历史项包含：

• topic, keywords, timestamp, tokens_used, content_snippet, is_compressed
• 顶层另有： current_topic, memory_context, last_switch_time, switch_count, total_tokens

配置文件（ config.json）#

所有键名与 load_skill_config() 默认值一致；用户 JSON 按 顶层块 与默认 合并（同一块内键覆盖，未写的子键保留默认）。

context_switch#

键名类型默认说明similarity_thresholdnumber0.7≥ 此值判为 continuous``continuity_thresholdnumber0.35< 此值判为硬切换 switch_context``compress_relevance_thresholdnumber0.3drift_compress 时，历史轮与当前相似度低于此则压缩该轮continuity_bonus_for_partialnumber0.3存在弱关联时的相似度加成drift_similarity_capnumber0.65弱关联时相似度上限，便于进入 drift_compress``time_decay_factornumber0.95按小时衰减的底数max_topic_historyint10主题历史条数上限memory_relevance_thresholdnumber0.5记忆文件匹配阈值log_levelstring（不设）可由环境变量 CONTEXT_SWITCH_LOG_LEVEL 写入

token_optimization#

键名类型默认说明**enabled**booltrue为 false 时不自动触发优化（对应环境变量 TOKEN_OPTIMIZER_ENABLED）token_limitint80000Token 预算compression_thresholdint56000压缩参考阈值context_cleanup_thresholdnumber0.8上下文清理参考memory_load_limitint2000记忆加载参考optimization_intervalint300优化间隔（秒，预留）max_history_sizeint100Token 使用记录条数上限

memory_search#

键名类型默认说明max_search_resultsint5最多返回记忆条数keyword_limitint5每轮提取关键词数**search_depth**int2可由环境变量 MEMORY_SEARCH_DEPTH 覆盖（1–3）file_typesstring[]["*.md"]记忆目录 glob

optimization_settings#

键名说明auto_optimization是否自动优化（策略预留）health_score_threshold健康分阈值suggestions_check_interval建议检查间隔（秒）

环境变量（与 apply_environment_overrides() 一致）#

环境变量映射配置键取值与行为**CONTEXT_HISTORY_SIZEcontext_switch.max_topic_history正整数，限制在 1–100MEMORY_SEARCH_DEPTHmemory_search.search_depth正整数，限制在 1–3TOKEN_OPTIMIZER_ENABLEDtoken_optimization.enabled``true/ 1/ yes/ on 为启用； false/ 0/ no/ off 为禁用（禁用后使用率 >70% 也不触发 trigger_optimization）CONTEXT_SWITCH_LOG_LEVEL**context_switch.log_level``DEBUG / INFO / WARNING / ERROR / CRITICAL；设置根 logger 级别

未设置上述环境变量时，行为完全由 config.json 与代码默认决定。

CLI 与入口#

• 主入口： python3 context-switch-token-optimizer.py [--config path] --process|--status|--reset|--test
• 子模块： context_manager.py、 token_optimizer.py（参数见 --help）

---

维护: Hermosa

版本: v1.1

最后更新: 2026-03-17