> 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/ja-jp/plugin-review/criteria/package-contents.md).

# パッケージ内容

提出する `.eagleplugin` は、実行に必要なファイルだけを含むクリーンなリリースパッケージにしてください。機密情報、開発環境、不要な成果物、入れ子のアーカイブ、バイナリに該当する可能性がある内容を確認し、用途に応じて判断します。

確認対象になっただけで禁止されるわけではありません。ネイティブバイナリや実行時の依存関係が必要なプラグインもありますが、開発者はその出所、目的、必要性を説明できる必要があります。

## 開発環境のディレクトリを含めない

最終パッケージには通常、実行と無関係なバージョン管理、エディター、仮想環境、キャッシュのディレクトリを含めないでください。

* `.git/`、`.svn/`、`.hg/`、`.bzr/`
* `.idea/`、`.vscode/`
* `__pycache__/`、`.pytest_cache/`
* `.venv/`、`venv/`

プロジェクトディレクトリ全体をそのままパッケージ化しないでください。`node_modules/` やその他の依存ディレクトリが実行時に必要な場合は、リリースに必要な内容だけを残してください。ビルド済みリリースから、未使用の開発依存関係と重複パッケージを削除することを推奨します。

## 機密データを削除する

実際の認証情報や秘密鍵をパッケージに含めてはいけません。特に次のファイルを確認してください。

* `.env` とその派生ファイル。
* `.pem`、`.key`、`.p12`、`.pfx` の鍵または証明書。
* `credentials.json`、`secrets.json`。
* Tokenや非公開Registryの認証情報を含む `.npmrc`。
* テストアカウント、個人データ、内部URL、開発用データベース。

機密情報をパッケージ化または公開した場合、ファイルの削除だけでは不十分です。影響を受けた秘密情報や認証情報を直ちに無効化し、変更してください。

## 不要なファイルを削除する

実行に影響しないシステムファイルや一時ファイルを削除してください。

* `.DS_Store`、`Thumbs.db`、`desktop.ini`
* `.log`、`.tmp`、`.swp`、`.swo`
* テスト出力、デバッグログ、下書き画像、ローカルキャッシュ。
* 重複した `dist/`、以前のビルド、重複したソースとリリース成果物。

内容を絞ったパッケージは、ユーザーがインストールするものを確認しやすくし、意図しない情報漏えいと供給網リスクを減らします。

## 入れ子のアーカイブと重複パッケージを避ける

`.eagleplugin` の中に、実行と無関係な `.zip`、`.rar`、`.7z`、`.tar`、`.tgz`、`.gz`、`.dmg`、`.iso` を含めないでください。

機能上アーカイブが必要な場合は、審査用の説明に内容、出所、用途を記載してください。ソースアーカイブ、以前のインストーラー、バックアップ、別の完全なプラグインは実際のリリース範囲を不明確にし、不合格となる場合があります。

## バイナリファイル

`.exe`、`.dll`、`.msi`、`.dylib`、`.so`、`.app`、`.pkg`、`.bin` は追加確認の対象になりますが、バイナリ形式だけを理由に不合格にはしません。

バイナリコンポーネントが必要な場合は、次を確認してください。

* 説明された機能を直接実現するために必要である。
* 信頼できる出所から取得し、開発者が再配布する権利を持つ。
* 対応OSとアーキテクチャを明記する。
* 説明されていないインストール、ダウンロード、システム変更を行わない。
* 無関係なOS向けファイルや古い重複バージョンを含めない。

## 主な不合格理由

* バージョン管理ディレクトリ、エディター設定、仮想環境が含まれている。
* `.env`、秘密鍵、認証情報ファイルが含まれている。
* 入れ子のソースアーカイブ、以前のインストーラー、重複ビルドが含まれている。
* 実行と無関係なログ、キャッシュ、テスト、システムファイルが大量にある。
* バイナリの出所や目的を説明できない、または未開示のシステム操作を行う。

新しいリリースディレクトリからパッケージを作成し、提出前に展開したコピーを確認して、ユーザーが必要とするファイルだけが含まれていることを確認してください。