@heybox/hb-sdk 0.9.1-alpha.7 → 0.9.1-alpha.9

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.1-alpha.9 - 2026-10-16
+
+### 新增能力
+
+- 反馈新建与追加回复支持上传本地图片和 GIF，图片和 GIF 合计最多 10 张，日志不占图片额度；普通图片单张 20 MiB、GIF 单张 10 MiB，暂不支持视频附件。
+- 新建和追加回复统一通过 `--log` 提供日志：支持本地 `.log`、ZIP 日志包，字符串自动包装成 `.log` 文件；单份上传最多 10 MiB，ZIP 内最多 50 份非空 UTF-8 `.log`，解压后合计最多 20 MiB，日志独立于图片额度，正文仅保留上传返回的日志下载链接。
+- 新建反馈强制校验至少 5 个字符的问题描述、问题项目的 SDK 版本、运行平台、非空日志和至少一张截图；追加回复的描述同步至少 5 个字符。
+- 移除重复的 `feedback submit` 子命令，统一使用 `hb-sdk feedback` 提交；工单列表保留分页以查看超过五条的历史记录。
+- 反馈命令仅直接提交工单，不再打开或输出反馈提交页面地址；缺少问题描述时提示补充。
+
+- 反馈提交与追加回复增加检查、上传和提交阶段提示，进度不混入 JSON 结果；附件按顺序串行上传，全部成功后才提交工单；结果不明确时提示在 App 核对，不自动重试，也不保存本地恢复缓存。
+
+### 问题修复
+
+- 修复反馈附件上传授权请求缺少表单类型，导致服务端无法读取上传范围并返回“参数错误:1000”的问题。
+- 反馈日志上传前校验 ZIP 目录、结束记录和 CRC，拒绝损坏或未写完的压缩包；修复普通日志末尾残缺 UTF-8 字符被漏检的问题。
+
+### 文档与工具
+
+- 移除开放平台与文档中的反馈页面直达入口，保留 App 帮助与反馈入口及 CLI 提交说明。
+
+## 0.9.1-alpha.8 - 2026-10-16
+
+### 问题修复
+
+- 修复第一方小程序已声明权限在 CLI 查询、本地调试和发布检查中被误判为不可用的问题。
+- 权限查询区分原始审批与有效权限，并展示第一方自动批准来源。
+
 ## 0.9.1-alpha.7 - 2026-10-16
 
 ### 新增能力

package/README.md

