@heybox/hb-sdk 0.8.0-alpha.3 → 0.8.0

package/CHANGELOG.md

@@ -1,615 +1,329 @@
 # Changelog
 
-## 0.8.0-alpha.3
+本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。内部集成、实现策略和审查证据不在此维护。
 
-### SDK / Agent Skill
+## 0.8.0 - 2026-09-11
 
-- Agent Skill 合并至 `@heybox/hb-sdk` npm 包，使用 `hb-sdk skill install`（项目）或 `hb-sdk skill install --global`（用户级）安装。
-- 要求 Node.js `>=22.20.0`；安装会校验项目 SDK 版本并维护 `skills-lock.json`，内容被修改时需使用 `--force` 覆盖。
-- `hb-sdk doctor` 改为本地多 Agent 诊断并支持 `--json`；Open 站点仅保留旧版只读兼容快照，不再持续发布。
+> 摘要：完善小程序权限声明、文件能力、分享体验和本地调试工具，并修复移动端网络请求兼容性。
+> 影响级别：常规
+> 开发者动作：升级 `@heybox/hb-sdk` 至 `0.8.0`；使用受控能力时按权限声明文档配置项目权限。
+> 兼容范围：0.8 系列继续兼容未声明权限的存量小程序；现有业务 API 保持兼容，其他已支持平台行为不受影响。
 
-## 0.8.0-alpha.2
+### 必须操作
 
-### SDK
+- 新项目或新增受控能力时，在 `package.json#heybox.permissions` 中声明实际需要的权限，并按平台审核结果使用对应能力。
 
-- 新增公开 `files` 模块，定义私有 sandbox、外部 File/Directory picker、UTF-8/Uint8Array 读写、stat 和有界目录列表。
-- `FileHandle` / `DirectoryHandle` 新增 sandbox-only 删除能力；外部 picker/saveFile 及派生授权不允许删除，目录递归删除必须显式开启。
-- 新增 `network.download()`，将 GET 响应流式写入受控 File/Directory target，并提供 AbortSignal 与 request-scoped progress。
+### 新增能力
 
-### Runtime / Host
+- 新 PC 工坊小程序支持隔离文件空间、单文件或目录选择、`saveFile()` 和公网流式下载；其他平台对尚未开放的文件能力保持明确不可用。
+- `hb-sdk dev` 调试台新增「日志」页签，可实时查看业务 `console` 日志以及 SDK 诊断信息，生产构建不包含调试代码。
+- `hb-sdk create` 使用可直接替换的 Vanilla JavaScript + Vite 模板；`hb-sdk skill install` 和 `hb-sdk doctor` 随 npm 包提供匹配版本的开发辅助能力。
 
-- 扩展零依赖 protocol wire、Host filesystem/picker/transfer contract 和稳定文件/下载错误码；当前 Host 均对 files/download fail closed。
-- Host 文件错误统一重建为 canonical code/message，不向 iframe 透传原始 data；每个 Runtime session 的外部 direct handle 上限为 1024，批量超限原子失败。
-- 下载 transfer 以 `writeResource()` resolve 为不可逆提交点并返回 `committedBytes`；取消只在提交前获胜，未消费 resource 的异步清理不阻塞既定终态。
-- 移除原计划面向旧版小黑盒 PC 的 files/download HostBridge 适配；文件/下载体系保持不变，后续直接按新版 PC Host 架构接入。
-- Runtime request/transport 贯通 `withCredentials`、`redirectPolicy` 与 `maxResponseBytes` 的显式覆盖；Mobile Host buffered request 固定 32 MiB 上限并统一 no-follow，凭据选项不改变平台请求路由。
+### 行为调整
 
-### Docs / Agent Skill
+- 普通 `share.showShareMenu()` 分享统一使用当前小程序的通用落地页；原有 `extra` 页面状态、`share.copyLink()` 和 `share.getExtra()` 能力保持可用。
+- `network` 权限只控制公开网络请求与下载能力，不再联动登录、用户资料和排行榜；权限声明、平台批准和能力支持状态会分别反馈。
+- 移动端请求第三方接口时统一由应用网络层执行，原有 URL、method、headers、body、timeout 和 `withCredentials` 配置保持兼容。
 
-- 将 files/download 的 6 个 canonical callable 纳入 API Reference、兼容性矩阵、LLM 文本与 Agent Skill。
+### 问题修复
 
-## 0.8.0-alpha.1
+- 修复移动端第三方请求受 WebView CORS 限制而失败的问题。
+- 修复本地设备预览尺寸、底部系统导航条和开发控制台输出等调试体验问题。
 
-### Breaking Changes
+### 文档与工具
 
-- `miniappManifest({ platforms })` 要求新构建的本地小程序产物显式声明目标平台；通过 `--from-version` 复用的历史产物允许缺失并保持“平台声明未分类”。
+- 更新权限声明、文件与下载、分享和 API Reference 文档，并提供公开更新日志与 RSS 订阅。
 
-### CLI / Browser Dev Host
+## 0.8.0-alpha.14
 
-- Browser Dev Host 硬切为 Vue 3 小程序调试台，复用小黑盒主题与组件；集中展示调用日志、当前小程序 Storage 快照和问题，并提供匹配手机外框的 iPhone、Pixel 屏幕预设与单一真机二维码入口。
-- 浏览器调试不再被 CLI 登录、项目绑定或远端 Dev Context 阻断；移除调试页权限修改和 Mac 启动入口，依赖账号或远端配置的能力改为按当前上下文明确返回结果或失败。
-- 授权、操作弹窗、Toast、Loading 与振动反馈统一限制在设备预览内；`navigation.reload` 在响应投递后只重建预览 iframe，保留整个调试台会话和诊断状态。
+- 摘要：修复移动端 `network.request()` 请求第三方接口时受 WebView CORS 限制的问题，统一交由 App Host 网络层执行。
+- 影响级别：修复
+- 开发者动作：无需修改调用代码；原有 URL、method、headers、body、timeout 与 `withCredentials` 配置保持兼容。
+- 兼容范围：仅调整移动端 Host 的 buffered request；PC、Web 与 Browser Dev Host 行为不变。
+- 问题修复
+  - 第三方绝对 URL 不再回退到 WebView Fetch，避免浏览器同源策略阻断请求。
+  - `withCredentials: false` 继续关闭 Cookie 与平台身份参数，第三方服务不会收到小黑盒客户端凭据。
 
