v1.4.0 — 多厂商缓存全字段解析与代理会话级前缀推导

⚡ v1.4.0 核心增强

• 多厂商全字段缓存解析（）：
  • 补齐 Google / Gemini 原生 与 ；
  • 补齐 vLLM / LiteLLM 与 OpenAI 各种嵌套别名。
• 代理会话级智能前缀缓存推导（）：
  • 针对第三方反代（如 CPA）漏传缓存字段的痛点，自动基于会话历史基线计算真实命中数与命中率，彻底杜绝“假 0”。
• 修复 Gateway 响应字典 键缺失缺陷（）：
  • 补齐正常响应返回字典，打通最后一公里数据传输。
• 新增 补丁：
  • 显式 workdir 被删除后自动安全回退，防止执行报 。

Full Changelog: v1.3.9...v1.4.0

v1.3.8: 修复网关层 Cache Read 传输断链，彻底解决缓存命中率固定为 0 问题

🐛 关键修复：补齐网关层 Cache Read Token 传输链路 (Gateway Cache Read Ingestion Fix)

• 修复网关运行态 cache_read_tokens 传输断链：
  • 深度重构 patch_runtime_footer 中的 transform_gateway_run：在官方 gateway/run.py 构造 agent_result 字典时，主动提取 _cache_read_toks = getattr(_agent, "session_cache_read_tokens", 0) or 0 并注入到正常返回与异常返回的两处 agent_result Payload 中。
  • 彻底解决由于上游官方网关未透传缓存字段、导致消费端 agent_result.get("cache_read_tokens") 永远返回 None/0、进而引发页脚缓存命中率持续固定显示 0 (0%) 的根本缺陷。
• 全链路 Token 提取与注入幂等加固：
  • 升级 transform_gateway_run 的注入算法，支持无损识别多版本官方与二次魔改源码，实现安全幂等注入。

v1.3.5 - Runtime Footer Token 计量注入与配置自愈加固

🐛 关键修复 (Bug Fixes)

• Runtime Footer 全量计量注入修复：修复 patch_runtime_footer 在修改 build_footer_line 签名时的条件误判 bug，确保 build_footer_line 完整接收 prompt_tokens、output_tokens、cache_read_tokens，彻底解决 Gateway 运行时因 TypeError 导致 Token 页脚静默吞噬的问题。
• 一键配置自愈增强：ensure_runtime_config 自动初始化 display.final_response_markdown: keep、display.streaming: false 与 telegram.extra.allow_cjk_rich: true，消除格式剥离与流式降级冲突。
• GitHub CDN 防缓存：一键安装脚本管道注入 nocache 时间戳，杜绝 CDN 缓存引起的补丁延迟。

v1.3.4 - Systemd Service Restart Hardening & Non-blocking Hook

🚀 hermes-patches v1.3.4 紧急加固：彻底解决 systemd control process 启动卡死问题

🛡️ 核心修复

• 🔄 彻底根治 systemctl restart 报 control process exited with error code 错误：
  • 非阻塞守护语法：在 10-local-patches.conf 中将 ExecStartPre 升级为 ExecStartPre=-...（容错前缀），即使自愈脚本遇到环境扰动也绝不阻塞 Gateway 主服务正常拉起。
  • 脚本前置同步机制：在执行任何补丁注入与服务重启前，第一时间将最新脚本同步覆盖至 ~/.hermes/scripts/hermes-local-patches.py 并 daemon-reload，彻底消除旧脚本残留导致 ExecStartPre 崩溃卡死的问题。
  • 智能失败重试与诊断：在重启失败时自动执行 systemctl reset-failed 并抓取输出 journalctl 现场日志。

📦 极速安装一行命令

curl -fsSL https://raw.githubusercontent.com/shali10/hermes-patches/main/install.sh | bash

v1.3.3 - Full Patch Matrix Hardening & E2E Runtime Verified

🚀 hermes-patches v1.3.3 全补丁矩阵深度加固与端到端真实验证

🛡️ 核心修复与全面加固

• 🇨🇳 Telegram 菜单与帮助汉化逻辑重构 ()：
  • 重构 telegram_bot_commands 动态汉化机制，彻底消除静态列表重写引发的 NameError: name '_RAW_TELEGRAM_BOT_COMMANDS' is not defined 异常。
  • 完美保留上游全部动态命令门控、插件命令发现与过滤逻辑，同时对全部 99+ 命令实现 100% 地道中文汉化。
• 🛡️ SQLite State DB 注入全面加固 ()：
  • 重写 apply_database_pragmas 注入锚点，确保 PRAGMA busy_timeout = 5000 连接级高并发锁等待 100% 生效。
  • 采用多行容错锚点安全注入 append_message 与 append_messages_batch 的外键自动补齐与自愈逻辑，彻底防止跨会话写入外键崩溃。
• ✂️ Telegram 4096 智能段落切分精准命中 ()：
  • 修复 Python 多行字符串字面量转义问题，采用精确锚点安全覆写，100% 确保长消息优先在自然段落 (\n\n) 边界处平滑切分。
