@heybox/hb-sdk 0.9.5-alpha.0 → 0.9.5-alpha.2

package/dist/cli-chunks/{index-DBPhVlCg.cjs → index-CS6WpCn8.cjs}

@@ -17,6 +17,8 @@ var require$$0$7 = require('constants');
 var fs$3 = require('node:fs');
 var fs$2 = require('node:fs/promises');
 var node_zlib = require('node:zlib');
+var promises = require('node:readline/promises');
+var promises$1 = require('node:timers/promises');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -238,19 +240,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-DBPhVlCg.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-CS6WpCn8.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-DBPhVlCg.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-CS6WpCn8.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-DBPhVlCg.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-CS6WpCn8.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-DBPhVlCg.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-CS6WpCn8.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-DBPhVlCg.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-CS6WpCn8.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -16259,9 +16261,9 @@ class AuthSessionError extends Error {
     }
 }
 const AUTH_CACHE_VERSION = 1;
-const paths$1 = envPaths('hb-sdk', { suffix: '' });
+const paths$2 = envPaths('hb-sdk', { suffix: '' });
 function getAuthCacheFilePath(options = {}) {
-    return options.cacheFile ?? path.join(paths$1.cache, 'auth.json');
+    return options.cacheFile ?? path.join(paths$2.cache, 'auth.json');
 }
 function createHeyboxAuthSession(payload, options = {}) {
     return {
@@ -16386,7 +16388,7 @@ function createCookie(name, value) {
     return `${name}=${value}`;
 }
 function isHeyboxAuthSession(value) {
-    if (!isRecord(value)) {
+    if (!isRecord$1(value)) {
         return false;
     }
     return (typeof value.heyboxId === 'string' &&
@@ -16412,7 +16414,7 @@ function normalizeHeyboxAuthSession(session) {
     return normalized;
 }
 function normalizeSelectedDeveloperEntitySnapshot(value) {
-    if (!isRecord(value)) {
+    if (!isRecord$1(value)) {
         return undefined;
     }
     if (typeof value.entityId !== 'number' || !Number.isFinite(value.entityId)) {
@@ -16434,7 +16436,7 @@ function normalizeSelectedDeveloperEntitySnapshot(value) {
         selectedAt: value.selectedAt,
     };
 }
-function isRecord(value) {
+function isRecord$1(value) {
     return Object.prototype.toString.call(value) === '[object Object]';
 }
 
@@ -17249,7 +17251,7 @@ async function inspectFeedbackLog(file, size) {
     return { mimeType: 'text/plain', width: 0, height: 0 };
 }
 async function createFeedbackCosClient(getToken) {
-    const { default: COS } = await Promise.resolve().then(function () { return require('./index-grzaqQfA.cjs'); }).then(function (n) { return n.index; });
+    const { default: COS } = await Promise.resolve().then(function () { return require('./index-_1anHmAG.cjs'); }).then(function (n) { return n.index; });
     const cos = new COS({
         getAuthorization(_options, callback) {
             void getToken().then((token) => callback({
@@ -20449,6 +20451,461 @@ function installDevLogCommands(dev) {
     }
 }
 
+const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
+const BUILT_CLI_VERSION = '0.9.5-alpha.2';
+const PACKAGE_JSON_CANDIDATES$1 = [
+    path.resolve(__dirname, '..', '..', 'package.json'),
+    path.resolve(__dirname, '..', 'package.json'),
+    path.resolve(__dirname, '..', '..', '..', 'package.json'),
+];
+function getCliVersion(packageJsonCandidates = PACKAGE_JSON_CANDIDATES$1) {
+    if (BUILT_CLI_VERSION !== CLI_VERSION_PLACEHOLDER) {
+        return BUILT_CLI_VERSION;
+    }
+    return readCurrentSdkVersion$1(packageJsonCandidates);
+}
+function readCurrentSdkVersion$1(packageJsonCandidates) {
+    for (const candidate of packageJsonCandidates) {
+        if (!pathExists$1(candidate)) {
+            continue;
+        }
+        const packageJson = JSON.parse(fs$3.readFileSync(candidate, 'utf8'));
+        if (typeof packageJson.version === 'string' && packageJson.version) {
+            return packageJson.version;
+        }
+    }
+    throw new Error('未能读取 @heybox/hb-sdk 当前版本号');
+}
+function pathExists$1(filePath) {
+    try {
+        fs$3.accessSync(filePath, fs$3.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+const DEPLOY_LOCKED_MESSAGE = '当前设备已有同版本产物正在上传，请等待完成后重试';
+const DEPLOY_LOCK_DIRECTORY_NAME = 'deploy-locks';
+const DEPLOY_LOCK_OWNER_FILE = 'owner.json';
+const INCOMPLETE_LOCK_GRACE_MS = 30_000;
+const defaultPaths = envPaths('hb-sdk', { suffix: '' });
+class DeployLockConflictError extends Error {
+}
+async function withDeployLock(scope, operation, options = {}) {
+    let lock;
+    try {
+        lock = await acquireDeployLock(scope, options);
+    }
+    catch (error) {
+        if (error instanceof DeployLockConflictError) {
+            throw error;
+        }
+        // 本地文件锁只减少重复操作，文件系统异常不阻断服务端上传流程。
+        return operation();
+    }
+    try {
+        return await operation();
+    }
+    finally {
+        await lock.release().catch(() => undefined);
+    }
+}
+async function acquireDeployLock(scope, options = {}) {
+    const lockDirectory = getDeployLockDirectory(scope, options.cacheRoot);
+    return acquireLocalLock(lockDirectory, options);
+}
+/** 配置文件复用相同的进程归属和崩溃回收机制；调用方决定是否等待锁。 */
+async function acquireLocalFileLock(file) {
+    return acquireLocalLock(`${file}.lock`, {});
+}
+async function acquireLocalLock(lockDirectory, options) {
+    const ownerFile = path.join(lockDirectory, DEPLOY_LOCK_OWNER_FILE);
+    const owner = {
+        version: 1,
+        pid: options.pid ?? process.pid,
+        token: options.token ?? node_crypto.randomBytes(16).toString('hex'),
+    };
+    await fs$2.mkdir(path.dirname(lockDirectory), { recursive: true, mode: 0o700 });
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        let created = false;
+        try {
+            await fs$2.mkdir(lockDirectory, { mode: 0o700 });
+            created = true;
+            await fs$2.writeFile(ownerFile, `${JSON.stringify(owner)}\n`, { encoding: 'utf8', mode: 0o600 });
+            return createDeployLock(lockDirectory, ownerFile, owner.token);
+        }
+        catch (error) {
+            if (created) {
+                await fs$2.rm(lockDirectory, { force: true, recursive: true });
+                throw error;
+            }
+            if (!isNodeError(error) || error.code !== 'EEXIST') {
+                throw error;
+            }
+            if (!(await canReclaimDeployLock(lockDirectory, ownerFile, options))) {
+                throw new DeployLockConflictError(DEPLOY_LOCKED_MESSAGE);
+            }
+            await reclaimDeployLock(lockDirectory, owner.token);
+        }
+    }
+    throw new DeployLockConflictError(DEPLOY_LOCKED_MESSAGE);
+}
+function getDeployLockDirectory(scope, cacheRoot = defaultPaths.cache) {
+    const scopeHash = node_crypto.createHash('sha256').update(`${scope.apiBaseUrl}\0${scope.miniProgramId}\0${scope.version}`).digest('hex');
+    return path.join(cacheRoot, DEPLOY_LOCK_DIRECTORY_NAME, scopeHash);
+}
+function createDeployLock(lockDirectory, ownerFile, token) {
+    let released = false;
+    return {
+        async release() {
+            if (released)
+                return;
+            released = true;
+            await removeOwnedLock(lockDirectory, ownerFile, token);
+        },
+    };
+}
+async function canReclaimDeployLock(lockDirectory, ownerFile, options) {
+    const owner = await readDeployLockOwner(ownerFile);
+    if (owner) {
+        return !(options.isProcessRunning ?? isProcessRunning)(owner.pid);
+    }
+    try {
+        const lockStat = await fs$2.stat(lockDirectory);
+        return (options.now ?? Date.now)() - lockStat.mtimeMs >= INCOMPLETE_LOCK_GRACE_MS;
+    }
+    catch (error) {
+        return isNodeError(error) && error.code === 'ENOENT';
+    }
+}
+async function removeOwnedLock(lockDirectory, ownerFile, token) {
+    const owner = await readDeployLockOwner(ownerFile);
+    if (owner?.token === token) {
+        await fs$2.rm(lockDirectory, { force: true, recursive: true });
+    }
+}
+async function reclaimDeployLock(lockDirectory, token) {
+    const reclaimDirectory = `${lockDirectory}.reclaim-${node_crypto.createHash('sha256').update(token).digest('hex')}`;
+    try {
+        await fs$2.rename(lockDirectory, reclaimDirectory);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    await fs$2.rm(reclaimDirectory, { force: true, recursive: true });
+}
+async function readDeployLockOwner(ownerFile) {
+    try {
+        const value = JSON.parse(await fs$2.readFile(ownerFile, 'utf8'));
+        return isDeployLockOwner(value) ? value : null;
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT')
+            return null;
+        if (error instanceof SyntaxError)
+            return null;
+        throw error;
+    }
+}
+function isDeployLockOwner(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.version === 1 &&
+        Number.isInteger(value.pid) &&
+        typeof value.token === 'string');
+}
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !isNodeError(error) || error.code !== 'ESRCH';
+    }
+}
+function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+
+/** npm 版本检查和已批准更新提醒共用的缓存周期。 */
+const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
+function isUpdateCheckCacheFresh(checkedAt, now) {
+    if (typeof checkedAt !== 'string')
+        return false;
+    const elapsed = now.getTime() - Date.parse(checkedAt);
+    return Number.isFinite(elapsed) && elapsed >= 0 && elapsed < UPDATE_CHECK_TTL_MS;
+}
+
+const RELEASE_HIGHLIGHT_CACHE_VERSION = 4;
+const DEFAULT_TIMEOUT_MS$1 = 1000;
+const RELEASE_HIGHLIGHT_CACHE_FILE = 'release-highlight.json';
+const UPDATES_URL = 'https://activity.xiaoheihe.cn/u/hb-sdk/approved-notice.json';
+const paths$1 = envPaths('hb-sdk', { suffix: '' });
+async function printReleaseHighlight(options = {}) {
+    try {
+        const logger = options.logger ?? createCliLogger({ stderr: options.stderr });
+        // 机器调用和 CI 不输出提醒，Agent 通过 Skill 读取更新日志。
+        if (!logger.isInteractive) {
+            return;
+        }
+        const notice = await getReleaseHighlight(options);
+        if (notice) {
+            // 展示即记录当天日期；内容缓存刷新、切换项目或中断确认都不会重复提醒。
+            if (!(await recordReleaseHighlightShown(notice.version, options)))
+                return;
+            const useColor = (options.env ?? process.env).NO_COLOR !== '1';
+            logger.raw(formatReleaseHighlight(notice, useColor, options.currentVersion ?? getCliVersion()), { stream: 'stderr' });
+            const ask = options.promptDismiss ?? (() => promptDismiss(useColor));
+            if ((options.promptDismiss || process.stdin.isTTY) && await ask()) {
+                await dismissReleaseHighlight(notice.version, options);
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof CommanderError)
+            throw error;
+        // 更新提醒不能影响实际执行的 hb-sdk 命令。
+    }
+}
+async function getReleaseHighlight(options = {}) {
+    const env = options.env ?? process.env;
+    if (env.HB_SDK_NO_UPDATE_CHECK === '1' || env.CI === 'true') {
+        return null;
+    }
+    const now = options.now?.() ?? new Date();
+    const cacheFile = options.cacheFile ?? path.join(paths$1.cache, RELEASE_HIGHLIGHT_CACHE_FILE);
+    let cache = await readFreshCache(cacheFile, now);
+    if (!cache) {
+        let release;
+        try {
+            release = await fetchLatestRelease(options);
+        }
+        catch {
+            // 与原 npm 检查一致：失败也缓存本次检查时间，24 小时后再检查。
+        }
+        cache = {
+            version: RELEASE_HIGHLIGHT_CACHE_VERSION,
+            checkedAt: now.toISOString(),
+            ...(release ? { release } : {}),
+        };
+        await writeCache(cacheFile, cache).catch(() => undefined);
+    }
+    const notice = createNotice(cache.release);
+    if (!notice)
+        return null;
+    return await isReleaseHighlightSuppressed(notice.version, options) ? null : notice;
+}
+function formatReleaseHighlight(notice, useColor = false, currentVersion) {
+    const label = currentVersion && semverExports.valid(currentVersion) && semverExports.valid(notice.version) && semverExports.gt(currentVersion, notice.version)
+        ? '行为变更，已升级版本请核对' : '行为变更，请关注';
+    const colors = pc.createColors(useColor);
+    const divider = colors.yellow('─'.repeat(40));
+    return [
+        '',
+        divider,
+        colors.bold(colors.yellow(`⚠ hb-sdk ${notice.version} · ${label}`)),
+        '',
+        plainNoticeText(cleanTerminalText(notice.text)),
+        colors.cyan(`详情：${cleanTerminalText(notice.url)}`),
+        divider,
+    ].join('\n');
+}
+function formatReleaseHighlightPrompt(useColor = false) {
+    const colors = pc.createColors(useColor);
+    return `${colors.bold(colors.green('[y + 回车]'))} 知道了，此版本公告不再提醒\n${colors.bold('[直接回车]')} 继续，今天不再提醒\n请选择：`;
+}
+function createNotice(release) {
+    if (!release?.body.trim())
+        return null;
+    return { version: release.version, text: release.body, url: release.url };
+}
+async function fetchLatestRelease(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? DEFAULT_TIMEOUT_MS$1);
+    try {
+        const response = await fetchImpl(options.updatesUrl ?? UPDATES_URL, {
+            headers: {
+                accept: 'application/json',
+            },
+            signal: controller.signal,
+        });
+        if (response.status === 404)
+            return undefined;
+        if (!response.ok) {
+            throw new Error(`hb-sdk updates returned ${response.status}`);
+        }
+        return parseLatestRelease(await response.json());
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function parseLatestRelease(payload) {
+    if (!isRecord(payload) || typeof payload.version !== 'string' || !/^\d+\.\d+\.\d+$/.test(payload.version) ||
+        typeof payload.date !== 'string' || typeof payload.body !== 'string' || typeof payload.url !== 'string') {
+        throw new Error('hb-sdk CDN notice has invalid content');
+    }
+    const url = new URL(payload.url);
+    if (url.origin !== 'https://docs.xiaoheihe.cn' || !url.pathname.startsWith('/hb_sdk/') ||
+        url.username || url.password || /[\x00-\x1f\x7f-\x9f]/.test(payload.url)) {
+        throw new Error('hb-sdk CDN notice has invalid URL');
+    }
+    return { version: payload.version, date: payload.date, body: cleanTerminalText(payload.body), url: url.href };
+}
+async function readFreshCache(cacheFile, now) {
+    try {
+        const parsed = JSON.parse(await fs$2.readFile(cacheFile, 'utf8'));
+        if (parsed.version !== RELEASE_HIGHLIGHT_CACHE_VERSION || !isUpdateCheckCacheFresh(parsed.checkedAt, now)) {
+            return null;
+        }
+        return {
+            ...parsed,
+            ...(parsed.release ? { release: parseLatestRelease(parsed.release) } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCache(cacheFile, cache) {
+    await fs$2.mkdir(path.dirname(cacheFile), { recursive: true });
+    await fs$2.writeFile(cacheFile, JSON.stringify(cache, null, 2), 'utf8');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function dismissalFile(options) {
+    return options.dismissedFile ?? path.join(paths$1.config, 'release-highlight-dismissed.json');
+}
+async function readState(options) {
+    try {
+        const data = JSON.parse(await fs$2.readFile(dismissalFile(options), 'utf8'));
+        if (isRecord(data) && data.version === 1 && Array.isArray(data.dismissedVersions) && isRecord(data.lastShownDates)) {
+            return {
+                version: 1,
+                dismissedVersions: data.dismissedVersions.filter((value) => typeof value === 'string'),
+                lastShownDates: Object.fromEntries(Object.entries(data.lastShownDates).filter((entry) => typeof entry[1] === 'string')),
+            };
+        }
+    }
+    catch {
+        // 配置缺失或损坏时按首次提醒处理，不影响主命令。
+    }
+    return { version: 1, dismissedVersions: [], lastShownDates: {} };
+}
+async function dismissReleaseHighlight(version, options = {}) {
+    await updateState(options, (state) => {
+        state.dismissedVersions = [...new Set([...state.dismissedVersions, version])];
+    });
+}
+async function recordReleaseHighlightShown(version, options) {
+    try {
+        return await updateState(options, (state) => {
+            const date = localDate(options.now?.() ?? new Date());
+            if (state.dismissedVersions.includes(version) || state.lastShownDates[version] === date)
+                return false;
+            state.lastShownDates[version] = date;
+            return true;
+        });
+    }
+    catch {
+        // 无法记录时仍允许展示；主命令不依赖本机配置可写。
+        return true;
+    }
+}
+async function updateState(options, update) {
+    const deadline = Date.now() + 2000;
+    let lock;
+    while (true) {
+        try {
+            lock = await acquireLocalFileLock(dismissalFile(options));
+            break;
+        }
+        catch (error) {
+            if (!(error instanceof DeployLockConflictError) || Date.now() >= deadline)
+                throw error;
+            await promises$1.setTimeout(20);
+        }
+    }
+    try {
+        const state = await readState(options);
+        const result = update(state);
+        await writeState(state, options);
+        return result;
+    }
+    finally {
+        await lock.release().catch(() => undefined);
+    }
+}
+function localDate(date) {
+    return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;
+}
+async function writeState(state, options) {
+    const file = dismissalFile(options);
+    await fs$2.mkdir(path.dirname(file), { recursive: true });
+    const temporary = `${file}.${process.pid}.${node_crypto.randomUUID()}.tmp`;
+    try {
+        await fs$2.writeFile(temporary, JSON.stringify(state), 'utf8');
+        await fs$2.rename(temporary, file);
+    }
+    finally {
+        await fs$2.unlink(temporary).catch(() => undefined);
+    }
+}
+async function promptDismiss(useColor) {
+    const prompt = promises.createInterface({ input: process.stdin, output: process.stderr });
+    const controller = new AbortController();
+    const cancel = () => controller.abort();
+    prompt.once('SIGINT', cancel);
+    prompt.once('close', cancel);
+    process.once('SIGINT', cancel);
+    try {
+        const answer = await prompt.question(formatReleaseHighlightPrompt(useColor), { signal: controller.signal });
+        return answer.trim().toLowerCase() === 'y';
+    }
+    catch (error) {
+        if (controller.signal.aborted)
+            throw new CommanderError(130, 'hb-sdk.cancelled', '已取消');
+        throw error;
+    }
+    finally {
+        process.removeListener('SIGINT', cancel);
+        prompt.removeListener('SIGINT', cancel);
+        prompt.removeListener('close', cancel);
+        prompt.close();
+    }
+}
+function cleanTerminalText(text) {
+    // 去除 ANSI/OSC 序列及其他终端控制字符；换行和制表符保留给摘要折叠。
+    return text.replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
+        .replace(/(?:\x1b\[|\x9b)[0-?]*[ -/]*[@-~]/g, '')
+        .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f-\x9f]/g, '');
+}
+/** 终端不渲染 Markdown：去掉标记、链接保留地址；篇幅由 notices 撰写者控制，这里不截断。 */
+function plainNoticeText(markdown) {
+    return markdown
+        .replace(/^[ \t]*(```|~~~).*\n?/gm, '')
+        .replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, '$1（$2）')
+        .replace(/`([^`]+)`/g, '$1')
+        .replace(/\*\*([^*]+)\*\*/g, '$1')
+        .replace(/^#{1,6}[ \t]+/gm, '')
+        .trim();
+}
+/** 已确认或当天已经展示的重点公告不重复输出。 */
+async function isReleaseHighlightSuppressed(version, options = {}) {
+    const state = await readState(options);
+    return state.dismissedVersions.includes(version) || state.lastShownDates[version] === localDate(options.now?.() ?? new Date());
+}
+/** 普通升级提示仅按当天已展示的公告去重，确认公告不影响后续升级提醒。 */
+async function isReleaseHighlightShownToday(version, options = {}) {
+    return (await readState(options)).lastShownDates[version] === localDate(options.now?.() ?? new Date());
+}
+
 const HB_SDK_PACKAGE_NAME = '@heybox/hb-sdk';
 const HB_SDK_SKILL_NAME = 'hb-sdk';
 /**
@@ -20470,13 +20927,12 @@ function createSkillContentHash(fileEntries) {
 }
 
 const UPDATE_CHECK_CACHE_VERSION = 1;
-const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
 const DEFAULT_TIMEOUT_MS = 1500;
 const UPDATE_CHECK_CACHE_FILE = 'update-check.json';
 const NPM_REGISTRY_URL = `https://registry.npmjs.org/${encodeURIComponent(HB_SDK_PACKAGE_NAME)}`;
 const PUBLIC_CHANGELOG_URL = 'https://docs.xiaoheihe.cn/hb_sdk/changelog/';
 const paths = envPaths('hb-sdk', { suffix: '' });
-const PACKAGE_JSON_CANDIDATES$1 = [
+const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', 'package.json'),
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', '..', '..', 'package.json'),
@@ -20484,7 +20940,7 @@ const PACKAGE_JSON_CANDIDATES$1 = [
 async function printUpdateReminder(options = {}) {
     try {
         const reminder = await getUpdateReminder(options);
-        if (!reminder) {
+        if (!reminder || await isReleaseHighlightShownToday(reminder.latestVersion, { dismissedFile: options.dismissedFile, now: options.now })) {
             return;
         }
         const logger = options.logger ??
@@ -20538,7 +20994,7 @@ async function getUpdateReminder(options = {}) {
         return null;
     }
     const now = options.now?.() ?? new Date();
-    const currentVersion = options.currentVersion ?? (await readCurrentSdkVersion$1(options.packageJsonFiles));
+    const currentVersion = options.currentVersion ?? (await readCurrentSdkVersion(options.packageJsonFiles));
     const cached = options.forceRefresh ? null : await readFreshUpdateCheckCache(getUpdateCheckCacheFilePath(options), now);
     if (cached) {
         return createUpdateReminder(currentVersion, cached.latestVersion);
@@ -20596,14 +21052,13 @@ async function readFreshUpdateCheckCache(cacheFile, now) {
     if (!cache) {
         return null;
     }
-    const checkedAt = Date.parse(cache.checkedAt);
-    if (!Number.isFinite(checkedAt) || now.getTime() - checkedAt >= UPDATE_CHECK_TTL_MS) {
+    if (!isUpdateCheckCacheFresh(cache.checkedAt, now)) {
         return null;
     }
     return cache;
 }
 async function readUpdateCheckCache(cacheFile) {
-    if (!(await pathExists$1(cacheFile))) {
+    if (!(await pathExists(cacheFile))) {
         return null;
     }
     try {
@@ -20651,9 +21106,9 @@ async function fetchLatestVersion(options) {
         clearTimeout(timeout);
     }
 }
-async function readCurrentSdkVersion$1(packageJsonCandidates = PACKAGE_JSON_CANDIDATES$1) {
+async function readCurrentSdkVersion(packageJsonCandidates = PACKAGE_JSON_CANDIDATES) {
     for (const candidate of packageJsonCandidates) {
-        if (!(await pathExists$1(candidate))) {
+        if (!(await pathExists(candidate))) {
             continue;
         }
         const packageJson = JSON.parse(await fs$2.readFile(candidate, 'utf8'));
@@ -20739,7 +21194,7 @@ function comparePrereleaseIdentifier(left, right) {
 function isNumericPrereleaseIdentifier(value) {
     return /^\d+$/.test(value);
 }
-async function pathExists$1(filePath) {
+async function pathExists(filePath) {
     try {
         await fs$2.access(filePath, fs$3.constants.F_OK);
         return true;
@@ -20899,41 +21354,6 @@ function readEnvNameArgFromArgv(argv) {
     return undefined;
 }
 
-const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.9.5-alpha.0';
-const PACKAGE_JSON_CANDIDATES = [
-    path.resolve(__dirname, '..', '..', 'package.json'),
-    path.resolve(__dirname, '..', 'package.json'),
-    path.resolve(__dirname, '..', '..', '..', 'package.json'),
-];
-function getCliVersion(packageJsonCandidates = PACKAGE_JSON_CANDIDATES) {
-    if (BUILT_CLI_VERSION !== CLI_VERSION_PLACEHOLDER) {
-        return BUILT_CLI_VERSION;
-    }
-    return readCurrentSdkVersion(packageJsonCandidates);
-}
-function readCurrentSdkVersion(packageJsonCandidates) {
-    for (const candidate of packageJsonCandidates) {
-        if (!pathExists(candidate)) {
-            continue;
-        }
-        const packageJson = JSON.parse(fs$3.readFileSync(candidate, 'utf8'));
-        if (typeof packageJson.version === 'string' && packageJson.version) {
-            return packageJson.version;
-        }
-    }
-    throw new Error('未能读取 @heybox/hb-sdk 当前版本号');
-}
-function pathExists(filePath) {
-    try {
-        fs$3.accessSync(filePath, fs$3.constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-
 async function runCli(options = {}) {
     const processLike = options.process ?? process;
     const argv = options.argv ?? process.argv;
@@ -20960,6 +21380,7 @@ function createCliProgram(overrides = {}) {
         clearLoginStatus: defaultClearLoginStatus,
         loginToHeybox: defaultLoginToHeybox,
         printLoginStatus: defaultPrintLoginStatus,
+        printReleaseHighlight: printReleaseHighlight,
         printUpdateReminder: printUpdateReminder,
         runBuildCommand: defaultRunBuildCommand,
         runCreateCommand: defaultRunCreateCommand,
@@ -20982,6 +21403,18 @@ function createCliProgram(overrides = {}) {
         .showHelpAfterError()
         .exitOverride();
     installVersionUpdateReminder(program, handlers.printUpdateReminder, resolveLogger);
+    program.hook('preAction', async (_program, command) => {
+        if (readCommandOptionsWithAncestors(command).json)
+            return;
+        try {
+            await handlers.printReleaseHighlight({ logger: resolveLogger(command) });
+        }
+        catch (error) {
+            if (error instanceof CommanderError)
+                throw error;
+            // 公告获取或展示失败不能阻断命令；交互环境判断由展示模块统一执行。
+        }
+    });
     addVerboseOption(program.command('create').description('创建外部小程序项目开发模板').argument('<project-name>', '项目目录名，例如 my-miniapp')).action(withUpdateReminder(async (projectName, _options, command) => {
         const logger = resolveLogger(command);
         await handlers.runCreateCommand(projectName, { logger });
@@ -21284,39 +21717,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DqP3MO5K.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-Bk3T3PMe.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DqP3MO5K.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-Bk3T3PMe.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DqP3MO5K.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-Bk3T3PMe.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-D7fJ6BEA.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-D6tP7Uje.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-B-Jsz3ik.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-BBXC3wLI.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-y8113QN9.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-XoWrqt1g.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-BhKqJsAC.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-Cuc3EQQ8.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunSkillInstallCommand = async (...args) => {
-    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-Fhveb4OH.cjs'); });
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-BGxlDR-g.cjs'); });
     return runSkillInstallCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-Bx-Pz3E9.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-Dfg2HLIt.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {
@@ -21408,13 +21841,15 @@ function parseNonNegativeInteger(value) {
     return parsed;
 }
 const defaultRunGameSearchCommand = async (...args) => {
-    const { runGameSearchCommand } = await Promise.resolve().then(function () { return require('./games-DQx46pWD.cjs'); });
+    const { runGameSearchCommand } = await Promise.resolve().then(function () { return require('./games-CoddgAux.cjs'); });
     return runGameSearchCommand(...args);
 };
 
 exports.CliError = CliError;
+exports.DEPLOY_LOCKED_MESSAGE = DEPLOY_LOCKED_MESSAGE;
 exports.HB_SDK_PACKAGE_NAME = HB_SDK_PACKAGE_NAME;
 exports.HB_SDK_SKILL_NAME = HB_SDK_SKILL_NAME;
+exports.acquireDeployLock = acquireDeployLock;
 exports.applyMiniProgramServiceTagIfNeeded = applyMiniProgramServiceTagIfNeeded;
 exports.clearHeyboxAuthSession = clearHeyboxAuthSession;
 exports.commonjsGlobal = commonjsGlobal;
@@ -21451,4 +21886,5 @@ exports.resolveHeyboxOpenPlatformBaseUrl = resolveHeyboxOpenPlatformBaseUrl;
 exports.runCli = runCli;
 exports.semverExports = semverExports;
 exports.setSelectedDeveloperEntitySnapshot = setSelectedDeveloperEntitySnapshot;
+exports.withDeployLock = withDeployLock;
 exports.writeHeyboxAuthSession = writeHeyboxAuthSession;