-### Runtime
+## 0.8.0-alpha.13
 
-- Host 可显式订阅脱敏 capability 完成记录，并通过只读 diagnostics 获取 canonical 小程序作用域的 Storage 快照；不向 iframe 暴露诊断能力或其他小程序数据。
-- 新增 response 成功投递后的脱敏 `bridge_response` trace，供 Host 确定性编排刷新等后续行为，不暴露 request id、payload 或 result。
+- 预发布版本：更新日志 RSS 与页面保持一致，仅展示公开变化分类，并按页面发布日期输出订阅时间。
 
-### SDK
+## 0.8.0-alpha.12
 
-- 公开运行时 API 使用严格 TSDoc 记录加入版本、支持平台、最低客户端版本、稳定性和废弃信息。
+- 摘要：本地调试台新增业务 console 实时捕获与全量「日志」页签，开发期排查不再依赖各端孤立的控制台。
+- 影响级别：常规
+- 开发者动作：无需操作。使用 `hb-sdk dev` 时，调试台「日志」页签会自动显示业务与 SDK/Host 的实时日志。
+- 兼容范围：仅影响本地开发链路与调试台 UI；生产构建零残留，线上小程序行为不变。
+- 新增能力
+  - `hb-sdk dev` 调试台「日志」页签新增业务 `console.log()`、`console.info()`、`console.warn()`、`console.error()` 与 `console.debug()` 的实时捕获，业务代码零改动；SDK/Host 诊断日志同时进入同一页签并以来源区分。
+  - 日志页签升级为控制台式单行流：四级颜色区分、长内容自动换行完整展示、智能跟随滚动（向上翻自动暂停，拉回底部自动恢复）。
 
-### Docs / Agent Skill
+## 0.8.0-alpha.11
 
-- API Reference 按模块和调用路径生成独立方法页、可跳转类型、反向引用、兼容性矩阵及统一搜索数据。
-- 新项目模板显式预填 `android`、`ios`、`ohos` 三个平台；该初始值不是 Runtime fallback 或真机验收证明。
-- canonical Docs 增加独立阻断 CI 门禁，校验 TSDoc、Manifest、API 图、生成物 freshness、链接和桌面/移动端阅读体验。
+- 新 PC 工坊小程序支持隔离 sandbox、单文件/目录选择、`saveFile()` 与公网流式下载；多文件选择和小黑盒域名流式下载暂不支持。
+- Mobile、Web 与 Browser Dev Host 继续对文件和下载能力 fail closed，不提供 Blob 或内存假实现。
 
-### Tooling
+## 0.8.0-alpha.10
 
-- 补齐 Browser Dev Host Vue 类型检查、资源完整性与第三方声明校验。
+- 预发布版本：新增 `package.json#heybox.permissions` 权限声明、运行时门禁和逐 API 权限文档；0.8 系列兼容未声明的存量小程序，0.9.0 起全面强制声明。
+- `network` 仅控制公开 network 模块且仍需平台批准，不再联动登录、用户信息和排行榜；权限失败会区分未声明、未批准与 Host 不支持。
+- 浏览器和手机调试保留完整权限快照，手机调试仍禁止使用官方域名网络配置。
 
-## 0.7.6-alpha.0
+## 0.8.0-alpha.9
 
-### Runtime
+- 预发布版本：增加公开更新日志、RSS 订阅和 CLI 更新链接，并统一 API Reference 地址。
 
-- 修复完整文档返回合法页面后误报 `UNEXPECTED_DOCUMENT_LOAD`；Host 发起 history traversal 时在遍历前隐藏 iframe，并在同一 2 秒截止时间内支持晚到 SDK 重发 probe。
-- 修复 v2 bridge ready 早于首个 iframe load 时吞掉真实导航的问题，并保持普通 heartbeat、hide/show 与终态清理语义。
-- 锁定 v2 handshake 后的 envelope 版本，继续校验精确 origin、nonce、SDK 版本和当前 Mini-program/version 路径。
+## 0.8.0-alpha.8
 
-### Tooling
+- 预发布版本：完善受控文件能力的公开类型与兼容性检查。
 
-- Android、iOS 与 OHOS Host 支持按弹层、iframe history、关闭 Mini-program 的顺序返回；Android 保留 `only_capture=1`。
-- 修复结构化协议失败、关闭与卸载竞态、动态 Playwright 端口，并为用户小程序 Host 增加阻塞双浏览器回归。
+## 0.8.0-alpha.7
 
-## 0.7.5
+- 预发布版本：改进本地开发工具的兼容性。
 
-### SDK
+## 0.8.0-alpha.6
 
-- 修复分享编码的旧浏览器兼容 (@heybox/hb-sdk).
-- 增加渐进式本地调试双栈 (@heybox/hb-sdk).
-- 支持分享扩展数据与链接复制 (@heybox/hb-sdk).
-- 恢复无网络用户全量 scope (hb-sdk).
-- 修复小程序宿主存储对象读取.
+- 预发布版本：改进公开文档和开发工具。
 
-### Runtime
+## 0.8.0-alpha.5
 
-- 本地读取无网络用户身份 (@heybox/hb-sdk-runtime).
-- 补齐授权弹窗展示资料 (@heybox/hb-sdk-runtime).
-- 兼容旧版 iOS 用户手势判断 (@heybox/hb-sdk-runtime).
-- 完成 Runtime Host 分层硬切 (@heybox/hb-sdk-runtime).
+- 预发布版本：完善文件选择、保存和下载能力的开发者体验。
 
-### Tooling
+## 0.8.0-alpha.4
 
-- 发布 0.7.4 正式版 (@heybox/hb-sdk).
-- 发布 0.7.3 正式版 (@heybox/hb-sdk).
+- 预发布版本：完善受控文件能力的公开契约。
 
-## 0.7.5-alpha.0
+## 0.8.0-alpha.3
 
-### SDK / Runtime
+- 预发布版本：修复文件能力的兼容性问题。
 
-- 将 `@msgpack/msgpack` 精确锁定到 `2.8.0`，保持分享 `extra` 编码兼容，同时避免用户小程序 Host 产物引入旧版浏览器不支持的 BigInt 能力。
+## 0.8.0-alpha.2
 
