> 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/store-listing-copy.md).

# 商店文案

商店文案必須讓使用者在安裝前理解插件的用途、主要流程與重要條件。審核會分別檢查每個投稿語系，並將文案與實際插件內容互相核對。

一個語系寫得完整，不能彌補另一個必要語系中的阻擋問題。請確保每個投稿語系都能獨立閱讀與理解。

## 名稱

插件名稱應容易閱讀與辨識，並和插件身分、用途、輸出或概念具有合理關聯。

* 最多 30 個 Unicode 字元。
* 使用由空格分隔的語言時，同時不得超過 6 個單字。
* 可以使用品牌名稱、創意名稱或功能導向名稱，不強制只能使用名詞。
* 可以描述性提及 `Eagle`，但不得暗示插件由 Eagle 官方製作、擁有或背書。
* 不得使用誤導、無法閱讀、無關、冒充他人或堆砌關鍵字的名稱。

英文名稱採用標題式大小寫是建議，不是硬性要求。只要名稱仍然清楚，全小寫、裝飾性標點或一般宣傳用語不會單獨導致拒絕。

## 簡短描述

描述應直接說明核心功能與使用者價值，並提供名稱以外的有效資訊。

* 簡體中文最多 100 個 Unicode 字元。
* 英文最多 200 個 Unicode 字元。
* 建議控制在兩句話內；句數本身不是拒絕條件。
* 避免只有口號、重複名稱或加入無關關鍵字。
* 不得宣稱插件沒有實作的功能。

「快速」、「最佳」、「提升效率」等一般宣傳用語本身不會阻擋投稿。不過，具體數字、排名、市場領先、指名比較、費用、隱私、支援格式或相容性等事實，必須有合理依據並與目前版本一致。

## 詳細介紹

介紹應讓使用者知道自己將安裝什麼，以及如何完成主要操作。內容至少應涵蓋：

* 插件用途與已經實作的主要功能；
* 開始使用所需的關鍵步驟；
* 重要輸入、輸出，以及是否會修改原始資料；
* 會實質影響安裝、存取、付款、資料處理或核心使用的條件。

遇到以下情況時，必須清楚揭露：

* 需要第三方登入、API 密鑰、付費方案或配套軟體；
* 必須使用網路或外部服務；
* 會將使用者資料、所選檔案或其內容傳送到外部；
* 會執行刪除、覆寫或其他不可逆操作；
* 只支援特定平台、Eagle 版本或檔案格式，而且該限制會決定核心功能能否使用；
* 有不可省略的操作步驟，否則主要流程無法完成。

選用設定、次要限制、細微操作差異、介面語言說明或推測性的未來相容性，通常屬於改進建議。只有遺漏會實質誤導使用者或使核心流程無法完成時，才會阻擋投稿。

## 更新日誌

投稿頁面有提供或要求更新日誌時，請使用使用者能夠理解的語言說明這個版本的實際變化。

* 首次發佈可以寫「首次發佈。」或 `Initial release.`。
* 更新版本應說明新增功能、修正或實際改進。
* 不要只寫 `Update`、`Fix`、`Changes` 或 `Initial Commit`。
* 更新日誌應與介紹分開，不要把版本記錄放進詳細介紹。

## 語系與文字品質

每個投稿語系都必須完整且可理解。以下情況會讓文案看起來尚未完成：

* 保留預留文字、測試內容或翻譯鍵；
* 只翻譯部分欄位或段落；
* 混雜語言到無法正常閱讀；
* 錯誤密集到掩蓋原意；
* 明顯未整理的機器翻譯內容導致語意失真。

個別拼字、標點、文法、大小寫或輕微排版問題，只要不影響理解，通常只會收到改進建議。

## 內容與連結

文案不得包含仇恨、騷擾、歧視、露骨色情、詐騙、鼓勵非法活動或沒有根據地攻擊其他產品等內容。

可以提供與插件使用直接相關的文件、支援、價格、隱私、開發者資訊及帳號註冊連結。無關廣告、垃圾資訊、大量聯盟連結、誤導性下載，或刻意隱藏目的地的縮短與混淆連結，可能阻擋投稿。

## 常見未通過原因

* 名稱或描述超過硬性長度限制。
* 介紹沒有說明插件用途、主要流程或任何實際功能。
* 文案宣稱目前版本並未實作的功能。
* 沒有說明必要登入、付款、外部資料傳輸或破壞性行為。
* 必要語系仍包含草稿、預留文字或無法理解的翻譯。
* 更新日誌存在但沒有說明任何實際發佈內容。

修改時請以目前版本能夠驗證的行為為準，不要為了讓文案更吸引人而加入無法證明的功能或保證。