> For the complete documentation index, see [llms.txt](https://developer.eagle.cool/plugin-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.eagle.cool/plugin-api/zh-tw/plugin-review/criteria/configuration-and-reviewability.md).

# 發佈設定與可審核性

投稿後，我們會先確認安裝包可以被安全開啟，並具備繼續審核所需的基本設定與資料。無法解壓縮、缺少必要設定或仍處於開發狀態的版本，會阻擋目前投稿。

## 安裝包必須有效

請使用 Eagle 的打包功能建立 `.eagleplugin` 檔案，並確認：

* 檔案可以正常開啟與完整解壓縮，不是損壞或不完整的壓縮包；
* 安裝包內沒有重複路徑、異常連結或可能把檔案寫到插件目錄以外的路徑；
* 最終檔案是準備發佈的版本，而不是改名後的其他壓縮格式；
* 重新下載或移動檔案後仍能正常安裝。

損壞、格式無效或無法安全解壓縮的安裝包不能進入後續審核。遇到這類問題時，請從乾淨的發佈目錄重新打包，不要嘗試手動修改已經產生的 `.eagleplugin` 檔案。

## `manifest.json` 必須位於插件根目錄

發佈版本至少應符合以下要求：

* 插件根目錄包含 `manifest.json`；
* 檔案內容是有效的 JSON 物件；
* `id` 與 `name` 都是非空字串；
* `devTools` 不得設為 `true`。

`manifest.json` 的其他欄位仍須符合插件類型與實際功能。完整設定方式請參閱[manifest.json 完整設定](/plugin-api/zh-tw/tutorial/manifest.md)。

## 提交最終發佈版本

發佈版本不應開啟開發工具，也不應依賴只存在於開發電腦上的路徑、服務或環境變數。提交前建議安裝打包後的檔案，確認它不需要原始專案目錄也能啟動。

如果插件只支援特定作業系統、Eagle 版本、檔案格式或第三方軟體，應在商店介紹中清楚說明。限制本身不一定會導致拒絕；未說明而使使用者無法完成核心功能，才會成為問題。

## 提供可執行的審核說明

如果沒有額外條件即可使用，通常不需要另寫審核文件。遇到以下情況時，請在投稿說明或插件根目錄的 `README` 提供步驟：

* 需要登入、API Token、授權碼或審核用帳號；
* 需要啟動伺服器、第三方應用程式或本機整合工具；
* 需要修改系統設定或授予額外權限；
* 核心功能需要特定測試檔案、資料格式或操作順序；
* 需要付費、訂閱或啟用試用方案才能完成測試。

說明應足以讓審核人員重現主要流程。測試帳號必須在審核期間有效；測試憑證請透過投稿頁面提供，不要把真實憑證、私人密鑰或使用者資料寫進安裝包。

## 常見未通過原因

* 插件根目錄缺少 `manifest.json`，或檔案無法解析。
* `id`、`name` 缺少有效內容。
* 發佈版本仍將 `devTools` 設為 `true`。
* `.eagleplugin` 已損壞或無法安全解壓縮。
* 核心功能必須登入或依賴外部環境，但沒有提供可用的審核方式。

解決以上問題後，請重新建立安裝包，並從頭安裝測試一次再投稿。