precis-cli 0.1.6__tar.gz → 0.1.8__tar.gz

{precis_cli-0.1.6/precis_cli.egg-info → precis_cli-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: precis-cli
-Version: 0.1.6
+Version: 0.1.8
 Summary: Precis - 可配置数据校验工具 CLI（校验 CSV/Excel/JSON 数据质量）
 Author: Precis Team
 License: Apache-2.0

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/dependencies.py

@@ -36,6 +36,7 @@
 
 # backend/app/api/dependencies.py
 import os
+from urllib.parse import quote, unquote
 
 from fastapi import Depends, Header, HTTPException
 
@@ -65,6 +66,44 @@ class ProjectStore:
         self.project_path = project_path
 
 
+def _decode_header_path(value: str) -> str:
+    """还原 HTTP header 携带的非 ASCII 路径。
+
+    两种线上契约并存，按特征识别、互不干扰：
+
+    1. GUI 契约（axios/fetch）：前端在出口处对路径做 encodeURIComponent（纯
+       ASCII 百分号转义）。浏览器 XHR/fetch 的 header 值只接受 ByteString
+       （ISO-8859-1），中文原值会被 XHR 直接拒绝；axios 1.18 的
+       toByteStringHeaderValue 还会把 latin1 之外的字符静默删除——不转义的
+       中文路径会以"删字后的错误路径"上线且无从在服务端还原。判定是否为
+       规范转义串用 round-trip 校验（quote(unquote(v)) == v），字面上含 % 的
+       合法路径通常不会被误解码（例外：字面 "%XX" 恰为合法 UTF-8 转义序列
+       的路径会被还原，随后走校验链报错而非指向任意目录）。round-trip 的
+       转义集必须与 encodeURIComponent 的不转义集对齐：JS 保留
+       `!'()*` 五字符原样上线，校验端 quote 的 safe 集须包含它们，否则含
+       括号/感叹号的中文路径（如 `D:/项目(备份)`）契约判定必败，被契约 2
+       原样放行后以百分号串走校验链 400/404。
+    2. TUI/脚本契约（reqwest FromBytes、curl 等）：UTF-8 原始字节按 obs-text
+       上线。ASGI 服务器把 header 字节按 latin-1 解码成乱码，latin-1 与字节流
+       双射，编码回字节再按 UTF-8 解码即可无损还原；非 UTF-8 字节保持原值，
+       交由后续校验链正常报错。
+    """
+    # 契约 1：规范百分号转义（GUI）。safe 集对齐 encodeURIComponent 的保留集
+    # （`!'()*`），Python quote 恒不转义字母数字与 `_.-~`，两者已一致
+    if "%" in value:
+        try:
+            decoded = unquote(value, errors="strict")
+        except UnicodeDecodeError:
+            decoded = None
+        if decoded is not None and decoded != value and quote(decoded, safe="!'()*") == value:
+            return decoded
+    # 契约 2：UTF-8 原始字节（TUI/脚本）
+    try:
+        return value.encode("latin-1").decode("utf-8")
+    except (UnicodeEncodeError, UnicodeDecodeError):
+        return value
+
+
 async def get_project_config_path(
     x_project_config_path: str = Header(..., description="项目根目录的绝对路径（须含 project.precis.yaml）"),
 ) -> str:
@@ -121,6 +160,9 @@ def _validate_project_root(raw_path: str | None) -> str:
     """
     if not raw_path:
         raise HTTPException(status_code=400, detail="X-Project-Config-Path header 不能为空。")
+    # 还原 header 编码乱码（见 _decode_header_path）：中文路径经 UTF-8 上线、
+    # latin-1 解码后 isdir 必失败，必须先还原再做后续校验
+    raw_path = _decode_header_path(raw_path)
     # 步骤1：先校验原始输入是否为绝对路径
     # 在 Windows 下，os.path.abspath 会把相对路径（如 "../project"）解析成绝对路径，
     # 导致后续 isabs 检查无法拒绝相对路径。因此必须在规范化之前先做判断。

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/models/full_validation.py

@@ -438,6 +438,12 @@ class FullValidationErrorItem(BaseModel):
     source_sheet: str | None = Field(
         default=None, description="配置文件内定义的 Excel Sheet 名（可选）"
     )  # schema 配置中 source.sheet 定义的 Excel 工作表名称，可选
+    error_code: str | None = Field(
+        default=None, description="稳定错误码（UPPER_SNAKE），供前端映射 i18n key 按当前语言渲染"
+    )  # 与 message 同时给出：message 为后端默认语言的兜底文案
+    error_params: dict | None = Field(
+        default=None, description="错误码对应的插值参数（JSON 标量），如 {column: 'Total'}"
+    )  # 供前端 t(key, params) 插值
 
 
 class ValidationPassedItem(BaseModel):

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/models/validation.py

@@ -257,6 +257,12 @@ class ValidationErrorRow(BaseModel):
     error_message: str | None = Field(
         None, description="错误信息"
     )  # 校验失败的具体错误描述，如"值不在允许列表中"，可选
+    error_code: str | None = Field(
+        None, description="稳定错误码（UPPER_SNAKE），供前端映射 i18n key 按当前语言渲染"
+    )  # 与 error_message 同时给出：message 为后端默认语言的兜底文案
+    error_params: dict | None = Field(
+        None, description="错误码对应的插值参数（JSON 标量），如 {column: 'Total', row: 1}"
+    )  # 供前端 t(key, params) 插值
 
 
 class ValidationResult(BaseModel):

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/ai/hardware.py

@@ -117,7 +117,11 @@ def diagnose_hardware() -> HardwareDiagnoseResponse:
         import subprocess
 
         result = subprocess.run(
-            ["nvidia-smi", "--query-gpu=name,memory.total", "--format=csv,noheader"], capture_output=True, text=True
+            ["nvidia-smi", "--query-gpu=name,memory.total", "--format=csv,noheader"],
+            capture_output=True,
+            text=True,
+            encoding="utf-8",
+            errors="replace",  # 中文 Windows 下 text=True 默认按 GBK 解码会乱码/抛错
         )
         if result.returncode == 0:
             for line in result.stdout.strip().split("\n"):

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/ai/providers.py

@@ -58,8 +58,10 @@ def _is_configured(p: AIProvider) -> bool:
     """判断 Provider 是否已配置。
 
     loader.load() 已完成 env-var 覆盖，直接检查 api_key 即可。
-    本地 Provider（Ollama）不需要 API Key。
+    本地 Provider（Ollama）不需要 API Key；fake 是确定性测试 Provider，永不依赖 key。
     """
+    if p.type == ProviderType.FAKE:
+        return True
     if p.deployment == DeploymentType.LOCAL:
         return bool(p.base_url)
     return bool(p.api_key and p.api_key.strip())
@@ -141,7 +143,7 @@ providers:
     type: openai
     base_url: https://api.deepseek.com
     api_key: ${DEEPSEEK_API_KEY}
-    model: deepseek-v4-pro
+    model: deepseek-flash
 
   # 本地 Ollama（无需 API Key）
   - id: ollama-local
@@ -391,7 +393,10 @@ async def create_provider(req: CreateProviderRequest) -> ProviderResponse:
     try:
         provider_type = ProviderType(req.type)
     except ValueError:
-        raise HTTPException(400, detail=f"不支持的 AI 服务类型「{req.type}」，目前仅支持 openai、ollama 两种接入方式")
+        raise HTTPException(
+            400,
+            detail=f"不支持的 AI 服务类型「{req.type}」，目前支持 openai、ollama 两种接入方式（fake 仅用于测试演练）",
+        )
 
     _validate_base_url(req.base_url)  # SSRF 防护
 

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/ai/utils.py

@@ -138,12 +138,19 @@ def expand_paths(
 
     数据文件类型：.xlsx, .xls, .csv, .json, .jsonl
     """
+    # 还原 header 线上编码（GUI 契约 percent-encode / TUI 原始 UTF-8 字节，见
+    # app.api.dependencies._decode_header_path）：前端出口统一转义后，未解码的
+    # 百分号串作 base 解析相对路径会全 miss，中文项目下静默返回空列表
+    from app.api.dependencies import _decode_header_path
+
+    base_path = _decode_header_path(x_project_config_path) if x_project_config_path else None
+
     result = []
     seen = set()
 
     for raw_path in paths:
         # 1. 解析为绝对路径
-        path = _resolve_path(raw_path, x_project_config_path)
+        path = _resolve_path(raw_path, base_path)
 
         # 2. 如果是目录，递归展开
         if os.path.isdir(path):

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/core/data_sources.py

@@ -86,7 +86,7 @@ def load_workspace_config(project_root: str) -> dict[str, Any]:
         }
 
     try:
-        with open(config_path, encoding="utf-8") as f:
+        with open(config_path, encoding="utf-8-sig") as f:
             return yaml.safe_load(f) or {}
     except Exception as e:
         raise HTTPException(

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/core/reporting.py

@@ -223,7 +223,7 @@ def get_reporting_config(store: ProjectStore = Depends(get_project_store)) -> Re
         )
     try:
         # 读取并解析 YAML 配置文件
-        with open(config_path, encoding="utf-8") as f:
+        with open(config_path, encoding="utf-8-sig") as f:
             config_data = yaml.safe_load(f)
         return ReportingConfig(**config_data)
     except Exception as e:

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/preview/header_row.py

@@ -106,7 +106,7 @@ def handle_header_row_changed(
 
             if os.path.exists(schema_path):
                 try:
-                    with open(schema_path, encoding="utf-8") as f:
+                    with open(schema_path, encoding="utf-8-sig") as f:
                         schema_content = yaml.safe_load(f)
 
                     if "header_row" not in schema_content:

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/project/helpers.py

@@ -67,7 +67,7 @@ def _load_yaml_file(path: str) -> dict:
     if not os.path.isfile(path):
         return {}
     try:
-        with open(path, encoding="utf-8") as f:
+        with open(path, encoding="utf-8-sig") as f:
             return yaml.safe_load(f) or {}
     except yaml.YAMLError:
         return {}

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/projects/open.py

@@ -36,7 +36,7 @@ def _get_project_name(project_path: str) -> str:
     """从 project.precis.yaml 中读取项目名称，失败时返回目录名。"""
     manifest_path = os.path.join(project_path, "project.precis.yaml")
     try:
-        with open(manifest_path, encoding="utf-8") as f:
+        with open(manifest_path, encoding="utf-8-sig") as f:
             manifest = yaml.safe_load(f)
         if isinstance(manifest, dict):
             project = manifest.get("project", {})

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/projects/scan.py

@@ -69,7 +69,7 @@ def scan_projects(
 def _parse_project(project_path: str, manifest_path: str) -> ProjectInfo | None:
     """解析单个项目的 manifest 文件获取元信息。"""
     try:
-        with open(manifest_path, encoding="utf-8") as f:
+        with open(manifest_path, encoding="utf-8-sig") as f:
             manifest = yaml.safe_load(f)
     except Exception:
         return None

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/routers/validation/common.py

@@ -189,11 +189,14 @@ def execute_dataframe_validation(
     )
 
     # 将原始错误行列表转换为标准化的 ValidationErrorRow 对象列表
+    # error_code/error_params 透传给前端，供按当前语言渲染错误文案
     error_rows = [
         ValidationErrorRow(
             row_index=err.get("row_index", 0),
             cell_value=str(err.get("cell_value", "")),
             error_message=err.get("error_message"),
+            error_code=err.get("error_code"),
+            error_params=err.get("error_params"),
         )
         for err in result.error_rows
     ]

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/api/services/full_validation_response_builder.py

@@ -150,6 +150,9 @@ class FullValidationResponseBuilder:
                     source_path=err.get("source_path"),
                     source_file=err.get("source_file"),
                     source_sheet=err.get("source_sheet"),
+                    # i18n：稳定错误码 + 插值参数透传，message 保留兜底文案
+                    error_code=err.get("error_code"),
+                    error_params=err.get("error_params"),
                 )
             )
 

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/cli/shared_services/config_ops.py

