@yfwu2020/dsh-selection-explain 0.12.0 → 0.13.1

package/lib/host/shot-platform.js

@@ -0,0 +1,208 @@
+/** macOS commands, native helper recovery, and private temporary files. */
+import { spawn } from 'node:child_process';
+import { access, chmod, mkdtemp, readFile, readdir, rm, stat } from 'node:fs/promises';
+import { homedir, platform, tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveNativeProbe } from './native-probe.js';
+import { parsePngSize, parseRectXattr } from './shot-geometry.js';
+const unref = (timer) => timer.unref();
+/** Every external command, including helper compilation, observes the service's abort signal. */
+export function createCommandRunner(launch = spawn) {
+    return (command, args, signal, timeout = 10_000, env) => new Promise(resolve => {
+        const result = { stdout: '', stderr: '', code: null, signal: null, timedOut: false, failed: false };
+        if (signal.aborted) {
+            resolve({ ...result, failed: true });
+            return;
+        }
+        let child;
+        try {
+            child = launch(command, args, { stdio: ['ignore', 'pipe', 'pipe'], env });
+        }
+        catch {
+            resolve({ ...result, failed: true });
+            return;
+        }
+        let settled = false;
+        let escalation;
+        let fallback;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            clearTimeout(escalation);
+            clearTimeout(fallback);
+            signal.removeEventListener('abort', abort);
+            resolve({ ...result });
+        };
+        const terminate = () => {
+            if (settled || escalation)
+                return;
+            result.failed = true;
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* Already gone. */ }
+            if (settled)
+                return;
+            escalation = setTimeout(() => {
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* Already gone. */ }
+                if (settled)
+                    return;
+                fallback = setTimeout(finish, 250);
+                unref(fallback);
+            }, 250);
+            unref(escalation);
+        };
+        const abort = () => terminate();
+        const timer = setTimeout(() => { result.timedOut = true; terminate(); }, timeout);
+        unref(timer);
+        signal.addEventListener('abort', abort, { once: true });
+        child.stdout?.on('data', chunk => {
+            if (settled)
+                return;
+            if (result.stdout.length + String(chunk).length > 8 * 1024 * 1024)
+                terminate();
+            else
+                result.stdout += String(chunk);
+        });
+        child.stderr?.on('data', chunk => { if (!settled && result.stderr.length < 4000)
+            result.stderr += String(chunk).slice(0, 4000 - result.stderr.length); });
+        child.once('error', () => { result.failed = true; finish(); });
+        child.once('close', (code, exitSignal) => {
+            if (settled)
+                return;
+            result.code = code;
+            result.signal = exitSignal;
+            result.failed ||= code !== 0 || !!exitSignal;
+            finish();
+        });
+        // Also cover an abort delivered synchronously by an injected launcher.
+        if (signal.aborted)
+            abort();
+    });
+}
+export function shotSupported() { return platform() === 'darwin'; }
+export function resolveWindowProbe() {
+    return join(dirname(fileURLToPath(import.meta.url)), '..', 'native', 'window-list');
+}
+export function createMacShotPlatform(execute = createCommandRunner()) {
+    const commands = new Set();
+    const run = (...args) => {
+        const pending = execute(...args);
+        commands.add(pending);
+        void pending.then(() => commands.delete(pending), () => commands.delete(pending));
+        return pending;
+    };
+    let windowProbePath = '';
+    let checked = false;
+    let probing;
+    const fileExists = (path) => stat(path).then(info => info.isFile() && info.size > 0).catch(() => false);
+    const probeAvailable = (signal) => {
+        if (signal.aborted || !shotSupported())
+            return Promise.resolve(false);
+        if (checked)
+            return Promise.resolve(!!windowProbePath);
+        if (probing)
+            return probing;
+        probing = resolveNativeProbe({
+            name: 'window-list',
+            packagedPath: resolveWindowProbe(),
+            sourcePath: fileURLToPath(new URL('../../native/window-list.c', import.meta.url)),
+            cacheDir: join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'selection-explain'),
+            frameworks: ['CoreFoundation', 'CoreGraphics'],
+            compile: async (source, output, frameworks) => {
+                const flags = ['-O2', ...frameworks.flatMap(name => ['-framework', name]), source, '-o', output];
+                const xcode = '/Applications/Xcode.app/Contents/Developer';
+                const compiler = join(xcode, 'Toolchains/XcodeDefault.xctoolchain/usr/bin/clang');
+                try {
+                    await access(compiler);
+                    const env = { ...process.env, DEVELOPER_DIR: xcode };
+                    const sdk = await run('xcrun', ['--sdk', 'macosx', '--show-sdk-path'], signal, 15000, env);
+                    if (!sdk.failed && sdk.stdout.trim()) {
+                        const built = await run(compiler, ['-isysroot', sdk.stdout.trim(), ...flags], signal, 60000, env);
+                        if (!built.failed && await fileExists(output) && !signal.aborted)
+                            return true;
+                    }
+                }
+                catch { /* Xcode is optional. */ }
+                for (const [command, args] of [['clang', flags], ['xcrun', ['clang', ...flags]]]) {
+                    if (signal.aborted)
+                        return false;
+                    if (!(await run(command, [...args], signal, 60000)).failed && await fileExists(output) && !signal.aborted)
+                        return true;
+                }
+                return false;
+            },
+        }).then(path => {
+            if (signal.aborted)
+                return false;
+            windowProbePath = path;
+            checked = true;
+            return !!path;
+        }).finally(() => { probing = undefined; });
+        return probing;
+    };
+    const probeJson = async (args, signal) => {
+        if (!await probeAvailable(signal) || signal.aborted)
+            return [];
+        const result = await run(windowProbePath, args, signal);
+        if (result.failed || signal.aborted)
+            return [];
+        try {
+            const items = JSON.parse(result.stdout);
+            return Array.isArray(items) ? items : [];
+        }
+        catch {
+            return [];
+        }
+    };
+    const pngSize = async (path) => { try {
+        return parsePngSize(await readFile(path));
+    }
+    catch {
+        return null;
+    } };
+    return {
+        supported: shotSupported, probeAvailable, run, fileExists, readFile, pngSize,
+        async settle() {
+            await probing?.catch(() => { });
+            while (commands.size)
+                await Promise.allSettled([...commands]);
+        },
+        async createTempDir() {
+            const dir = await mkdtemp(join(tmpdir(), 'dsh-selection-explain-'));
+            await chmod(dir, 0o700);
+            return dir;
+        },
+        async remove(path, recursive = false) { await rm(path, { recursive, force: true }).catch(() => { }); },
+        async prune(dir, seq) {
+            const names = await readdir(dir).catch(() => []);
+            await Promise.all(names.filter(name => {
+                const match = /^(?:region|shot|display)-(\d+)\.png$/.exec(name);
+                return match && Number(match[1]) <= seq - 3;
+            }).map(name => rm(join(dir, name), { force: true }).catch(() => { })));
+        },
+        async rectFromXattr(path, signal) {
+            const result = await run('/usr/bin/xattr', ['-px', 'com.apple.metadata:kMDItemScreenCaptureGlobalRect', path], signal);
+            return result.failed || signal.aborted ? null : parseRectXattr(result.stdout);
+        },
+        async listWindows(signal) {
+            return (await probeJson([], signal)).filter((item) => {
+                const w = item;
+                return !!w && [w.id, w.x, w.y, w.w, w.h, w.layer].every(Number.isFinite) && w.w > 0 && w.h > 0 && typeof w.owner === 'string';
+            });
+        },
+        async listDisplays(signal) {
+            return (await probeJson(['--displays'], signal)).filter((item) => {
+                const d = item;
+                return !!d && [d.x, d.y, d.w, d.h].every(Number.isFinite) && Number(d.w) > 0 && Number(d.h) > 0;
+            }).map(d => ({ id: Number(d.id) || 0, x: Number(d.x), y: Number(d.y), w: Number(d.w), h: Number(d.h), index: Number(d.index) || 0, main: d.main === true || Number(d.main) === 1 }));
+        },
+    };
+}
+//# sourceMappingURL=shot-platform.js.map

