# 登錄表規則與檢查 — AI Game Dev 應用程式與 CLI · AI Game Developer Wiki

社群套件登錄表：命名規則、限制、自動檢查、簽章索引、發佈者面板、其 API，以及供代理閱讀的 Markdown。

本頁面由英文機器翻譯而成。[閱讀英文原文](https://ai-game.dev/docs/wiki/app/package-registry)。

每個上傳到 AI Game Dev 社群登錄表的版本，都會在任何人能安裝之前自動接受檢查；沒有手動審核佇列。本頁列出套件必須遵守的規則、每項檢查會拒絕什麼以及原因、已發佈的版本如何透過簽章索引送達使用者、發佈者面板、登錄表的 API，以及 AI 代理所閱讀的 Markdown 頁面。

## 名稱

- **發佈者 id** 為 2 到 40 個小寫字母、數字與單一連字號，先搶先贏。保留名稱包括：`aigd`、引擎名稱 `unity`、`godot`、`unreal`、`brutal`、`bevy` 與 `threejs`、商標與角色詞（`anthropic`、`claude`、`openai`、`official`、`admin`、`samples` …）、將數字替換為字母後的相似名稱（`un1ty`），以及任何把保留名稱當作單字或前綴使用的 id（`unity-tools`、`my-godot`）。AI Game Dev 可將保留名稱指派給其真正的擁有者。
- **套件 id** 為 `<publisher>.<name>`，且必須與 manifest 相符。像 `aigd.image` 這類應用程式保留的 id 會遭到拒絕。
- **優先順序：** 對於 `aigd.*` 的 id，或任何列在 AI Game Dev 自家索引中的 id，應用程式會忽略社群項目，因此沒有人能遮蔽官方套件。

## 限制

| 限制 | 值 |
| --- | --- |
| 封存檔（gzip） | 壓縮後 50 MiB，解壓後 200 MiB |
| 檔案 | 每個封存檔 5,000 個，每個檔案 64 MiB |
| 每個帳號的發佈者數 | 3 |
| 上傳次數 | 每小時 20 次（依帳號計算，使用 token 上傳則依發佈者計算） |
| 等待檢查的版本 | 每個發佈者 5 個 |
| 有效的發佈者 token | 每個發佈者 10 個，每個有效期最長 365 天 |
| 受信任的發佈者 | 每個套件 10 個 |
| 發行說明 | 每個版本 20 KB 的 Markdown |
| 通道 | 每個套件 5 個 |

## 自動檢查

封存檔一律視為不受信任的資料：在大小上限內於記憶體中解壓，並以位元組形式讀取，絕不執行。檢查依下列順序執行，報告會列出每項檢查及其結果：

| 檢查 | 拒絕項目 |
| --- | --- |
| `archive` | 非 gzip 的格式；超過限制的封存檔；符號連結、硬連結、裝置檔、絕對路徑、`..`、控制字元、在 Windows 上無效的名稱、忽略大小寫後重複的名稱、`.git/` |
| `manifest` | 應用程式不會載入的 manifest，會以應用程式自身的驗證器檢查：schema、擁有的 id、遊戲引擎規則 |
| `registry-rules` | 你不持有的發佈者；保留的 id；任何 `enabledApiProposals` 項目；不在封存檔中的 `main`；不是真正的 PNG、JPEG、GIF、WebP 或 ICO 的圖示，或含有腳本、樣式、外部參照或事件處理器的 SVG |
| `secrets` | 私鑰與憑證（雲端、GitHub、GitLab、Slack、Stripe、Google、Anthropic、OpenAI、npm、PyPI、Hugging Face、ai-game.dev 金鑰）、JWT、`.env`、`.npmrc` 或 `id_rsa` 等檔案。報告只會指出檔案與行號，絕不顯示內容 |
| `prompt-injection` | 試圖對代理下指令的文字（見下文） |
| `native-code` | 不拒絕：原生二進位檔允許上傳並會遭到標記，使用者會在套件上看到「原生程式碼」 |
| `virus-scan` | 病毒掃描器標記的任何內容，包括巢狀過深而無法掃描的封存檔 |

未通過的版本會標記為 `rejected` 並列出所有原因；修正後再上傳同一個版本即可。若掃描器暫時無法連線，版本會等待並重試，絕不會未經掃描就通過。

### 提示注入

套件的文字會傳達到代理：工具描述、skills、README、發行說明。登錄表會以全部規則讀取每個 manifest 字串、`README*`、Markdown 與文字檔、`SKILL.md`、`CLAUDE.md`、`AGENTS.md`，以及 `skills/`、`agents/`、`commands/` 與 `prompts/` 下的檔案，並以高信賴度規則讀取你的程式碼檔案。文字會先正規化（HTML 實體、Unicode 相似字元、隱形字元、Markdown 強調符號），所以偽裝沒有用。會拒絕以下情況：

- 要求忽略或覆寫先前的指示，或要求洩漏系統提示；
- 聊天角色標記（`<|im_start|>`、`[INST]`、`<system>` …）；
- 隱藏字元：零寬與雙向控制字元、Unicode 標籤字元；
- 解碼後會成為可讀文字的長串 base64；
- 向 AI 喊話的 HTML 註解或隱藏元素；
- 要求將金鑰、token、憑證或對話內容傳送到任何地方；
- 越獄語句、要求對使用者隱藏動作，以及要求自動核准工具或繞過權限檢查。

一般遊戲用語（「god mode」）、emoji、徽章與 API 文件都會通過。若檢查標記了無害的文字，請改寫措辭，或向 AI Game Dev 回報誤判。

## 簽章索引

已發佈的版本會寫入專屬的儲存空間（`community-packages.ai-game.dev`），並列在由登錄庫以 Ed25519 簽署的社群索引中。每個應用程式都會用內建於程式中的金鑰驗證簽章，拒絕已過期或比先前已接受者更舊的索引，並在解壓縮前驗證每個封存檔的 `sha512` 完整性，解壓縮後再驗證其樹狀雜湊。除了每個版本的封存檔之外，索引還會為每個套件記錄發佈者、評分、README、圖示、通道與棄用狀態，並為每個版本記錄發行說明（前 4 KB）、棄用狀態、來源證明與原生程式碼旗標。

AI Game Dev 撤銷的版本會列在索引的 `revoked` 清單中：每個應用程式會在下次讀取時將它停用（執行中的應用程式約每 30 分鐘讀取一次索引），而且永遠不會再安裝它。

## 發佈者面板

位於 [ai-game.dev/publisher](https://ai-game.dev/publisher) 的發佈者面板，是已登入的擁有者與維護者管理其發佈內容的地方：

- 你的發佈者、你在各發佈者中的角色，以及其成員；
- 每個套件的版本，包含其狀態與完整檢查報告；
- 發行說明、通道、棄用與撤回；
- 發佈者權杖（建立、列出、撤銷）；
- GitHub 與 GitLab 的信任發佈者，附可複製的工作流程片段；
- 仍在檢查中的上傳狀態。

## 登錄庫 API 的路由

CLI 與面板所做的一切都會經過 `https://ai-game.dev/api/registry/v1`。錯誤一律使用同一種信封格式：`{"error": {"code", "message", "fields"}}`。

| 路由 | 誰 | 什麼 |
| --- | --- | --- |
| `POST /publishers`、`GET /publishers`、`GET /publishers/{slug}` | 已登入者、成員 | 認領發佈者；列出你的發佈者；單一發佈者及其套件與版本 |
| `GET /me/publishers` | 已登入 | 你的發佈者與你的角色 |
| `GET /publishers/{slug}/members` | 成員 | 成員清單（電子郵件僅對擁有者顯示） |
| `POST /publishers/{slug}/members`、`DELETE …/members/{userId}` | 擁有者 | 新增或移除維護者 |
| `POST /publishers/{slug}/tokens`、`GET …/tokens`、`DELETE …/tokens/{id}` | 成員 | 發佈者權杖 |
| `POST /uploads`（multipart `tarball`，可選 `notes`） | 成員或權杖 | 上傳版本 |
| `GET /packages/{id}/versions/{version}` | 成員或權杖 | 狀態、檢查報告與發行說明 |
| `PATCH /packages/{id}/versions/{version}` | 成員 | 編輯發行說明 |
| `POST /packages/{id}/versions/{version}/yank` | 成員或權杖 | 撤回或還原 |
| `POST`、`DELETE /packages/{id}/deprecate` 與 `…/versions/{version}/deprecate` | 成員 | 標記棄用或取消棄用 |
| `GET /packages/{id}/dist-tags` | 公開 | 通道 |
| `PUT`、`DELETE /packages/{id}/dist-tags/{tag}` | 成員 | 設定或移除通道 |
| `GET`、`POST /packages/{id}/trusted-publishers`、`DELETE …/{tpId}` | 成員可讀取，擁有者可變更 | 信任發佈者 |
| `POST /oidc/token` | CI | 以 CI 身分權杖換取上傳憑證 |
| `GET /packages/{id}/ratings`、`PUT` 與 `DELETE …/rating` | 公開、已登入 | 評分（套件所屬發佈者的成員無法對其評分） |

## 供 AI 代理使用的 Markdown 頁面

AI 代理會以 Markdown 形式閱讀本站，因此所有與套件相關的內容都有 Markdown 版本：

- **目錄。** `ai-game.dev/packages` 的套件目錄（逐步推出中）列出所有官方與社群套件，每個套件在 `/packages/<id>` 都有專屬頁面。在任一路徑後加上 `.md`，或以 `Accept: text/markdown` 請求，即可取得相同內容的 Markdown：名稱、id、版本、發佈者、說明與安裝指令。
- **這些文件。** 本 wiki 的每一頁在 `/docs-md/` 下都有 Markdown 鏡像（本頁為 `/docs-md/wiki-app-package-registry.md`），可從頁面頂端的 **View as Markdown** 連結前往。鏡像中的每張截圖都會保留為圖片連結。
- **供 LLM 使用的網站索引。** `https://ai-game.dev/llms.txt` 列出這些頁面，因此被要求撰寫套件的代理可以直接找到 manifest 參考與套件 API。

**提示**

若想讓代理替你撰寫套件，請引導它閱讀 [套件 API](https://ai-game.dev/zh-hant/docs/wiki/app/package-api) 與 [manifest 參考](https://ai-game.dev/zh-hant/docs/wiki/app/package-manifest) 的 Markdown 鏡像，並讓它在每次變更後執行 `gamedev pkg validate`。

## 相關頁面

- [發佈套件](https://ai-game.dev/zh-hant/docs/wiki/app/publishing-packages)：發佈工作流程。
- [信任發佈](https://ai-game.dev/zh-hant/docs/wiki/app/trusted-publishing)：CI 與來源證明。
- [生命週期、主機與權限](https://ai-game.dev/zh-hant/docs/wiki/app/package-lifecycle#permissions)：套件安裝後可以做的事。

---

Source (HTML): https://ai-game.dev/zh-hant/docs/wiki/app/package-registry

Machine-translated (zh-Hant) from the English page: https://ai-game.dev/docs/wiki/app/package-registry
