# @deskwink/cli 中文文档

规范地址：https://npmcn.com/package/%40deskwink/cli/

版本：0\.5\.2
npm 元数据更新时间：2026-11-10T05:48:21.769Z
中文译文更新时间：2026-11-13T05:05:34.985Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40deskwink/cli
原文对照：https://npmcn.com/package/%40deskwink/cli/?lang=original
项目主页：https://deskwink.com/
源码仓库：https://github.com/rwang23/deskwink

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

- 包体积（解压后）：2.4 MB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-10-19T23:26:09.872Z
- 最新版本发布：2026-11-10T05:48:21.318Z
- 近 30 天下载量：2258（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

桌面Wink CLI:将您的Windows PC,Mac或Linux计算机连接到您已经使用的AI. 默认情况下, 万事俱备; 限制在您的 OfficeWink 设置中 .

## 安装

```sh
npm install @deskwink/cli
```

也可以使用：`pnpm add @deskwink/cli`、`yarn add @deskwink/cli`、`bun add @deskwink/cli`

## README

# 服务台链接CLI

DeskWink允许您已经使用的AI(Claude, ChatGPT等支持远程MCP连接器的应用程序)使用您自己的Windows PC,Mac或Linux计算机工作. 一切都是默认的:整个计算机,命令,你的浏览器和(在Windows)桌面控制,没有等待批准. 在您的桌面链接设置中限制其中的任何内容 .

这个软件包是运行在您的计算机上的小程序. 它连接到 DeskWink, 所以您的计算机不需要打开端口 .

## 所需资源

-   Windows 10/11, macOS 13+, 或 Linux( x64 或 arm64; 桌面, 或没有屏幕的服务器)
-   22号节点或更新

## 开始吧

```bash
npm install -g @deskwink/cli
deskwink launch
```

第一个 `deskwink launch` 显示配对代码并打开 `app.deskwink.com` 在您的浏览器中。 签名确认密码匹配 OfficeWink 一直运行在背景.

新的计算机从所有内容开始,第一次发布时没有问你:你的AI可以在计算机的任何地方读取并更改文件(除了SSH密钥,保存的证书和密码存储等受保护的地方),运行命令,通过OpenWink扩展使用你的浏览器,在Windows上使用桌面并读取剪贴板. 无事等待您的批准(3级批准,无终止). OfficeWink网站可能会更改这些设置,OfficeWink在您注册时开始. 当Chrome或Edge被安装后,启动时也会为OpenWink浏览器扩展设置链接,因此从Chrome Web Store的扩展会自己连接. 在最后发射时列出哪些内容以及如何加以限制:在网站(计算机)上的桌面Wink设置中,或使用 `deskwink remote-settings off`, (中文(简体) ), `deskwink autostart disable`, (中文(简体) ), `deskwink access read folders`, (中文(简体) ), `deskwink approvals level 0` 财务报告和审定财务报表 `deskwink capabilities disable <feature>`。 。 。 .

使用更古老版本的计算机保持其访问、功能和批准水平。 启动时会打开两件东西:OfficeWink网站可能会更改其设置(它印出一行写着这样的话),OfficeWink在登录时会开始,除非你关掉它 `deskwink autostart disable`记住这两项决定: `deskwink remote-settings off` 或者说 `deskwink autostart disable`发射时永远不要打开.

同一台电脑再次对接是一个崭新的开始. 之后 `deskwink logout`,或者在您移除了 OfficeWink 网站上的计算机之后,下一个 `deskwink launch` 将它作为新的计算机对齐,并按上述方式打开所有设备,包括网站设置和开始登录(除非您运行) `deskwink autostart disable`) (中文(简体) ). 您先前的设置没有丢失: 发射将副本保存为 `policy.json.bak-<time>` 旁边 `policy.json` 在OfficeWink的文件夹和指纹中保存(保存了3个最新拷贝)。 将早期的设置与您在交互式终端上的所有需要相取代:从脚本,管子或没有终端运行,发射让计算机获得最少的访问权限,并打印开启所有命令. 启动一个仍然对齐的计算机,永远不会改变它的设置.

取舍:在这些默认情况下,你的AI运行命令并更改文件而不先询问,而OpenWink网站(以及任何接管OpenWink服务器的人)可以更改设置并批准为您服务. 浏览器中的支付步骤总是被拒绝的,浏览器在新站点之前,在签名或发送之前,桌面控制暂停移动鼠标,每个更改都会被备份并列在"活动"中. 限制你不希望的东西.

