- 重写 index.mdx 为真正的快速开始指南,链接服务商配置 - 新增 chat.mdx(对话模式、权限、上下文管理) - 新增 skills.mdx(技能分类、市场、本地管理) - 新增 design-agent.mdx(单张/批量图片生成、参考图、连续编辑) - 新增 gallery.mdx(素材库浏览、筛选、详情操作) - 重写 providers.mdx — CLI 环境认证 vs 手动添加、cc switch 不生效说明、 国内服务商预设、Anthropic 第三方模型映射、服务商优先级链 - 重写 mcp.mdx — 三种传输类型(stdio/SSE/HTTP)、列表+JSON 双视图 - 重写 assistant-workspace.mdx — 对齐实际设置>助理标签页 - 重写 faq.mdx — 更全面的问答覆盖 - 桥接拆分为 5 页:总览(斜杠命令、全局设置) + Telegram + Discord + 飞书 + QQ - Discord 开发者模式获取 ID 说明移入配置流程 - 飞书长连接模式启动顺序说明 - 所有 UI 按钮/菜单名称改为中文翻译(设置、服务商、技能、桥接等) - 扁平化无子页面的 folder/index.mdx → page.mdx,消除侧边栏多余展开三角 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
87 lines
3.0 KiB
Plaintext
87 lines
3.0 KiB
Plaintext
---
|
||
title: 消息桥接
|
||
description: 将 Claude 对话桥接到 Telegram、Discord、飞书和 QQ。
|
||
---
|
||
|
||
# 消息桥接
|
||
|
||
消息桥接让你从手机上的即时通讯应用与 Claude 对话。在桌面上启动 CodePilot,配置好 Bot 后,你可以通过 Telegram、Discord、飞书或 QQ 随时随地与 Claude 交互。
|
||
|
||
## 支持的平台
|
||
|
||
| 平台 | 特点 |
|
||
|------|------|
|
||
| **Telegram** | 长轮询模式,支持流式预览、权限按钮、丰富的 Markdown 渲染 |
|
||
| **Discord** | WebSocket 模式,支持流式预览、频道/私聊双模式 |
|
||
| **飞书 / Lark** | WebSocket 模式,支持国内/国际版切换、群组策略控制 |
|
||
| **QQ** | REST API 模式,支持图片发送、私聊桥接 |
|
||
|
||
## 工作原理
|
||
|
||
```
|
||
手机 IM → Bot 收到消息 → CodePilot 转发给 Claude → Claude 回复 → Bot 发回 IM
|
||
```
|
||
|
||
1. 你在消息平台上向 Bot 发送消息
|
||
2. CodePilot 的 Bridge 服务接收消息并转发给 Claude
|
||
3. Claude 处理请求后生成回复
|
||
4. 回复通过 Bot 发回你的消息平台
|
||
5. 如果 Claude 需要权限确认(如写文件),会在 IM 中发送确认按钮
|
||
|
||
## 基本设置
|
||
|
||
### 开启桥接
|
||
|
||
1. 点击侧边栏的 **桥接**
|
||
2. 在桥接总览页面打开 **桥接主开关**
|
||
3. 分别启用你需要的渠道(Telegram / Discord / 飞书 / QQ)
|
||
4. 进入各渠道页面配置 Bot 凭据
|
||
5. 点击 **启动** 按钮
|
||
|
||
### 桥接全局设置
|
||
|
||
在桥接总览页面可以配置:
|
||
|
||
- **默认工作目录** — 新对话的默认项目路径
|
||
- **默认模型** — 桥接对话使用的模型
|
||
- **默认服务商** — 桥接对话使用的 API 服务商
|
||
- **自动启动** — CodePilot 启动时自动开启桥接服务
|
||
|
||
### 桥接状态
|
||
|
||
桥接页面实时显示:
|
||
|
||
- 主服务状态(已连接 / 已断开)
|
||
- 各渠道适配器状态
|
||
- 活跃的会话绑定数量
|
||
- 最后一条消息时间
|
||
|
||
## 斜杠命令
|
||
|
||
在 IM 中可以使用斜杠命令控制 CodePilot:
|
||
|
||
| 命令 | 参数 | 说明 |
|
||
|------|------|------|
|
||
| `/new` | `[路径]` | 新建对话,可指定工作目录 |
|
||
| `/bind` | `<会话ID>` | 绑定当前 IM 聊天到已有的 CodePilot 对话 |
|
||
| `/cwd` | `/path/to/dir` | 切换当前对话的工作目录 |
|
||
| `/mode` | `plan\|code\|ask` | 切换对话模式 |
|
||
| `/status` | — | 查看当前对话状态(ID、工作目录、模式、模型) |
|
||
| `/sessions` | — | 列出当前渠道最近的对话(最多 10 个) |
|
||
| `/stop` | — | 中止当前正在运行的任务 |
|
||
| `/help` | — | 查看可用命令 |
|
||
|
||
## 使用建议
|
||
|
||
- **保持 CodePilot 运行** — 桥接依赖桌面端作为中转,关闭后 Bot 无法响应
|
||
- **系统托盘模式** — 最小化到系统托盘,桥接保持活跃不占桌面空间
|
||
- **私聊优先** — 建议在私聊中使用,群聊中可能被其他消息干扰
|
||
- **权限确认** — Claude 需要执行敏感操作时会在 IM 中发送确认按钮,注意及时处理
|
||
|
||
## 各渠道配置
|
||
|
||
- [Telegram 配置](/zh/docs/bridge/telegram)
|
||
- [Discord 配置](/zh/docs/bridge/discord)
|
||
- [飞书配置](/zh/docs/bridge/feishu)
|
||
- [QQ 配置](/zh/docs/bridge/qq)
|