add initial AI ball protocol docs

schemas/resource_pack_schema.json

@@ -1,19 +1,53 @@
 {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "AI Ball Resource Pack Schema",
+  "description": "Initial schema for AI球 resource packs used by devices and the PC host application.",
   "type": "object",
+  "additionalProperties": false,
   "required": ["pack_id", "version", "resources"],
   "properties": {
-    "pack_id": { "type": "string" },
-    "version": { "type": "string" },
+    "pack_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "target_firmware": {
+      "type": "string",
+      "description": "Optional compatible firmware version or range."
+    },
+    "description": {
+      "type": "string"
+    },
     "resources": {
       "type": "array",
       "items": {
         "type": "object",
+        "additionalProperties": false,
         "required": ["id", "type", "path"],
         "properties": {
-          "id": { "type": "string" },
-          "type": { "type": "string" },
-          "path": { "type": "string" }
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "type": {
+            "type": "string",
+            "enum": ["audio", "image", "animation", "light_preset", "expression", "other"]
+          },
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^[A-Fa-f0-9]{64}$"
+          },
+          "size_bytes": {
+            "type": "integer",
+            "minimum": 0
+          }
         }
       }
     }