要连接您的AI, 请添加 `https://mcp.deskwink.com/mcp` 作为您的 AI 应用程序中的自定义连接器, 然后签名到 OfficeWink 并允许它。 菜单名称在应用程序和计划之间有所不同;参见 [a. 数据是:](https://deskwink.com/docs)。 。 。 .

在服务器上或之上 SSH 没有浏览器可打开 : `deskwink launch` 打印链接和短代码,然后在手机或笔记本电脑上打开链接。 见“Linux和服务器” [桌面wink.com/docs/开始](https://deskwink.com/docs/getting-started#linux)。 。 。 .

Claude Code 或 Codex 等编码代理可以为您安装 OfficeWink: 指向它们 [页面存档备份,存于互联网档案馆. deskwink.com/install.md](https://deskwink.com/install.md)。 。 。 .

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `deskwink launch [--passphrase]` | 平等 (第一次),然后在背景中开始 OfficeWink. `--passphrase` (Linux) 用密码句保护设备密钥 |
| `deskwink status` | 显示连接、 计算机、 共享文件夹和 MCP URL |
| `deskwink stop` | 现在断开连接; 您的人工智能无法再到达此计算机 |
| `deskwink folders list | add <path> | remove <name>` | 管理共享文件夹( 在键盘上添加需要您) |
| `deskwink access` • 妇女 `deskwink approvals level` • 妇女 `deskwink capabilities` | 您的人工智能能达到多少, 哪些变化不问就通过, 哪些特性在 |
| `deskwink remote-settings on | off` | DeskWink网站是否可以更改这些设置并批准此计算机的命令(默认情况下); `off` 被记住) |
| `deskwink autostart enable | disable` | 注册时启动桌面Wink(默认情况下); `disable` 被记住) |
| `deskwink restore <execution-id>` | 撤消应用的更改桌面链接 |
| `deskwink logs` | 显示本地日志( 仅显示元数据, 不显示文件内容) |
| `deskwink doctor` | 检查节点、网络、时钟、证书和文件夹访问 |
| `deskwink logout` | 从 OfficeWink 中删除此计算机并删除其密钥; 稍后再次对齐是一个新的开始 |

运行 `deskwink help` 每一个选项.

## 如何让你控制

-   您的AI可以到达您设定的内容: 整个计算机( 新计算机的默认) , 或者只有您共享的文件夹 。 文件工具无法打开被保护的地方(系统文件夹、桌面Wink本身、SSH密钥、, `.env` 档案和类似机密)。 命令按您运行, 并可以到达您账户中的任何内容; 关闭命令或请求批准以限制 .
-   每次文件更改都是分阶段的,之前的版本保存了7天,无论批准级别如何. 较低职等`deskwink approvals level 0`)您会审查台风控制台的准确变化,并在写出任何内容之前批准.
-   给 OfficeWink 更多的访问权限是在这里完成的,在您自己的终端,或者在 OfficeWink 网站上完成,同时它可能会改变这个计算机的设置. 网站的每次更改都需要最近的登录,并发电子邮件给您; `deskwink remote-settings off` 阻止网站制作 剥夺进入权总是从两者都起作用.
-   DeskWink将您的设备密钥存储在 Windows DPAPI, macOS keychain, 或在桌面密钥环或只有用户才能读取的文件上( 选择用密码句加密) 。 文件内容从不离开你的电脑,除了回答你的AI.

## 链接

-   网站和文件: [页面存档备份,存于互联网档案馆. deskwink.com](https://deskwink.com/)
-   隐私 : [a. 法律/隐私](https://deskwink.com/legal/privacy) · 术语: [deskwink.com/法律/术语](https://deskwink.com/legal/terms)
-   支助和安全报告: [支持@ deskwink.com](mailto:support@deskwink.com) (将主题中的"安全"写入安全报告)

DeskWink由Viva Essence有限公司(英格兰和威尔士,公司编号为16065477)运营. 这个软件包是专有软件,根据服务台链接服务条款提供。 它捆绑列出的开源组件 `dist/THIRD_PARTY_NOTICES.txt`。 。 。 .

## 常见问题

### @deskwink/cli 是什么？

桌面Wink CLI:将您的Windows PC,Mac或Linux计算机连接到您已经使用的AI\. 默认情况下, 万事俱备; 限制在您的 OfficeWink 设置中 \.

### 如何安装 @deskwink/cli？

在项目目录运行 npm install @deskwink/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 deskwink，可以用 npx deskwink 直接运行。

### @deskwink/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/deskwink\_\_cli 是否存在。

### @deskwink/cli 支持 ESM 还是 CommonJS？

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

### @deskwink/cli 需要什么版本的 Node\.js？

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

### @deskwink/cli 可以商用吗？

@deskwink/cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @deskwink/cli 的下载量有多少？

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

### @deskwink/cli 还在维护吗？

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