-### Tooling
+- 预发布版本：新增受控文件与下载能力。
 
-- SDK release family 变化时增加用户小程序详情 Host 的无副作用生产构建，提前拦截最终浏览器产物兼容性回归。
+## 0.8.0-alpha.1
 
-## 0.7.4
+- 预发布版本：改进诊断信息和错误处理。
 
-### Breaking Changes
+## 0.7.6-alpha.0
 
-- Runtime 硬切到 `ports` + Capability Module 架构：移除 `platformAdapter`、Heybox Runtime factory 和独立 Mock Runtime，Host 集成改用 `@heybox/hb-sdk-runtime` 的 `createMiniProgramRuntime()`、`host-contract` 与 `web-host` 入口。
-- 新增零依赖 `@heybox/hb-sdk-protocol` 作为 wire contract owner；`@heybox/hb-sdk/protocol` 仅保留兼容 re-export，Runtime 网络 I/O 统一经过 `HostNetworkPort`。
-- 小程序业务 API（`auth`、`user`、`share`、`network` 等）公开契约保持不变。
+- 预发布版本：改进连接可靠性。
 
-### SDK
+## 0.7.5
 
-- `share.showShareMenu()` 支持携带 JSON-compatible `extra`；新增 `share.copyLink()` 复制并返回相同格式的通用分享链接，链接启动后可通过同步 `share.getExtra()` 恢复页面状态。
-- 无网络模式下，`user.getInfo()` 保持隐式授予 `identity` 与 `profile` 全量 scope。
-- Browser Dev Host 未配置外部 one-time code / PKCE 服务时明确禁用登录入口，避免把 CLI 登录态或 credential 暴露给调试页面。
+- 未发布的稳定版本候选，不进入公开文档投影。
 
-### CLI
+## 0.7.5-alpha.0
 
-- Browser Dev Host 增加私有双栈连接，并保留现有 HTTP/SSE fallback；连接不可用时仍可按原调试流程工作。
-- Mobile 二维码统一使用 `open_inapp` 与 `heybox://` `openWindow` 包装的局域网短链接；短链返回跳转页，打开完整 `heybox-mini-dev://sandbox` 协议后延迟调用 `closeWindow` 关闭中间页。移除 `--raw-protocol` 与 `--runtime-url` 参数。
-- `hb-sdk dev` 不再支持匿名调试；启动 Browser、Mac 或 Mobile 调试前必须完成 CLI 登录并绑定小程序，且远端 Dev Context 必须可用。
-- Browser Mock 使用 Node 中的 `hb-sdk login` 会话代发 Host `heybox-session` 请求，调试页改为简单授权弹窗，凭证不下发到浏览器。
-- Browser Dev Host 的 `network.request` 代理允许办公网、Tailscale 与 Clash fake-ip 解析到的本机/局域网地址；仍拒绝 metadata、NAT64 和跨 origin redirect。
-- Mobile 调试短链使用 LAN HTTP，只应在受信局域网内使用。
-- PC/Mac 与移动端的原生启动、账号、网络、存储和权限契约保持不变，本版本不要求更新原生客户端。
+- 预发布版本：改进旧版浏览器兼容性和构建检查。
 
-### Runtime
+## 0.7.4 - 2026-09-02
 
-- 修复首次授权弹窗仅显示占位信息的问题；展示小程序名称和图标，并在申请 `profile` 时预览当前账号昵称和头像，资料读取失败继续使用中性占位。
-- 展示资料读取增加独立超时与取消边界；账号切换、撤销或 Runtime 终止会立即取消当前确认界面。
-- Mobile/PC Host 启动配置复用已可信解析的小程序资料，回退请求携带 canonical version，避免预览或开发实例展示线上版本资料。
-- 兼容缺少 User Activation API 的旧版 iOS WKWebView；旧版环境回退到父文档捕获的近期 iframe 输入与焦点组合判定，环境读取失败一律拒绝。
-- 修复 Mobile storage 对象读取、PC Host 重试与公开网络能力声明，并保证 terminal abort 后截图 chrome cleanup 可跨独立发布入口恢复。
+> 摘要：新增可恢复页面状态的分享能力，并改进登录调试、移动端调试与多端兼容性。
+> 影响级别：常规
+> 开发者动作：使用本地调试前请完成 CLI 登录并绑定小程序；无需修改现有小程序业务 API。
+> 兼容范围：现有小程序业务 API 保持兼容；原生客户端无需因本版本升级。
 
-### Tooling
+### 新增能力
 
-- Protocol、Runtime 与 SDK 改为版本锁步的 release family，固定按 Protocol、Runtime、SDK candidate 发布并最后提升 SDK dist-tag；Runtime 与 SDK 发布产物精确锁定同版本 Protocol。
+- `share.showShareMenu()` 支持携带 JSON-compatible `extra`。
+- 新增 `share.copyLink()`，用于复制包含同类 `extra` 的分享链接。
+- 新增同步 `share.getExtra()`，用于从分享链接恢复页面状态。
 
-## 0.7.4-alpha.6
+### 行为调整
 
-### SDK / CLI
+- `hb-sdk dev` 启动浏览器、Mac 或移动端调试前，需要先完成 CLI 登录并绑定小程序。
+- 移动端调试链接仅适合在受信任的局域网内使用。
 
-- Browser Dev Host 增加私有双栈连接，并继续保留现有 HTTP/SSE fallback；连接不可用时仍可按原调试流程工作。
-- Mobile 二维码统一使用 `open_inapp` 与 `heybox://` `openWindow` 包装的局域网短链接；短链返回跳转页，打开完整 `heybox-mini-dev://sandbox` 协议后延迟调用 `closeWindow` 关闭中间页。移除不再需要的 `--raw-protocol` 与 `--runtime-url` 参数。
-- `hb-sdk dev` 不再支持匿名调试；启动 Browser、Mac 或 Mobile 调试前必须完成 CLI 登录并绑定小程序，且远端 Dev Context 必须可用。
-- PC/Mac 与移动端的原生启动、账号、网络、存储和权限契约保持不变，本版本不要求更新原生客户端。
-- Mobile 调试短链使用 LAN HTTP，只应在受信局域网内使用；不要在公共或不受信网络中暴露调试服务。
-- Browser Dev Host 的 `network.request` 代理允许办公网、Tailscale 与 Clash fake-ip 解析到的本机/局域网地址；仍拒绝 metadata、NAT64 和跨 origin redirect。
-- Browser Mock 使用 Node 中的 `hb-sdk login` 会话代发 Host `heybox-session` 请求，调试页去掉 Bridge/User 状态和登录按钮，改为简单授权弹窗。凭证不下发到浏览器。
+### 问题修复
 