package/lib/host/shot-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shot-platform.js","sourceRoot":"","sources":["../../src/host/shot-platform.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAIjE,MAAM,KAAK,GAAG,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;AAEtD,iGAAiG;AACjG,MAAM,UAAU,mBAAmB,CAAC,SAAuB,KAAK;IAC9D,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC7E,MAAM,MAAM,GAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;QAClH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,OAAM;QAAC,CAAC;QACpE,IAAI,KAAmB,CAAA;QACvB,IAAI,CAAC;YAAC,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;QAAC,CAAC;QACjF,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,OAAM;QAAC,CAAC;QACtD,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,UAAsC,CAAA;QAC1C,IAAI,QAAoC,CAAA;QACxC,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,YAAY,CAAC,UAAU,CAAC,CAAA;YACxB,YAAY,CAAC,QAAQ,CAAC,CAAA;YACtB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC1C,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QACxB,CAAC,CAAA;QACD,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,IAAI,OAAO,IAAI,UAAU;gBAAE,OAAM;YACjC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAA;YACpB,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;YAC3D,IAAI,OAAO;gBAAE,OAAM;YACnB,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC3B,IAAI,CAAC;oBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;gBAC3D,IAAI,OAAO;oBAAE,OAAM;gBACnB,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;gBAClC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACjB,CAAC,EAAE,GAAG,CAAC,CAAA;YACP,KAAK,CAAC,UAAU,CAAC,CAAA;QACnB,CAAC,CAAA;QACD,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,SAAS,EAAE,CAAA;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,SAAS,EAAE,CAAA,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QAChF,KAAK,CAAC,KAAK,CAAC,CAAA;QACZ,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACvD,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;YAC/B,IAAI,OAAO;gBAAE,OAAM;YACnB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI;gBAAE,SAAS,EAAE,CAAA;;gBACzE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI;YAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QACxJ,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,MAAM,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;QAC7D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;YACvC,IAAI,OAAO;gBAAE,OAAM;YACnB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;YAClB,MAAM,CAAC,MAAM,GAAG,UAAU,CAAA;YAC1B,MAAM,CAAC,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;YAC5C,MAAM,EAAE,CAAA;QACV,CAAC,CAAC,CAAA;QACF,uEAAuE;QACvE,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,KAAc,OAAO,QAAQ,EAAE,KAAK,QAAQ,CAAA,CAAC,CAAC;AAC3E,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAyB,mBAAmB,EAAE;IAClF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAClD,MAAM,GAAG,GAAkB,CAAC,GAAG,IAAI,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;QAChC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACrB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QACjF,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IACD,IAAI,eAAe,GAAG,EAAE,CAAA;IACxB,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,OAAqC,CAAA;IACzC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IAC/G,MAAM,cAAc,GAAG,CAAC,MAAmB,EAAoB,EAAE;QAC/D,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,aAAa,EAAE;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACrE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAA;QACtD,IAAI,OAAO;YAAE,OAAO,OAAO,CAAA;QAC3B,OAAO,GAAG,kBAAkB,CAAC;YAC3B,IAAI,EAAE,aAAa;YACnB,YAAY,EAAE,kBAAkB,EAAE;YAClC,UAAU,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjF,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC;YACpF,UAAU,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE;gBAC5C,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;gBAChG,MAAM,KAAK,GAAG,4CAA4C,CAAA;gBAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,mDAAmD,CAAC,CAAA;gBACjF,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAA;oBACtB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,CAAA;oBACpD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;oBAC1F,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;wBACrC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;wBACjG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;4BAAE,OAAO,IAAI,CAAA;oBAC/E,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;gBACpC,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAU,EAAE,CAAC;oBAC1F,IAAI,MAAM,CAAC,OAAO;wBAAE,OAAO,KAAK,CAAA;oBAChC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;wBAAE,OAAO,IAAI,CAAA;gBACxH,CAAC;gBACD,OAAO,KAAK,CAAA;YACd,CAAC;SACF,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACb,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAA;YAChC,eAAe,GAAG,IAAI,CAAA;YACtB,OAAO,GAAG,IAAI,CAAA;YACd,OAAO,CAAC,CAAC,IAAI,CAAA;QACf,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,SAAS,CAAA,CAAC,CAAC,CAAC,CAAA;QACzC,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IACD,MAAM,SAAS,GAAG,KAAK,EAAE,IAAc,EAAE,MAAmB,EAAsB,EAAE;QAClF,IAAI,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAA;QAC9D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QACvD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAA;QAC9C,IAAI,CAAC;YAAC,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAAC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAA;QAAC,CAAC;IACxH,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE,GAAG,IAAI,CAAC;QAAC,OAAO,YAAY,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAA;IAAC,CAAC,CAAC,CAAC,CAAA;IACnH,OAAO;QACL,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO;QAC5E,KAAK,CAAC,MAAM;YACV,MAAM,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAC9B,OAAO,QAAQ,CAAC,IAAI;gBAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAA;QAC/D,CAAC;QACD,KAAK,CAAC,aAAa;YACjB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAA;YACnE,MAAM,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvB,OAAO,GAAG,CAAA;QACZ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA,CAAC,CAAC;QACpG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG;YAClB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YAChD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;gBACpC,MAAM,KAAK,GAAG,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC/D,OAAO,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;YAC7C,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACvE,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;YAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,mDAAmD,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;YACtH,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC/E,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,MAAM;YACtB,OAAO,CAAC,MAAM,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAmB,EAAE;gBACpE,MAAM,CAAC,GAAG,IAAsB,CAAA;gBAChC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAA;YAC/H,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,MAAM;YACvB,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAgC,EAAE;gBAC7F,MAAM,CAAC,GAAG,IAAmC,CAAA;gBAC7C,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YACjG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;QACtL,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/host/shot-service.js

