precis-cli 0.1.3__py3-none-any.whl

app/cli/shell/commands/ai/delete.py

@@ -0,0 +1,165 @@
+# 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.
+# backend/app/cli/shell/commands/ai/delete.py
+"""
+@fileoverview AI Provider 删除命令模块
+
+功能概述:
+- 提供 ai delete 子命令删除已配置的 AI Provider API Key
+- 支持交互式菜单选择与直接指定 Provider ID 删除
+- 删除前要求用户确认，防止误操作
+
+架构设计:
+- AIDeleteCommand 继承 Command 基类
+- execute() 根据是否有参数决定交互式删除或直接删除
+- 通过 CLI 配置管理器删除 Provider 配置
+
+输入示例:
+    ai delete
+    ai delete openai
+
+输出示例:
+    CommandResult.ok("API Key 已删除")
+    CommandResult.error("没有已配置的 API Key")
+"""
+
+from app.cli.shell.commands.base import Command, CommandResult, ProjectContext
+from app.cli.shell.config_storage import get_cli_config
+from app.cli.shell.formatter import Colors, Formatter
+from app.cli.shell.interactive_menu import InteractiveMenu
+
+
+class AIDeleteCommand(Command):
+    """删除已配置的 AI Provider API Key 命令。
+
+    支持交互式选择或直接指定 Provider ID 删除。
+    删除前会要求用户确认。
+    """
+
+    def __init__(self) -> None:
+        super().__init__("delete")
+        self._cli_config = get_cli_config()
+
+    @property
+    def description(self) -> str:
+        return "删除 AI Provider"
+
+    @property
+    def usage(self) -> str:
+        return "ai delete [provider_id]"
+
+    @property
+    def help_text(self) -> str:
+        return """
+用法: ai delete [provider_id]
+
+示例:
+  ai delete           # 交互式选择要删除的 Provider
+  ai delete openai   # 直接删除 OpenAI
+
+说明:
+  删除指定的 Provider 配置。
+  使用 'ai status' 查看已配置的 Provider。
+        """.strip()
+
+    def execute(self, args: list[str], context: ProjectContext) -> CommandResult:
+        """执行删除命令。
+
+        Args:
+            args: 命令参数列表，可能包含 Provider ID
+            context: 项目上下文
+
+        Returns:
+            删除成功或失败的结果
+        """
+        providers = self._cli_config.list_providers()
+
+        if not providers:
+            return CommandResult.error("没有已配置的 Provider\n请使用 'ai setup' 进行配置")
+
+        if not args:
+            return self._interactive_delete(providers)
+
+        # 4.4: 大小写不敏感匹配——原实现把参数强转小写后查存储原名（含大写的
+        # provider 恒查不到），交互菜单走原值正常，参数路径自相矛盾
+        raw_id = args[0]
+        provider_id = next(
+            (p.id for p in providers if p.id.lower() == raw_id.lower()),
+            raw_id,
+        )
+        return self._do_delete(provider_id, providers)
+
+    def _interactive_delete(self, providers: list) -> CommandResult:
+        """交互式删除 Provider（支持方向键导航）。
+
+        显示菜单让用户选择要删除的 Provider。
+
+        Args:
+            providers: 已配置的 Provider 列表
+
+        Returns:
+            删除结果或取消结果
+        """
+        print(Formatter.header("\n删除 Provider"))
+
+        menu = InteractiveMenu("请选择要删除的 Provider:")
+
+        for p in providers:
+            label = f"{p.name} ({p.model})"
+            menu.add_item(p.id, label, "")
+
+        menu.add_item("_cancel_", "取消", "返回")
+
+        provider_id = menu.show()
+
+        if provider_id is None or provider_id == "_cancel_":
+            return CommandResult.ok("已取消")
+
+        return self._do_delete(provider_id, providers)
+
+    def _do_delete(self, provider_id: str, providers: list) -> CommandResult:
+        """执行删除操作。
+
+        验证 Provider 存在，然后要求用户确认后删除。
+
+        Args:
+            provider_id: 要删除的 Provider ID
+            providers: 已配置的 Provider 列表
+
+        Returns:
+            删除成功或失败的结果
+        """
+        provider = self._cli_config.get_provider(provider_id)
+        if not provider:
+            return CommandResult.error(f"Provider '{provider_id}' 未配置\n使用 'ai status' 查看已配置的 Provider")
+
+        print(Formatter.warning(f"\n警告: 将删除 {provider.name} ({provider.id})"))
+        print(Formatter.info(f"  模型: {provider.model}\n"))
+
+        try:
+            confirm = input(Formatter.colorize("确认删除? (y/N): ", Colors.YELLOW)).strip().lower()
+        except (KeyboardInterrupt, EOFError):
+            print()
+            return CommandResult.ok("已取消")
+
+        if confirm not in ("y", "yes"):
+            return CommandResult.ok("已取消")
+
+        if self._cli_config.delete_provider(provider_id):
+            print(Formatter.success(f"\n[*] {provider.name} 已删除"))
+            return CommandResult.ok("Provider 已删除")
+        else:
+            return CommandResult.error("删除失败")