-## 0.7.4-alpha.5
+- 修复首次授权确认信息不完整，以及部分旧版 iOS 环境无法完成授权操作的问题。
+- 修复移动端存储对象读取和部分跨端重试场景中的兼容性问题。
 
-### Share extra
+## 0.7.4-alpha.6
 
-- `share.showShareMenu()` 支持携带 JSON-compatible `extra`，新增 `share.copyLink()` 复制并返回相同格式的通用分享链接；链接启动后可通过同步 `share.getExtra()` 恢复页面状态。
+- 预发布版本：验证登录调试与移动端调试流程。
 
-## 0.7.4-alpha.4
-
-### SDK
+## 0.7.4-alpha.5
 
-- 同步 `auth.login()` 授权弹窗展示说明与 Agent Skill 引用。
+- 预发布版本：验证分享状态恢复能力。
 
-### Runtime
+## 0.7.4-alpha.4
 
-- 修复首次授权弹窗仅显示占位信息的问题；展示小程序名称和图标，并在申请 `profile` 时预览当前账号昵称和头像，资料读取失败继续使用中性占位。
-- 展示资料读取增加独立超时与取消边界，避免可选请求阻塞授权队列；账号切换、撤销或 Runtime 终止会立即取消当前确认界面。
-- Mobile/PC Host 启动配置复用已可信解析的小程序资料，回退请求携带 canonical version，避免预览或开发实例展示线上版本资料。
-- 将 hb-sdk release family 单测接入 `build_changed_packages` MR 门禁。
+- 预发布版本：改进授权确认信息。
 
 ## 0.7.4-alpha.3
 
-### Runtime
-
-- 兼容缺少 User Activation API 的旧版 iOS WKWebView；支持环境继续使用标准用户激活状态，旧版环境回退到父文档捕获的近期 iframe 输入与焦点组合判定。旧环境的手势门禁强度低于标准环境，环境读取失败一律拒绝。
+- 预发布版本：改进旧版 iOS 授权兼容性。
 
 ## 0.7.4-alpha.1
 
-### Breaking / Host Runtime
-
-- Runtime 已硬切到 `ports` + Capability Module 架构：移除 `platformAdapter`、Heybox Runtime factory 和独立 Mock Runtime。Host 集成改用 `@heybox/hb-sdk-runtime` 的 `createMiniProgramRuntime()`、`host-contract` 与 `web-host` 入口。
-- 新增零依赖 `@heybox/hb-sdk-protocol` 作为 wire contract owner；`@heybox/hb-sdk/protocol` 仅保留兼容 re-export。Runtime 内部不再提供独立 `runtime-request`/Transport facade，所有 Runtime 网络 I/O 经过 `HostNetworkPort`。
-- 这是 Host/Runtime 集成的 breaking change；小程序业务 API（`auth`、`user`、`share`、`network` 等）保持公开契约，DOM/network helper 与旧 mock-host 仅允许按迁移文档清理。
-- 同步记录 network security hardening（敏感 header、受保护 endpoint 和显式 credential realm）与 typed-void result correction（void method 统一返回 `undefined`；排行榜删除仍返回 `{ deleted }`）。
-
-### SDK
-
-- 统一服务端密钥名称并补充接入文档 (@heybox-spa/open).
-- Browser Dev Host 未配置外部 one-time code / PKCE 服务时明确禁用登录入口，避免把 CLI 登录态或 credential 暴露给调试页面。
-
-### Runtime
+- 预发布版本：验证业务 API 兼容性和多端问题修复。
 
-- 完成 Runtime Host 分层硬切 (@heybox/hb-sdk-runtime).
-- 修复 Mobile storage 对象读取、PC Host 重试与公开网络能力声明，并保证 terminal abort 后截图 chrome cleanup 可跨独立发布入口恢复。
-
-### Release
-
-- Protocol、Runtime 与 SDK 改为版本锁步的 release family，固定按 Protocol、Runtime、SDK candidate 发布并最后提升 SDK dist-tag；支持无副作用 dry-run、失败续跑和显式 dist-tag rollback。
-- Runtime 与 SDK 发布产物精确锁定同版本 Protocol，避免后续 Protocol patch 改变已发布版本的安装图。
-
-### SDK / Runtime
+## 0.7.4-alpha.0
 
-- 保留无网络模式 `user.getInfo()` 对 `identity` 与 `profile` 的隐式 full-scope 授权，并迁移到新的 Protocol/Capability owner。
+- 预发布版本：验证无网络模式用户信息兼容性。
 
 ## 0.7.3
 
-### SDK
-
-- 无网络模式下，`user.getInfo()` 恢复隐式授予 `identity` 与 `profile` 全量 scope，并返回隔离身份、昵称和头像。
-- 修复 Host 读取小程序存储对象时返回结果异常的问题。
-
-## 0.7.4-alpha.0
-
-### SDK / Runtime
-
-- 修复无网络模式用户 scope 退化：`user.getInfo()` 重新隐式授予 `identity` 与 `profile`，静默返回隔离 `app_user_id`、昵称和头像；资料读取失败时保留身份结果，并拒绝账号切换或撤销后的旧上下文结果。
-- 公开 canonical 用户信息 scope 目录，并让协议类型、Runtime、Browser Mock 与 Host presentation 共享同一 scope owner。
+- 修复无网络模式用户信息读取和小程序存储对象读取问题。
 
 ## 0.7.3-alpha.2
 
-### SDK
-
-- 对齐无网络用户全量 scope 契约，并公开 canonical 用户信息 scope 目录。
+- 预发布版本：验证用户信息 scope 兼容性。
 
 ## 0.7.3-alpha.1
 
-### Runtime
-
-- 允许 `@heybox/hb-sdk-runtime` 与 `@heybox/hb-sdk` 独立演进版本。
+- 预发布版本：发布流程验证，无小程序业务 API 变化。
 
 ## 0.7.2
 
