dsh-agent-desktop

DSH PLUGIN会话与消息

仓库 dogxxgod/dsh-agent-desktop · npm dsh-agent-desktop

会话与消息 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

把 agent-desktop 的 computer-use 能力封装为 DSH 原生 desktop_* 工具,让 DeepSeek Harness 代理通过无障碍树快照操作桌面应用。

一句话选型结论

按资料字段整理

dsh-agent-desktop 是会话与消息类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类会话与消息 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-03 创建于 2026-11-03
README 11.9 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:dogxxgod/dsh-agent-desktop#v1.0.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 ^22.19.0 || >=24.0.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求^22.19.0 || >=24.0.0来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/cordis@>=4.0.5、@deepseek-ai/dsh-tools@>=0.2.1-rc.5 <0.3.0-0 等 3 个需要同时安装的同级依赖
npm 包名dsh-agent-desktop可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-agent-desktop:让 DeepSeek Harness 智能体直接操作桌面应用

  • 封装 desktop_* 原生工具
  • 无障碍树快照操作应用
  • 绕过 Bash 沙箱限制
  • 内置快照-操作-校验规则

上游标签

computer-usedeepseekdeepseek-harnessdesktopdshdsh-plugin

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在会话与消息场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-agent-desktop当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
dsh-desktop L3 · 安装规范通过 低风险 3.0 万 未标注 无
openpets L4 · 沙盒安装通过 低风险 1,274 未标注 有
deeptide L4 · 沙盒安装通过 低风险 1,104 0.1.1-rc.2 有
jingyun-dsh L3 · 安装规范通过 低风险 1,004 未标注 有
study-mate 未做沙盒验证 未标注 856 未标注 无

仓库档案

会话与消息
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方dogxxgod仓库 dsh-agent-desktop · 默认分支 main
分类会话与消息desktop
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-03 · 2026-11-03最后推送 2026-11-03
本站收录2026-11-03首次进入本站目录的时间

README 全文

11.9 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-agent-desktop

English | 简体中文

把 Vercel Labs 的 agent-desktop(通过操作系统
辅助功能树做计算机操作的 CLI)接入 DeepSeek Harness
的 Host 插件:它把「快照 → 操作 → 复核」这套桌面自动化能力注册成原生 desktop_* 工具,
并把原 skill 的操作规则注入系统提示词。

agent-desktop 通过 OS 辅助功能树读取和操作桌面应用:每次快照返回带稳定 @ref 的 JSON
元素树,agent 对 ref 执行动作,再快照复核——不做像素匹配、不用坐标,循环由 agent 掌控。

  • 插件版本:1.0.0
  • 兼容性:DSH &gt;= 0.2.1-rc.5;已在 DSH 0.2.1-rc.5 + macOS 26.7.1 (arm64) 验证
  • CLI 兼容:agent-desktop 1.1.0(JSON envelope version: 2.6)

为什么做成插件,而不是只装 skill

上游项目自带一个 agent skill(SKILL.md)。DSH 可以直接安装它:DSH 的文件系统 skill provider
会扫描 ~/.dsh/skills 与 ~/.agents/skills,解析 frontmatter 里的 name + description,
并且热加载、无需重启。作为「文档」这是正确做法。

但有一个实际缺口:Harness 的 Bash 工具带文件沙箱。macOS 沙箱不允许执行 /bin/ps,而
agent-desktop 的应用清单(list-apps、所有 --app &lt;名称&gt; 过滤、launch、close-app)依赖
ps,在 Bash 工具里会报:

TIMEOUT ... A required macOS app inventory source failed: ps: Operation not permitted (os error 1)

本插件把 CLI 放到 Host 主进程执行(不经过 Bash 沙箱),Bash 命令仍保持隔离;同时把 skill
的规则(快照→操作→复核、ref 生命周期、重试 disposition、headless/headed 策略)作为系统提示词段
注入,因此不依赖单独安装 skill。skill 与插件可以共存、互为补充。

