evyzacq
157 lines
4.8 KiB
JSON
157 lines
4.8 KiB
JSON
{
|
|
"$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" }
|
|
}
|
|
}
|
|
}
|
|
}
|