Windows 插件使用#

文档目录 · 首次使用 · 排障

Windows 上使用同一套 Oh My DSH 插件、任务、记忆和工作台。内置浏览器使用独立配置；已有 Chrome 扩展和原生桌面提供开发适配。桌面部分使用 Windows 前台输入、UI Automation 和窗口捕获，不同应用的兼容性需要在目标设备上验证。

Web／源码建议使用 Node.js 24（插件声明最低 22.19），并准备 pnpm 11.23.0、Git 和 PowerShell 7；官方桌面应用按下方专用教程安装。首次准备 Windows Chrome 连接或安装桌面控制还需要 .NET 10 SDK 和可访问 NuGet 的网络；编译后的程序自带运行时，不要求每次运行都启动 SDK。

安装与试用#

当前 Web／源码版 Oh My DSH 0.2.1-alpha.1.omd.0.5.2 适配 DSH 0.2.1-alpha.1。官方新版桌面安装包尚待发布，桌面用户请按固定 rc.2 桌面教程使用此前配对版本。桌面安装与管理继续使用应用内插件页或官方桌面内置 CLI。本版验证范围。

以下是 Web 安装。已有环境先停止服务并备份实际 DSH_HOME，沿用原 profile 和端口；首次安装可使用默认 web。在 PowerShell 7 中运行，无需先全局安装 dsh：

npx --yes @deepseek-ai/dsh@0.2.1-alpha.1 plugin --profile web add github:gulagala001/oh-my-dsh#v0.2.1-alpha.1.omd.0.5.2
if ($LASTEXITCODE -ne 0) { throw '插件安装失败' }
npx --yes @deepseek-ai/dsh@0.2.1-alpha.1 --profile web

打开启动时打印的登录链接，新建会话并选择 Oh My DSH，通过输入区的 工作台 和电脑使用插件。已有模型、凭据和会话沿用 DSH；自定义 profile 或 DSH_HOME 应保持原配置。此方式无需先下载 ZIP、手动构建或另起一套服务。

从源码独立试用（可选）#

在 PowerShell 7 中进入完整源码目录。本地 link: 开发建议使用不含空格的源码路径，例如 C:\src\oh-my-dsh。

pnpm install --frozen-lockfile
if ($LASTEXITCODE -ne 0) { throw '安装依赖失败' }
pnpm build
if ($LASTEXITCODE -ne 0) { throw '构建失败' }
$env:DSH_HOME = Join-Path $env:LOCALAPPDATA 'oh-my-dsh-win-dev'
$env:PORT = '3090'
pnpm start

打开启动打印的登录链接，在 DSH 中配置自己的模型。电脑面板可独立打开内置浏览器；若没有 Chrome，在源码目录执行 pnpm exec playwright install chromium。

内置浏览器隐藏网页原生及 CSS 滚动条，使全页截图前后的排版保持稳定；页面和嵌套区域仍可用滚轮、键盘或滚动工具操作。

连接已有 Chrome#

打开 电脑 → 运行环境与权限 → 准备 Chrome 连接，等待本机程序编译与注册完成。
在 Chrome 打开 chrome://extensions，开启开发者模式，加载面板显示的扩展目录。
等待显示“已连接 Oh My DSH”，选择已有测试标签，再让助手操作。

连接注册在当前 Windows 用户下，不需要管理员启动。若该 Chrome 已连接另一个 Oh My DSH 实例，会说明冲突并保留原连接；请先在原实例移除连接。

更新后若显示“待重新加载”，回到 Chrome 扩展管理页点击重新加载。Chrome 连接详情 → 移除 Chrome 连接 会停止操控并移除本机注册，网页和扩展目录保留，再次使用时重新准备。

原生桌面控制#

需要 Windows 10 2004 或更新版本，支持 x64 与 ARM64 构建。在 电脑 → 运行环境与权限 → 安装桌面控制 中编译并安装。助手可发现 Windows 应用目录中的已安装应用和运行窗口；getApp 接受发现列表中的名称／ID 或完整 .exe 路径，必要时启动应用，再核对真实进程与窗口。应用名或窗口不唯一时，选择具体 ID 和窗口；失效的进程／窗口引用不会自动重开应用。

单屏 125%、150%、200% 显示缩放按物理像素统一处理截图、控件位置与鼠标输入；缩放改变后旧截图坐标失效，需要重新观察。

