dsh-agent-desktop
IdentifiedWraps the separately installed agent-desktop CLI (`npm i -g agent-desktop`) as nine DSH tools (ad_status, ad_list_windows, ad_snapshot, ad_find, ad_click, ad_type, ad_press, ad_launch, ad_close_app) s
dsh-agent-desktop
把 agent-desktop CLI 封成 DSH 插件,让 Agent 直接调用本机 GUI 工具(不走沙盒子进程)。
插件本身不含 UI 自动化逻辑,只做:参数校验 → 调用 CLI → 解析 JSON 信封 → 返回工具结果。
前置:安装 CLI
npm i -g agent-desktop
Windows 上插件会优先调用 agent-desktop.cmd(避免命中被执行策略拦截的 .ps1)。
工具(9 个)
| 工具 | 说明 |
|---|---|
ad_status | 平台、权限、支持的 surface、CLI 版本 |
ad_list_windows | 列出窗口(可选 app 过滤) |
ad_snapshot | 抓无障碍树;返回 snapshotId / refCount / tree |
ad_find | 在窗口内按 name 子串或 role 搜索元素 |
ad_click | 点击 @snapshot:eN ref |
ad_type | 向元素输入文本 |
ad_press | 发送按键(escape、ctrl+c…) |
ad_launch | 启动应用;activate 可等待窗口 |
ad_close_app | 优雅关闭应用 |
推荐循环
ad_list_windows/ad_snapshot观察- 用返回的
@s…:eN调用ad_click/ad_type - UI 变化后 重新
ad_snapshot(ref 会过期;插件不会自动重试,避免误点)
ad_snapshot 的 render 只打摘要(snapshotId、refCount、前 20 个有名字的元素);完整 tree 在结果的 data 里。
默认不加 --headed,避免抢焦点。需要物理输入时由调用方显式传 headed: true。
安装
dsh plugin add dsh-agent-desktop
本地路径 / tgz:
- DSH → 设置 → 插件管理 → 安装
- 填本仓库绝对路径,或
node tools/release.mjs产出的 tgz - 重启 DSH
配置
| 字段 / 环境变量 | 说明 |
|---|---|
cliPath(插件配置) | agent-desktop 可执行文件绝对路径 |
AGENT_DESKTOP_CLI | 同上,环境变量 |
未配置时自动探测:%APPDATA%\npm\agent-desktop.cmd、常见 Unix 路径、再查 PATH。
Windows 注意
- 必须走
.cmd;裸agent-desktop可能落到.ps1被策略拦住 - PowerShell 里手动测 CLI 时,ref 要加引号:
agent-desktop click '@s…:e1'(@是 splat) - 不提供打开开始菜单等 shell surface 的工具(跨进程易失效)
开发
node --check lib/index.js
node test/selftest.mjs
node tools/release.mjs
版本:0.1.0 · 协议:MIT
Comments
Loading…
Similar plugins
by meng-lx
Restart initiated by the agent itself, not by a button. The agent calls one tool, then the plugin takes over: it waits until every agent and background job on the host is idle, runs a visible ten-seco
★ 0
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-autonomous-restartby kiligzzz
User-defined agents with automatic routing, model failover, and squad orchestration: six model tools (agent_dispatch / agent_followup / agent_list / agent_squad / agent_import_skill / agent_upsert), n
★ 1
MIT
JavaScript
Aug 31, 2026
dsh plugin --profile web add @kiligzzz/dsh-agent-dispatchby EternalNight996
🧑💼为 DeepSeek Harness Web 主窗口添加「工作角色」页签 + 「像素办公室」浮层:内置 508 张完整角色卡(The Agency 255 + agency-agents-zh 253),支持搜索 / 中英切换 / 分部分类选人;Canvas 2D 像素小人可站立、打字、踱步,浮层可拖动折叠缩放,选人即入列;闲聊台词可接 AI(内置或外部接口,20 字内中文)。npm 双
★ 6
↓ 230/wk
MIT
JavaScript
Sep 3, 2026
dsh plugin --profile web add dsh-ui-agents-pixeSettings page for agent modes (presets): switch up to 15 capabilities per mode (commands, files or read-only files, web, subagents, and more) or individual plugin rows; edit each mode's system prompt
★ 1
MIT
JavaScript
dsh plugin --profile web add dsh-modesby LINGTIAN303
Views, creates and edits AGENTS.md and other AI rule files from the DSH settings page: the project directory chain from project root to cwd, both DSH global roots (~/.dsh and ~/.agents), and user-leve
★ 1
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add dsh-agents-visualizationby cnyc6n
Windows UI Automation agent for DeepSeek Harness: enumerate/snapshot/find/click/set_text/scroll/drag/swipe/screenshot + window state as a dsh plugin (single C++ exe)
★ 0
GPL-3.0
JavaScript
Sep 29, 2026
dsh plugin --profile web add dsh-uia-agent