add initial protocol docs and schemas

docs/concert_sync_protocol.md

@@ -0,0 +1,3 @@
+# 演唱会播放同步协议
+
+用于定义 PC 同步播放器如何向 AI球同步 content_id、position_ms、state、speed。

docs/device_api.md

@@ -0,0 +1,3 @@
+# AI球设备控制协议
+
+用于定义上位机、播放器、测试工具如何控制 AI球。

docs/factory_test_spec.md

@@ -0,0 +1,3 @@
+# AI球出厂测试标准
+
+用于定义首批 100 台设备的烧录、自检、屏幕、喇叭、麦克风、按键、无线充电和应援脚本测试标准。

docs/state_machine.md

@@ -0,0 +1,3 @@
+# AI球状态机
+
+用于定义 AI球设备端状态、状态切换和默认反馈。

schemas/call_script_schema.json

@@ -0,0 +1,25 @@
+{
+  "title": "AI Ball Call Script Schema",
+  "type": "object",
+  "required": ["content_id", "title", "duration_ms", "actions"],
+  "properties": {
+    "content_id": { "type": "string" },
+    "title": { "type": "string" },
+    "duration_ms": { "type": "integer" },
+    "actions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["time_ms", "type", "value"],
+        "properties": {
+          "time_ms": { "type": "integer" },
+          "type": { "type": "string" },
+          "value": { "type": "string" },
+          "duration_ms": { "type": "integer" },
+          "intensity": { "type": "number" },
+          "silent_alt": { "type": "string" }
+        }
+      }
+    }
+  }
+}

schemas/resource_pack_schema.json

@@ -0,0 +1,21 @@
+{
+  "title": "AI Ball Resource Pack Schema",
+  "type": "object",
+  "required": ["pack_id", "version", "resources"],
+  "properties": {
+    "pack_id": { "type": "string" },
+    "version": { "type": "string" },
+    "resources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "type", "path"],
+        "properties": {
+          "id": { "type": "string" },
+          "type": { "type": "string" },
+          "path": { "type": "string" }
+        }
+      }
+    }
+  }
+}