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>等变体标签及未闭合草稿块。
- CLI 端:将终端
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 虚拟环境路径指定。
- 官方文档新增专属 FAQ 章节,涵盖
🔄 优化与变更 (Changed)
- 全中文地道输出:核心补丁引擎
hermes_patches.py终端日志全面中文化,引入直观彩色状态图标(🟢 已应用、⚪ 已是最新/无需变更、🟡 待应用、🔴 失败)。 - 智能寻径算法增强:新增基于
which hermesCLI 二进制多级符号链接追溯探测,极大提升非标准路径与虚拟环境下的自动识别成功率。 - 非侵入式配置保障:移除破坏性 YAML 文件整写逻辑,改由代码内部原生默认初始化指标,零配置损坏风险。
- 双语文档与导航:在中英文文档中全量引入标准 HTML 显式跳转锚点与顶部导航栏。
- CI 与测试:更新 GitHub Actions 每日 CI 流程,覆盖全量 8 个补丁注入及 9 个核心文件的 Python 语法编译检测。
[v1.1.0] - 2026-08-29
🚀 新增特性 (Added)
- 模块化精细控制:引入
--only与--skipCLI 参数,支持用户按需选择注入模块(例如:--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 源码升级后补丁自动重应用(升级不失效)。
- 提供