系统要求

  1. DeepSeek Harness &gt;= 0.2.1-rc.5,且当前 profile 暴露 ctx.tools 与 ctx.subprocess。
  2. Node.js ^22.19.0 || &gt;=24.0.0。Harness 自带运行 Node,但 npm install -g 需要系统里
    有 Node/npm。
  3. agent-desktop CLI 已安装并可用。
  4. macOS 权限:辅助功能(Accessibility)必需;截图还需屏幕录制(Screen Recording)。
    Windows 在同一完整性级别下无需授权。

安装

插件是本地 bundle:无构建步骤、无安装脚本、无运行时依赖。agent-desktop CLI 与 macOS 权限是
前置条件(见系统要求),下面只做一件事:把本插件注册到某个 Harness profile。

注册 bundle

推荐通过 Harness 的插件管理器注册。它会把包 link 进当前 profile,并写入 bundle 行:

  1. 下载并解压发布包。

macOS:

curl -L -o dsh-agent-desktop-1.0.0.zip \
https://codeload.github.com/dogxxgod/dsh-agent-desktop/zip/refs/tags/v1.0.0
unzip -q dsh-agent-desktop-1.0.0.zip -d ~/work

也可以在浏览器打开该 URL,双击下载好的 ZIP 解压。

Windows(PowerShell):

