@jingyi0605/codingns4dsh 0.2.1-beta.3 → 0.2.1-beta.4

package/data/build/dist/host/desktop-assistant/controller.js

@@ -0,0 +1,150 @@
+/** 只有这个控制器拥有进程与端口；Client 的迟到请求不能复活已关闭的 generation。 */
+export class DesktopAssistantController {
+    options;
+    owner;
+    sequence = -1;
+    generation = 0;
+    frame;
+    presentation = { visible: false, state: 'idle', caption: '', label: '' };
+    page;
+    agent;
+    starting;
+    stopping = Promise.resolve();
+    visible = false;
+    ready = false;
+    error;
+    openSequence = 0;
+    disposed = false;
+    settle;
+    constructor(options) {
+        this.options = options;
+    }
+    attach(owner) {
+        if (this.disposed)
+            return this.status(owner);
+        // 页面刷新显式取得所有权，旧页面随后发来的 detach/update 均失效。
+        if (this.owner !== owner) {
+            this.owner = owner;
+            this.sequence = -1;
+            this.error = undefined;
+        }
+        return this.status(owner);
+    }
+    async update(owner, sequence, presentation) {
+        if (this.disposed || this.owner !== owner || sequence <= this.sequence)
+            return this.status(owner);
+        this.sequence = sequence;
+        this.presentation = presentation;
+        await this.refresh();
+        return this.status(owner);
+    }
+    async refresh() {
+        this.frame = this.options.readFrame(this.presentation);
+        if (!this.options.supported || this.disposed || !this.owner || !this.frame) {
+            this.error = undefined;
+            await this.stop();
+            return;
+        }
+        if (this.error)
+            return;
+        if (!this.frame.visible) {
+            if (!this.ready) {
+                await this.stop();
+                return;
+            }
+            this.visible = false;
+            this.agent?.send({ cmd: 'hide' });
+            return;
+        }
+        if (!this.agent) {
+            this.starting ??= this.start().finally(() => { this.starting = undefined; });
+            await this.starting;
+        }
+        if (this.ready && this.frame?.visible)
+            this.agent?.send({ cmd: 'show', width: this.frame.size, height: Math.ceil(this.frame.size * 208 / 192) + (this.frame.caption ? 132 : 0) });
+    }
+    status(owner) {
+        // 能否使用原生形象与窗口是否已经显示是两回事，启动握手期间不能误判为不可用。
+        // 当前形象不支持原生渲染时明确放行页面回退，避免一直停留在原生等待状态。
+        return { available: this.options.supported && !this.disposed && this.options.readFrame(this.presentation) !== undefined,
+            owned: this.owner === owner, attached: this.owner !== undefined,
+            visible: this.visible && this.owner === owner, openSequence: this.openSequence, error: this.error };
+    }
+    async detach(owner) {
+        if (this.owner !== owner)
+            return;
+        this.owner = undefined;
+        await this.stop();
+    }
+    async dispose() { this.disposed = true; this.owner = undefined; await this.stop(); await this.starting; }
+    async start() {
+        const generation = ++this.generation;
+        await this.stopping;
+        if (generation !== this.generation || this.disposed)
+            return;
+        let page;
+        let agent;
+        try {
+            page = await this.options.openPage(() => this.frame);
+            if (generation !== this.generation) {
+                await page.close();
+                return;
+            }
+            this.page = page;
+            const ready = new Promise((resolve, reject) => {
+                const timer = setTimeout(() => this.settle?.('原生悬浮窗口启动超时'), this.options.deadlineMs ?? 20000);
+                this.settle = (error) => { clearTimeout(timer); this.settle = undefined; error ? reject(new Error(error)) : resolve(); };
+            });
+            // 防止 launch 期间失败的就绪 Promise 成为未处理拒绝。
+            void ready.catch(() => undefined);
+            agent = await this.options.launch((event) => this.event(generation, event), () => this.failed(generation, '原生悬浮进程已退出'));
+            if (generation !== this.generation) {
+                await agent.stop();
+                return;
+            }
+            this.agent = agent;
+            agent.send({ cmd: 'load', url: page.url, width: this.frame.size, height: Math.ceil(this.frame.size * 208 / 192) + (this.frame.caption ? 132 : 0) });
+            await ready;
+            if (generation !== this.generation)
+                return;
+            this.ready = true;
+        }
+        catch (error) {
+            this.failed(generation, error instanceof Error ? error.message : String(error));
+        }
+    }
+    event(generation, event) {
+        if (generation !== this.generation || this.disposed)
+            return;
+        if (event.ev === 'loaded')
+            this.settle?.();
+        if (event.ev === 'shown')
+            this.visible = this.frame?.visible === true;
+        // 打开 Desktop 或助理工作台只发送交互事件，不改变原生形象的常驻状态。
+        if (event.ev === 'open')
+            this.openSequence++;
+        if (event.ev === 'error')
+            this.failed(generation, typeof event.message === 'string' ? event.message.slice(0, 500) : '原生悬浮窗口不可用');
+    }
+    failed(generation, message) {
+        if (generation !== this.generation)
+            return;
+        this.error = message;
+        void this.stop();
+    }
+    stop() {
+        this.generation++;
+        this.visible = false;
+        this.ready = false;
+        this.settle?.('悬浮窗口已关闭');
+        const agent = this.agent, page = this.page;
+        this.agent = undefined;
+        this.page = undefined;
+        this.stopping = this.stopping.then(async () => {
+            // 任意一项清理失败都不能挡住另一项，也不能让后续 generation 永久挂在拒绝链上。
+            await Promise.allSettled([agent?.stop(), page?.close()]);
+        });
+        return this.stopping;
+    }
+}
+//# sourceMappingURL=controller.js.map

