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

package/README.md

@@ -158,7 +158,7 @@ await share.screenshot({
 });
 ```
 
-截图分享支持多个预置分区；分区与话题仍由用户在客户端发帖页中确认和修改，SDK 不会直接发布内容。
+截图分享支持多个预置分区；分区与话题仍由用户在客户端发帖页中确认和修改，SDK 不会直接发布内容。通过截图分享进入社区发帖流程时，客户端会自动把帖子关联到当前小程序，开发者无需配置额外来源字段。
 
 ### 基础 UI
 

package/dist/cli-chunks/{build-egxk9rgs.cjs → build-cBQK_qq-.cjs}

@@ -5,8 +5,8 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-BSs4uCNa.cjs');
 var runtimeGate = require('./runtime-gate--rPXjiG6.cjs');
-var index = require('./index-DAJGwzpN.cjs');
-var projectVite = require('./project-vite-RXpbNaQD.cjs');
+var index = require('./index-CZ1l6xci.cjs');
+var projectVite = require('./project-vite-BGAleOVW.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-B2Y0Du9z.cjs → context-CfrdSQSg.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var session = require('./session-4SxzY4w1.cjs');
+var session = require('./session-BbDd1r6M.cjs');
 var runtimePermissionEnv = require('./runtime-permission-env-BSs4uCNa.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');

package/dist/cli-chunks/{create-DPm5Sp-d.cjs → create-mp5nBLFJ.cjs}

@@ -5,7 +5,7 @@ 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-DAJGwzpN.cjs');
+var index = require('./index-CZ1l6xci.cjs');
 require('node:module');
 require('os');
 require('readline');

package/dist/cli-chunks/{dev-CEqWxCnf.cjs → dev-CSuSpwJC.cjs}

@@ -6,15 +6,15 @@ var path = require('node:path');
 var net = require('node:net');
 var promises = require('node:dns/promises');
 var node_http = require('node:http');
-var context = require('./context-B2Y0Du9z.cjs');
+var context = require('./context-CfrdSQSg.cjs');
 var node_crypto = require('node:crypto');
 var undici = require('undici');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-DAJGwzpN.cjs');
-var projectVite = require('./project-vite-RXpbNaQD.cjs');
+var index = require('./index-CZ1l6xci.cjs');
+var projectVite = require('./project-vite-BGAleOVW.cjs');
 var fs$1 = require('node:fs/promises');
 var runtimePermissionEnv = require('./runtime-permission-env-BSs4uCNa.cjs');
-require('./session-4SxzY4w1.cjs');
+require('./session-BbDd1r6M.cjs');
 require('fs');
 require('constants');
 require('stream');
@@ -1170,7 +1170,7 @@ function createHeyboxProtocol(payload) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.6.6';
+    : '0.6.7-alpha.1';
 
 class DevPermissionOverrideStoreError extends Error {
     code;

package/dist/cli-chunks/{doctor-DqNzGi3s.cjs → doctor-nEv6ikeF.cjs}

@@ -4,7 +4,7 @@ var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-DAJGwzpN.cjs');
+var index = require('./index-CZ1l6xci.cjs');
 require('node:module');
 require('path');
 require('os');

package/dist/cli-chunks/{index-DAJGwzpN.cjs → index-CZ1l6xci.cjs}

@@ -234,19 +234,19 @@ function requireArgument () {
 
 var command = {};
 
-const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DAJGwzpN.cjs', document.baseURI).href)));
+const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CZ1l6xci.cjs', document.baseURI).href)));
 function __require$4() { return require$5("node:events"); }
 
-const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DAJGwzpN.cjs', document.baseURI).href)));
+const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CZ1l6xci.cjs', document.baseURI).href)));
 function __require$3() { return require$4("node:child_process"); }
 
-const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DAJGwzpN.cjs', document.baseURI).href)));
+const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CZ1l6xci.cjs', document.baseURI).href)));
 function __require$2() { return require$3("node:path"); }
 
-const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DAJGwzpN.cjs', document.baseURI).href)));
+const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CZ1l6xci.cjs', document.baseURI).href)));
 function __require$1() { return require$2("node:fs"); }
 
-const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DAJGwzpN.cjs', document.baseURI).href)));
+const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-CZ1l6xci.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13347,7 +13347,7 @@ function getPathname(pathWithQuery) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.6.6';
+const BUILT_CLI_VERSION = '0.6.7-alpha.1';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13680,35 +13680,35 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DseHvHCN.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-B2kXjmcM.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DseHvHCN.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-B2kXjmcM.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DseHvHCN.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-B2kXjmcM.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-egxk9rgs.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-cBQK_qq-.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-DPm5Sp-d.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-mp5nBLFJ.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CEqWxCnf.cjs'); });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CSuSpwJC.cjs'); });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-DqNzGi3s.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-nEv6ikeF.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-Cko4-pSc.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-B5byhdC7.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{index-CSc_4vi-.cjs → index-CgUdrl3g.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index$2 = require('./index-DAJGwzpN.cjs');
+var index$2 = require('./index-CZ1l6xci.cjs');
 var require$$0$2 = require('fs');
 var require$$2$1 = require('crypto');
 var require$$1$2 = require('path');

package/dist/cli-chunks/{login-DseHvHCN.cjs → login-B2kXjmcM.cjs}

@@ -3,9 +3,9 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-4SxzY4w1.cjs');
+var session = require('./session-BbDd1r6M.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-DAJGwzpN.cjs');
+var index = require('./index-CZ1l6xci.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{project-vite-RXpbNaQD.cjs → project-vite-BGAleOVW.cjs}

@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
 var node_module = require('node:module');
 var path = require('node:path');
 var node_url = require('node:url');
-var index = require('./index-DAJGwzpN.cjs');
+var index = require('./index-CZ1l6xci.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-Cko4-pSc.cjs → remote-B5byhdC7.cjs}

@@ -1,15 +1,15 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var index = require('./index-DAJGwzpN.cjs');
-var session = require('./session-4SxzY4w1.cjs');
+var index = require('./index-CZ1l6xci.cjs');
+var session = require('./session-BbDd1r6M.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-BSs4uCNa.cjs');
 var runtimeGate = require('./runtime-gate--rPXjiG6.cjs');
-var context = require('./context-B2Y0Du9z.cjs');
+var context = require('./context-CfrdSQSg.cjs');
 require('node:module');
 require('path');
 require('os');
@@ -192,7 +192,7 @@ async function createDefaultCosClient(uploadToken) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-CSc_4vi-.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-CgUdrl3g.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{session-4SxzY4w1.cjs → session-BbDd1r6M.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-DAJGwzpN.cjs');
+var index = require('./index-CZ1l6xci.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
 var require$$0$2 = require('fs');

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-DAJGwzpN.cjs');
+var index = require('./cli-chunks/index-CZ1l6xci.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/dist/devtools/mock-host/main.js

@@ -3707,25 +3707,61 @@ function stringifyMiniProgramRuntimeJsonData(data, options) {
 }
 
 const LEADERBOARD_KEY_RE = /^[A-Za-z0-9_-]{1,64}$/;
+const DEFAULT_LEADERBOARD_KEY = 'default';
 const DEFAULT_LEADERBOARD_LIST_LIMIT = 20;
 const MAX_LEADERBOARD_LIST_LIMIT = 100;
 const MAX_LEADERBOARD_EXTRA_BYTES = 2048;
 const MAX_LEADERBOARD_SAFE_SCORE = Number.MAX_SAFE_INTEGER;
-/** 提交当前用户排行榜分数。 */
-async function submitMiniProgramRuntimeLeaderboardEntry(payload, options) {
-    const request = readLeaderboardPayload(payload, 'cloud.leaderboard.submit', 'submit');
+const LEADERBOARD_READ_CACHE_TTL_MS = 5 * 60 * 1000;
+const MAX_LEADERBOARD_LIST_CACHE_ENTRIES = 250;
+const MAX_LEADERBOARD_CACHE_BUCKETS = 3;
+/** 创建一组共享读缓存的排行榜 handler。 */
+function createMiniProgramRuntimeLeaderboardHandlers(options) {
+    const store = createLeaderboardReadStore();
+    return {
+        async submit(payload) {
+            const request = readLeaderboardPayload(payload, 'cloud.leaderboard.submit', 'submit');
+            const bucketKey = createLeaderboardBucketKey(options, request.key);
+            return submitLeaderboardEntry(request, options, () => store.invalidateMutableReads(bucketKey));
+        },
+        async getList(payload) {
+            const request = readLeaderboardPayload(payload, 'cloud.leaderboard.getList', 'list');
+            const bucketKey = createLeaderboardBucketKey(options, request.key);
+            const cacheKey = createLeaderboardCacheKey('list', request.limit, request.cursor ?? null);
+            return store.read(bucketKey, 'list', cacheKey, () => requestLeaderboardList(request, options));
+        },
+        async getCurrentUserEntry(payload) {
+            const request = readLeaderboardPayload(payload, 'cloud.leaderboard.getCurrentUserEntry', 'keyOnly');
+            const userId = await readCurrentUserId(options.platformAdapter);
+            const bucketKey = createLeaderboardBucketKey(options, request.key);
+            const cacheKey = createLeaderboardCacheKey('current', userId);
+            return store.read(bucketKey, 'current', cacheKey, () => requestCurrentUserLeaderboardEntry(request, userId, options));
+        },
+        async deleteCurrentUserEntry(payload) {
+            const request = readLeaderboardPayload(payload, 'cloud.leaderboard.deleteCurrentUserEntry', 'keyOnly');
+            const bucketKey = createLeaderboardBucketKey(options, request.key);
+            return deleteCurrentUserLeaderboardEntry(request, options, () => store.invalidateMutableReads(bucketKey));
+        },
+        async getInfo(payload) {
+            const request = readLeaderboardPayload(payload, 'cloud.leaderboard.getInfo', 'keyOnly');
+            const bucketKey = createLeaderboardBucketKey(options, request.key);
+            const cacheKey = createLeaderboardCacheKey('info');
+            return store.read(bucketKey, 'info', cacheKey, () => requestLeaderboardInfo(request, options));
+        },
+    };
+}
+async function submitLeaderboardEntry(request, options, onAdapterSuccess) {
     const userId = await readCurrentUserId(options.platformAdapter);
     const entry = await options.platformAdapter.cloud.leaderboard.submit({
         ...request,
         miniProgramId: options.identity?.miniProgramId,
         userId,
     });
+    onAdapterSuccess?.();
     assertLeaderboardEntry(entry, 'cloud.leaderboard.submit');
     return entry;
 }
-/** 读取排行榜列表。 */
-async function getMiniProgramRuntimeLeaderboardList(payload, options) {
-    const request = readLeaderboardPayload(payload, 'cloud.leaderboard.getList', 'list');
+async function requestLeaderboardList(request, options) {
     const result = await options.platformAdapter.cloud.leaderboard.getList({
         ...request,
         miniProgramId: options.identity?.miniProgramId,
@@ -3743,10 +3779,7 @@ async function getMiniProgramRuntimeLeaderboardList(payload, options) {
     }
     return result;
 }
-/** 读取当前用户在排行榜中的记录。 */
-async function getMiniProgramRuntimeCurrentUserLeaderboardEntry(payload, options) {
-    const request = readLeaderboardPayload(payload, 'cloud.leaderboard.getCurrentUserEntry', 'keyOnly');
-    const userId = await readCurrentUserId(options.platformAdapter);
+async function requestCurrentUserLeaderboardEntry(request, userId, options) {
     const entry = await options.platformAdapter.cloud.leaderboard.getCurrentUserEntry({
         ...request,
         miniProgramId: options.identity?.miniProgramId,
@@ -3757,24 +3790,21 @@ async function getMiniProgramRuntimeCurrentUserLeaderboardEntry(payload, options
     }
     return entry;
 }
-/** 删除当前用户在排行榜中的记录。 */
-async function deleteMiniProgramRuntimeCurrentUserLeaderboardEntry(payload, options) {
-    const request = readLeaderboardPayload(payload, 'cloud.leaderboard.deleteCurrentUserEntry', 'keyOnly');
+async function deleteCurrentUserLeaderboardEntry(request, options, onAdapterSuccess) {
     const userId = await readCurrentUserId(options.platformAdapter);
     const result = await options.platformAdapter.cloud.leaderboard.deleteCurrentUserEntry({
         ...request,
         miniProgramId: options.identity?.miniProgramId,
         userId,
     });
+    onAdapterSuccess?.();
     assertMiniProgramRuntimeRecord(result, 'cloud.leaderboard.deleteCurrentUserEntry 返回值必须是对象');
     if (typeof result.deleted !== 'boolean') {
         throw createMiniProgramRuntimeBridgeError('INVALID_RESPONSE', 'cloud.leaderboard.deleteCurrentUserEntry 返回的 deleted 必须是布尔值');
     }
     return result;
 }
-/** 读取排行榜基础信息。 */
-async function getMiniProgramRuntimeLeaderboardInfo(payload, options) {
-    const request = readLeaderboardPayload(payload, 'cloud.leaderboard.getInfo', 'keyOnly');
+async function requestLeaderboardInfo(request, options) {
     const info = await options.platformAdapter.cloud.leaderboard.getInfo({
         ...request,
         miniProgramId: options.identity?.miniProgramId,
@@ -3791,6 +3821,138 @@ async function getMiniProgramRuntimeLeaderboardInfo(payload, options) {
     }
     return info;
 }
+function createLeaderboardReadStore() {
+    const buckets = new Map();
+    const inflight = new Map();
+    function getOrCreateBucket(bucketKey) {
+        const bucket = buckets.get(bucketKey);
+        if (bucket) {
+            return bucket;
+        }
+        pruneExpiredBuckets();
+        if (buckets.size >= MAX_LEADERBOARD_CACHE_BUCKETS) {
+            return undefined;
+        }
+        const nextBucket = {
+            generation: 0,
+            caches: {
+                list: new Map(),
+                current: new Map(),
+                info: new Map(),
+            },
+        };
+        buckets.set(bucketKey, nextBucket);
+        return nextBucket;
+    }
+    function read(bucketKey, kind, cacheKey, request) {
+        const bucket = getOrCreateBucket(bucketKey);
+        const cache = bucket?.caches[kind];
+        const cached = cache?.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            return Promise.resolve(cached.value);
+        }
+        cache?.delete(cacheKey);
+        const inflightKey = createLeaderboardInflightKey(bucketKey, cacheKey);
+        const existingInflight = inflight.get(inflightKey);
+        if (existingInflight) {
+            return existingInflight.promise;
+        }
+        const requestGeneration = bucket?.generation;
+        const promise = request()
+            .then((result) => {
+            if (bucket && cache && bucket.generation === requestGeneration) {
+                if (kind === 'list') {
+                    if (cache.size >= MAX_LEADERBOARD_LIST_CACHE_ENTRIES) {
+                        cache.delete(cache.keys().next().value);
+                    }
+                }
+                else {
+                    cache.clear();
+                }
+                cache.set(cacheKey, {
+                    expiresAt: Date.now() + LEADERBOARD_READ_CACHE_TTL_MS,
+                    value: result,
+                });
+            }
+            return result;
+        })
+            .finally(() => {
+            if (inflight.get(inflightKey)?.promise === promise) {
+                inflight.delete(inflightKey);
+            }
+            if (bucket) {
+                removeEmptyBucket(bucketKey, bucket);
+            }
+        });
+        inflight.set(inflightKey, { bucketKey, promise });
+        return promise;
+    }
+    function invalidateMutableReads(bucketKey) {
+        invalidateInflight(bucketKey);
+        const bucket = buckets.get(bucketKey);
+        if (!bucket) {
+            return;
+        }
+        bucket.generation += 1;
+        bucket.caches.list.clear();
+        bucket.caches.current.clear();
+    }
+    function invalidateInflight(bucketKey) {
+        inflight.forEach((entry, inflightKey) => {
+            if (entry.bucketKey === bucketKey) {
+                inflight.delete(inflightKey);
+            }
+        });
+    }
+    function pruneExpiredBuckets() {
+        const now = Date.now();
+        for (const [bucketKey, bucket] of buckets) {
+            removeExpiredCacheEntries(bucket, now);
+            if (isBucketEmpty(bucketKey, bucket)) {
+                buckets.delete(bucketKey);
+            }
+        }
+    }
+    function removeEmptyBucket(bucketKey, bucket) {
+        removeExpiredCacheEntries(bucket, Date.now());
+        if (buckets.get(bucketKey) === bucket && isBucketEmpty(bucketKey, bucket)) {
+            buckets.delete(bucketKey);
+        }
+    }
+    function removeExpiredCacheEntries(bucket, now) {
+        Object.values(bucket.caches).forEach((cache) => {
+            cache.forEach((entry, cacheKey) => {
+                if (entry.expiresAt <= now) {
+                    cache.delete(cacheKey);
+                }
+            });
+        });
+    }
+    function isBucketEmpty(bucketKey, bucket) {
+        return !hasInflight(bucketKey) && Object.values(bucket.caches).every(cache => cache.size === 0);
+    }
+    function hasInflight(bucketKey) {
+        for (const entry of inflight.values()) {
+            if (entry.bucketKey === bucketKey) {
+                return true;
+            }
+        }
+        return false;
+    }
+    return {
+        read,
+        invalidateMutableReads,
+    };
+}
+function createLeaderboardBucketKey(options, key) {
+    return JSON.stringify([options.identity?.miniProgramId ?? null, key ?? DEFAULT_LEADERBOARD_KEY]);
+}
+function createLeaderboardCacheKey(kind, ...parts) {
+    return JSON.stringify([kind, ...parts]);
+}
+function createLeaderboardInflightKey(bucketKey, cacheKey) {
+    return JSON.stringify([bucketKey, cacheKey]);
+}
 function readLeaderboardPayload(payload, methodName, shape) {
     if (payload === undefined && shape !== 'submit') {
         return shape === 'list' ? { limit: DEFAULT_LEADERBOARD_LIST_LIMIT } : {};
@@ -4379,15 +4541,17 @@ async function isMiniProgramShareDevelopmentRuntime(platformAdapter) {
 }
 
 /** 截图并唤起分享。 */
-function shareMiniProgramRuntimeScreenshot(payload, platformAdapter) {
+function shareMiniProgramRuntimeScreenshot(payload, platformAdapter, context = {}) {
     const options = readMiniProgramScreenshotOptions(payload);
     const rect = options.rect || getMiniProgramRuntimeViewportRect(platformAdapter);
     const postResult = readMiniProgramRuntimeSharePostOptions(payload && typeof payload === 'object' ? payload.post : undefined, { method: 'share.screenshot' });
+    const sourceMiniProgramId = context.miniProgramId?.trim() || undefined;
     return handleMiniProgramRuntimeSharePostValidation(postResult, platformAdapter, (post) => platformAdapter.share.shareScreenshot({
         rect,
         delay: options.delay,
         saveToAlbum: options.saveToAlbum,
         post,
+        ...(sourceMiniProgramId ? { sourceMiniProgramId } : {}),
     }));
 }
 function readMiniProgramScreenshotOptions(payload) {
@@ -5349,8 +5513,10 @@ function createBrowserMockRuntimePlatformAdapter(options) {
             isDevRuntime: () => true,
         },
         launch: {
-            async getMiniProgramInfo() {
+            async getMiniProgramInfo(miniProgramId) {
+                // 与生产一致：启动详情返回的 canonical ID 作为可信身份，而非直接信任宿主 URL。
                 return {
+                    miniProgramId,
                     pageUrl: options.getMiniProgramPageUrl(),
                 };
             },
@@ -5501,6 +5667,10 @@ class MiniProgramMockRuntime {
         this.vibrates = [];
         this.openAppPages = [];
         this.evaluateRuntimePermission = createMiniProgramRuntimePermissionEvaluator(options.runtimePermissions);
+        this.leaderboardHandlers = createMiniProgramRuntimeLeaderboardHandlers({
+            identity: options.identity,
+            platformAdapter: adapter,
+        });
     }
     async runMethod(method, payload) {
         if (!isMiniProgramMockRuntimeMethod(method)) {
@@ -5598,10 +5768,21 @@ class MiniProgramMockRuntime {
             : undefined;
     }
     showShareMenu(payload) {
-        return showMiniProgramRuntimeShareMenu(payload, this.adapter, readMockRuntimeShareContext(this.adapter.app.getCurrentHref()));
+        return showMiniProgramRuntimeShareMenu(payload, this.adapter, this.getShareContext());
     }
     shareScreenshot(payload) {
-        return shareMiniProgramRuntimeScreenshot(payload, this.adapter);
+        return shareMiniProgramRuntimeScreenshot(payload, this.adapter, this.getShareContext());
+    }
+    getShareContext() {
+        if (this.options.identity) {
+            return {
+                miniProgramId: this.options.identity.miniProgramId?.trim() || undefined,
+                miniProgramVersion: this.options.identity.miniProgramVersion?.trim() || undefined,
+            };
+        }
+        // Mock host 由开发者控制：其 URL 启动参数等价于生产中的启动详情绑定，
+        // 不是 iframe payload。生产 runtime 路径不会信任未绑定的宿主 URL 参数。
+        return readMockHostShareContext(this.adapter.app.getCurrentHref());
     }
     getWindowInfo() {
         return getMiniProgramRuntimeWindowInfo(this.adapter);
@@ -5619,19 +5800,19 @@ class MiniProgramMockRuntime {
         return requestMiniProgramRuntimeNetwork(payload, this.adapter);
     }
     submitLeaderboardEntry(payload) {
-        return submitMiniProgramRuntimeLeaderboardEntry(payload, { platformAdapter: this.adapter });
+        return this.leaderboardHandlers.submit(payload);
     }
     getLeaderboardList(payload) {
-        return getMiniProgramRuntimeLeaderboardList(payload, { platformAdapter: this.adapter });
+        return this.leaderboardHandlers.getList(payload);
     }
     getCurrentUserLeaderboardEntry(payload) {
-        return getMiniProgramRuntimeCurrentUserLeaderboardEntry(payload, { platformAdapter: this.adapter });
+        return this.leaderboardHandlers.getCurrentUserEntry(payload);
     }
     deleteCurrentUserLeaderboardEntry(payload) {
-        return deleteMiniProgramRuntimeCurrentUserLeaderboardEntry(payload, { platformAdapter: this.adapter });
+        return this.leaderboardHandlers.deleteCurrentUserEntry(payload);
     }
     getLeaderboardInfo(payload) {
-        return getMiniProgramRuntimeLeaderboardInfo(payload, { platformAdapter: this.adapter });
+        return this.leaderboardHandlers.getInfo(payload);
     }
     async showToast(payload) {
         const toast = readShowToastPayload(payload);
@@ -5724,12 +5905,18 @@ class MiniProgramMockRuntime {
         this.records.splice(30);
     }
 }
-function readMockRuntimeShareContext(href) {
+/**
+ * 读取 mock host 自身 URL 上的启动参数作为可信分享上下文。
+ * 与生产 runtime 不同：生产只信任启动详情回填的 canonical ID；
+ * mock host 页面本身由开发者控制，因此允许从 host URL 读取，
+ * 用于本地联调，且始终忽略 iframe 业务 payload 中的伪造字段。
+ */
+function readMockHostShareContext(href) {
     try {
         const currentUrl = new URL(href);
         return {
-            miniProgramId: currentUrl.searchParams.get('mini_program_id') || undefined,
-            miniProgramVersion: currentUrl.searchParams.get('miniprogram_version') || undefined,
+            miniProgramId: currentUrl.searchParams.get('mini_program_id')?.trim() || undefined,
+            miniProgramVersion: currentUrl.searchParams.get('miniprogram_version')?.trim() || undefined,
         };
     }
     catch {

package/dist/index.cjs.js

@@ -325,7 +325,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.6.6';
+    : '0.6.7-alpha.1';
 
 /**
  * 判断未知数据是否符合小程序 bridge 消息信封。

package/dist/index.esm.js

@@ -321,7 +321,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.6.6';
+    : '0.6.7-alpha.1';
 
 /**
  * 判断未知数据是否符合小程序 bridge 消息信封。

package/dist/vite.cjs.js

@@ -8,7 +8,7 @@ var _documentCurrentScript = typeof document !== 'undefined' ? document.currentS
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.6.6';
+    : '0.6.7-alpha.1';
 
 var re = {exports: {}};
 

package/dist/vite.esm.js

@@ -5,7 +5,7 @@ import { AsyncLocalStorage } from 'node:async_hooks';
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.6.6';
+    : '0.6.7-alpha.1';
 
 var re = {exports: {}};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.6.6",
+  "version": "0.6.7-alpha.1",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.6.6`
+- Version at generation time: `0.6.7-alpha.1`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`
@@ -579,7 +579,7 @@ await share.screenshot({
 });
 ```
 
