@heybox/hb-sdk 0.6.6-alpha.1 → 0.6.6-alpha.3

package/skill/scripts/sync-references.mjs

@@ -207,6 +207,7 @@ const authGuide = frontmatterless(read('apps/docs/hb-sdk/guide/auth.md'));
 const lifecycleGuide = frontmatterless(read('apps/docs/hb-sdk/guide/lifecycle.md'));
 const errorGuide = frontmatterless(read('apps/docs/hb-sdk/guide/error-handling.md'));
 const loginGate = frontmatterless(read('apps/docs/hb-sdk/recipes/login-gate.md'));
+const communityShare = frontmatterless(read('apps/docs/hb-sdk/recipes/community-share.md'));
 const customInstance = frontmatterless(read('apps/docs/hb-sdk/recipes/custom-instance.md'));
 const referenceHome = frontmatterless(read('apps/docs/hb-sdk/reference/index.md'));
 const quickStartSection = extractSection(readme, '## 快速开始');
@@ -220,6 +221,7 @@ const manifestSection = extractSection(readme, '## Manifest');
 const cliSummarySection = extractSection(readme, '## CLI');
 const cliCreateSection = extractSection(cliGuide, '## 创建工坊小程序');
 const cliDevSection = extractSection(cliGuide, '## 推荐调试流程');
+const cliBuildSection = extractSection(cliGuide, '## 生产构建');
 const cliDeploySection = extractSection(cliGuide, '## 部署发布');
 const cliRemoteSection = extractSection(cliGuide, '## 远端管理命令');
 const cliLoginSection = extractSection(cliGuide, '## CLI 登录态');