package/data/build/dist/host/desktop-assistant/controller.js.map

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

package/data/build/dist/host/desktop-assistant/feature.d.ts

@@ -0,0 +1,9 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { FeatureModule } from '../../shared/contracts/feature.js';
+import type { CodingNsHostServices } from '../features/types.js';
+import { DesktopAssistantController } from './controller.js';
+/** 原生窗口能力只在官方 Desktop Host 中启用，不依据客户端宣称的平台启动进程。 */
+export declare function createDesktopAssistantFeature(): FeatureModule<CodingNsHostServices>;
+/** 同时要求物理回环连接与 DSH 认证；PeerHost 转发与普通远程网页不能启动本机窗口。 */
+export declare function handleDesktopAssistantRequest(request: IncomingMessage, response: ServerResponse, rejection: (headers: IncomingMessage['headers']) => number | undefined, controller: DesktopAssistantController): Promise<void>;
+//# sourceMappingURL=feature.d.ts.map

package/data/build/dist/host/desktop-assistant/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../../../src/host/desktop-assistant/feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAGhE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAI5D,mDAAmD;AACnD,wBAAgB,6BAA6B,IAAI,aAAa,CAAC,oBAAoB,CAAC,CA8BnF;AAED,qDAAqD;AACrD,wBAAsB,6BAA6B,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EACpG,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC/H"}

package/data/build/dist/host/desktop-assistant/feature.js

