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

# 钉钉插件

> 在 superun 中接入钉钉登录、企业成员校验和知识库文档写入能力。

# 钉钉插件

钉钉插件用于把钉钉账号、组织协作和知识库文档能力接入到 superun 产品中。它适合需要统一企业登录、成员校验和团队文档协作的业务。

***

## 可以接入哪些能力

| 能力                                                | 适合场景          | 说明                |
| ------------------------------------------------- | ------------- | ----------------- |
| 钉钉登录                                              | 企业内部系统、员工门户   | 用户使用钉钉账号进入产品      |
| 企业成员校验                                            | 企业白名单、内部访问控制  | 控制哪些钉钉组织成员可以使用产品  |
| [钉钉文档写入](/superun/integrations/dingtalk-document) | 周报、会议纪要、知识库归档 | 在钉钉知识库中创建、写入或更新文档 |

***

## 接入前需要准备

* [钉钉开放平台](https://open.dingtalk.com/)的管理员权限。
* 一个钉钉企业内部应用，并取得 **Client ID** 和 **Client Secret**。
* 已发布的 superun 项目域名，用于配置登录回调地址。
* 根据要接入的能力，在钉钉开放平台开通对应权限并发布应用。

***

## 建议开通的能力范围

在 [钉钉开放平台](https://open.dingtalk.com/) 创建企业内部应用后，建议按实际接入目标分层开通，不需要一次性打开所有权限。

| 接入目标   | 建议开通范围              | 需要关注的权限 / 配置                                                                       | 说明                                                                        |
| ------ | ------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| 钉钉登录   | 企业内部应用、登录与分享、登录回调域名 | `Contact.User.Read`；按需 `Contact.User.mobile`                                       | 用于读取登录用户基础信息。需要手机号时再额外申请手机号权限                                             |
| 企业成员校验 | 登录能力 + 企业成员信息读取     | `Contact.User.Read`；企业信息读权限按需开通                                                    | 用于判断用户是否属于目标钉钉组织、部门或可访问范围                                                 |
| 钉钉文档写入 | 知识库和文档相关能力          | `Wiki.Workspace.Read`、`Document.WorkspaceDocument.Write`，按需 `Wiki.Workspace.Write` | 用于选择知识库、创建知识库文档和写入内容，详见 [钉钉文档写入](/superun/integrations/dingtalk-document) |

### 应用可见范围建议

* 调试阶段：建议先把应用可见范围设置为开发团队或测试部门，避免影响全员。
* 上线阶段：设置为实际会使用该产品的部门、成员或全部员工。
* 如果接入文档写入：应用可见范围需要覆盖执行授权的钉钉用户，目标知识库也要给该用户相应的查看或编辑权限。

<Note>
  钉钉权限申请后通常还需要管理员审批，并在开放平台发布应用后才会生效。仅保存权限配置但未发布，可能导致 superun 侧仍然提示权限不足。
</Note>

***

## 如何在 superun 中启用

<Steps>
  <Step title="创建钉钉企业内部应用">
    打开 [钉钉开放平台](https://open.dingtalk.com/)，进入「企业内部开发」，创建应用并完成基础信息配置。
  </Step>

  <Step title="启用钉钉插件">
    在「研发」→「技能库」启用钉钉插件，填写 Client ID、Client Secret 等应用凭证。
  </Step>

  <Step title="选择要接入的能力">
    如果只是登录，先完成登录回调和成员校验；如果要写入知识库文档，继续启用钉钉文档写入。
  </Step>

  <Step title="发布并测试">
    在钉钉开放平台发布应用后，回到产品中测试登录、企业校验或文档写入流程。
  </Step>
</Steps>

***

## 子能力说明

<CardGroup cols={2}>
  <Card title="钉钉文档写入" icon="file-lines" href="/superun/integrations/dingtalk-document">
    接入知识库文档创建、内容写入、文档更新和协作归档。
  </Card>
</CardGroup>