Boring Registry 格式規範

版本: 1.0.0
狀態: 草稿
日期: 2026-01-18

這份文件定義了 registry.json 的結構，這是 Boring-Gemini 去中心化插件生態系的索引檔案。

核心哲學 (Core Philosophy)

• 僅索引 (Index Only): Registry 只做索引，不存代碼。
• Git 原生 (Git-Native): 依賴 Git URL 作為唯一的「真相來源 (Source of Truth)」。
• 去中心化 (Decentralized): 任何人都可以 fork 這個 registry 並維護自己的清單。

JSON 結構

{
  "schema_version": "1.0",
  "last_updated": "YYYY-MM-DD",
  "maintainer": "Boring Team",
  "plugins": [
    {
      "id": "namespace/plugin-name",
      "type": "plugin",
      "name": "Display Name",
      "description": "Short description",
      "repo": "https://github.com/user/repo",
      "branch": "main",
      "path": "/",
      "min_core_version": "15.0.0",
      "tags": ["tag1", "tag2"],
      "verified": false
    }
  ]
}

欄位定義

Root Object (根物件)

欄位	類型	描述
schema_version	string	Registry 格式版本 (e.g. "1.0")
last_updated	string	最後更新日期 (ISO 8601)
plugins	array	插件清單

Plugin Object (插件物件)

欄位	類型	必填	描述
id	string	Yes	唯一識別符，格式 namespace/name。通常對應 github_user/repo_name。
type	string	Yes	資源類型: plugin, workflow, brain, theme
name	string	Yes	人類可讀的顯示名稱
description	string	Yes	簡短說明 (建議 < 100 字)
repo	string	Yes	完整的 Git Repository URL (HTTPS)
branch	string	No	指定分支，預設為 main 或 master
path	string	No	Repository 內的子目錄路徑，預設為根目錄 /
min_core_version	string	No	需要的 boring-gemini 最低版本 (SemVer)
tags	array	No	搜尋用的關鍵字標籤
verified	bool	No	(官方用) 是否經過官方安全審核

範例

{
  "schema_version": "1.0",
  "last_updated": "2026-01-18",
  "plugins": [
    {
      "id": "boring/security-scanner",
      "type": "plugin",
      "name": "Security Scanner",
      "description": "Advanced static analysis for Python code security.",
      "repo": "https://github.com/boring-plugins/security-scanner",
      "min_core_version": "15.0.0",
      "tags": ["security", "audit", "linter"],
      "verified": true
    }
  ]
}