初始提交

2026-07-24 09:43:10 +08:00
commit b5b4721456
793 changed files with 116305 additions and 0 deletions
@@ -0,0 +1,83 @@
+from typing import Any
+
+
+class CompletionCommandPresenter:
+    """
+    completion 命令文本渲染器。
+
+    该渲染器负责将 `completion` 命令组产生的结构化 payload 转换为稳定的文本摘要，
+    同时保持 JSON 输出仍由控制器直接返回，不在此处做契约变形。
+    """
+
+    def build_completion_doctor_text(self, payload: dict[str, Any]) -> str:
+        """
+        将 completion 诊断结果渲染为文本摘要。
+
+        :param payload: completion 诊断结果字典
+        :return: 文本摘要
+        """
+        lines = [
+            f'ok: {str(payload.get("ok", False)).lower()}',
+            f'message: {payload.get("message", "-")}',
+            f'active_shell: {payload.get("activeShell") or "-"}',
+            f'project_dir: {payload.get("projectDir", "-")}',
+            f'complete_env_var: {payload.get("completeEnvVar", "-")}',
+        ]
+        if payload.get('recommendedInstallCommand'):
+            lines.append(f'recommended_install_command: {payload.get("recommendedInstallCommand")}')
+        env_choices = payload.get('envChoices')
+        if isinstance(env_choices, list) and env_choices:
+            lines.append('env_choices:')
+            lines.extend(f'  - {env_name}' for env_name in env_choices)
+        shells = payload.get('shells')
+        if isinstance(shells, dict) and shells:
+            lines.append('shells:')
+            for shell_name, shell_payload in shells.items():
+                if not isinstance(shell_payload, dict):
+                    continue
+                lines.extend(
+                    [
+                        f'  {shell_name}:',
+                        f'    supported: {str(shell_payload.get("supported", False)).lower()}',
+                        f'    detected: {str(shell_payload.get("detected", False)).lower()}',
+                        f'    target_file: {shell_payload.get("targetFile", "-")}',
+                        f'    target_file_exists: {str(shell_payload.get("targetFileExists", False)).lower()}',
+                        f'    rc_file: {shell_payload.get("rcFile", "-") or "-"}',
+                        f'    rc_file_exists: {str(shell_payload.get("rcFileExists", False)).lower()}',
+                        f'    auto_discovery: {str(shell_payload.get("autoDiscovery", False)).lower()}',
+                        f'    source_command: {shell_payload.get("sourceCommand", "-")}',
+                        f'    recommended_install_command: {shell_payload.get("recommendedInstallCommand", "-")}',
+                    ]
+                )
+        return '\n'.join(lines)
+
+    @staticmethod
+    def build_completion_install_text(payload: dict[str, Any]) -> str:
+        """
+        将 completion 安装结果渲染为文本摘要。
+
+        :param payload: completion 安装结果字典
+        :return: 文本摘要
+        """
+        lines = [
+            f'ok: {str(payload.get("ok", False)).lower()}',
+            f'message: {payload.get("message", "-")}',
+            f'shell: {payload.get("shell", "-")}',
+        ]
+        field_label_mapping = {
+            'detectedShell': 'detected_shell',
+            'targetFile': 'target_file',
+            'activated': 'activated',
+            'activateRequested': 'activate_requested',
+            'rcFile': 'rc_file',
+            'rcFileUpdated': 'rc_file_updated',
+            'sourceCommand': 'source_command',
+            'autoDiscovery': 'auto_discovery',
+            'activationRequired': 'activation_required',
+            'nextStep': 'next_step',
+            'completeEnvVar': 'complete_env_var',
+        }
+        for field_name, field_label in field_label_mapping.items():
+            if field_name in payload:
+                lines.append(f'{field_label}: {payload.get(field_name)}')
+        return '\n'.join(lines)