"""工具服务配置(全部可通过环境变量覆盖,便于一键部署与离线迁移)。""" from __future__ import annotations import os from dataclasses import dataclass, field from pathlib import Path def _env(name: str, default: str) -> str: value = os.environ.get(name) return value if value not in (None, "") else default @dataclass class Settings: """运行时设置。""" #: 数据根目录(对象库、台账、处理产物都放在这里) data_dir: Path = field(default_factory=lambda: Path(_env("CDA_DATA_DIR", "data"))) host: str = field(default_factory=lambda: _env("CDA_TOOLS_HOST", "127.0.0.1")) port: int = field(default_factory=lambda: int(_env("CDA_TOOLS_PORT", "8788"))) #: data_read 单次返回行数上限 max_rows: int = field(default_factory=lambda: int(_env("CDA_MAX_ROWS", "200"))) query_timeout_ms: int = field(default_factory=lambda: int(_env("CDA_QUERY_TIMEOUT_MS", "5000"))) query_max_offset: int = field(default_factory=lambda: int(_env("CDA_QUERY_MAX_OFFSET", "10000"))) query_max_bytes: int = field(default_factory=lambda: int(_env("CDA_QUERY_MAX_BYTES", "1048576"))) #: 单文件上传上限(字节) max_upload_bytes: int = field(default_factory=lambda: int(_env("CDA_MAX_UPLOAD_MB", "512")) * 1024 * 1024) #: 台账 JSONL 是否落盘 ledger_jsonl: bool = field(default_factory=lambda: _env("CDA_LEDGER_JSONL", "1") == "1") @property def db_path(self) -> Path: return self.data_dir / "app.sqlite" @property def objects_dir(self) -> Path: return self.data_dir / "objects" @property def runs_dir(self) -> Path: return self.data_dir / "runs" @property def ledger_path(self) -> Path: return self.data_dir / "ledger.jsonl" def ensure(self) -> None: for path in (self.data_dir, self.objects_dir, self.runs_dir): path.mkdir(parents=True, exist_ok=True) settings = Settings()