@@ -503,7 +503,7 @@ Host/Runtime 集成维护者请先阅读 [`@heybox/hb-sdk-runtime` README](../hb
 
 ### 终端权限申请
 
-绑定小程序后，可用 `hb-sdk remote permission list` 查看平台状态和最近申请；使用 `hb-sdk remote permission apply network --reason "访问业务接口" --domains "api.example.com"` 或 `hb-sdk remote permission apply companion --reason "运行桌面辅助应用"` 提交申请。两种命令均支持 `--json`，无需上传版本；获批后仍需声明 Manifest 权限。
+绑定小程序后，可用 `hb-sdk remote permission list` 查看原始审批、本地声明下的有效状态和最近申请；使用 `hb-sdk remote permission apply network --reason "访问业务接口" --domains "api.example.com"` 或 `hb-sdk remote permission apply companion --reason "运行桌面辅助应用"` 提交申请。两种命令均支持 `--json`，无需上传版本；获批后仍需声明 Manifest 权限。第一方已声明的受审批权限自动批准，原始审批为 `disabled` 不表示有效权限被禁用；CLI 会单独标明批准来源。完整语义见[终端权限申请](https://docs.xiaoheihe.cn/hb_sdk/guide/permissions#终端权限申请)。
 
 ### 工作区卡片（开发中）
 
@@ -521,18 +521,18 @@ Controller 使用 `@heybox/hb-sdk/card-controller` 编写，普通页面使用
 小程序工坊开发者反馈统一进入现有私有客服工单。登录后只能查看自己的反馈，客服通过现有后台派单和回复。
 
 ```bash
-hb-sdk feedback                       # 打开现有反馈页面，预选开发者分类
-hb-sdk feedback --no-open              # 只输出地址
-hb-sdk feedback submit --desc "调用失败" --app-id app123 --api hb.network.request
-hb-sdk feedback submit --desc "调用失败" --screenshot https://cdn.example.com/error.png --json
+hb-sdk feedback --desc "调用接口时发生异常" --sdk-version 0.9.1-alpha.7 --platform ios --log ./error.log --screenshot ./error.png --app-id app123 --api hb.network.request
+hb-sdk feedback --desc "页面运行时出现崩溃" --sdk-version 0.9.1-alpha.7 --platform android --log ./error.log --screenshot ./error.png --json
 hb-sdk feedback list --json            # 先查看本人已有的小程序工坊工单
 hb-sdk feedback detail 9527 --json     # 查看内容和客服回复
-hb-sdk feedback reply 9527 --desc "补充复现步骤" --json
+hb-sdk feedback reply 9527 --desc "补充复现步骤" --screenshot ./error.png --log "Error: retry failed" --json
 ```
 
-问题描述必填；AppID、关联 API、SDK 版本、环境、复现步骤、日志及截图选填。使用 `--scene` 补充复现步骤，`--log-file` 读取日志文件。完整正文最多 5000 字符；截图参数接受已经上传的 HTTP(S) URL，可重复，最多 10 张。CLI 不会上传本地图片文件，网页图片上传复用现有反馈页。
+CLI 仅直接提交工单，不打开或输出反馈提交页面地址。新建反馈必须提供至少 5 个字符的问题描述、问题项目实际使用的 SDK 版本、问题发生的平台、非空报错日志和至少一张截图。使用 `--sdk-version` 填写有效版本号，不能用 CLI 自身版本代替；使用 `--platform` 指定 `ios`、`android`、`windows`、`macos`、`linux` 或 `web`，不会把执行 CLI 的电脑平台当作问题平台。日志统一通过 `--log` 提供，可传本地 `.log`、ZIP 日志包路径或日志文本，提交前请脱敏。缺少或填写无效时在登录、上传和提交前拒绝。AppID、关联 API、补充运行环境、复现步骤选填。追加回复只要求至少 5 个字符的补充描述，日志和附件可选，不重复要求原工单的 SDK 版本与平台。使用 `--scene` 补充复现步骤。`--log ./error.log` 上传非空 UTF-8 `.log` 文件；`--log "Error: request failed"` 将原始文本包装成 `feedback-text.log` 后上传。`--log ./logs.zip` 支持多个日志文件打包上传：只允许非空 UTF-8 `.log` 文件，最多 50 份，解压后合计不超过 20 MiB；不接受其他附件或嵌套压缩包。日志文件或压缩包单个不超过 10 MiB；日志全文不写入正文，正文只记录日志下载链接。完整正文最多 5000 字符；使用 `--screenshot` 传本地图片路径或已上传的 HTTP(S) 图片链接，可重复，图片和 GIF 合计最多 10 张，日志不占图片额度。普通图片单张不超过 20 MiB，GIF 单张不超过 10 MiB。暂不支持视频附件。图片沿用帮助与反馈的上传流程。
 
-提交时从现有分类接口查找“小程序工坊”分类（兼容原“小程序工坊开发者”和“小程序工坊开发者反馈”名称）及“开发中的常见问题”问题项，再调用 `/bbs/web/feedback/user/post`。分类未配置时拒绝提交；上线前需配置分类、问题项，并绑定客服组和派单优先级。提交结果包含原有工单 ID 和详情链接，不再创建独立 SDK 反馈记录。提交前会明确提示将创建私有反馈工单；使用提交时的同一小黑盒账号，在 App「设置 → 帮助与反馈 → 我的反馈」查看进展、客服回复或补充信息，也可打开返回的工单详情链接。`--json` 的成功结果包含 `message` 和 `follow_up` 说明，提交前提示输出到 stderr，不影响 stdout JSON 解析。
+提交时从现有分类接口查找“小程序工坊”分类（兼容原“小程序工坊开发者”和“小程序工坊开发者反馈”名称）及“开发中的常见问题”问题项，再调用 `/bbs/web/feedback/user/post`。分类未配置时拒绝提交；回复前先检查原工单属于本人小程序工坊且尚未关闭。所有本地附件先校验，再使用同一登录账号上传并提交，上传失败不会继续提交工单；附件不会单独作为上传命令对外提供。日志复用现有上传接口，正文使用接口返回的完整下载链接，不要求下载地址保留 `.log` 后缀。上线前需配置分类、问题项，并绑定客服组和派单优先级。提交结果包含原有工单 ID 和详情链接，不再创建独立 SDK 反馈记录。提交前会明确提示将创建私有反馈工单；使用提交时的同一小黑盒账号，在 App「设置 → 帮助与反馈 → 我的反馈」查看进展、客服回复或补充信息，也可打开返回的工单详情链接。`--json` 的成功结果包含 `message` 和 `follow_up` 说明，提交前提示输出到 stderr，不影响 stdout JSON 解析。
+
+反馈命令会显示检查文件、上传附件和提交工单的阶段提示，附件按顺序串行上传，全部上传成功后才提交工单；上传失败会提示具体文件和阶段，不继续提交。进度输出到 stderr，`--json` 的 stdout 只输出最终结果。不保存本地上传进度或提交缓存。提交超时、连接中断或响应不明确时，不自动查询或重试，请先到 App「帮助与反馈 → 我的反馈」核对结果，确认未成功后再重试。
 
 列表支持 `--offset` 和 `--limit`（最多 50 条），详情和回复只允许访问当前登录账号在小程序工坊分类 `71` 下的工单。回复复用原工单，不占新建额度；已解决或关闭的工单不能继续回复。新能力需要后端支持范围隔离；服务未更新时会明确报错，不回退为读取全部工单。
 

package/dist/cli-chunks/_commonjs-dynamic-modules-DUamuDzp.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+function commonjsRequire(path) {
+	throw new Error('Could not dynamically require "' + path + '". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.');
+}
+
+exports.commonjsRequire = commonjsRequire;