@@ -227,6 +229,7 @@ const cliDoctorSection = extractSection(cliGuide, '## Agent Skill doctor');
 const cliUpdateSection = extractSection(cliGuide, '## 版本提醒');
 const cliCommandSurface = `hb-sdk create <project-name>
 hb-sdk dev [--port <port>] [--mock-port <port>] [--no-open]
+hb-sdk build [--env <name>] [--verbose]
 hb-sdk login
 hb-sdk login status
 hb-sdk login clear
@@ -344,6 +347,7 @@ files.set('cli.md', `${header('CLI reference', [
   'packages/hb-sdk/src/cli/index.ts',
   'packages/hb-sdk/src/cli/commands/create.ts',
   'packages/hb-sdk/src/cli/commands/dev.ts',
+  'packages/hb-sdk/src/cli/commands/build.ts',
   'packages/hb-sdk/src/cli/commands/login.ts',
   'apps/docs/hb-sdk/guide/cli.md',
 ])}${contents([
@@ -351,6 +355,7 @@ files.set('cli.md', `${header('CLI reference', [
   ['Command surface', 'command-surface'],
   ['Create a mini-program template', 'create-a-mini-program-template'],
   ['Local debugging', 'local-debugging'],
+  ['Production build', 'production-build'],
   ['Deploy and publish', 'deploy-and-publish'],
   ['Developer account scope', 'developer-account-scope'],
   ['Remote management commands', 'remote-management-commands'],
@@ -386,6 +391,17 @@ ${cliDevSection}
 
 Use \`hb-sdk dev\` to open the local debugging page. The "在 Mac 版 APP 中启动" button opens the page in the Mac App; the "Mobile App" QR code opens it in the phone App after a LAN interface is selected. These entries remain available without CLI login or project binding, but managed capabilities are denied by default. The phone and computer must be on the same LAN. If an embedded browser cannot open the App, use the system browser.
 
+## Production build
+
+${cliBuildSection}
+
+Agent rules:
+
+- Use \`hb-sdk build [--env <name>] [--verbose]\` as the recommended production build entry.
+- Require explicit \`miniappManifest()\` configuration and keep typechecking in the project's \`scripts.build\`.
+- Do not claim \`hb-sdk build\` needs login, binding, or network access, and do not invent unsupported build flags.
+- Existing \`vite build\` projects remain compatible and must not be auto-migrated.
+
 ## Deploy and publish
 
 ${rewriteBundledCliLinks(cliDeploySection)}
@@ -462,6 +478,7 @@ files.set('recipes.md', `${header('Recipes', [
   'apps/docs/hb-sdk/guide/lifecycle.md',
   'apps/docs/hb-sdk/guide/error-handling.md',
   'apps/docs/hb-sdk/recipes/login-gate.md',
+  'apps/docs/hb-sdk/recipes/community-share.md',
   'apps/docs/hb-sdk/recipes/custom-instance.md',
 ])}${contents([
   ['Quick start', 'quick-start'],
@@ -469,6 +486,7 @@ files.set('recipes.md', `${header('Recipes', [
   ['Lifecycle events', 'lifecycle-events'],
   ['Error handling', 'error-handling'],
   ['Login gate recipe', 'login-gate-recipe'],
+  ['Community share recipe', 'community-share-recipe'],
   ['Custom instance recipe', 'custom-instance-recipe'],
 ])}## Quick start
 
@@ -490,6 +508,10 @@ ${rewriteBundledRecipeLinks(errorGuide)}
 
 ${rewriteBundledRecipeLinks(loginGate)}
 
+## Community share recipe
+
+${rewriteBundledRecipeLinks(communityShare)}
+
 ## Custom instance recipe
 
 ${rewriteBundledRecipeLinks(customInstance)}
@@ -506,7 +528,7 @@ ${capabilityBoundaries}
 
 - Do not instruct mini-program code to read, extract, forward, store, or depend on token, cookie, phone number, or private credentials.
 - Negative safety statements that explain the SDK does not expose token/cookie/private credentials are correct and should be preserved.
-- Do not use raw share protocol fields, JS callbacks, activity reporting, post publishing, custom buttons, or upload-only flows.
+- Do not use raw share protocol fields, JS callbacks, activity reporting, direct post publishing, custom buttons, or upload-only flows. Public \`share.*({ post })\` options only preset an editable client post flow.
 - Do not use storage delete, clear, info listing, V2, or global Heybox client storage access.
 - Do not pass host-only protocol fields through \`network.request\`.
 - Do not build raw \`postMessage\` bridge flows in iframe business code.

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.6.6-alpha.1+skill.2799351c9553",
+  "skillVersion": "0.6.6-alpha.3+skill.7940a3d57a8b",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.6.6-alpha.1",
-    "compatibility": "0.6.6-alpha.1"
+    "version": "0.6.6-alpha.3",
+    "compatibility": "0.6.6-alpha.3"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-2799351c9553f32af834bd0a53e6d016d647aafb275dff139ddd0dfaf2261321"
+  "integrity": "sha256-7940a3d57a8b57fb3045378c068cc875bea2def32d926fcef19e0accad67901b"
 }

package/types/index.d.ts

@@ -4,7 +4,7 @@ export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPay
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
 export type { DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, LeaderboardEntry, LeaderboardOrder, MiniProgramCloudLeaderboardModule, MiniProgramCloudModule, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, } from './modules/cloud';
 export type { BasePlatformAccountInfo, CurrentUserAvatarConfig, CurrentUserAvatarDecoration, CurrentUserBbsInfo, CurrentUserDetail, CurrentUserLevelInfo, CurrentUserMedal, CurrentUserProfile, EpicPlatformAccountInfo, GetCurrentUserDetailPayload, GetCurrentUserDetailResult, GetCurrentUserProfilePayload, GetCurrentUserProfileResult, GetPlatformAccountInfoPayload, GetPlatformAccountInfoResult, GetPlatformAccountOverviewPayload, GetPlatformAccountOverviewResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, MiniProgramUserModule, MobilePlatformAccountInfo, PcHardwareAccountInfo, PlatformAccountInfoMap, PlatformAccountOverview, PlatformAccountResult, PlatformAccountType, PlatformStatItem, PsnPlatformAccountInfo, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SteamPlatformAccountInfo, SwitchPlatformAccountInfo, UserScopedResult, XboxPlatformAccountInfo, } from './modules/user';
-export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareModule, MiniProgramShowShareMenuOptions, ScreenshotPayload, ScreenshotResult, ShowShareMenuPayload, ShowShareMenuResult, } from './modules/share';
+export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareModule, MiniProgramSharePostOptions, MiniProgramShowShareMenuOptions, ScreenshotPayload, ScreenshotResult, ShowShareMenuPayload, ShowShareMenuResult, } from './modules/share';
 export type { GetWindowInfoPayload, GetWindowInfoResult, MiniProgramNavigationBarForegroundStyle, MiniProgramSafeArea, MiniProgramSetNavigationBarStyleOptions, MiniProgramViewportModule, MiniProgramWindowInfoResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, } from './modules/viewport';
 export type { GetStoragePayload, GetStorageResult, MiniProgramStorageModule, SetStoragePayload, } from './modules/storage';
 export type { MiniProgramNetworkHeaders, MiniProgramNetworkModule, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, NetworkRequestPayload, NetworkResponsePayload, } from './modules/network';

package/types/modules/share/types.d.ts

@@ -5,6 +5,13 @@
  * 不同宿主环境可支持的渠道集合可能不同；未传 `channel` 时由客户端自行展示默认分享面板。
  */
 export type MiniProgramShareChannel = 'wechatSession' | 'wechatTimeline' | 'qqFriend' | 'qzone' | 'weibo';
+/** 社区发帖预置配置。 */
+export interface MiniProgramSharePostOptions {
+    /** 默认发布分区 ID；普通分享只使用第一项，截图分享支持多项。 */
+    topicIds?: (string | number)[];
+    /** 预置话题内容，不包含首尾 `#`。 */
+    topics?: string[];
+}
 /**
  * 展示基础分享面板的配置。
  *
@@ -22,6 +29,8 @@ export interface MiniProgramShowShareMenuOptions {
     imageUrl?: string;
     /** 指定分享渠道；不传则由客户端展示默认分享面板。 */
     channel?: MiniProgramShareChannel;
+    /** 转发到社区时使用的分区与话题预置；`null` 等同于不配置。 */
+    post?: MiniProgramSharePostOptions | null;
 }
 /**
  * 截图区域。
@@ -52,4 +61,6 @@ export interface MiniProgramScreenshotOptions {
     delay?: number;
     /** 是否展示保存到相册能力。 */
     saveToAlbum?: boolean;
+    /** 转发到社区时使用的分区与话题预置；`null` 等同于不配置。 */
+    post?: MiniProgramSharePostOptions | null;
 }

package/types/protocol.d.ts

@@ -10,7 +10,7 @@ export type { DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderb
 export type { GetCurrentUserDetailPayload, GetCurrentUserDetailResult, GetCurrentUserProfilePayload, GetCurrentUserProfileResult, GetPlatformAccountInfoPayload, GetPlatformAccountInfoResult, GetPlatformAccountOverviewPayload, GetPlatformAccountOverviewResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, } from './modules/user';
 export type { ScreenshotPayload, ScreenshotResult } from './modules/share/screenshot';
 export type { ShowShareMenuPayload, ShowShareMenuResult } from './modules/share/show-share-menu';
-export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShowShareMenuOptions, } from './modules/share';
+export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramSharePostOptions, MiniProgramShowShareMenuOptions, } from './modules/share';
 export type { GetStoragePayload, GetStorageResult, SetStoragePayload } from './modules/storage';
 export type { GetWindowInfoPayload, GetWindowInfoResult, MiniProgramNavigationBarForegroundStyle, MiniProgramSafeArea, MiniProgramSetNavigationBarStyleOptions, MiniProgramWindowInfoResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, } from './modules/viewport';
 export type { MiniProgramNetworkHeaders, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, NetworkRequestPayload, NetworkResponsePayload, } from './modules/network';