@heybox/hb-sdk 0.9.1-alpha.5 → 0.9.1-alpha.6

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.1-alpha.6 - 2026-10-15
+
+### 新增能力
+
+- 新增 `hb-sdk feedback`，可打开小程序工坊反馈页面，或提交问题、复现步骤、日志与截图链接，进入现有私有客服工单。
+- 新增 `hb-sdk feedback list`、`detail` 和 `reply`，查看本人小程序工坊工单并向未关闭的原工单追加信息。
+
+### 文档与工具
+
+- 提交前后明确说明私有工单性质、编号与详情链接，并提示在 App「设置 → 帮助与反馈 → 我的反馈」跟进。
+- 智能体新建前先查看已有工单，确认同一问题后优先补充；服务端未确认工单隔离时拒绝读取和回复。
+- 补充开发常见问题及反馈入口。
+
 ## 0.9.1-alpha.5
 
 - 工作区卡片 Controller v2 支持在本地开发入口调试，并校验控制器依赖、权限及卡片参数。

package/README.md

@@ -512,3 +512,25 @@ Controller 使用 `@heybox/hb-sdk/card-controller` 编写，普通页面使用
 
 卡片合同只在开发构建时依赖私有 `@ai-desktop/view-contract`，发布 JS 与声明已封装所需代码和类型。
 用户安装 hb-sdk 不需要该私有包；`check:bundled-contract` 阻止未内联引用进入发布制品。
+
+## 开发反馈
+
+小程序工坊开发者反馈统一进入现有私有客服工单。登录后只能查看自己的反馈，客服通过现有后台派单和回复。
+
+```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 list --json            # 先查看本人已有的小程序工坊工单
+hb-sdk feedback detail 9527 --json     # 查看内容和客服回复
+hb-sdk feedback reply 9527 --desc "补充复现步骤" --json
+```
+
+问题描述必填；AppID、关联 API、SDK 版本、环境、复现步骤、日志及截图选填。使用 `--scene` 补充复现步骤，`--log-file` 读取日志文件。完整正文最多 5000 字符；截图参数接受已经上传的 HTTP(S) URL，可重复，最多 10 张。CLI 不会上传本地图片文件，网页图片上传复用现有反馈页。
+
+提交时从现有分类接口查找“小程序工坊”分类（兼容原“小程序工坊开发者”和“小程序工坊开发者反馈”名称）及“开发中的常见问题”问题项，再调用 `/bbs/web/feedback/user/post`。分类未配置时拒绝提交；上线前需配置分类、问题项，并绑定客服组和派单优先级。提交结果包含原有工单 ID 和详情链接，不再创建独立 SDK 反馈记录。提交前会明确提示将创建私有反馈工单；使用提交时的同一小黑盒账号，在 App「设置 → 帮助与反馈 → 我的反馈」查看进展、客服回复或补充信息，也可打开返回的工单详情链接。`--json` 的成功结果包含 `message` 和 `follow_up` 说明，提交前提示输出到 stderr，不影响 stdout JSON 解析。
+
+列表支持 `--offset` 和 `--limit`（最多 50 条），详情和回复只允许访问当前登录账号在小程序工坊分类 `71` 下的工单。回复复用原工单，不占新建额度；已解决或关闭的工单不能继续回复。新能力需要后端支持范围隔离；服务未更新时会明确报错，不回退为读取全部工单。
+
+新建前先用 `feedback list` 查看已有工单，必要时用 `detail` 确认是否为同一问题；同一问题优先 `reply`。CLI 不会自动进行语义查重或合并，不能确认时由用户判断。

