> 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/functionality-and-policy.md).

# 功能與政策合規

通過初步掃描後，插件才會進入人工審核。人工審核會根據插件類型、宣稱功能與風險選擇適用的測試項目，確認使用者實際安裝後獲得的體驗與商店說明一致。

人工審核不會對每個插件套用完全相同的操作腳本。功能簡單的插件可能只需要驗證核心流程；會修改大量資料、連線外部服務或執行系統操作的插件，則需要更深入的情境檢查。

## AI 輔助開發與開發者責任

開發者可以使用 AI 工具協助開發，但必須對最終提交的全部程式碼、相依套件與實際行為負責。投稿前，開發者至少應做到：

* 閱讀並理解 AI 生成或修改的程式碼，而不是只確認介面看起來可以執行；
* 檢查第三方相依套件、外部連線、資料傳輸、檔案操作與系統指令；
* 移除無關、重複、無法解釋或未經驗證的程式碼；
* 確認商店文案只描述目前版本真正實作的功能；
* 安裝並測試最終打包的 `.eagleplugin`，而不只是測試開發環境中的專案；
* 能夠說明插件的重要行為、風險與必要權限。

如果開發者無法解釋核心實作或無法確認插件會如何處理使用者資料與檔案，審核人員可能無法判斷該插件可以安全上架。明顯由 AI 程式碼胡亂拼湊、缺少基本檢查或未經實際測試的投稿，可能無法通過審核。

## 安裝與啟動

審核會確認：

* `.eagleplugin` 可以正常安裝；
* 插件能從預期入口啟動，並在合理時間內回應；
* 發佈版本不依賴開發電腦上的原始專案、臨時服務或未說明設定；
* 不支援的平台或環境能夠得到清楚提示，而不是直接失敗或造成資料損壞。

## 主要功能

商店文案宣稱的主要功能應能在目前版本完成。人工審核可能依序檢查：

* 啟動核心流程所需的選擇、輸入或設定；
* 每項已經明確宣稱的主要能力；
* 產生的檔案、資料或畫面結果；
* 是否保留、修改或刪除原始 Eagle 資料；
* 需要外部服務時，連線、認證與結果是否正常。

未完成、僅有預留介面、與描述明顯不符，或無法重複完成的核心功能，會阻擋投稿。

## 取消、無效輸入與錯誤狀態

插件應合理處理使用者取消、缺少選擇、輸入無效、外部服務不可用或權限不足等情況。並非每個邊緣情境都必須提供複雜介面，但插件不應因此無回應、損壞資料或讓使用者誤以為操作成功。

會執行大量或不可逆變更時，應在操作前提供清楚說明與確認。能夠預覽、取消或復原時，建議提供相應機制。

## 對 Eagle 資料與本機檔案的影響

插件對項目、標籤、資料夾、本機檔案或系統設定所做的變更，必須：

* 與插件宣稱用途一致；
* 限制在完成功能所需的範圍；
* 在執行前讓使用者理解重要影響；
* 不暗中修改無關資料；
* 不造成未說明且無法復原的資料損失。

如果插件會建立新檔案、覆寫原檔案、刪除資料或批次修改項目，請在介紹與實際介面中使用一致、明確的說明。

## 解除安裝與清理

適用時，人工審核也會確認插件停用或解除安裝後的行為。插件不應繼續執行未說明的背景程序，也不應在解除安裝時擅自刪除使用者建立的檔案或 Eagle 資料。如果插件會建立快取、輔助程式或系統設定，請說明保留與清理方式。

## 審核條件與外部服務

需要帳號、付費方案、API Token、第三方應用程式、特定檔案或伺服器時，開發者必須提供足以完成主要流程的審核條件。外部服務在審核期間應可用。

如果限制已經清楚揭露，特定平台、格式或付費條件本身不一定會導致拒絕；但審核人員必須能夠驗證投稿所宣稱的功能。

## 開發者政策

人工審核也會結合[《Eagle 開發者政策》](/plugin-api/zh-tw/plugin-review/developer-policies.md)檢查內容、安全、隱私、付費功能、廣告、使用者權益及其他適用要求。

特別需要注意：

* 插件與商店資料不得冒充官方或誤導來源；
* 功能、費用、限制與資料處理方式必須準確；
* 插件不得破壞 Eagle 或系統的穩定性與安全性；
* 付費、訂閱與試用條件必須在使用者決定前清楚揭露；
* 插件內容及行為必須符合適用法律與內容政策。

## 常見未通過原因

* 插件無法安裝、啟動或完成商店介紹中的核心功能。
* 主要介面仍是預留內容，或宣稱功能沒有實際實作。
* 取消或輸入錯誤會造成當機、無回應或資料損壞。
* 插件在未說明的情況下刪除、覆寫或大量修改使用者資料。
* 停用或解除安裝後仍執行未說明的背景行為，或擅自刪除使用者內容。
* 需要帳號、Token 或第三方服務，卻沒有提供可用的審核條件。
* 開發者無法說明插件的核心行為、外部連線、資料處理或檔案變更。
* 投稿包含大量無法解釋、未經檢查或與功能無關的 AI 生成程式碼。
* 實際行為、付費方式或資料處理與商店說明不一致。
* 插件違反開發者政策中的安全、內容、隱私或使用者權益要求。

人工審核的目的不是要求所有插件具有相同設計或功能規模，而是確認目前版本可以安全、穩定且如實地完成開發者對使用者作出的承諾。