• 🧪 引入全量 8 大补丁端到端运行时断言测试套件：
  • 在 GitHub Actions CI 工作流中加入完整的动态导入、函数调用与字段断言测试矩阵，确保每一项补丁在全新上游代码库中 100% 真实可用。

📦 极速安装一行命令

curl -fsSL https://raw.githubusercontent.com/shali10/hermes-patches/main/install.sh | bash

v1.3.2 - Fix Telegram CJK Pipe Table Native Bypass Signature

🚀 hermes-patches v1.3.2 紧急关键修复

🐛 核心修复

• 📑 彻底修复 Telegram CJK 原生表格放行补丁因注释特征码不匹配被跳过的重大缺陷：
  • 修复了上游 adapter.py 函数注释与旧版 AST 签名不匹配导致 patch_telegram_cjk_rich 被误判为 UNCHANGED 未真正修改磁盘文件的严重 Bug。
  • 改为动态精确覆写 _has_telegram_desktop_cjk_rich_garble_shape 函数体，100% 确保含有中文字符的 Markdown Pipe Table 原生放行渲染，彻底根治中文字符表格被降级为无序圆点列表的问题。

📦 极速安装一行命令

curl -fsSL https://raw.githubusercontent.com/shali10/hermes-patches/main/install.sh | bash

v1.3.1 - Full 99-Command Localization for /help, /commands & Bot Menu

🚀 hermes-patches v1.3.1 更新说明

🌟 核心更新

1. 🇨🇳 全量 99 个命令与 /help、/commands 地道汉化：
   • 彻底解决 Telegram / QQ / Discord / Web 发送 /help 与 /commands 时命令说明仍为英文的痛点。
   • 补齐官方 COMMAND_REGISTRY 全部 99 个斜杠命令（含 Session / Configuration / Tools & Skills / Info 等全部模块）的专业地道中文释义与参数说明。
   • 重构 gateway_help_lines() 与 _build_description()，使输出中的命令功能、参数占位符与 (别名: /...) 标签 100% 中文化。
2. ⚙️ 自动初始化 display.language: zh：
   • 在 --auto-config 流程中自动确保配置 display.language: zh，打通全系统内置多语言响应。

📦 极速安装一行命令

curl -fsSL https://raw.githubusercontent.com/shali10/hermes-patches/main/install.sh | bash

v1.3.0 - Turnkey Zero-Config Init, Auto Gateway Restart & Universal Path Prober

🚀 hermes-patches v1.3.0 重大更新

真正的 Turnkey 零配置开箱即用 + 全自动平滑重启 + 终极自适应寻径引擎！

🌟 核心突破与改进

1. ⚙️ 零配置开箱即用 (Turnkey Zero-Config Init)：安装脚本自动检测并初始化 ~/.hermes/config.yaml，自动开启 runtime_footer.enabled: true 并预注入 Prompt 总量、缓存命中率、输出 Token、耗时与上下文占用 6 大全量指标，彻底告别「安装后因为官方配置没开导致看似没生效」的困扰！
2. 🔄 一键全自动平滑重启 (Auto Gateway Restart)：补丁注入完成后自动探测运行中的 hermes-gateway 服务并执行平滑重启，一行命令全链路闭环，改动瞬间生效！
3. 🔍 终极多维自适应寻径引擎 (Universal Path Prober)：覆盖 6 级深度寻径（环境变量 -> /proc 活跃进程 -> systemd ExecStart -> CLI shebang 解释器 -> 多 Python venv 探测 -> 系统标准路径），100% 精准锁定任何非标部署环境下的 Hermes 源码！
4. 🧹 字节码全量清理与编译 (Bytecode Cache Purge)：安装后自动清除目标目录下所有 __pycache__ 与 stale .pyc，杜绝 Python 执行陈旧缓存。
5. 🛡️ 升级自愈守护增强：systemd 10-local-patches.conf 同时支持 HERMES_PATCH_SOURCE_ROOT 与 HERMES_SOURCE_DIR 双变量，版本升级后自动自愈重应用。

📦 极速安装一行命令

curl -fsSL https://raw.githubusercontent.com/shali10/hermes-patches/main/install.sh | bash

v1.2.0 - Quiet Streaming, Deep Thinking Cleaner & Smart Message Chunker

📝 更新日志 (Changelog)

所有 hermes-patches 的重要更新与演进均记录于此。
本项目遵循 Semantic Versioning (语义化版本 2.0.0) 规范。

---

[v1.2.0] - 2026-08-29

🚀 新增特性 (Added)

• nostream 补丁（流式静默控制与 429 频控护盾）：
  • 支持全局 display.streaming: false 与平台级流式拦截，彻底关闭中间高频 editMessageText 消息编辑。
  • 消除 Telegram 客户端高频跳动、频繁编辑震动与通知打扰。
  • 彻底避免生成长文本时长周期轮询导致的 429 Flood control exceeded 封禁限制。
