DooTask 机器人入口完全指南:应用面板、我的机器人抽屉与系统机器人会话定位

原创2026-10-16 10:25:241,946 阅读
文章标签:后端前端桌面应用协同办公

DooTask 机器人入口完全指南:应用面板、我的机器人抽屉与系统机器人会话定位

DooTask 的机器人功能统一收纳在「应用」面板的「我的机器人」卡片中,本文以 机器人入口 menu-map 文档 为核心,完整讲解桌面端 Web / Electron、移动端三条入口路径,以及「添加机器人」「与系统机器人聊天」「权限边界」等操作细节,并结合 UserBot 模型、UsersController 机器人接口 等源码说明背后的权限校验与数据模型。读完本文,你将能准确找到机器人管理入口、快速定位任意系统机器人单聊,并理解「哪些机器人能改、哪些不能删、为什么报错」背后的判断逻辑。

一、机器人入口总览:三条路径 + 一个指令入口

DooTask 的机器人没有独立的顶部主导航标签,所有入口都围绕「应用」面板与「消息」列表展开。根据 entry.md,入口路径共四条:

场景 路径 说明
桌面端 Web 左侧栏「应用」→「我的机器人」卡片 打开右侧 720px 宽抽屉,列出自建机器人,可「开始聊天 / 修改 / 删除」
桌面端 Electron 同 Web 桌面客户端与 Web 端入口一致
移动端 底部 Tabbar「应用」→「我的机器人」卡片 同一功能,移动布局
指令入口 与「机器人管理」(bot-manager@bot.system)单聊中发 /list 直接看到当前账号拥有的机器人列表

一个常见误区是去顶部主导航找「机器人」标签——它并不存在(见 entry.md 的 negative 声明)。机器人相关能力分属两个系统应用:mybot(我的机器人,自建机器人管理)与 bot-manager(机器人管理,斜杠指令控制台),后者的卡片/会话入口同样在「应用」与「消息」体系内。

从 系统应用清单 可以看到 mybot 被归类为"系统应用",即所有登录用户可见的固定功能,不需要管理员安装。

二、「我的机器人」抽屉:能做什么

点开「应用」→「我的机器人」后,右侧会滑出 720px 宽的抽屉面板。抽屉承担三类操作(见 app-system.bot.howto):

  1. 查看列表:列出当前用户创建的所有机器人;若没有则提示「您没有创建机器人」。
  2. 逐条操作:每条机器人提供「开始聊天」「修改」「删除」三个按钮:
    • 「开始聊天」直接进入与该机器人的私聊会话;
    • 「修改」打开编辑表单(与新建共用同一套表单);
    • 「删除」要求输入删除备注(≤ 255 字符)。
  3. 新建:抽屉右上角「添加机器人」按钮弹出创建表单。

抽屉背后:bot__list 接口

抽屉列表的数据来自后端接口 api/users/bot/list(bot__list),其实现位于 UsersController.php。关键逻辑是:用 users 与 user_bots 表按 user_bots.userid = 当前用户 连表查询,只返回本人创建的机器人(bot=1 且 user_bots.bot_id = users.userid),并按创建时间倒序。返回字段包括 userid、nickname、userimg、clear_day、webhook_url、webhook_events,同时通过 UserBot::normalizeWebhookEvents 对事件配置做标准化。

值得注意的是,系统机器人的 bot__list 结果也由 systemBotName 附带标注 system_name,但抽屉列表本身只展示自建机器人——这正是原文档强调的"系统机器人不会出现在「我的机器人」列表里"的源码佐证。

三、添加与编辑机器人:表单字段与后端校验

「我的机器人」抽屉右上角的「添加机器人」与已有机器人条目的「修改」共用同一份编辑表单,提交到后端接口 api/users/bot/edit(bot__edit,见 UsersController.php)。字段说明如下:

