dsh-desktop-control 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qingying012
+
+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,97 @@
-# Temporary Holding Version
+# dsh-desktop-control
 
-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.
+A [DeepSeek Harness](https://github.com/deepseek-ai) plugin that gives the model a native
+`desktop` tool: **screenshot the Windows screen, move/click the mouse, type text and key combos**.
+
+It wraps the battle-tested `gui.ps1` script (screenshot + Win32 input) as a DSH plugin, so the
+model calls a typed tool instead of assembling PowerShell commands every time.
+
+> Windows only. The package ships its own `assets/gui.ps1` (UTF-8 with BOM); it does not depend on
+> a workspace script.
+
+## Actions
+
+| action | What it does | Main args |
+| :-- | :-- | :-- |
+| `screenshot` | Save a PNG and return its absolute path | `window` / `region` / `print` |
+| `windows` | List visible windows (HWND, PID, rect, title) | — |
+| `click` | Move and click | `x` `y` `button` `count` |
+| `move` | Move the cursor | `x` `y` |
+| `drag` | Press, move, release | `x` `y` `x2` `y2` |
+| `scroll` | Wheel | `x` `y` `amount` |
+| `type` | Paste text via the clipboard | `text` |
+| `key` | Key combo, e.g. `ctrl+s`, `alt+f4` | `key` |
+| `activate` | Bring a window to the front | `window` |
+| `pos` | Cursor position | — |
+| `wait` | Sleep | `waitMs` |
+
+**All coordinates are physical pixels**, matching the saved screenshot one-to-one (the script
+enables per-monitor DPI awareness v2).
+
+Typical loop:
+
+```text
+screenshot -> read_image -> click / type -> screenshot again
+```
+
+## Install
+
+Client (Electron): **Plugins → + Add plugin**, paste `dsh-desktop-control`, install, then
+**Enable now**.
+
+CLI profile:
+
+```powershell
+dsh plugin --profile web add dsh-desktop-control
+```
+
+## Configure
+
+```yaml
+- id: dsh-desktop-control
+  name: dsh-desktop-control
+  config:
+    enabled: true
+    powershellPath: powershell.exe
+    timeoutMs: 30000
+    screenshotDir: ''   # empty = $DSH_HOME/desktop-control
+```
+
+| Option | Default | Meaning |
+| :-- | :-- | :-- |
+| `enabled` | `true` | `false` registers no tool |
+| `powershellPath` | `powershell.exe` | PowerShell executable |
+| `timeoutMs` | `30000` | Per-call timeout |
+| `screenshotDir` | `$DSH_HOME/desktop-control` | Where screenshots are saved |
+
+## Why a plugin instead of the pwsh tool
+
+The DSH pwsh tool runs children at Low integrity, so `SetCursorPos` / `SendInput` are often
+refused and the old script needed `danger-full-access` per approval. This plugin spawns
+PowerShell from the host process, outside that sandbox, so input usually works without switching
+the permission preset.
+
+## Safety
+
+- Full desktop control: it can click anything and type anything, and screenshots enter the
+  model context once you open them with `read_image`.
+- Do not enable it on an unattended machine.
+- UAC secure desktop, the lock screen, and some games/anti-cheat/terminal apps cannot be driven.
+
+## Self-test
+
+```powershell
+npm run selftest
+```
+
+Pure argument-construction tests: no screenshot, no mouse movement.
+
+## Limitations
+
+- Windows only.
+- One action per call; each call spawns PowerShell (~300–600 ms).
+- Static screenshots; the cursor marker is not exposed by the tool.
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,103 @@
+# dsh-desktop-control
+
+一个 [DeepSeek Harness](https://github.com/deepseek-ai) 插件：给模型一个原生的 `desktop` 工具，**截屏看屏幕、移动/点击鼠标、输入文字和组合键**。
+
+它把之前那套 `gui.ps1` 脚本（截图 + 鼠标键盘控制）包进 DSH 插件，模型直接调用工具，不用每次手拼 PowerShell 命令、也不用担心执行策略。
+
+> Windows only。插件包内自带 `assets/gui.ps1`（UTF-8 BOM），不依赖工作区里的脚本。
+
+## 工具动作
+
+| action | 作用 | 主要参数 |
+| :-- | :-- | :-- |
+| `screenshot` | 截图并返回 PNG 绝对路径 | `window` / `region` / `print` |
+| `windows` | 列出可见窗口（HWND、PID、矩形、标题） | — |
+| `click` | 移动并点击 | `x` `y` `button` `count` |
+| `move` | 移动光标 | `x` `y` |
+| `drag` | 按住拖拽 | `x` `y` `x2` `y2` |
+| `scroll` | 滚轮 | `x` `y` `amount` |
+| `type` | 粘贴文本（走剪贴板，Unicode 安全） | `text` |
+| `key` | 组合键，如 `ctrl+s`、`alt+f4` | `key` |
+| `activate` | 把窗口提到前台 | `window` |
+| `pos` | 光标当前位置 | — |
+| `wait` | 等待 | `waitMs` |
+
+**坐标全部是物理像素**，与 `screenshot` 保存的图片像素一一对应。脚本内部已开启 per-monitor DPI aware v2，图上量到多少就传多少。
+
+典型循环：
+
+```text
+screenshot → read_image 看图 → click / type → 再 screenshot 确认
+```
+
+## 安装
+
+客户端（Electron）：**插件 → + 添加插件**，填入 `dsh-desktop-control`，安装后 **立即启用**。
+
+CLI profile：
+
+```powershell
+dsh plugin --profile web add dsh-desktop-control
+```
+
+## 配置
+
+在 profile 的 `cordis.patch.yml` 里：
+
+```yaml
+- id: dsh-desktop-control
+  name: dsh-desktop-control
+  config:
+    enabled: true
+    powershellPath: powershell.exe   # 不在 PATH 时再改
+    timeoutMs: 30000
+    screenshotDir: ''                # 空 = $DSH_HOME/desktop-control
+```
+
+| 选项 | 默认值 | 说明 |
+| :-- | :-- | :-- |
+| `enabled` | `true` | 设为 `false` 时不注册工具 |
+| `powershellPath` | `powershell.exe` | PowerShell 可执行文件 |
+| `timeoutMs` | `30000` | 单次调用超时 |
+| `screenshotDir` | `$DSH_HOME/desktop-control` | 截图落盘目录 |
+
+## 和直接跑 `gui.ps1` 的区别
+
+| | `gui.ps1` + pwsh 工具 | 本插件 |
+| :-- | :-- | :-- |
+| 调用方式 | 每次拼命令行 | 原生工具调用，参数结构化 |
+| 执行策略 | 受 Restricted 影响，要绕 | 插件内部固定 `-ExecutionPolicy Bypass` |
+| 沙箱降权 | DSH 的 pwsh 子进程会被降为 Low 完整性，鼠标键盘常被拒 | 插件在宿主进程内 spawn，不经过 pwsh 沙箱 |
+| 截图路径 | 自己管理 | 自动落盘到 DSH home 并返回绝对路径 |
+
+> 也就是说：**用插件通常不需要切 `danger-full-access`**，这是它比脚本顺手的地方。
+
+## 安全提醒
+
+- 这是完整的桌面控制：能点任何按钮、能敲任何键、能截下屏幕上的任何内容。
+- 截图会进入模型上下文（你随后用 `read_image` 读它），涉密画面先关掉再截。
+- 工具调用受宿主工具策略约束；但不要在无人值守的机器上启用。
+- UAC 安全桌面、登录界面、锁屏无法操作；部分游戏/反作弊/终端会屏蔽模拟输入。
+
+## 自测
+
+```powershell
+npm run selftest
+```
+
+只测参数构建和校验（不截图、不动鼠标）：
+
+- `screenshot` 生成绝对 `.png` 路径；
+- `type` 对以 `-` 开头的文本使用 `--` 保护；
+- `click` 缺坐标、未知 action 会报错；
+- `scroll` 两种形式、`move`/`drag`/`key`/`activate`/`pos`/`wait` 的 argv 正确。
+
+## 已知限制
+
+- 仅 Windows（依赖 PowerShell + user32/gdi32）。
+- 每次调用起一个 PowerShell 进程，约 300–600ms 开销；高频操作建议一次调用串多个动作（当前工具一次只做一个动作）。
+- 截图是整屏/窗口/区域的静态图，不包含光标（除非脚本带 `-cursor`，本工具暂未暴露）。
+
+## License
+
+MIT

package/assets/gui.ps1

@@ -0,0 +1,573 @@
+<#
+  gui.ps1 — 屏幕读取与鼠标键盘控制（Windows / PowerShell 5.1+）
+
+  用法示例：
+    .\gui.ps1 windows                        列出可见顶层窗口
+    .\gui.ps1 shot out.png                   截全屏（虚拟桌面）
+    .\gui.ps1 shot out.png -window "记事本"   截指定窗口
+    .\gui.ps1 shot out.png -region 0,0,800,600
+    .\gui.ps1 shot out.png -cursor           截图并标出光标位置
+    .\gui.ps1 pos                            打印光标当前坐标
+    .\gui.ps1 move 800 500                   移动光标
+    .\gui.ps1 click 800 500                  左键单击
+    .\gui.ps1 click 800 500 -button right -count 2
+    .\gui.ps1 drag 100 100 400 300           左键拖拽
+    .\gui.ps1 scroll 800 500 3               滚轮（正=上，负=下，1=120单位）
+    .\gui.ps1 type "hello 中文"              逐字符 Unicode 输入
+    .\gui.ps1 key "ctrl+s"                   组合键
+    .\gui.ps1 key "enter"
+    .\gui.ps1 activate "DeepSeek"            激活窗口到前台
+
+  约定：所有坐标都是物理像素（脚本内部开启 per-monitor DPI v2），
+  与 `shot` 输出的图片像素一一对应，可放心把图上的像素坐标直接当参数用。
+#>
+
+[CmdletBinding()]
+param(
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [object[]] $Argv
+)
+
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$ErrorActionPreference = 'Stop'
+
+if (-not ('GuiNative' -as [type])) {
+    Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+    Add-Type -TypeDefinition @'
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Runtime.InteropServices;
+using System.Text;
+
+public class GuiNative
+{
+    [StructLayout(LayoutKind.Sequential)]
+    public struct POINT { public int X; public int Y; }
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct RECT { public int Left; public int Top; public int Right; public int Bottom; }
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct MOUSEINPUT { public int dx; public int dy; public uint mouseData; public uint dwFlags; public uint time; public IntPtr dwExtraInfo; }
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct KEYBDINPUT { public ushort wVk; public ushort wScan; public uint dwFlags; public uint time; public IntPtr dwExtraInfo; }
+
+    [StructLayout(LayoutKind.Explicit)]
+    public struct INPUT
+    {
+        [FieldOffset(0)] public uint type;
+        [FieldOffset(4)] public MOUSEINPUT mi;
+        [FieldOffset(4)] public KEYBDINPUT ki;
+    }
+
+    public delegate bool EnumProc(IntPtr hWnd, IntPtr lParam);
+
+    [DllImport("user32.dll")] public static extern bool SetCursorPos(int X, int Y);
+    [DllImport("user32.dll")] public static extern bool GetCursorPos(out POINT p);
+    [DllImport("user32.dll")] public static extern int GetSystemMetrics(int nIndex);
+    [DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();
+    [DllImport("user32.dll", CharSet = CharSet.Unicode)] public static extern int GetWindowText(IntPtr h, StringBuilder s, int n);
+    [DllImport("user32.dll")] public static extern bool IsWindowVisible(IntPtr h);
+    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr h, out RECT r);
+    [DllImport("user32.dll")] public static extern bool EnumWindows(EnumProc cb, IntPtr p);
+    [DllImport("user32.dll")] public static extern uint GetWindowThreadProcessId(IntPtr h, out uint pid);
+    [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr h);
+    [DllImport("user32.dll")] public static extern bool BringWindowToTop(IntPtr h);
+    [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr h, int cmd);
+    [DllImport("user32.dll")] public static extern bool IsIconic(IntPtr h);
+    [DllImport("user32.dll")] public static extern bool AttachThreadInput(uint a, uint b, bool attach);
+    [DllImport("kernel32.dll")] public static extern uint GetCurrentThreadId();
+    [DllImport("user32.dll")] public static extern bool PrintWindow(IntPtr h, IntPtr hdc, uint flags);
+    [DllImport("user32.dll")] public static extern bool SetProcessDpiAwarenessContext(IntPtr v);
+
+    const uint MOUSEEVENTF_MOVE = 0x0001;
+    const uint MOUSEEVENTF_LEFTDOWN = 0x0002;
+    const uint MOUSEEVENTF_LEFTUP = 0x0004;
+    const uint MOUSEEVENTF_RIGHTDOWN = 0x0008;
+    const uint MOUSEEVENTF_RIGHTUP = 0x0010;
+    const uint MOUSEEVENTF_MIDDLEDOWN = 0x0020;
+    const uint MOUSEEVENTF_MIDDLEUP = 0x0040;
+    const uint MOUSEEVENTF_WHEEL = 0x0800;
+    const uint MOUSEEVENTF_ABSOLUTE = 0x8000;
+    const uint MOUSEEVENTF_VIRTUALDESK = 0x4000;
+    const uint KEYEVENTF_KEYUP = 0x0002;
+    const uint KEYEVENTF_UNICODE = 0x0004;
+
+    public static void EnableDpiAwareness()
+    {
+        try { SetProcessDpiAwarenessContext(new IntPtr(-4)); } catch { }
+    }
+
+    static INPUT MouseInput(uint flags, int dx, int dy, uint data)
+    {
+        INPUT i = new INPUT();
+        i.type = 0;
+        i.mi.dx = dx;
+        i.mi.dy = dy;
+        i.mi.mouseData = data;
+        i.mi.dwFlags = flags;
+        return i;
+    }
+
+    static INPUT KeyInput(ushort vk, ushort scan, uint flags)
+    {
+        INPUT i = new INPUT();
+        i.type = 1;
+        i.ki.wVk = vk;
+        i.ki.wScan = scan;
+        i.ki.dwFlags = flags;
+        return i;
+    }
+
+    [DllImport("user32.dll", SetLastError = true, EntryPoint = "SendInput")]
+    static extern uint SendRaw(uint nInputs, IntPtr pInputs, int cbSize);
+    [DllImport("user32.dll")]
+    static extern void mouse_event(uint dwFlags, int dx, int dy, uint dwData, UIntPtr dwExtraInfo);
+    [DllImport("user32.dll")]
+    static extern void keybd_event(byte bVk, byte bScan, uint dwFlags, UIntPtr dwExtraInfo);
+
+    static int Cb() { return Marshal.SizeOf(typeof(INPUT)); }
+
+    static uint SendAll(INPUT[] arr)
+    {
+        int size = Cb();
+        IntPtr buf = Marshal.AllocHGlobal(size * arr.Length);
+        try
+        {
+            for (int i = 0; i < arr.Length; i++)
+                Marshal.StructureToPtr(arr[i], new IntPtr(buf.ToInt64() + (long)i * size), false);
+            return SendRaw((uint)arr.Length, buf, size);
+        }
+        finally { Marshal.FreeHGlobal(buf); }
+    }
+
+    public static bool MoveTo(int x, int y)
+    {
+        if (SetCursorPos(x, y))
+        {
+            POINT p;
+            if (GetCursorPos(out p) && Math.Abs(p.X - x) <= 2 && Math.Abs(p.Y - y) <= 2) return true;
+        }
+        int vx = GetSystemMetrics(76), vy = GetSystemMetrics(77);
+        int vw = GetSystemMetrics(78), vh = GetSystemMetrics(79);
+        if (vw <= 1) vw = 2;
+        if (vh <= 1) vh = 2;
+        int ax = (int)Math.Round((double)(x - vx) * 65535.0 / (vw - 1));
+        int ay = (int)Math.Round((double)(y - vy) * 65535.0 / (vh - 1));
+        mouse_event(MOUSEEVENTF_MOVE | MOUSEEVENTF_ABSOLUTE, ax, ay, 0, UIntPtr.Zero);
+        POINT q;
+        return GetCursorPos(out q) && Math.Abs(q.X - x) <= 2 && Math.Abs(q.Y - y) <= 2;
+    }
+
+    public static void MouseButton(string button, bool down)
+    {
+        string b = (button ?? "left").ToLowerInvariant();
+        uint mf;
+        if (b.StartsWith("r")) mf = down ? 0x0008u : 0x0010u;
+        else if (b.StartsWith("m")) mf = down ? 0x0020u : 0x0040u;
+        else mf = down ? 0x0002u : 0x0004u;
+        mouse_event(mf, 0, 0, 0, UIntPtr.Zero);
+    }
+
+    public static void Scroll(int notches)
+    {
+        uint data = (uint)(int)(notches * 120);
+        mouse_event(MOUSEEVENTF_WHEEL, 0, 0, data, UIntPtr.Zero);
+    }
+
+    public static void KeyDown(ushort vk) { keybd_event((byte)vk, 0, 0, UIntPtr.Zero); }
+    public static void KeyUp(ushort vk) { keybd_event((byte)vk, 0, KEYEVENTF_KEYUP, UIntPtr.Zero); }
+
+    public static void TypeText(string s)
+    {
+        if (string.IsNullOrEmpty(s)) return;
+        List<INPUT> list = new List<INPUT>();
+        foreach (char c in s)
+        {
+            ushort scan = (ushort)c;
+            list.Add(KeyInput(0, scan, KEYEVENTF_UNICODE));
+            list.Add(KeyInput(0, scan, KEYEVENTF_UNICODE | KEYEVENTF_KEYUP));
+        }
+        SendAll(list.ToArray());
+    }
+
+    public static POINT Cursor()
+    {
+        POINT p;
+        GetCursorPos(out p);
+        return p;
+    }
+
+    public static string[] ListWindows()
+    {
+        List<string> rows = new List<string>();
+        EnumWindows(delegate(IntPtr h, IntPtr l)
+        {
+            if (!IsWindowVisible(h)) return true;
+            StringBuilder sb = new StringBuilder(1024);
+            GetWindowText(h, sb, sb.Capacity);
+            string title = sb.ToString();
+            if (title.Trim().Length == 0) return true;
+            RECT r;
+            if (!GetWindowRect(h, out r)) return true;
+            int w = r.Right - r.Left, ht = r.Bottom - r.Top;
+            if (w < 40 || ht < 40) return true;
+            uint pid;
+            GetWindowThreadProcessId(h, out pid);
+            string proc = "";
+            try { proc = Process.GetProcessById((int)pid).ProcessName; } catch { }
+            rows.Add(string.Format("{0}\t{1}\t{2}\t{3}\t{4}\t{5}\t{6}\t{7}",
+                h.ToInt64(), title, r.Left, r.Top, w, ht, pid, proc));
+            return true;
+        }, IntPtr.Zero);
+        return rows.ToArray();
+    }
+
+    public static IntPtr FindWindow(string needle)
+    {
+        if (string.IsNullOrEmpty(needle)) return IntPtr.Zero;
+        string n = needle.ToLowerInvariant();
+        IntPtr best = IntPtr.Zero;
+        int bestScore = 0;
+        foreach (string row in ListWindows())
+        {
+            string[] p = row.Split('\t');
+            if (p.Length < 8) continue;
+            string title = p[1].ToLowerInvariant();
+            string proc = p[7].ToLowerInvariant();
+            int score = 0;
+            if (title == n) score = 100;
+            else if (title.StartsWith(n)) score = 80;
+            else if (title.Contains(n)) score = 60;
+            else if (proc == n) score = 50;
+            else if (proc.Contains(n)) score = 40;
+            if (score > bestScore)
+            {
+                bestScore = score;
+                best = new IntPtr(long.Parse(p[0]));
+            }
+        }
+        return best;
+    }
+
+    public static bool ForceForeground(IntPtr h)
+    {
+        if (h == IntPtr.Zero) return false;
+        if (IsIconic(h)) ShowWindow(h, 9);
+        uint pid;
+        uint tid = GetWindowThreadProcessId(h, out pid);
+        uint cur = GetCurrentThreadId();
+        bool ok;
+        if (tid != cur)
+        {
+            AttachThreadInput(cur, tid, true);
+            BringWindowToTop(h);
+            ok = SetForegroundWindow(h);
+            AttachThreadInput(cur, tid, false);
+        }
+        else
+        {
+            BringWindowToTop(h);
+            ok = SetForegroundWindow(h);
+        }
+        if (!ok) { ShowWindow(h, 9); ShowWindow(h, 5); ok = SetForegroundWindow(h); }
+        return ok;
+    }
+
+    public static bool GetRect(IntPtr h, out int left, out int top, out int width, out int height)
+    {
+        RECT r;
+        left = top = width = height = 0;
+        if (h == IntPtr.Zero || !GetWindowRect(h, out r)) return false;
+        left = r.Left; top = r.Top;
+        width = r.Right - r.Left; height = r.Bottom - r.Top;
+        return true;
+    }
+}
+'@
+}
+
+[GuiNative]::EnableDpiAwareness()
+
+# ---- 参数解析：位置参数 + -name value ----
+$pos = New-Object System.Collections.ArrayList
+$opt = @{}
+$literal = $false
+for ($i = 0; $i -lt $Argv.Count; $i++) {
+    $a = $Argv[$i]
+    if (-not $literal -and $a -is [string] -and $a -eq '--') { $literal = $true; continue }
+    if (-not $literal -and $a -is [string] -and $a.Length -gt 1 -and $a.StartsWith('-') -and $a -notmatch '^-?\d') {
+        $name = $a.TrimStart('-').ToLowerInvariant()
+        $val = $null
+        if ($i + 1 -lt $Argv.Count) {
+            $nxt = $Argv[$i + 1]
+            if (-not ($nxt -is [string] -and $nxt.Length -gt 1 -and $nxt.StartsWith('-') -and $nxt -notmatch '^-?\d')) {
+                $val = $nxt; $i++
+            }
+        }
+        if ($null -eq $val) { $opt[$name] = $true } else { $opt[$name] = $val }
+    }
+    else { [void]$pos.Add($a) }
+}
+
+if ($pos.Count -eq 0) { Get-Help $PSCommandPath -ErrorAction SilentlyContinue; Write-Host "`n没有参数。用 'shot out.png' 或 'windows' 开始。" ; return }
+
+$cmd = ([string]$pos[0]).ToLowerInvariant()
+$rest = @()
+if ($pos.Count -gt 1) { $rest = $pos[1..($pos.Count - 1)] }
+
+function Get-RectFromString([string]$s) {
+    $p = $s -split ','
+    if ($p.Count -ne 4) { throw "region 需要 x,y,w,h 四段，例如 0,0,800,600" }
+    @{ X = [int]$p[0]; Y = [int]$p[1]; W = [int]$p[2]; H = [int]$p[3] }
+}
+
+switch ($cmd) {
+
+    'windows' {
+        $rows = [GuiNative]::ListWindows()
+        "{0,-14} {1,-10} {2,-26} {3}" -f 'HWND', 'PID', 'RECT', 'TITLE'
+        foreach ($row in $rows) {
+            $p = $row -split "`t"
+            $hw = [long]$p[0]
+            "{0,-14} {1,-10} {2,-26} {3}" -f ('0x' + $hw.ToString('X')), $p[6], ("{0},{1} {2}x{3}" -f $p[2], $p[3], $p[4], $p[5]), ($p[1] + "  [" + $p[7] + "]")
+        }
+    }
+
+    'pos' {
+        $pt = [GuiNative]::Cursor()
+        "{0},{1}" -f $pt.X, $pt.Y
+    }
+
+    'fg' {
+        $h = [GuiNative]::GetForegroundWindow()
+        $sb = New-Object System.Text.StringBuilder 512
+        [void][GuiNative]::GetWindowText($h, $sb, 512)
+        [pscustomobject]@{ hwnd = ('0x' + $h.ToInt64().ToString('X')); title = $sb.ToString() } | ConvertTo-Json -Compress
+    }
+
+    'shot' {
+        $out = if ($rest.Count -ge 1) { [string]$rest[0] } else { 'shot.png' }
+        if (-not [System.IO.Path]::IsPathRooted($out)) { $out = Join-Path (Get-Location).Path $out }
+        $dir = [System.IO.Path]::GetDirectoryName($out)
+        if ($dir -and -not (Test-Path $dir)) { New-Item -ItemType Directory -Force -Path $dir | Out-Null }
+
+        $hwnd = [IntPtr]::Zero
+        if ($opt.ContainsKey('window')) { $hwnd = [GuiNative]::FindWindow([string]$opt['window']) }
+        elseif ($opt.ContainsKey('hwnd')) { $hwnd = [IntPtr]([long]$opt['hwnd']) }
+
+        if ($hwnd -ne [IntPtr]::Zero) {
+            $l = 0; $t = 0; $w = 0; $h = 0
+            if (-not [GuiNative]::GetRect($hwnd, [ref]$l, [ref]$t, [ref]$w, [ref]$h)) { throw "拿不到窗口矩形" }
+            $x = $l; $y = $t; $width = $w; $height = $h
+        }
+        elseif ($opt.ContainsKey('region')) {
+            $r = Get-RectFromString ([string]$opt['region'])
+            $x = $r.X; $y = $r.Y; $width = $r.W; $height = $r.H
+        }
+        else {
+            $x = [GuiNative]::GetSystemMetrics(76)
+            $y = [GuiNative]::GetSystemMetrics(77)
+            $width = [GuiNative]::GetSystemMetrics(78)
+            $height = [GuiNative]::GetSystemMetrics(79)
+        }
+        if ($width -le 0 -or $height -le 0) { throw "截图区域无效: ${width}x${height}" }
+
+        $bmp = New-Object System.Drawing.Bitmap $width, $height
+        try {
+            $g = [System.Drawing.Graphics]::FromImage($bmp)
+            try {
+                if ($hwnd -ne [IntPtr]::Zero -and $opt.ContainsKey('print')) {
+                    $hdc = $g.GetHdc()
+                    try { [void][GuiNative]::PrintWindow($hwnd, $hdc, 2) }
+                    finally { $g.ReleaseHdc($hdc) }
+                }
+                else {
+                    $g.CopyFromScreen($x, $y, 0, 0, (New-Object System.Drawing.Size $width, $height))
+                }
+            }
+            finally { $g.Dispose() }
+
+            if ($opt.ContainsKey('cursor')) {
+                $pt = [GuiNative]::Cursor()
+                $cx = $pt.X - $x; $cy = $pt.Y - $y
+                if ($cx -ge 0 -and $cy -ge 0 -and $cx -lt $width -and $cy -lt $height) {
+                    $g2 = [System.Drawing.Graphics]::FromImage($bmp)
+                    try {
+                        $pen = New-Object System.Drawing.Pen ([System.Drawing.Color]::Red), 3
+                        $g2.DrawEllipse($pen, $cx - 14, $cy - 14, 28, 28)
+                        $g2.DrawLine($pen, $cx - 22, $cy, $cx + 22, $cy)
+                        $g2.DrawLine($pen, $cx, $cy - 22, $cx, $cy + 22)
+                        $pen.Dispose()
+                    }
+                    finally { $g2.Dispose() }
+                }
+            }
+
+            $bmp.Save($out, [System.Drawing.Imaging.ImageFormat]::Png)
+        }
+        finally { $bmp.Dispose() }
+
+        [pscustomobject]@{
+            path   = $out
+            x      = $x
+            y      = $y
+            width  = $width
+            height = $height
+            bytes  = (Get-Item $out).Length
+        } | ConvertTo-Json -Compress
+    }
+
+    'activate' {
+        if ($rest.Count -lt 1) { throw "activate 需要窗口标题关键字" }
+        $h = [GuiNative]::FindWindow([string]$rest[0])
+        if ($h -eq [IntPtr]::Zero) { throw "找不到窗口: $($rest[0])" }
+        $ok = [GuiNative]::ForceForeground($h)
+        [pscustomobject]@{ ok = $ok; hwnd = ('0x' + $h.ToInt64().ToString('X')) } | ConvertTo-Json -Compress
+    }
+
+    'move' {
+        if ($rest.Count -lt 2) { throw "move 需要 x y" }
+        $x = [int]$rest[0]; $y = [int]$rest[1]
+        [GuiNative]::MoveTo($x, $y)
+        Start-Sleep -Milliseconds 40
+        $pt = [GuiNative]::Cursor()
+        "{0},{1}" -f $pt.X, $pt.Y
+    }
+
+    'click' {
+        if ($rest.Count -ge 2) {
+            [GuiNative]::MoveTo([int]$rest[0], [int]$rest[1])
+            Start-Sleep -Milliseconds 60
+        }
+        $button = if ($opt.ContainsKey('button')) { [string]$opt['button'] } else { 'left' }
+        $count = if ($opt.ContainsKey('count')) { [int]$opt['count'] } else { 1 }
+        $gap = if ($opt.ContainsKey('gap')) { [int]$opt['gap'] } else { 90 }
+        for ($k = 0; $k -lt $count; $k++) {
+            [GuiNative]::MouseButton($button, $true)
+            Start-Sleep -Milliseconds 40
+            [GuiNative]::MouseButton($button, $false)
+            if ($k -lt $count - 1) { Start-Sleep -Milliseconds $gap }
+        }
+        $pt = [GuiNative]::Cursor()
+        "click {0} x{1} @ {2},{3}" -f $button, $count, $pt.X, $pt.Y
+    }
+
+    'drag' {
+        if ($rest.Count -lt 4) { throw "drag 需要 x1 y1 x2 y2" }
+        $button = if ($opt.ContainsKey('button')) { [string]$opt['button'] } else { 'left' }
+        [GuiNative]::MoveTo([int]$rest[0], [int]$rest[1])
+        Start-Sleep -Milliseconds 60
+        [GuiNative]::MouseButton($button, $true)
+        Start-Sleep -Milliseconds 80
+        $x1 = [int]$rest[0]; $y1 = [int]$rest[1]; $x2 = [int]$rest[2]; $y2 = [int]$rest[3]
+        for ($s = 1; $s -le 10; $s++) {
+            $mx = [int]($x1 + ($x2 - $x1) * $s / 10.0)
+            $my = [int]($y1 + ($y2 - $y1) * $s / 10.0)
+            [GuiNative]::MoveTo($mx, $my)
+            Start-Sleep -Milliseconds 15
+        }
+        Start-Sleep -Milliseconds 80
+        [GuiNative]::MouseButton($button, $false)
+        "drag {0} ({1},{2}) -> ({3},{4})" -f $button, $x1, $y1, $x2, $y2
+    }
+
+    'scroll' {
+        if ($rest.Count -ge 3) { [GuiNative]::MoveTo([int]$rest[0], [int]$rest[1]); Start-Sleep -Milliseconds 40 }
+        $d = if ($rest.Count -ge 3) { [int]$rest[2] } else { [int]$rest[0] }
+        [GuiNative]::Scroll($d)
+        "scroll $d"
+    }
+
+    'type' {
+        $text = [string]::Join(' ', ($rest | ForEach-Object { [string]$_ }))
+        if ($text -eq '') { throw "type 需要文本" }
+        $text = $text -replace '\\n', "`n" -replace '\\t', "`t"
+
+        if ($opt.ContainsKey('raw')) {
+            [GuiNative]::TypeText($text)
+            "typed {0} chars (raw)" -f $text.Length
+            break
+        }
+
+        # 默认走剪贴板粘贴：对中文/任意 Unicode 都可靠，且结束后还原原剪贴板
+        $old = $null
+        try { $old = Get-Clipboard -Raw -ErrorAction Stop } catch { }
+        try { Set-Clipboard -Value $text -ErrorAction Stop }
+        catch { [System.Windows.Forms.Clipboard]::SetText($text) }
+        Start-Sleep -Milliseconds 120
+
+        [GuiNative]::KeyDown(0x11)
+        Start-Sleep -Milliseconds 30
+        [GuiNative]::KeyDown(0x56)
+        Start-Sleep -Milliseconds 30
+        [GuiNative]::KeyUp(0x56)
+        Start-Sleep -Milliseconds 30
+        [GuiNative]::KeyUp(0x11)
+        Start-Sleep -Milliseconds 180
+
+        if ($null -ne $old -and $old -ne '') {
+            try { Set-Clipboard -Value $old -ErrorAction Stop }
+            catch { try { [System.Windows.Forms.Clipboard]::SetText($old) } catch { } }
+        }
+        "pasted {0} chars" -f $text.Length
+    }
+
+    'key' {
+        if ($rest.Count -lt 1) { throw "key 需要组合键，例如 ctrl+s" }
+        $combo = [string]::Join('+', ($rest | ForEach-Object { [string]$_ }))
+
+        $map = @{
+            'ctrl' = 0x11; 'control' = 0x11; 'shift' = 0x10; 'alt' = 0x12; 'win' = 0x5B; 'lwin' = 0x5B; 'rwin' = 0x5C
+            'enter' = 0x0D; 'return' = 0x0D; 'esc' = 0x1B; 'escape' = 0x1B; 'space' = 0x20; 'tab' = 0x09
+            'backspace' = 0x08; 'bs' = 0x08; 'delete' = 0x2E; 'del' = 0x2E; 'insert' = 0x2D; 'ins' = 0x2D
+            'home' = 0x24; 'end' = 0x23; 'pageup' = 0x21; 'pgup' = 0x21; 'pagedown' = 0x22; 'pgdn' = 0x22
+            'up' = 0x26; 'down' = 0x28; 'left' = 0x25; 'right' = 0x27
+            'capslock' = 0x14; 'printscreen' = 0x2C; 'pause' = 0x13; 'apps' = 0x5D
+        }
+        for ($n = 1; $n -le 24; $n++) { $map["f$n"] = 0x6F + $n }
+
+        function Resolve-Vk([string]$t) {
+            $t = $t.Trim().ToLowerInvariant()
+            if ($map.ContainsKey($t)) { return [int]$map[$t] }
+            if ($t -match '^[a-z]$') { return [int][char]([char]::ToUpperInvariant($t)) }
+            if ($t -match '^\d$') { return 0x30 + [int]$t }
+            $aliases = @{
+                '-' = 0xBD; '=' = 0xBB; '[' = 0xDB; ']' = 0xDD; '\' = 0xDC; ';' = 0xBA; "'" = 0xDE
+                ',' = 0xBC; '.' = 0xBE; '/' = 0xBF; '`' = 0xC0
+            }
+            if ($aliases.ContainsKey($t)) { return [int]$aliases[$t] }
+            throw "无法识别的按键: $t"
+        }
+
+        $parts = $combo -split '\+'
+        $vks = @()
+        foreach ($p in $parts) { if ($p.Trim() -ne '') { $vks += (Resolve-Vk $p) } }
+        if ($vks.Count -eq 0) { throw "组合键为空" }
+
+        $mods = @()
+        foreach ($v in $vks[0..($vks.Count - 2)]) { $mods += [uint16]$v }
+        $last = [uint16]$vks[$vks.Count - 1]
+
+        foreach ($m in $mods) { [GuiNative]::KeyDown($m); Start-Sleep -Milliseconds 25 }
+        [GuiNative]::KeyDown($last)
+        Start-Sleep -Milliseconds 35
+        [GuiNative]::KeyUp($last)
+        for ($k = $mods.Count - 1; $k -ge 0; $k--) { [GuiNative]::KeyUp($mods[$k]); Start-Sleep -Milliseconds 25 }
+        "key $combo"
+    }
+
+    'wait' {
+        $ms = if ($rest.Count -ge 1) { [int]$rest[0] } else { 500 }
+        Start-Sleep -Milliseconds $ms
+        "waited $ms ms"
+    }
+
+    default {
+        Write-Host "未知命令: $cmd"
+        Write-Host "可用: windows | pos | shot | activate | move | click | drag | scroll | type | key | wait"
+        exit 1
+    }
+}

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh bundle layer: mount the desktop-control tool.
+# Loaded by DeepSeek Harness from package.json's dsh.bundle manifest.
+- insert:
+    - id: dsh-desktop-control
+      name: dsh-desktop-control

package/dsh/index.js

@@ -0,0 +1,289 @@
+// dsh-desktop-control — DeepSeek Harness plugin
+//
+// Registers one `desktop` tool that lets the model see the screen and drive
+// the mouse/keyboard: screenshot, window list, click, move, drag, scroll,
+// type, key, activate, cursor position and wait.
+//
+// Implementation: every call spawns the bundled `assets/gui.ps1` (Windows
+// PowerShell 5.1) and parses its output. Keeping the Win32 work in PowerShell
+// avoids a native addon, keeps the package tiny, and reuses the script that
+// was already battle-tested on this machine.
+//
+// Coordinates are physical pixels and match the saved screenshot one-to-one:
+// the script enables per-monitor DPI awareness v2 internally.
+//
+// Safety: this is full desktop control. It can click anything and type
+// anything. Every call is a normal tool call, so the host's tool policy and
+// the user's judgement are the only gates. Do not enable it on an unattended
+// machine.
+import { spawn } from 'node:child_process'
+import { existsSync, mkdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export const name = 'dsh-desktop-control'
+
+// `tools` is the registry this plugin contributes the `desktop` tool to.
+export const inject = ['tools']
+
+const SCRIPT = fileURLToPath(new URL('../assets/gui.ps1', import.meta.url))
+const DSH_HOME = process.env.DSH_HOME || join(homedir(), '.dsh')
+const SHOT_DIR = join(DSH_HOME, 'desktop-control')
+
+const DEFAULTS = {
+  enabled: true,
+  // Override only if powershell.exe is not on PATH.
+  powershellPath: 'powershell.exe',
+  timeoutMs: 30_000,
+  // Keep the most recent screenshots in the DSH home so read_image can open them.
+  screenshotDir: SHOT_DIR,
+}
+
+const ACTIONS = [
+  'screenshot',
+  'windows',
+  'click',
+  'move',
+  'drag',
+  'scroll',
+  'type',
+  'key',
+  'activate',
+  'pos',
+  'wait',
+]
+
+const ACTION_SET = new Set(ACTIONS)
+
+const PARAMETERS = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    action: {
+      type: 'string',
+      enum: ACTIONS,
+      description:
+        'screenshot (save a PNG and return its path), windows (list visible windows), click, move, drag, scroll, type (paste text), key (press a combo such as ctrl+s), activate (bring a window to front), pos (cursor position), wait.',
+    },
+    x: { type: 'number', description: 'Target X in physical screen pixels.' },
+    y: { type: 'number', description: 'Target Y in physical screen pixels.' },
+    x2: { type: 'number', description: 'Drag end X.' },
+    y2: { type: 'number', description: 'Drag end Y.' },
+    text: { type: 'string', description: 'Text for action=type. Unicode is fine; it is pasted via the clipboard.' },
+    key: { type: 'string', description: 'Combo for action=key, e.g. "ctrl+s", "alt+f4", "enter".' },
+    window: {
+      type: 'string',
+      description: 'Window title or process name substring, for screenshot -window or activate.',
+    },
+    region: {
+      type: 'string',
+      description: 'Screenshot region "x,y,width,height" in physical pixels.',
+    },
+    button: { type: 'string', enum: ['left', 'right', 'middle'], description: 'Mouse button for click/drag.' },
+    count: { type: 'integer', description: 'Click count, 1-3.' },
+    amount: { type: 'integer', description: 'Scroll notches; positive is up. 1 = one wheel notch.' },
+    waitMs: { type: 'integer', description: 'Milliseconds for action=wait.' },
+    print: {
+      type: 'boolean',
+      description: 'For screenshot with a window: capture it with PrintWindow even when occluded.',
+    },
+  },
+  required: ['action'],
+}
+
+const OUTPUT = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    ok: { type: 'boolean' },
+    action: { type: 'string' },
+    output: { type: 'string' },
+    imagePath: { type: 'string' },
+    width: { type: 'integer' },
+    height: { type: 'integer' },
+  },
+  required: ['ok', 'action'],
+}
+
+function requireNumber(args, key) {
+  const value = args[key]
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    throw new Error(`desktop action "${args.action}" requires a numeric "${key}"`)
+  }
+  return value
+}
+
+function requireString(args, key) {
+  const value = args[key]
+  if (typeof value !== 'string' || value.length === 0) {
+    throw new Error(`desktop action "${args.action}" requires a non-empty "${key}"`)
+  }
+  return value
+}
+
+function shotPath(config) {
+  const dir = config.screenshotDir
+  mkdirSync(dir, { recursive: true })
+  const d = new Date()
+  const pad = (n, w = 2) => String(n).padStart(w, '0')
+  const stamp =
+    `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}` +
+    `-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}-${pad(d.getMilliseconds(), 3)}`
+  return join(dir, `shot-${stamp}.png`)
+}
+
+/**
+ * Translate one tool call into gui.ps1 argv.
+ * Exported for the self-test; not part of the public plugin API.
+ */
+export function buildArgs(args, config = DEFAULTS) {
+  const action = args.action
+  if (!ACTION_SET.has(action)) throw new Error(`desktop: unknown action "${action}"`)
+  switch (action) {
+    case 'screenshot': {
+      const path = shotPath(config)
+      const argv = ['shot', path]
+      if (typeof args.window === 'string' && args.window.length > 0) argv.push('-window', args.window)
+      if (typeof args.region === 'string' && args.region.length > 0) argv.push('-region', args.region)
+      if (args.print === true) argv.push('-print')
+      return { argv, json: true }
+    }
+    case 'windows':
+      return { argv: ['windows'], json: false }
+    case 'click': {
+      const argv = ['click', requireNumber(args, 'x'), requireNumber(args, 'y')]
+      if (args.button !== undefined) argv.push('-button', String(args.button))
+      if (args.count !== undefined) argv.push('-count', String(args.count))
+      return { argv, json: false }
+    }
+    case 'move':
+      return { argv: ['move', requireNumber(args, 'x'), requireNumber(args, 'y')], json: false }
+    case 'drag':
+      return {
+        argv: [
+          'drag',
+          requireNumber(args, 'x'),
+          requireNumber(args, 'y'),
+          requireNumber(args, 'x2'),
+          requireNumber(args, 'y2'),
+        ],
+        json: false,
+      }
+    case 'scroll': {
+      const amount = typeof args.amount === 'number' ? args.amount : 3
+      if (typeof args.x === 'number' && typeof args.y === 'number') {
+        return { argv: ['scroll', args.x, args.y, amount], json: false }
+      }
+      return { argv: ['scroll', amount], json: false }
+    }
+    case 'type':
+      // `--` stops option parsing, so text beginning with "-" is safe.
+      return { argv: ['type', '--', requireString(args, 'text')], json: false }
+    case 'key':
+      return { argv: ['key', requireString(args, 'key')], json: false }
+    case 'activate':
+      return { argv: ['activate', requireString(args, 'window')], json: false }
+    case 'pos':
+      return { argv: ['pos'], json: false }
+    case 'wait': {
+      const ms = typeof args.waitMs === 'number' ? args.waitMs : 500
+      return { argv: ['wait', ms], json: false }
+    }
+    default:
+      throw new Error(`desktop: unknown action "${action}"`)
+  }
+}
+
+function runPowerShell(argv, config, signal) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(
+      config.powershellPath,
+      ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', SCRIPT, ...argv.map(String)],
+      { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] },
+    )
+    let stdout = ''
+    let stderr = ''
+    let settled = false
+    const finish = (error, value) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      signal?.removeEventListener('abort', onAbort)
+      if (error) reject(error)
+      else resolve(value)
+    }
+    const onAbort = () => {
+      child.kill()
+      finish(new Error('desktop: cancelled'))
+    }
+    const timer = setTimeout(() => {
+      child.kill()
+      finish(new Error(`desktop: timed out after ${config.timeoutMs} ms`))
+    }, config.timeoutMs)
+    signal?.addEventListener('abort', onAbort, { once: true })
+
+    child.stdout.setEncoding('utf8')
+    child.stderr.setEncoding('utf8')
+    child.stdout.on('data', (chunk) => {
+      stdout += chunk
+    })
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk
+    })
+    child.on('error', (error) => finish(error))
+    child.on('close', (code) => {
+      if (code !== 0) {
+        finish(new Error(`desktop: gui.ps1 exited ${code}: ${(stderr || stdout).trim()}`))
+        return
+      }
+      finish(undefined, { stdout: stdout.trim(), stderr: stderr.trim() })
+    })
+  })
+}
+
+export function apply(ctx, userConfig = {}) {
+  const config = { ...DEFAULTS, ...(userConfig || {}) }
+  if (!config.enabled) return
+  if (!existsSync(SCRIPT)) throw new Error(`desktop: bundled script missing at ${SCRIPT}`)
+
+  ctx.tools.register({
+    name: 'desktop',
+    description:
+      'See and control the Windows desktop. action=screenshot saves a PNG and returns its absolute path; open it with read_image to see the screen. Coordinates are physical pixels matching that image. Typical loop: screenshot -> read_image -> click/type -> screenshot again. Supports windows, click, move, drag, scroll, type, key, activate, pos, wait. Use it only when a task truly has no CLI or API path.',
+    parameters: PARAMETERS,
+    output: {
+      schema: OUTPUT,
+      render(_args, value) {
+        const parts = []
+        if (value.imagePath) parts.push(`Screenshot saved: ${value.imagePath}`)
+        if (typeof value.width === 'number') parts.push(`Size: ${value.width}x${value.height}`)
+        if (value.output) parts.push(value.output)
+        return [{ type: 'text', text: parts.join('\n') || 'ok' }]
+      },
+    },
+    isConcurrencySafe: () => false,
+    timeoutMs: config.timeoutMs + 5_000,
+    async execute(args, exec) {
+      const { argv, json } = buildArgs(args, config)
+      const { stdout } = await runPowerShell(argv, config, exec?.signal)
+      if (json) {
+        let parsed
+        try {
+          parsed = JSON.parse(stdout)
+        } catch {
+          throw new Error(`desktop: gui.ps1 returned non-JSON for ${args.action}: ${stdout.slice(0, 400)}`)
+        }
+        return {
+          ok: true,
+          action: args.action,
+          imagePath: typeof parsed.path === 'string' ? parsed.path : undefined,
+          width: typeof parsed.width === 'number' ? parsed.width : undefined,
+          height: typeof parsed.height === 'number' ? parsed.height : undefined,
+          output: stdout,
+        }
+      }
+      return { ok: true, action: args.action, output: stdout }
+    },
+  })
+}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "dsh-desktop-control",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "DeepSeek Harness plugin: a desktop tool that screenshots the Windows screen and drives the mouse and keyboard.",
+  "author": "qingying012",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qingying012/dsh-desktop-control.git"
+  },
+  "homepage": "https://github.com/qingying012/dsh-desktop-control#readme",
+  "bugs": {
+    "url": "https://github.com/qingying012/dsh-desktop-control/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "desktop",
+    "screenshot",
+    "mouse",
+    "keyboard",
+    "automation",
+    "windows"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": "./dsh/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dsh",
+    "assets",
+    "scripts",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md"
+  ],
+  "scripts": {
+    "selftest": "node scripts/selftest.mjs"
+  },
+  "os": [
+    "win32"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}