• clean-think 补丁（全链路深度思考净化）：
  • CLI 端：将终端 show_reasoning 默认策略调整为静默模式，不再弹出大尺寸思维链面板遮挡屏幕。
  • IM / Gateway 端：全面拦截并剥离 <think>, <thought>, <thinking>, <reflection>, <antml:thought>, <inner_monologue> 等变体标签及未闭合草稿块。
• smart-split 补丁（Telegram 4096 消息智能段落切分）：
  • 重构基础平台消息切分器，优先在自然段落边界（\n\n）处切分，次选行边界（\n）。
  • 保持跨块 Markdown 结构完整性，避免在代码块中间生硬截断导致的 can't parse entities 解析错误。
• 🖥️ 交互式中文数字菜单 (Interactive Numbered Menu)：
  • install.sh 升级为全中文可视化数字交互菜单。
  • 默认选项 [1] 全量一键安装：支持直接按回车一键搞定全部 8 个补丁。
  • 支持自由组合多选：输入单数字（如 2）或组合数字（如 2 3 7 / 2,3,7）按需安装。
  • 集成常用快捷动作：[10] Dry-Run 预检分析、[11] 一键无损卸载与回滚、[0] 安全退出。
• ❓ 常见问题排障指南 (FAQ & Troubleshooting)：
  • 官方文档新增专属 FAQ 章节，涵盖 /footer on 页脚激活、Telegram 客户端缓存刷新、Docker 容器内打补丁以及多 Python 虚拟环境路径指定。

🔄 优化与变更 (Changed)

• 全中文地道输出：核心补丁引擎 hermes_patches.py 终端日志全面中文化，引入直观彩色状态图标（🟢 已应用、⚪ 已是最新/无需变更、🟡 待应用、🔴 失败）。
• 智能寻径算法增强：新增基于 which hermes CLI 二进制多级符号链接追溯探测，极大提升非标准路径与虚拟环境下的自动识别成功率。
• 非侵入式配置保障：移除破坏性 YAML 文件整写逻辑，改由代码内部原生默认初始化指标，零配置损坏风险。
• 双语文档与导航：在中英文文档中全量引入标准 HTML 显式跳转锚点与顶部导航栏。
• CI 与测试：更新 GitHub Actions 每日 CI 流程，覆盖全量 8 个补丁注入及 9 个核心文件的 Python 语法编译检测。

---

[v1.1.0] - 2026-08-29

🚀 新增特性 (Added)

• 模块化精细控制：引入 --only 与 --skip CLI 参数，支持用户按需选择注入模块（例如：--only table db）。
• CLI 模块查询：新增 --list-patches 命令，快速列出所有补丁 ID、别名列表与功能说明。
• tirith 补丁（低风险审批免打扰）：自动放行 LOW / INFO 级别的静态安全扫描提示，高危风险正常拦截，提升自动化流畅度。
• 双语官方文档：新增英文完整文档 README_EN.md 与中英文快速导航切换。
• 开源社区规范：添加 GitHub Issue 模板（Bug Report 与 Feature Request）。
• CI 兼容性防护：添加每日定时 GitHub Actions 工作流，自动对 upstream NousResearch/hermes-agent 最新代码执行注入与编译测试。

🛡️ 安全增强 (Security)

• 引入原子编译保护机制：修改代码时先在临时文件进行 py_compile.compile(..., doraise=True) 编译校验，只有语法 100% 正确时才原子置换原文件。
• 物理备份与无损回滚：首次执行自动生成 .bak 文件，支持 bash install.sh --uninstall 瞬间还原。

---

[v1.0.0] - 2026-08-29

🎉 首次发布 (Initial Release)

• footer 补丁（Runtime Footer 全指标计量）：
  • 输出 Prompt 总量、缓存命中数及命中率百分比、输出 Token、执行耗时与上下文占用率。
  • 所有数值引入千分位格式化（12,345），排版工整清晰。
• table 补丁（Telegram CJK 原生 Markdown 表格放行）：
  • 绕过桌面端 CJK 字符乱码检测，100% 放行现代 Telegram 原生 Markdown Pipe Table。
• menu 补丁（Telegram 快捷命令中文本地化）：
  • 将 /start, /new, /reset, /status, /model, /memory, /skills, /help, /restart, /doctor, /footer 等快捷命令描述汉化为地道中文。
• db 补丁（SQLite 生产级外键自愈与高并发争用保护）：
  • 数据库连接注入 PRAGMA busy_timeout = 5000，有效缓解高并发锁表。
  • 自动补齐 session 外键父记录，彻底根治消息写入时的外键缺失中断报错。
• 一键安装与守护脚本：
  • 提供 install.sh 脚本，支持自动寻径 Hermes 安装目录。
  • 配置 systemd ExecStartPre 自动守护钩子，实现 Hermes 源码升级后补丁自动重应用（升级不失效）。