@@ -371,7 +371,7 @@ def set_config_value_in_file(project_path: str, filename: str, key_path: str, va
     yaml_parser.preserve_quotes = True
 
     try:
-        with open(config_path, encoding="utf-8") as f:
+        with open(config_path, encoding="utf-8-sig") as f:
             data = yaml_parser.load(f)
     except RuamelYAMLError as e:
         return False, f"YAML 解析失败: {e}"
@@ -482,7 +482,7 @@ def load_config_content(project_path: str, filename: str) -> dict | str:
     if not config_path:
         return f"配置文件不存在: {filename}"
     try:
-        with open(config_path, encoding="utf-8") as f:
+        with open(config_path, encoding="utf-8-sig") as f:
             content = yaml.safe_load(f)
             if content:
                 return content if isinstance(content, dict) else str(content)

precis_cli-0.1.8/app/cli/shell/commands/ai/agent_interaction.py

@@ -0,0 +1,210 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Copyright 2026 Precis Team
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""@fileoverview Agent 模式终端交互适配器（CLI）
+
+为 CLI `ai chat`（默认 agent 模式）提供 apply_actions 两阶段确认与 ask_user
+交互问答的终端实现，解开非流式环境的 fail-closed 写盘/提问闸门。
+
+机制与 GUI 流式路径同源：回调在事件循环协程内触发（on_apply_pending /
+on_user_input_requested），此处打印摘要后在独立 daemon 线程阻塞读终端输入，
+经 pending interaction store 线程安全 resolve 唤醒挂起的 await_decision() /
+await_response()。超时（5 分钟）由 controller 兜底自动 reject/skip。
+"""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+import threading
+from typing import Any
+
+from app.cli.shell.commands.ai.executor_utils import SpinnerController
+from app.cli.shell.formatter import Formatter
+from app.shared.services.ai.agent.chat_tools.apply_actions import ApplyCallbacks
+from app.shared.services.ai.agent.chat_tools.ask_user import AskCallbacks
+
+logger = logging.getLogger(__name__)
+
+# 终端 diff 展示上限：超长 diff 只显示前 N 行，避免刷屏（完整内容在 dry-run 文件里）
+_MAX_DIFF_LINES = 30
+
+
+def build_agent_interaction(spinner: SpinnerController | None) -> tuple[ApplyCallbacks, AskCallbacks]:
+    """构建 CLI 终端的 apply/ask 回调集合。
+
+    参数:
+        spinner: CLI 交互模式的 spinner 控制器（None 表示无动画，静默模式）
+
+    返回:
+        (ApplyCallbacks, AskCallbacks)，注入 ChatOptions 后经 ChatAgentRunner 生效
+    """
+
+    def on_apply_pending(payload: dict[str, Any]) -> None:
+        # 回调在事件循环协程内同步触发，捕获运行中的 loop 供工作线程 resolve
+        loop = asyncio.get_running_loop()
+        apply_id = payload.get("apply_id", "")
+        if spinner:
+            spinner.pause()
+        _print_apply_summary(payload)
+
+        def _worker() -> None:
+            decision = _read_apply_decision()
+            try:
+                future = asyncio.run_coroutine_threadsafe(_resolve_apply(apply_id, decision), loop)
+                future.result(timeout=10)
+            except Exception:
+                logger.exception("[agent-confirm] 终端确认 resolve 失败: apply_id=%s", apply_id)
+            finally:
+                if spinner:
+                    spinner.resume()
+
+        threading.Thread(target=_worker, daemon=True, name="agent-apply-confirm").start()
+
+    def on_user_input_requested(payload: dict[str, Any]) -> None:
+        loop = asyncio.get_running_loop()
+        ask_id = payload.get("ask_id", "")
+        if spinner:
+            spinner.pause()
+        _print_ask_question(payload)
+
+        def _worker() -> None:
+            response = _read_ask_response(payload)
+            try:
+                future = asyncio.run_coroutine_threadsafe(_resolve_ask(ask_id, response), loop)
+                future.result(timeout=10)
+            except Exception:
+                logger.exception("[agent-ask] 终端问答 resolve 失败: ask_id=%s", ask_id)
+            finally:
+                if spinner:
+                    spinner.resume()
+
+        threading.Thread(target=_worker, daemon=True, name="agent-ask-input").start()
+
+    apply_callbacks = ApplyCallbacks(on_apply_pending=on_apply_pending)
+    ask_callbacks = AskCallbacks(on_user_input_requested=on_user_input_requested)
+    return apply_callbacks, ask_callbacks
+
+
+async def _resolve_apply(apply_id: str, decision: str) -> None:
+    """按 apply_id 从全局 store 取 controller 并写入决策（幂等）。"""
+    # 延迟导入与 apply_actions._run_two_phase 一致（避免 streaming 包初始化链循环导入）
+    from app.shared.services.ai.streaming.pending_interaction_store import (
+        ConfirmController,
+        get_global_pending_interaction_store,
+    )
+
+    controller = get_global_pending_interaction_store().get(apply_id)
+    if isinstance(controller, ConfirmController):
+        await controller.resolve(decision)
+
+
+async def _resolve_ask(ask_id: str, response: dict[str, Any]) -> None:
+    from app.shared.services.ai.streaming.pending_interaction_store import (
+        InteractionController,
+        get_global_pending_interaction_store,
+    )
+
+    controller = get_global_pending_interaction_store().get(ask_id)
+    if isinstance(controller, InteractionController):
+        await controller.resolve(response)
+
+
+def _print_apply_summary(payload: dict[str, Any]) -> None:
+    """打印写盘计划摘要：文件清单 + 状态 + 截断 diff + 汇总行。"""
+    files = payload.get("files") or []
+    print(Formatter.warning(f"\nAI 请求写入 {len(files)} 个文件："))
+    for f in files:
+        status = f.get("status", "?")
+        path = f.get("path", "?")
+        print(f"  [{status}] {path}")
+        diff = (f.get("diff") or "").strip()
+        if diff:
+            diff_lines = diff.splitlines()
+            shown = diff_lines[:_MAX_DIFF_LINES]
+            for line in shown:
+                print(f"      {line}")
+            if len(diff_lines) > _MAX_DIFF_LINES:
+                print(f"      ...（共 {len(diff_lines)} 行，已截断）")
+    summary = payload.get("summary")
+    if summary:
+        print(Formatter.info(f"  摘要: {summary}"))
+
+
+def _read_apply_decision() -> str:
+    """读取 y/n 决策；空输入与非 y 输入一律 reject（写盘默认保守）。"""
+    try:
+        raw = input(Formatter.warning("确认写入以上变更？[y/N]: ")).strip().lower()
+    except EOFError:
+        return "reject"
+    return "confirm" if raw in ("y", "yes", "是") else "reject"
+
+
+def _print_ask_question(payload: dict[str, Any]) -> None:
+    print(Formatter.warning(f"\nAI 提问: {payload.get('prompt', '')}"))
+    options = payload.get("options")
+    if isinstance(options, list) and options:
+        for idx, opt in enumerate(options, start=1):
+            print(f"  {idx}. {opt}")
+    if payload.get("optional"):
+        print(Formatter.info("  （直接回车跳过此问题）"))
+
+
+def _read_ask_response(payload: dict[str, Any]) -> dict[str, Any]:
+    """按 question_type 读取终端回答，构造 AskResponseBody 形态。
+
+    形态与前端 AskUserCard 一致：{answer: str|num|bool|str[]} / {skipped: true, reason}。
+    """
+    question_type = payload.get("question_type", "free_text")
+    optional = bool(payload.get("optional"))
+    try:
+        if question_type == "confirm":
+            raw = input("[y/N]: ").strip().lower()
+            return {"answer": raw in ("y", "yes", "是")}
+        if question_type == "choice":
+            options = payload.get("options") or []
+            raw = input(("(多选，逗号分隔) " if payload.get("multiple") else "") + "选项编号: ").strip()
+            if not raw and optional:
+                return {"skipped": True, "reason": "user_skipped"}
+            indexes = [part.strip() for part in raw.split(",") if part.strip()]
+            picked: list[str] = []
+            for part in indexes:
+                if part.isdigit() and 1 <= int(part) <= len(options):
+                    picked.append(str(options[int(part) - 1]))
+                else:
+                    picked.append(part)
+            if payload.get("multiple"):
+                return {"answer": picked}
+            return {"answer": picked[0] if picked else ""}
+        if question_type == "value":
+            value_type = payload.get("value_type", "string")
+            raw = input(f"输入值({value_type}): ").strip()
+            if not raw and optional:
+                return {"skipped": True, "reason": "user_skipped"}
+            if value_type in ("integer", "float"):
+                try:
+                    return {"answer": float(raw) if value_type == "float" else int(raw)}
+                except ValueError:
+                    return {"answer": raw}
+            if value_type == "boolean":
+                return {"answer": raw.lower() in ("y", "yes", "true", "1", "是")}
+            return {"answer": raw}
+        # free_text
+        raw = input("回答: ").strip()
+        if not raw and optional:
+            return {"skipped": True, "reason": "user_skipped"}
+        return {"answer": raw}
+    except EOFError:
+        return {"skipped": True, "reason": "eof"}

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/cli/shell/commands/ai/chat.py

@@ -275,6 +275,8 @@ AI 助手帮助
   - ForeignKey: 外键约束 (如: "关联到 orders 表的 user_id 列")
   - Conditional: 条件约束 (如: "如果 type 等于 A 则值为 B")
   - DateLogic: 日期逻辑约束 (如: "日期晚于 2023-01-01")
+  - Charset: 字符集约束 (如: "该列只能包含中文")
+  - Composite: 复合约束 (如: "该列必须非空且唯一")
         """
         print(Formatter.info(help_text))
 

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/cli/shell/commands/ai/executor.py

@@ -125,6 +125,15 @@ def execute_ai_chat(
     context_window = resolve_context_window(provider_config)
     max_history_tokens, _output_budget = compute_token_budgets(context_window)
 
+    # Agent 模式终端交互：注入 apply/ask 回调解开 fail-closed 写盘/提问闸门
+    # （非交互或 legacy JSON 路径不需要——legacy 走 confirm_callback 确认门）
+    agent_apply_callbacks = None
+    agent_ask_callbacks = None
+    if interactive and agent_mode:
+        from app.cli.shell.commands.ai.agent_interaction import build_agent_interaction
+
+        agent_apply_callbacks, agent_ask_callbacks = build_agent_interaction(spinner)
+
     # 配置对话选项
     options = ChatOptions(
         history=history or [],
@@ -137,6 +146,9 @@ def execute_ai_chat(
         agent_mode=agent_mode,
         max_agent_iterations=5,
         canvas_nodes=[],
+        apply_callbacks=agent_apply_callbacks,
+        ask_callbacks=agent_ask_callbacks,
+        dry_run_enabled=agent_apply_callbacks is not None,
     )
 
     try:

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/cli/shell/commands/provider.py

@@ -576,7 +576,7 @@ providers:
     type: openai
     base_url: https://api.deepseek.com
     api_key: sk-xxx
-    model: deepseek-v4-flash
+    model: deepseek-flash
 
   # 本地 Ollama（无需 API Key）
   - id: ollama-local

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/cli/shell/commands/validate.py

@@ -111,6 +111,39 @@ def _parse_standalone_args(args: list[str]) -> dict:
     return result
 
 
+def _extract_settings(project_config: dict | None) -> tuple[dict, dict]:
+    """从清单 dump 中提取 (validation, script_security) 设置。
+
+    兼容两种形态：标准清单 dump（settings 嵌套在 "settings" 键下，open 命令
+    的 project_config 即此形态）与直接以 settings 内容为顶层的形态。
+    旧实现读顶层 "validation"/"script_security" 在标准形态下恒 miss。
+    """
+    if not project_config:
+        return {}, {}
+    settings = project_config.get("settings")
+    if isinstance(settings, dict):
+        return settings.get("validation") or {}, settings.get("script_security") or {}
+    return project_config.get("validation") or {}, project_config.get("script_security") or {}
+
+
+def _load_manifest_settings(manifest_path: str) -> tuple[dict, dict]:
+    """轻量读取清单 YAML 的 settings 段，供 standalone 模式使用。
+
+    不做完整模型加载（executor 内部自会加载并报告真正的解析错误）；
+    文件不可读/非 dict 结构时静默回退默认设置。
+    """
+    try:
+        import yaml
+
+        with open(manifest_path, encoding="utf-8") as f:
+            data = yaml.safe_load(f) or {}
+    except Exception:
+        return {}, {}
+    if not isinstance(data, dict):
+        return {}, {}
+    return _extract_settings(data)
+
+
 def _find_dangling_option(args: list[str]) -> str | None:
     """检测缺值的 standalone 选项（尾部悬挂或值位置是下一个选项）。
 
@@ -236,9 +269,9 @@ class ValidateCommand(Command):
         manifest_path = os.path.join(project_path, "project.precis.yaml")
         data_dir = project_path
 
-        # 从项目配置中读取设置
-        validation_settings = context.project_config.get("validation", {}) if context.project_config else {}
-        script_security = context.project_config.get("script_security", {}) if context.project_config else {}
+        # 从项目配置中读取设置（settings 嵌套在清单 dump 的 "settings" 键下；
+        # 旧实现读顶层 "validation" 恒 miss，REPL 模式的 timeout/error_handling 实际从未生效）
+        validation_settings, script_security = _extract_settings(context.project_config)
 
         return self._run_validation(
             manifest_path,
@@ -255,7 +288,8 @@ class ValidateCommand(Command):
         """Standalone 模式执行校验。
 
         直接从命令行参数获取路径，不依赖项目上下文。
-        使用默认设置（timeout=30, 安全沙箱）。
+        读取清单内 settings（validation/script_security），缺省回退默认值
+        （timeout=30 / continue / 安全沙箱）。
 
         Args:
             parsed: 解析后的参数字典，包含 manifest/data_directory/table/format/report
@@ -294,8 +328,14 @@ class ValidateCommand(Command):
 
         table_name = parsed["table"]
 
-        # standalone 模式使用默认设置
-        return self._run_validation(manifest_path, data_dir, table_name, {}, {}, output_format, parsed["report"])
+        # standalone 模式同样读取清单内的 settings（插件/CI 场景改 YAML 的
+        # timeout/error_handling 由此生效；旧实现传空 settings 导致配置被忽略，
+        # 与 SKILL.md "调整超时/错误处理" 的指引矛盾）。清单不可读时退回默认值，
+        # 真正的解析错误由 executor 加载阶段报告。
+        validation_settings, script_security = _load_manifest_settings(manifest_path)
+        return self._run_validation(
+            manifest_path, data_dir, table_name, validation_settings, script_security, output_format, parsed["report"]
+        )
 
     def _run_validation(
         self,

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/shared/core/io/yaml.py

@@ -162,7 +162,9 @@ def read_yaml(path: Path) -> dict[str, Any]:
     :raises FileNotFoundError: 当指定路径的文件不存在时抛出
     :raises yaml.YAMLError: 当 YAML 格式错误时抛出
     """
-    with open(path, encoding="utf-8") as f:
+    # utf-8-sig：兼容记事本等编辑器保存的"UTF-8 带 BOM"（BOM 若混入会被
+    # yaml 误认Control Character抛错）；无 BOM 时解码行为与 utf-8 完全一致
+    with open(path, encoding="utf-8-sig") as f:
         return cast(dict[str, Any], yaml.safe_load(f))
 
 

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/shared/core/project/constraint/registry.py

@@ -100,6 +100,10 @@ CONSTRAINT_TYPE_ALIASES: dict[str, str] = {
     # 日期逻辑约束别名
     "datelogic": "DateLogic",
     "date_logic": "DateLogic",
+    # 字符集约束别名
+    "charset": "Charset",
+    # 复合约束别名
+    "composite": "Composite",
 }
 
 

{precis_cli-0.1.6 → precis_cli-0.1.8}/app/shared/core/reporter/reporters/__init__.py

@@ -27,7 +27,7 @@
 
 输入示例:
     从外部导入所需的报告器:
-    from backend.app.shared.core.reporter.reporters import (
+    from app.shared.core.reporter.reporters import (
         Reporter,           # 抽象基类，用于自定义报告器
         LocalFileReporter,  # 本地文件报告器
         EmailReporter,      # 邮件报告器