- checks.py:确定性检查(find_zero_length / find_duplicate_entities 传 window + 纯 Python 派生空文字、未闭合多段线)。问题带 source=deterministic,handle 来自 工具/数据本身,不依赖 LLM 回忆 - findings.py:解析 LLM 的 JSON 结论 + handle 交叉校验(引用未知 handle 时保留问题、 剥掉 handle、verified=False)+ findings 装配 - config.py:新增 DETERMINISTIC_CHECKS / VALIDATE_HANDLES / CHECK_UNCLOSED_POLYLINES 开关与 ZERO_LENGTH_TOLERANCE / DUP_TOLERANCE / DUP_GROUP_LIMIT 实机验证:find_zero_length / find_duplicate_entities 的 window 参数在基座上生效 (schema 未声明,C++ 侧 parseCommonQuery 实际支持)。
127 lines
5.4 KiB
Python
127 lines
5.4 KiB
Python
"""集中配置:全部来自环境变量,禁止硬编码密钥。
|
||
|
||
用法:所有模块统一 `from . import config` 后读取 config.XXX。
|
||
"""
|
||
|
||
import os
|
||
from pathlib import Path
|
||
|
||
# 仓库根目录(本文件位于 <root>/dwg_review/config.py)
|
||
PROJECT_ROOT = Path(__file__).resolve().parent.parent
|
||
|
||
|
||
def _resolve_path(value: str) -> Path:
|
||
"""相对路径按仓库根目录解析(避免依赖当前工作目录)。"""
|
||
p = Path(value)
|
||
return p if p.is_absolute() else (PROJECT_ROOT / p)
|
||
|
||
|
||
def _read_env(name: str) -> str:
|
||
"""读取环境变量。
|
||
|
||
Windows 下新设置的系统/用户环境变量不会传播到**已启动**的进程,
|
||
因此当前进程读不到时,回退到注册表中的 Machine / User 级环境变量。
|
||
"""
|
||
value = os.environ.get(name)
|
||
if value:
|
||
return value
|
||
if os.name != "nt":
|
||
return ""
|
||
try:
|
||
import winreg
|
||
except ImportError: # pragma: no cover
|
||
return ""
|
||
locations = (
|
||
(winreg.HKEY_LOCAL_MACHINE,
|
||
r"SYSTEM\CurrentControlSet\Control\Session Manager\Environment"),
|
||
(winreg.HKEY_CURRENT_USER, r"Environment"),
|
||
)
|
||
for hive, subkey in locations:
|
||
try:
|
||
with winreg.OpenKey(hive, subkey) as key:
|
||
value, _ = winreg.QueryValueEx(key, name)
|
||
if value:
|
||
return str(value)
|
||
except OSError:
|
||
continue
|
||
return ""
|
||
|
||
|
||
def _read_bool(name: str, default: bool = True) -> bool:
|
||
"""读取布尔型环境变量;未设置或空串时返回 default。"""
|
||
value = os.environ.get(name)
|
||
if value is None or value.strip() == "":
|
||
return default
|
||
return value.strip().lower() in ("1", "true", "yes", "on")
|
||
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# CAD MCP 基座(TCP JSON-RPC)
|
||
# ---------------------------------------------------------------------------
|
||
HOST = os.environ.get("CAD_MCP_HOST", "127.0.0.1")
|
||
PORT = int(os.environ.get("CAD_MCP_PORT", "8080"))
|
||
|
||
# 单次 TCP 调用超时(秒)
|
||
CALL_TIMEOUT = float(os.environ.get("CAD_MCP_TIMEOUT", "30"))
|
||
# 连接/超时类错误的重试次数(写类工具不重试)
|
||
CALL_RETRIES = int(os.environ.get("CAD_MCP_RETRIES", "2"))
|
||
# 帧大小上限(与基座 8MB 上限对齐,留余量)
|
||
MAX_FRAME_BYTES = int(os.environ.get("MAX_FRAME_BYTES", str(4 * 1024 * 1024)))
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# LLM(默认 DeepSeek,视觉模型 deepseek-flash)
|
||
# ---------------------------------------------------------------------------
|
||
API_KEY = _read_env("DEEPSEEK_API_KEY")
|
||
BASE_URL = os.environ.get("DEEPSEEK_BASE_URL", "https://api.deepseek.com")
|
||
MODEL_NAME = os.environ.get("DEEPSEEK_MODEL", "deepseek-flash")
|
||
LLM_TIMEOUT = float(os.environ.get("LLM_TIMEOUT", "120"))
|
||
LLM_RETRIES = int(os.environ.get("LLM_RETRIES", "2"))
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# 审查流程
|
||
# ---------------------------------------------------------------------------
|
||
# 审查清单路径
|
||
CHECKLIST_PATH = _resolve_path(os.environ.get("REVIEW_CHECKLIST", "review_checklist.json"))
|
||
# 最多审查多少个图框(0 = 全部)
|
||
MAX_FRAMES = int(os.environ.get("MAX_FRAMES", "0"))
|
||
# 每个图框取数据的条数上限
|
||
FRAME_ENTITY_LIMIT = int(os.environ.get("FRAME_ENTITY_LIMIT", "200"))
|
||
# 缩放后等待 CAD 渲染的秒数
|
||
RENDER_WAIT = float(os.environ.get("RENDER_WAIT", "0.6"))
|
||
# 审查阶段受控工具子循环的最大回合数
|
||
REVIEW_MAX_ITERS = int(os.environ.get("REVIEW_MAX_ITERS", "4"))
|
||
# 报告输出目录
|
||
REPORT_DIR = _resolve_path(os.environ.get("REPORT_DIR", "reports"))
|
||
# 批注回写使用的图层
|
||
ANNOTATE_LAYER = os.environ.get("ANNOTATE_LAYER", "AI_REVIEW")
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# 可信度三件套:确定性检查前置 / 结论结构化 / 证据交叉校验
|
||
# ---------------------------------------------------------------------------
|
||
# 是否在 LLM 审查前跑确定性检查(零长度、重复实体、空文字、未闭合多段线)
|
||
DETERMINISTIC_CHECKS = _read_bool("DETERMINISTIC_CHECKS", True)
|
||
# 是否校验 LLM 引用的 handle 确实出现在已采集证据中(不在则剥掉 handle)
|
||
VALIDATE_HANDLES = _read_bool("VALIDATE_HANDLES", True)
|
||
# 是否检查未闭合多段线(中心线/开放轮廓多时误报,可关闭)
|
||
CHECK_UNCLOSED_POLYLINES = _read_bool("CHECK_UNCLOSED_POLYLINES", True)
|
||
# find_zero_length 的长度阈值
|
||
ZERO_LENGTH_TOLERANCE = float(os.environ.get("ZERO_LENGTH_TOLERANCE", "0.001"))
|
||
# find_duplicate_entities 的几何量化容差
|
||
DUP_TOLERANCE = float(os.environ.get("DUP_TOLERANCE", "0.001"))
|
||
# find_duplicate_entities 的 limit(语义是「最大重复组数」,非条目数)
|
||
DUP_GROUP_LIMIT = int(os.environ.get("DUP_GROUP_LIMIT", "50"))
|
||
|
||
# ---------------------------------------------------------------------------
|
||
# 截图(视觉 token 成本控制)
|
||
# ---------------------------------------------------------------------------
|
||
# 长边上限(超过才缩放),0 表示不缩放
|
||
IMAGE_MAX_EDGE = int(os.environ.get("IMAGE_MAX_EDGE", "1280"))
|
||
# 缩放后的输出格式:png(默认,无损,适合 CAD 线稿)或 jpeg(体积更小)
|
||
IMAGE_FORMAT = os.environ.get("IMAGE_FORMAT", "png").strip().lower()
|
||
# JPEG 质量(仅 IMAGE_FORMAT=jpeg 时生效)
|
||
IMAGE_JPEG_QUALITY = int(os.environ.get("IMAGE_JPEG_QUALITY", "80"))
|
||
|
||
|
||
def has_api_key() -> bool:
|
||
return bool(API_KEY.strip())
|