7418andClaude Opus 4.6
c67f3ef82b
- 重写 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>
77 lines
2.3 KiB
Plaintext
77 lines
2.3 KiB
Plaintext
---
|
|
title: QQ
|
|
description: 配置 QQ Bot 桥接。
|
|
---
|
|
|
|
# QQ 桥接
|
|
|
|
通过 QQ Bot 与 Claude 对话。支持图片发送和私聊桥接。
|
|
|
|
## 创建 QQ Bot
|
|
|
|
1. 前往 [QQ 开放平台](https://q.qq.com)，注册开发者账号
|
|
2. 创建一个新的 Bot 应用
|
|
3. 完成实名认证（个人或企业）
|
|
4. 在应用管理页面获取：
|
|
- **AppID**（数字格式）
|
|
- **App Secret**
|
|
5. 在 **功能配置** 中开启需要的消息权限
|
|
6. 提交审核，等待通过
|
|
|
|
> QQ Bot 平台审核较严格，建议仔细阅读平台文档中的接入规范。
|
|
|
|
## 在 CodePilot 中配置
|
|
|
|
1. 点击侧边栏 **桥接**，切换到 **QQ** 页面
|
|
2. 填写 **App ID** 和 **App Secret**
|
|
3. 点击 **测试连接** 验证凭据
|
|
4. （可选）配置 **允许的用户** — 填写 QQ user_openid，多个用逗号分隔
|
|
5. （可选）配置图片设置：
|
|
- **启用图片发送** — 允许 Bot 发送图片（默认开启）
|
|
- **最大图片大小** — 单张图片大小限制（默认 20MB）
|
|
6. 点击 **保存**
|
|
|
|
## 启用桥接
|
|
|
|
1. 回到桥接总览页面
|
|
2. 确保 **QQ** 渠道开关已打开
|
|
3. 确保桥接主开关已开启
|
|
4. 点击 **启动**
|
|
5. 在 QQ 中添加 Bot 为好友，发送消息即可与 Claude 对话
|
|
|
|
## 消息格式
|
|
|
|
QQ 桥接以纯文本格式发送消息：
|
|
|
|
- 不支持 Markdown 渲染
|
|
- 超长消息自动分片（每片最大 2000 字符）
|
|
- 每条回复最多发送 3 个分片（平台限制）
|
|
- 支持发送图片（需开启图片设置）
|
|
|
|
## 权限处理
|
|
|
|
QQ Bot 平台不支持内联按钮，权限确认通过文本命令处理：
|
|
|
|
- Bot 发送权限确认消息，包含操作说明和权限 ID
|
|
- 你回复 `/perm allow <ID>` 允许操作
|
|
- 你回复 `/perm deny <ID>` 拒绝操作
|
|
- 你回复 `/perm allow_session <ID>` 允许本次会话内同类操作
|
|
|
|
## 故障排除
|
|
|
|
### 测试连接失败
|
|
|
|
1. 确认 App ID 和 App Secret 正确
|
|
2. 确认 Bot 应用已通过审核
|
|
3. 确认开发者实名认证已完成
|
|
|
|
### Bot 不响应
|
|
|
|
1. 确认已添加 Bot 为 QQ 好友
|
|
2. 确认 CodePilot 桥接已启动
|
|
3. 如果设置了允许用户列表，确认你的 user_openid 在列表中
|
|
|
|
### 消息被截断
|
|
|
|
QQ 平台限制每条回复最多 3 个分片。对于特别长的回复，可能会丢失末尾部分。建议在提示中要求 Claude 简洁回复。
|