super-dev 2.1.1__tar.gz → 2.1.3__tar.gz

{super_dev-2.1.1/super_dev.egg-info → super_dev-2.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: super-dev
-Version: 2.1.1
+Version: 2.1.3
 Summary: Super Dev - Pipeline AI Coding Assistant
 Author-email: Excellent <11964948@qq.com>
 License-Expression: MIT
@@ -60,7 +60,7 @@ Dynamic: license-file
 
 ## 版本
 
-当前版本：`2.1.1`
+当前版本：`2.1.3`
 
 ---
 
@@ -345,13 +345,13 @@ super-dev
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.1.1
+pip install super-dev==2.1.3
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.1.1
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.1.3
 ```
 
 ### 5. 源码开发安装
@@ -479,9 +479,9 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 
 ---
 
-## 20 宿主支持
+## 21 宿主支持
 
-### CLI 宿主（9 个）
+### CLI 宿主（10 个）
 
 | 宿主 | 触发方式 | 安装命令 |
 |------|----------|----------|
@@ -489,6 +489,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 | Codex CLI | `super-dev: 需求` | `super-dev onboard --host codex-cli` |
 | Gemini CLI | `/super-dev 需求` | `super-dev onboard --host gemini-cli` |
 | OpenCode | `/super-dev 需求` | `super-dev onboard --host opencode` |
+| OpenClaw | `/super-dev 需求` | `openclaw plugins install @super-dev/openclaw-plugin` |
 | Kiro CLI | `/super-dev 需求` | `super-dev onboard --host kiro-cli` |
 | Cursor CLI | `/super-dev 需求` | `super-dev onboard --host cursor-cli` |
 | Qoder CLI | `/super-dev 需求` | `super-dev onboard --host qoder-cli` |
@@ -948,6 +949,55 @@ super-dev: 你的需求
 3. 建议先用 `super-dev doctor --host cline` 做一次确认。
 4. 在同一个 Agent Chat 会话里完成整条流水线效果最佳。
 
+#### 21. OpenClaw (原生插件)
+
+OpenClaw 通过原生 Plugin SDK 集成，无需 `super-dev onboard`，直接安装 npm 插件即可。
+
+安装：
+```bash
+# 第一步：安装 super-dev CLI
+pip install super-dev
+
+# 第二步：安装 OpenClaw 插件
+openclaw plugins install @super-dev/openclaw-plugin
+```
+
+触发位置：
+在 OpenClaw Agent 对话面板中，确保当前工作区为目标项目后触发。
+
+触发命令：
+```text
+super-dev: 你的需求
+```
+或
+```text
+/super-dev 你的需求
+```
+
+插件提供 13 个专用 Tool：
+
+| Tool | 功能 |
+|------|------|
+| `super_dev_pipeline` | 启动完整流水线 |
+| `super_dev_init` | 项目初始化 |
+| `super_dev_status` | 查看流水线状态 |
+| `super_dev_quality` | 质量检查（按类型） |
+| `super_dev_spec` | Spec 管理（propose/list/show/scaffold/validate） |
+| `super_dev_config` | 配置管理（list/get/set） |
+| `super_dev_review` | 审查与门禁确认（docs/ui/architecture/quality） |
+| `super_dev_release` | 发布就绪度 / 交付证明包 |
+| `super_dev_expert` | 专家咨询 (10 角色) |
+| `super_dev_deploy` | CI/CD 配置 / Dockerfile / 发布演练 |
+| `super_dev_analyze` | 项目分析（技术栈/依赖/结构） |
+| `super_dev_doctor` | 环境诊断 |
+| `super_dev_run` | 通用命令透传（可选） |
+
+补充说明：
+1. 插件通过 CLI subprocess 桥接调用 `super-dev`，因此必须先 `pip install super-dev`。
+2. 安装后建议重启 OpenClaw Gateway 或新开会话，让 Plugin 和 Skill 生效。
+3. 插件内嵌 SKILL.md，OpenClaw Agent 会自动理解流水线协议。
+4. 使用 `super-dev doctor --host openclaw` 检查集成状态。
+
 ---
 
 ## 关键文档

{super_dev-2.1.1 → super_dev-2.1.3}/README.md

@@ -19,7 +19,7 @@
 
 ## 版本
 
-当前版本：`2.1.1`
+当前版本：`2.1.3`
 
 ---
 
@@ -304,13 +304,13 @@ super-dev
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.1.1
+pip install super-dev==2.1.3
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.1.1
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.1.3
 ```
 
 ### 5. 源码开发安装
@@ -438,9 +438,9 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 
 ---
 
-## 20 宿主支持
+## 21 宿主支持
 
-### CLI 宿主（9 个）
+### CLI 宿主（10 个）
 
 | 宿主 | 触发方式 | 安装命令 |
 |------|----------|----------|
@@ -448,6 +448,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 | Codex CLI | `super-dev: 需求` | `super-dev onboard --host codex-cli` |
 | Gemini CLI | `/super-dev 需求` | `super-dev onboard --host gemini-cli` |
 | OpenCode | `/super-dev 需求` | `super-dev onboard --host opencode` |
+| OpenClaw | `/super-dev 需求` | `openclaw plugins install @super-dev/openclaw-plugin` |
 | Kiro CLI | `/super-dev 需求` | `super-dev onboard --host kiro-cli` |
 | Cursor CLI | `/super-dev 需求` | `super-dev onboard --host cursor-cli` |
 | Qoder CLI | `/super-dev 需求` | `super-dev onboard --host qoder-cli` |
@@ -907,6 +908,55 @@ super-dev: 你的需求
 3. 建议先用 `super-dev doctor --host cline` 做一次确认。
 4. 在同一个 Agent Chat 会话里完成整条流水线效果最佳。
 
+#### 21. OpenClaw (原生插件)
+
+OpenClaw 通过原生 Plugin SDK 集成，无需 `super-dev onboard`，直接安装 npm 插件即可。
+
+安装：
+```bash
+# 第一步：安装 super-dev CLI
+pip install super-dev
+
+# 第二步：安装 OpenClaw 插件
+openclaw plugins install @super-dev/openclaw-plugin
+```
+
+触发位置：
+在 OpenClaw Agent 对话面板中，确保当前工作区为目标项目后触发。
+
+触发命令：
+```text
+super-dev: 你的需求
+```
+或
+```text
+/super-dev 你的需求
+```
+
+插件提供 13 个专用 Tool：
+
+| Tool | 功能 |
+|------|------|
+| `super_dev_pipeline` | 启动完整流水线 |
+| `super_dev_init` | 项目初始化 |
+| `super_dev_status` | 查看流水线状态 |
+| `super_dev_quality` | 质量检查（按类型） |
+| `super_dev_spec` | Spec 管理（propose/list/show/scaffold/validate） |
+| `super_dev_config` | 配置管理（list/get/set） |
+| `super_dev_review` | 审查与门禁确认（docs/ui/architecture/quality） |
+| `super_dev_release` | 发布就绪度 / 交付证明包 |
+| `super_dev_expert` | 专家咨询 (10 角色) |
+| `super_dev_deploy` | CI/CD 配置 / Dockerfile / 发布演练 |
+| `super_dev_analyze` | 项目分析（技术栈/依赖/结构） |
+| `super_dev_doctor` | 环境诊断 |
+| `super_dev_run` | 通用命令透传（可选） |
+
+补充说明：
+1. 插件通过 CLI subprocess 桥接调用 `super-dev`，因此必须先 `pip install super-dev`。
+2. 安装后建议重启 OpenClaw Gateway 或新开会话，让 Plugin 和 Skill 生效。
+3. 插件内嵌 SKILL.md，OpenClaw Agent 会自动理解流水线协议。
+4. 使用 `super-dev doctor --host openclaw` 检查集成状态。
+
 ---
 
 ## 关键文档

{super_dev-2.1.1 → super_dev-2.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "super-dev"
-version = "2.1.1"
+version = "2.1.3"
 description = "Super Dev - Pipeline AI Coding Assistant"
 readme = "README.md"
 requires-python = ">=3.10"

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/__init__.py

@@ -6,6 +6,6 @@
 最后修改：2025-12-30
 """
 
-__version__ = "2.1.1"
+__version__ = "2.1.3"
 __author__ = "Excellent"
 __description__ = "超级开发战队 - 一个宿主内 AI 开发治理与编排工具"

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/analyzer/dependency_graph.py

@@ -128,8 +128,9 @@ class DependencyGraphBuilder:
         module_index = self._build_module_index(files)
         edges = self._build_edges(files, module_index, path_index)
         inbound, outbound = self._degree(edges)
-        critical_nodes = self._critical_nodes(path_index, inbound, outbound)
-        critical_paths = self._critical_paths(edges, critical_nodes)
+        repo_map = self.repo_map_builder.build()
+        critical_nodes = self._critical_nodes(path_index, inbound, outbound, repo_map=repo_map)
+        critical_paths = self._critical_paths(edges, critical_nodes, repo_map=repo_map)
 
         summary = (
             f"The dependency graph highlights `{len(path_index)}` source nodes and `{len(edges)}` internal import edges. "
@@ -298,8 +299,11 @@ class DependencyGraphBuilder:
         path_index: dict[str, Path],
         inbound: dict[str, int],
         outbound: dict[str, int],
+        repo_map: object | None = None,
     ) -> list[DependencyNode]:
-        entry_paths = {item.path for item in self.repo_map_builder.build().entry_points}
+        if repo_map is None:
+            repo_map = self.repo_map_builder.build()
+        entry_paths = {item.path for item in repo_map.entry_points}
         nodes: list[DependencyNode] = []
         for rel in path_index:
             in_count = inbound.get(rel, 0)
@@ -317,11 +321,14 @@ class DependencyGraphBuilder:
         self,
         edges: list[DependencyEdge],
         critical_nodes: list[DependencyNode],
+        repo_map: object | None = None,
     ) -> list[CriticalPath]:
         adjacency: dict[str, list[str]] = defaultdict(list)
         for edge in edges:
             adjacency[edge.source].append(edge.target)
-        entry_points = [item.path for item in self.repo_map_builder.build().entry_points]
+        if repo_map is None:
+            repo_map = self.repo_map_builder.build()
+        entry_points = [item.path for item in repo_map.entry_points]
         targets = [item.path for item in critical_nodes[:5] if item.role != "entry-point"]
         paths: list[CriticalPath] = []
         for entry in entry_points[:5]:

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/analyzer/detectors.py

@@ -74,18 +74,7 @@ def detect_project_type(project_path: Path) -> ProjectCategory:
     if (project_path / "android").exists() or (project_path / "ios").exists():
         return ProjectCategory.MOBILE
 
-    # 检查 Electron 项目
-    if package_json.exists():
-        try:
-            with open(package_json, encoding="utf-8") as f:
-                data = json.load(f)
-                deps = data.get("dependencies", {})
-                dev_deps = data.get("devDependencies", {})
-
-                if "electron" in deps or "electron" in dev_deps:
-                    return ProjectCategory.DESKTOP
-        except (OSError, json.JSONDecodeError):
-            pass
+    # Electron 检测已移入 _detect_node_project_type
 
     return ProjectCategory.UNKNOWN
 
@@ -102,6 +91,10 @@ def _detect_node_project_type(project_path: Path) -> ProjectCategory:
 
             all_deps = {**deps, **dev_deps}
 
+            # 检测 Electron 桌面应用
+            if "electron" in all_deps:
+                return ProjectCategory.DESKTOP
+
             # 检测前端框架
             frontend_frameworks = [
                 "react", "react-dom", "vue", "vue-router", "@angular/core",
@@ -354,33 +347,51 @@ def _detect_node_tech_stack(project_path: Path, category: ProjectCategory) -> Te
 def _detect_python_tech_stack(project_path: Path, category: ProjectCategory) -> TechStack:
     """检测 Python 技术栈"""
     requirements_txt = project_path / "requirements.txt"
+    pyproject_toml = project_path / "pyproject.toml"
 
     dependencies = []
     framework = FrameworkType.UNKNOWN
     testing_framework = ""
 
-    # 解析依赖
+    # 解析 requirements.txt
     if requirements_txt.exists():
         try:
             with open(requirements_txt, encoding="utf-8") as f:
                 for line in f:
                     line = line.strip()
                     if line and not line.startswith("#"):
-                        # 解析 requirement
                         match = re.match(r"^([a-zA-Z0-9_-]+)([>=<~]+(.+))?", line)
                         if match:
                             name = match.group(1)
                             version = match.group(3) or ""
                             dependencies.append(
-                                Dependency(
-                                    name=name,
-                                    version=version,
-                                    type="prod",
-                                )
+                                Dependency(name=name, version=version, type="prod")
                             )
         except OSError:
             pass
 
+    # 解析 pyproject.toml 依赖（补充 requirements.txt 未覆盖的情况）
+    if pyproject_toml.exists() and not dependencies:
+        try:
+            content = pyproject_toml.read_text(encoding="utf-8", errors="ignore")
+            in_deps = False
+            for line in content.split("\n"):
+                stripped = line.strip()
+                if stripped in ("[project.dependencies]", "dependencies = ["):
+                    in_deps = True
+                    continue
+                if in_deps:
+                    if stripped.startswith("[") or stripped == "]":
+                        in_deps = False
+                        continue
+                    dep_match = re.match(r'"?([a-zA-Z0-9_-]+)', stripped)
+                    if dep_match:
+                        dependencies.append(
+                            Dependency(name=dep_match.group(1), version="", type="prod")
+                        )
+        except OSError:
+            pass
+
     # 检测框架
     dep_names = {d.name.lower() for d in dependencies}
 

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/analyzer/feature_checklist.py

@@ -362,7 +362,6 @@ class FeatureChecklistBuilder:
             return explicit_gaps
 
         result: list[FeatureChecklistItem] = []
-        gap_lookup = {gap.title: gap for gap in explicit_gaps}
         for feature in features:
             state = "unknown"
             priority = ""

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/catalogs.py

@@ -153,6 +153,7 @@ HOST_TOOL_CATALOG: list[dict[str, str]] = [
     {"id": "kiro", "name": "Kiro"},
     {"id": "qoder", "name": "Qoder"},
     {"id": "trae", "name": "Trae"},
+    {"id": "openclaw", "name": "OpenClaw"},
 ]
 
 HOST_TOOL_IDS: tuple[str, ...] = tuple(item["id"] for item in HOST_TOOL_CATALOG)
@@ -196,6 +197,7 @@ CLI_HOST_TOOL_IDS: tuple[str, ...] = (
     "iflow",
     "kimi-cli",
     "kiro-cli",
+    "openclaw",
     "opencode",
     "qoder-cli",
 )
@@ -225,6 +227,7 @@ HOST_COMMAND_CANDIDATES: dict[str, list[str]] = {
     "qoder-cli": ["qoder", "qoder-cli"],
     "roo-code": ["roo", "roo-code"],
     "cursor": ["cursor"],
+    "openclaw": ["openclaw", "openclaw-cli"],
     "qoder": ["qoder"],
     "trae": ["trae"],
 }

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/cli.py

@@ -97,7 +97,7 @@ class SuperDevCLI:
     """Super Dev 命令行接口"""
 
     def __init__(self):
-        self.console = create_console() if RICH_AVAILABLE else None
+        self.console = create_console()
         self.parser = self._create_parser()
         self.logger = get_logger('cli', level='WARNING')  # CLI只记录WARNING及以上级别
 
@@ -3398,16 +3398,19 @@ super-dev start --idea "你的需求"
             }
             expert_role, expert_title = expert_map.get(normalized, ("CODE", "代码专家"))
 
-            from rich.panel import Panel
             self.console.print("")
-            self.console.print(Panel(
-                f"[bold cyan]Super Dev Run[/bold cyan]\n\n"
-                f"  [dim]环节[/dim]    {normalized} ({label})\n"
-                f"  [dim]专家[/dim]    [bold]{expert_role}[/bold] - {expert_title}",
-                border_style="cyan",
-                expand=True,
-                padding=(1, 2),
+            if RICH_AVAILABLE:
+                from rich.panel import Panel
+                self.console.print(Panel(
+                    f"[bold cyan]Super Dev Run[/bold cyan]\n\n"
+                    f"  [dim]环节[/dim]    {normalized} ({label})\n"
+                    f"  [dim]专家[/dim]    [bold]{expert_role}[/bold] - {expert_title}",
+                    border_style="cyan",
+                    expand=True,
+                    padding=(1, 2),
             ))
+            else:
+                self.console.print(f"Super Dev Run: {normalized} ({label}) | {expert_role} - {expert_title}")
             self.console.print("")
 
             if normalized in {"research", "prd", "architecture", "uiux"}:
@@ -3602,7 +3605,7 @@ super-dev start --idea "你的需求"
             + (", ".join(payload["skipped_gates"]) if payload["skipped_gates"] else "-")
         )
         scope_rate = payload["scope_coverage_rate"]
-        scope_rate_text = f"{float(scope_rate):.1f}%" if isinstance(scope_rate, (int, float)) else "-"
+        scope_rate_text = f"{float(scope_rate):.1f}%" if isinstance(scope_rate, int | float) else "-"
         self.console.print(f"  范围覆盖状态: {payload['scope_coverage_status']}")
         self.console.print(f"  范围覆盖率: {scope_rate_text}")
         self.console.print(f"  范围缺口: {payload['scope_gap_count']}")
@@ -5361,6 +5364,16 @@ super-dev start --idea "你的需求"
                 knowledge_cache_exists=knowledge_cache_file.exists(),
             )
 
+            # 初始化 resume 跳过时可能未赋值的变量
+            knowledge_bundle: dict | None = None
+            cicd_files: dict[str, str] = {}
+            remediation_outputs: dict = {"env_file": "", "checklist_file": "", "items_count": 0}
+            migration_files: dict[str, str] = {}
+            delivery_outputs: dict = {
+                "manifest_file": "", "report_file": "", "archive_file": "", "status": "skipped",
+            }
+            task_execution_summary = None
+
             # ========== 第 0 阶段: 需求增强 ==========
             _start_stage("0", "需求增强")
             if _should_skip_for_resume(0):
@@ -6329,9 +6342,13 @@ super-dev start --idea "你的需求"
                 self.console.print("    - backend/src/*")
                 self.console.print("    - backend/API_CONTRACT.md")
                 self.console.print("    - backend/migrations/*.sql")
-                if task_execution_summary is not None:
+                if task_execution_summary is not None and task_execution_summary.report_file:
+                    try:
+                        rel = Path(str(task_execution_summary.report_file)).relative_to(project_dir)
+                    except ValueError:
+                        rel = Path(str(task_execution_summary.report_file)).name
                     self.console.print(
-                        f"    - {Path(str(task_execution_summary.report_file)).relative_to(project_dir)}"
+                        f"    - {rel}"
                     )
                 self.console.print("")
             self.console.print("  CI/CD:")
@@ -8705,9 +8722,9 @@ super-dev start --idea "你的需求"
 
             status = "[green]已就绪[/green]" if host["ready"] else "[red]未安装[/red]"
 
-            integrate_ok = host.get("integrate_ok", True)
-            skill_ok = host.get("skill_ok", True)
-            slash_ok = host.get("slash_ok", True)
+            integrate_ok = bool(host.get("checks", {}).get("integrate", {}).get("ok", True))
+            skill_ok = bool(host.get("checks", {}).get("skill", {}).get("ok", True))
+            slash_ok = bool(host.get("checks", {}).get("slash", {}).get("ok", True))
 
             integrate_text = "[green]已安装[/green]" if integrate_ok else "[red]未安装[/red]"
             skill_text = "[green]已安装[/green]" if skill_ok else ("[dim]不适用[/dim]" if not IntegrationManager.requires_skill(target) else "[red]未安装[/red]")
@@ -9119,10 +9136,10 @@ super-dev start --idea "你的需求"
 
     def _fetch_latest_pypi_version(self) -> str | None:
         try:
-            response = requests.get("https://pypi.org/pypi/super-dev/json", timeout=10)
+            response = requests.get("https://pypi.org/pypi/super-dev/json", timeout=10)  # type: ignore[name-defined]
             response.raise_for_status()
             payload = response.json()
-        except Exception:
+        except (Exception, NameError):
             return None
         info = payload.get("info", {})
         version = info.get("version")
@@ -11326,6 +11343,7 @@ super-dev start --idea "你的需求"
             domain=domain,
             name=direct_overrides.get("name"),
             cicd=cicd,
+            mode=direct_overrides.get("mode", "feature"),
             skip_redteam=bool(direct_overrides.get("skip_redteam", False)),
             skip_scaffold=bool(direct_overrides.get("skip_scaffold", False)),
             skip_quality_gate=bool(direct_overrides.get("skip_quality_gate", False)),

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/config/manager.py

@@ -6,6 +6,7 @@
 最后修改：2025-12-30
 """
 
+import dataclasses
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any, cast
@@ -142,6 +143,10 @@ class ConfigManager:
         # 合并默认配置
         config_data: dict[str, Any] = {**self.DEFAULT_CONFIG, **data}
 
+        # 过滤掉 ProjectConfig 不支持的字段，避免 TypeError
+        valid_fields = {f.name for f in dataclasses.fields(ProjectConfig)}
+        config_data = {k: v for k, v in config_data.items() if k in valid_fields}
+
         return ProjectConfig(**cast(dict[str, Any], config_data))
 
     def save(self, config: ProjectConfig | None = None) -> None:

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/creators/document_generator.py

@@ -8,6 +8,7 @@
 最后修改：2025-01-04
 """
 
+import logging
 from datetime import datetime
 
 from .requirement_parser import RequirementParser
@@ -4332,48 +4333,50 @@ spec:
 """
 
     def _render_ui_intelligence_summary(self, profile: dict) -> str:
+        lib = profile.get("primary_library", {})
+        stack = profile.get("component_stack", {})
         lines = [
-            f"- **界面定位**: {profile['surface']}",
-            f"- **信息密度**: {profile['information_density']}",
-            f"- **行业语气**: {profile['industry_tone']}",
-            f"- **首选组件生态**: {profile['primary_library']['name']}",
-            f"- **表单基线**: {profile['component_stack']['form']}",
-            f"- **数据展示基线**: {profile['component_stack']['table']} / {profile['component_stack']['chart']}",
+            f"- **界面定位**: {profile.get('surface', 'N/A')}",
+            f"- **信息密度**: {profile.get('information_density', 'N/A')}",
+            f"- **行业语气**: {profile.get('industry_tone', 'N/A')}",
+            f"- **首选组件生态**: {lib.get('name', 'N/A')}",
+            f"- **表单基线**: {stack.get('form', 'N/A')}",
+            f"- **数据展示基线**: {stack.get('table', 'N/A')} / {stack.get('chart', 'N/A')}",
             "",
             "**优先原则**:",
         ]
-        lines.extend(f"- {item}" for item in profile["benchmark_principles"])
+        lines.extend(f"- {item}" for item in profile.get("benchmark_principles", []))
         lines.extend(["", "**设计知识库关键词**:"])
-        lines.append("- " + " / ".join(profile["knowledge_keywords"]))
+        lines.append("- " + " / ".join(profile.get("knowledge_keywords", [])))
         return "\n".join(lines)
 
     def _render_component_ecosystem(self, profile: dict) -> str:
-        primary = profile["primary_library"]
+        primary = profile.get("primary_library", {})
         lines = [
-            f"#### 首选方案: {primary['name']}",
+            f"#### 首选方案: {primary.get('name', 'N/A')}",
             "",
-            f"**适用原因**: {primary['rationale']}",
+            f"**适用原因**: {primary.get('rationale', 'N/A')}",
             "",
             "**核心能力**:",
         ]
-        lines.extend(f"- {item}" for item in primary["strengths"])
+        lines.extend(f"- {item}" for item in primary.get("strengths", []))
         lines.extend(
             [
                 "",
                 "**实现注意事项**:",
             ]
         )
-        lines.extend(f"- {item}" for item in primary["notes"])
+        lines.extend(f"- {item}" for item in primary.get("notes", []))
         lines.extend(
             [
                 "",
                 "#### 配套技术基线",
                 "",
-                f"- **表单与验证**: {profile['component_stack']['form']}",
-                f"- **图表能力**: {profile['component_stack']['chart']}",
-                f"- **表格/数据工作区**: {profile['component_stack']['table']}",
-                f"- **图标体系**: {profile['component_stack']['icons']}",
-                f"- **动效能力**: {profile['component_stack']['motion']}",
+                f"- **表单与验证**: {profile.get('component_stack', {}).get('form', 'N/A')}",
+                f"- **图表能力**: {profile.get('component_stack', {}).get('chart', 'N/A')}",
+                f"- **表格/数据工作区**: {profile.get('component_stack', {}).get('table', 'N/A')}",
+                f"- **图标体系**: {profile.get('component_stack', {}).get('icons', 'N/A')}",
+                f"- **动效能力**: {profile.get('component_stack', {}).get('motion', 'N/A')}",
             ]
         )
 
@@ -4381,7 +4384,7 @@ spec:
         if alternatives:
             lines.extend(["", "#### 可选备选方案", ""])
             for item in alternatives:
-                lines.append(f"- **{item['name']}**: {item['rationale']}")
+                lines.append(f"- **{item.get('name', 'N/A')}**: {item.get('rationale', 'N/A')}")
         matrix = profile.get("ui_library_matrix", [])
         if matrix:
             lines.extend(
@@ -4598,7 +4601,7 @@ spec:
 
         except Exception as e:
             # 如果设计引擎失败，返回空推荐
-            print(f"Warning: Design engine failed: {e}")
+            logging.getLogger(__name__).warning(f"Design engine failed: {e}")
             return {
                 'styles': [],
                 'colors': None,

{super_dev-2.1.1 → super_dev-2.1.3}/super_dev/creators/frontend_builder.py

@@ -4,6 +4,7 @@
 
 from __future__ import annotations
 
+import html
 import json
 from pathlib import Path
 
@@ -53,7 +54,7 @@ class FrontendScaffoldBuilder:
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>{self.name} · Frontend Blueprint</title>
+    <title>{html.escape(self.name)} · Frontend Blueprint</title>
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Manrope:wght@400;600;700;800&family=Sora:wght@400;600;700&display=swap" rel="stylesheet" />
@@ -65,7 +66,7 @@ class FrontendScaffoldBuilder:
       <nav class="topbar">
         <div class="brand">
           <span class="brand-mark">SD</span>
-          <span>{self.name}</span>
+          <span>{html.escape(self.name)}</span>
         </div>
         <div class="top-actions">
           <a href="#trust">客户证明</a>
@@ -603,6 +604,7 @@ body {
             "docs": docs,
         }
         payload_str = json.dumps(payload, ensure_ascii=False, indent=2)
+        payload_str = payload_str.replace("</", "<\\/")
         return f"""const DATA = {payload_str};
 
 const docContainer = document.getElementById("doc-links");