@@ -0,0 +1,127 @@
+/** Instance-owned task, event, and file lifetime; deliberately independent of HTTP. */
+import { captureShot, ShotCaptureError } from './shot-capture.js';
+export function createShotTasks(platform) {
+    const state = { available: false, reason: 'idle', capturing: false, total: 0, lastError: '' };
+    let pending = null;
+    let pendingError = null;
+    let lastShot = null;
+    let sequence = 0;
+    let stopped = false;
+    let tempDir;
+    let stopPromise;
+    const lifetime = new AbortController();
+    const waiters = new Set();
+    let active;
+    const notify = () => { const callbacks = [...waiters]; waiters.clear(); for (const callback of callbacks)
+        callback(); };
+    const ensureAvailable = () => {
+        state.available = !stopped && platform.supported();
+        state.reason = stopped ? 'stopped' : state.available ? 'ok' : 'not-macos';
+        return state.available;
+    };
+    const status = () => ({ ...state });
+    const clean = async (dir) => { await platform.remove(dir, true).catch(() => { }); };
+    async function start(options, rect) {
+        if (!ensureAvailable() || state.capturing)
+            return false;
+        state.capturing = true;
+        const task = { controller: new AbortController(), sequence: ++sequence };
+        active = task;
+        const current = () => !stopped && active === task && !task.controller.signal.aborted;
+        let dir;
+        try {
+            tempDir ??= platform.createTempDir();
+            dir = await tempDir;
+            if (!current()) {
+                await clean(dir);
+                return false;
+            }
+        }
+        catch (error) {
+            tempDir = undefined;
+            if (current()) {
+                state.lastError = `${rect ? 'start-failed' : 'tmp-failed'}: ${String(error?.message ?? error)}`;
+                state.capturing = false;
+                active = undefined;
+            }
+            return false;
+        }
+        const work = captureShot(platform, { ...options, seq: task.sequence }, dir, task.controller.signal, rect)
+            .then(async (result) => {
+            if (!current())
+                return false;
+            if (result) {
+                state.total++;
+                state.lastError = result.note;
+                pending = lastShot = result.shot;
+                pendingError = null;
+                state.capturing = false;
+                notify();
+                await platform.prune(dir, task.sequence).catch(() => { });
+            }
+            return !!result;
+        })
+            .catch((error) => {
+            if (!current())
+                return false;
+            const code = error instanceof ShotCaptureError ? error.code : rect ? 'start-failed' : 'finish-failed';
+            const message = error instanceof ShotCaptureError ? error.message : `截图已拍下，但处理失败：${String(error?.message ?? error)}`;
+            state.lastError = rect && !(error instanceof ShotCaptureError) ? `start-failed: ${String(error?.message ?? error)}` : code;
+            const finishError = error instanceof ShotCaptureError && !error.startup;
+            if (!rect || finishError) {
+                pendingError = { code, message, at: Date.now() };
+                state.capturing = false;
+                notify();
+            }
+            // The rect route historically reports startup success when finishing emits an error.
+            return !!rect && finishError;
+        })
+            .finally(async () => {
+            // Selection may finish before speculative window/display probes. Cancel
+            // those commands while this task still owns their cancellation signal.
+            task.controller.abort();
+            if (active === task) {
+                active = undefined;
+                state.capturing = false;
+            }
+            // An injected/uncooperative operation can resolve after disposal. Remove any late files too.
+            if (stopped)
+                await clean(dir);
+        });
+        if (rect)
+            return work;
+        void work;
+        return true;
+    }
+    function stop() {
+        if (stopPromise)
+            return stopPromise;
+        stopped = true;
+        lifetime.abort();
+        active?.controller.abort();
+        active = undefined;
+        state.capturing = false;
+        state.available = false;
+        state.reason = 'stopped';
+        pending = lastShot = null;
+        pendingError = null;
+        notify();
+        stopPromise = (async () => {
+            await platform.settle?.().catch(() => { });
+            if (tempDir)
+                await tempDir.then(clean).catch(() => { });
+        })();
+        return stopPromise;
+    }
+    return {
+        start, stop, status, ensureAvailable,
+        signal: lifetime.signal,
+        clearError() { pendingError = null; },
+        hasPending() { return !!pending || !!pendingError; },
+        takePending() { const result = { shot: pending, error: pendingError }; pending = null; pendingError = null; return result; },
+        findShot(id) { return pending?.id === id ? pending : lastShot?.id === id ? lastShot : null; },
+        lastShot() { return lastShot; },
+        subscribe(callback) { waiters.add(callback); return () => { waiters.delete(callback); }; },
+    };
+}
+//# sourceMappingURL=shot-service.js.map

