> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 连接器

> 连接飞书、Notion 等平台，在对话中查找、读取和整理你已授权的工作资料。

## 连接器能做什么

连接器让 superun 在对话中使用你已授权的外部资料。例如，读取需求文档、整理会议记录，或对比两份资料，再用于需求梳理、咨询和研发。

当前使用范围是**查询、读取和整理资料**，暂不提供向外部平台写入、更新或删除内容的能力。

<Info>
  连接器用于你与 superun 的对话。技能库中的飞书、钉钉等集成，则用于给你创建的应用添加登录、消息等功能；两者的用途和授权配置不同。
</Info>

## 可连接的平台

| 平台 | 连接的账号或资料范围 |
| - | - |
| 飞书 | 已授权的飞书工作资料 |
| 钉钉 | 所选组织中已授权的工作资料 |
| 企业微信 | 机器人获准访问的工作资料 |
| Notion | 授权工作空间中允许访问的页面 |
| GitHub | 授权允许访问的 GitHub 资源 |
| 金山文档 | 在 WPS 授权页面允许访问的资料 |
| 腾讯文档 | 授权允许访问的在线文档和表格 |

实际开放的平台和可读取内容，以「我的连接器」页面及平台授权范围为准。

## 首次连接

<Steps>
  <Step title="打开连接器">
    点击头像菜单中的 **「我的连接器」**。也可以在首页或项目对话的附件菜单中选择 **「使用连接器」**，进入管理面板。
  </Step>

  <Step title="选择平台并授权">
    点击目标平台的 **「连接」**，按页面提示完成扫码或网页授权。首次使用可能先显示「正在准备连接环境…」。

    飞书首次连接可能分为「创建飞书应用」和「授权飞书账号」两步，请按顺序完成，等待页面自动进入下一步。
  </Step>

  <Step title="确认连接状态">
    回到 superun，确认状态为 **「已授权」**，并且开关已开启。连接属于你的账号，可在不同项目中复用，无需每个项目重复连接。
  </Step>
</Steps>

## 在对话中使用

在探索、咨询或研发对话中，说明**使用哪个平台、读取什么资料、希望如何处理**。提供文档链接或明确的标题、时间范围，有助于找到目标内容。

例如：

* 「读取这个 Notion 需求文档，整理目标用户、核心流程和待确认问题：文档链接。」
* 「在飞书中查找本周的项目会议记录，汇总结论和待办，并列出来源。」
* 「对比这两份已授权的文档，指出需求差异，先不要修改项目代码。」

授权完成后可以回到原会话继续请求，无需为连接器另建会话。需要最新内容时，请明确要求「重新读取」，避免只基于之前的对话资料回答。

## 管理连接

| 操作 | 作用 |
| - | - |
| 开启 | 允许在对话中使用该连接器，仍需授权有效 |
| 关闭 | 暂停使用，保留授权；这个开关影响你的不同项目 |
| 重新授权 | 授权已失效或需要调整授权范围时，按提示再次授权 |
| 解绑 | 清理 superun 保存的连接凭证；再次使用需要重新连接 |

连接基于当前发起请求的用户授权，不会因为协作加入项目就自动获得其他成员的外部账号权限。

## 常见问题

| 遇到的情况 | 如何处理 |
| - | - |
| 授权窗口没有打开 | 按页面提示点击「继续授权」或「打开授权页面」，并允许授权弹窗 |
| 一直显示授权中 | 确认厂商页面的步骤已完成；可以重新打开面板查看进度。关闭面板不等于取消授权；授权超时后重新连接 |
| 已授权，但读不到某份资料 | 检查是否用了正确账号、资料是否在授权范围内，以及该账号是否有访问权限。连接成功不代表所有内容都可访问 |
| Notion 读不到指定页面 | 检查授权时是否已选择或允许访问目标页面，需要时补充页面访问范围后重试 |
| 提示授权已失效 | 对相应平台重新授权，然后在原会话中再次发起读取 |
| 返回的资料不完整 | 根据提示补充资料、调整范围或补齐权限，再要求重新读取；不要把部分结果当成完整资料 |

### 钉钉提示需管理员开通

请所选组织的管理员进入 **钉钉开发者平台 → 更多 → 基本信息 → CLI 设置**，开启「允许成员通过 CLI 访问个人数据」，并在「使用范围管理」中将你的账号加入可用范围。完成后返回 superun 重新连接，授权时选择同一组织。

### 企业微信已连接，但无法读取已有文档

请本次连接的机器人创建者进入 **企业微信 → 工作台 → 智能机器人 → 对应机器人 → 编辑 → 可使用权限 → 文档**，为「搜索与获取文档内容」完成授权；如需审批，请联系企业管理员。

权限显示已授权后，在 superun 原会话中重新请求读取即可，无需先解绑重连。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.