Skip to content

Commands

monkeycode-ai edited this page Jun 30, 2026 · 2 revisions

管理命令手册

InboxBridge 会向 Telegram 注册原生命令菜单。白名单管理员在管理群 Topic 中点击输入框旁边的菜单按钮,即可看到可用命令和解释。

普通消息会默认转发给外部用户;以 / 开头的命令只作为管理操作处理,不会直接发给用户。

查看与定位

/info

汇总联系人、会话、Topic、负责人和标签信息。适合刚打开 Topic 时快速了解上下文。

/profile

查看联系人资料,包括平台、外部 ID、用户名、联系人状态和 Topic 信息。

/status

查看当前会话状态、优先级、负责人、静音时间和销毁策略。

/whoami

查看自己的 Telegram user_id。配置管理员白名单时很有用。

/id

查看当前 chat、Topic 和用户 ID,主要用于排障。

/history [数量]

查看最近消息摘要。

/history
/history 20

默认 10 条,最多 30 条。

/search <关键词>

在当前会话历史消息中搜索,最多返回 20 条。

/search 发票
/search deployment

备注与标签

/note <内容>

保存内部备注,不会发送给外部用户。

/note 用户询问部署问题,等待确认 Serv00 环境

/notes [数量]

查看最近内部备注。

/notes
/notes 10

默认 5 条,最多 20 条。

/tag <标签>

给当前会话添加标签。

/tag serv00
/tag high-value

/untag <标签>

移除标签。

/untag serv00

/tags

列出当前会话标签。

会话处理

/priority low|normal|high|urgent

设置优先级。

/priority high

/assign <telegram_user_id>

分配负责人。

/assign 123456789

/mine

查看分配给自己的最近会话列表。列表最多返回 20 条,适合管理员快速找回自己负责的 Topic。

/close

关闭会话。用户之后再次发消息时,会话会自动重开。

/open / /reopen

重新打开会话。

/mute <时长>

静音当前会话提醒,不阻止用户继续发消息。

/mute 30m
/mute 2h
/mute 1d

支持单位:

  • m:分钟
  • h:小时
  • d:天

销毁策略

/expire <天数|never>

设置当前会话的独立销毁策略。

/expire 7
/expire 30
/expire never

never 表示该会话不自动销毁。

/expires

查看当前会话销毁策略和到期时间。

安全与辅助

/ban [原因]

封禁当前联系人。封禁后,外部用户后续消息会被拒收,不再进入管理 Topic。

/ban spam

/unban

解除当前联系人封禁。

/delete confirm

删除当前 Topic,并清理数据库中的该会话数据。

这是高风险命令,因此必须带 confirm

/delete confirm

/reset confirm

清空当前会话消息和 AI 草稿,保留联系人映射和 Topic。适合测试或清理上下文时使用。

/reset confirm

/audit [数量]

查看当前会话最近审计记录,默认 20 条,最多 50 条。

/audit
/audit 50

/draft

重新生成 AI 回复草稿。草稿只发送到管理 Topic,不会自动回复外部用户。

如果 AI 配置缺失或服务失败,主消息转发不受影响。

/draft view

查看当前 ready 状态的草稿。

/draft send

将当前 ready 草稿发送给外部用户。发送会创建投递记录,因此可以在运维仪表盘查看结果。发送失败时草稿会保留,可再次执行 /draft send

/draft discard

丢弃当前 ready 草稿。

/ai_on / /ai_off

开启或关闭当前会话的 AI 草稿。全局 AI 配置仍由 Web 控制台或环境变量控制。

/export

导出当前会话最近 200 条消息 JSON,并作为文件发送到当前 Topic。

优先级提醒

当会话优先级为 urgent 且已经分配负责人时,新入站消息会在 Topic 内提醒负责人。提醒失败不会影响主消息入库和转发。