在 Duaer 里用 No Operation 占位

在 Duaer 里妥善处理错误

在 Duaer 里设计数字组织时，预先考虑失败，并决定失败后怎么告警或改道。

修复 Duaer 的内存问题

Duaer 不限制每个节点能取多少数据。执行需要的内存超过可用量时会出错。这一页说明如何识别并避免。

在 Duaer 里使用循环

需要按多条数据重复处理时，用 Duaer 的循环。多数节点会自动按条目执行；少数情况要自己建循环。

在 Duaer 里拆成子数字组织

用 Execute Sub-workflow 把一段流程拆成可复用的 Duaer 子数字组织。被调用方必须以 Execute Sub-workflow Trigger 开头。

在 Duaer 里管理用户与访问

在 Duaer 实例里邀请同事一起工作，包括登录、角色与项目权限。

把 LDAP 接到 Duaer

在 Duaer 里使用 LDAP。

为 Duaer LDAP 映射角色

把目录组映射到 Duaer 实例角色或项目角色。

为 Duaer OIDC 预配角色

完成 OIDC 登录后，把提供方的组映射到 Duaer 角色。

为 Duaer SAML 预配角色

完成 SAML 登录后，把断言里的组映射到 Duaer 角色。

在 Duaer 里要求两步验证

如何为 Duaer 账户启用两步验证。

Duaer 里的自定义角色

Duaer 自定义角色概览：项目级与实例级。

在 Duaer 里使用外部密钥库

把外部密钥库接到 Duaer。

在 Duaer 里使用源代码管理与环境

Duaer 源代码管理与环境概览。

为 Duaer 设置源代码管理

把 Duaer 实例连到你的 Git 提供方。

在 Duaer 里使用环境

理解 Duaer 里环境背后的概念。

在 Duaer 里使用 Git

Duaer 里的 Git 概念与限制。

在 Duaer 里推送与拉取改动

把工作送到 Git，并从 Git 拉回你的 Duaer 实例。

把 Duaer 日志流到外部系统

把 Duaer 事件流到你的日志工具。

用 Insights 跟踪 Duaer 用量

Duaer Insights 让实例所有者与管理员看到数字组织一段时间里的表现。

接口

使用 Duaer 公开 API

用 API 密钥调用 Duaer 公开 REST API。

接口

Duaer 公开 API 的身份验证

Duaer 用 API 密钥鉴权公开 REST API。

接口

Duaer 公开 API 端点参考

对照你这台 Duaer 实例上的公开 REST API。文档站不另存一份会过期的路由表。

Duaer 变更日志

Duaer 版本说明入口。破坏性变更另有专页。

Duaer 发行说明

这一版 Duaer 带来了什么，以及升级时要核对的项。

Duaer v3 破坏性变更

升级到 Duaer v3 后会改变的行为。

Duaer 1.0 迁移清单

从 Duaer 1.0 之前迁上来时要核对的项。

Duaer 2.0 破坏性变更

升级到 Duaer 2.0 后会改变的行为。

在 Duaer 里启用队列模式

按需要用不同模式跑 Duaer。队列模式可扩展性最好。

控制 Duaer 并发

限制自托管 Duaer 同时跑多少生产执行。

修复自托管 Duaer 的内存问题

自托管 Duaer 的内存相关错误：如何识别与避免。

在 Duaer 里处理二进制数据

处理大文件而不拖慢 Duaer。

比较 Duaer 版本

比较自托管 Duaer 的社区版、注册社区版、Business 与 Enterprise。

为自托管 Duaer 配置用户管理

配置自托管 Duaer 以支持用户管理，并开始邀请用户。

Duaer 加密密钥

Duaer 用加密密钥保护写入数据库的凭证。首次启动会自动生成；也可用 DUAER_ENCRYPTION_KEY。

为 Duaer 设置自定义加密密钥

为 Duaer 设置自定义加密密钥，用于安全加密凭证。

Duaer 环境变量

用环境变量配置自托管 Duaer 进程。

用环境变量管理 Duaer 设置

从进程环境、.env 或容器注入配置自托管 Duaer。

Duaer 支持的数据库

自托管 Duaer 可用 SQLite 或 Postgres。

为 Duaer 设置 task runners

配置 Duaer task runners，用内部或外部进程执行任务。

用 OpenTelemetry 追踪 Duaer 执行

把 Duaer 数字组织与节点执行的追踪发到 OpenTelemetry 采集端。

使用 Duaer 命令行

自托管 Duaer 内置命令行可用的命令。

更新 Duaer

更新自托管 Duaer 的最佳实践。

