> 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/configuration-and-reviewability.md).

# 发布设置与可审核性

投稿后，我们会先确认安装包可以被安全开启，并具备继续审核所需的基本设置与数据。无法解压、缺少必要设置或仍处于开发状态的版本，会阻挡当前投稿。

## 安装包必须有效

请使用 Eagle 的打包功能创建 `.eagleplugin` 文件，并确认：

* 文件可以正常开启与完整解压，不是损坏或不完整的压缩包；
* 安装包内没有重复路径、异常链接或可能把文件写到插件目录以外的路径；
* 最终文件是准备发布的版本，而不是改名后的其他压缩格式；
* 重新下载或移动文件后仍能正常安装。

损坏、格式无效或无法安全解压的安装包无法进入后续审核。遇到这类问题时，请从干净的发布目录重新打包，不要尝试手动修改已经产生的 `.eagleplugin` 文件。

## `manifest.json` 必须位于插件根目录

发布版本至少应符合以下要求：

* 插件根目录包含 `manifest.json`；
* 文件内容是有效的 JSON 对象；
* `id` 与 `name` 都是非空字符串；
* `devTools` 不得设为 `true`。

`manifest.json` 的其他字段仍须符合插件类型与实际功能。完整配置方式请参阅[manifest.json 完整配置](/plugin-api/zh-cn/tutorial/manifest.md)。

## 提交最终发布版本

发布版本不应开启开发工具，也不应依赖只存在于开发电脑上的路径、服务或环境变量。提交前建议安装打包后的文件，确认它不需要原始项目目录也能启动。

如果插件只支持特定操作系统、Eagle 版本、文件格式或第三方软件，应在商店介绍中清楚说明。限制本身不一定会导致拒绝；未说明而使用户无法完成核心功能，才会成为问题。

## 提供可执行的审核说明

如果没有额外条件即可使用，通常不需要另写审核文件。遇到以下情况时，请在投稿说明或插件根目录的 `README` 提供步骤：

* 需要登录、API Token、授权码或审核用账号；
* 需要启动服务器、第三方应用或本地整合工具；
* 需要修改系统设置或授予额外权限；
* 核心功能需要特定测试文件、数据格式或操作顺序；
* 需要付费、订阅或启用试用方案才能完成测试。

说明应足以让审核人员重复主要流程。测试账号必须在审核期间有效；测试凭证请通过投稿页面提供，不要把真实凭证、私人密钥或用户数据写进安装包。

## 常见未通过原因

* 插件根目录缺少 `manifest.json`，或文件无法解析。
* `id`、`name` 缺少有效内容。
* 发布版本仍将 `devTools` 设为 `true`。
* `.eagleplugin` 已损坏或无法安全解压。
* 核心功能必须登录或依赖外部环境，但没有提供可用的审核方式。

解决以上问题后，请重新创建安装包，并从头安装测试一次再投稿。