-### SDK / Runtime
-
-- 移除 `user.getLocalIdentity()`；未开通网络权限的小程序改用 `user.getInfo()` 静默获取隔离身份和公开资料，不再展示身份授权弹窗。
-- 未开通网络权限且用户已登录时，`user.getInfo()` 会静默建立或读取当前小程序隔离身份，并在每次成功调用后广播 `identity: granted` 与 `profile: granted`；撤销授权后再次调用会建立新的隔离身份并恢复隐式授权。
-- Runtime 不再兼容缺少 canonical `miniProgramId` 的无参 `getUserInfo()` adapter 路径；身份缺失时 `user.getInfo()` 返回 `INVALID_STATE`。
+- 调整无网络模式的用户信息获取方式；开发者统一使用 `user.getInfo()`。
 
 ## 0.7.1
 
-### Docs / Agent Skill
-
-- 完善登录身份文档与自动握手接入 (@heybox/hb-sdk).
+- 完善登录身份文档与接入说明。
 
 ## 0.7.0
 
-- No user-facing hb-sdk package changes were detected from Conventional Commits.
+- 发布用户身份与握手能力兼容更新。
 
 ## 0.7.0-alpha.9
 
-### SDK
-
-- 移除旧的公开 readiness 方法；能力调用继续自动等待握手，并新增 `getHandshakeState()` 与 `onHandshakeStateChange()`，供业务查询、立即接收并订阅 `connecting | ready | failed` 持久状态。`ready` 生命周期事件仅保留为不可重放的边沿通知。
-
-### Runtime
-
-- 修复授权能力的可信手势归属：Runtime 与浏览器 Mock 复用同一套请求级判定，并按已验证的当前 bridge 请求生成手势快照，避免异步等待、规则漂移或其他窗口操作误用用户手势。
+- 预发布版本：新增 `getHandshakeState()` 与 `onHandshakeStateChange()`。
 
 ## 0.7.0-alpha.3
 
-### SDK
-
-- 收紧生产开发地址确认边界.
-- 统一小程序宿主运行时安全策略.
-
-### Runtime
-
-- 导出 URL 判定工具并接线截图 chrome 隐藏 (@heybox/hb-sdk-runtime).
-- 收口用户授权编排到 Runtime adapter (@heybox/hb-sdk-runtime).
-- 切断 legacy 依赖并收口 Host Runtime 边界 (@heybox/hb-sdk-runtime).
-- 收口生产启动解析与请求装配 (@heybox/hb-sdk-runtime).
-- 补强生产启动配置矩阵 (@heybox/hb-sdk-runtime).
-- 统一生产入口到 Core Runtime (@heybox/hb-sdk-runtime).
-- 增加 Runtime-first 生产 Host 入口 (@heybox/hb-sdk-runtime).
-- 严格校验平台适配器输入 (@heybox/hb-sdk-runtime).
-- 移除能力目录重复枚举 (@heybox/hb-sdk-runtime).
-- 统一 Host 核心状态机与协议实现 (@heybox/hb-sdk-runtime).
-- 完善生产启动矩阵契约 (@heybox/hb-sdk-runtime).
-- 补充 Host URL 脱敏契约 (@heybox/hb-sdk-runtime).
-- 补强 Host 迁移安全契约 (@heybox/hb-sdk-runtime).
-- 固化生产 Host 迁移契约 (@heybox/hb-sdk-runtime).
+- 预发布版本：改进生产环境兼容性。
 
 ## 0.7.0-alpha.2
 
-### CLI
-
-- `hb-sdk dev` 绑定远端小程序后签发并轮换 local_dev 启动票，把独立的 `preview_token` 写入扫码 URL，供 Host 兑换 unpublished 公开详情。
-
-### Runtime
-
-- 允许的 `mini_url` 调试入口会绑定 Host 上的 `mini_program_id`；公开详情对 unpublished 失败时也不丢这个身份。
+- 预发布版本：改进真机调试入口。
 
 ## 0.7.0-alpha.1
 
-### Docs / Agent Skill
-
-- 开发者服务端改为调用 `GET /user_miniprogram/openapi/v1/user` 读取当前用户，不再使用已下线的 `/user/identity` 与 `/user/profile`。
-
-### Runtime
-
-- 公开详情关网时的合法空权限快照视为未开通 `network.request`，允许本地身份读取与撤销授权。
+- 预发布版本：更新开发者服务端用户信息接口说明，并新增 `user.revokeAuthorization()` 供用户撤销当前小程序授权。
 
 ## 0.7.0-alpha.0
 
-### Release
-
-- 硬切小程序隐私用户身份 v2 契约，并保留 v1 bridge 握手兼容。
-- 排行榜记录的公开用户标识从 `userId` 硬切为按小程序隔离的 `appUserId`。
-
-### SDK
-
-- 已开通网络权限的小程序统一通过 `auth.login({ scopes? })` 获取 5 分钟短期授权码；identity 隐式强制包含，返回值不再携带用户、资料或 `appUserId`。
-- 未开通网络权限的小程序通过 `user.getLocalIdentity()` 读取当前小程序内隔离的 `appUserId`，不能获取授权码或调用 OpenAPI。
-- 新增 `user.revokeAuthorization()`，在两种网络模式下由可信用户操作撤销当前账号对当前小程序的授权。
-- 已开通网络权限时，Host current-user 资料与平台账号读取统一提示 `SERVER_API_REQUIRED`，由开发者服务端通过 OpenAPI 获取。
-
-### Security
-
-- 授权码只能交给开发者服务端换取 token；小程序页面不得持有服务端应用凭据，`network.request` 也不能访问平台保留的 runtime auth 与 OpenAPI 内部路径。
-- 需要授权 UI 且缺少可信用户手势时返回 `USER_GESTURE_REQUIRED`；用户取消或关闭时返回 `AUTHORIZATION_CANCELLED`，已授权场景可静默签发新 code。
-
-### Docs / Agent Skill
-
-- README、用户身份 Guide、快速开始、登录门禁、错误处理、生命周期、CLI 与排行榜文档同步新身份边界，并移除旧用户授权 API 指引。
+- 预发布版本：更新用户身份授权流程与排行榜用户标识。
 
 ## 0.6.9
 