在 Duaer 上运行安全审计

对你的 Duaer 实例运行安全审计。

Duaer 里的流程逻辑

失败怎么走、循环、以及子数字组织。画布上最常见的流程问题从这三页开始。

配置自托管 Duaer

加密密钥、环境变量、数据库与任务运行器。生产环境优先 Postgres，并固定 DUAER_ENCRYPTION_KEY。

Duaer 配置示例

可直接套用的自托管配置写法。先从自定义加密密钥开始。

在 Duaer 项目角色里开放执行记录

在 Duaer 里，项目角色的「执行记录」有查看和删除。查看跟着数字组织的查看走，不能单独勾上。

看懂 Duaer 实例角色里的个人空间

在 Duaer 里，每个实例角色都会列出个人空间权限，那些勾选不能在角色上关掉。能关的是安全与策略里的发布和共享。

在 Duaer 里看到受限节点并换成可用的

在 Duaer 里，被策略挡住的节点仍出现在搜索里，但不能加到画布。替换步骤时，面板标题是「替换此步骤」。

让 Duaer 读到 Telegram 图片

在 Duaer 里，Telegram Trigger 要打开下载图片和文件，数字员工才能读到图片内容，而不只是一条文字更新。

在窄屏上查看 Duaer 节点的输入和输出

在 Duaer 里，打开节点后，窗口变窄时输入面板和输出面板仍然留在画面上。没有单独的开关。

在 Duaer 里取消执行后状态保持取消

在 Duaer 里，你取消的执行会停在已取消。之后的写入不会把它改成成功或失败。

怎么开始用 Duaer

Duaer 可以开在 www.duaer.com 上，也可以用 Docker 自己托管。套餐决定每月执行次数和 AI 积分。

在 Duaer 里创建第一名数字员工

在 Duaer 里新建一名数字员工：写清指令、选好模型、发布后开一次对话验收结果。界面按钮可能写「智能体」。

在 Duaer 里做出第一张数字组织

在 Duaer 里把画布流程跑通：手动触发、Edit Fields、执行一次。这不是数字员工的交付验收主路径。

Duaer 里会碰到的词

Duaer 里数字组织是画布上的流程，数字员工是交付结果的那一侧。节点、凭证、表达式和套餐都在这一页。

套餐

Duaer 套餐与积分

Duaer 线上按执行次数计费。Hobby 免费，每月 1,000 次执行和 800 AI 积分。年付大约便宜 17%。

在 Duaer 里保存并发布数字组织

在 Duaer 里，编辑会先存成草稿。点发布之后，定时、Webhook 和生产地址才按这一版运行。

在 Duaer 里查看执行记录

在 Duaer 里，一次执行就是数字组织跑完的一轮。侧栏的执行记录列出成功、错误、已取消、运行中、排队和等待。

在 Duaer 里调试一次过去的执行

在 Duaer 里，打开一次历史执行，用在编辑器中调试把当时的数据钉回画布，再改节点重跑。

在 Duaer 里用 If 和 Switch 分叉

在 Duaer 里，If 把每条数据分到 true 或 false。Switch 按规则或表达式分到多个出口。

在 Duaer 里用 Merge 汇合数据

在 Duaer 里，Merge 等各路数据到齐后，按追加、按字段合并、SQL 或只留一路继续。

在 Duaer 里用 Wait 暂停执行

在 Duaer 里，Wait 让这次执行停住，等到一段时间、某个时刻、一次 Webhook 或一次表单提交再继续。

在 Duaer 里导出和导入数字组织

在 Duaer 里，导出 JSON 得到画布和节点，不含凭证里的密钥。导入之后要重新选凭证。

在 Duaer 里分享数字组织并打标签

在 Duaer 里，分享把一条数字组织交给其他人或项目。标签写在描述里，用来在列表里筛选。

在 Duaer 里用 Webhook 接收请求

在 Duaer 里，Webhook 是数字组织的入口。测试地址只在监听时有效，生产环境地址要发布之后才接外部请求。

在 Duaer 里用 Schedule Trigger 定时运行

在 Duaer 里，Schedule Trigger 按你设的间隔启动数字组织。发布之后才按点跑。画布上的执行是立刻试一次，不等到点。

在 Duaer 里用 HTTP Request 调接口

在 Duaer 里，HTTP Request 按你填的方法和地址发请求。账号放在凭证里，不写进节点参数。

在 Duaer 里用 Filter 丢掉不需要的数据

在 Duaer 里，Filter 按条件分流：符合的走 Kept，不符合的走 Discarded。节点步骤见 /build/filter/。

