返回目录

dsh-computer-use

编辑精选维护状态: 活跃

anionex/dsh-computer-use

为 DeepSeek Harness 提供电脑控制插件:新鲜 Accessibility 观测、过期状态拒绝、作用域权限与安全输入(目前支持macos)|Accessibility-first macOS Computer Use bundle for DSH with fresh observations, stale-state rejection, scoped permissions, and safe input.

前往 GitHub
$ dsh plugin --profile web add @anionex/dsh-computer-use

46

星标

5

Fork

TypeScript

语言

MIT

许可证

2026-08-13

创建于

2026-09-26

最近推送

面向 DeepSeek Harness 的原生、前台安全 macOS 电脑控制——新鲜 Accessibility 观测、目标进程输入、作用域租约,以及对敏感操作的一次性确认。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-09-03

许可证

MIT

01它能帮你完成什么?

  • Let an Agent inspect and control macOS applications with fresh Accessibility observations

    Bounded Accessibility tree, indexed elements, exact app/process/window metadata, permission state, and an optional screenshot Artifact

    Agents and developers running DeepSeek Harness (dsh) on macOS who need reliable native GUI automation

  • Route keyboard and pointer input to a target process without stealing focus or moving the system cursor

    Target-process-bound keyboard/pointer events plus a separate non-activating Agent cursor; pid/window targeted, never global HID

    Operators who need foreground-safe computer use while the user keeps working in the current app

  • Gate high-impact actions behind one-use confirmation tied to exact state

    A short-lived, one-use confirmation token bound to the exact app, process, observation, target handle, and action

    Security-conscious users who require explicit approval before sensitive macOS input

02如何接入 DeepSeek Harness?

前置条件

  • macOS 14 or newer
  • DeepSeek Harness with a Web or Headless Profile and the Skill Tool mounted
  • macOS Accessibility permission for observation and native actions
  • macOS Screen Recording permission only when a screenshot is requested
  • Node.js ^22.19.0 or >=24.0.0 when building this repository from source

安装步骤

  1. 01

    Install the published npm package into a Web profile: `dsh plugin --profile web add @anionex/dsh-computer-use`

    $ dsh plugin --profile web add @anionex/dsh-computer-use

  2. 02

    Install into a Headless profile: `dsh plugin --profile headless add @anionex/dsh-computer-use`

    $ dsh plugin --profile headless add @anionex/dsh-computer-use

  3. 03

    Restart a running `dsh web` host, start a new Session, then load the Skill with `/computer-use`

    $ dsh web

验证接入成功

  • Confirm the bundle is registered: `dsh --profile web --dump-config | grep computer-use`
  • Restart the host and start a new Session so the Bundle and Skill catalog reload

回滚

  • Remove from the Web profile: `dsh plugin --profile web remove @anionex/dsh-computer-use`
  • Remove from the Headless profile: `dsh plugin --profile headless remove @anionex/dsh-computer-use`

03DSH 适配与能力边界

DSH 适配原生运行时

Native macOS action layer (DSH Bundle) mounted via `dsh plugin add`; exposes Computer Use Tools after loading the `/computer-use` Skill

  • Observe

    target application bundle id and pid→fresh full/diff Accessibility observation and optional screenshot Artifact

  • Click

    exact element index or opaque targetHandle (with optional safe rebinding)→target-process coordinate click after semantic AXPress preference

    may activate the target app before keyboard input when keyboardPolicy: activate
  • Type text

    Unicode text and target process→inserted text via Accessibility, with process-targeted keyboard fallback

    process-targeted keyboard fallback may activate the target app first
  • Confirm

    one exact sensitive action→a one-use token bound to the exact app, process, observation, target handle, and action

  • Scope application access

    Agent, Session, turn, and exact bundle id→separated read and control leases; high-impact actions require one-use confirmation

04适合谁?何时不该用?

适合

  • Agents and developers running DeepSeek Harness (dsh) on macOS who need reliable native GUI automation
  • Operators who need foreground-safe computer use while the user keeps working in the current app
  • Security-conscious users who require explicit approval before sensitive macOS input

不适合

  • The current provider is macOS-only (macOS 14+); Windows UI Automation and Linux providers are not implemented, so non-macOS hosts register no Computer Use Tools.
  • The plugin needs macOS Accessibility and Screen Recording UI permissions (not filesystem permissions); normal use stays under DSH workspace-write and screenshots remain in the Session workspace.
  • The clicked point must fall inside an on-screen window of the selected app; minimized, hidden, or windowless targets fail closed rather than switching to global input.

05兼容性、维护与安全提示

  • The current provider is macOS-only (macOS 14+); Windows UI Automation and Linux providers are not implemented, so non-macOS hosts register no Computer Use Tools.
  • The plugin needs macOS Accessibility and Screen Recording UI permissions (not filesystem permissions); normal use stays under DSH workspace-write and screenshots remain in the Session workspace.
  • The clicked point must fall inside an on-screen window of the selected app; minimized, hidden, or windowless targets fail closed rather than switching to global input.
  • No Tool accepts AppleScript, JXA, shell, Swift, Objective-C, native selectors, arbitrary Accessibility constants, or source code; the model cannot override host policies through Tool arguments.
2026-08-132026-09-03v0.3.1

MIT · actively maintained (latest release v0.3.1, 2026-09-02)

06常见问题

如何为 DeepSeek Harness 安装 DSH Computer Use?

通过 npm 发布包 `@anionex/dsh-computer-use`,在 Web 或 Headless 配置中执行 `dsh plugin --profile web add @anionex/dsh-computer-use`,然后在新 Session 中加载 Skill `/computer-use`。

它会移动真实光标或抢占焦点吗?

不会——默认输入路径不含光标位移,且使用面向目标进程的 SkyLight 路由而非全局指针注入;Agent 光标是一个独立、不激活的叠加层,绝不替换 macOS 系统光标。

支持哪些平台?

当前 provider 仅支持 macOS(macOS 14+);Windows UI Automation 与 Linux provider 尚未实现。在非 macOS 主机上插件会优雅降级,不注册 Computer Use 工具。

敏感操作如何防护?

高危操作在执行前需要短时效、一次性的 `computer_confirm` 令牌,绑定到精确的 app、进程、observation、target handle 与动作;授权无法绕过该确认。

我的数据如何保护?

插件需要 macOS 辅助功能与屏幕录制(UI)权限,而非文件系统权限;观测采用作用域读写租约,安全文本值以 `[secure]` 形式输出。

08数据与来源

  • 作者声明github.com97b9731abccc…

    **Native macOS control for DeepSeek Harness that keeps your real cursor and foreground application alone by default

  • 作者声明github.com97b9731abccc…

    DSH Computer Use gives an Agent fresh Accessibility observations, exact process/window targeting, stale-state rejection,…

  • 作者声明github.com97b9731abccc…

    Semantic Accessibility comes first; mouse, drag, wheel, and keyboard fallback are routed to the selected process instead…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-03。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。