dsh-plugin-live-shot 0.0.0-stage → 0.7.0-beta.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TangerineSplendor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,88 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# DSH Shot
+
+[![DSH Market 已收录](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-zh.svg)](https://dsh.market/)
+
+Windows screenshot and annotation plugin for DeepSeek Harness. Select the **live desktop**, capture only the selected region after releasing the mouse, then insert the image directly into the conversation draft.
+
+Windows 实时桌面截图插件：全局热键、窗口识别、选区调整、标注，以及直接插入 DSH 输入框。
+
+[Download Windows ZIP 0.7.0-beta.5](https://github.com/TangerineSplendor/dsh-screenshot/releases/download/v0.7.0-beta.5/dsh-shot-0.7.0-beta.5-windows-x64.zip) · [Release notes](https://github.com/TangerineSplendor/dsh-screenshot/releases/tag/v0.7.0-beta.5) · [DSH Market 已确认收录](https://github.com/2BingLing/dsh-market/issues/283#issuecomment-6379257821)
+
+**当前测试版为 `0.7.0-beta.5`。此版改用 Windows 原生预框选，改善本机视频/游戏框选可见性；游戏预框选 Esc 取消仍有已知问题，暂用右键退出。旧 beta.2 的相机/插图安装缺陷已在此前版本修复，该旧版已下架。**
+
+**Beta: 0.7.0-beta.5. Windows 10/11 x64, official DSH desktop only.** Tested on the developer's machine with isolated profiles; compatibility on other machines still needs feedback. macOS, Linux, browser-only DSH and remote Hosts are unsupported.
+
+## Install / 安装
+
+Install and open the official Windows DSH desktop app at least once. Keep DSH running during setup so the installer can find its executable.
+
+**ZIP, no additional Node.js required:** download [dsh-shot-0.7.0-beta.5-windows-x64.zip](https://github.com/TangerineSplendor/dsh-screenshot/releases/download/v0.7.0-beta.5/dsh-shot-0.7.0-beta.5-windows-x64.zip), extract it completely and run `install.bat`. The installer must print `Installed 0.7.0-beta.5`. If prompted, select your installed `DeepSeek Harness.exe`. Quit DSH completely from its tray menu and reopen it. Do not reuse a beta.2 ZIP or its extracted installer.
+
+**npm, for users who already have Node.js:**
+
+```powershell
+npx --yes --package=dsh-plugin-live-shot@0.7.0-beta.5 dsh-shot install
+```
+
+Alternatively, download the Release TGZ and use `npx --yes --package=./dsh-plugin-live-shot-0.7.0-beta.5.tgz dsh-shot install` from its folder. Use `dsh-shot install -DshExe "C:\Apps\DeepSeek Harness\DeepSeek Harness.exe"` if automatic detection fails. `-ProfileDir`, `-DshHome` and `-DataDir` support non-default installations. Then fully quit and reopen DSH.
+
+ZIP, npm and standard bundle installations all use `dsh-plugin-live-shot` as the installed directory, Loader entry, manifest name and Client module ID. The installer migrates the old `@local/dsh-shot` entry while preserving its settings and custom data directory. Beta.2 ZIP installations had a name mismatch that prevented the camera and image delivery from loading; upgrade with this installer and completely restart DSH. Standard bundle installations prepare the local runtime on first startup; if automatic discovery fails, use the explicit installer instead.
+
+安装无需管理员权限。ZIP 安装不需要额外 Node 或网络下载；npm 方式需要 Node 和网络获取插件包。辅助运行时均从你本机的 DSH 复制，首次约需数百 MB 空间，不修改 DSH 程序目录。DSH 升级后重新运行安装器。
+
+## Use / 使用
+
+- Click the camera in the composer, or press **Ctrl+Shift+X** from any program. The desktop remains live while selecting; no full-screen preview is captured.
+- Hover a window and click to select it, or drag a custom region. After release, move the selection with **↔** or resize its eight handles. Releasing a changed selection captures the new region.
+- Rectangle, ellipse, arrow, pen, mosaic, text, undo and PNG save are available.
+- **Enter / double-click / Done** inserts into the active DSH composer. **Ctrl+C** copies only. **Right-click** cancels. Esc works in the editor; preselection Esc in games remains a known issue.
+- **隐藏 DSH** remembers whether to hide DSH during capture. **Shift+camera** inverts that choice for one capture. Completion or cancellation restores hidden windows.
+- **⚙** changes the global shortcut. A conflict or save failure preserves the previous binding.
+
+## Known issue in this beta / 本版已知问题
+
+游戏预框选阶段 Esc 可能无效，暂用右键退出；松手后的编辑器 Esc 已获本机反馈正常。⚙ 中新增手动启用的「管理员游戏兼容」试验入口，需要本人确认 Windows 提示，仅本次辅助进程运行有效。**完整插件实测仍未解决该 Esc 问题，不能将此入口视为已修复或保证有效。**普通截图和安装不请求管理员权限。编辑后移动/调整选区仍使用 Electron，游戏焦点行为尚待进一步验证。
+
+本机用户已确认 B 站视频框选期间恢复可见、游戏原生拖选可用；这不是所有游戏或所有机器的兼容性保证。
+
+## Restart acceptance / 重启后三步验收
+
+1. Use the camera and the global hotkey; select over a moving clock or video and confirm the desktop stays live.
+2. Select a window, adjust the region and add annotations; enable **隐藏 DSH**, cancel and confirm DSH returns.
+3. Verify Enter inserts, Ctrl+C copies only, and saved hotkey/hide preferences survive another complete restart.
+
+## Uninstall / 卸载
+
+For the explicit installer, run `uninstall.bat`, or:
+
+```powershell
+npx --yes --package=dsh-plugin-live-shot@0.7.0-beta.5 dsh-shot uninstall
+```
+
+Then completely restart DSH. Default removal retains settings and local runtime. The optional `-RemoveData` also deletes the dedicated data directory, including images saved in its `captures` folder. For a non-default profile, pass the same `-ProfileDir` used to install. If installed as a standard DSH bundle, remove it through that bundle manager instead.
+
+Full path options and troubleshooting: [portable_readme.md](portable_readme.md).
+
+## Limits and local access
+
+One monitor per selection; no cross-monitor stitching or scrolling capture. Window detection covers top-level windows. Protected video and UAC secure desktops follow Windows restrictions. Capture occurs after hiding the overlay and waiting for composition, rather than promising the exact video frame at mouse release.
+
+The plugin registers a global hotkey, reads pointer/window geometry, captures the region you select, and writes the clipboard or a PNG only when requested. It uses an authenticated random-token loopback connection between its local processes. The dedicated Electron helper uses `--no-sandbox` and a local page with context isolation and a network-blocking CSP; it must not load remote pages. The plugin does not upload screenshots or read account keys.
+
+Composer delivery uses DSH's current paste/drop DOM behavior; version changes may require adaptation. Report DSH/Windows versions, monitor scaling, RDP use and the error message in [Issues](https://github.com/TangerineSplendor/dsh-screenshot/issues). Do not attach account settings or private screenshots.
+
+## Development
+
+No npm dependencies or build step. Runtime files and machine-specific configuration are excluded from public artifacts. On Windows with Node:
+
+```powershell
+node --experimental-vm-modules tests/host_test.mjs
+node tests/selection_settings_test.mjs
+node tests/client_install_test.mjs
+node tests/worker_test.mjs
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build_portable.ps1
+```
+
+The worker test captures a small region locally without writing it to disk. Integration tests require an installed DSH and should use isolated profiles.
+
+MIT license for this plugin. DSH/Electron binaries are not included; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). This is an independent community plugin.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,7 @@
+# Third-party runtime notice
+
+This test archive contains plugin source and installation scripts. It does not include a DSH or Electron binary distribution.
+
+During installation the scripts copy runtime files from the recipient's existing DeepSeek Harness installation into a dedicated local plugin data directory. The original installation is not modified. Available `LICENSE.electron.txt` and `LICENSES.chromium.html` files are copied with that runtime. Other notices in the original DSH installation remain applicable to its components.
+
+This package uses the Windows PowerShell, .NET, Win32 and DWM facilities already present on the recipient's computer.

package/bin/dsh-shot.cjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process');
+const path = require('node:path');
+const [command, ...args] = process.argv.slice(2);
+if (!command || command === '--help' || command === '-h') {
+  console.log('DSH Shot for Windows x64\nUsage: dsh-shot install [PowerShell installer options]\n       dsh-shot uninstall [PowerShell uninstaller options]\nAfter installation or removal, quit DSH completely and reopen it.');
+} else if (!['install', 'uninstall'].includes(command)) {
+  console.error('Unknown command. Use dsh-shot --help.'); process.exitCode = 1;
+} else if (process.platform !== 'win32' || process.arch !== 'x64') {
+  console.error('DSH Shot requires Windows x64.'); process.exitCode = 1;
+} else {
+  const child = spawn('powershell.exe', ['-NoProfile', '-STA', '-ExecutionPolicy', 'Bypass', '-File',
+    path.join(__dirname, '..', command + '.ps1'), ...args], { stdio: 'inherit', windowsHide: true });
+  child.on('error', error => { console.error(error.message); process.exitCode = 1; });
+  child.on('close', code => { process.exitCode = code ?? 1; });
+}

package/capture_worker.ps1

@@ -0,0 +1,144 @@
+$ErrorActionPreference = 'Stop'
+Add-Type -AssemblyName System.Drawing
+Add-Type -TypeDefinition @"
+using System;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Threading;
+public static class ShotNative {
+  [StructLayout(LayoutKind.Sequential)] public struct Rect { public int Left, Top, Right, Bottom; }
+  public class WindowInfo { public int x, y, width, height; public long handle; public uint pid; }
+  [StructLayout(LayoutKind.Sequential)] public struct Point { public int X; public int Y; }
+  [DllImport("user32.dll")] public static extern IntPtr SetThreadDpiAwarenessContext(IntPtr value);
+  [DllImport("user32.dll")] public static extern bool SetProcessDPIAware();
+  [DllImport("user32.dll")] public static extern bool GetCursorPos(out Point point);
+  [DllImport("user32.dll")] public static extern short GetAsyncKeyState(int key);
+  [DllImport("dwmapi.dll")] public static extern int DwmFlush();
+  [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr window, int command);
+  [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr window);
+  [DllImport("user32.dll")] public static extern bool IsWindow(IntPtr window);
+  [DllImport("user32.dll")] public static extern bool IsWindowVisible(IntPtr window);
+  [DllImport("user32.dll")] public static extern bool IsIconic(IntPtr window);
+  [DllImport("user32.dll")] public static extern bool ShowWindowAsync(IntPtr window, int command);
+  [DllImport("user32.dll")] public static extern uint GetWindowThreadProcessId(IntPtr window, out uint pid);
+  public delegate bool EnumCallback(IntPtr window, IntPtr data);
+  [DllImport("user32.dll")] public static extern bool EnumWindows(EnumCallback callback, IntPtr data);
+  [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr window, out Rect rect);
+  [DllImport("dwmapi.dll", EntryPoint="DwmGetWindowAttribute")] public static extern int GetFrame(IntPtr window, int attribute, out Rect rect, int size);
+  [DllImport("dwmapi.dll", EntryPoint="DwmGetWindowAttribute")] public static extern int GetCloaked(IntPtr window, int attribute, out int value, int size);
+  public static WindowInfo WindowAt(int x, int y, uint excludePid) {
+    WindowInfo found = null;
+    EnumWindows(delegate(IntPtr window, IntPtr data) {
+      uint pid; GetWindowThreadProcessId(window, out pid);
+      int cloaked = 0; GetCloaked(window, 14, out cloaked, 4);
+      if (pid == excludePid || !IsWindowVisible(window) || IsIconic(window) || cloaked != 0) return true;
+      Rect rect;
+      if (GetFrame(window, 9, out rect, Marshal.SizeOf(typeof(Rect))) != 0 && !GetWindowRect(window, out rect)) return true;
+      if (rect.Right - rect.Left < 2 || rect.Bottom - rect.Top < 2) return true;
+      if (x >= rect.Left && x < rect.Right && y >= rect.Top && y < rect.Bottom) {
+        found = new WindowInfo { x=rect.Left, y=rect.Top, width=rect.Right-rect.Left, height=rect.Bottom-rect.Top, handle=window.ToInt64(), pid=pid };
+        return false;
+      }
+      return true;
+    }, IntPtr.Zero);
+    return found;
+  }
+  private static Dictionary<long, uint> hidden = new Dictionary<long, uint>();
+  public static long[] HideProcessWindows(uint pid) {
+    List<long> handles = new List<long>();
+    EnumWindows(delegate(IntPtr window, IntPtr data) {
+      uint owner;
+      GetWindowThreadProcessId(window, out owner);
+      // Minimized windows already expose the desktop; leave them untouched.
+      if (owner == pid && IsWindowVisible(window) && !IsIconic(window)) {
+        long handle = window.ToInt64(); hidden[handle] = pid; handles.Add(handle);
+        ShowWindowAsync(window, 0);
+      }
+      return true;
+    }, IntPtr.Zero);
+    Thread.Sleep(140);
+    DwmFlush();
+    foreach (long handle in handles) {
+      if (IsWindowVisible(new IntPtr(handle))) {
+        RestoreAll();
+        throw new InvalidOperationException("DSH window could not be hidden");
+      }
+    }
+    return handles.ToArray();
+  }
+  public static void RestoreWindows(long[] handles, uint pid) {
+    foreach (long handle in handles) {
+      IntPtr window = new IntPtr(handle); uint owner;
+      GetWindowThreadProcessId(window, out owner);
+      if (IsWindow(window) && owner == pid) ShowWindowAsync(window, 8);
+      hidden.Remove(handle);
+    }
+    Thread.Sleep(50);
+  }
+  public static void RestoreAll() {
+    foreach (KeyValuePair<long, uint> item in hidden) {
+      IntPtr window = new IntPtr(item.Key); uint owner;
+      GetWindowThreadProcessId(window, out owner);
+      if (IsWindow(window) && owner == item.Value) ShowWindowAsync(window, 8);
+    }
+    hidden.Clear();
+    Thread.Sleep(50);
+  }
+}
+"@
+try { [ShotNative]::SetThreadDpiAwarenessContext([IntPtr](-4)) | Out-Null }
+catch { [ShotNative]::SetProcessDPIAware() | Out-Null }
+[Console]::Out.WriteLine('READY')
+[Console]::Out.Flush()
+try {
+while ($null -ne ($line = [Console]::In.ReadLine())) {
+  if ($line -eq 'quit') { break }
+  $bitmap = $null
+  $graphics = $null
+  $stream = $null
+  try {
+    $cmd = $line | ConvertFrom-Json
+    if ($cmd.op -eq 'windowAt') {
+      $result = [ShotNative]::WindowAt([int]$cmd.x, [int]$cmd.y, [uint32]$cmd.excludePid)
+    } elseif ($cmd.op -eq 'hide') {
+      if ([int]$cmd.pid -le 0) { throw 'DSH shell process is unavailable' }
+      $handles = [ShotNative]::HideProcessWindows([uint32]$cmd.pid)
+      $result = @{ windows=@($handles | ForEach-Object { $_.ToString() }); pid=[int]$cmd.pid }
+    } elseif ($cmd.op -eq 'restore') {
+      [ShotNative]::RestoreWindows([long[]]@($cmd.windows), [uint32]$cmd.pid)
+      $result = @{ restored=$true }
+    } elseif ($cmd.op -eq 'focus') {
+      $target = [System.Diagnostics.Process]::GetProcessById([int]$cmd.pid)
+      $window = $target.MainWindowHandle
+      if ($window -ne [IntPtr]::Zero) {
+        if ([ShotNative]::IsIconic($window)) { [ShotNative]::ShowWindow($window, 9) | Out-Null }
+        else { [ShotNative]::ShowWindow($window, 8) | Out-Null }
+        [ShotNative]::SetForegroundWindow($window) | Out-Null
+      }
+      $result = @{ focused=($window -ne [IntPtr]::Zero) }
+    } elseif ($cmd.op -eq 'pointer') {
+      $point = New-Object ShotNative+Point
+      [ShotNative]::GetCursorPos([ref]$point) | Out-Null
+      $result = @{ x=$point.X; y=$point.Y; down=(([ShotNative]::GetAsyncKeyState(1) -band 0x8000) -ne 0) }
+    } elseif ($cmd.op -eq 'region') {
+      $w = [int]$cmd.width; $h = [int]$cmd.height
+      if ($w -lt 1 -or $h -lt 1 -or ([long]$w * $h) -gt 100000000) { throw 'Invalid region dimensions' }
+      [ShotNative]::DwmFlush() | Out-Null
+      $bitmap = New-Object System.Drawing.Bitmap $w, $h
+      $graphics = [System.Drawing.Graphics]::FromImage($bitmap)
+      $graphics.CopyFromScreen([int]$cmd.x, [int]$cmd.y, 0, 0, $bitmap.Size)
+      $stream = New-Object System.IO.MemoryStream
+      $bitmap.Save($stream, [System.Drawing.Imaging.ImageFormat]::Png)
+      $result = @{ png=[Convert]::ToBase64String($stream.ToArray()); width=$w; height=$h }
+    } else { throw 'Unknown operation' }
+    [Console]::Out.WriteLine((@{ ok=$true; result=$result } | ConvertTo-Json -Compress))
+  } catch {
+    [Console]::Out.WriteLine((@{ ok=$false; error=$_.Exception.Message } | ConvertTo-Json -Compress))
+  } finally {
+    if ($graphics) { $graphics.Dispose() }
+    if ($stream) { $stream.Dispose() }
+    if ($bitmap) { $bitmap.Dispose() }
+  }
+  [Console]::Out.Flush()
+}
+} finally { [ShotNative]::RestoreAll() }

package/client.js

@@ -0,0 +1,147 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-plugin-live-shot',
+  factory(require) {
+    const React = require('react'), h = React.createElement;
+    const client = sessionStorage.getItem('dsh-shot-client') || crypto.randomUUID();
+    sessionStorage.setItem('dsh-shot-client', client);
+    let running = false, stopped = false, retryAt = 0, errorShown = '', delivered = new Set();
+    let hidePreference = false, preferenceLoaded = false;
+    let hotkeyPreference = 'Ctrl+Shift+X', shortcutProblem = '', hotkeyRegistered = false;
+    let gameCompatibilityReady = false, gameCompatibilityEnabling = false;
+    const preferenceState = () => ({ value: hidePreference, ready: preferenceLoaded,
+      hotkey: hotkeyPreference, problem: shortcutProblem, registered: hotkeyRegistered,
+      gameCompatibilityReady, gameCompatibilityEnabling });
+    const preferenceListeners = new Set();
+    function toast(message) {
+      let el = document.getElementById('dsh-shot-toast');
+      if (!el) {
+        el = document.createElement('div'); el.id = 'dsh-shot-toast';
+        el.style.cssText = 'position:fixed;bottom:85px;left:50%;transform:translateX(-50%);z-index:2147483647;background:#222;color:white;padding:9px 16px;border-radius:8px;font:13px system-ui;pointer-events:none';
+        document.body.appendChild(el);
+      }
+      el.textContent = message; el.hidden = false;
+      clearTimeout(toast.timer); toast.timer = setTimeout(() => { el.hidden = true; }, 4500);
+    }
+    function deliver(file) {
+      const input = document.querySelector('[data-composer-input="true"]');
+      if (!input) return false;
+      input.focus();
+      const data = new DataTransfer(); data.items.add(file);
+      const paste = new ClipboardEvent('paste', { clipboardData: data, bubbles: true, cancelable: true });
+      if (!input.dispatchEvent(paste)) return true;
+      return !input.dispatchEvent(new DragEvent('drop', { dataTransfer: data, bubbles: true, cancelable: true }));
+    }
+    async function post(op, extra = {}) {
+      const response = await fetch('/api/dsh-shot/control', { method: 'POST', cache: 'no-store',
+        headers: { 'content-type': 'application/json' }, body: JSON.stringify({ op, client, focused: document.hasFocus(), ...extra }) });
+      const raw = await response.text();
+      let data;
+      try { data = JSON.parse(raw); }
+      catch (_) { throw new Error(response.status === 404 ? '截图 Host 接口未加载，请完整退出 DSH 后重开' : '截图服务返回异常（HTTP ' + response.status + '）'); }
+      if (!response.ok) throw new Error(data.error || '截图服务不可用');
+      if (typeof data.hideDsh === 'boolean') {
+        hidePreference = data.hideDsh; preferenceLoaded = true;
+        hotkeyPreference = data.hotkey || hotkeyPreference; shortcutProblem = data.hotkeyError || ''; hotkeyRegistered = !!data.registered;
+        gameCompatibilityReady = data.gameCompatibilityReady === true;
+        gameCompatibilityEnabling = data.gameCompatibilityEnabling === true;
+        for (const listener of preferenceListeners) listener(preferenceState());
+      }
+      return data;
+    }
+    async function poll() {
+      if (running || stopped) return;
+      running = true;
+      try {
+        const data = await post('poll', { skipImage: Date.now() < retryAt });
+        if (data.error && errorShown !== data.error) { errorShown = data.error; toast(data.error); }
+        if (data.hotkeyError && errorShown !== data.hotkeyError) { errorShown = data.hotkeyError; toast(data.hotkeyError); }
+        if (data.result && Date.now() >= retryAt) {
+          const item = data.result;
+          if (!delivered.has(item.id)) {
+            const bytes = Uint8Array.from(atob(item.png), c => c.charCodeAt(0));
+            if (!deliver(new File([bytes], 'shot-' + Date.now() + '.png', { type: 'image/png' }))) {
+              retryAt = Date.now() + 5000;
+              toast('未找到可接收图片的输入框；图片已保留，打开对话后自动重试');
+              await post('failure'); return;
+            }
+            delivered.add(item.id);
+            if (delivered.size > 100) delivered.delete(delivered.values().next().value);
+            toast('截图已插入输入框');
+          }
+          await post('ack', { id: item.id });
+        }
+      } catch (e) { /* A restarting Host is retried by the next poll. */ }
+      finally { running = false; }
+    }
+    function ShotButton() {
+      const [preference, setPreference] = React.useState(preferenceState());
+      const [saving, setSaving] = React.useState(false);
+      const [settingsOpen, setSettingsOpen] = React.useState(false);
+      const [shortcutDraft, setShortcutDraft] = React.useState(hotkeyPreference);
+      const [settingsError, setSettingsError] = React.useState('');
+      React.useEffect(() => {
+        preferenceListeners.add(setPreference);
+        setPreference(preferenceState());
+        return () => preferenceListeners.delete(setPreference);
+      }, []);
+      const changePreference = async event => {
+        const value = event.target.checked; setSaving(true);
+        try { await post('settings', { hideDsh: value }); }
+        catch (error) { toast(error.message); }
+        finally { setSaving(false); }
+      };
+      const saveShortcut = async () => {
+        setSaving(true); setSettingsError('');
+        try { const data = await post('settings', { hotkey: shortcutDraft }); setSettingsOpen(false); toast('截图快捷键：' + data.hotkey); }
+        catch (error) { setSettingsError(error.message); }
+        finally { setSaving(false); }
+      };
+      const enableGameCompatibility = async () => {
+        setSettingsError('');
+        try { await post('gameCompatibility'); toast('请确认 Windows 提示，启用后即可返回游戏截图'); }
+        catch (error) { setSettingsError(error.message); }
+      };
+      return h('span', { style: { display: 'inline-flex', alignItems: 'center', gap: 3, position: 'relative' } },
+        h('button', { type: 'button', title: '实时桌面截图（全局 ' + preference.hotkey + '）\nShift+点击：本次反向切换隐藏 DSH',
+        'aria-label': '截图', onClick: event => {
+          void post('start', event.shiftKey ? { hideDsh: !hidePreference } : {}).catch(e => toast(e.message));
+        },
+        style: { border: 0, background: 'transparent', color: 'inherit', cursor: 'pointer', width: 28, height: 28 } },
+        h('svg', { width: 18, height: 18, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 1.7 },
+          h('path', { d: 'M3 7h4l2-3h6l2 3h4v13H3z' }), h('circle', { cx: 12, cy: 13, r: 4 }))),
+        h('label', { title: '截图前隐藏 DSH，完成或取消后恢复；全局热键也使用此设置',
+          style: { display: 'inline-flex', alignItems: 'center', gap: 3, fontSize: 11, whiteSpace: 'nowrap', cursor: 'pointer' } },
+          h('input', { type: 'checkbox', checked: preference.value, disabled: saving || !preference.ready,
+            onChange: changePreference, 'aria-label': '截图时隐藏 DSH', style: { margin: 0, accentColor: '#07a953' } }), '隐藏 DSH'),
+        h('button', { type: 'button', 'aria-label': '截图设置', title: '设置截图快捷键',
+          disabled: !preference.ready, style: { border: 0, background: 'transparent', color: 'inherit', cursor: 'pointer', padding: '2px 5px' },
+          onClick: () => { setSettingsOpen(!settingsOpen); setShortcutDraft(preference.hotkey); setSettingsError(''); } }, '⚙'),
+        settingsOpen && h('div', { role: 'dialog', 'aria-label': '截图快捷键设置',
+          style: { position: 'absolute', bottom: 'calc(100% + 8px)', left: 0, width: 285, zIndex: 1000,
+            background: '#fff', color: '#222', border: '1px solid #ddd', borderRadius: 8, padding: 12, boxShadow: '0 4px 20px #0003', font: '13px system-ui' } },
+          h('label', { style: { display: 'block' } }, '全局截图快捷键',
+            h('input', { type: 'text', value: shortcutDraft, 'aria-label': '全局截图快捷键', placeholder: 'Ctrl+Alt+A',
+              style: { display: 'block', boxSizing: 'border-box', width: '100%', marginTop: 6, padding: 6, color: '#222', background: '#fff', border: '1px solid #aaa', borderRadius: 4 },
+              onChange: event => setShortcutDraft(event.target.value),
+              onKeyDown: event => { if (event.key === 'Enter') { event.preventDefault(); void saveShortcut(); } if (event.key === 'Escape') setSettingsOpen(false); } })),
+          h('div', { style: { fontSize: 11, color: '#666', margin: '6px 0' } }, '例如 Ctrl+Alt+A、Ctrl+Shift+X、F8'),
+          h('div', { style: { borderTop: '1px solid #ddd', paddingTop: 8, marginBottom: 8 } },
+            h('button', { type: 'button', disabled: preference.gameCompatibilityReady || preference.gameCompatibilityEnabling,
+              onClick: () => { void enableGameCompatibility(); } },
+              preference.gameCompatibilityReady ? '游戏兼容已启用' : preference.gameCompatibilityEnabling ? '等待 Windows 确认…' : '启用管理员游戏兼容'),
+            h('div', { style: { fontSize: 11, color: '#666', marginTop: 5 } }, '用于游戏中 Esc 无法取消选框的情况。需确认 Windows 提示；仅本次运行有效。')),
+          (settingsError || preference.problem) && h('div', { role: 'alert', style: { color: '#b22', marginBottom: 6 } }, settingsError || preference.problem),
+          h('div', { style: { display: 'flex', gap: 6 } },
+            h('button', { type: 'button', disabled: saving, onClick: () => { void saveShortcut(); } }, '保存'),
+            h('button', { type: 'button', disabled: saving, onClick: () => setShortcutDraft('Ctrl+Shift+X') }, '恢复默认'),
+            h('button', { type: 'button', onClick: () => setSettingsOpen(false) }, '取消'))));
+    }
+    return { inject: ['slots'], apply(ctx) {
+      ctx.slots.inject('conversation.input.left', () => ctx.slots.register({ name: 'conversation.input.left', id: 'dsh-shot', order: 20 }, ShotButton));
+      ctx.effect(() => {
+        stopped = false; void poll(); const timer = setInterval(() => { void poll(); }, 700);
+        return () => { stopped = true; clearInterval(timer); document.getElementById('dsh-shot-toast')?.remove(); };
+      });
+    } };
+  },
+});

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-shot
+      name: 'dsh-plugin-live-shot'