# @duetso/agent 中文文档

规范地址：https://npmcn.com/package/%40duetso/agent/

版本：1\.1\.47
npm 元数据更新时间：2026-10-31T22:06:36.502Z
中文译文更新时间：2026-11-01T00:56:15.896Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40duetso/agent
原文对照：https://npmcn.com/package/%40duetso/agent/?lang=original
项目主页：https://github.com/aomni-com/duet#readme
源码仓库：https://github.com/aomni-com/duet

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

- 包体积（解压后）：13.4 MB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-05-08T06:02:23.401Z
- 最新版本发布：2026-10-31T22:06:36.330Z
- 已发布版本数：272（近 12 个月 272 个）

## 中文简介

双重CLI用于本地代理、工作区和文件同步

## 安装

```sh
npm install @duetso/agent
```

也可以使用：`pnpm add @duetso/agent`、`yarn add @duetso/agent`、`bun add @duetso/agent`

## README

# 二重唱CLI

该工作空间由duet命令组成：本地代理工作、终端UI和 一次登录下的工作空间/文件/同步操作。npm的 身份仍然是@duetso/agent。

版权所有(c) 2026 dzzhg， LLC [agpl - 3.0](https://npmcn.com/package/%40duetso/agent/LICENSE);捆绑的依赖项保留其许可证和通知。

外部代理使用 [消费能力](https://npmcn.com/package/skills/duet/SKILL.md) 来 从他们自己的计算机安装和操作释放的命令。根 [代理设置](https://npmcn.com/package/README.md#agent-setup) 具有安装技能。

在安装public命令之前，请先安装Bun 1.3.14和Node 22及以上版本：

```sh
npm install -g @duetso/agent
duet login
```

命令在Bun上运行；NPM提供外部包。 `duet login` 节省了 一个用于工作空间命令和Mac同步的人工凭证。使用 `duet workspace use <slug>` 选择默认工作区和 `duet --help` 用于命令界面。

控制运行时和协议所有权属于私有 [代理工作空间](https://npmcn.com/package/%40duetso/agent/README.md)． CLI直接使用该所有者； 它拥有调度和用户配置。局部记忆和训练仍然存在 Local unless——workspace显式地选择远程操作。保存的默认值 选择远程操作对象和模式计费；它不会改变执行 模式。显式文件地址和工作空间标志必须一致。

命名API操作使用共享 [客户绑定](https://npmcn.com/package/%40duetso/contract/src/endpoints/customer-bindings.ts). 他们的帮助来自于这些绑定。完整的主体输入来自文件 或stdin;查询和声明的头输入是分开的。JSON结果保留 stdout上的API字段，而stderr上的HTTP状态和标头是NDJSON元数据。 命名二进制写入流的本地文件 `--in`，或与 `--in -`. CLI JSON主体文件也接受共享 [二进制请求表示](https://npmcn.com/package/%40duetso/contract/README.md#customer-adapter-representations) 对于任意字节。保留声明的内容类型和条件标头。 空的条件/可选读取保留HTTP元数据，而不替换 当地的目的地。二进制读取使用现有的 `src/file-transfers.ts` 标准输出的流媒体所有者 或者一个本地目的地。与 `--json`，故障保留完整的上游体 内部 `apiError`;非作用域拒绝保留自己的代码。本地文件处理和进程退出代码仍然是cli所有的。

[服务调用](https://npmcn.com/package/%40duetso/agent/src/commands/services.ts) 使用命名的供应商操作，而不是 任意Duet REST调用者。API保留路由准入，供应商 证书，资金和会计。调用保留重复的查询/表单值； 完整的JSON和原始字节；HTTP状态和所有返回的标头都转到stderr。 输出文件可以包含供应商拒绝，因此调用方必须保留出口 状态和元数据。已安装的帮助拥有输入标志。

命名 `model` 操作使用网关的独立源和现有计费 工作区。它们完整的原生体、协议选择和头是 由命令帮助发布；网关拥有准入和准确的模型id。 原生流需要协议结束。媒体字节使用普通的本地文件， 机器结果保留了周围的本机元数据。交货失败 这将导致标准输出上所有成功保存的文件，并以非零值退出。 与 `--json`， stderr包括索引传递错误。一代永远不会 重复以恢复。 分离的视频收据和原始状态结果仍然可以在没有另一个的情况下恢复 客户端作业系统。 提示便利性和本机命令共享SDK媒体和输出所有者。

远程会话使用来自共享的持久输入结果 [会议合同](https://npmcn.com/package/%40duetso/contract/README.md)． Submission写入其恢复请求 在HTTP之前将标识转换为stderr，然后返回一个终端结果或可恢复句柄。 等待的结果不会取消工作；结果/等待只观察该输入。 退出0表示成功完成，1表示失败/取消，2表示需要 检查尸体。只重新等待 `status: "pending"`． 一个终端 `ask` 需要 一个带有新输入句柄的答案；其他最终结果，包括 `sleep` 和 `interrupted`，他们的处理仍然是最后的。运输关闭不能 建立完成。

`duet app credentials` 管理已注册的外部运行时密钥 使用相同保存的人工登录名或进程提供的VM密钥。工作空间和 应用程序选择是显式的。Export返回标准输出时的完整API响应，包括一次性响应 明文密钥和部署url；HTTP元数据转到stderr。捕获 键在内存中，并通过stdin将其传递到主机的服务器端秘密存储。 该命令从不保存导出的密钥或重试不明确的mint。检查 在再次显式导出之前，激活库存并撤销不需要的条目。 轮换使用第二次导出，主机部署和验证，然后撤销 先前的证书。 `duet app credentials --help` 拥有命令界面。

保存的人工登录和默认API/工作区位于config.json中。其他 提供程序密钥保留在提供程序env文件中，连接的订阅保留 他们自己的商店。登录批准识别人员；访问遵循当前 工作区会员。Mac镜像有自己的非秘密机器身份， 因此，删除Mac并不会撤销登录。

存储库和公共构建都将本机包保持在外部 `scripts/native-packages.ts`保护他们的进口相关资产。公共 打包还内联了私有工作区代码并保留了Pi补丁。NPM是一个外部发布渠道。VM命令使用 托管运行时版本，包括交互式shell调用。

将包脚本用于构建、检查和集中的一次性容器 测试。这个CLI仍然是bunnative的。根lockfile拥有依赖项，并且 根存储库拥有发布和VM发布交付。

[Mac同步](https://npmcn.com/package/%40duetso/agent/src/sync/README.md) 保持一个计算机身份跨独立 工作区转移实例，删除帐户独立于用户登录。

## 常见问题

### @duetso/agent 是什么？

双重CLI用于本地代理、工作区和文件同步

### 如何安装 @duetso/agent？

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

### @duetso/agent 支持 TypeScript 吗？

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

### @duetso/agent 支持 ESM 还是 CommonJS？

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

### @duetso/agent 需要什么版本的 Node\.js？

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

### @duetso/agent 可以商用吗？

@duetso/agent 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @duetso/agent 还在维护吗？

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