在 Duaer 里决定分支先跑哪一边

在 Duaer 里，一条数字组织分出多条分支时，Execution Logic 决定先做完哪一边。新的数字组织用 v1（推荐）。

在 Duaer 里从模板开始

在 Duaer 里，模板是一条现成的数字组织。用模板会复制到你的实例，凭证要在这里重新选。

数据

在 Duaer 里用数据表留下结果

在 Duaer 里，数据表存在当前项目里。一条数字组织写入的行，同一项目里的另一条可以再读。

在 Duaer 里用 Respond to Webhook 回复调用方

在 Duaer 里，Respond to Webhook 决定 Webhook 或表单什么时候、用什么内容回复。前面的 Webhook 要把 Respond 设成 Using Respond to Webhook Node。

在 Duaer 里用表单收集填写

在 Duaer 里，Duaer Form Trigger 生成一张网页表单。有人提交后，这条数字组织开始跑，字段出现在节点输出里。

在 Duaer 里用 Edit Fields 改字段

在 Duaer 里，Edit Fields (Set) 给每条数据加上或改掉字段。只改几个字段时用它，不必写 Code。

在 Duaer 里用 Loop Over Items 分批处理

在 Duaer 里，面板名是 Loop Over Items (Split in Batches)。多数节点已经会按条执行；这个节点用来限定每一批的条数，并在批与批之间接回自己。节点步骤见 /build/loop-over-items/。

在 Duaer 里用 Manual Trigger 手动开跑

在 Duaer 里，Manual Trigger 只在你点执行数字组织时启动。一条数字组织只能有一个 Manual Trigger。

在 Duaer 里用 Code 写一小段逻辑

在 Duaer 里，Code 用 JavaScript 或 Python 处理当前条目。只改几个字段时，优先用 Edit Fields。

在 Duaer 里用 Stop and Error 主动判失败

在 Duaer 里，Stop and Error 会停住这次执行并记成错误。后面的节点不会再跑。可用来触发错误数字组织。

在 Duaer 里用 Limit 限制条数

在 Duaer 里，Limit 只留下前几条或后几条。超出 Max Items 的条目在这一步被丢掉。

在 Duaer 里用 Sort 排序条目

在 Duaer 里，Sort 按字段名重排当前条目。Type 可选 Simple、Random 或 Code。

在 Duaer 里用 Remove Duplicates 去重

在 Duaer 里，Remove Duplicates 丢掉当前输入里重复的条目。也可以按以前执行里见过的值去重。

在 Duaer 里用 Aggregate 把条目收成一组

在 Duaer 里，Aggregate 把多条输入收成更少的输出。可以只收某几个字段，也可以把整批收成一个列表。

在 Duaer 里用 Markdown 做格式转换

在 Duaer 里，Markdown 节点在 Markdown 和 HTML 之间转换。结果写到 Destination Key 指定的字段。

在 Duaer 里用 Convert to File 写出文件

在 Duaer 里，Convert to File 把当前条目的 JSON 转成 binary 上的文件。默认 Operation 是 Convert to CSV。

在 Duaer 里用 Extract from File 读出文件

在 Duaer 里，Extract from File 从 binary 上的文件读出 JSON 条目或文本。默认 Operation 是 Extract From CSV。

在 Duaer 里用 Date & Time 处理时间

在 Duaer 里，Date & Time 默认 Operation 是 Get Current Date。只在表达式里取当前时间时，也可以用 {{ $now }}，不必加这个节点。

在 Duaer 里用 Rename Keys 改字段名

在 Duaer 里，Rename Keys 只改字段名，不改字段值。在 Keys 里填 Current Key Name 和 New Key Name。

在 Duaer 里用 Split Out 拆开列表

在 Duaer 里，Split Out 把条目里的列表拆成多条。必填 Fields To Split Out；Include 默认是 No Other Fields。

在 Duaer 里用 Compare Datasets 对比两路数据

在 Duaer 里，Compare Datasets 有 Input A 和 Input B 两个输入，四个输出：In A only、Same、Different、In B only。用 Fields to Match 配对。

在 Duaer 里用 Compression 压缩或解压文件

在 Duaer 里，Compression 默认 Operation 是 Decompress。Input Binary Field(s) 默认是 data，处理的是条目上的 binary，不是本机路径。

在 Duaer 里用 Crypto 做哈希

在 Duaer 里，Crypto 默认 Action 是 Hash。Type 默认 SHA256，结果写到 Property Name（默认 data），Encoding 默认 HEX。

在 Duaer 里用 Filter 筛选条目

