For the complete documentation index, see llms.txt. This page is also available as Markdown.

發佈設定與可審核性

插件安裝包、manifest.json、發佈設定與審核資訊的具體要求。

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

安裝包必須有效

請使用 Eagle 的打包功能建立 .eagleplugin 檔案,並確認:

  • 檔案可以正常開啟與完整解壓縮,不是損壞或不完整的壓縮包;

  • 安裝包內沒有重複路徑、異常連結或可能把檔案寫到插件目錄以外的路徑;

  • 最終檔案是準備發佈的版本,而不是改名後的其他壓縮格式;

  • 重新下載或移動檔案後仍能正常安裝。

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

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

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

  • 插件根目錄包含 manifest.json

  • 檔案內容是有效的 JSON 物件;

  • idname 都是非空字串;

  • devTools 不得設為 true

manifest.json 的其他欄位仍須符合插件類型與實際功能。完整設定方式請參閱manifest.json 完整設定

提交最終發佈版本

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

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

提供可執行的審核說明

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

  • 需要登入、API Token、授權碼或審核用帳號;

  • 需要啟動伺服器、第三方應用程式或本機整合工具;

  • 需要修改系統設定或授予額外權限;

  • 核心功能需要特定測試檔案、資料格式或操作順序;

  • 需要付費、訂閱或啟用試用方案才能完成測試。

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

常見未通過原因

  • 插件根目錄缺少 manifest.json,或檔案無法解析。

  • idname 缺少有效內容。

  • 發佈版本仍將 devTools 設為 true

  • .eagleplugin 已損壞或無法安全解壓縮。

  • 核心功能必須登入或依賴外部環境,但沒有提供可用的審核方式。

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

Last updated