-### SDK
-
-- `@heybox/hb-sdk/miniapp-publish` 提供跨 CLI 和开放平台复用的整包 framing、严格路径校验与上传 session 文件映射工具。
-
-### Build and CLI
-
-- `hb-sdk remote deploy` 改为按整包签名创建或恢复服务端上传会话；同一构建仅上传服务端尚未确认的文件，不再维护本地上传会话缓存。
-- 上传产物使用 session 隔离目录，同 key 重传可安全覆盖；上传回调按批次确认，重新执行 deploy 可依据服务端回执恢复上传。
-- 同一设备的普通 deploy 按 API 环境、小程序和版本使用本地文件锁减少重复上传；锁目录不可用时降级为无锁执行，不影响服务端上传会话的正确性。
-- CLI 不再自行拼接版本目录 key，当前小程序产物上传只使用服务端上传 session 返回的文件映射。
-- 上传协议 hard cut 到 `0.6.8`；`0.6.7` 及更早 CLI 不再支持部署小程序构建产物，需升级后使用上传 session。
+- 改进远端部署的断点恢复、重复执行与并发保护能力。
 
 ## 0.6.8
 
-### SDK
-
-- `network.request` 增加脱敏诊断日志和更完整的错误上下文，覆盖 HTTP 非 2xx、无效响应及 bridge/runtime 错误；业务应继续通过错误类型与结构化字段判断失败。
-- `network.request` 在 SDK、Mock Host 和 Mock 网络代理中统一拒绝 `multipart/form-data`，并提示改用 form-urlencoded、JSON 或专用上传能力。
-
-### Build and CLI
-
-- `hb-sdk dev` 与 `hb-sdk remote deploy` 在远端已启用 `network.request` 且 `useOfficialDomain=true` 时跳过平台 CSP；普通 build、匿名或异常权限快照继续 fail closed 注入。
-
-### Runtime
-
-- Runtime 为 `network.request` 参数校验、adapter 失败与非 2xx 响应增加脱敏诊断，并同步拒绝 multipart 请求；非 2xx 响应继续保持 bridge success 语义。
-- Runtime 默认分享链接保留当前 Host `h_src`，并在小程序加载成功时上报 `h_src` 与 `h_src_parent`，不改变 SDK 公共 API。
-
-### Docs / Agent Skill
-
-- 精简外部开发者 README 并拆分详细参考内容；npm 包显式包含 README 与共同 Changelog。
-- 同步公开 Agent Skill references、SDK compatibility、版本元数据与 integrity 至 0.6.8。
+- 改进 `network.request` 错误诊断，并明确不支持 `multipart/form-data`。
 
 ## 0.6.8-alpha.4
 
-### Build and CLI
-
-- 恢复远端官方域名网络权限项目的 CSP 兼容行为：`hb-sdk dev` 与 `hb-sdk remote deploy` 在 `network.request.status=enabled` 且 `useOfficialDomain=true` 时跳过平台 CSP，其他场景继续 fail closed 注入。
+- 预发布版本：验证远端官方域名网络权限兼容性。
 
 ## 0.6.8-alpha.3
 
-### SDK
-
-- 用户身份 API 收敛为 `auth.requireHeyboxAppLogin()`、`user.getInfo()` 与 `user.authorize()`；登录不再返回资料，身份使用按小程序隔离的 `app_user_id`，资料按授权 scope 披露。
-- Vue 3 模板、调试示例与公开文档同步使用 v2 登录和资料授权流程。
-
-### Runtime
-
-- Host 集成改用稳定的用户身份隔离接口，并由 Runtime 构造授权结果，避免转发后端额外字段。
-- `user.authorize` 对畸形 payload 稳定返回 `INVALID_PARAMS`；浏览器 Mock 使用 `heybox_app_login_change` 与 `user_info_authorization_change` 事件，并保持授权事件不携带身份资料。
-
-### Docs / Agent Skill
-
-- 同步 README、Guide、Recipe、API Reference 与 Agent Skill，移除已删除的用户 API 指引。
+- 预发布版本：验证用户身份 API 调整。
 
 ## 0.6.8-alpha.2
 
-### Docs / Agent Skill
-
-- 同步 Agent skill 元数据与 integrity 至 package 版本 0.6.8-alpha.2 (@heybox/hb-sdk).
+- 预发布版本：同步公开开发资料。
 
 ## 0.6.8-alpha.0
 
-### Docs / Agent Skill
-
-- 精简外部开发者 README，拆分详细参考内容 (@heybox/hb-sdk).
-- npm 包显式包含 README 与共同 Changelog，发布检查会阻止文档遗漏 (@heybox/hb-sdk).
+- 预发布版本：精简公开文档并完善 npm 包内容。
 
 ## 0.6.7
 
-### SDK
-
-- Improve CLI diagnostics (hb-sdk).
+- 改进 CLI 诊断信息。
 
 ## 0.6.7-alpha.2
 
-### SDK
-
-- 放宽官方静态资源 CSP，保留网络出口限制 (@heybox/hb-sdk).
-
-### Build and CLI
-
-- `miniappManifest()` 在 build 和 dev 中始终注入平台 CSP；官方 HTTPS 域名可用于脚本、样式、图片、字体和媒体资源，浏览器原生网络出口仍保持限制。
+- 预发布版本：验证静态资源加载兼容性。
 
 ## 0.6.7-alpha.1
 
-### Runtime
-
-- 合并排行榜重复读请求，增加短期缓存 (@heybox/hb-sdk-runtime).
+- 预发布版本：改进排行榜重复读取性能。
 
 ## 0.6.7-alpha.0
 
-### Runtime
-
-- 将截图来源身份绑定到启动详情返回的小程序 ID，避免信任未经绑定的宿主 URL 参数 (@heybox/hb-sdk-runtime)。
-- 自定义 `resolveLaunchUrl` 可通过 `helpers.bindCanonicalIdentity` 回填可信小程序身份，避免 cloud / 截图来源在覆盖启动解析时丢失 identity (@heybox/hb-sdk-runtime)。
-- Mock Runtime 支持显式 `identity`，并在注释中标明 browser dev host URL 与生产启动详情信任边界的差异 (@heybox/hb-sdk-runtime)。
+- 预发布版本：改进真机预览身份校验。
 
 ## 0.6.6
 