Invoke-WebRequest -Uri &quot;https://codeload.github.com/dogxxgod/dsh-agent-desktop/zip/refs/tags/v1.0.0&quot; `
-OutFile &quot;$env:USERPROFILE\Downloads\dsh-agent-desktop-1.0.0.zip&quot;
Expand-Archive &quot;$env:USERPROFILE\Downloads\dsh-agent-desktop-1.0.0.zip&quot; `
-DestinationPath &quot;$env:USERPROFILE\work&quot;

也可以在浏览器打开该 URL,用资源管理器解压。

解压后得到 ~/work/dsh-agent-desktop-1.0.0 之类的目录,其中包含 package.json。

  1. 打开 Harness 的插件(Plugins)页面,使用「安装 Bundle / 从本地目录安装」(不同版本
    按钮文案略有差异),选择解压出的 dsh-agent-desktop-1.0.0 目录。或者直接对 agent 说:

> 用 plugin_manager 把 /绝对路径/dsh-agent-desktop-1.0.0 安装为 bundle

管理器会把 dsh-agent-desktop 写入 profile 的 dsh.profile.bundles,并激活
agent-desktop 这一行。

  1. 如果结果提示 restart-required,重启 Harness;然后运行 desktop_status,工具列表里应出现
    desktop_*。

可选配置

想调整参数而不改本仓库时,在 profile 的 cordis.patch.yml 中覆盖该行(后层会整体替换
config):

- id: agent-desktop
config:
binaryPath: /Users/you/.local/bin/agent-desktop
stateHome: /Users/you/.agent-desktop
timeoutMs: 90000
promptSection: true

升级

下载新版本 tag 的 ZIP(把 URL 里的 v1.0.0 换成新版本,如 .../zip/refs/tags/v1.1.0),解压覆盖
同一目录;也可以解压到新目录后重新注册该目录。bundle 以 link 方式安装,更新文件后重启
Harness
即生效,无需重装。

卸载

在 Harness 插件页面移除该 bundle(或调用 plugin_manager remove_bundle)并重启。可选清理 CLI
与状态目录:

npm uninstall -g agent-desktop
rm -rf ~/.agent-desktop ~/work/dsh-agent-desktop-1.0.0
npm uninstall -g agent-desktop
Remove-Item -Recurse -Force &quot;$env:USERPROFILE\.agent-desktop&quot;, &quot;$env:USERPROFILE\work\dsh-agent-desktop-1.0.0&quot;

配置

字段 默认值 含义
binaryPath agent-desktop 通过 PATH 解析的可执行文件名,或绝对路径。绝对路径会校验可执行性。
stateHome &quot;&quot;(CLI 默认 ~/.agent-desktop) 设置 AGENT_DESKTOP_HOME:快照 refmap、会话、trace 存放位置;必须是绝对路径且仅属主可访问。
timeoutMs 60000 每条 CLI 命令的默认超时;单次调用可用 timeout_ms 覆盖。
promptSection true 是否把桌面操作规则注入 agent 系统提示词。

CLI 还会写入插件之外的位置:截图写到调用时传入的路径,--trace 写到传入的路径,会话写在
state root 下。

工具

工具 对应 CLI 用途
desktop_status status 平台、权限状态、CLI 版本、state root、可用 surface。建议首先调用。
desktop_list_windows list-windows 可见窗口及 w-… id、应用、标题、bounds、focused/visible。
desktop_list_apps list-apps 运行中的 GUI 应用(名称、bundle id、pid)。
desktop_snapshot snapshot 辅助功能树与 @ref id;默认前台应用。
desktop_find find 按 role/name/text/value/description/native id 查找元素。
desktop_get get 读取某个 ref 的属性(text、value、title、bounds、role、states)。
desktop_click click / double-click / triple-click / right-click 对 ref 执行点击。
desktop_type type 向 ref 输入文本(可选逐字符按键)。
desktop_press press 发送按键组合,如 return、escape、cmd+s。
desktop_scroll scroll 按方向/数量滚动 ref。
desktop_screenshot screenshot 保存窗口/显示器 PNG。
desktop_run 任意子命令 逃生口,覆盖其余能力(launch、clipboard-get、wait、session、batch、通知、窗口管理等)。

每个工具返回 CLI 的单条 JSON envelope(ok 加 data 或 error)。命令失败不会被转成工具
异常:模型按 error.code 与 error.disposition 分支处理,与上游 skill 的教导一致。只有当
error.disposition.retry 为 safe(delivery 为 not_delivered)时才重试;已投递但未验证的
动作可能已经生效,重复前应先读取实时状态。

快速循环

desktop_list_windows { app: &quot;Finder&quot; }
desktop_snapshot     { window_id: &quot;w-204749&quot;, interactive_only: true, compact: true }
desktop_click        { ref: &quot;@s8f3k2p9:e12&quot; }
desktop_snapshot     { window_id: &quot;w-204749&quot;, interactive_only: true, compact: true }   # 复核

对结构复杂的应用:先 desktop_snapshot { skeleton: true } 取浅层地图,再用
desktop_snapshot { root: &quot;@s8f3k2p9:e3&quot; } 钻取一个区域,最后加 interactive_only: true。

菜单、sheet、alert 属于 surface:desktop_snapshot { surface: &quot;menu&quot; }。

逃生口

desktop_run { command: &quot;clipboard-get&quot; }
desktop_run { command: &quot;launch&quot;, args: [&quot;--app&quot;, &quot;Safari&quot;] }
desktop_run { command: &quot;resize-window&quot;, args: [&quot;w-204749&quot;, &quot;--width&quot;, &quot;1200&quot;, &quot;--height&quot;, &quot;800&quot;] }
desktop_run { command: &quot;session&quot;, args: [&quot;start&quot;, &quot;--name&quot;, &quot;run_1&quot;] }
desktop_run { command: &quot;batch&quot;, args: [&quot;--help&quot;] }

desktop_run 原样透传参数、原样返回 envelope,因此 agent-desktop &lt;命令&gt; --help 里记录的
能力都能覆盖到。

工作原理

index.js          插件入口:Config schema、工具注册、系统提示词段
lib/desktop.js    Host 侧执行器:可执行文件解析、spawn、超时、envelope 解析
lib/tools.js      模型侧工具定义 + 系统提示词文本
cordis.patch.yml  bundle patch,插入 host 行
locale/*.json     插件管理器展示元数据(en / zh)
icon.svg          插件图标

index.js 声明 inject = [&#x27;tools&#x27;, &#x27;subprocess&#x27;],延迟解析可执行文件(PATH 或绝对路径),在
插件 context 上注册每个 CLI 能力的工具。每次调用以 collect 模式 spawn agent-desktop、施加超时、
在工具取消时中止,并解析 JSON envelope。spawn 失败、超时、无法解析的输出都会以带 plugin 版本
标记的 envelope 返回,便于模型区分插件错误与 CLI 错误。

CLI 继承 Host 进程身份,因此 macOS 上授予 DeepSeek Harness.app 的辅助功能权限即可覆盖这些
调用。

安全与隐私

  • 辅助功能权限很强:授予后 Harness 可以读取并操作 GUI 应用。只在确实需要计算机操作时授予。
  • 默认无头(headless):ref 操作走语义辅助功能调用——不动鼠标、不抢焦点、不合成按键、不用
    剪贴板。工具暴露 headed: true 用于物理输入,仅在用户明确同意时使用;headed 动作可能移动
    指针。
  • 隐私数据:快照、剪贴板、截图、命令输出可能包含私密桌面内容,不要放进公开日志或上传。
    插件本身不联网,只有 CLI 在本地运行。
  • 破坏性动作:desktop_click/desktop_type 可能提交表单、删除内容或发送消息。先做只读观察
    (desktop_status、desktop_get、desktop_find),把不可逆动作当作需要用户确认的决策。

开发

node --check index.js
node --check lib/desktop.js
node --check lib/tools.js
node test/runner.test.mjs

测试用 child_process 替身模拟 ctx.subprocess,无需 Harness 运行时即可执行;未安装
agent-desktop 时,依赖 CLI 的用例会跳过。

兼容性与验证

  • 在 macOS 26.7.1 (arm64) + DSH 0.2.1-rc.5 + agent-desktop 1.1.0 的运行中 Host 插件上
    实测通过:desktop_status、desktop_list_windows(271 个窗口)、
    desktop_snapshot { window_id }(89 个 ref)、desktop_find { window_id, role, name }、
    desktop_get、desktop_run { command: &quot;focus&quot; }(语义动作,delivered_unverified)、
    desktop_screenshot 均返回 ok: true。
  • desktop_find { app: &quot;DeepSeek Harness&quot; } 证明应用清单定向在插件侧可用:它解析到应用并返回
    AMBIGUOUS_TARGET,附带两个候选窗口、safe 重试 disposition 和 --window-id 建议。
    同一台机器上 desktop_list_apps(不带过滤的全局应用清单)两次返回 TIMEOUT:8s 与 25s 内
    macOS 全局应用清单未稳定,这属于 CLI 侧的清单状态,被如实包装成 envelope,不是插件故障;
    按 --app、--window-id 收窄的调用不受影响。
  • 插件的 Windows/Linux 支持来自 CLI 本身(插件只负责 spawn),但目前的运行验证仅限 macOS。

许可证

本插件使用 MIT 许可证。agent-desktop 是 Vercel Labs 的独立项目(Apache-2.0);本插件不内嵌
其代码,只调用已安装的 CLI。与 Vercel Labs、DeepSeek 均无隶属关系。

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-agent-desktop 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:dogxxgod/dsh-agent-desktop#v1.0.0` 即可。对应的 npm 包名是 `dsh-agent-desktop`。

