Initial commit

This commit is contained in:
Alex committed 2026-11-02 22:54:14 +08:00
commit 57fc3525eb
7311 files changed
+1291398

No files matched your search

+154
View File
@@ -0,0 +1,154 @@
"""R1-1:站点适配器 Schema v1。
只校验“形状”:类型、必填项、嵌套关系,以及 default_preset 必须指向已有预设。
语义校验(工作流 DSL、选择器能否命中等)仍由 ``flow_runtime.validate_workflow`` 和
ConfigEngine 的各个 ``_validate_*`` 负责。为了不误伤现有配置和用户自建预设,未知字段一律放行,
预设内部也不设必填项。
单站点文件(R1-2,``config/sites/<站点>.json``)的外层信封::
{"schema_version": 1, "site": "chat.deepseek.com", "adapter_version": "2026.09.26",
"min_app_version": "3.0.0", "last_verified": "2026-09-26", "config": {...}}
``config`` 与旧版 ``config/sites.json`` 中对应节点的内容完全相同。
"""
from __future__ import annotations
from typing import Any, Dict, Iterable, List
from jsonschema import Draft202012Validator
SITE_FILE_SCHEMA_VERSION = 1
GLOBAL_KEY = "_global"
_OBJECT = {"type": "object"}
WORKFLOW_STEP_SCHEMA: Dict[str, Any] = {
"type": "object",
"required": ["action"],
"properties": {
"action": {"type": "string", "minLength": 1},
"target": {"type": ["string", "null"]},
"optional": {"type": "boolean"},
"label": {"type": "string"},
"selector": {"type": "string"},
"execution": _OBJECT,
"flow_version": {"type": "integer"},
"retry_safe": {"type": "boolean"},
},
}
PRESET_SCHEMA: Dict[str, Any] = {
"type": "object",
"properties": {
"selectors": {"type": "object", "additionalProperties": {"type": ["string", "null"]}},
"workflow": {"type": "array", "items": WORKFLOW_STEP_SCHEMA},
"stealth": {"type": "boolean"},
"stream_config": _OBJECT,
"image_extraction": _OBJECT,
"file_paste": _OBJECT,
"prompt_padding": _OBJECT,
"advanced": _OBJECT,
},
}
SITE_CONFIG_SCHEMA: Dict[str, Any] = {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": ["presets"],
"properties": {
"presets": {"type": "object", "minProperties": 1, "additionalProperties": PRESET_SCHEMA},
"default_preset": {"type": "string", "minLength": 1},
"advanced": _OBJECT,
},
}
GLOBAL_CONFIG_SCHEMA: Dict[str, Any] = {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"selector_definitions": {
"type": "array",
"items": {
"type": "object",
"required": ["key"],
"properties": {
"key": {"type": "string", "minLength": 1},
"description": {"type": "string"},
"enabled": {"type": "boolean"},
"required": {"type": "boolean"},
},
},
},
},
}
SITE_FILE_SCHEMA: Dict[str, Any] = {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": ["schema_version", "site", "config"],
"properties": {
"schema_version": {"const": SITE_FILE_SCHEMA_VERSION},
"site": {"type": "string", "minLength": 1},
"adapter_version": {"type": "string"},
"min_app_version": {"type": "string", "pattern": r"^\d+(\.\d+){0,3}$"},
"last_verified": {"type": "string", "pattern": r"^\d{4}-\d{2}-\d{2}$"},
"config": _OBJECT,
},
}
_VALIDATORS = {
name: Draft202012Validator(schema)
for name, schema in (
("site", SITE_CONFIG_SCHEMA),
("global", GLOBAL_CONFIG_SCHEMA),
("file", SITE_FILE_SCHEMA),
)
}
def _format_path(prefix: str, parts: Iterable[Any]) -> str:
path = prefix
for part in parts:
path += f"[{part}]" if isinstance(part, int) else f".{part}"
return path
def _schema_errors(kind: str, payload: Any, prefix: str) -> List[str]:
errors = sorted(_VALIDATORS[kind].iter_errors(payload), key=lambda e: list(map(str, e.absolute_path)))
return [f"{_format_path(prefix, error.absolute_path)}: {error.message}" for error in errors]
def site_config_errors(site: str, config: Any) -> List[str]:
"""校验单个站点(或 ``_global``)的配置,返回可读的路径级错误列表;空列表表示通过。"""
prefix = f"sites[{site}]"
if site == GLOBAL_KEY:
return _schema_errors("global", config, prefix)
errors = _schema_errors("site", config, prefix)
if not errors and isinstance(config, dict):
default = config.get("default_preset")
presets = config.get("presets") or {}
if default and default not in presets:
errors.append(f"{prefix}.default_preset: '{default}' 不在 presets 中(可选:{', '.join(presets)})")
return errors
def site_file_errors(payload: Any) -> List[str]:
"""校验单站点文件(信封 + config)。"""
errors = _schema_errors("file", payload, "file")
if errors:
return errors
return site_config_errors(payload["site"], payload["config"])
def sites_errors(sites: Any) -> Dict[str, List[str]]:
"""校验整份站点配置字典(旧 sites.json 结构),返回 {站点: [错误...]},只包含有错误的站点。"""
if not isinstance(sites, dict):
return {"*": [f"sites: 应为对象,实际为 {type(sites).__name__}"]}
result: Dict[str, List[str]] = {}
for site, config in sites.items():
errors = site_config_errors(str(site), config)
if errors:
result[str(site)] = errors
return result