-### SDK
-
-- 真机预览改用短时 token 保护的 `dev_context_url`，并通过 token-bound 本地代理执行 `network.request`；旧 `dev_network_request` 不再授权。
-- `share.showShareMenu()` 与 `share.screenshot()` 支持通过 `post` 预置社区发帖分区和话题。
-
-### Build and CLI
-
-- 新增 `hb-sdk build [--env <name>]` 作为推荐生产构建入口，新模板默认在类型检查后调用该命令。
-- Dev Context 权限覆盖按项目和小程序持久化；Mock Host 网络代理允许本机、局域网和保留地址，同时保留协议、敏感请求头、超时和重定向安全校验。
-- `hb-sdk dev` 与 `hb-sdk remote deploy` 仅在远端已授权官方域名网络请求时跳过平台 CSP；其他构建和异常权限快照继续 fail closed 注入。
-
-### Runtime
-
-- `network.request` 在权限开启后允许任意 HTTP(S) 目标，官方域名授权仍由 `useOfficialDomain` 独立控制。
-- 分享 Runtime 对 `post` 做白名单归一化：开发环境严格报错，生产环境过滤非法项并保留原分享流程。
+- 新增 `hb-sdk build`，改进真机预览，并为分享能力新增发帖预置选项。
 
 ## 0.6.6-alpha.4
 
-### Build and CLI
-
-- `hb-sdk dev` 与 `hb-sdk remote deploy` 在远端 `network.request` 已启用且 `useOfficialDomain=true` 时跳过平台 CSP；`hb-sdk build`、直接 Vite build、匿名或异常权限快照继续 fail closed 注入，Runtime Gate 与其他 HTML 校验保持不变。
+- 预发布版本：验证远端网络权限兼容性。
 
 ## 0.6.6-alpha.3
 
-### Build and CLI
-
-- 新增 `hb-sdk build [--env <name>]` 作为推荐生产构建入口：直接使用项目 Vite、固定清理并生成 `dist/`，要求显式配置 `miniappManifest()`，且不执行类型检查、不依赖登录、项目绑定或远端网络。
-- 新模板的 `scripts.build` 改为 `vue-tsc --noEmit && hb-sdk build`；`hb-sdk remote deploy` 继续执行项目自己的 `scripts.build`，现有 `vite build` 项目保持兼容且不会自动迁移。
+- 预发布版本：验证 `hb-sdk build`。
 
 ## 0.6.6-alpha.2
 
-### SDK
-
-- `share.showShareMenu()` 与 `share.screenshot()` 新增可空 `post` 配置，通过 `topicIds` 和不带首尾 `#` 的 `topics` 预置客户端社区发帖页；普通分享支持一个默认分区，截图分享支持多个分区。
-
-### Runtime
-
-- 分享 Runtime 对 `post` 做白名单归一化：开发 Runtime 严格返回参数错误，生产 Runtime 过滤非法项并保留原分享流程；客户端协议仍只在 Host adapter 内生成。
+- 预发布版本：验证分享发帖预置选项。
 
 ## 0.6.6-alpha.1
 
-### Build and CLI
-
-- Mock Host 的 `network.request` 代理不再拒绝本机、局域网或保留地址；初始请求和重定向仍分别解析并固定连接地址。
-
-### Runtime
-
-- `network.request` 在权限开启后允许任意 HTTP(S) 目标，不再按本机、内网、link-local、metadata 或保留地址分类拒绝初始 URL；协议、URL 用户信息、敏感请求头、超时和请求体限制保持不变。
+- 预发布版本：改进本地网络调试。
 
 ## 0.6.6-alpha.0
 
-### Build and CLI
-
-- Dev Context 权限覆盖改为持久化到 `hb-sdk` 用户缓存，并按真实项目路径与小程序 ID 隔离；刷新调试页或重启 `hb-sdk dev` 后继续生效，只有显式重置才会重新读取远端权限并清除覆盖。
-- 权限覆盖按 scope 拆分为独立原子文件，多调试页或多进程写入同一 scope 时采用最后成功写入的完整配置；缓存写入失败时当前页面仍立即应用修改，并明确提示刷新或重启后会丢失。
-
-### SDK
-
-- 真机预览改用 5 分钟有效、256-bit token 保护的 `dev_context_url`：Runtime Host 启动前拉取不可变权限快照，`network.request` 仅走 token-bound 本地代理且固定 `useOfficialDomain: false`；旧 `dev_network_request` 不再授权，Android/iOS 客户端无需修改 (@heybox/hb-sdk).
+- 预发布版本：改进 Dev Context 和真机预览。
 
 ## 0.6.5
 
-### Docs / Agent Skill
-
-- 优化小程序工坊公开文档，突出 AI 开发路径，统一受控沙箱、网络权限、真机调试和发布展示口径。
-- 精简 CLI 与本地 Mock 指南，收紧可分发 Agent Skill 的公开边界。
+- 优化公开文档、CLI 与本地调试说明。
 
 ## 0.6.4
 
-### Build and CLI
-
-- `hb-sdk dev` 不再把项目绑定、CLI 登录或远端 dev context 作为启动门禁；远端信息不可用时，浏览器 Mock、Mac 启动协议和手机二维码仍可进入默认拒绝受管能力的匿名本地沙箱。
-- Mock Host 支持仅在本地内存中切换 `network.request` 权限，并按远端快照保留官方域名权限，对比提示上线后的 `PERMISSION_DENIED` 差异；切换权限不会重建 iframe 或中断 Vite HMR，也不会修改线上配置。
-- 匿名降级继续向 LAN bootstrap 只提供固定脱敏提示；`hb-sdk dev --verbose` 会在本地输出移除 URL 凭据后的失败原因。Runtime 与 Mock Host 统一复用 `@heybox/hb-sdk/protocol` 的权限快照解析器。
+- 改进匿名本地调试和网络权限模拟体验。
 
 ## 0.6.3
 
-### Build and CLI
-
-- 移除 `hb-sdk dev` 和手动 Vite build 的客户端最低 SDK 版本查询、比较与 24 小时缓存；Manifest SDK 版本记录、Runtime 启动校验和服务端发布策略保持生效。
+- 简化本地开发和构建时的版本检查。
 
 ## 0.6.2
 