@@ -0,0 +1,102 @@
+import { isDesktopAssistantHost, readDesktopAssistantPresentation, DESKTOP_ASSISTANT_CHANNEL } from '../../shared/desktop-assistant.js';
+import { normalizeAssistantAppearance, selectedAssistantAvatar, resolveAssistantAvatarAsset } from '../../shared/assistant-avatar.js';
+import { getAssistantAvatarPackages } from '../avatar/registry.js';
+import { createAssistantAvatarRouteHandler } from '../features/assistant-avatar-runtime.js';
+import { DesktopAssistantController } from './controller.js';
+import { openDesktopAssistantPage } from './server.js';
+import { launchDesktopAssistant } from './launcher.js';
+/** 原生窗口能力只在官方 Desktop Host 中启用，不依据客户端宣称的平台启动进程。 */
+export function createDesktopAssistantFeature() {
+    return {
+        descriptor: { name: 'desktopAssistant', version: '0.1.0', enabledByDefault: true, dependencies: [], runtime: 'host' },
+        start(context) {
+            const supported = isDesktopAssistantHost(process.platform, process.versions.electron, process.env.ELECTRON_RUN_AS_NODE, process.argv[1] ?? '');
+            const ctx = context.services.dshContext;
+            if (!supported || !ctx)
+                return;
+            const assets = createAssistantAvatarRouteHandler(getAssistantAvatarPackages(context.services), true);
+            const controller = new DesktopAssistantController({ supported, launch: launchDesktopAssistant,
+                openPage: (frame) => openDesktopAssistantPage({ frame, assets }),
+                readFrame: (presentation) => {
+                    const settings = context.services.settings?.get();
+                    if (!settings?.modules.globalVoiceAssistant || settings.assistant.profile?.initialized !== true)
+                        return undefined;
+                    const appearance = normalizeAssistantAppearance(settings.assistant.appearance);
+                    if (!appearance.floatingEnabled)
+                        return undefined;
+                    const model = selectedAssistantAvatar(appearance);
+                    // 第三方自定义渲染器在主 Client 注册，无法假设它已存在于独立页面。
+                    if (!['builtin', 'image', 'spritesheet', 'live2d'].includes(resolveAssistantAvatarAsset(model, 'floating').renderer))
+                        return undefined;
+                    return { ...presentation, model, size: appearance.floatingSize };
+                },
+            });
+            const webServer = ctx.get('webServer');
+            context.resources.add(webServer.register({ kind: 'prefix', path: DESKTOP_ASSISTANT_CHANNEL,
+                handler: (req, res) => handleDesktopAssistantRequest(req, res, (headers) => ctx.connection.requestRejection({ headers }), controller),
+            }));
+            const unwatch = context.services.settings?.watch(() => { void controller.refresh().catch(() => undefined); });
+            if (unwatch)
+                context.resources.add(unwatch);
+            context.resources.add(() => controller.dispose());
+        },
+    };
+}
+/** 同时要求物理回环连接与 DSH 认证；PeerHost 转发与普通远程网页不能启动本机窗口。 */
+export async function handleDesktopAssistantRequest(request, response, rejection, controller) {
+    // 官方 dsh-app 转发会移除 Origin 并使用回环 Host；反代和 Web 页面不能借回环代理进入。
+    const localHost = /^(?:127\.0\.0\.1|localhost|\[::1\])(?::\d+)?$/u.test(request.headers.host ?? '');
+    const forwarded = ['forwarded', 'x-forwarded-for', 'x-forwarded-host', 'x-real-ip'].some((key) => request.headers[key] !== undefined);
+    if (!['127.0.0.1', '::1', '::ffff:127.0.0.1'].includes(request.socket.remoteAddress ?? '')
+        || !localHost || forwarded || request.headers.origin !== undefined
+        || rejection(request.headers) !== undefined) {
+        response.writeHead(403).end();
+        return;
+    }
+    if (request.method !== 'POST' || request.headers['content-type']?.split(';')[0] !== 'application/json') {
+        response.writeHead(405).end();
+        return;
+    }
+    let rpcId = '';
+    try {
+        const chunks = [];
+        let length = 0;
+        for await (const chunk of request) {
+            const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            length += bytes.length;
+            if (length > 40000)
+                throw new Error('悬浮请求过大');
+            chunks.push(bytes);
+        }
+        const envelope = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        if (envelope.type !== 'client-request' || typeof envelope.rpcId !== 'string' || envelope.rpcId.length > 160)
+            throw new Error('悬浮协议无效');
+        rpcId = envelope.rpcId;
+        const action = envelope.method;
+        if (!['attach', 'update', 'detach'].includes(String(action)) || request.url?.split('?')[0] !== `${DESKTOP_ASSISTANT_CHANNEL}/${String(action)}`)
+            throw new Error('悬浮操作无效');
+        const input = envelope.payload;
+        if (!input || typeof input.ownerId !== 'string' || !/^[a-zA-Z0-9:-]{8,160}$/u.test(input.ownerId))
+            throw new Error('悬浮调用方无效');
+        let value;
+        if (action === 'attach')
+            value = controller.attach(input.ownerId);
+        else if (action === 'detach') {
+            await controller.detach(input.ownerId);
+            value = controller.status(input.ownerId);
+        }
+        else {
+            if (!Number.isSafeInteger(input.sequence) || Number(input.sequence) < 0)
+                throw new Error('悬浮更新序号无效');
+            value = await controller.update(input.ownerId, Number(input.sequence), readDesktopAssistantPresentation(input.presentation));
+        }
+        response.setHeader('Content-Type', 'application/json');
+        response.end(JSON.stringify({ type: 'server-response', rpcId, result: { ok: true, value } }));
+    }
+    catch (error) {
+        response.setHeader('Content-Type', 'application/json');
+        response.end(JSON.stringify({ type: 'server-response', rpcId,
+            result: { ok: false, error: { code: 'desktop_assistant_unavailable', message: error instanceof Error ? error.message : String(error), details: {} } } }));
+    }
+}
+//# sourceMappingURL=feature.js.map

