Release Notes

本页汇总 Hashee 平台 / SDK / Plugin 的重大发布说明。日常 user-visible 小改动见站点根 changelog；SDK 详细版本历史见 SDK 变更日志。

2026-05-08 — Codex Plugin v2.0 (daemon-channel 模型)

Breaking change：Codex Plugin v1.0 hook 模型已 SUPERSEDED。

为什么变

v1.0 描述的 SessionStart / UserPromptSubmit / Stop / additionalContext / --append-system-prompt 等 hook 注入路径与 Plugin Channel Parity Rules（Codex Channel Rule）冲突。这些路径会污染 Agent 的 prompt 上下文 + 难以保证”plugin 不伪造 Agent 输出”。

v2.0 新模型

长驻 Node.js daemon（独立进程，systemd / launchd / pm2 管理）
启动 codex app-server --listen stdio:// 子进程作为真实 Codex 会话
JSON-RPC 通信：用户消息走 turn/start，输出走 stream/tool/approval/file 事件
持久化在 ~/.hashee/<agent_id>/ 下 6 类文件

升级 v1.0 → v2.0

1. 停掉旧 v1.0 hook 调用
2. 安装 v2.0：npm install -g @hasheeai/codex-plugin
3. 在 Hashee app 跟系统 Agent 说"切换 CodexBot 到 webhook" 或 keep websocket
4. 把 token + 密钥放进 env (HASHEE_CODEX_* 前缀)
5. 启动 daemon：hashee-codex-plugin

详见 Codex Plugin v2.0 + Codex Plugin 规范。

2026-04-24 — SDK v0.2.0 首次公开发布

@hasheeai/agent-sdk-ts v0.2.0 上 GitHub Packages（V1 内测期 npm publish 走 GitHub Packages 私有 registry；V2 切回 npm public）。

主要新增（complete list 见 SDK changelog）：

createWebhookDispatcher — 无状态 webhook Agent 调度器
Layer 1-3 E2EE envelope 处理
HMAC-SHA256 webhook 签名验证
createEncryptedSender 严格 aadContext（zero-downgrade）
HasheeAgent 类 + WebSocket transport
Artifact 发送 + 更新
Streaming delta
Group 加密原语（hashee-group-v1.2）

2026-04-23 — Agent 开发者平台 v1.1（owner-approved）

Agent 注册协议由 V2 planning 提升为 V1 权威。关键决策：

Option C 采纳：系统 Agent 编排 UX + 客户端直 API + artifact 表单
拒绝 Option A（user JWT tunneling，违反盲管道）
拒绝 Option B（on-behalf-of header，auth 链改造过大）
配额：默认 50 Agent/用户（后端 env 可配）
client_action 安全模型：whitelist + restricted JSONPath + fields whitelist

详见 Agent 开发者平台规范。

2026-04-23 — Capability Manifest v1（owner-approved）

A2H Capability Manifest v1 协议冻结：

128 KB hard cap（≥64 KB 触发 warning）
服务端单源 diff engine
Tool call / response 复用现有 MsgSubtype（artifact_tool_call / artifact_response）
Sensitivity 3 级权限（low / medium / high）
V1 预置 4 个标准 scope（notification:send / filesystem:read / clipboard:read / location:read）
群聊禁用 tool call（V1 限制；V2 评估 group-scoped tool）

详见 Capability Manifest 规范。

2026-04-23 — Webhook Delivery v1（owner-approved）

Webhook 传输层冻结：

HMAC-SHA256 签名 + ±5 分钟 timestamp 容忍 + 10 分钟 delivery-id 去重
HTTP 响应 deadline 10 秒
重试 7 次 指数退避（1s → 4s → 16s → 60s → 5min → 30min → unreachable）
Payload 1 MB hard cap（owner 拒绝原 10 MB；超过自动走 R2 对象引用）
agents.unreachable_since 状态机 + 7 次失败后 owner 收 security_alert
30 天 delivery log（自动 cron sweep）
bcrypt(cost=10) 哈希 webhook secret（Workers CPU 配额下 Argon2id 不实用）

详见 Webhook 投递规范。

2026-04-14 — E2EE 统一规范 v1.0（10 份历史文档整合）

把 10 份历史 E2EE / 安全 / 数据主权文档整合为唯一真源：

6 层栈定义（Content / Wrap / Sign / Ratchet / X3DH / Grant Ledger）
Wire format 一致：hashee-envelope-v1 (H2H/H2A) + hashee-group-v1.2 (群聊)
AAD 绑定（v1.1 引入 44 字节 AAD 防 CEK 重放）
三条密钥恢复路径
跨平台互操作（iOS / Android / Desktop Electron / Agent）

废弃同时：Pure browser Web App（Desktop 通过 hashee:// privileged scheme 获得 secure context）。

详见 E2EE 规范。

2026-04-22 — iOS E2EE Detox 14 层修复 close-out

iOS E2EE 端到端解密在 Detox 测试中通过 14 层修复后达成 5/5 decryption-accuracy。

技术要点（开发者关注）：

confirmSend 必须持久化 encryptedPayload + selfWrap（SendResult 扩展）
Hermes HKDF：使用 crypto.createHmac 而不用 @noble/hashes（避免 quick-crypto.install race）
react-native 0.79.6 + Metro extraNodeModules 硬 pin 防止 peer-dep 0.79.7 漂移

主要影响：Mobile 端开发者无需关心；Agent 开发者不变。

升级策略与 SemVer 承诺

版本组件	V1 阶段	V2 阶段（Marketplace launch）
`@hasheeai/agent-sdk-ts`	0.x.x（可能 breaking）	1.0.0 起 SemVer 严格遵守
`@hasheeai/protocol`（wire format）	`hashee-envelope-v1.2` 稳定；group v1.2 稳定	任何 wire 变更走 wire version bump + 多版本共存窗口
Plugin（Claude Code / Codex / OpenClaw）	V1.x 内部 breaking 必须升级	V2 起严格 SemVer
REST API 端点	URL 稳定；body schema 可能新增字段	V2 引入 `/v2/` 路径并独立版本化
WebSocket 事件	事件名稳定；payload 字段可能新增	V2 引入 `protocol_version` frame
错误码	稳定（已上的 enum 不会改名）	同

V2 路线预告（subject to change）

V1.1：Layer 4 Ratchet 外部审计 / Ratchet state 持久化 / 多语言 SDK alpha (Python)
V2 Phase 1：Developer Portal / Agent Builder / Agent Hosting (Hashee Cloud) / Python SDK GA
V2 Phase 2：Marketplace / Payment (Stripe Connect) / Data Grant API
V2 Phase 3：Agent 认证 / Featured 集合 / 企业计划
V3：Multi-Agent 编排 / Agent-to-Agent marketplace / Go SDK

详见 Agent 开发者平台规范 §V1/V2 路线。

订阅 release notes

渠道	频率
这一页	重大 release
站点 changelog	日常 user-visible 改动
SDK 变更日志	SDK 每版本
邮件订阅 release@hashee.ai	季度大事件
系统 Agent	重大 breaking change 自动推送给所有 Agent owner