v0.12.4
发布日期:2026-05-27
English readers: please scroll down for the English version below.
用户应该知道的
- Cloud PG / OSS 运行时配置落地第一段:
cloud.postgres与cloud.oss现在是一等配置项,可从运行时 env 解析;公开 Web 上传在 OSS 配好后会写入public-uploads/...并返回oss://bucket/key,/api/public/image与/api/public/file也能代理托管 OSS 对象。 - 远端运行时健康信号更清楚:
/api/meta会暴露cloud_runtime、cloud_postgres、cloud_oss、oss_file_proxy等 capability,启动时也会打印“仍依赖哪些本地存储”的脱敏摘要,避免误以为已经完全云化。 - Scheduler commodity guard 误杀收窄:宽泛市场复盘、跨资产提醒或 XME / OWALERT 这类任务提到原油时,不再整段被替换成原油安全提示;真正以原油为主体的内容仍会保留 guard。
- Feishu 与外部错误诊断更稳:Feishu client / facade 的错误路径补齐了更可读的上下文,工具和外部 HTTP 错误继续做脱敏,减少排障时暴露原始 payload 或敏感字段的风险。
- 事件引擎与运维烟测补强:event-engine digest / poller / HTTP sink 的局部诊断继续收口,并新增 Aliyun、FMP poller、event-engine live integration 的手工 smoke wrapper,便于有凭证的环境做真实联通性验证。
谁应该尽快更新
- 正在把 backend / public Web runtime 切向云端 PG / OSS 的部署者
- 使用公开 Web 上传、公开图片 / 文件代理、desktop remote backend 健康探测的部署
- 依赖 scheduler 市场复盘、跨资产提醒、商品相关 guard 的用户
- 依赖 Feishu 私聊 / 群聊、事件引擎推送或 live integration 运维 smoke 的部署
升级后会有什么变化
- 配好 cloud OSS 后,公开上传会优先写入 OSS;未配置时仍走原来的本地文件 fallback。
cloud.strict_no_local_storage=true会在仍存在本地依赖时阻止启动;在 PG-backed repositories 全部补齐前,应保持默认false。- 宽泛市场类 scheduler 内容更少被 commodity guard 误判为原油播报,但油价主导内容仍会被安全提示接管。
- Feishu 与外部工具失败时的日志更适合排障,同时更少暴露原始敏感响应。
安装与更新
curl | bash用户:重新运行安装脚本即可切到新版本- Homebrew 用户:
brew update && brew upgrade honeclaw
已知注意事项
- 架构 SVG 已随 v0.12.4 刷新:版本卡、recent milestones 与 storage/cloud runtime 说明已更新;核对后 channel bins / pollers / EventKind / agent runners / LLM tools 数量仍分别为 8 / 11 / 13 / 5 / 14。
- Cloud PG / OSS Runtime Migration 仍是
in_progress:sessions、quota、audit、portfolio、cron、notification prefs、生成物和日志等状态仍保留本地 fallback。 - 新增 live smoke wrapper 位于
tests/regression/manual/,依赖外部账号、凭证和网络路径,不属于默认 CI 门禁。
对比范围
- Compare: v0.12.3...v0.12.4
English
Release date: 2026-05-27
What Users Should Know
- First Cloud PG / OSS runtime slice:
cloud.postgresandcloud.ossare now first-class config sections with runtime env fallback. When OSS is configured, public Web uploads are written underpublic-uploads/..., returnoss://bucket/key, and/api/public/imageplus/api/public/filecan proxy managed OSS objects. - Clearer remote-runtime health signals:
/api/metanow reports capabilities such ascloud_runtime,cloud_postgres,cloud_oss, andoss_file_proxy. Startup also logs a redacted summary of remaining local storage dependencies so operators do not mistake this for full cloud ownership yet. - Narrower scheduler commodity guard false positives: broad market reviews, cross-asset alerts, and XME / OWALERT-style jobs can mention oil without having the entire response replaced by the oil safety notice. Truly oil-dominant content is still guarded.
- More robust Feishu and external-error diagnostics: Feishu client / facade failures now carry more useful context, while tool and external HTTP errors continue to redact sensitive payload details.
- Event-engine and ops smoke coverage improved: event-engine digest / poller / HTTP sink diagnostics were tightened, and manual smoke wrappers were added for Aliyun, FMP pollers, and live event-engine integration checks.
Who Should Update Soon
- Operators moving backend / public Web runtime ownership toward cloud PG / OSS
- Deployments using public Web uploads, public image / file proxies, or desktop remote-backend health checks
- Users relying on scheduler market reviews, cross-asset alerts, or commodity-related guards
- Deployments using Feishu direct/group chats, event-engine pushes, or live integration smoke checks
What Will Change After Upgrading
- With cloud OSS configured, public uploads prefer OSS; without it, the previous local-file fallback remains.
cloud.strict_no_local_storage=truenow blocks startup while local dependencies remain; keep the defaultfalseuntil the PG-backed repositories are finished.- Broad market scheduler output is less likely to be misclassified as an oil bulletin, while oil-dominant content remains protected.
- Feishu and external-tool failures are easier to debug with less raw sensitive response data in logs.
Install and Update
curl | bashusers: rerun the install script to move to this version- Homebrew users:
brew update && brew upgrade honeclaw
Known Notes
- The architecture SVG was refreshed for v0.12.4: release card, recent milestones, and storage/cloud runtime wording were updated; verified counts remain 8 channel bins, 11 pollers, 13 EventKind variants, 5 agent runners, and 14 LLM tools.
- Cloud PG / OSS Runtime Migration remains
in_progress: sessions, quota, audit, portfolio, cron, notification prefs, generated artifacts, and logs still keep local fallbacks. - The new live smoke wrappers live under
tests/regression/manual/; they require external accounts, credentials, and network access, so they are not default CI gates.
Compare
- Compare: v0.12.3...v0.12.4