package/data/build/dist/host/desktop-assistant/feature.js.map

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

package/data/build/dist/host/desktop-assistant/launcher.d.ts

@@ -0,0 +1,5 @@
+import type { DesktopAssistantAgent } from './controller.js';
+/** 所有运行数据落在插件自有目录，不触碰 Desktop 壳或其包目录。 */
+export declare function desktopAssistantDirectory(): string;
+export declare function launchDesktopAssistant(onEvent: (event: Record<string, unknown>) => void, onExit: () => void): Promise<DesktopAssistantAgent>;
+//# sourceMappingURL=launcher.d.ts.map

package/data/build/dist/host/desktop-assistant/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../../../../src/host/desktop-assistant/launcher.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAE5D,yCAAyC;AACzC,wBAAgB,yBAAyB,IAAI,MAAM,CAAuE;AAE1H,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoDlJ"}

package/data/build/dist/host/desktop-assistant/launcher.js

@@ -0,0 +1,84 @@
+import { spawn } from 'node:child_process';
+import { mkdir, mkdtemp, readFile, rm, writeFile, rename } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
+import { buildMacAssistantScript } from './mac-agent.js';
+import { buildWinAssistantScript } from './win-agent.js';
+import { observeDesktopAssistantProcess } from './process.js';
+/** 所有运行数据落在插件自有目录，不触碰 Desktop 壳或其包目录。 */
+export function desktopAssistantDirectory() { return join(resolveDshHome(), 'codingns4dsh', 'desktop-assistant'); }
+export async function launchDesktopAssistant(onEvent, onExit) {
+    const directory = desktopAssistantDirectory();
+    await mkdir(directory, { recursive: true });
+    const temporary = await mkdtemp(join(directory, 'run-'));
+    const windows = process.platform === 'win32';
+    const sdkRoot = fileURLToPath(new URL('../../../../../assets/desktop-assistant/webview2/', import.meta.url));
+    const script = join(temporary, windows ? 'assistant.ps1' : 'assistant.js');
+    let bounds;
+    try {
+        bounds = JSON.parse(await readFile(join(directory, 'position.json'), 'utf8'));
+    }
+    catch { /* 首次运行或损坏记录使用系统默认位置。 */ }
+    // PowerShell 5.1 无 BOM 时按系统 ANSI 读取，用户目录含中文会导致 SDK 路径损坏。
+    try {
+        await writeFile(script, windows ? '\uFEFF' + buildWinAssistantScript(sdkRoot) : buildMacAssistantScript(), 'utf8');
+    }
+    catch (error) {
+        await rm(temporary, { recursive: true, force: true });
+        throw error;
+    }
+    const command = windows ? join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe') : '/usr/bin/osascript';
+    const args = windows ? ['-NoProfile', '-NonInteractive', '-Sta', '-ExecutionPolicy', 'Bypass', '-File', script] : ['-l', 'JavaScript', script];
+    const child = spawn(command, args, { stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+    let buffer = '', stopped = false, saving = Promise.resolve();
+    const failure = (message) => onEvent({ ev: 'error', message });
+    const exit = observeDesktopAssistantProcess(child, failure, onExit, () => stopped);
+    child.stdout.setEncoding('utf8');
+    child.stdout.on('data', (chunk) => {
+        buffer += chunk;
+        if (buffer.length > 65536) {
+            buffer = '';
+            failure('原生悬浮输出超出限制');
+            return;
+        }
+        let newline;
+        while ((newline = buffer.indexOf('\n')) >= 0) {
+            const line = buffer.slice(0, newline);
+            buffer = buffer.slice(newline + 1);
+            try {
+                const event = JSON.parse(line);
+                if (event.ev === 'moved' && ['x', 'y', 'width', 'height'].every((key) => typeof event[key] === 'number' && Number.isFinite(event[key]))) {
+                    const value = JSON.stringify({ x: event.x, y: event.y, width: event.width, height: event.height });
+                    // 只保存完成拖动的位置；串行原子替换，退出等待最后一笔。
+                    saving = saving.then(async () => { await writeFile(join(temporary, 'position.json'), value); await rename(join(temporary, 'position.json'), join(directory, 'position.json')); }).catch(() => undefined);
+                }
+                onEvent(event);
+            }
+            catch { /* 非协议行不解释为命令。 */ }
+        }
+    });
+    return {
+        send(command) {
+            if (stopped || child.stdin.destroyed)
+                return;
+            const extra = command.cmd === 'load' ? { parentPid: process.ppid, userData: join(directory, 'webview2'), bounds } : {};
+            child.stdin.write(JSON.stringify({ ...command, ...extra }) + '\n');
+        },
+        async stop() {
+            if (stopped) {
+                await exit;
+                return;
+            }
+            stopped = true;
+            if (!child.stdin.destroyed)
+                child.stdin.end(JSON.stringify({ cmd: 'quit' }) + '\n');
+            const timer = setTimeout(() => child.kill(), 2000);
+            await exit;
+            clearTimeout(timer);
+            await saving;
+            await rm(temporary, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=launcher.js.map

package/data/build/dist/host/desktop-assistant/launcher.js.map

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

package/data/build/dist/host/desktop-assistant/mac-agent.d.ts

@@ -0,0 +1,5 @@
+/** 交给 Desktop 的 open-url 入口恢复主窗口；单纯激活进程不会取消窗口最小化。 */
+export declare function buildMacDesktopFocusScript(): string;
+/** Cocoa/WKWebView 伴随进程；stdout 只传 JSON Lines，原生异常转为明确失败事件。 */
+export declare function buildMacAssistantScript(): string;
+//# sourceMappingURL=mac-agent.d.ts.map

package/data/build/dist/host/desktop-assistant/mac-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mac-agent.d.ts","sourceRoot":"","sources":["../../../../../src/host/desktop-assistant/mac-agent.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,wBAAgB,0BAA0B,IAAI,MAAM,CAuBnD;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,IAAI,MAAM,CA6FhD"}

package/data/build/dist/host/desktop-assistant/mac-agent.js

@@ -0,0 +1,122 @@
+import { clampDesktopAssistantBounds } from '../../shared/desktop-assistant.js';
+/** 交给 Desktop 的 open-url 入口恢复主窗口；单纯激活进程不会取消窗口最小化。 */
+export function buildMacDesktopFocusScript() {
+    return String.raw `
+var focusingDesktop=false
+function focusDesktop(){
+ if(focusingDesktop)return
+ var desktop=$.NSRunningApplication.runningApplicationWithProcessIdentifier(parentPid)
+ if(parentPid<=0||desktop.isNil()||desktop.terminated||desktop.bundleURL.isNil())throw new Error('Desktop application is unavailable')
+ var configuration=$.NSWorkspaceOpenConfiguration.configuration
+ configuration.setActivates(true);configuration.setCreatesNewApplicationInstance(false)
+ configuration.setAllowsRunningApplicationSubstitution(false)
+ configuration.setPromptsUserIfNeeded(false)
+ focusingDesktop=true
+ try{
+  // 明确指定当前父进程的应用包，避免系统协议默认值指向另一份 Desktop。
+  $.NSWorkspace.sharedWorkspace.openURLsWithApplicationAtURLConfigurationCompletionHandler(
+   $([$.NSURL.URLWithString('dsh://open')]),desktop.bundleURL,configuration,safe(function(application,error){
+    focusingDesktop=false
+    if(!error.isNil()){emit({ev:'error',message:'Desktop restore: '+ObjC.unwrap(error.localizedDescription)});return}
+    emit({ev:'open'})
+   }))
+ }catch(error){focusingDesktop=false;throw error}
+}
+`.trim();
+}
+/** Cocoa/WKWebView 伴随进程；stdout 只传 JSON Lines，原生异常转为明确失败事件。 */
+export function buildMacAssistantScript() {
+    return String.raw `
+ObjC.import('Cocoa')
+ObjC.import('WebKit')
+var out=$.NSFileHandle.fileHandleWithStandardOutput,NL=String.fromCharCode(10)
+function emit(m){out.writeData($(JSON.stringify(m)+NL).dataUsingEncoding($.NSUTF8StringEncoding))}
+function safe(fn){return function(){try{return fn.apply(null,arguments)}catch(e){emit({ev:'error',message:String(e)})}}}
+var app=$.NSApplication.sharedApplication
+app.setActivationPolicy(1)
+var win=$.NSPanel.alloc.initWithContentRectStyleMaskBackingDefer($.NSMakeRect(0,0,144,156),128,2,false)
+win.setOpaque(false);win.setBackgroundColor($.NSColor.clearColor);win.setHasShadow(false)
+win.setLevel(3);win.setCollectionBehavior(1|16|256);win.setHidesOnDeactivate(false)
+var visible=false,drag=false,lastMouse=null,parentPid=0,origin='',positioned=false
+${buildMacDesktopFocusScript()}
+var clampBounds=${clampDesktopAssistantBounds.toString()}
+function moved(){var f=win.frame;emit({ev:'moved',x:f.origin.x,y:f.origin.y,width:f.size.width,height:f.size.height})}
+function clamp(){
+ var f=win.frame,screens=$.NSScreen.screens,areas=[]
+ for(var i=0;i<screens.count;i++){var a=screens.objectAtIndex(i).visibleFrame;areas.push({x:a.origin.x,y:a.origin.y,width:a.size.width,height:a.size.height})}
+ var next=clampBounds({x:f.origin.x,y:f.origin.y,width:f.size.width,height:f.size.height},areas)
+ win.setFrameDisplay($.NSMakeRect(next.x,next.y,next.width,next.height),true)
+}
+function bounds(m){
+ var f=win.frame,w=Math.max(72,Math.min(320,Number(m.width)||144)),h=Math.max(78,Math.min(480,Number(m.height)||156))
+ var area=$.NSScreen.mainScreen.visibleFrame
+ var x=positioned?f.origin.x:area.origin.x+area.size.width-w-24,y=positioned?f.origin.y:area.origin.y+24
+ if(m.bounds&&Number.isFinite(m.bounds.x)&&Number.isFinite(m.bounds.y)){x=m.bounds.x;y=m.bounds.y}
+ win.setFrameDisplay($.NSMakeRect(x,y,w,h),true);positioned=true;clamp()
+}
+function endDrag(){if(!drag)return;drag=false;clamp();moved()}
+var config=$.WKWebViewConfiguration.alloc.init,controller=$.WKUserContentController.alloc.init
+// JXA 注册类不返回类对象；WebKit 协议元数据也并非所有系统都可见。
+// 显式声明代理方法签名，注册后通过 $ 查找类，由 WebKit 按选择器调用。
+ObjC.registerSubclass({name:'CodingNsAssistantBridge',methods:{'userContentController:didReceiveScriptMessage:':{types:['void',['id','id']],implementation:safe(function(c,m){
+ if(!m.frameInfo.isMainFrame)return
+ var msg=JSON.parse(ObjC.unwrap(m.body))
+ if(msg.type==='ready')emit({ev:'loaded'})
+ else if(msg.type==='error')emit({ev:'error',message:String(msg.message).slice(0,500)})
+ else if(msg.type==='drag-start'){drag=true;lastMouse=$.NSEvent.mouseLocation}
+ else if(msg.type==='drag-end')endDrag()
+ else if(msg.type==='open')focusDesktop()
+})}}})
+var bridgeHandler=$.CodingNsAssistantBridge.alloc.init
+controller.addScriptMessageHandlerName(bridgeHandler,$('assistant'));config.setUserContentController(controller)
+config.setWebsiteDataStore($.WKWebsiteDataStore.nonPersistentDataStore)
+var web=$.WKWebView.alloc.initWithFrameConfiguration($.NSMakeRect(0,0,144,156),config)
+web.setValueForKey($.NSNumber.numberWithBool(false),'drawsBackground');win.setContentView(web)
+ObjC.registerSubclass({name:'CodingNsAssistantNavigation',methods:{
+ 'webView:decidePolicyForNavigationAction:decisionHandler:':{types:['void',['id','id','id']],implementation:safe(function(w,a,done){
+  var policy=0
+  try{var url=ObjC.unwrap(a.request.URL.absoluteString);policy=url.indexOf(origin+'/')===0?1:0}
+  finally{
+   // block 的隐含参数只有自身，没有 Objective-C 方法的 selector。
+   // 用 NSInvocation 按 void (^)(NSInteger) 签名调用，不能把它当 JS 函数。
+   var invocation=$.NSInvocation.invocationWithMethodSignature($.NSMethodSignature.signatureWithObjCTypes('v@?q')),argument=Ref('long')
+   argument[0]=policy;invocation.setTarget(done);invocation.setArgumentAtIndex(argument,1);invocation.invoke
+  }
+ })},
+ 'webView:didFailProvisionalNavigation:withError:':{types:['void',['id','id','id']],implementation:safe(function(w,n,e){emit({ev:'error',message:'navigation: '+e.code+' '+ObjC.unwrap(e.localizedDescription)})})},
+ 'webView:didFailNavigation:withError:':{types:['void',['id','id','id']],implementation:safe(function(w,n,e){emit({ev:'error',message:'navigation: '+e.code+' '+ObjC.unwrap(e.localizedDescription)})})},
+ 'webViewWebContentProcessDidTerminate:':{types:['void',['id']],implementation:safe(function(w){emit({ev:'error',message:'webview process terminated'})})}
+}})
+var navigation=$.CodingNsAssistantNavigation.alloc.init;web.setNavigationDelegate(navigation)
+$.NSTimer.scheduledTimerWithTimeIntervalRepeatsBlock(1/60,true,safe(function(){
+ if(!drag)return;if(($.NSEvent.pressedMouseButtons&1)===0||!visible){endDrag();return}
+ var p=$.NSEvent.mouseLocation,f=win.frame;win.setFrameOrigin($.NSMakePoint(f.origin.x+p.x-lastMouse.x,f.origin.y+p.y-lastMouse.y));lastMouse=p
+}))
+$.NSNotificationCenter.defaultCenter.addObserverForNameObjectQueueUsingBlock($.NSApplicationDidChangeScreenParametersNotification,$(),$.NSOperationQueue.mainQueue,safe(function(){clamp();moved()}))
+function handle(m){
+ if(m.cmd==='quit'){app.terminate($());return}
+ if(m.cmd==='hide'){endDrag();win.orderOut($());visible=false;return}
+ if(m.cmd==='load'){
+  parentPid=Number(m.parentPid)||0;bounds(m)
+  var url=$.NSURL.URLWithString($(String(m.url)));origin=String(m.url).split('/').slice(0,3).join('/')
+  web.loadRequest($.NSURLRequest.requestWithURL(url));return
+ }
+ if(m.cmd==='show'){if(!drag)bounds(m);if(!visible){win.orderFrontRegardless;visible=true}emit({ev:'shown'});return}
+}
+var stdin=$.NSFileHandle.fileHandleWithStandardInput,buf='',pending=$.NSMutableData.data
+$.NSNotificationCenter.defaultCenter.addObserverForNameObjectQueueUsingBlock($.NSFileHandleDataAvailableNotification,stdin,$.NSOperationQueue.mainQueue,safe(function(){
+ var data=stdin.availableData;if(data.length===0){app.terminate($());return}
+ // 管道可能在中文字节中间分块，完整 UTF-8 到达前保留原始数据。
+ pending.appendData(data);if(pending.length+buf.length>65536)throw new Error('command too large')
+ var decoded=$.NSString.alloc.initWithDataEncoding(pending,$.NSUTF8StringEncoding)
+ if(decoded.isNil()){stdin.waitForDataInBackgroundAndNotify;return}
+ buf+=decoded.js;pending.setLength(0)
+ var i;while((i=buf.indexOf(NL))>=0){var line=buf.slice(0,i);buf=buf.slice(i+1);handle(JSON.parse(line))}
+ stdin.waitForDataInBackgroundAndNotify
+}))
+stdin.waitForDataInBackgroundAndNotify
+emit({ev:'ready'})
+app.run
+`.trim();
+}
+//# sourceMappingURL=mac-agent.js.map

package/data/build/dist/host/desktop-assistant/mac-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mac-agent.js","sourceRoot":"","sources":["../../../../../src/host/desktop-assistant/mac-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAA;AAE/E,qDAAqD;AACrD,MAAM,UAAU,0BAA0B;IACxC,OAAO,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;CAqBlB,CAAC,IAAI,EAAE,CAAA;AACR,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;EAYjB,0BAA0B,EAAE;kBACZ,2BAA2B,CAAC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8EvD,CAAC,IAAI,EAAE,CAAA;AACR,CAAC"}

package/data/build/dist/host/desktop-assistant/process.d.ts

@@ -0,0 +1,4 @@
+import type { ChildProcessWithoutNullStreams } from 'node:child_process';
+/** 保留有上限的原生启动诊断；正常回收不产生降级提示。 */
+export declare function observeDesktopAssistantProcess(child: ChildProcessWithoutNullStreams, onError: (message: string) => void, onExit: () => void, isStopping: () => boolean): Promise<void>;
+//# sourceMappingURL=process.d.ts.map

package/data/build/dist/host/desktop-assistant/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../../src/host/desktop-assistant/process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AAExE,gCAAgC;AAChC,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,8BAA8B,EAClF,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlG"}

package/data/build/dist/host/desktop-assistant/process.js

@@ -0,0 +1,25 @@
+/** 保留有上限的原生启动诊断；正常回收不产生降级提示。 */
+export function observeDesktopAssistantProcess(child, onError, onExit, isStopping) {
+    let stderr = '', reported = false;
+    const failure = (message) => {
+        if (reported || isStopping())
+            return;
+        reported = true;
+        // 导航错误可能包含一次性启动 URL，不把实例令牌放进界面。
+        onError(message.replace(/([?&]token=)[^\s&"'<>]+/gu, '$1[redacted]').slice(0, 500));
+    };
+    child.stderr.setEncoding('utf8');
+    child.stderr.on('data', (chunk) => { stderr = (stderr + chunk).slice(0, 4096); });
+    child.once('error', (error) => failure(`原生悬浮启动失败：${error.message}`));
+    // EPIPE 常常先于 close 到达；等待退出诊断，避免它掩盖真正的脚本异常。
+    child.stdin.on('error', () => { });
+    return new Promise((resolve) => {
+        child.once('close', (code, signal) => {
+            const reason = stderr.trim() || `code=${String(code)}, signal=${signal ?? 'none'}`;
+            failure(`原生悬浮进程已退出：${reason}`);
+            onExit();
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=process.js.map

package/data/build/dist/host/desktop-assistant/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../../../src/host/desktop-assistant/process.ts"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,MAAM,UAAU,8BAA8B,CAAC,KAAqC,EAClF,OAAkC,EAAE,MAAkB,EAAE,UAAyB;IACjF,IAAI,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,KAAK,CAAA;IACjC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAQ,EAAE;QACxC,IAAI,QAAQ,IAAI,UAAU,EAAE;YAAE,OAAM;QACpC,QAAQ,GAAG,IAAI,CAAA;QACf,gCAAgC;QAChC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IACrF,CAAC,CAAA;IACD,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IACxF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IACpE,2CAA2C;IAC3C,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,QAAQ,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,EAAE,CAAA;YAClF,OAAO,CAAC,aAAa,MAAM,EAAE,CAAC,CAAA;YAC9B,MAAM,EAAE,CAAC;YAAC,OAAO,EAAE,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/data/build/dist/host/desktop-assistant/server.d.ts

@@ -0,0 +1,12 @@
+import type { DesktopAssistantFrame } from '../../shared/desktop-assistant.js';
+export interface DesktopAssistantPage {
+    readonly url: string;
+    close(): Promise<void>;
+}
+/** 独立回环服务只提供形象，不把完整 DSH 页面或认证会话交给伴随窗口。 */
+export declare function openDesktopAssistantPage(options: {
+    readonly frame: () => DesktopAssistantFrame | undefined;
+    readonly assets: (request: Request) => Promise<Response>;
+    readonly readBundle?: () => Promise<string>;
+}): Promise<DesktopAssistantPage>;
+//# sourceMappingURL=server.d.ts.map

package/data/build/dist/host/desktop-assistant/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../src/host/desktop-assistant/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAE9E,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;AACtF,0CAA0C;AAC1C,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,qBAAqB,GAAG,SAAS,CAAA;IACvD,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAC5C,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyChC"}