# @copylee/dsh-computer-use 中文文档

规范地址：https://npmcn.com/package/%40copylee/dsh-computer-use/

版本：0\.8\.3
npm 元数据更新时间：2026-11-07T07:05:52.446Z
中文译文更新时间：2026-11-10T18:38:52.340Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40copylee/dsh-computer-use
原文对照：https://npmcn.com/package/%40copylee/dsh-computer-use/?lang=original
项目主页：https://github.com/copylee711/dsh-computer-use#readme
源码仓库：https://github.com/copylee711/dsh-computer-use

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：734 kB，46 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^22\.19\.0 \|\| \>=24\.0\.0
- 运行依赖：0 个
- peer 依赖：react \>=18\.2\.0 \<19，@deepseek-ai/cordis \>=4\.0\.0 \<5，@deepseek-ai/schemastery \>=3\.18\.0 \<4
- 首次发布：2026-10-02T08:47:47.790Z
- 最新版本发布：2026-11-07T07:05:52.043Z
- 近 30 天下载量：9761（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 32 个）

## 中文简介

DeepSeek Harness Computer Use 插件（Windows）：让 AI 看屏幕、点鼠标、敲键盘操控电脑；控制时屏幕泛起橙色光晕并显示“DeepSeek Harness 正在操控你的电脑”，按 Esc 暂停 / 继续。

## 安装

```sh
npm install @copylee/dsh-computer-use
```

也可以使用：`pnpm add @copylee/dsh-computer-use`、`yarn add @copylee/dsh-computer-use`、`bun add @copylee/dsh-computer-use`

## README

# dsh-computer-use

[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com/) [![npm](https://img.shields.io/npm/v/@copylee/dsh-computer-use)](https://www.npmjs.com/package/@copylee/dsh-computer-use)

在 DeepSeek Harness 里交代一个任务，让模型用你已经安装的 Windows 应用完成它。它可以打开应用、读界面、点击和输入，也可以在操作后检查结果。你可以在屏幕上看着它做，随时暂停或接手。

> **可以这样说**：「打开记事本，把下面三条待办写进去，保存到桌面，最后告诉我文件名。」

![Computer Use 按控件名填写测试报名表，暂停后继续提交，进度卡片显示完成结果](https://npmcn.com/package/%40copylee/dsh-computer-use/assets/demo-form.gif)

_演示中，插件按控件名填写报名表，中途暂停，继续后提交并读出确认文字。画面取自隔离 Chrome 配置中的实际操作，动作由脚本发起，卡片使用演示文案。_

## 可以用它做什么

| 场景 | 可以交给 DSH 的任务 |
| --- | --- |
| 浏览器 | 用当前已打开的 Chrome，在同一窗口的新标签打开网址，填写表单并检查确认提示。 |
| 办公软件 | 在 Word、WPS 或记事本中输入和整理内容，按指定位置保存，再确认文件名。 |
| 桌面应用 | 打开计算器、文件资源管理器等应用，操作菜单或对话框，再读出屏幕上的结果。 |

## 一次操作是怎么完成的

-   **先看清界面。** 模型可以读截图，也可以通过 Windows UI Automation 获取按钮、输入框及其内容。例如，直接定位「按钮:提交报名」；同名控件还能用 AutomationId 区分。截图上的坐标由插件换算，适配 Windows 的缩放和多显示器。
-   **连续完成几步。** 「填字段 → 提交 → 等成功提示」可以放进同一个批次。等待条件满足就继续，结束时等画面稳定再回传截图，也可以只读出窗口文字。
-   **处理常用应用时参考操作笔记。** 插件内置 Word、Excel、Chrome 等应用的技能，模型打开对应应用时会收到常用快捷键和操作步骤。你可以在设置页查看或编辑这些笔记。

## 操控期间，你仍然掌握主动权

默认按应用授权，DSH 会在需要时请求操作目标应用。开始操控后，橙色光晕标出操控状态，迷你卡片上方显示 DSH 提供的思考内容，下方保留操作时间线。按 **Esc** 暂停或继续，点 **停止** 结束本轮。你也可以直接在卡片上输入新指令，或者亲自接手键盘。

正文一开始输出，就回到 DSH 对话阅读。桌面版会恢复窗口并切回前台，Web GUI 会尝试回到任务开始时识别到的活动 DSH 标签。可查看[暂停时的卡片](https://npmcn.com/package/%40copylee/dsh-computer-use/assets/demo-paused.png)和[任务结束的画面](https://npmcn.com/package/%40copylee/dsh-computer-use/assets/demo-complete.png)。授权范围、截图和剪贴板的处理规则见[数据与权限](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/privacy.md)。

## 安装并试一次

需要 **Windows 10 2004+ 或 Windows 11**，以及 **DeepSeek Harness 0.2.0-rc.2 或更新版本**。在 DSH 桌面版的 **插件 → 添加插件** 中输入 `@copylee/dsh-computer-use`，安装后启用。

第一次可以试试「打开计算器，算 1234 × 5678，然后读出结果」。支持图片输入的模型可以看截图；纯文本模型可以读取应用提供的无障碍控件和窗口文字。游戏、画布和部分自绘界面可能需要截图定位。Web GUI 安装方式和常见问题见[安装与排障](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/getting-started.md)。

## 文档

| 文档 | 内容 |
| --- | --- |
| [安装与排障](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/getting-started.md) | 桌面版与 Web 安装、第一次操作和常见问题 |
| [操作指南](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/usage.md) | 示例任务、授权、暂停与接管、应用技能 |
| [设置参考](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/settings.md) | 截图、输入方式、浮层和 Web GUI 地址 |
| [Agent 工具](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/tools.md) | 工具清单、控件定位、批量动作与文字结果 |
| [数据与权限](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/privacy.md) | 模型可见数据、截图缓存、剪贴板与 Windows 限制 |
| [开发与验证](https://npmcn.com/package/%40copylee/dsh-computer-use/docs/development.md) | 架构、构建、Windows 冒烟测试和本地联调 |

[MIT License](https://npmcn.com/package/%40copylee/dsh-computer-use/LICENSE)

## 常见问题

### @copylee/dsh-computer-use 是什么？

DeepSeek Harness Computer Use 插件（Windows）：让 AI 看屏幕、点鼠标、敲键盘操控电脑；控制时屏幕泛起橙色光晕并显示“DeepSeek Harness 正在操控你的电脑”，按 Esc 暂停 / 继续。

### 如何安装 @copylee/dsh-computer-use？

在项目目录运行 npm install @copylee/dsh-computer-use，或使用 pnpm add / yarn add / bun add。

### @copylee/dsh-computer-use 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @copylee/dsh-computer-use 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @copylee/dsh-computer-use 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.19\.0 \|\| \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @copylee/dsh-computer-use 可以商用吗？

@copylee/dsh-computer-use 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @copylee/dsh-computer-use 的下载量有多少？

根据 npm 官方下载统计，@copylee/dsh-computer-use 在 2026/10/11 – 2026/11/09 这 30 天内被下载 9,761 次，日均约 325 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @copylee/dsh-computer-use 还在维护吗？

最新版本 0\.8\.3 发布于 2026/11/07（3 天前）；至今共发布 32 个版本，其中过去 12 个月发布了 32 个；首次发布于 2026/10/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。