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

# 功能与政策合规

通过初步扫描后，插件才会进入人工审核。人工审核会根据插件类型、宣称功能与风险选择适用的测试项目，确认用户实际安装后获得的体验与商店说明一致。

人工审核的范围不会对每个插件套用完全相同的操作脚本。功能简单的插件可能只需要验证核心流程；会修改大量数据、连接外部服务或执行系统操作的插件，则需要更深入的情境检查。

## AI 辅助开发与开发者责任

开发者可以使用 AI 工具协助开发，但必须对最终提交的全部代码、依赖与实际行为负责。投稿前，开发者至少应做到：

* 阅读并理解 AI 生成或修改的代码，而不是只确认界面看起来可以运行；
* 检查第三方依赖、外部连接、数据传输、文件操作与系统命令；
* 移除无关、重复、无法解释或未经验证的代码；
* 确认商店文案只描述当前版本真正实现的功能；
* 安装并测试最终打包的 `.eagleplugin`，而不只是测试开发环境中的项目；
* 能够说明插件的重要行为、风险与必要权限。

如果开发者无法解释核心实现或无法确认插件会如何处理用户数据与文件，审核人员可能无法判断该插件可以安全上架。明显由 AI 代码胡乱拼凑、缺少基本检查或未经实际测试的投稿，可能无法通过审核。

## 安装与启动

审核会确认：

* `.eagleplugin` 可以正常安装；
* 插件能从预期入口启动，并在合理时间内响应；
* 发布版本不依赖开发电脑上的原始项目、临时服务或未说明设置；
* 不支持的平台或环境能够得到清楚提示，而不是直接失败或造成数据损坏。

## 主要功能

商店文案宣称的主要功能应能在当前版本完成。人工审核可能依序检查：

* 启动核心流程所需的选择、输入或设置；
* 每项已经明确宣称的主要能力；
* 产生的文件、数据或画面结果；
* 是否保留、修改或删除原始 Eagle 数据；
* 需要外部服务时，连接、认证与结果是否正常。

未完成、仅有占位界面、与描述明显不符，或无法重复完成的核心功能，会阻挡投稿。

## 取消、无效输入与错误状态

插件应合理处理用户取消、缺少选择、输入无效、外部服务不可用或权限不足等情况。并非每个边缘情境都必须提供复杂界面，但插件不应因此无响应、损坏数据或让用户误以为操作成功。

会执行大量或不可逆变更时，应在操作前提供清楚说明与确认。能够预览、取消或恢复时，建议提供相应机制。

## 对 Eagle 数据与本地文件的影响

插件对项目、标签、文件夹、本地文件或系统设置所做的变更，必须：

* 与插件宣称用途一致；
* 限制在完成该功能所需的范围；
* 在执行前让用户理解重要影响；
* 不暗中修改无关数据；
* 不造成未说明且无法恢复的数据损失。

如果插件会创建新文件、覆盖原文件、删除数据或批量修改项目，请在介绍与实际界面中使用一致、明确的说明。

## 卸载与清理

适用时，人工审核也会确认插件停用或卸载后的行为。插件不应继续运行未说明的后台进程，也不应在卸载时擅自删除用户创建的文件或 Eagle 数据。如果插件会创建缓存、辅助程序或系统设置，请说明保留与清理方式。

## 审核条件与外部服务

需要账号、付费方案、API Token、第三方应用、特定文件或服务器时，开发者必须提供足以完成主要流程的审核条件。外部服务在审核期间应可用。

如果限制已经清楚说明，特定平台、格式或付费条件本身不一定会导致拒绝；但审核人员必须能够验证投稿所宣称的功能。

## 开发者政策

人工审核也会结合[《Eagle 开发者政策》](/plugin-api/zh-cn/plugin-review/developer-policies.md)检查内容、安全、隐私、付费功能、广告、用户权益及其他适用要求。

特别需要注意：

* 插件与商店信息不得冒充官方或误导来源；
* 功能、费用、限制与数据处理方式必须准确；
* 插件不得破坏 Eagle 或系统的稳定性与安全性；
* 付费、订阅与试用条件必须在用户决定前清楚说明；
* 插件内容及行为必须符合适用法律与内容政策。

## 常见未通过原因

* 插件无法安装、启动或完成商店介绍中的核心功能。
* 主要界面仍是占位内容，或宣称功能没有实际实现。
* 取消或输入错误会造成崩溃、无响应或数据损坏。
* 插件在未说明的情况下删除、覆盖或大量修改用户数据。
* 停用或卸载后仍执行未说明的后台行为，或擅自删除用户内容。
* 需要账号、Token 或第三方服务，却没有提供可用的审核条件。
* 开发者无法说明插件的核心行为、外部连接、数据处理或文件变更。
* 投稿包含大量无法解释、未经检查或与功能无关的 AI 生成代码。
* 实际行为、付费方式或数据处理与商店说明不一致。
* 插件违反开发者政策中的安全、内容、隐私或用户权益要求。

人工审核的目的不是要求所有插件具有相同设计或功能规模，而是确认当前版本可以安全、稳定且如实地完成开发者对用户作出的承诺。