dsh-agent-desktop 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-agent-desktop 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-agent-desktop 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-agent-desktop 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-agent-desktop 需要什么运行环境?

Node.js ^22.19.0 || >=24.0.0;需要同时安装 @deepseek-ai/cordis@>=4.0.5、@deepseek-ai/dsh-tools@>=0.2.1-rc.5 <0.3.0-0、@deepseek-ai/schemastery@^3.18.0。环境不满足时安装会失败,建议先确认本机版本。

dsh-agent-desktop 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-agent-desktop 有哪些功能?

封装 desktop_* 原生工具、无障碍树快照操作应用、绕过 Bash 沙箱限制、内置快照-操作-校验规则。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

2 条
不同作者的仓库分开列,请确认你要装的是哪一个
会话与消息
按星标排序,可作替代方案

dsh-desktop

dsh-desktop

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。

L3 · 安装规范通过 3.0 万 星

openpets

openpets

L4 · 沙盒安装通过 1,274 星

deeptide

deeptide

L4 · 沙盒安装通过 1,104 星

jingyun-dsh

jingyun-dsh

井云 DSH 客户端插件,为 DeepSeek Harness 注入会员登录、订阅支付、算力管控与应用市场,让智能体和技能快速变成可交易商品

L3 · 安装规范通过 1,004 星

study-mate

study-mate

StudyMate 是 DSH 的「学习模式」预设与技能包,为数学、计算机科目定制学习路线、讲解课件与练习评估,跨科目共享记忆。

未标注验证等级 856 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。