app/cli/shell/commands/ai/diff.py

@@ -0,0 +1,70 @@
+# 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.
+# backend/app/cli/shell/commands/ai/diff.py
+"""
+@fileoverview AI 配置变更 Diff 生成模块
+
+功能概述:
+- 使用 Python 标准库 difflib 生成统一差异格式（Unified Diff）
+- 对比文件修改前后的内容，输出类 Git diff 格式
+- 处理行尾换行符，确保 diff 格式标准
+
+架构设计:
+- 独立工具模块，无外部依赖（仅使用标准库 difflib）
+- 被 display.py 调用以展示详细的文件变更对比
+- 统一差异格式（unified diff）是 Git 等版本控制工具使用的标准格式
+
+输入示例:
+    _generate_diff("constraints.yaml", old_content, new_content)
+
+输出示例:
+    "--- a/constraints.yaml\n+++ b/constraints.yaml\n@@ -1,3 +1,4 @@..."
+"""
+
+from __future__ import annotations
+
+import difflib
+from pathlib import Path
+
+
+def _generate_diff(file_path: str, old_content: str, new_content: str) -> str:
+    """生成文件的 diff 显示。
+
+    使用 Python 标准库 difflib.unified_diff 生成统一差异格式（Unified Diff），
+    这是 Git 等版本控制工具使用的标准格式。
+
+    Args:
+        file_path: 文件路径（用于显示文件名）
+        old_content: 修改前的文件内容
+        new_content: 修改后的文件内容
+
+    Returns:
+        统一差异格式的字符串
+    """
+    from_line = old_content.splitlines(keepends=True) if old_content else []
+    to_line = new_content.splitlines(keepends=True) if new_content else []
+
+    # 确保最后一行以换行符结尾，否则 diff 格式不标准
+    if from_line and not from_line[-1].endswith("\n"):
+        from_line[-1] += "\n"
+    if to_line and not to_line[-1].endswith("\n"):
+        to_line[-1] += "\n"
+
+    diff = difflib.unified_diff(
+        from_line, to_line, fromfile=f"a/{Path(file_path).name}", tofile=f"b/{Path(file_path).name}", lineterm="\n"
+    )
+
+    return "".join(diff)

app/cli/shell/commands/ai/display.py

