Skip to content

Commands

Kana edited this page May 17, 2026 · 1 revision

管理命令手册

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

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

查看与定位

/info

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

/profile

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

/status

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

/whoami

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

/id

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

/history [数量]

查看最近消息摘要。

/history
/history 20

默认 10 条,最多 30 条。

备注与标签

/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

/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

/draft

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

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

/export

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

已保留但未实装

/ai_on / /ai_off

当前版本尚未实现按会话开关 AI。全局开关请使用 .env

AI_DRAFTS_ENABLED=false