package/scripts/selftest.mjs

@@ -0,0 +1,55 @@
+// Pure unit tests for argv construction and argument validation. Nothing here
+// touches the real desktop: no screenshots, no mouse, no keyboard.
+import assert from 'node:assert/strict'
+import { buildArgs } from '../dsh/index.js'
+
+// screenshot builds a shot command with an absolute .png path.
+{
+  const { argv, json } = buildArgs({ action: 'screenshot' }, { screenshotDir: 'C:\\shots' })
+  assert.equal(argv[0], 'shot')
+  assert.match(argv[1], /C:\\shots\\shot-\d{8}-\d{6}-\d{3}\.png$/)
+  assert.equal(json, true)
+}
+
+// screenshot with window / region / print adds the right flags.
+{
+  const { argv } = buildArgs(
+    { action: 'screenshot', window: '记事本', region: '0,0,800,600', print: true },
+    { screenshotDir: 'C:\\shots' },
+  )
+  assert.deepEqual(argv.slice(2), ['-window', '记事本', '-region', '0,0,800,600', '-print'])
+}
+
+// type uses `--` so leading dashes are literal text.
+{
+  const { argv } = buildArgs({ action: 'type', text: '-not-a-flag 中文' })
+  assert.deepEqual(argv, ['type', '--', '-not-a-flag 中文'])
+}
+
+// click validates coordinates and forwards button/count.
+{
+  const { argv } = buildArgs({ action: 'click', x: 10, y: 20, button: 'right', count: 2 })
+  assert.deepEqual(argv, ['click', 10, 20, '-button', 'right', '-count', '2'])
+  assert.throws(() => buildArgs({ action: 'click', x: 10 }), /requires a numeric "y"/)
+}
+
+// scroll has both positional and point forms.
+{
+  assert.deepEqual(buildArgs({ action: 'scroll', amount: -2 }).argv, ['scroll', -2])
+  assert.deepEqual(buildArgs({ action: 'scroll', x: 5, y: 6, amount: 3 }).argv, ['scroll', 5, 6, 3])
+}
+
+// move / drag / key / activate / pos / wait.
+{
+  assert.deepEqual(buildArgs({ action: 'move', x: 1, y: 2 }).argv, ['move', 1, 2])
+  assert.deepEqual(buildArgs({ action: 'drag', x: 1, y: 2, x2: 3, y2: 4 }).argv, ['drag', 1, 2, 3, 4])
+  assert.deepEqual(buildArgs({ action: 'key', key: 'ctrl+s' }).argv, ['key', 'ctrl+s'])
+  assert.deepEqual(buildArgs({ action: 'activate', window: 'DeepSeek' }).argv, ['activate', 'DeepSeek'])
+  assert.deepEqual(buildArgs({ action: 'pos' }).argv, ['pos'])
+  assert.deepEqual(buildArgs({ action: 'wait' }).argv, ['wait', 500])
+}
+
+// unknown action is rejected.
+assert.throws(() => buildArgs({ action: 'teleport' }), /unknown action/)
+
+console.log('selftest ok: argv construction and validation behave as expected')