在 Duaer 里，Filter 有两个出口：Kept 和 Discarded。在 Conditions 里写条件；Options 里 Ignore Case 默认打开。

在 Duaer 里用 If 分成 true 和 false

在 Duaer 里，If 有两个出口：true 和 false。条件写在 Conditions；没接到的那一侧上的条目会丢掉。

在 Duaer 里用 Switch 按规则分多路

在 Duaer 里，Switch 默认 Mode 是 Rules。在 Routing Rules 里为每条规则写 Conditions；未匹配且 Fallback Output 为 None 时条目被忽略。

在 Duaer 里配置 Wait 节点

在 Duaer 里，Wait 默认 Resume 是 After Time Interval。当前版本 Wait Amount 默认 5，Wait Unit 默认 Seconds。

在 Duaer 里配置 Merge 节点

在 Duaer 里，Merge 默认 Mode 是 Append，把各输入的条目顺次接成一条输出。按字段合并时改 Mode 为 Combine。

在 Duaer 里用 Summarize 汇总字段

在 Duaer 里，Summarize 在 Fields to Summarize 里选 Aggregation（默认 Count）和 Field。可用 Fields to Split By 分组。

在 Duaer 里用 HTML 节点处理网页片段

在 Duaer 里，HTML 默认 Operation 是 Generate HTML Template。还可以 Extract HTML Content 或 Convert to HTML Table。

在 Duaer 里用 XML 节点转换格式

在 Duaer 里，XML 默认 Mode 是 XML to JSON。Property Name 默认是 data。binary 里的 XML 先用 Extract from File 转成文本。

在 Duaer 里用 Edit Image 改图片

在 Duaer 里，Edit Image 默认 Operation 是 Border。Property Name 默认是 data，指向条目 binary 上的图片。

在 Duaer 里用 Execution Data 标记执行

在 Duaer 里，Execution Data 默认 Operation 是 Save Highlight Data (for Search/review)。在 Data to Save 里加 Key 和 Value，方便在执行列表里查看和筛选。

在 Duaer 里配置 Stop and Error 节点

在 Duaer 里，Stop and Error 没有输出。默认 Error Type 是 Error Message。执行到这里会失败并停止后续节点。

在 Duaer 里用 Execute Duaer Organization 调子组织

在 Duaer 里，节点名是 Execute Duaer Organization。当前版本 Source 默认 Database，Mode 默认 Run once with all items。被调用方要以 Execute Workflow Trigger 开头。

在 Duaer 里用 Execute Command 跑主机命令

在 Duaer 里，Execute Command 在运行 Duaer 的那台机器上执行命令。Execute Once 默认打开；Command 必填。

在 Duaer 里用 JWT 签发令牌

在 Duaer 里，JWT 默认 Operation 是 Sign。需要配置 jwtAuth 凭据。Use JSON to Build Payload 默认关闭。

在 Duaer 里用 Sticky Note 写画布说明

在 Duaer 里，Sticky Note 没有输入输出。默认 Content 是一段 Markdown 提示；Height 160、Width 240、Color 1。

在 Duaer 里用 GraphQL 请求接口

在 Duaer 里，GraphQL 默认 Authentication 是 None，HTTP Request Method 默认 POST。填 Endpoint 和 Query；响应默认按 JSON，写在 Response Data Property Name（默认 data）。

在 Duaer 里用 SSH 连远程主机

在 Duaer 里，SSH 默认 Authentication 是 Password，Resource 是 Command，Operation 是 Execute。Working Directory 默认是 /。

在 Duaer 里用 FTP 传文件

在 Duaer 里，FTP 节点 Protocol 默认是 FTP（也可选 SFTP）。Operation 默认 Download；下载结果写到 Put Output File in Field（默认 data）。

在 Duaer 里配置 Loop Over Items

在 Duaer 里，节点显示名是 Loop Over Items (Split in Batches)，默认名是 Loop Over Items。两个出口：loop 和 done。Batch Size 默认是 1。

在 Duaer 里用 Send Email 发邮件

在 Duaer 里，节点名是 Send Email。默认 Operation 是 Send。填 From Email、To Email、Subject；当前版本 Email Format 默认 HTML。

在 Duaer 里用 Read/Write Files from Disk

在 Duaer 里，Read/Write Files from Disk 默认 Operation 是 Read File(s) From Disk。它读写运行 Duaer 的那台机器上的路径，不是浏览器所在电脑。

在 Duaer 里用 Duaer Form 加表单页

在 Duaer 里，Duaer Form 接在 Duaer Form Trigger 后面。Page Type 默认是 Next Form Page；也可选 Form Ending 结束表单。