-### CLI
-
-- `hb-sdk remote deploy` 仅从项目配置读取 `package.json.heybox.miniProgramId`；名称/icon/封面由开放平台维护。服务端在无历史审核通过资料时注入默认名与默认图，占位资料可 release 但不可 `square show`。
+- 简化远端部署所需的本地项目配置。
 
 ## 0.6.1
 
-### CLI
-
-- `hb-sdk remote deploy` 及 `--from-version` 不再执行客户端最低 SDK 版本查询或比较；Manifest 校验和服务端版本策略保持生效。
+- 简化远端部署的版本检查。
 
 ## 0.6.0
 
-### SDK
-
-- 根入口改为 eager 创建唯一 SDK 实例并立即握手；移除 `createMiniProgramSDK`、`MiniProgramSDK` 和 `MiniProgramSDKOptions` 公共导出，业务统一迁移到默认单例。
-- handshake 携带构建时注入的真实 `sdkVersion`，为 Runtime 心跳、导航越界检测和版本一致性校验提供依据。
-
-### Build and CLI
-
-- `miniappManifest()` 自动写入不可覆盖的 `sdkVersion`，仅允许 `dist/index.html`，并在 `<head>` 首位注入禁止浏览器原生网络出口的 CSP；危险资源 URL、meta refresh、额外 HTML 和危险 resource hint 会直接使 build 失败。
-- 工坊小程序构建产物只能在兼容的小黑盒 Runtime 中启动，普通浏览器直接打开时不执行标准业务脚本。
-- `hb-sdk dev`、Vite build 和 `hb-sdk remote deploy` 接入公共 `minimumSdkVersion` 门禁，按 Remote Environment 隔离缓存最后一次有效配置 24 小时；无有效配置默认阻断。
-- `hb-sdk remote deploy` 移除 `--skip-build`，普通发布始终执行项目 build，并拒绝不符合 Runtime-only 启动要求的入口产物。
-- `hb-sdk remote deploy --env <name>` 在加载 `.env.<name>` 后会将同名 Vite mode 传给项目 build，并让 Vite 最低 SDK 版本门禁携带 `HB_SDK_SERVICE_TAG`，使 CLI 后端环境、灰度路由和构建环境保持一致。
-- 正式 deploy 拒绝预发布 SDK，dev/build 允许合规预发布版本用于远程预览。
-
-### Runtime
-
-- 保持 bridge 消息版本 1，增加内部 location probe/report 与 CSP 诊断契约；Runtime 可对 SDK 0.6 及以上版本执行主动心跳和导航范围检查。
+- 统一 SDK 默认实例，并强化构建产物与发布检查。
 
 ## 0.5.17
 
-### CLI
-
-- 使用结构化登录态错误码判断本地 Runtime 权限降级，避免登录提示文案调整导致 `hb-sdk dev` 启动中断。
-
-### SDK
-
-- 保持 `@heybox/hb-sdk` 与 `@heybox/hb-sdk-runtime` 版本一致，并补齐 Runtime 权限契约与跨端回归验证。
+- 修复 CLI 登录状态判断导致的本地调试中断。
 
 ## 0.5.16
 
-### Runtime
-
-- `network.request` 改为读取服务端 Runtime 权限快照并默认拒绝未显式授权的请求，官方域名访问由 `useOfficialDomain` 独立控制。
-
-### SDK
-
-- 保持 `@heybox/hb-sdk` 与 `@heybox/hb-sdk-runtime` 版本一致，并将相关 Runtime 权限回归测试纳入发布门禁。
-
-### Cloud
-
-- 修复云端排行榜请求错误使用工坊 API 域名的问题，统一通过小黑盒主站 API 访问排行榜接口。
+- 改进网络权限检查，并修复排行榜服务访问问题。
 
 ## 0.5.15
 
-### Runtime
-
-- 截图分享期间等待开发者入口隐藏完成绘制后再派发原生截图，并在页面隐藏或销毁时取消请求；绘制等待超时后兜底继续派发，避免点击分享无响应。
-
-### SDK
-
-- 保持 `@heybox/hb-sdk` 与 `@heybox/hb-sdk-runtime` 版本一致。
+- 修复截图分享偶发无响应的问题。
 
 ## 0.5.14
 
-### Agent Skill
-
-- 同步 hb-sdk Agent Skill 版本元数据与完整性标识，并保持 `@heybox/hb-sdk-runtime` 和 SDK 版本一致。
+- 同步公开 Agent Skill 版本信息。
 
 ## 0.5.11
 
-### Cloud
-
-- 对齐云端排行榜后端契约：保留后端 SBE 错误码、校验 safe number 分数与 2048 bytes `extra` 限制，并按服务端不透明 cursor、`rankLimit` 和并发提交锁语义更新 mock runtime 与文档。
-- 同步后端排行榜创建/删除语义：创建成功后记录集合已可用，删除会同步清理配置和记录集合，不再暴露异步建表中间状态。
-- 同步当前用户记录排名计算上限：`submit()` 和 `getCurrentUserEntry()` 超出前 5000 名或 `rankLimit` 时返回 `ranked=false`、`rank=0`。
-- 补充 `cloud.leaderboard` 公开 API 文档，明确默认榜单需预先创建、`extra` 更新规则、排序与分页约束。
+- 完善 `cloud.leaderboard` 排行榜能力、限制和公开文档。
 
 ## 0.5.10
 
-### CLI
-
-- `remote deploy --from-version` 文档化历史产物复用流程，并拒绝与 `--skip-build` 同时使用。
+- 支持复用历史构建产物提交新版本审核。
 
 ## 0.5.7
 
-### CLI
-
-- 同步小程序版本资料接口，`remote deploy` 提交审核时带上名称、icon 和封面图.
-- 移除 `remote update` 以及 `remote create` 的基础信息参数，基础资料统一跟随版本审核.
-- 模板补充 `heybox.miniProgramProfile` 配置占位.
-
-### Agent Skill
-
-- 同步 CLI 文档、skill references 和公开 agent-skills payload 到 0.5.7.
+- 调整远端版本资料配置与审核提交流程。
 
 ## 0.5.6
 
-Initial maintained changelog baseline.
-
-Future entries are generated from Conventional Commits, refined by AI, and confirmed by the releaser.
+- 开始维护公开 Package Changelog。