package/dist/cli-chunks/browser-DUdEZCyq.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var index = require('./index-J4uQvKT_.cjs');
+
+async function openExternalUrl(url) {
+    try {
+        await index.open(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+exports.openExternalUrl = openExternalUrl;

package/dist/cli-chunks/{build-D91J_GAa.cjs → build-DYYWRiaY.cjs}

@@ -1,29 +1,35 @@
 'use strict';
 
-var runtimeGate = require('./runtime-gate-CfAkz0p-.cjs');
+var runtimeGate = require('./runtime-gate-DedD3ynE.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-L7OfyRcl.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DWaPlchd.cjs');
 require('node:crypto');
 require('node:zlib');
-var index = require('./index-TQwjvNjL.cjs');
-var projectVite = require('./project-vite-CN6mMjzX.cjs');
+var index = require('./index-J4uQvKT_.cjs');
+var projectVite = require('./project-vite-Du1m7Y_3.cjs');
 require('node:module');
 require('node:url');
 require('fs');
 require('path');
 require('os');
 require('inspector');
-require('./version-C_NaCZ8O.cjs');
+require('./version-tzrFwpkl.cjs');
 require('node:async_hooks');
+require('constants');
+require('stream');
+require('util');
+require('assert');
 require('readline');
 require('tty');
-require('assert');
 require('events');
-require('stream');
 require('buffer');
-require('util');
+require('node:process');
+require('node:buffer');
+require('node:util');
+require('node:child_process');
+require('node:os');
 
 function areStringArraysEqual(left, right) {
     return left.length === right.length && left.every((value, index) => value === right[index]);

package/dist/cli-chunks/{context-Xdd45FFd.cjs → context-Bo4L-Cx_.cjs}

@@ -3,10 +3,10 @@
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-L7OfyRcl.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DWaPlchd.cjs');
 var fs$1 = require('node:fs');
 var sharp = require('sharp');
-var session = require('./session-DZrr6RYK.cjs');
+var index = require('./index-J4uQvKT_.cjs');
 
 async function inspectBasicInfoImage(bytes, sourcePath, kind) {
     const inspected = await inspectDecodedBasicInfoImage(bytes, kind);
@@ -525,20 +525,20 @@ async function listUserMiniprogramVersions(options, runtime) {
 }
 async function remoteGet(path, query, runtime) {
     const pathWithQuery = createPathWithQuery(path, query);
-    const context = session.createHeyboxOpenPlatformRequestContext(runtime.session, pathWithQuery);
+    const context = index.createHeyboxOpenPlatformRequestContext(runtime.session, pathWithQuery);
     const fetchImpl = runtime.fetchImpl ?? fetch;
-    const response = await fetchImpl(session.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, pathWithQuery, context.platformParams), {
+    const response = await fetchImpl(index.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, pathWithQuery, context.platformParams), {
         method: 'GET',
         headers: context.headers,
     });
     return readRequiredResult(response, pathWithQuery);
 }
 async function remotePostForm(path, fields, runtime, options = {}) {
-    const context = session.createHeyboxOpenPlatformRequestContext(runtime.session, path, {
+    const context = index.createHeyboxOpenPlatformRequestContext(runtime.session, path, {
         contentType: 'application/x-www-form-urlencoded',
     });
     const fetchImpl = runtime.fetchImpl ?? fetch;
-    const response = await fetchImpl(session.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, path, context.platformParams), {
+    const response = await fetchImpl(index.createHeyboxApiUrl(runtime.baseUrl ?? context.baseUrl, path, context.platformParams), {
         method: 'POST',
         headers: context.headers,
         body: createFormBody(fields),
@@ -549,11 +549,11 @@ async function remotePostForm(path, fields, runtime, options = {}) {
     return readRequiredResult(response, path);
 }
 async function readRequiredResult(response, pathWithQuery) {
-    const result = await session.readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: true });
+    const result = await index.readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: true });
     return result;
 }
 async function readOptionalResult(response, pathWithQuery) {
-    return session.readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: false });
+    return index.readHeyboxApiEnvelope(response, { pathWithQuery, requireResult: false });
 }
 function createPathWithQuery(path, query) {
     const params = new URLSearchParams();
@@ -586,16 +586,16 @@ function createFormBody(fields) {
 
 async function resolveRemoteEnvironment(options = {}, runtime = {}) {
     const env = options.env ?? process.env;
-    const apiBaseUrl = session.resolveHeyboxApiBaseUrl({ ...options, env });
-    const loginBaseUrl = session.resolveHeyboxLoginBaseUrl({ ...options, env });
-    const session$1 = options.session ?? (await (runtime.requireAuthSession ?? session.requireHeyboxAuthSession)({ loginBaseUrl }));
+    const apiBaseUrl = index.resolveHeyboxApiBaseUrl({ ...options, env });
+    const loginBaseUrl = index.resolveHeyboxLoginBaseUrl({ ...options, env });
+    const session = options.session ?? (await (runtime.requireAuthSession ?? index.requireHeyboxAuthSession)({ loginBaseUrl }));
     return {
         apiBaseUrl,
         loginBaseUrl,
         allowUnsafeApiBaseUrl: options.allowUnsafeApiBaseUrl === true || isTruthyEnvFlag(env.HB_SDK_ALLOW_UNSAFE_API_BASE_URL),
         env,
         fetchImpl: runtime.fetchImpl ?? options.fetchImpl ?? fetch,
-        session: session$1,
+        session,
     };
 }
 function createRemoteApiClientForEnvironment(environment) {

package/dist/cli-chunks/{create-BzpdRC5r.cjs → create-CKC4yp0J.cjs}

@@ -5,17 +5,24 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var require$$0 = require('fs');
 var require$$1 = require('path');
-var index = require('./index-TQwjvNjL.cjs');
+var index = require('./index-J4uQvKT_.cjs');
 require('node:module');
 require('os');
-require('node:crypto');
+require('constants');
+require('stream');
+require('util');
+require('assert');
 require('readline');
 require('tty');
-require('assert');
 require('events');
-require('stream');
 require('buffer');
-require('util');
+require('node:crypto');
+require('node:process');
+require('node:buffer');
+require('node:url');
+require('node:util');
+require('node:child_process');
+require('node:os');
 
 var ejs = {};
 

package/dist/cli-chunks/{dev-C7acO3Kt.cjs → dev-BMX6UXUe.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var session = require('./session-DZrr6RYK.cjs');
-var context = require('./context-Xdd45FFd.cjs');
+var index = require('./index-J4uQvKT_.cjs');
+var context = require('./context-Bo4L-Cx_.cjs');
 var node_crypto = require('node:crypto');
 var fs = require('node:fs');
-var runtimePermissionEnv = require('./runtime-permission-env-L7OfyRcl.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DWaPlchd.cjs');
 var os = require('node:os');
 var path = require('node:path');
 var net = require('node:net');
@@ -13,12 +13,11 @@ var node_http = require('node:http');
 var node_module = require('node:module');
 var undici = require('undici');
 var fs$1 = require('node:fs/promises');
-var index = require('./index-TQwjvNjL.cjs');
 var require$$0$1 = require('crypto');
 var require$$0 = require('buffer');
-var browser = require('./browser-RAy8e8cV.cjs');
-var projectVite = require('./project-vite-CN6mMjzX.cjs');
-var version = require('./version-C_NaCZ8O.cjs');
+var browser = require('./browser-DUdEZCyq.cjs');
+var projectVite = require('./project-vite-Du1m7Y_3.cjs');
+var version = require('./version-tzrFwpkl.cjs');
 require('node:zlib');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -1993,8 +1992,8 @@ const DEFAULT_CHANNEL_TRANSPORT = {
 };
 const IPV4_LOOPBACK_ADDRESSES = new net.BlockList();
 IPV4_LOOPBACK_ADDRESSES.addSubnet('127.0.0.0', 8, 'ipv4');
-const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-C7acO3Kt.cjs', document.baseURI).href)))('ws');
-const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-C7acO3Kt.cjs', document.baseURI).href)))('parse5');
+const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-BMX6UXUe.cjs', document.baseURI).href)))('ws');
+const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-BMX6UXUe.cjs', document.baseURI).href)))('parse5');
 const BROWSER_DEV_HOST_ROOT_CANDIDATES = [
     path.resolve(__dirname, 'devtools/browser-dev-host'),
     path.resolve(__dirname, '../devtools/browser-dev-host'),
@@ -11094,7 +11093,7 @@ function assertNodeRuntimeCapabilities(ctx, settings) {
 function createNodeRealtimeDriverRegistry() {
     const registry = createRuntimeRealtimeDriverRegistry();
     registry.registerLazy('node-websocket', async () => {
-        const mod = await Promise.resolve().then(function () { return require('./index.esm-dgqkvowo.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-eNPTDv6W.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;
@@ -14905,7 +14904,7 @@ function createBrowserDevHostCliAuth(options = {}) {
     const fetchImpl = options.fetchImpl ?? fetch;
     const noRedirectFetch = (input, init) => fetchImpl(input, { ...init, redirect: 'manual' });
     const store = options.store ?? { env: options.env };
-    const readSession = options.readSession ?? (() => session.readHeyboxAuthSession(store));
+    const readSession = options.readSession ?? (() => index.readHeyboxAuthSession(store));
     let lastKey = '';
     let revision = 0;
     let profileKey = '';
@@ -15810,7 +15809,7 @@ async function runDevCommand(options, runtime = {}) {
     let browserDevHost;
     try {
         browserDevHost = await runDevStartupTask(logger, '正在启动浏览器调试页服务', () => startBrowserDevHostServer({
-            openPlatformBaseUrl: session.resolveHeyboxOpenPlatformBaseUrl(runtime.env),
+            openPlatformBaseUrl: index.resolveHeyboxOpenPlatformBaseUrl(runtime.env),
             appUrl,
             devSessionId,
             devContext: currentDevContext,
@@ -16035,7 +16034,7 @@ async function loadDevLaunchContext(options) {
     const anonymous = (warning) => ({ context: { source: 'anonymous', warning,
             declaredPermissions: localPermissions.permissions ?? {}, platforms,
             runtimePermissions: runtimePermissionEnv.composeMiniappRuntimePermissions(localPermissions, undefined).runtimePermissions }, miniProgram: null });
-    if (!(await session.readHeyboxAuthSession({ env: options.env })))
+    if (!(await index.readHeyboxAuthSession({ env: options.env })))
         return anonymous('尚未登录 CLI，真实手机和 PC 调试不可用');
     const miniProgramId = await context.readBoundMiniProgramId(options.projectRoot);
     if (!miniProgramId)

package/dist/cli-chunks/{doctor-BgHRDQmG.cjs → doctor-DqEYRo4I.cjs}

@@ -3,19 +3,26 @@
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-TQwjvNjL.cjs');
+var index = require('./index-J4uQvKT_.cjs');
 require('node:module');
-require('node:fs');
 require('path');
 require('os');
-require('node:crypto');
+require('fs');
+require('constants');
+require('stream');
+require('util');
+require('assert');
 require('readline');
 require('tty');
-require('assert');
 require('events');
-require('stream');
 require('buffer');
-require('util');
+require('node:crypto');
+require('node:process');
+require('node:buffer');
+require('node:url');
+require('node:util');
+require('node:child_process');
+require('node:fs');
 
 const CANDIDATES = [
     path.resolve(__dirname, '..', 'package.json'),

package/dist/cli-chunks/{index-CjhQXbxy.cjs → index-DmCWB_hF.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index$2 = require('./index-TQwjvNjL.cjs');
+var index$2 = require('./index-J4uQvKT_.cjs');
 var require$$0$3 = require('fs');
 var require$$0$2 = require('crypto');
 var require$$1$2 = require('path');
 var require$$0$5 = require('assert');
 var require$$0$4 = require('events');
 var require$$1$1 = require('util');
-var runtimePermissionEnv = require('./runtime-permission-env-L7OfyRcl.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DWaPlchd.cjs');
 var require$$0$7 = require('net');
 var require$$0$6 = require('url');
 var require$$2$1 = require('http');
@@ -16,7 +16,7 @@ var require$$0$8 = require('stream');
 var require$$0$a = require('zlib');
 var require$$1$3 = require('querystring');
 var require$$0$9 = require('buffer');
-var runtimeGate = require('./runtime-gate-CfAkz0p-.cjs');
+var runtimeGate = require('./runtime-gate-DedD3ynE.cjs');
 var require$$4$3 = require('tls');
 
 function _mergeNamespaces(n, m) {