package/lib/host/shot-service.js.map

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

package/lib/host/shot-types.js

@@ -0,0 +1,5 @@
+export const CAPTURE = '/usr/sbin/screencapture';
+export const SELECT_TIMEOUT_MS = 90_000;
+export const MAX_MARGIN_PT = 400;
+export const DEFAULT_SHOT_CONFIG = { shotCardScope: 'window', shotPanelScope: 'selection', shotMargin: 48 };
+//# sourceMappingURL=shot-types.js.map

package/lib/host/shot-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shot-types.js","sourceRoot":"","sources":["../../src/host/shot-types.ts"],"names":[],"mappings":"AAuDA,MAAM,CAAC,MAAM,OAAO,GAAG,yBAAyB,CAAA;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAA;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA"}

package/lib/host/shot.js

@@ -0,0 +1,136 @@
+import { readBody, sendJson } from './http.js';
+import { createMacShotPlatform } from './shot-platform.js';
+import { createShotTasks } from './shot-service.js';
+import { resolveOptions } from './shot-geometry.js';
+import { DEFAULT_SHOT_CONFIG } from './shot-types.js';
+export { resolveWindowProbe, shotSupported } from './shot-platform.js';
+export function createShotService(config = DEFAULT_SHOT_CONFIG, dependencies = {}) {
+    const platform = dependencies.platform ?? createMacShotPlatform();
+    const tasks = createShotTasks(platform);
+    let clientHello = null;
+    const clientReports = {};
+    async function handleShotStart(req, res) {
+        if (req.method !== 'POST') {
+            sendJson(res, 405, { ok: false, reason: 'method-not-allowed' });
+            return;
+        }
+        tasks.clearError();
+        const url = new URL(req.url || '/', 'http://localhost');
+        const mode = url.searchParams.get('mode') === 'panel' ? 'panel' : 'card';
+        await readBody(req, 64 * 1024).catch(() => '');
+        if (!tasks.ensureAvailable()) {
+            sendJson(res, 200, { ok: false, reason: tasks.status().reason });
+            return;
+        }
+        if (tasks.status().capturing) {
+            sendJson(res, 200, { ok: false, reason: 'busy' });
+            return;
+        }
+        const options = resolveOptions(config, mode, url);
+        const n = url.searchParams.get('rect')?.split(',').map(Number);
+        const rect = n?.length === 4 && n.every(Number.isFinite) && n[2] > 0 && n[3] > 0
+            ? { x: n[0], y: n[1], width: n[2], height: n[3] } : undefined;
+        const started = await tasks.start(options, rect);
+        sendJson(res, 200, {
+            ok: started, ...(rect ? { test: true } : {}), mode, scope: options.scope, margin: options.margin,
+            ...(started ? {} : { reason: tasks.status().lastError || 'start-failed' }),
+        });
+    }
+    function handleShotPending(req, res) {
+        const reply = () => sendJson(res, 200, { ok: true, ...tasks.takePending(), status: tasks.status() });
+        if (tasks.hasPending() || tasks.signal.aborted) {
+            reply();
+            return;
+        }
+        let finished = false;
+        let unsubscribe;
+        const clear = () => {
+            clearTimeout(timer);
+            unsubscribe?.();
+            req.removeListener('aborted', disconnect);
+            res.removeListener('close', disconnect);
+        };
+        const done = () => { if (finished)
+            return; finished = true; clear(); reply(); };
+        const disconnect = () => { if (finished)
+            return; finished = true; clear(); };
+        const timer = setTimeout(done, 25_000);
+        timer.unref();
+        req.once('aborted', disconnect);
+        // IncomingMessage.close also occurs for a normally completed GET body. Response.close
+        // identifies the socket/response lifetime without prematurely removing every long-poll.
+        res.once('close', disconnect);
+        unsubscribe = tasks.subscribe(done);
+    }
+    async function handleShotImage(req, res) {
+        const id = new URL(req.url || '/', 'http://localhost').searchParams.get('id') || '';
+        const shot = tasks.findShot(id);
+        if (!shot) {
+            res.statusCode = 404;
+            res.end('shot-not-found');
+            return;
+        }
+        if (!shot.ready) {
+            res.statusCode = 404;
+            res.end('not-ready');
+            return;
+        }
+        try {
+            const buf = await platform.readFile(shot.imagePath);
+            if (res.destroyed)
+                return;
+            if (tasks.signal.aborted) {
+                res.statusCode = 404;
+                res.end('shot-not-found');
+                return;
+            }
+            res.statusCode = 200;
+            res.setHeader('content-type', 'image/png');
+            res.setHeader('cache-control', 'no-store');
+            res.end(buf);
+        }
+        catch {
+            if (!res.destroyed) {
+                res.statusCode = tasks.signal.aborted ? 404 : 500;
+                res.end(tasks.signal.aborted ? 'shot-not-found' : 'read-failed');
+            }
+        }
+    }
+    async function handleShotHello(req, res) {
+        try {
+            const body = await readBody(req, Number.MAX_SAFE_INTEGER);
+            if (!tasks.signal.aborted) {
+                clientHello = JSON.parse(body || 'null');
+                const stage = clientHello?.stage;
+                if (stage)
+                    clientReports[stage] = clientHello;
+            }
+        }
+        catch {
+            if (!tasks.signal.aborted)
+                clientHello = { parseError: true };
+        }
+        if (!res.destroyed)
+            sendJson(res, 200, { ok: true });
+    }
+    async function handleShotStatus(_req, res) {
+        tasks.ensureAvailable();
+        const probe = await platform.probeAvailable(tasks.signal);
+        const last = tasks.lastShot();
+        sendJson(res, 200, {
+            ok: true, status: tasks.status(), windowProbe: probe, clientHello, clientReports,
+            lastShot: last ? {
+                id: last.id, scope: last.scope, mode: last.mode, frame: last.frame, ready: last.ready,
+                ageMs: Date.now() - last.at, owner: last.owner, rect: last.rect, pad: last.pad,
+                scale: last.scale, selectionRect: last.selectionRect, windowRect: last.windowRect,
+            } : null,
+        });
+    }
+    return {
+        handleShotStart, handleShotPending, handleShotImage, handleShotHello, handleShotStatus,
+        status: tasks.status,
+        async stop() { clientHello = null; for (const stage of Object.keys(clientReports))
+            delete clientReports[stage]; await tasks.stop(); },
+    };
+}
+//# sourceMappingURL=shot.js.map

