DooTask 机器人管理入口全解析:从「我的机器人」抽屉到 bot-manager 指令管理

原创2026-10-16 09:56:031,349 阅读
文章标签:后端前端桌面应用协同办公

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 组件实现。

抽屉里能做什么

打开抽屉后可以完成四件事:

  1. 查看列表:列出当前账号创建的所有自建机器人,每条显示头像、名称、ID、清理时间(clear_day)、Webhook 地址与已勾选的「Webhook 事件」(application.vue)。若列表为空,显示「您没有创建机器人」。
  2. 添加机器人:点击右上角「添加机器人」打开编辑表单(id 为空即为新建)。
  3. 开始聊天:applyClick({value: 'mybot-chat'}, item) 通过 openDialogUserid 直接进入与该机器人的单聊。
  4. 修改 / 删除:修改复用同一个编辑表单;删除会弹出输入框强制填写删除备注(必填,≤ 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 字符),删除同时会清理关联会话。

相关文档

登录后查看全文
dootask