> 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-cn/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`。
* 更新日志应与介绍分开，不要把版本记录塞进详细介绍。

## 语言版本与文字质量

每个投稿语言版本都必须完整且可理解。以下情况会让文案看起来尚未完成：

* 保留预留文字、测试内容或翻译键；
* 只翻译部分字段或段落；
* 混杂语言到无法正常阅读；
* 错误密集到掩盖原意；
* 明显未整理的机器翻译内容导致语意失真。

个别拼字、标点、文法、大小写或轻微排版问题，只要不影响理解，通常只会收到改进建议。

## 内容与链接

文案不得包含仇恨、骚扰、歧视、露骨色情、诈骗、鼓励非法活动或没有根据地攻击其他产品等内容。

可以提供与插件使用直接相关的文件、支持、价格、隐私、开发者信息及账号注册链接。无关广告、垃圾信息、大量联盟链接、误导性下载，或刻意隐藏目的地的缩短与混淆链接，可能阻挡投稿。

## 常见未通过原因

* 名称或描述超过硬性长度限制。
* 介绍没有说明插件用途、主要流程或任何实际功能。
* 文案宣称当前版本并未实现的功能。
* 没有说明必要登录、付款、外部数据传输或破坏性行为。
* 必要语言版本仍包含草稿、预留文字或无法理解的翻译。
* 更新日志存在但没有说明任何实际发布内容。

修改时请以当前版本能够验证的行为为准，不要为了让文案更吸引人而加入无法证明的功能或保证。