Windows 使用前台操控；保持桌面解锁，鼠标或键盘介入会停止助手。点击悬浮卡片只放大查看，不暂停任务或激活应用。停止操作后，独立预览仍可继续观察；关闭预览不会关闭应用。

运行时提供控件读取、窗口截图、键盘输入、点击、拖拽、文本赋值／选择和粘贴。滚动依赖控件的 UI Automation 滚动模式；应用不提供相应模式时会说明限制。Windows 快捷键使用 Ctrl／Alt／Shift／Win；super 对应 Win，不能当成 Mac 的 Command。

出现更新提示时点击 更新桌面控制；安装损坏时可点击 修复桌面控制。更新先校验新程序，切换失败时保留旧安装；之后重新选择应用。

在 桌面控制版本 → 移除桌面控制 中卸载运行时。移除会停止原生操控与预览，保留应用窗口、用户文件和浏览器连接；之后可以重新安装。程序损坏时会用 .NET 10 SDK 重建独立卸载程序；若停止或文件删除尚未确认，会保留相应安装信息供重试。额外文件和无法确认归属的目录会保留。

停止操控不会关闭启动的应用。锁屏、提升权限窗口和应用兼容性不能据基础自检结果推定可用。

WSL 控制 Windows 桌面#

WSL 中运行的 DSH 可以通过手动指定的 OhMyDsh.Desktop.exe 使用 Windows 原生桌面后端。仅在 Linux 内核版本标识包含 Microsoft 且配置了 computerUseNativeBinary 时启用；普通 Linux 和未配置该路径的 WSL 保持原有行为。Windows 仍需满足上面的系统版本要求、保持桌面解锁，并允许 WSL 启动 Windows 程序。

在 Windows 上准备 Node.js 和 .NET 10 SDK，进入与当前插件配套的 OpenCU 目录（Oh My DSH 安装包内为 vendor/opencu），用已有构建脚本生成自包含程序。在 PowerShell 中运行：
powershell
```
$env:TRISOUL_CU_WINDOWS_NATIVE_OUTPUT = 'C:\DSH-WinDesktop'
node scripts/build-computer-use-windows-native.mjs
if ($LASTEXITCODE -ne 0) { throw '桌面程序构建失败' }
```
输出目录可自行选择。目标架构默认跟随 Windows Node.js；需要时通过 TRISOUL_CU_WINDOWS_ARCH 指定 x64 或 arm64。请使用该脚本保留构建身份，不直接使用标记为 development 的程序。
在 WSL 的当前 DSH profile 中，给 Oh My DSH（trisoul-x） 的配置填入 WSL 可访问的路径：
yaml
```
computerUseNativeBinary: /mnt/c/DSH-WinDesktop/OhMyDsh.Desktop.exe
```
这是插件配置项，不是新增一个顶层插件。自定义盘符和挂载点按实际路径填写；修改后重启相应 DSH 服务。在 Oh My DSH 的设置界面中也可填写「桌面控制程序路径」。
在 WSL 中进入上述 OpenCU 目录，执行只读自检：
bash
```
node scripts/check-wsl-desktop.mjs /mnt/c/DSH-WinDesktop/OhMyDsh.Desktop.exe
```
自检验证程序身份、MCP 连接、交互桌面和捕获能力，并列出应用数量；不会点击、输入或启动目标应用。成功后在电脑面板确认显示 Windows 桌面和窗口捕获状态，再选择应用。

程序由用户手动管理，面板不提供安装、更新或移除按钮。更新时先停止桌面操作及 DSH 服务，再替换程序并重启服务。连接校验协议、平台及磁盘与运行中程序的构建身份；桥接模式不要求外部程序的构建哈希等于 WSL 内插件源码的哈希，因此插件升级后应使用配套源码重新构建 Windows 程序。

此桥接只接通原生桌面后端；内置浏览器和 Chrome 扩展的运行位置、安装方式保持原有行为。跨平台自动回归覆盖后端选择、身份校验、设置界面和文档装配；WSL 真机的截图、输入、停止及进程清理仍需在目标设备验收，只读自检不能代替完整操控验证。

在本机运行自检#

Computer Use 的 Windows 构建、自检与原生测试随实现迁入 OpenCU。完整步骤见 OpenCU Windows 指南。Oh My DSH 安装时自动包含运行所需的 OpenCU，无需另装一套插件。