開發者設定

這個區塊是所有程式化功能的入口。參考文件在 API、Agents 和「將 Sofia 新增到你的應用程式」這幾個標籤頁中；本頁介紹介面上的各項操作。開啟設定，進入「Sofia API」區塊。

存取

該頁面有兩個標籤頁：「個人存取」和「應用程式用戶端」。

你的個人金鑰

• 建立金鑰。「新增金鑰」：可以為它命名，設定有效期（7 天、30 天、90 天、1 年或永不過期）以及權限。預設全部勾選；只保留你的工具需要的權限。
• 立即複製。它只顯示一次，Sofia 只保留它的指紋。
• 使用它。把它放在每次呼叫的 Authorization: Bearer 請求標頭中。一個金鑰對你所有的門市生效，權限與你相同。

連接 AI 助手

對於 Claude、ChatGPT、Cursor、Gemini CLI 或 Claude Code，使用已連接應用程式中的連接器通常更簡單：它不需要任何金鑰。參見 AI 連接器。

CLI 與AI 代理

「複製代理程式說明」會給出一段文字，貼上到你的AI 代理中，它就會使用 API。sofia 命令以 sofia-post 為名發布在 npm 上，它封裝了 API，可從終端、腳本或排程任務中發布；安裝方法見「Agents」標籤頁。

應用程式客戶端

應用程式客戶端用來構建讓其他 Sofia 用戶授權的東西，而不是以你的身份操作的東西。

• 建立客戶端。「新增用戶端」：填寫名稱、不小於 180 × 180 像素的標誌、隱私政策的地址、一到五個 HTTPS 重新導向 URL，以及應用程式可以請求的權限。名稱和標誌會在授權過程中展示給用戶。
• 複製憑證。你會得到 Client ID 和 Client Secret。公開客戶端適用於程式碼公開的應用程式，沒有金鑰，使用 PKCE 進行身分驗證；這個選擇無法更改。
• 實現授權流程。參見「將 Sofia 加到你的應用程式」標籤頁。

用金鑰還是 OAuth 客戶端？

如果你自動化的是自己的發布，請使用金鑰。只有涉及他人帳戶時，才需要構建客戶端。

延伸閱讀

• API：存取端點、請求負載和各平台的設定，見 API 標籤頁。
• CLI：在終端中發布，見 Agents 標籤頁。
• AI 連接器：接入 Claude、Cursor 或 ChatGPT，參見 AI 連接器。