-截图分享支持多个预置分区；分区与话题仍由用户在客户端发帖页中确认和修改，SDK 不会直接发布内容。
+截图分享支持多个预置分区；分区与话题仍由用户在客户端发帖页中确认和修改，SDK 不会直接发布内容。通过截图分享进入社区发帖流程时，客户端会自动把帖子关联到当前小程序，开发者无需配置额外来源字段。
 
 ### 基础 UI
 

package/skill/references/recipes.md

@@ -385,7 +385,7 @@ await share.showShareMenu({
 
 ## 截图分享
 
-截图分享可以预置多个分区，客户端发帖页负责最终选择与确认。
+截图分享可以预置多个分区，客户端发帖页负责最终选择与确认。进入社区发帖流程后，客户端会自动把帖子关联到当前小程序，开发者无需配置额外来源字段。
 
 ```ts
 await share.screenshot({

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.6.6+skill.ec6411dd6834",
+  "skillVersion": "0.6.7-alpha.1+skill.00dab20ae3bc",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.6.6",
-    "compatibility": "0.6.6"
+    "version": "0.6.7-alpha.1",
+    "compatibility": "0.6.7-alpha.1"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-ec6411dd683403ca3e7e92ed169848274d6d7a7492759cbedfc38fb4b866e23a"
+  "integrity": "sha256-00dab20ae3bceff225037abb08cf86b24daee2d7b2002aa90e720492ef8b58f8"
 }