DooTask 机器人管理入口全解析:从「我的机器人」抽屉到 bot-manager 指令管理
DooTask 机器人管理入口全解析:从「我的机器人」抽屉到 bot-manager 指令管理
DooTask 将「机器人管理」功能统一收纳在「应用」面板中,并通过一个内置系统机器人 bot-manager@bot.system 提供可选的斜杠指令入口。本文以 resources/ai-kb/zh/menu-map/menu-navigation/bot-mgmt.md 为骨架,结合前端 application.vue、后端 UserBot 模型、BotReceiveMsgTask 与 UsersController 机器人接口 的源码实现,完整讲解桌面端、移动端、指令三种入口的进入方式、抽屉面板能力、权限边界与系统机器人查找方法。读完本文,你可以熟练地在任意端快速定位机器人管理面板、用指令完成机器人全生命周期管理,并理解 50 个创建上限与「系统机器人不可删除」背后的后端校验逻辑。
入口总览
DooTask 的机器人管理没有独立主导航标签,统一收敛在「应用」面板下,共三条进入路径:
| 端 | 路径 | 备注 |
|---|---|---|
| 桌面端(Web / Electron) | 左侧栏「应用」→「我的机器人」卡片 → 右侧 720px 抽屉 | 主入口,功能最完整 |
| 桌面端指令入口 | 消息列表搜 bot-manager@bot.system → 单聊里发 /list 看列表、/newbot 名称 新建 |
纯键盘操作,适合高频管理 |
| 移动端 | 底部 Tabbar「应用」→「我的机器人」 | 与桌面端同构的卡片式列表 |
| 快捷键 | 无 | 只能从「应用」面板进入 |
三条路径最终都指向同一套能力:查看自己创建的机器人列表、添加机器人、以及每条机器人的「开始聊天 / 修改 / 删除」操作。
桌面端入口:左侧栏「应用」→「我的机器人」
720px 右侧抽屉
桌面端点击左侧栏「应用」中 sort 为 55 的「我的机器人」卡片(application.vue 中 {value: "mybot", label: "我的机器人"}),前端会调用 getMybot() 拉取机器人列表并打开一个 720px 宽的右侧抽屉:
<DrawerOverlay v-model="mybotShow" placement="right" :size="720">
<template v-if="mybotShow" #title>
{{ $L('我的机器人') }}
</template>
<template v-if="mybotShow" #more>
<a href="javascript:void(0)" @click="applyClick({value: 'mybot-add'}, {id: 0})">{{ $L('添加机器人') }}</a>
</template>
抽屉右上角即「添加机器人」链接,对应 application.vue 中的 DrawerOverlay 组件实现。
抽屉里能做什么
打开抽屉后可以完成四件事:
- 查看列表:列出当前账号创建的所有自建机器人,每条显示头像、名称、
ID、清理时间(clear_day)、Webhook地址与已勾选的「Webhook 事件」(application.vue)。若列表为空,显示「您没有创建机器人」。 - 添加机器人:点击右上角「添加机器人」打开编辑表单(
id为空即为新建)。 - 开始聊天:
applyClick({value: 'mybot-chat'}, item)通过openDialogUserid直接进入与该机器人的单聊。 - 修改 / 删除:修改复用同一个编辑表单;删除会弹出输入框强制填写删除备注(必填,≤ 255 字符),确认后调用
users/bot/delete(application.vue)。
编辑表单字段
抽屉内点「添加机器人」或「修改」打开的表单包含以下字段(对应 application.vue):
| 字段 | 控件 | 约束 |
|---|---|---|
| 头像 | ImgUpload,512×512 裁剪 |
留空使用默认头像 |
| 名称 | 文本框,maxlength=20 |
必填,2-20 字符 |
消息保留(clear_day) |
数字输入,maxlength=3 |
1-999 天,默认 90 天,超期自动清理 |
| Webhook | 文本域,maxlength=255 |
必须 http(s):// 开头 |
| Webhook 事件 | CheckboxGroup 多选 | message / dialog_open / member_join / member_leave |
其中「消息保留」对应后端 bot__edit 中的 min(max(intval($data['clear_day']), 1), 999) 取值钳制,「Webhook 事件」经 UserBot::normalizeWebhookEvents 标准化为合法事件数组。
指令入口:与「机器人管理」单聊
除了图形界面,DooTask 还内置了一个系统机器人「机器人管理」(邮箱 bot-manager@bot.system),专门用于通过斜杠指令管理自建机器人。
如何进入
在桌面端消息列表搜索框输入 bot-manager@bot.system 或「机器人管理」,即可定位到与该机器人的单聊。该机器人的快捷菜单由 UserBot::quickMsgs 定义,固定提供三个按钮:
/help— 帮助指令/api— API 接口文档/list— 我的机器人
支持的全部斜杠指令
消息会进入 BotReceiveMsgTask 处理。在 bot-manager 单聊中(isManager = true),可用的指令如下:
| 指令 | 作用 | 约束 / 说明 |
|---|---|---|
/list |
查看我的机器人列表 | 最多返回 50 条,按创建倒序 |
/newbot 名称 |
新建机器人 | 名称 2-20 字符;单个账号上限 50 个 |
/setname <bot_id> <名称> |
修改机器人名称 | 在管理机器人语境下需带 bot_id |
/deletebot <bot_id> |
删除机器人 | 走 deleteUser('delete bot') 软删除流程 |
/token <bot_id> |
获取机器人 API token | 调用 User::generateToken |
/revoke <bot_id> |
重置机器人 token | 重新生成 encrypt 与 password |
/clearday <bot_id> <天数> |
设置消息保留天数 | min(intval ?: 30, 999),同步更新 clear_at |
/webhook <bot_id> <url> |
设置 webhook 地址 | 长度 ≤ 255 字符,置空则清空 |
/dialog <bot_id> <关键词> |
搜索机器人会话 | 按名称模糊匹配,返回前 20 条会话 |
/hello / /info <bot_id> |
查看机器人详情 | 管理语境下需带 bot_id |
/help |
帮助指令 | 回复中携带 manager 标记区分管理/非管理 |
/api |
API 接口文档 | 回复中携带当前版本号 |
需要特别说明的是:原入口文档中描述的「/add 新建」在 BotReceiveMsgTask 的指令分发 中实际对应 /newbot(switch ($type) 的 case '/newbot' 调用 UserBot::newBot($msg->userid, $array[1])),实际使用以 /newbot 名称 为准。
指令的权限分流
指令处理存在双重校验(BotReceiveMsgTask):
- 若消息发给
bot-manager@bot.system,$isManager = true,可管理任意自建机器人; - 若消息发给某个自建机器人,则只有该机器人的主人(
UserBot::whereBotId(...)->whereUserid(...)存在记录)能下发指令,非主人会收到「非常抱歉,我不是你的机器人,无法完成你的指令。」; - 普通用户机器人不识别
/list、/newbot这类管理指令,这两条仅对「机器人管理」机器人有效。
移动端入口:底部 Tabbar「应用」
移动端(iOS / Android App 与移动 Web)入口收敛在底部 Tabbar:点「应用」→「我的机器人」卡片,即可看到与桌面端同构的机器人列表。移动端不提供斜杠指令输入的特殊通道,管理操作全部通过该面板完成;如需使用指令,可在移动端消息列表搜索 bot-manager@bot.system 直接发指令。
权限模型:谁能创建、修改、删除
机器人权限由后端硬性判断,前端隐藏按钮并不代表绕过校验。核心规则如下:
- 创建:任何登录用户都能创建自建机器人,单个账号上限 50 个。超出时 UserBot::newBot 返回「超过最大创建数量。」;名称不在 2-20 字符区间返回「机器人名称由2-20个字符组成。」
- 修改 / 删除自建机器人:仅创建者本人(
user_bots.userid与当前用户一致)。他人操作返回「不是你的机器人」。 - 系统机器人(邮箱以
@bot.system结尾):仅管理员(userIsAdmin)可修改昵称 / 头像;任何人均不可删除,删除请求返回「系统机器人不能删除」,修改权限不足时返回「权限不足」。
这三类判断集中体现在 bot__info、bot__edit 与 bot__delete 三个接口中,判断依据是 UserBot::systemBotName($botUser->email) 是否命中系统机器人名单。
找系统机器人:为什么不在「我的机器人」里
「我的机器人」抽屉只列出自建机器人。系统内置机器人(任务提醒、审批、签到、AI 对话等)不会出现在该列表里,需要到「消息」列表搜索机器人名(如「任务提醒」「Claude」)定位单聊。原因在于两类机器人数据归属不同:自建机器人通过 user_bots 表绑定创建者,而系统机器人是全局内置用户(初始化见 generate_web_socket_dialogs_default_group 迁移)。
系统机器人的完整名单由 UserBot::systemBotName 的 match 表达式硬编码维护,包括:
- 通知 / 提醒类:
system-msg@bot.system(系统消息)、task-alert@bot.system(任务提醒)、todo-alert@bot.system(待办提醒)、meeting-alert@bot.system(会议通知)、okr-alert@bot.system(OKR 提醒)、approval-alert@bot.system(审批) - 互动 / 办公类:
check-in@bot.system(签到打卡)、anon-msg@bot.system(匿名消息)、bot-manager@bot.system(机器人管理) - AI 对话类:
ai-openai(ChatGPT)、ai-claude(Claude)、ai-deepseek(DeepSeek)、ai-gemini(Gemini)、ai-grok(Grok)、ai-ollama(Ollama)、ai-zhipu(智谱清言)、ai-qianwen(通义千问)、ai-wenxin(文心一言)、ai-dooai(Doo AI)
系统机器人的行为逻辑在后端写死(如签到机器人的打卡窗口计算见 UserBot::checkinBotCheckin),不支持自定义回复;AI 机器人还需在「系统设置 → AI 设置」中配置 API Key 后才启用,否则报「机器人未启用」(BotReceiveMsgTask)。
抽屉背后的 API 与数据模型
图形界面与指令入口最终都落到同一组 REST 接口(定义于 UsersController.php):
| 接口 | 方法 | 用途 |
|---|---|---|
api/users/bot/list |
GET | 获取我的机器人列表(bot__list,连表返回 clear_day / webhook_url / webhook_events) |
api/users/bot/info |
GET | 获取单个机器人详情(bot__info,参数 id) |
api/users/bot/edit |
POST | 添加 / 编辑机器人(bot__edit,id 为空为添加) |
api/users/bot/delete |
GET | 删除机器人(bot__delete,参数 id + 必填 remark) |
数据层由 user_bots 表承载「用户-机器人」的归属关系:userid(所属人 ID)+ bot_id(机器人 ID),该表初始结构见 2022_12_17_111737_create_user_bots_table 迁移,后续迁移在此基础上增加了 clear_day、webhook_url、webhook_num、webhook_events 等字段(add_user_bots_webhook 迁移)。机器人的消息清理、webhook 事件判断与系统机器人识别等能力则全部封装在 UserBot 模型 中。
常见误区与边界
- 快捷键:机器人管理没有全局快捷键,只能从「应用」面板进入。
- 没有机器人广场 / 公共市场:DooTask 只有「自建 + 系统内置」两种机器人来源,不存在公共机器人市场入口。
- 用户自建机器人不识别斜杠指令:
/help、/list等仅对系统机器人(尤其是bot-manager)有效;自建机器人收到/开头消息会直接忽略,不会触发 webhook(BotReceiveMsgTask)。 - 不能跨账号转让 / 转换:机器人不能过户给他人,普通用户与机器人角色不能互转。
- 删除需备注:无论界面还是指令删除,后端都要求填写删除备注(≤ 255 字符),删除同时会清理关联会话。
相关文档
- 机器人入口详解:resources/ai-kb/zh/menu-map/bot/entry.md
- 创建机器人完整步骤与字段说明:resources/ai-kb/zh/howto/bot/create.md
- 内置系统机器人清单:resources/ai-kb/zh/concept/bot/system-list.md
- 机器人 Webhook 接入与事件订阅:resources/ai-kb/zh/concept/bot/webhook.md
- 机器人权限 FAQ:resources/ai-kb/zh/faq/bot/permission.md