init the project

2026-05-25 15:09:42 +08:00
commit 7fc0e7852e
122 changed files with 14557 additions and 0 deletions
@@ -0,0 +1,156 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zeekerwatchman/schemas/ir.json",
+  "title": "IR (Intermediate Representation) Schema",
+  "description": "3-stage pipeline output: feature analysis rules with trigger/action semantics",
+
+  "type": "object",
+  "required": ["feature", "feature_id", "rules"],
+  "properties": {
+    "feature": {
+      "type": "string",
+      "description": "功能名称，从 PRD 中提取"
+    },
+    "feature_id": {
+      "type": "string",
+      "description": "功能缩写，用于生成 rule_id 前缀，如 PRD, AUTH, ORDER",
+      "pattern": "^[A-Z]{2,8}$"
+    },
+    "rule_count": {
+      "type": "integer",
+      "description": "规则总数"
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "rules": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/definitions/IRRule"
+      }
+    }
+  },
+
+  "definitions": {
+    "IRRule": {
+      "type": "object",
+      "required": ["rule_id", "description", "priority"],
+      "properties": {
+        "rule_id": {
+          "type": "string",
+          "description": "唯一标识。格式: IR-{feature_id}-{section}-{seq}，如 IR-PRD-4.2.1-001",
+          "pattern": "^IR-[A-Z]{2,8}-[0-9.]+-[0-9]{3}$",
+          "examples": ["IR-PRD-4.2.1-001", "IR-AUTH-2.1-001"]
+        },
+        "description": {
+          "type": "string",
+          "description": "完整的中文自然语言描述，包含前置条件、触发条件和所有动作",
+          "minLength": 10
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["P0", "P1", "P2"],
+          "description": "P0=核心安全规则, P1=重要规则, P2=边界情况"
+        },
+        "sources": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/Source" },
+          "description": "规则的数据来源锚点"
+        },
+        "precondition": {
+          "type": "object",
+          "description": "规则生效的前置状态条件。可以是空对象",
+          "properties": {
+            "switch": { "type": "string" },
+            "app_type": { "type": "string", "description": "如: 系统限制, SDK限制, 其他应用" },
+            "app_state": { "type": "string", "description": "如: 前台, 后台" }
+          }
+        },
+        "trigger": {
+          "type": "object",
+          "required": ["operator", "conditions"],
+          "properties": {
+            "operator": {
+              "type": "string",
+              "enum": ["AND", "OR"],
+              "description": "多个条件的组合方式"
+            },
+            "conditions": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/definitions/TriggerCondition" }
+            }
+          }
+        },
+        "actions": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/Action" }
+        }
+      }
+    },
+
+    "TriggerCondition": {
+      "type": "object",
+      "required": ["signal", "operator", "value"],
+      "properties": {
+        "signal": {
+          "type": "string",
+          "description": "触发信号名，如 车速, 档位, 文件格式",
+          "examples": ["车速", "文件大小", "应用请求启动"]
+        },
+        "operator": {
+          "type": "string",
+          "enum": [">=", ">", "<=", "<", "==", "!=", "in", "not_in", "exists"],
+          "description": "比较运算符"
+        },
+        "value": {
+          "description": "比较值，可以是数字、字符串或数组"
+        },
+        "unit": {
+          "type": "string",
+          "description": "数值单位，如 km/h, 秒, MB",
+          "examples": ["km/h", "秒", "MB"]
+        }
+      }
+    },
+
+    "Action": {
+      "type": "object",
+      "required": ["type", "description"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["system", "user_interaction"],
+          "description": "system=系统自动行为, user_interaction=用户可见交互"
+        },
+        "description": {
+          "type": "string",
+          "description": "动作描述"
+        },
+        "content": {
+          "type": "string",
+          "description": "用户可见内容（仅 user_interaction 类型需要），如 Toast 文案"
+        }
+      }
+    },
+
+    "Source": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["para", "table", "image", "logic_tree"],
+          "description": "来源类型"
+        },
+        "section": { "type": "string", "description": "章节号" },
+        "row": { "type": "integer", "description": "表格行号" },
+        "text_snippet": { "type": "string", "description": "前200字关键文字" },
+        "image_id": { "type": "string", "description": "图片 rId" }
+      }
+    }
+  }
+}