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

{precis_cli-0.1.5 → precis_cli-0.1.6}/MANIFEST.in

@@ -1,3 +1,2 @@
 include README.md
 include pyproject.toml
-recursive-include app *.yaml

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

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

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

@@ -41,6 +41,7 @@
 from __future__ import annotations
 
 import logging
+import math
 import os
 import tempfile
 from collections.abc import Iterator
@@ -207,6 +208,10 @@ def resolve_config_file(project_path: str, filename: str | None) -> tuple[str |
 def get_by_dotpath(data: dict, key_path: str) -> tuple[bool, Any]:
     """按点号路径从字典中查找值。
 
+    YAML 键可为非字符串（如 ``2024:`` 解析为 int、``true:`` 解析为 bool）——
+    路径段除精确匹配外也按字符串形态匹配非字符串键，防止"键存在却查不到"
+    进而被 set 侧写出同形态影子键。
+
     Args:
         data: 配置字典
         key_path: 点号路径，如 "project.name"
@@ -217,8 +222,16 @@ def get_by_dotpath(data: dict, key_path: str) -> tuple[bool, Any]:
     keys = key_path.split(".")
     value: Any = data
     for key in keys:
-        if isinstance(value, dict) and key in value:
-            value = value[key]
+        if isinstance(value, dict):
+            if key in value:
+                value = value[key]
+                continue
+            for k, v in value.items():
+                if not isinstance(k, str) and str(k) == key:
+                    value = v
+                    break
+            else:
+                return False, None
         else:
             return False, None
     return True, value
@@ -227,7 +240,8 @@ def get_by_dotpath(data: dict, key_path: str) -> tuple[bool, Any]:
 def set_by_dotpath(data: dict, key_path: str, value: Any) -> dict:
     """按点号路径写入值，返回新 data（不改原 dict）。
 
-    中间层级不存在时自动创建空字典。
+    中间层级不存在时自动创建空字典；路径段与既有非字符串键（如 int ``2024``）
+    字符串形态相同时复用原键，防止写出同形态影子键并存。
 
     Args:
         data: 原配置字典（不会被修改）
@@ -244,10 +258,21 @@ def set_by_dotpath(data: dict, key_path: str, value: Any) -> dict:
     keys = key_path.split(".")
     current = new_data
     for key in keys[:-1]:
-        if key not in current or not isinstance(current[key], dict):
-            current[key] = {}
-        current = current[key]
-    current[keys[-1]] = value
+        existing = current.get(key)
+        if isinstance(existing, dict):
+            current = existing
+            continue
+        # 同形态非字符串键复用（写原键而非另建字符串影子键）
+        non_str_key = next((k for k in current if not isinstance(k, str) and str(k) == key), None)
+        if non_str_key is not None and isinstance(current[non_str_key], dict):
+            current = current[non_str_key]
+            continue
+        target = non_str_key if non_str_key is not None else key
+        current[target] = {}
+        current = current[target]
+    leaf = keys[-1]
+    leaf_key = next((k for k in current if not isinstance(k, str) and str(k) == leaf), leaf)
+    current[leaf_key] = value
     return new_data
 
 
@@ -267,8 +292,9 @@ def parse_config_value(value_str: str) -> tuple[bool, Any, str]:
         value_str: 原始字符串值
 
     Returns:
-        (成功, 转换后的值, 错误信息)；本实现始终成功，错误信息为空字符串。
-        保留 tuple 三元组以匹配接口契约，便于未来扩展严格模式。
+        (成功, 转换后的值, 错误信息)；毒化字面量（inf/nan/下划线整数等
+        无法被下游安全消费的数值形态）返回 (False, None, 错误信息)，
+        调用方应拒绝落盘。
     """
     # 尝试布尔值
     if value_str.lower() == "true":
@@ -278,17 +304,24 @@ def parse_config_value(value_str: str) -> tuple[bool, Any, str]:
     if value_str.lower() == "null" or value_str.lower() == "none":
         return True, None, ""
 
-    # 尝试整数
-    try:
-        return True, int(value_str), ""
-    except ValueError:
-        pass
+    # 尝试整数：拒绝 Python 下划线字面量（'1_0' 静默变 10 会毒化下游数值读取）
+    if "_" not in value_str:
+        try:
+            return True, int(value_str), ""
+        except ValueError:
+            pass
 
-    # 尝试浮点数
-    try:
-        return True, float(value_str), ""
-    except ValueError:
-        pass
+    # 尝试浮点数：拒绝非有限值（inf/nan/溢出 1e999）与下划线字面量——
+    # timeout_seconds: .inf 落盘后 validate 侧 int(inf) 抛 OverflowError，项目从此无法校验
+    if "_" not in value_str:
+        try:
+            parsed_float = float(value_str)
+        except ValueError:
+            parsed_float = None
+        if parsed_float is not None:
+            if not math.isfinite(parsed_float):
+                return False, None, f"不接受非有限数值: {value_str}（inf/nan 落盘会使项目无法校验）"
+            return True, parsed_float, ""
 
     # 去除引号
     if (value_str.startswith('"') and value_str.endswith('"')) or (

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shared_services/generation_ops.py

@@ -36,6 +36,7 @@ from __future__ import annotations
 import glob
 import logging
 import os
+import re
 from pathlib import Path
 from typing import Any
 
@@ -46,6 +47,25 @@ logger = logging.getLogger(__name__)
 # 支持的文件扩展名（generate/migrate 共用）
 SUPPORTED_EXTENSIONS = (".xlsx", ".xls", ".csv", ".json", ".jsonl")
 
+# 实体 id 安全白名单：字母/数字/下划线/连字符（H10——LLM 生成的 id 未消毒即拼盘
+# 路径时，`../../evil` 类路径成分可越项目写文件/建目录，写盘前须拒绝）
+_SAFE_ENTITY_ID_RE = re.compile(r"[A-Za-z0-9_-]+")
+
+
+def _filter_safe_entity_ids(entities: dict[str, Any], kind: str) -> dict[str, Any]:
+    """过滤掉含路径成分或非法字符的实体 id，记录错误日志（H10）。
+
+    Returns:
+        仅保留安全 id 的实体字典；非法 id 整体跳过（不写盘、不进 manifest 引用）
+    """
+    safe: dict[str, Any] = {}
+    for eid, body in entities.items():
+        if isinstance(eid, str) and _SAFE_ENTITY_ID_RE.fullmatch(eid):
+            safe[eid] = body
+        else:
+            logger.error("跳过非法实体 id（含路径成分或非法字符，kind=%s）: %r", kind, eid)
+    return safe
+
 
 def scan_data_files(patterns: list[str], project_path: str) -> list[str]:
     """展开数据文件路径（支持通配符、相对路径、data/ 目录扫描）。
@@ -91,8 +111,9 @@ def scan_data_files(patterns: list[str], project_path: str) -> list[str]:
 def apply_generated_config(result: dict[str, Any], project_path: str) -> list[str]:
     """将生成的配置写入项目目录。
 
-    会保留现有 project.precis.yaml 中的 transforms/manual_data 等引用，
-    覆盖写入 schemas、constraints、regex_nodes。
+    保留策略为并集（R6）：生成 manifest 未携带的既有顶层键（project/settings/
+    templates/data_sources 等）一律保留，防止空/局部 manifest 清空既有配置；
+    schemas、constraints、regex_nodes 引用则始终按生成结果覆盖写入。
 
     Args:
         result: ConfigGenerationService / ConfigMigrationService 返回的配置字典
@@ -111,16 +132,24 @@ def apply_generated_config(result: dict[str, Any], project_path: str) -> list[st
         except Exception:
             logger.warning("读取现有 manifest 失败，将覆盖写入", exc_info=True)
 
-    manifest = result.get("manifest") or {"version": 2, "project": {"id": "", "name": ""}}
-
-    # 保留现有 manifest 中生成未覆盖的引用
-    for key in ("transforms", "manual_data"):
-        if key in existing_manifest and key not in manifest:
-            manifest[key] = existing_manifest[key]
-
-    schemas = result.get("schemas", {})
-    constraints = result.get("constraints", {})
-    regex_nodes = result.get("regex_nodes", {})
+    generated_manifest = result.get("manifest")
+    if generated_manifest:
+        manifest = dict(generated_manifest)
+    else:
+        # LLM 未返回 manifest：以现有 manifest 为底仅补最小骨架，
+        # 不再制造空 project 兜底清空既有 project.id/settings（R6）
+        manifest = dict(existing_manifest)
+        manifest.setdefault("version", 2)
+        manifest.setdefault("project", {"id": "", "name": ""})
+
+    # 保留策略并集（R6）：生成 manifest 未携带的既有键一律保留
+    for key, value in existing_manifest.items():
+        if key not in manifest:
+            manifest[key] = value
+
+    schemas = _filter_safe_entity_ids(result.get("schemas", {}) or {}, "schema")
+    constraints = _filter_safe_entity_ids(result.get("constraints", {}) or {}, "constraint")
+    regex_nodes = _filter_safe_entity_ids(result.get("regex_nodes", {}) or {}, "regex")
 
     # 确保目录存在
     (Path(project_path) / "schemas").mkdir(exist_ok=True)

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shared_services/project_ops.py

@@ -51,10 +51,25 @@ HISTORY_FILE = os.path.expanduser("~/.precis_project_history")
 MAX_HISTORY = 10
 
 
+def _backup_corrupt_history() -> None:
+    """把损坏的历史文件改名备份（.corrupt.bak），失败仅记日志。
+
+    原实现在 JSON 损坏后静默按空历史继续——下次保存直接覆盖，
+    用户历史不可恢复；备份保留现场供手工抢救。
+    """
+    try:
+        backup = f"{HISTORY_FILE}.corrupt.bak"
+        os.replace(HISTORY_FILE, backup)
+        logger.warning("项目历史文件损坏，已备份到 %s 并从空历史继续", backup)
+    except OSError:
+        logger.error("备份损坏的项目历史文件失败: %s", HISTORY_FILE, exc_info=True)
+
+
 def load_history() -> list[dict]:
     """加载项目打开历史。
 
     从 HISTORY_FILE 读取历史记录。文件不存在、格式损坏或权限不足时返回空列表。
+    JSON 损坏时先把原文件备份为 ``*.corrupt.bak`` 再按空历史继续（不静默清零）。
 
     Returns:
         历史记录列表，每个元素为包含 path 和 last_opened 的字典
@@ -78,7 +93,8 @@ def load_history() -> list[dict]:
                 return valid
             return []
     except json.JSONDecodeError:
-        # JSON 格式损坏，返回空列表
+        # JSON 格式损坏：备份后按空历史继续
+        _backup_corrupt_history()
         return []
     except PermissionError:
         # 无权限读取，返回空列表
@@ -91,7 +107,8 @@ def load_history() -> list[dict]:
 def _save_history(history: list[dict]) -> None:
     """保存项目打开历史。
 
-    将历史记录写入 HISTORY_FILE。保存失败仅记录日志，不阻断主流程。
+    原子写（临时文件 + os.replace）：进程中断不会留下半截 JSON——
+    半截文件在下次 load 即被判损坏。保存失败仅记录日志，不阻断主流程。
 
     Args:
         history: 历史记录列表
@@ -99,8 +116,10 @@ def _save_history(history: list[dict]) -> None:
     try:
         # 确保目录存在（用户主目录）
         os.makedirs(os.path.dirname(HISTORY_FILE), exist_ok=True)
-        with open(HISTORY_FILE, "w", encoding="utf-8") as f:
+        tmp_file = f"{HISTORY_FILE}.tmp"
+        with open(tmp_file, "w", encoding="utf-8") as f:
             json.dump(history, f, ensure_ascii=False, indent=2)
+        os.replace(tmp_file, HISTORY_FILE)
     except (PermissionError, OSError):
         # 保存失败时记录错误日志，但不阻断主流程
         logger.error("保存项目历史记录失败", exc_info=True)

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

@@ -258,8 +258,6 @@ AI 助手帮助
   qq           - 直接退出整个程序（全局可用）
 
 启动选项:
-    --stream         - 启用流式输出
-    --no-stream      - 禁用流式输出（默认，显示 loading spinner）
     --no-agent-mode  - 关闭 Agent 深度模式（降级为旧 JSON actions 路径）
 
 你可以用自然语言描述你的需求，例如:

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/ai/generate.py

@@ -53,6 +53,7 @@ from app.cli.shared_services.generation_ops import (
 )
 from app.cli.shell.commands.base import Command, CommandResult, ProjectContext
 from app.cli.shell.formatter import Formatter
+from app.shared.core.utils.path_utils import display_relpath
 from app.shared.services.llm.generation import (
     ConfigGenerationService,
     GenerationOptions,
@@ -200,7 +201,7 @@ class AIGenerateCommand(Command):
         print(Formatter.info(f"迭代次数: {max_iterations}"))
         print(Formatter.info("数据文件:"))
         for p in file_paths:
-            print(f"  - {os.path.relpath(p, project_path)}")
+            print(f"  - {display_relpath(p, project_path)}")
 
         def progress_callback(stage: str, progress: float, extra: dict[str, Any] | None = None) -> None:
             """终端进度回调。"""

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/ai/migrate.py

@@ -51,6 +51,7 @@ from app.cli.shared_services.generation_ops import (
 )
 from app.cli.shell.commands.base import Command, CommandResult, ProjectContext
 from app.cli.shell.formatter import Formatter
+from app.shared.core.utils.path_utils import display_relpath
 from app.shared.services.ai.migrate_service import ConfigMigrationService
 from app.shared.services.llm.generation import (
     GenerationOptions,
@@ -72,6 +73,10 @@ def _infer_language(file_path: str) -> str:
     return "natural_language"
 
 
+# --language 可选值（与 usage 声明一致）
+_SUPPORTED_LANGUAGES = ("python", "sql", "excel_formula", "natural_language")
+
+
 class AIMigrateCommand(Command):
     """AI 配置迁移命令。
 
@@ -171,6 +176,9 @@ class AIMigrateCommand(Command):
 
         if language is None:
             language = _infer_language(script_path)
+        elif language not in _SUPPORTED_LANGUAGES:
+            # 枚举校验：非法值前置拒绝（usage 已声明可选值），不透传下游晦涩报错
+            return CommandResult.error(f"--language 仅支持 {'|'.join(_SUPPORTED_LANGUAGES)}，收到: {language}")
 
         try:
             with open(script_path, encoding="utf-8") as f:
@@ -202,10 +210,10 @@ class AIMigrateCommand(Command):
 
         print(Formatter.header("\nAI 配置迁移"))
         print(Formatter.info(f"项目: {project_name}"))
-        print(Formatter.info(f"脚本: {os.path.relpath(script_path, project_path)} ({language})"))
+        print(Formatter.info(f"脚本: {display_relpath(script_path, project_path)} ({language})"))
         print(Formatter.info("数据文件:"))
         for p in file_paths:
-            print(f"  - {os.path.relpath(p, project_path)}")
+            print(f"  - {display_relpath(p, project_path)}")
 
         def progress_callback(stage: str, progress: float, extra: dict[str, Any] | None = None) -> None:
             """终端进度回调。"""

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/ai/switch.py

@@ -58,19 +58,20 @@ class AISwitchCommand(Command):
 
     @property
     def usage(self) -> str:
-        return "ai switch <provider_id>"
+        return "ai switch [provider_id]"
 
     @property
     def help_text(self) -> str:
         return """
-用法: ai switch <provider_id>
+用法: ai switch [provider_id]
 
 示例:
-  ai switch openai   # 切换到 OpenAI
-  ai switch kimi     # 切换到 Kimi
+  ai switch             # 交互式选择 Provider（方向键导航）
+  ai switch openai      # 切换到 OpenAI
+  ai switch kimi        # 切换到 Kimi
 
 说明:
-  切换到已配置的 Provider。
+  缺省参数时进入交互式选择；传入 provider_id 时直接切换（大小写不敏感）。
   使用 'ai status' 查看可用的 Provider。
         """.strip()
 

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/config/check.py

@@ -104,8 +104,11 @@ class ConfigCheckCommand(Command):
         # 否则验证所有 YAML 文件
         all_files = []
         for root, _, files in os.walk(project_path):
-            # 跳过隐藏目录
-            if any(part.startswith(".") for part in root.split(os.sep)):
+            # 跳过项目内的隐藏子目录（.git 等）——以项目根为基准算相对路径，
+            # 项目自身位于隐藏目录时不受影响（原实现按绝对路径分段判断，
+            # 根目录含点前缀时整个 walk 被跳过，0 文件假绿）
+            rel_root = os.path.relpath(root, project_path)
+            if rel_root != "." and any(part.startswith(".") for part in rel_root.split(os.sep)):
                 continue
             for f in files:
                 if f.endswith((".yaml", ".yml")):
@@ -145,7 +148,9 @@ class ConfigCheckCommand(Command):
             return CommandResult.ok(f"✓ 所有 {valid_count} 个配置文件格式正确")
 
         # 有错误时只显示错误文件（除非指定 --all）
-        output_lines = [f"[bold]\n发现 {invalid_count} 个配置文件格式错误:[/bold]"]
+        # 注意：文案不再内嵌 [bold] 等 rich 标记——CommandResult.error 经
+        # Formatter.print_error 统一转义渲染，内嵌标记会以字面量呈现
+        output_lines = [f"\n发现 {invalid_count} 个配置文件格式错误:"]
         output_lines.extend(results)
         if show_all:
             output_lines.append(f"\n总计: {valid_count} 个有效, {invalid_count} 个无效")

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/config/edit.py

@@ -86,8 +86,9 @@ class ConfigEditCommand(Command):
             # 列出可用的配置文件
             available = []
             for root, _, files in os.walk(project_path):
-                # 跳过隐藏目录
-                if any(part.startswith(".") for part in root.split(os.sep)):
+                # 跳过项目内的隐藏子目录（以项目根为基准，同 config check 修法）
+                rel_root = os.path.relpath(root, project_path)
+                if rel_root != "." and any(part.startswith(".") for part in rel_root.split(os.sep)):
                     continue
                 for f in files:
                     if f.endswith((".yaml", ".yml")):
@@ -103,8 +104,13 @@ class ConfigEditCommand(Command):
         editor = self._get_editor()
 
         try:
+            # EDITOR/VISUAL 可含参数（如 "code -w"、"vim -f"）——shlex 拆分后拼接，
+            # 原样整体当可执行名会在含空格/参数时 FileNotFoundError
+            import shlex
+
+            editor_cmd = shlex.split(editor, posix=(sys.platform != "win32"))
             result = subprocess.run(
-                [editor, config_path],
+                [*editor_cmd, config_path],
                 cwd=project_path,
             )
 

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/config/get.py

@@ -34,11 +34,9 @@
     CommandResult.error("配置项不存在: project.unknown")
 """
 
-import os
-
 import yaml
 
-from app.cli.shared_services.config_ops import get_by_dotpath
+from app.cli.shared_services.config_ops import find_config_file, get_by_dotpath
 from app.cli.shell.commands.base import Command, CommandResult, ProjectContext
 
 
@@ -80,9 +78,11 @@ class ConfigGetCommand(Command):
 
         config_file = args[0]
         key_path = args[1]
-        config_path = os.path.join(project_path, config_file)
+        # 穿越防护与族内其他命令（show/set/check）同源：find_config_file
+        # 统一拒绝绝对路径/.. 引用并做文件名递归回退（原裸 join 是族内唯一残留）
+        config_path = find_config_file(project_path, config_file)
 
-        if not os.path.isfile(config_path):
+        if not config_path:
             return CommandResult.error(f"配置文件不存在: {config_file}")
 
         try:

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/config/set.py

@@ -39,6 +39,8 @@
     CommandResult.error("配置文件不存在: project.precis.yaml")
 """
 
+from typing import Any
+
 from app.cli.shared_services.config_ops import (
     MATCH_BASENAME,
     parse_config_value,
@@ -98,8 +100,13 @@ class ConfigSetCommand(Command):
         value_str = raw_args[2]
 
         # 解析值（委托 shared_services 纯逻辑，CLI/TUI 同源）
-        # parse_config_value 始终成功返回三元组，行为与原 _parse_value 一致
-        value = value_str if as_string else parse_config_value(value_str)[1]
+        # 毒化字面量（inf/nan/下划线整数）被拒绝时按参数错误处理，不落盘
+        if as_string:
+            value: Any = value_str
+        else:
+            parse_ok, value, parse_error = parse_config_value(value_str)
+            if not parse_ok:
+                return CommandResult.error(parse_error)
 
         # 定位结果（用于文件名模糊回退命中时披露实际写入路径）
         resolved_path, match_kind = resolve_config_file(project_path, config_file)

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/commands/config/show.py

@@ -126,7 +126,7 @@ class ConfigShowCommand(Command):
         return CommandResult.ok("\n".join(output_lines))
 
     def _show_single_file(self, config_path: str, config_file: str) -> CommandResult:
-        """显示单个配置文件。
+        """显示单个配置文件（原文输出，H11）。
 
         Args:
             config_path: 文件的完整路径
@@ -134,14 +134,18 @@ class ConfigShowCommand(Command):
 
         Returns:
             文件内容或错误提示
+
+        H11：过去用 PyYAML safe_load+dump 有损重序列化（注释全丢、`007`→`7`），
+        与无参模式/`--string` 的"原样呈现"承诺三方不一致。改为直接读原文输出，
+        与无参模式的 _show_file 同口径。
         """
         try:
             with open(config_path, encoding="utf-8") as f:
-                content = yaml.safe_load(f)
+                raw_text = f.read()
 
             output_lines = [
                 Formatter.header(f"\n{config_file}"),
-                yaml.dump(content, allow_unicode=True, default_flow_style=False),
+                raw_text,
             ]
             return CommandResult.ok("\n".join(output_lines))
         except yaml.YAMLError as e:

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

@@ -111,6 +111,21 @@ def _parse_standalone_args(args: list[str]) -> dict:
     return result
 
 
+def _find_dangling_option(args: list[str]) -> str | None:
+    """检测缺值的 standalone 选项（尾部悬挂或值位置是下一个选项）。
+
+    `validate --table`（尾部悬挂）过去被静默忽略 → 变全表校验；
+    `validate --table --format json` 的值位被下一个选项占据时同理。
+    返回首个悬挂选项名（无则 None），供调用方报参数错误。
+    """
+    for i, arg in enumerate(args):
+        if arg not in _STANDALONE_OPTIONS:
+            continue
+        if i + 1 >= len(args) or args[i + 1] in _STANDALONE_OPTIONS:
+            return arg
+    return None
+
+
 def _split_positional_args(args: list[str]) -> list[str]:
     """剥离 args 中的选项及选项值，返回剩余位置参数。
 
@@ -183,6 +198,10 @@ class ValidateCommand(Command):
         """
         # 检测是否为 standalone 模式
         parsed = _parse_standalone_args(args)
+        # 尾部悬挂选项（缺值）前置拒绝：防 `validate --table` 静默降级为全表校验
+        dangling = _find_dangling_option(args)
+        if dangling:
+            return CommandResult.error(f"{dangling} 需要参数值\n用法: {self.usage}", exit_code=2)
         if parsed["manifest"] is not None:
             return self._execute_standalone(parsed)
 
@@ -203,7 +222,9 @@ class ValidateCommand(Command):
         """
         project_path = context.project_path
         if project_path is None:
-            return CommandResult.error("未打开项目，请先使用 'open <path>' 命令打开项目")
+            # 使用错误（未打开项目）对齐 standalone 各错误路径的 exit_code=2 契约，
+            # 避免 CI 按 0/1/2 分流把工具错误误判为"发现数据违规"
+            return CommandResult.error("未打开项目，请先使用 'open <path>' 命令打开项目", exit_code=2)
 
         # 表名过滤来源优先级：--table/-t 选项 > 首个位置参数 > None（校验全部）
         # 位置参数须先剥离选项及选项值，否则 `validate --table users` 会把 "--table" 当表名

{precis_cli-0.1.5 → precis_cli-0.1.6}/app/cli/shell/formatter.py

@@ -251,11 +251,19 @@ class Formatter:
 
         for i, error in enumerate(errors, 1):
             error_type = error.get("error_type", "UnknownError")
-            message = error.get("message", "无错误信息")
+            # 双字段兼容：格式检查/约束错误经 service 层归一为 cell_value/error_message，
+            # 部分内部路径仍产 value/message（对齐 json_payload.py 的兼容读取）
+            message = error.get("message")
+            if message is None:
+                message = error.get("error_message")
+            if message is None:
+                message = "无错误信息"
             table_name = error.get("table", "")
             column = error.get("column", "")
             row_index = error.get("row_index")
             value = error.get("value")
+            if value is None:
+                value = error.get("cell_value")
 
             type_display = error_type.replace("Violation", "").replace("Error", "")
             type_color = "red" if "Violation" in error_type else "yellow"
@@ -263,15 +271,15 @@ class Formatter:
             lines.append(f"  [bold][{i}][/bold] [{type_color}]【{type_display}】[/{type_color}]")
 
             if table_name:
-                lines.append(f"      表: [cyan]{table_name}[/cyan]")
+                lines.append(f"      表: [cyan]{markup_escape(str(table_name))}[/cyan]")
                 if column:
-                    lines.append(f"      列: [cyan]{column}[/cyan]")
+                    lines.append(f"      列: [cyan]{markup_escape(str(column))}[/cyan]")
                 if row_index is not None:
                     lines.append(f"      行号: [cyan]{row_index}[/cyan]")
                 if value is not None:
-                    lines.append(f"      值: [yellow]{value}[/yellow]")
+                    lines.append(f"      值: [yellow]{markup_escape(str(value))}[/yellow]")
 
-            lines.append(f"      [dim]消息:[/dim] {message}")
+            lines.append(f"      [dim]消息:[/dim] {markup_escape(str(message))}")
             lines.append("")
 
         lines.append("[cyan]" + "═" * 60 + "[/cyan]")
@@ -315,8 +323,8 @@ class Formatter:
             ds = (raw_datasets or {}).get(table)
             row_count = len(ds) if ds is not None and hasattr(ds, "__len__") else "-"
             source = fc.get("source_file") or ""
-            src_hint = f" [dim]({source})[/dim]" if source else ""
-            table_lines.append(f"    {bullet} {table}: {row_count} 行{src_hint}")
+            src_hint = f" [dim]({markup_escape(str(source))})[/dim]" if source else ""
+            table_lines.append(f"    {bullet} {markup_escape(str(table))}: {row_count} 行{src_hint}")
         tables_block = "\n".join(table_lines) if table_lines else "    (无)"
 
         # ---- 约束检查统计 ----
@@ -353,7 +361,7 @@ class Formatter:
                 tag = f"[green]{mark_ok}[/green]" if passed else f"[red]{mark_fail}[/red]"
                 err_cnt = c.get("error_count", 0)
                 err_hint = f" [red]({err_cnt} 错误)[/red]" if err_cnt else ""
-                lines.append(f"    {bullet} {desc}  {tag}{err_hint}")
+                lines.append(f"    {bullet} {markup_escape(str(desc))}  {tag}{err_hint}")
 
         return "\n".join(lines)