@@ -0,0 +1,428 @@
+# 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.
+# backend/app/cli/shell/commands/ai/display.py
+"""
+@fileoverview AI 执行结果展示模块
+
+功能概述:
+- 显示 AI 修改文件的 diff 摘要与详细对比
+- 区分新增、删除、修改三种文件状态并用颜色高亮
+- 展示约束操作结果与数据校验结果（通过/失败）
+
+架构设计:
+- _show_diff_summary(): 显示文件变更摘要，询问是否查看详细 diff
+- _display_detailed_diff(): 使用颜色高亮显示详细 diff 内容
+- _display_execution_results(): 主入口，判断是否有文件修改并决定展示方式
+- _display_results_without_diff(): 无文件修改时的结果展示（如仅执行校验）
+- _display_constraint_results(): 分类显示校验结果与约束操作结果
+
+输入示例:
+    _display_execution_results(result, "/path/to/project", original_files_cache)
+
+输出示例:
+    带颜色高亮的 diff 与操作结果文本
+"""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from app.cli.shell.formatter import Colors, Formatter
+from app.shared.services.ai.chat_orchestrator import ChatExecutionResult
+from app.shared.services.llm.actions.validation_types import action_display_name
+
+from .diff import _generate_diff
+
+logger = logging.getLogger(__name__)
+
+
+# 工具名到中文标签的映射（与 ChatAgentRunner._TOOL_LABELS 保持一致）
+_TOOL_LABELS = {
+    "read_project": "读取项目",
+    "read_table": "查看数据",
+    "apply_actions": "修改配置",
+    "validate_table": "校验数据",
+    "read_canvas": "读取画布",
+}
+
+
+def _display_tool_trail(tool_steps: list[dict]) -> None:
+    """显示 Agent 工具调用轨迹。
+
+    在 CLI 交互模式下，当 AI 使用 Agent 工具循环完成查-改-验后，
+    输出简要的工具步骤摘要，让用户感知 AI 的思考与操作路径。
+
+    Args:
+        tool_steps: ChatAgentRunResult.tool_steps 列表，每个元素含 tool/label/turn/action_count/status
+    """
+    if not tool_steps:
+        return
+
+    print(Formatter.header("\n🔧 Agent 工具轨迹"))
+    for step in tool_steps:
+        label = step.get("label") or _TOOL_LABELS.get(step.get("tool", ""), step.get("tool", "未知"))
+        action_count = step.get("action_count")
+        status = step.get("status", "success")
+        error = step.get("error")
+
+        count_str = f"({action_count})" if action_count else ""
+        status_marker = "✓" if status == "success" else "✗" if status == "failed" else "•"
+        line = f"  {status_marker} {label}{count_str}"
+        if error:
+            line += f" — {error}"
+        print(Formatter.info(line))
+
+
+def _show_diff_summary(changed_files: dict[str, tuple[str, str]]) -> bool:
+    """显示修改文件的 diff 摘要，并询问用户是否查看详细 diff。
+
+    对每份修改的文件显示状态：新增（绿色）、删除（红色）、修改（黄色）。
+
+    Args:
+        changed_files: 字典，键为文件路径，值为 (旧内容, 新内容) 元组
+
+    Returns:
+        用户是否选择查看详细 diff
+    """
+    if not changed_files:
+        return False
+
+    print(Formatter.header("\n📋 修改文件摘要"))
+    print("=" * 50)
+
+    for file_path, (old_content, new_content) in changed_files.items():
+        rel_path = Path(file_path).name
+        if old_content == "":
+            status = "新增"
+            color = Colors.GREEN
+        elif new_content == "":
+            status = "删除"
+            color = Colors.RED
+        else:
+            old_lines = len(old_content.splitlines())
+            new_lines = len(new_content.splitlines())
+            if old_lines == new_lines:
+                status = "修改"
+            else:
+                status = f"修改 ({old_lines} → {new_lines} 行)"
+            color = Colors.YELLOW
+
+        print(f"  {Formatter.colorize(status, color)}: {rel_path}")
+
+    print("=" * 50)
+
+    try:
+        response = input(Formatter.colorize("\n查看详细 diff? (y/N): ", Colors.YELLOW)).strip().lower()
+        return response in ("y", "yes")
+    except (KeyboardInterrupt, EOFError):
+        print()
+        return False
+
+
+def _display_detailed_diff(changed_files: dict[str, tuple[str, str]]) -> None:
+    """显示详细的 diff 内容。
+
+    对 diff 的每一行进行颜色高亮：
+    - 绿色：新增的行（以 + 开头）
+    - 红色：删除的行（以 - 开头）
+    - 青色：行号信息（以 @@ 开头）
+    - 灰色：文件头信息（以 --- 或 +++ 开头）
+
+    Args:
+        changed_files: 字典，键为文件路径，值为 (旧内容, 新内容) 元组
+    """
+    print(Formatter.header("\n📄 详细 Diff"))
+    print("=" * 70)
+
+    has_diff = False
+    for file_path, (old_content, new_content) in changed_files.items():
+        diff_text = _generate_diff(file_path, old_content, new_content)
+        if diff_text:
+            has_diff = True
+            rel_path = Path(file_path).name
+            print(f"\n{Formatter.colorize('▶', Colors.CYAN)} {rel_path}")
+            print("-" * 50)
+
+            for line in diff_text.splitlines():
+                if line.startswith("+"):
+                    print(Formatter.colorize(line, Colors.GREEN))
+                elif line.startswith("-"):
+                    print(Formatter.colorize(line, Colors.RED))
+                elif line.startswith("@@"):
+                    print(Formatter.colorize(line, Colors.CYAN))
+                elif line.startswith("---") or line.startswith("+++"):
+                    print(Formatter.dim(line))
+                else:
+                    print(line)
+
+    if not has_diff:
+        print(Formatter.dim("  无内容变更"))
+
+    print("\n" + "=" * 70)
+
+
+def _display_execution_results(
+    result: ChatExecutionResult,
+    project_path: str,
+    original_files_cache: dict[str, str] | None = None,
+) -> None:
+    """显示执行结果（CLI 交互模式）并处理 diff。
+
+    判断 AI 返回的动作是否包含约束节点的增删改操作。
+    如果有文件修改，则对比原始缓存生成 diff 并展示；
+    如果没有文件修改（如仅执行校验），则只显示校验结果。
+
+    Args:
+        result: AIChatOrchestrator 的执行结果对象
+        project_path: 项目路径
+        original_files_cache: 原始文件内容缓存，用于 diff 对比
+    """
+    actions = result.actions
+    original_files_cache = original_files_cache or {}
+
+    # 判断是否有会修改文件的操作
+    file_modification_types = {
+        "ADD_CONSTRAINT_NODE",
+        "UPDATE_CONSTRAINT_NODE",
+        "DELETE_CONSTRAINT_NODE",
+        "ADD_SCHEMA",
+        "UPDATE_SCHEMA",
+        "DELETE_SCHEMA",
+        "ADD_REGEX",
+        "UPDATE_REGEX",
+        "DELETE_REGEX",
+        "ADD_TRANSFORM",
+        "UPDATE_TRANSFORM",
+        "DELETE_TRANSFORM",
+        "UPDATE_SETTINGS",
+    }
+    has_modifications = any(a.get("actionType") in file_modification_types for a in actions)
+
+    if not has_modifications:
+        _display_results_without_diff(result)
+        return
+
+    # 使用 orchestrator 已经执行的结果，避免重复执行 process_actions
+    results = getattr(result, "action_results", [])
+
+    # 收集修改后的文件内容，与原始缓存对比找出变更
+    changed_files = {}
+    for file_path, old_content in original_files_cache.items():
+        try:
+            if Path(file_path).exists():
+                new_content = Path(file_path).read_text(encoding="utf-8")
+            else:
+                new_content = ""
+            if old_content != new_content:
+                changed_files[file_path] = (old_content, new_content)
+        except Exception:
+            logger.error("读取文件内容失败", exc_info=True)
+
+    _display_constraint_results(results)
+
+    if changed_files and _show_diff_summary(changed_files):
+        _display_detailed_diff(changed_files)
+
+
+def _display_results_without_diff(result: ChatExecutionResult) -> None:
+    """显示没有修改操作的结果（仅校验等）。
+
+    当 AI 的动作不涉及文件修改时（如 VALIDATE_PROJECT），
+    直接显示校验结果而不进行 diff 对比。
+
+    Args:
+        result: AIChatOrchestrator 的执行结果对象
+    """
+    results = getattr(result, "action_results", [])
+    _display_constraint_results(results)
+
+
+def _format_validate_table_display(table_filter: str | list[str] | None) -> str:
+    """根据校验的 table_filter 推导出用于展示的"表"描述文案。
+
+    校验结果详情（validate_details）里的 table_filter 才是真实信息源：
+    - None/空 → 全量校验
+    - 字符串 → 单表校验
+    - 列表 → 多表校验
+
+    Args:
+        table_filter: validate_executor 返回的 details.table_filter 值
+
+    Returns:
+        适合直接拼接进 "✓ 表 '...' 数据校验通过" 的描述文案
+    """
+    # 全量校验（None 或空字符串/空列表）
+    if not table_filter:
+        return "全部表"
+    # 单表（字符串）
+    if isinstance(table_filter, str):
+        return table_filter
+    # 列表形式
+    tables = [t for t in table_filter if t]
+    if not tables:
+        return "全部表"
+    if len(tables) == 1:
+        return tables[0]
+    return f"{len(tables)} 张表（{', '.join(tables)}）"
+
+
+def _display_constraint_results(results: list[dict]) -> None:
+    """显示操作结果。
+
+    将动作结果分为四类：
+    1. VALIDATE_PROJECT：数据校验结果
+    2. 约束操作：约束 CRUD 结果
+    3. Schema/Regex/Transform/Settings 操作
+    4. 其他操作
+
+    Args:
+        results: 动作执行结果列表，每个元素是一个字典
+    """
+    constraint_types = {"ADD_CONSTRAINT_NODE", "UPDATE_CONSTRAINT_NODE", "DELETE_CONSTRAINT_NODE"}
+    schema_types = {"ADD_SCHEMA", "UPDATE_SCHEMA", "DELETE_SCHEMA"}
+    regex_types = {"ADD_REGEX", "UPDATE_REGEX", "DELETE_REGEX"}
+    transform_types = {"ADD_TRANSFORM", "UPDATE_TRANSFORM", "DELETE_TRANSFORM"}
+
+    # 分离各类结果
+    validate_results = [r for r in results if r.get("action", {}).get("actionType") == "VALIDATE_PROJECT"]
+    constraint_results = [r for r in results if r.get("action", {}).get("actionType") in constraint_types]
+    schema_results = [r for r in results if r.get("action", {}).get("actionType") in schema_types]
+    regex_results = [r for r in results if r.get("action", {}).get("actionType") in regex_types]
+    transform_results = [r for r in results if r.get("action", {}).get("actionType") in transform_types]
+    settings_results = [r for r in results if r.get("action", {}).get("actionType") == "UPDATE_SETTINGS"]
+
+    # 显示校验结果
+    for r in validate_results:
+        msg = r.get("message", "")
+        details = r.get("validate_details", {})
+        has_errors = details.get("has_errors", False) if details else False
+        # 展示文案优先取 action.constraintSpec 里的"原始表名"（用户友好）：
+        # - 多表：spec.tables（表名列表）
+        # - 单表：spec.tableName（表名，resolver 解析后仍保留原名）
+        # - 全量：两者都没有 → fallback 到 validate_details.table_filter（None）
+        # 注意：validate_details.table_filter 在 resolver 解析后会变成"表 ID"（加密串），
+        # 直接展示对用户不友好，故仅作兜底。
+        spec = r.get("action", {}).get("constraintSpec", {}) or {}
+        raw_tables = spec.get("tables")
+        if isinstance(raw_tables, list) and raw_tables:
+            table_display = _format_validate_table_display(raw_tables)
+        else:
+            single_name = spec.get("tableName")
+            fallback = single_name or (details.get("table_filter") if details else None)
+            table_display = _format_validate_table_display(fallback)
+
+        if has_errors:
+            print(Formatter.warning("\n" + "=" * 50))
+            print(Formatter.warning(f"⚠ 表 '{table_display}' 数据校验发现问题"))
+            print(Formatter.warning("=" * 50))
+            print(msg)
+            print("=" * 50)
+        else:
+            print(Formatter.success("\n" + "=" * 50))
+            print(Formatter.success(f"✓ 表 '{table_display}' 数据校验通过"))
+            print(Formatter.success(f"  耗时: {details.get('duration_ms', 0)}ms"))
+            print(Formatter.success("=" * 50))
+
+    # 显示约束操作结果
+    if constraint_results:
+        if all(r.get("success") for r in constraint_results):
+            print(Formatter.success("\n" + "=" * 50))
+            print(Formatter.success("✓ 约束操作成功"))
+            print(Formatter.success("=" * 50))
+
+            for r in constraint_results:
+                msg = r.get("message", "N/A")
+                action = r.get("action", {})
+                spec = action.get("constraintSpec", {})
+                is_inline = spec.get("isInline", False)
+                constraint_type = spec.get("type", "N/A")
+                table_name = spec.get("tableName", "未知表")
+                column_name = spec.get("targetColumn", "N/A")
+                params = spec.get("params", {})
+
+                print("\n  约束配置详情:")
+                print(f"    - 类型: {constraint_type}")
+                print(f"    - 目标表: {table_name}")
+                print(f"    - 目标列: {column_name}")
+
+                if params:
+                    print(f"    - 参数: {params}")
+
+                if is_inline:
+                    print("    - 存储方式: 内联约束（存储在表配置中）")
+                else:
+                    constraint_id = msg.replace("inline:", "") if msg.startswith("inline:") else msg
+                    print("    - 存储方式: 独立约束文件")
+                    print(f"    - 文件路径: constraints/{constraint_id}.constraint.yaml")
+
+            print("\n" + "=" * 50)
+        else:
+            print(Formatter.error("\n" + "=" * 50))
+            print(Formatter.error("✗ 约束操作失败"))
+            print(Formatter.error("=" * 50))
+            for r in constraint_results:
+                if not r.get("success"):
+                    msg = r.get("message", "未知错误")
+                    print(f"  - 错误: {msg}")
+            print("=" * 50)
+
+    # 显示 Schema 操作结果
+    if schema_results:
+        print(Formatter.header("\n📋 Schema 操作"))
+        for r in schema_results:
+            action_type = r.get("action", {}).get("actionType", "")
+            spec = r.get("action", {}).get("schemaSpec", {})
+            name = spec.get("name", spec.get("schemaId", "未知"))
+            if r.get("success"):
+                print(Formatter.success(f"  ✓ {action_display_name(action_type)}: {name}"))
+            else:
+                print(Formatter.error(f"  ✗ {action_display_name(action_type)}: {name} - {r.get('message', '')}"))
+
+    # 显示 Regex 操作结果
+    if regex_results:
+        print(Formatter.header("\n🔤 Regex 操作"))
+        for r in regex_results:
+            action_type = r.get("action", {}).get("actionType", "")
+            spec = r.get("action", {}).get("regexSpec", {})
+            name = spec.get("name", spec.get("regexId", "未知"))
+            if r.get("success"):
+                print(Formatter.success(f"  ✓ {action_display_name(action_type)}: {name}"))
+            else:
+                print(Formatter.error(f"  ✗ {action_display_name(action_type)}: {name} - {r.get('message', '')}"))
+
+    # 显示 Transform 操作结果
+    if transform_results:
+        print(Formatter.header("\n⚙ Transform 操作"))
+        for r in transform_results:
+            action_type = r.get("action", {}).get("actionType", "")
+            spec = r.get("action", {}).get("transformSpec", {})
+            t_type = spec.get("type", spec.get("transformId", "未知"))
+            if r.get("success"):
+                print(Formatter.success(f"  ✓ {action_display_name(action_type)}: {t_type}"))
+            else:
+                print(Formatter.error(f"  ✗ {action_display_name(action_type)}: {t_type} - {r.get('message', '')}"))
+
+    # 显示 Settings 操作结果
+    if settings_results:
+        print(Formatter.header("\n⚙ 项目设置"))
+        for r in settings_results:
+            spec = r.get("action", {}).get("settingsSpec", {})
+            category = spec.get("category", "未知")
+            if r.get("success"):
+                print(Formatter.success(f"  ✓ 更新设置: {category}"))
+            else:
+                print(Formatter.error(f"  ✗ 更新设置失败: {r.get('message', '')}"))