在 Duaer 里用 MQTT 发布消息

在 Duaer 里，MQTT 向主题发布消息。Topic 必填；Send Input Data 默认打开。需要 mqtt 凭据。

在 Duaer 里用 DebugHelper 造故障与样例数据

在 Duaer 里，DebugHelper 故意制造问题或随机数据，方便调试。Category 默认 Throw Error；Error Type 默认 NodeApiError。

在 Duaer 里用 Redis 读写键值

在 Duaer 里，Redis 默认 Operation 是 Info。也可用 Set / Get 等操作读写键。需要 redis 凭据。

在 Duaer 里用 AMQP Sender 发消息

在 Duaer 里，AMQP Sender 按 AMQP 1.0 向 Queue / Topic 发消息，每条输入执行一次。需要 amqp 凭据。

在 Duaer 里用 Email Trigger (IMAP) 收信

在 Duaer 里，Email Trigger (IMAP) 在收到新邮件时启动数字组织。Mailbox Name 默认 INBOX；Action 默认 Mark as Read；Format 默认 Simple。需要 imap 凭据。

在 Duaer 里用 Postgres 读写表

在 Duaer 里，Postgres 默认 Operation 是 Insert。选 Schema、Table，再在 Columns 里映射字段。需要 postgres 凭据。

在 Duaer 里用 MySQL 读写表

在 Duaer 里，MySQL 默认 Operation 是 Insert。选 Table；Data Mode 默认 Auto-Map Input Data to Columns。需要 mySql 凭据。

在 Duaer 里用 MongoDB 查文档

在 Duaer 里，MongoDB 默认 Resource 是 Document，Operation 是 Find。填 Collection；Query (JSON Format) 默认是 {}。需要 mongoDb 凭据。

在 Duaer 里用 Local File Trigger 监视主机文件

在 Duaer 里，Local File Trigger 在主机文件系统变化时启动数字组织。路径是运行 Duaer 的那台机器上的路径，不是浏览器所在电脑。

在 Duaer 里用 Slack 发消息

在 Duaer 里，Slack 默认 Authentication 是 Access Token，Resource 是 Message，Operation 是 Send。Message Type 默认 Simple Text Message。

在 Duaer 里用 Telegram 发消息

在 Duaer 里，Telegram 默认 Resource 是 Message，Operation 是 Send Message。需要填 Chat ID 和 Text。需要 telegramApi 凭据。

在 Duaer 里用 Google Sheets 读行

在 Duaer 里，Google Sheets 默认 Authentication 是 OAuth2，Resource 是 Sheet，Operation 是 Get Row(s)。需要 googleSheetsOAuth2Api 凭据。

在 Duaer 里用 TOTP 生成验证码

在 Duaer 里，TOTP 默认 Operation 是 Generate Secret。Options 里 Algorithm 默认 SHA1，Digits 默认 6，Period 默认 30。需要 totpApi 凭据（存 label 与 secret）。

在 Duaer 里用 Google Drive 上传文件

在 Duaer 里，Google Drive 默认 Authentication 是 OAuth2，Resource 是 File，Operation 是 Upload。Input Data Field Name 默认 data。需要 googleDriveOAuth2Api 凭据。

在 Duaer 里用 Discord 发消息

在 Duaer 里，Discord 默认 Connection Type 是 Bot Token；Resource 默认 Channel。发聊天时把 Resource 改成 Message，Operation 选 Send。需要 discordBotApi 凭据。

在 Duaer 里用 Dropbox 上传文件

在 Duaer 里，Dropbox 默认 Authentication 是 Access Token，Resource 是 File，Operation 是 Upload。File Path 必填。需要 dropboxApi 凭据。

在 Duaer 里用 SSE Trigger 收事件流

在 Duaer 里，SSE Trigger 在收到 Server-Sent Events 时启动数字组织。URL 必填，事件 data 需是 JSON。

在 Duaer 里用 Gmail 发邮件

在 Duaer 里，Gmail 默认 Authentication 是 OAuth2，Resource 是 Message，Operation 是 Send。Email Type 默认 HTML。需要 gmailOAuth2 凭据。

在 Duaer 里用 Notion 创建页面

在 Duaer 里，Notion 默认 Authentication 是 API Key，Resource 是 Page，Operation 是 Create。Content Type 默认 Block Builder。需要 notionApi 凭据。

在 Duaer 里用 GitHub 创建 Issue

在 Duaer 里，GitHub 默认 Authentication 是 Access Token，Resource 是 Issue，Operation 是 Create。需要 githubApi 凭据。