字段 必填 说明 后端校验(源码依据)
name 是 机器人昵称,2-20 字符 UserBot::newBot 校验长度,超限报「机器人名称由2-20个字符组成」(UserBot.php)
avatar 否 头像 URL;留空用默认 bot__edit 中 Base::unFillUrl 归一化,avatar/ 内置头像会被置空
session 否 0/1,是否开启「新会话/历史会话」菜单 仅在添加时生效,创建后不可改(需重建);开启后 webhook 的 message 事件会多带 session_id
clear_day 否 消息保留天数,1-999,默认 90 bot__edit 中 min(max(intval, 1), 999) 强制钳制范围
webhook_url 否 http(s):// 开头,≤ 255 字符 shouldDispatchWebhook 用 preg_match('/^https?:\/\//') 校验协议头(UserBot.php)
webhook_events 否 事件列表 normalizeWebhookEvents 只保留白名单事件,空列表默认回退为 <a href="https://link.gitcode.com/i/8ff05c48c22ccb183d8ffc5df6612167" target="_blank">message]([UserBot.php)

数量上限与名称校验的源码依据

创建机器人走 UserBot::newBot(UserBot.php):

  • 每用户最多 50 个:先连表统计 users.bot = 1 AND user_bots.userid = 当前用户 的条数,达到 50 直接返回「超过最大创建数量」;
  • 名称必须 2-20 字符;
  • 创建成功后自动建立与主人的私聊会话(WebSocketDialog::checkUserDialog),若开启 session 还会创建 WebSocketDialogSession 并回填 session_id;
  • 机器人的邮箱形如 user-normal-xxx@bot.system 或 user-session-xxx@bot.system(随机后缀),可据此判断自建机器人类型。

创建后可以做什么

  • 在「我的机器人」列表点「开始聊天」进入单聊;
  • 将机器人邀请进群(详见 bot/invite.md);
  • 在「机器人管理」单聊发 /token <bot_id> 取 token,/revoke 重置凭证;
  • 删除机器人时需填备注(≤ 255 字符),系统机器人删除会直接报错(见下文权限部分)。

四、与系统机器人聊天:在「消息」列表搜索定位

内置系统机器人(任务提醒、审批、AI 等)不需要手动添加,默认会自动出现在「消息」列表——因为它们本质是 bot=1 的特殊 User 账号,每个机器人与每个用户之间独立建立单聊会话(bot_type=system-msg / task-alert / todo-alert 等,见 messenger/bot.md)。

定位方式:

  • 桌面端:左侧栏「消息」→ 在搜索框输入机器人名(如「任务提醒」「Claude」)即可定位单聊;
  • 移动端:底部「消息」Tab 同样可搜索。

系统机器人清单与依赖

系统机器人名单写死在 UserBot::systemBotName(UserBot.php),邮箱统一以 @bot.system 结尾,普通用户不能创建或删除。常见几类(完整清单见 bot/system-list.md):

  • 通知类:system-msg(系统消息)、task-alert(任务提醒)、todo-alert(待办提醒)、meeting-alert(会议通知,需会议插件)、approval-alert(审批,需审批插件)、okr-alert(OKR 提醒,需 OKR 插件);
  • 互动办公类:check-in(签到打卡,支持手动/定位/MAC/人脸)、anon-msg(匿名消息)、bot-manager(机器人管理,识别 /list /newbot 等斜杠指令);
  • 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 设置」填 API Key 后启用,否则报「机器人未启用」。

从源码看,这些机器人的头像映射也内置在 User.php 的机器人头像逻辑(default_ai.png、default_bot.png 等),进一步印证"系统机器人由系统创建并维护"。

指令入口:bot-manager 与 /list

除了 UI 面板,还可以在与「机器人管理」(bot-manager@bot.system)的单聊中直接发 /list 查看自己的机器人列表。该指令的处理实现在 BotReceiveMsgTask.php:按 user_bots.userid = 当前用户 连表查询最多 50 条机器人记录;若列表为空回复「您没有创建机器人」。该任务还支持 /hello、/info、/newbot、/setname、/deletebot 等指令(BotReceiveMsgTask.php),并且只有 bot-manager@bot.system 才允许 /list 与 /newbot(BotReceiveMsgTask.php)。

五、权限要求:所有权 + 类型的双层校验

机器人的所有写操作都由后端按「所有权 + 类型」硬性校验,前端隐藏按钮不等于绕过校验(见 faq/bot/permission.md):

  1. 创建:任何登录用户都能创建自建机器人,但单个账号最多 50 个,超出报「超过最大创建数量」;
  2. 修改系统机器人:仅 userIsAdmin(系统管理员)可改昵称/头像,普通成员报「权限不足」;
  3. 删除系统机器人:任何人都不能删,后端直接返回「系统机器人不能删除」;
  4. 操作他人自建机器人:非主人报「不是你的机器人」。

这三条规则在 bot__info、bot__edit、bot__delete 中完全一致地实现(UsersController.php):

  • 先查 users.bot = 1 的机器人账号;
  • 再查 user_bots 表确认当前用户是否是该机器人的主人;
  • 若查不到归属记录,则通过 UserBot::systemBotName($botUser->email) 判断是否系统机器人:是系统机器人则要求管理员权限(修改时),删除时直接拒绝;否则一律报「不是你的机器人」。

此外,删除接口还强制要求填写备注(为空报「请输入删除备注」,超过 255 字符报「删除备注长度限制255个字」),且机器人删除会通过 deleteUser 同时清理关联会话。

六、边界与不支持项

原文档明确列出以下不支持的能力,使用时需注意:

  • 没有「机器人广场 / 公共机器人市场」:机器人只能自建或用内置,不存在第三方共享市场入口;
  • 没有独立的机器人快捷键:只能从「应用」面板进入,没有全局快捷键直达(参见 menu-navigation/bot-mgmt.md 的"快捷键:无");
  • 系统机器人不出现在「我的机器人」列表:只能在「消息」列表搜索定位;
  • 延伸边界(来自 bot/overview.md):机器人之间不会互相触发(避免死循环);系统机器人不能由普通用户删除;单个用户自建机器人上限 50 个。

七、本文涉及文档与源码速查

总结:找到 DooTask 机器人的关键就一句话——自建机器人在「应用」面板管理,系统机器人在「消息」列表搜索;理解了 user_bots 归属表与 @bot.system 邮箱约定,就能准确预判每一个「能不能改 / 能不能删 / 报什么错」的边界行为。

登录后查看全文
dootask