package/lib/host/shot.js.map

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

package/lib/prompts.js

@@ -124,7 +124,60 @@ export const DETAIL_PROMPT = [
     '是后者就先说一句，再按它实际的意思解释。）',
     '选中文字是单个英文单词时，带上音标（IPA；英式美式不同就都写，拿不准就不写）。',
 ].join('\n');
-/** 追问模式（对话小窗）的系统提示词：不再要求两节结构，就是围绕这段文字聊天。 */
+function shotFocusWording(scope, frame) {
+    if (!frame || scope === 'selection')
+        return '**这张图里的对象**';
+    return '**红框圈出的那个对象**';
+}
+function shotIntro(scope, frame) {
+    if (!frame || scope === 'selection') {
+        return '用户在 DSH 里按了截图快捷键，发来一张截图。这张图**就是**他框选的那块区域本身，同时提出一个问题。';
+    }
+    if (scope === 'margin') {
+        return '用户在 DSH 里按了截图快捷键，发来一张截图。这张图是选区加上周围留白：红色实线框内是选区，框外那一圈是他特意保留的周边内容。';
+    }
+    if (scope === 'screen') {
+        return '用户在 DSH 里按了截图快捷键，发来一张截图。这张图是他框选时所在的整块屏幕，红色实线框出了他关心的那一块。';
+    }
+    return '用户在 DSH 里按了截图快捷键，发来一张截图，并用红色实线框出了他关心的那一块，同时提出一个问题。';
+}
+function shotFocusRule(scope, frame) {
+    if (!frame || scope === 'selection') {
+        return '- 以**图里的内容**为依据回答；整张图就是他关心的地方。';
+    }
+    if (scope === 'margin' || scope === 'screen') {
+        return '- 以**图里的内容**为依据回答；红框内是问题的焦点，框外是它所在的位置（上下文）。';
+    }
+    return '- 以**图里的内容**为依据回答；红框标出的是问题的焦点，红框周围的界面是上下文。';
+}
+/** 按取景范围生成标题提示词（没有框时改用“这张图里的…”口径，不把注意力引到不存在的标记上）。 */
+export function shotTitlePromptFor(scope, frame) {
+    return [
+        '现在只做一件事：给这次对话起个名字。',
+        '',
+        '要求：',
+        `- 概括${shotFocusWording(scope, frame)}，不超过 20 个字（能短则短；是文字就取最关键的几个字，是图案就说清它是什么）。`,
+        '- 只输出这几个字本身：不要引号、不要标点、不要前缀、不要解释、不要调用任何工具。',
+    ].join('\n');
+}
+export const SHOT_TITLE_PROMPT = shotTitlePromptFor('window', true);
+/** 按取景范围生成回答用的 system prompt。 */
+export function shotPromptFor(scope, frame) {
+    const noFrame = !frame || scope === 'selection';
+    return [
+        shotIntro(scope, frame),
+        '',
+        '回答要求：',
+        shotFocusRule(scope, frame),
+        noFrame
+            ? '- 不要说"这段文字""这段代码"这种指代（用户没选中任何文字，只有一张图）；需要提及时说"图里的…"。'
+            : '- 不要说"这段文字""这段代码"这种指代（用户没选中任何文字，只有一张图）；需要提及时说"框里的…"。',
+        '- 不要输出翻译或"解读"的格式；直接回答问题本身。',
+        '- 看不清就说看不清（图可能被压缩过），不要猜内容。',
+        '- 需要外部信息时才用工具；能用图里内容回答的，不要联网。',
+    ].join('\n');
+}
+export const SHOT_PROMPT = shotPromptFor('window', true);
 export const CHAT_SYSTEM_PROMPT = [
     '你是 DeepSeek Harness 中「划词解读」小窗里的助手，正在辅助用户对一段【选中文字】及其上下文进行理解。',
     '用户问什么就答什么：可以问这段文字本身，也可以顺着它问到别的，不必把话题拉回选中文字。',

package/lib/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,+BAA+B;AAC/B,iCAAiC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,mDAAmD;IACnD,oCAAoC;IACpC,4CAA4C;IAC5C,+CAA+C;IAC/C,mDAAmD;IACnD,EAAE;IACF,iDAAiD;CAClD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,mBAAmB;AACnB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW;IACX,EAAE;IACF,uCAAuC;IACvC,+CAA+C;IAC/C,EAAE;IACF,sCAAsC;IACtC,gDAAgD;IAChD,sDAAsD;IACtD,wBAAwB;IACxB,4DAA4D;IAC5D,yDAAyD;IACzD,gEAAgE;IAChE,qDAAqD;IACrD,mCAAmC;IACnC,sDAAsD;IACtD,+CAA+C;IAC/C,0BAA0B;IAC1B,kDAAkD;IAClD,8BAA8B;IAC9B,4BAA4B;IAC5B,kEAAkE;IAClE,iEAAiE;IACjE,uDAAuD;IACvD,qCAAqC;IACrC,qFAAqF;IACrF,kCAAkC;IAClC,EAAE;IACF,gDAAgD;IAChD,wCAAwC;IACxC,2CAA2C;IAC3C,EAAE;IACF,+CAA+C;IAC/C,0BAA0B;IAC1B,wCAAwC;IACxC,qBAAqB;IACrB,kCAAkC;IAClC,wCAAwC;IACxC,EAAE;IACF,KAAK;IACL,gCAAgC;IAChC,oCAAoC;IACpC,uDAAuD;IACvD,iBAAiB;IACjB,8BAA8B;IAC9B,qDAAqD;IACrD,gBAAgB;CACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,6CAA6C;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,EAAE;IACF,+CAA+C;IAC/C,EAAE;IACF,OAAO;IACP,kDAAkD;IAClD,8BAA8B;IAC9B,EAAE;IACF,KAAK;IACL,wBAAwB;IACxB,UAAU;IACV,cAAc;IACd,UAAU;IACV,KAAK;IACL,EAAE;IACF,OAAO;IACP,0DAA0D;IAC1D,2EAA2E;IAC3E,mCAAmC;IACnC,kDAAkD;IAClD,kCAAkC;IAClC,8BAA8B;IAC9B,yDAAyD;IACzD,EAAE;IACF,8BAA8B;IAC9B,2BAA2B;IAC3B,2CAA2C;IAC3C,iCAAiC;IACjC,+BAA+B;IAC/B,mCAAmC;IACnC,EAAE;IACF,KAAK;IACL,0CAA0C;IAC1C,0CAA0C;IAC1C,uBAAuB;IACvB,8BAA8B;CAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,iCAAiC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,WAAW;IACX,EAAE;IACF,+CAA+C;IAC/C,EAAE;IACF,OAAO;IACP,2CAA2C;IAC3C,4CAA4C;IAC5C,uBAAuB;IACvB,0CAA0C;CAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,6DAA6D;IAC7D,6CAA6C;IAC7C,0CAA0C;IAC1C,sDAAsD;IACtD,oDAAoD;IACpD,gDAAgD;IAChD,oDAAoD;IACpD,4BAA4B;IAC5B,4DAA4D;IAC5D,mDAAmD;CACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/lib/settings.js

@@ -8,11 +8,11 @@ export const SETTINGS_GROUPS = [
         id: 'model', label: '模型',
         sections: [
             { "label": "模型", "keys": ["modelChoice"] },
-            { "label": "对话记忆", "keys": ["chatContextTokens"], "note": "容量允许时保留完整对话；接近预算时压缩较早问答，原始历史和附件仍保留。图片计入预算，不按固定张数淘汰。" },
+            { "label": "对话记忆", "keys": ["chatContextTokens"], "note": "默认输入预算为20万 tokens。接近预算时优先压缩较早问答；最近一组也放不下时会一并整理为摘要，原始历史和附件仍保留。图片计入预算，不按固定张数淘汰。" },
             { "label": "思考强度", "keys": ["translationReasoningEffort", "reasoningEffort", "chatReasoningEffort"], "note": "关闭思考仍会生成回答。" },
         ],
         items: [
-            { "key": "chatContextTokens", "kind": "number", "label": "对话输入预算", "hint": "按模型容量自动收紧，并为回答及工具结果预留空间；未知模型使用此预算。用量为估算。", "unit": "tokens", "min": CONFIG_LIMITS.chatContextTokens.min, "max": CONFIG_LIMITS.chatContextTokens.max, "step": 1024 },
+            { "key": "chatContextTokens", "kind": "number", "label": "对话输入预算", "hint": "按模型容量自动收紧，并为回答及工具结果预留空间；未知模型使用此预算。用量为估算。", "unit": "tokens", "min": CONFIG_LIMITS.chatContextTokens.min, "max": CONFIG_LIMITS.chatContextTokens.max, "step": 1 },
             { "key": "modelChoice", "kind": "model", "label": "模型", "hint": "", "keys": ["provider", "model"] },
             { "key": "translationReasoningEffort", "kind": "seg", "label": "首轮", "hint": "翻译 / 解读 / 注释", "options": ["off", "low", "high", "max"] },
             { "key": "reasoningEffort", "kind": "seg", "label": "次轮", "hint": "点击「展开详解」", "options": ["off", "low", "high", "max"] },
@@ -78,6 +78,17 @@ export const SETTINGS_GROUPS = [
             { "key": "voiceAutoSend", "kind": "switch", "label": "说完直接发送", "hint": "结束语音输入后，输入框里有字就直接发送（等于按发送键）。" },
         ],
     },
+    {
+        id: 'shot', label: '截图',
+        sections: [
+            { "label": "取景范围", "keys": ["shotCardScope", "shotPanelScope", "shotMargin"], "note": "两种模式的取景范围分开设置；留白两模式共用，仅「选区 + 留白」生效。" },
+        ],
+        items: [
+            { "key": "shotCardScope", "kind": "seg", "label": "小窗未打开时", "hint": "截图后弹语音卡时截取的范围。", "options": ["screen", "window", "margin", "selection"] },
+            { "key": "shotPanelScope", "kind": "seg", "label": "小窗已打开时", "hint": "截图直接进输入框附件时截取的范围。", "options": ["screen", "window", "margin", "selection"] },
+            { "key": "shotMargin", "kind": "number", "label": "选区留白", "hint": "向四周外扩的逻辑像素；仅「选区 + 留白」生效，外扩不会超出选区中心所在的那块屏。", "unit": "pt", "min": CONFIG_LIMITS.shotMargin.min, "max": CONFIG_LIMITS.shotMargin.max, "step": 8 },
+        ],
+    },
     {
         id: 'data', label: '数据',
         sections: [