@jingyi0605/codingns4dsh 0.2.0-beta.1 → 0.2.0-rc.2

package/data/build/dist/client/pwa-install-prompt.js

@@ -0,0 +1,179 @@
+/**
+ * 安装引导条。
+ *
+ * 页面早期注入的脚本已经捕获了 `beforeinstallprompt`（并暂停默认横幅），这里只
+ * 负责展示与交互：
+ * - Android/Chromium：显示“安装”按钮，点击后调用捕获到的事件；
+ * - iOS：没有安装 API，展示“分享 → 添加到主屏幕”指引；
+ * - 已安装（standalone）、回环入口、或用户关闭过 → 不显示。
+ *
+ * 样式内联并带 `env(safe-area-inset-bottom)`，避免被 Home 指示条遮住。
+ */
+import { resolveCodingNsTranslator } from './locale.js';
+export const PWA_INSTALL_DISMISS_KEY = 'codingns4dsh.pwa.installPromptDismissed';
+/** 启动安装引导条；不满足条件时不创建任何节点。 */
+export function startPwaInstallPrompt(options = {}) {
+    const hostWindow = options.window ?? globalThis;
+    const hostDocument = options.document ?? globalThis;
+    const t = resolveCodingNsTranslator(options.locale);
+    const text = options.text ?? {
+        install: t('pwaPrompt.install'),
+        hint: t('pwaPrompt.hint'),
+        dismiss: t('pwaPrompt.dismiss'),
+        iosHint: t('pwaPrompt.iosHint'),
+    };
+    let element;
+    let removeListeners;
+    const evaluate = () => {
+        const state = hostWindow.__CODINGNS_PWA__;
+        if (state === undefined)
+            return 'hidden';
+        if (state.loopback === true || state.installed === true)
+            return 'hidden';
+        if (hostWindow.__CODINGNS_PWA_PROMPT__ === undefined && state.installPromptAvailable !== true) {
+            // 没有安装事件：只有 iOS 才值得展示手把手指引。
+            return isIos(hostWindow) ? 'ios' : 'hidden';
+        }
+        return 'prompt';
+    };
+    const build = (mode) => {
+        if (hostDocument.body === undefined || typeof hostDocument.createElement !== 'function')
+            return undefined;
+        const root = hostDocument.createElement('div');
+        root.style.position = 'fixed';
+        root.style.left = '12px';
+        root.style.right = '12px';
+        // 悬浮在对话区上方，但留出输入框与安全区。
+        root.style.bottom = 'calc(16px + env(safe-area-inset-bottom, 0px))';
+        root.style.zIndex = '2147483000';
+        root.style.display = 'flex';
+        root.style.alignItems = 'center';
+        root.style.gap = '10px';
+        root.style.padding = '10px 12px';
+        root.style.borderRadius = '12px';
+        root.style.background = 'var(--dsw-alias-bg-layer-3, rgba(15, 23, 42, 0.96))';
+        root.style.color = 'var(--dsw-alias-label-primary, CanvasText)';
+        root.style.boxShadow = '0 10px 30px rgba(0, 0, 0, 0.35)';
+        root.style.fontSize = '12px';
+        root.style.lineHeight = '1.5';
+        const message = hostDocument.createElement('span');
+        message.style.flex = '1 1 auto';
+        message.style.minWidth = '0';
+        message.textContent = mode === 'ios' ? `${text.hint} ${text.iosHint}` : text.hint;
+        root.appendChild(message);
+        if (mode === 'prompt') {
+            const install = hostDocument.createElement('button');
+            install.style.flex = '0 0 auto';
+            install.style.padding = '6px 12px';
+            install.style.borderRadius = '8px';
+            install.style.border = '0';
+            install.style.cursor = 'pointer';
+            install.style.background = 'var(--dsw-alias-button-primary-fill, #3b82f6)';
+            install.style.color = '#ffffff';
+            install.textContent = text.install;
+            install.addEventListener('click', () => {
+                const prompt = hostWindow.__CODINGNS_PWA_PROMPT__;
+                if (prompt === undefined)
+                    return;
+                void prompt().then((outcome) => {
+                    options.onOutcome?.(outcome);
+                    if (outcome === 'accepted')
+                        hide();
+                    else
+                        refresh();
+                }).catch(() => undefined);
+            });
+            root.appendChild(install);
+        }
+        const dismiss = hostDocument.createElement('button');
+        dismiss.style.flex = '0 0 auto';
+        dismiss.style.padding = '6px 10px';
+        dismiss.style.borderRadius = '8px';
+        dismiss.style.border = '0';
+        dismiss.style.cursor = 'pointer';
+        dismiss.style.background = 'transparent';
+        dismiss.style.color = 'var(--dsw-alias-label-secondary, GrayText)';
+        dismiss.textContent = text.dismiss;
+        dismiss.addEventListener('click', () => {
+            markDismissed(hostWindow);
+            hide();
+        });
+        root.appendChild(dismiss);
+        return root;
+    };
+    const hide = () => {
+        removeListeners?.();
+        removeListeners = undefined;
+        if (element !== undefined) {
+            try {
+                element.remove();
+            }
+            catch {
+                try {
+                    hostDocument.body?.removeChild(element);
+                }
+                catch { /* 节点已不在文档里 */ }
+            }
+            element = undefined;
+        }
+    };
+    const refresh = () => {
+        if (isDismissed(hostWindow)) {
+            hide();
+            return false;
+        }
+        const mode = evaluate();
+        if (mode === 'hidden') {
+            hide();
+            return false;
+        }
+        if (element !== undefined)
+            return true;
+        const node = build(mode);
+        if (node === undefined)
+            return false;
+        hostDocument.body?.appendChild(node);
+        element = node;
+        const onAvailable = () => { hide(); refresh(); };
+        const onInstalled = () => { hide(); };
+        try {
+            hostWindow.addEventListener('codingns-pwa-install-available', onAvailable);
+            hostWindow.addEventListener('codingns-pwa-installed', onInstalled);
+            removeListeners = () => {
+                hostWindow.removeEventListener('codingns-pwa-install-available', onAvailable);
+                hostWindow.removeEventListener('codingns-pwa-installed', onInstalled);
+            };
+        }
+        catch {
+            removeListeners = undefined;
+        }
+        return true;
+    };
+    refresh();
+    return { dispose: hide, refresh };
+}
+function isDismissed(windowLike) {
+    try {
+        return windowLike.localStorage?.getItem(PWA_INSTALL_DISMISS_KEY) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+function markDismissed(windowLike) {
+    try {
+        windowLike.localStorage?.setItem(PWA_INSTALL_DISMISS_KEY, '1');
+    }
+    catch {
+        // 隐私模式下 localStorage 可能不可写；只影响“记住关闭”这一便利功能。
+    }
+}
+function isIos(windowLike) {
+    const navigatorLike = windowLike.navigator;
+    const agent = navigatorLike?.userAgent ?? '';
+    if (/iPad|iPhone|iPod/u.test(agent))
+        return true;
+    // iPadOS 桌面模式伪装成 Mac，用触摸点数补充判断。
+    return /Macintosh/u.test(agent) && (navigatorLike?.maxTouchPoints ?? 0) > 1;
+}
+//# sourceMappingURL=pwa-install-prompt.js.map

package/data/build/dist/client/pwa-install-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-install-prompt.js","sourceRoot":"","sources":["../../../../src/client/pwa-install-prompt.ts"],"names":[],"mappings":"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"}

package/data/build/dist/client/pwa-notifications.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 通知与推送客户端。
+ *
+ * 只使用浏览器原生能力，不引入依赖：
+ * - 通知：要求安全上下文与用户授权；已注册 Service Worker 时走
+ *   `registration.showNotification`，否则退回页面 `new Notification`。
+ * - 推送：先要有一个活跃的 Service Worker 注册（由启动页注入脚本完成），
+ *   这里只负责 `pushManager.subscribe` 并把订阅凭据交给 Host 保存。
+ *
+ * 所有方法在能力缺失时返回可解释状态而不抛异常，设置面板据此灰显输入。
+ */
+export interface PwaPushSubscriptionJson {
+    readonly endpoint: string;
+    readonly keys: {
+        readonly p256dh: string;
+        readonly auth: string;
+    };
+}
+export type PwaNotificationPermission = 'default' | 'granted' | 'denied' | 'unsupported';
+export interface PwaNotificationStatus {
+    /** 浏览器是否提供通知能力。 */
+    readonly supported: boolean;
+    /** 是否处于安全上下文（HTTPS 或回环地址）。 */
+    readonly secure: boolean;
+    readonly permission: PwaNotificationPermission;
+    /** 是否已有可用的 Service Worker 注册（推送的前提）。 */
+    readonly serviceWorker: boolean;
+}
+export interface PwaPushSubscriptionLike {
+    readonly endpoint: string;
+    toJSON?(): {
+        endpoint?: unknown;
+        keys?: {
+            p256dh?: unknown;
+            auth?: unknown;
+        };
+    };
+    unsubscribe(): Promise<boolean>;
+}
+export interface PwaServiceWorkerRegistrationLike {
+    readonly active?: unknown;
+    readonly pushManager?: {
+        getSubscription(): Promise<PwaPushSubscriptionLike | null>;
+        subscribe(options: {
+            userVisibleOnly: boolean;
+            applicationServerKey: Uint8Array;
+        }): Promise<PwaPushSubscriptionLike>;
+    };
+    showNotification?(title: string, options?: Record<string, unknown>): Promise<void>;
+    unregister?(): Promise<boolean>;
+}
+export interface PwaNotificationNavigatorLike {
+    readonly serviceWorker?: {
+        getRegistration(scope?: string): Promise<PwaServiceWorkerRegistrationLike | undefined>;
+        ready?: Promise<PwaServiceWorkerRegistrationLike>;
+    };
+}
+export interface PwaNotificationGlobalLike {
+    readonly isSecureContext?: boolean;
+    readonly Notification?: {
+        readonly permission: string;
+        requestPermission(): Promise<string>;
+    };
+    readonly navigator?: PwaNotificationNavigatorLike;
+}
+export interface PwaNotificationClientOptions {
+    readonly global?: PwaNotificationGlobalLike;
+    /** 注册作用域，需与启动页脚本注册的 `/sw.js` 一致。 */
+    readonly scope?: string;
+    readonly serviceWorkerUrl?: string;
+}
+export interface PwaNotificationPayload {
+    readonly title: string;
+    readonly body?: string;
+    readonly tag?: string;
+    readonly url?: string;
+    /** Android 通知的振动模式；浏览器不支持时会自动忽略。 */
+    readonly vibrate?: number | readonly number[];
+}
+/** 通知与推送的统一入口；同一实例可重复调用。 */
+export declare class PwaNotificationClient {
+    private readonly globalLike;
+    private readonly scope;
+    private readonly serviceWorkerUrl;
+    constructor(options?: PwaNotificationClientOptions);
+    /** 当前能力与授权状态；不会触发任何权限请求。 */
+    status(): Promise<PwaNotificationStatus>;
+    /** 请求通知权限；必须由用户手势触发（浏览器要求），失败时返回当前状态。 */
+    requestPermission(): Promise<PwaNotificationStatus>;
+    /** 发送本地通知（不需要推送服务）。 */
+    notify(payload: PwaNotificationPayload): Promise<boolean>;
+    /** 当前订阅；没有 Service Worker 或未订阅时返回 null。 */
+    currentSubscription(): Promise<PwaPushSubscriptionJson | null>;
+    /** 订阅推送；applicationServerKey 为 Host 下发的 VAPID 公钥（base64url）。 */
+    subscribe(vapidPublicKey: string): Promise<PwaPushSubscriptionJson>;
+    /** 取消当前订阅；没有订阅时返回 false。 */
+    unsubscribe(): Promise<boolean>;
+    /** 注销 Service Worker：逃生口，同时通知 SW 清理缓存。 */
+    unregisterServiceWorker(): Promise<boolean>;
+    private registration;
+}
+export declare function createPwaNotificationClient(options?: PwaNotificationClientOptions): PwaNotificationClient;
+/** base64url → Uint8Array；VAPID 公钥是 65 字节的非压缩点。 */
+export declare function base64UrlToBytes(value: string): Uint8Array;
+//# sourceMappingURL=pwa-notifications.d.ts.map

package/data/build/dist/client/pwa-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-notifications.d.ts","sourceRoot":"","sources":["../../../../src/client/pwa-notifications.ts"],"names":[],"mappings":"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"}

package/data/build/dist/client/pwa-notifications.js

@@ -0,0 +1,192 @@
+/**
+ * 通知与推送客户端。
+ *
+ * 只使用浏览器原生能力，不引入依赖：
+ * - 通知：要求安全上下文与用户授权；已注册 Service Worker 时走
+ *   `registration.showNotification`，否则退回页面 `new Notification`。
+ * - 推送：先要有一个活跃的 Service Worker 注册（由启动页注入脚本完成），
+ *   这里只负责 `pushManager.subscribe` 并把订阅凭据交给 Host 保存。
+ *
+ * 所有方法在能力缺失时返回可解释状态而不抛异常，设置面板据此灰显输入。
+ */
+/** 通知与推送的统一入口；同一实例可重复调用。 */
+export class PwaNotificationClient {
+    globalLike;
+    scope;
+    serviceWorkerUrl;
+    constructor(options = {}) {
+        this.globalLike = options.global ?? globalThis;
+        this.scope = options.scope ?? '/';
+        this.serviceWorkerUrl = options.serviceWorkerUrl ?? '/sw.js';
+    }
+    /** 当前能力与授权状态；不会触发任何权限请求。 */
+    async status() {
+        const secure = this.globalLike.isSecureContext === true;
+        const notification = this.globalLike.Notification;
+        const permission = notification === undefined
+            ? 'unsupported'
+            : normalizePermission(notification.permission);
+        const registration = await this.registration();
+        return {
+            supported: notification !== undefined,
+            secure,
+            permission,
+            serviceWorker: registration !== undefined,
+        };
+    }
+    /** 请求通知权限；必须由用户手势触发（浏览器要求），失败时返回当前状态。 */
+    async requestPermission() {
+        const notification = this.globalLike.Notification;
+        if (notification !== undefined && this.globalLike.isSecureContext === true) {
+            try {
+                await notification.requestPermission();
+            }
+            catch {
+                // 直接打开页面等场景下浏览器会拒绝；状态查询会给出真实结果。
+            }
+        }
+        return this.status();
+    }
+    /** 发送本地通知（不需要推送服务）。 */
+    async notify(payload) {
+        const notification = this.globalLike.Notification;
+        if (notification === undefined || normalizePermission(notification.permission) !== 'granted')
+            return false;
+        const options = {
+            ...(payload.body === undefined ? {} : { body: payload.body }),
+            ...(payload.tag === undefined ? {} : { tag: payload.tag }),
+            ...(payload.url === undefined ? {} : { data: { url: payload.url } }),
+            // Android Chrome 会在允许通知时按该模式触发系统振动；iOS/桌面会忽略未知选项。
+            vibrate: payload.vibrate ?? [80, 40, 80],
+        };
+        const registration = await this.registration();
+        if (registration?.showNotification !== undefined) {
+            try {
+                await registration.showNotification(payload.title, options);
+                return true;
+            }
+            catch {
+                // 落到页面级通知；iOS 上只有已安装的 Web App 才能成功。
+            }
+        }
+        try {
+            const notificationApi = this.globalLike.Notification;
+            if (notificationApi === undefined)
+                return false;
+            const Constructor = this.globalLike.Notification;
+            new Constructor(payload.title, options);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** 当前订阅；没有 Service Worker 或未订阅时返回 null。 */
+    async currentSubscription() {
+        const registration = await this.registration();
+        const pushManager = registration?.pushManager;
+        if (pushManager === undefined)
+            return null;
+        try {
+            const subscription = await pushManager.getSubscription();
+            return subscription === null ? null : toSubscriptionJson(subscription);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** 订阅推送；applicationServerKey 为 Host 下发的 VAPID 公钥（base64url）。 */
+    async subscribe(vapidPublicKey) {
+        const registration = await this.registration();
+        const pushManager = registration?.pushManager;
+        if (pushManager === undefined)
+            throw new Error('推送不可用：没有活跃的 Service Worker 注册');
+        const applicationServerKey = base64UrlToBytes(vapidPublicKey);
+        const existing = await pushManager.getSubscription().catch(() => null);
+        const subscription = existing ?? await pushManager.subscribe({ userVisibleOnly: true, applicationServerKey });
+        return toSubscriptionJson(subscription);
+    }
+    /** 取消当前订阅；没有订阅时返回 false。 */
+    async unsubscribe() {
+        const registration = await this.registration();
+        const pushManager = registration?.pushManager;
+        if (pushManager === undefined)
+            return false;
+        const subscription = await pushManager.getSubscription().catch(() => null);
+        if (subscription === null || subscription === undefined)
+            return false;
+        try {
+            return await subscription.unsubscribe();
+        }
+        catch {
+            return false;
+        }
+    }
+    /** 注销 Service Worker：逃生口，同时通知 SW 清理缓存。 */
+    async unregisterServiceWorker() {
+        const registration = await this.registration();
+        if (registration?.unregister === undefined)
+            return false;
+        try {
+            const active = registration.active;
+            if (active !== undefined && active !== null && typeof active.postMessage === 'function') {
+                ;
+                active.postMessage({ type: 'codingns-sw-unregister' });
+            }
+            return await registration.unregister();
+        }
+        catch {
+            return false;
+        }
+    }
+    async registration() {
+        const serviceWorker = this.globalLike.navigator?.serviceWorker;
+        if (serviceWorker === undefined)
+            return undefined;
+        try {
+            const direct = await serviceWorker.getRegistration(this.scope);
+            if (direct !== undefined)
+                return direct;
+        }
+        catch {
+            // 回退到 ready；两种路径在浏览器里等价，差别只在是否需要等待激活。
+        }
+        if (serviceWorker.ready === undefined)
+            return undefined;
+        try {
+            return await serviceWorker.ready;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+export function createPwaNotificationClient(options = {}) {
+    return new PwaNotificationClient(options);
+}
+function normalizePermission(value) {
+    return value === 'granted' || value === 'denied' || value === 'default' ? value : 'unsupported';
+}
+function toSubscriptionJson(subscription) {
+    const raw = typeof subscription.toJSON === 'function'
+        ? subscription.toJSON()
+        : { endpoint: subscription.endpoint, keys: undefined };
+    const endpoint = typeof raw.endpoint === 'string' ? raw.endpoint : subscription.endpoint;
+    const p256dh = typeof raw.keys?.p256dh === 'string' ? raw.keys.p256dh : undefined;
+    const auth = typeof raw.keys?.auth === 'string' ? raw.keys.auth : undefined;
+    if (endpoint === undefined || p256dh === undefined || auth === undefined) {
+        throw new Error('订阅缺少 endpoint 或密钥，无法上报');
+    }
+    return { endpoint, keys: { p256dh, auth } };
+}
+/** base64url → Uint8Array；VAPID 公钥是 65 字节的非压缩点。 */
+export function base64UrlToBytes(value) {
+    const normalized = value.replace(/-/gu, '+').replace(/_/gu, '/');
+    const padded = normalized + '='.repeat((4 - (normalized.length % 4)) % 4);
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1)
+        bytes[index] = binary.charCodeAt(index);
+    return bytes;
+}
+//# sourceMappingURL=pwa-notifications.js.map

package/data/build/dist/client/pwa-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-notifications.js","sourceRoot":"","sources":["../../../../src/client/pwa-notifications.ts"],"names":[],"mappings":"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"}

package/data/build/dist/client/quick-phrase-layout.d.ts

@@ -11,6 +11,17 @@ export declare const QUICK_PHRASE_PERMISSION_ORDER = 2;
 export declare const QUICK_PHRASE_GAP_SCALE = 0.5;
 /** 读不到宿主 gap 时按 DSH 当前的 12px 估算，留出一半间距。 */
 export declare const QUICK_PHRASE_FALLBACK_MARGIN = -6;
+/**
+ * 按 CSS Modules 本地名匹配 DSH 类名。
+ *
+ * DSH 类名形如 `uV2eYG_add`，前缀是构建期生成的哈希：npm 分发的 Web 构建与
+ * Desktop 内嵌构建（app.asar）哈希不同（`yhfFVG_add`）。插件只能按本地名
+ * 匹配，把类名绑到某一次构建的哈希上会在另一个运行时失效。
+ * @param className - 元素完整的 class 字符串，可含多个类名。
+ * @param localName - CSS Modules 本地名，例如 `add`。
+ * @returns class 字符串里是否有本地名等于 localName 的类名。
+ */
+export declare function matchesDshCssModuleClass(className: string | null | undefined, localName: string): boolean;
 /** 读取计算样式的入口；测试可注入替身。 */
 export interface QuickPhraseLayoutEnvironment {
     readonly computedStyle?: (element: Element) => {

package/data/build/dist/client/quick-phrase-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-phrase-layout.d.ts","sourceRoot":"","sources":["../../../../src/client/quick-phrase-layout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAC3C,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAC9C,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,MAAM,CAAA;AACzC,2CAA2C;AAC3C,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOzG;AAED,yBAAyB;AACzB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACzG;AAED,gCAAgC;AAChC,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAA;IAC1C,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IACtC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,EAChC,WAAW,GAAE,4BAAiC,GAC7C,sBAAsB,CAgBxB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,OAAO,GAAG,IAAI,EACzB,WAAW,GAAE,4BAAiC,GAC7C,MAAM,CAMR"}

package/data/build/dist/client/quick-phrase-layout.js

@@ -11,6 +11,26 @@ export const QUICK_PHRASE_PERMISSION_ORDER = 2;
 export const QUICK_PHRASE_GAP_SCALE = 0.5;
 /** 读不到宿主 gap 时按 DSH 当前的 12px 估算，留出一半间距。 */
 export const QUICK_PHRASE_FALLBACK_MARGIN = -6;
+/**
+ * 按 CSS Modules 本地名匹配 DSH 类名。
+ *
+ * DSH 类名形如 `uV2eYG_add`，前缀是构建期生成的哈希：npm 分发的 Web 构建与
+ * Desktop 内嵌构建（app.asar）哈希不同（`yhfFVG_add`）。插件只能按本地名
+ * 匹配，把类名绑到某一次构建的哈希上会在另一个运行时失效。
+ * @param className - 元素完整的 class 字符串，可含多个类名。
+ * @param localName - CSS Modules 本地名，例如 `add`。
+ * @returns class 字符串里是否有本地名等于 localName 的类名。
+ */
+export function matchesDshCssModuleClass(className, localName) {
+    if (typeof className !== 'string')
+        return false;
+    for (const token of className.split(/\s+/)) {
+        const separator = token.lastIndexOf('_');
+        if (separator > 0 && token.slice(separator + 1) === localName)
+            return true;
+    }
+    return false;
+}
 /**
  * 把快捷短语按钮排到添加附件按钮之后、权限设置组件之前。
  * @param request - 快捷短语根节点与添加附件按钮。

package/data/build/dist/client/quick-phrase-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-phrase-layout.js","sourceRoot":"","sources":["../../../../src/client/quick-phrase-layout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAA;AAC3C,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAA;AAC9C,uCAAuC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAA;AACzC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,CAAA;AAE9C;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAAoC,EAAE,SAAiB;IAC9F,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC/C,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,SAAS,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;IAC5E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAuBD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgC,EAChC,cAA4C,EAAE;IAE9C,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,IAAI,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;IACpG,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IACrE,MAAM,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IACtG,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAA;IACzF,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC1D,KAAK,MAAM,IAAI,IAAI,SAAS;QAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAA;IACtF,OAAO;QACL,SAAS,EAAE,SAAS;QACpB,SAAS;QACT,OAAO,EAAE,GAAG,EAAE;YACZ,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBAChC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;YAC1C,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAyB,EACzB,cAA4C,EAAE;IAE9C,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,4BAA4B,CAAA;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,IAAI,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;IACpG,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;IACvE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,4BAA4B,CAAA;IAC1E,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAA;AAC5C,CAAC;AAED,4BAA4B;AAC5B,SAAS,uBAAuB,CAC9B,SAAsB,EACtB,OAAgC,EAChC,aAAiE;IAEjE,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5E,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAC3B,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;AACpF,CAAC;AAED,kDAAkD;AAClD,SAAS,iBAAiB,CAAC,IAAa,EAAE,aAAiE;IACzG,IAAI,OAAO,GAAG,IAAI,CAAC,aAAa,CAAA;IAChC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAA;QAC9C,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,MAAM;YAAE,OAAO,OAAO,CAAA;QACzF,OAAO,GAAG,OAAO,CAAC,aAAa,CAAA;IACjC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,sEAAsE;AACtE,SAAS,WAAW,CAAC,SAAkB,EAAE,aAAiE;IACxG,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,CAAC,MAAe,EAAQ,EAAE;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;YAC5C,IAAI,OAAO,KAAK,MAAM;gBAAE,SAAQ;YAChC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3B,KAAK,CAAC,KAAK,CAAC,CAAA;gBACZ,SAAQ;YACV,CAAC;YACD,IAAI,UAAU,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC,CAAA;IACD,KAAK,CAAC,SAAS,CAAC,CAAA;IAChB,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,UAAU,CAAC,OAAgB;IAClC,OAAQ,OAAgC,CAAC,KAAK,KAAK,SAAS,CAAA;AAC9D,CAAC"}

package/data/build/dist/client/quick-phrase-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-phrase-slot.d.ts","sourceRoot":"","sources":["../../../../src/client/quick-phrase-slot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAC9E,OAAO,EAAyB,KAAK,gBAAgB,EAAoB,MAAM,+BAA+B,CAAA;AAC9G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAkCxE,oCAAoC;AACpC,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,EACjD,MAAM,EAAE,cAAc,GACrB,MAAM,IAAI,CAUZ"}

package/data/build/dist/client/quick-phrase-slot.js

@@ -1,11 +1,15 @@
 import { createElement, useEffect, useLayoutEffect, useRef, useState } from 'react';
 import { DEFAULT_QUICK_PHRASES } from '../shared/contracts/config.js';
 import { useCodingNsTranslator } from './locale.js';
-import { applyQuickPhraseOrder, QUICK_PHRASE_FALLBACK_MARGIN, QUICK_PHRASE_TRIGGER_ORDER, readQuickPhraseMargin } from './quick-phrase-layout.js';
+import { applyQuickPhraseOrder, matchesDshCssModuleClass, QUICK_PHRASE_FALLBACK_MARGIN, QUICK_PHRASE_PERMISSION_ORDER, QUICK_PHRASE_TRIGGER_ORDER, readQuickPhraseMargin } from './quick-phrase-layout.js';
 import { dshPopupSurfaceStyle, dshThemeColor } from './theme.js';
 const QUICK_PHRASE_FALLBACK_SIZE = 28;
 const QUICK_PHRASE_FALLBACK_ICON_SIZE = 14;
 const QUICK_PHRASE_STYLE_ID = 'codingns4dsh-quick-phrase-responsive-style';
+/** 高于 DSH 侧栏和普通模态框，避免弹层被宿主布局覆盖。 */
+const QUICK_PHRASE_MODAL_Z_INDEX = 10001;
+/** 用属性选择器粗筛带 `_add` 类名的按钮，精确匹配再交给 matchesDshCssModuleClass。 */
+const ADD_BUTTON_CANDIDATE_SELECTOR = 'button[class*="_add"]';
 /** 移动端弹层脱离对话窗口边界，使用整个视口宽度。 */
 function installQuickPhraseStyles() {
     if (typeof document === 'undefined' || document.querySelector(`style[data-plugin-css="${QUICK_PHRASE_STYLE_ID}"]`) !== null)
@@ -13,7 +17,12 @@ function installQuickPhraseStyles() {
     const style = document.createElement('style');
     style.dataset.plugin = 'codingns4dsh';
     style.dataset.pluginCss = QUICK_PHRASE_STYLE_ID;
-    style.textContent = '@media (max-width: 768px){.codingns4dsh-quick-phrase-overlay{left:0!important;right:0!important;width:100vw!important}}';
+    style.textContent = [
+        '@media (max-width: 768px){.codingns4dsh-quick-phrase-overlay{left:0!important;right:0!important;width:100vw!important}}',
+        // 与 applyQuickPhraseOrder 同一顺序：权限/规划组永远排在快捷短语之后。
+        // JS 落位依赖挂载时序（找不到添加按钮时静默跳过），CSS 固定值兜底，结构在即生效。
+        `[data-composer-card] [class*="_modes"]{order:${QUICK_PHRASE_PERMISSION_ORDER}}`,
+    ].join('');
     document.head.appendChild(style);
 }
 /** 在添加文件按钮右侧的输入工具区挂载插件自己的快捷会话入口。 */
@@ -286,14 +295,17 @@ function QuickPhraseSlot(props) {
 function findAddButton(root) {
     let scope = root.parentElement;
     while (scope !== null) {
-        const button = Array.from(scope.querySelectorAll('button.uV2eYG_add'))
-            .find(isVisibleElement) ?? null;
+        const button = findAddButtonIn(scope);
         if (button !== null)
             return button;
         scope = scope.parentElement;
     }
-    return Array.from(document.querySelectorAll('button.uV2eYG_add'))
-        .find(isVisibleElement) ?? null;
+    return findAddButtonIn(document);
+}
+/** 添加附件按钮：类名带 CSS Modules 本地名 `add` 且可见。哈希前缀随构建变化，不参与匹配。 */
+function findAddButtonIn(scope) {
+    return Array.from(scope.querySelectorAll(ADD_BUTTON_CANDIDATE_SELECTOR))
+        .find((button) => matchesDshCssModuleClass(button.className, 'add') && isVisibleElement(button)) ?? null;
 }
 function findPositioningParent(root) {
     let current = root.parentElement;
@@ -343,7 +355,7 @@ const quickPhraseTriggerStyle = {
 const quickPhraseOverlayStyle = {
     position: 'fixed',
     inset: 0,
-    zIndex: 1400,
+    zIndex: QUICK_PHRASE_MODAL_Z_INDEX,
     display: 'flex',
     alignItems: 'center',
     justifyContent: 'center',
@@ -366,7 +378,7 @@ const quickPhraseTitleStyle = { display: 'block', color: dshThemeColor.labelPrim
 const quickPhraseHintStyle = { margin: '6px 0 0', color: dshThemeColor.labelSecondary, fontSize: 13, lineHeight: 1.5 };
 const quickPhraseCloseStyle = { width: 32, height: 32, flex: '0 0 auto', border: 0, borderRadius: 16, color: dshThemeColor.labelSecondary, background: dshThemeColor.surfaceSubtle, fontSize: 24, lineHeight: 1, cursor: 'pointer' };
 const quickPhraseIconButtonStyle = { width: 32, height: 32, display: 'inline-flex', alignItems: 'center', justifyContent: 'center', padding: 0, border: 0, borderRadius: 8, color: dshThemeColor.labelSecondary, background: dshThemeColor.surfaceSubtle, cursor: 'pointer' };
-const quickPhraseEditorOverlayStyle = { ...quickPhraseOverlayStyle, zIndex: 1410, background: 'transparent' };
+const quickPhraseEditorOverlayStyle = { ...quickPhraseOverlayStyle, zIndex: QUICK_PHRASE_MODAL_Z_INDEX + 1, background: 'transparent' };
 const quickPhraseEditorStyle = { ...dshPopupSurfaceStyle, width: 'min(100%, 520px)', boxSizing: 'border-box', padding: 24, borderRadius: 12 };
 const quickPhraseEditorHeaderStyle = { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 16, paddingBottom: 16, borderBottom: `1px solid ${dshThemeColor.border}` };
 const quickPhraseEditorInputStyle = { width: '100%', minHeight: 92, marginTop: 16, boxSizing: 'border-box', padding: '10px 12px', border: `1px solid ${dshThemeColor.border}`, borderRadius: 8, color: dshThemeColor.labelPrimary, background: dshThemeColor.inputBackground, fontSize: 14, lineHeight: 1.5, resize: 'vertical' };