术语表¶

OpenBot 使用的产品术语，以及每个术语所拥有的标识符。在命名新类型、表、IPC 通道或产品字符串时，或当代码中的术语与 UI 中的术语不一致时，请阅读本文。 AGENTS.md 包含两条命名规则，它们是决策而非查表项。

• agent：产品对象（AgentStore、AgentSummary、agent-${uuid}、~/OpenBot/Agents/<id>、projection_agents）、编码 agent 或市场 agent（ipc-marketplace-agents.ts）。teammate 是提示词和营销文本，绝不是一种类型。人类成员使用 TeamMemberSummary。
• agent template：某个 agent 的指令、技能和 routine 的公开、仅通过链接访问的副本（ipc-agent-templates.ts、agent-templates:*、D1 agent_templates、openbot.run/agents/<id>）。它不包含工作区文件，也不包含记忆。它不是市场 agent：没有审核，也没有列表。
• browser profile：在运行 agent 的计算机上，一个已命名的、持久的浏览器会话（browser_profiles、BrowserProfileSummary、AgentBrowserProfile、agent:admin:*-browser-profile*、persist:openbot-browser-profile-<id>）。内置选项“Shared”和“Only this agent”（仅对已经在使用它的 agent 显示）在 UI 中也是 profile，但它们没有对应的行。它不是 agent profile（AgentProfile，即 agent 的显示数据），也不是账户 profile（v1/me/profile）。
• bot：不要用于新的产品代码。保留已发布名称：Team API v1-v3 的 bot/botId/bots-changed（current-agent-keys.ts 负责转换）、bots.json、mailbox.json、legacy-import:bots:v1，以及可读的 ~/OpenBot/Bots 路径前缀。接受来自未运行迁移 v13 的数据库中的 bot-<uuid> ID。"first-bot" 是头像种子；BloubBot 和 lucide Bot 图标是库名称。
• channel：共享的多 agent 聊天（ChannelStore、ChannelSummary、projection_channels、channel-chats-v1）。group 不是产品术语：它指侧边栏部分（SidebarPinnedGroup、create_section）、IPC 端点组（IpcEndpointGroup、define-ipc-group.ts）或 ARIA role="group"。IPC channel 是 IPC_ENDPOINTS（ipc-endpoints.ts）中某个端点的线上名称；产品契约见 ipc-chat-channels.ts。
• connector：OpenBot 将外部服务的登录转换为 agent 工具的内置登录方式，每台 OpenBot 计算机一个（GitHubConnectorService、github-connector:*、GITHUB_CONNECTOR_MCP_SERVER_ID）。用户添加的 MCP 服务器或市场插件不属于 connector。
• messaging connection：外部聊天平台的一个工作区（Slack 工作区、Discord 服务器或 Telegram 聊天），此计算机上的 agent 在其间应答（projection_messaging_connections、MessagingConnection、messaging:*）。它的 Slack Orchestrator 是接收每个新对话并询问其队友的 agent。messaging thread 是一个外部对话（Slack 线程），由一个 agent 在它自己的执行线程中应答（projection_messaging_threads、MessagingLink）。Slack 频道是 platformChannelId，绝不是 channel。
• server：已加入的团队服务器（ServerSummary、servers:*）、本地 Team API 主机（HostStatus、host:*、src/main/team-api-server.ts）、账户 API（apps/auth-api、auth:*）或 MCP 服务器（createSdkMcpServer）。
• thread：持久化的 projection_threads 记录。conversation：它的读取投影，没有单独的表。provider session：私有 CLI 恢复状态（projection_provider_sessions）。team session：经过身份验证的远程连接。turn：thread 中的一次交换。
• side thread：某个 agent 在自己的聊天旁边的第二个对话，即 main thread（projection_agent_threads、AgentThreadRecord）。UI 将两者都称为 thread。代码和 agent-tasks-v1 线上协议仍将 side thread 称为 task（AgentTask、taskId），其任务 ID 为 legacy_task_id ?? thread_id。archive 会将 side thread 从标签页中隐藏，并把它列在“Archived”下；它就是任务关闭（closed、archived_at）。tab 是 thread 的设备本地视图；关闭它不会改变 thread。
• role：服务器的自定义角色，用于设置其成员可以使用哪些 agent，以及可以使用到什么级别（AgentAccessRole、agent-access-v1、openbot-agent-access-v1.json）。Everyone 角色适用于每个成员。它不是团队角色（TeamRole：owner、admin、member），UI 将其称为服务器角色。agent 设置中的 agent access 是 agent 自身的运行时访问权限；agent-access-v1 的级别是成员对 agent 的访问权限。
• routine：为 agent 或 channel 保存的指令，带有一个计划或 webhook 触发器（EventRoutineTrigger）。Agent routine 使用 projection_agent_routines。这不是 Claude Code 的 /schedule。
• webhook routine：带有 webhook 触发器的 routine（RoutineWebhookTrigger）。对其 URL 的签名请求会开始一次运行。该触发器可以要求一个事件类型和数据过滤器（projection_routine_webhooks、projection_channel_routine_webhooks）。没有共享的事件源。
• webhook route：一个 webhook routine 的不透明路由 ID，以及包含它的公共 Signal URL（WebhookRouteStore、D1 webhook_routes）。receipt 记录一个已接收的投递 ID 以用于去重。
• workflow：Workflows 页面上的步骤图，可以命名多个 agent、模型、条件、审批和输出（WorkflowStore、Workflows、workflows、workflows-v1）。它不是 routine flow，后者将一个 agent 的 routine 的答案交给其他 agent（routine-flows-v1）。workflow run 是对图副本的一次遍历（workflow_runs）；workflow step 是对某个节点的一次尝试，在运行中或单独进行（workflow_steps）。workflow version 是用户可恢复的图的已保存副本（workflow_versions）。workflow webhook trigger 是带有 workflow owner 类型的 webhook route 的触发器节点（workflow_trigger_webhooks）。
• shared table：agent 在每个 agent 共有的一个文件中创建的表（~/OpenBot/Shared/Data/agent-data.db、SharedTable、AgentTables）。openbot.db 是应用程序的数据库，不包含这些表。owner：openbot_metadata 为表记录其 ID 的 agent，也是唯一可以删除或修改该表的 agent；其他所有 agent 仍然可以读写其行，用户可以在 agent 设置中删除任何表。