描述想要的功能
说明何时、在哪里、做什么。例如：“欢迎新成员，并给他们添加成员身份组。”
一起创建您的第一个Bot。
先从欢迎新成员开始。我们将带您把现成示例改成适合自己服务器的样子，测试后再发布。这里也会介绍如何请AI帮忙，或从零开始搭建。
体验基本操作 · 约3分钟无需登录或安装 Bot。 在新标签页打开，不会改变正在编辑的 Bot。01
从示例创建欢迎Bot
新成员加入时，Bot会向您指定的频道发送欢迎消息。示例已连接好各个步骤，只需调整发送目标和正文，让它适合您的服务器。
新成员加入发送欢迎消息不发送消息并测试发布并启用- 1
选择服务器并打开示例
使用Discord登录，在顶部选择服务器。如果尚未安装DPalette，先点击“安装Bot”进行连接。打开“示例”，加载欢迎示例。
- 2
选择发送频道
在示例设置画面中，从列表选择要发送欢迎消息的频道。不用查找或输入频道ID。
- 3
换成自己的欢迎语
选择“发送消息”，在右侧设置面板编辑正文。通过“插入值”可以选择对新加入成员的提及。
- 4
先试一试，再正式使用
通过“验证”检查设置，用“测试运行”查看计划发送的内容。确认后保存草稿，再点击“发布并启用”。
02
用自己的话，请AI帮您起草
告诉AI您想让Bot做什么，例如“开播时在通知频道发一条消息”。AI会组合DPalette的功能提出方案，请确认内容后再使用。
补充必要设置
需要频道、身份组或成员时，可从Discord服务器候选中选择，无需手工复制ID。
检查并应用
确认AI补充的条件和注意事项，再应用到编辑区。每个步骤都可以修改。请检查发送目标和权限，并在发布前测试。
AI不会自行发布或运行Bot
应用方案只会修改尚未保存的编辑内容，不会自动保存、测试、发布或正式执行。DPalette也不会为AI读取或发送已保存的API密钥（Secrets）和数据库记录。
03
想自己搭建？
不用示例，也可以通过这7步创建同样的欢迎功能。先决定何时开始，再连接Bot应该执行的步骤。
- 1
使用Discord登录
登录后选择要编辑的Discord服务器。如果尚未安装DPalette，请点击“安装Bot”。新创建的服务器会在“刷新服务器”后出现。
- 2
添加开始条件
从左侧步骤列表将“成员加入”拖到编辑区。这就是启动Bot行为的事件。
- 3
添加操作
添加“发送消息”，它会在新成员加入后执行。
- 4
连接执行顺序
用实线将“成员加入”的next端口连接到“发送消息”的输入端口。
- 5
在右侧设置
设置频道和消息正文，点击“插入值”选择对新成员的提及。
- 6
检查设置并测试
先修复“验证”中提示的问题，再用测试运行（Dry Run）查看预计执行的操作，不会真正修改Discord。
- 7
保存草稿并发布
保存草稿，验证通过后点击“发布并启用”。Bot便会按照发布的内容响应Discord事件。
04
测试后再上线
编辑中的草稿与服务器上运行的版本相互独立。发布修改之前，Bot会保持原有行为。
1. 检查设置
通过“验证”检查未连接的步骤、必填设置和所需权限等。请先修复提示的问题。
2. 不发送消息并测试
测试运行（Dry Run）不会向Discord写入内容。您可以查看经过哪些步骤，以及计划发送什么。
3. 发布并启用
发布已确认的草稿后，就可以在服务器上使用。在您编辑下一次修改时，已发布的版本会继续运行。
注意无法撤销的操作
删除等操作请确认风险标签和执行限制。建议先在测试服务器通过Dry Run确认行为。
05
用连线连接顺序和数据
执行顺序与数据传递相互独立。理解两者后，大型工作流也更容易阅读。
实线：执行顺序（Flow）
决定下一个运行的节点。true和false等分支也是Flow。
虚线：传递数据（Data）
将消息、成员等值传入有类型的输入端口，只能连接兼容类型。
join节点ID
引用数据时的第一段。本指南中“成员加入”节点的ID是join。
不确定时
先用Flow实线完成执行顺序，再添加所需的Data虚线。
06
使用前置节点的数据
大多数操作字段（包括消息、URL、数字、列表和选项）都可以使用前面步骤的输出。候选值根据当前工作流生成。触发条件等固定设置除外。
Welcome
{{ join.member.mention }}!＋ 插入值 或输入 {{
无需背诵
点击字段旁的小 {} 按钮（插入值），或按 Ctrl+Space。文本字段也可以输入 {{。选择候选项即可插入 {{ 节点ID.输出.属性 }}。可用方向键、Enter 和 Esc 操作。
| 路径示例 | 表示的值 |
|---|---|
join.member.mention | 加入成员的Discord mention |
join.guild.member_count | 该成员加入后的当前服务器成员数（包括Bot） |
join.member.display_name | 加入成员的显示名称 |
message.message.content | 收到的消息正文 |
message.author.mention | 消息作者的Discord mention |
manual.payload.target_user | 手动操作中定义的target_user输入 |
webhook.body | Incoming Webhook请求正文 |
schedule.scheduled_at | Schedule触发时间 |
join、message、manual等前缀是节点ID。实际候选值使用画布中的ID。输出来源节点必须先于引用节点在Flow中执行。
07
无需在工作流中直接填写API密钥
Secrets是按Discord服务器保存外部API密钥、令牌等凭据的可选功能。包括YouTube通知在内的普通预设不需要Secrets。
1. 保存到安全性 → Secrets
选择服务器，打开安全性，然后在Secrets中保存名称和值。可使用api_key或github_token等易懂的名称。
2. 通过名称引用
在可输入文本的节点设置中使用{{ secret.名称 }}。如果名称为api_key，则写作{{ secret.api_key }}。
3. 用于外部API
外部服务需要身份验证时，可在HTTP请求的标头、查询参数和正文中使用Secrets。
保存的值会保持隐藏
保存后DPalette不会再次显示Secret值，并会在保存的执行详情中隐藏它。需要轮换时，请用相同名称保存新值。
08
需要时立即手动运行工作流
DPalette不仅能创建等待事件的自动化，也能创建通过输入表单立即执行的Manual Action。同一工作流还可以发布为Discord斜杠命令。
手动触发器→发布→Actions / /命令→执行历史1. 创建Manual Action
以手动触发器作为起点，定义target_user、数量上限等输入项，再连接后续操作。草稿请在测试面板中试运行；通过验证并发布后才能用于正式执行。
2. 从Actions手动执行
已发布的Manual Action会以自动生成的输入表单显示在Actions中。先用Dry Run检查效果；非破坏性操作使用Run Now，删除等破坏性操作使用Review & Run确认后执行。
3. 转为Discord命令
在触发器设置中启用斜杠命令，即可同步拥有相同输入项的服务器专用命令。例如：/purge-user target_user:@spammer。发布后会自动同步，也可在Actions中重新同步。
无论从哪里执行，都使用相同的安全机制
Actions和Discord命令共享Workflow Executor、执行限制、并发控制和执行历史。Dry Run不消耗正式执行配额，且只有已发布版本能够正式运行。
09
遇到问题时
大多数问题与连接、执行顺序或Discord权限有关。
没有显示值候选项＋
请确认画布上存在另一个有输出的节点。节点自身的输出不会出现在其设置候选项中。
新创建的Discord服务器不在列表中＋
服务器列表是登录时的快照。请在编辑器中使用“刷新服务器”从Discord重新获取，然后再选择新服务器。
出现unknown property或unknown root＋
手动输入的路径与实际节点ID或输出不一致，请从“插入值”重新选择。
候选值在运行时无法解析＋
请确认来源节点在同一Flow分支中更早执行。
Discord权限错误＋
请在验证中检查所需权限和Gateway Intent，并确认Bot角色顺序、频道权限和Developer Portal设置。
从一句简单的欢迎开始。
从示例列表中选择欢迎示例，把消息改成适合您服务器的语气。
打开示例 →