> ## 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 產品中。它適合需要統一企業登入、成員校驗和團隊文件協作的業務。

***

## 可以接入哪些能力

| 能力                                                        | 適合場景          | 說明                |
| --------------------------------------------------------- | ------------- | ----------------- |
| 釘釘登入                                                      | 企業內部系統、員工門戶   | 用戶使用釘釘帳號進入產品      |
| 企業成員校驗                                                    | 企業白名單、內部訪問控制  | 控制哪些釘釘組織成員可以使用產品  |
| [釘釘文件寫入](/zh-Hant/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` | 用於選擇知識庫、建立知識庫文件和寫入內容，詳見 [釘釘文件寫入](/zh-Hant/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="/zh-Hant/superun/integrations/dingtalk-document">
    接入知識庫文件建立、內容寫入、文件更新和協作歸檔。
  </Card>
</CardGroup>