本頁面由英文機器翻譯而成。閱讀英文原文。

登錄表規則與檢查

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

更新於 2026年11月19日 以 Markdown 檢視

每個上傳到 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 的發佈者面板,是已登入的擁有者與維護者管理其發佈內容的地方:

  • 你的發佈者、你在各發佈者中的角色,以及其成員;
  • 每個套件的版本,包含其狀態與完整檢查報告;
  • 發行說明、通道、棄用與撤回;
  • 發佈者權杖(建立、列出、撤銷);
  • 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/tokenCI以 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。