super-dev 2.0.8__tar.gz → 2.0.10__tar.gz

{super_dev-2.0.8/super_dev.egg-info → super_dev-2.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: super-dev
-Version: 2.0.8
+Version: 2.0.10
 Summary: Super Dev - Pipeline AI Coding Assistant
 Author-email: Excellent <11964948@qq.com>
 License-Expression: MIT
@@ -43,14 +43,14 @@ Dynamic: license-file
 
 <div align="center">
 
-# 超级开发战队
+<img src="docs/assets/super-dev-logo.svg" alt="Super Dev - AI PIPELINE ORCHESTRATOR" width="600">
+
 ### 面向商业级交付的 AI 开发编排工具
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
 [![Type Checks](https://img.shields.io/badge/type%20checks-mypy-success)](https://mypy-lang.org/)
 [![Lint](https://img.shields.io/badge/lint-ruff-success)](https://docs.astral.sh/ruff/)
-[![CI](https://img.shields.io/badge/CI-GitHub%20Actions-success)](.github/workflows/ci.yml)
 
 [English](README_EN.md) | 简体中文
 
@@ -60,7 +60,16 @@ Dynamic: license-file
 
 ## 版本
 
-当前版本：`2.0.8`
+当前版本：`2.0.10`
+
+---
+
+## 演示视频
+
+<video controls playsinline preload="metadata" src="https://shangyankeji.github.io/super-dev/demo.mp4" width="100%"></video>
+
+- 在线播放：[观看演示视频](https://shangyankeji.github.io/super-dev/demo.mp4)
+- 仓库文件：[demo.mp4](demo.mp4)
 
 ---
 
@@ -95,6 +104,7 @@ Dynamic: license-file
 
 - 同类产品研究 -> 需求增强 -> 文档 -> Spec -> 实现骨架 -> 红队 -> 质量门禁 -> 交付
 - 全流程可恢复执行（`run --resume`）
+- UI 不满意时可发起正式改版回路（`review ui`）
 - 适配 0-1 新建与 1-N+1 增量场景
 
 ### 3. 策略治理（Policy DSL）
@@ -116,6 +126,7 @@ Dynamic: license-file
 - `pipeline-contract` 阶段契约证据
 - `resume-audit` 恢复执行审计
 - `delivery manifest/report/archive` 交付包
+- `proof-pack` 交付证据汇总
 
 ### 6. 商业级门禁链路
 
@@ -161,6 +172,20 @@ super-dev update
 super-dev
 ```
 
+常用交付证据命令：
+
+```bash
+super-dev integrate audit --auto --repair --force
+super-dev integrate validate --auto
+super-dev repo-map
+super-dev impact "修改登录流程" --files services/auth.py
+super-dev fix "修复登录接口 500 并补充回归验证"
+super-dev release proof-pack
+super-dev release readiness
+super-dev review architecture --status revision_requested --comment "技术方案需要重构"
+super-dev review quality --status revision_requested --comment "质量门禁未通过，需要整改"
+```
+
 默认会进入宿主安装引导：
 
 - 顶部显示 `Super Dev` 安装入口
@@ -176,17 +201,31 @@ super-dev
 
 - slash 宿主：`/super-dev 你的需求`
 - 非 slash 宿主：`super-dev: 你的需求`
+- 需要真人验收时，可执行：`super-dev integrate validate --target <host>`
+
+如果你希望先显式初始化项目契约，再开始接入宿主：
+
+```bash
+super-dev bootstrap --name my-project --platform web --frontend next --backend node
+```
+
+这会显式生成：
+
+- `.super-dev/WORKFLOW.md`
+- `output/*-bootstrap.md`
+
+用来固定初始化规范、触发方式和阶段顺序。
 
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.0.8
+pip install super-dev==2.0.10
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.8
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.10
 ```
 
 ### 5. 源码开发安装
@@ -259,6 +298,23 @@ uv tool install super-dev
 5. 宿主负责联网、推理、编码、运行与修改文件
 6. Super Dev 负责流程、文档、门禁、审计和交付标准
 
+补充说明：
+
+- 新功能开发默认走完整流水线：`research -> 三文档 -> 用户确认 -> Spec / tasks -> 前端运行验证 -> 后端 / 测试 / 交付`
+- 缺陷修复同样不会直接跳过文档；会走轻量补丁路径，先整理问题现象、复现条件、影响范围和回归风险，再更新补丁文档与验证结果
+- 分析阶段默认排除 `.venv`、`site-packages`、`node_modules` 等非项目源码目录
+
+---
+
+## 关键文档
+
+- [宿主使用指南](docs/HOST_USAGE_GUIDE.md)
+- [宿主能力审计](docs/HOST_CAPABILITY_AUDIT.md)
+- [宿主运行时验收矩阵](docs/HOST_RUNTIME_VALIDATION.md)
+- [宿主接入面说明](docs/HOST_INSTALL_SURFACES.md)
+- [工作流指南](docs/WORKFLOW_GUIDE.md)
+- [产品审查](docs/PRODUCT_AUDIT.md)
+
 执行原则：
 
 - 宿主负责“写代码”
@@ -292,6 +348,9 @@ uv tool install super-dev
 2. Claude Code / Gemini CLI / Kiro CLI / Qoder CLI / CodeBuddy CLI 等支持原生映射的宿主，可直接输入：`/super-dev 你的需求`。
 3. Codex CLI、Kimi CLI 当前不使用 `/super-dev`；在宿主会话里输入 `super-dev: 你的需求`。
 4. 宿主会先被约束执行“同类产品研究 -> 三文档 -> 等待用户确认 -> Spec -> 前端运行验证 -> 后端/测试/交付”，不会直接跳到写代码。
+5. 如果是缺陷修复，优先使用 `super-dev fix "缺陷描述"`，走轻量 bugfix 路径，而不是完整功能开发路径。
+6. 接手已有项目或复杂仓库时，优先执行 `super-dev repo-map` 生成代码库地图，再让宿主进入开发。
+7. 如果准备重构、改接口、修登录流或修改关键状态流，先执行 `super-dev impact "变更描述" --files ...` 评估影响范围，再动手。
 
 ### 宿主如何理解 Super Dev
 
@@ -484,6 +543,7 @@ super-dev onboard --host iflow --force --yes
 补充说明：
 1. 当前按 slash 宿主适配。
 2. 如果 slash 未出现，先检查项目级命令文件是否已写入。
+3. 如果宿主返回 `Invalid API key provided`，先在 iFlow 会话内执行 `/auth`，或更新 `IFLOW_API_KEY` / `settings.json` 后重启宿主会话。
 
 #### 10. Kimi CLI
 
@@ -653,7 +713,7 @@ super-dev: 你的需求
 
 补充说明：
 1. Codex CLI 当前使用 `super-dev: 你的需求` 作为主触发方式。
-2. 实际依赖 `.codex/AGENTS.md` 与官方用户级 Skill `~/.codex/skills/super-dev-core/SKILL.md`。
+2. 实际依赖 `AGENTS.md` 与官方用户级 Skill `~/.codex/skills/super-dev-core/SKILL.md`。
 3. 如果旧会话没加载新 Skill，重启 `codex` 再试。
 
 #### 18. Trae
@@ -678,4 +738,3 @@ super-dev: 你的需求
 2. 接入一定会写入项目级 `.trae/project_rules.md`、`.trae/rules.md` 和用户级 `~/.trae/user_rules.md`、`~/.trae/rules.md`；如果检测到兼容技能目录，也会增强安装 `~/.trae/skills/super-dev-core/SKILL.md`。
 3. 完成接入后建议重开 Trae 或至少新开一个 Agent Chat，使规则生效；如果兼容 Skill 已安装，也会一起生效。
 4. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
-

{super_dev-2.0.8 → super_dev-2.0.10}/README.md

@@ -2,14 +2,14 @@
 
 <div align="center">
 
-# 超级开发战队
+<img src="docs/assets/super-dev-logo.svg" alt="Super Dev - AI PIPELINE ORCHESTRATOR" width="600">
+
 ### 面向商业级交付的 AI 开发编排工具
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
 [![Type Checks](https://img.shields.io/badge/type%20checks-mypy-success)](https://mypy-lang.org/)
 [![Lint](https://img.shields.io/badge/lint-ruff-success)](https://docs.astral.sh/ruff/)
-[![CI](https://img.shields.io/badge/CI-GitHub%20Actions-success)](.github/workflows/ci.yml)
 
 [English](README_EN.md) | 简体中文
 
@@ -19,7 +19,16 @@
 
 ## 版本
 
-当前版本：`2.0.8`
+当前版本：`2.0.10`
+
+---
+
+## 演示视频
+
+<video controls playsinline preload="metadata" src="https://shangyankeji.github.io/super-dev/demo.mp4" width="100%"></video>
+
+- 在线播放：[观看演示视频](https://shangyankeji.github.io/super-dev/demo.mp4)
+- 仓库文件：[demo.mp4](demo.mp4)
 
 ---
 
@@ -54,6 +63,7 @@
 
 - 同类产品研究 -> 需求增强 -> 文档 -> Spec -> 实现骨架 -> 红队 -> 质量门禁 -> 交付
 - 全流程可恢复执行（`run --resume`）
+- UI 不满意时可发起正式改版回路（`review ui`）
 - 适配 0-1 新建与 1-N+1 增量场景
 
 ### 3. 策略治理（Policy DSL）
@@ -75,6 +85,7 @@
 - `pipeline-contract` 阶段契约证据
 - `resume-audit` 恢复执行审计
 - `delivery manifest/report/archive` 交付包
+- `proof-pack` 交付证据汇总
 
 ### 6. 商业级门禁链路
 
@@ -120,6 +131,20 @@ super-dev update
 super-dev
 ```
 
+常用交付证据命令：
+
+```bash
+super-dev integrate audit --auto --repair --force
+super-dev integrate validate --auto
+super-dev repo-map
+super-dev impact "修改登录流程" --files services/auth.py
+super-dev fix "修复登录接口 500 并补充回归验证"
+super-dev release proof-pack
+super-dev release readiness
+super-dev review architecture --status revision_requested --comment "技术方案需要重构"
+super-dev review quality --status revision_requested --comment "质量门禁未通过，需要整改"
+```
+
 默认会进入宿主安装引导：
 
 - 顶部显示 `Super Dev` 安装入口
@@ -135,17 +160,31 @@ super-dev
 
 - slash 宿主：`/super-dev 你的需求`
 - 非 slash 宿主：`super-dev: 你的需求`
+- 需要真人验收时，可执行：`super-dev integrate validate --target <host>`
+
+如果你希望先显式初始化项目契约，再开始接入宿主：
+
+```bash
+super-dev bootstrap --name my-project --platform web --frontend next --backend node
+```
+
+这会显式生成：
+
+- `.super-dev/WORKFLOW.md`
+- `output/*-bootstrap.md`
+
+用来固定初始化规范、触发方式和阶段顺序。
 
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.0.8
+pip install super-dev==2.0.10
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.8
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.10
 ```
 
 ### 5. 源码开发安装
@@ -218,6 +257,23 @@ uv tool install super-dev
 5. 宿主负责联网、推理、编码、运行与修改文件
 6. Super Dev 负责流程、文档、门禁、审计和交付标准
 
+补充说明：
+
+- 新功能开发默认走完整流水线：`research -> 三文档 -> 用户确认 -> Spec / tasks -> 前端运行验证 -> 后端 / 测试 / 交付`
+- 缺陷修复同样不会直接跳过文档；会走轻量补丁路径，先整理问题现象、复现条件、影响范围和回归风险，再更新补丁文档与验证结果
+- 分析阶段默认排除 `.venv`、`site-packages`、`node_modules` 等非项目源码目录
+
+---
+
+## 关键文档
+
+- [宿主使用指南](docs/HOST_USAGE_GUIDE.md)
+- [宿主能力审计](docs/HOST_CAPABILITY_AUDIT.md)
+- [宿主运行时验收矩阵](docs/HOST_RUNTIME_VALIDATION.md)
+- [宿主接入面说明](docs/HOST_INSTALL_SURFACES.md)
+- [工作流指南](docs/WORKFLOW_GUIDE.md)
+- [产品审查](docs/PRODUCT_AUDIT.md)
+
 执行原则：
 
 - 宿主负责“写代码”
@@ -251,6 +307,9 @@ uv tool install super-dev
 2. Claude Code / Gemini CLI / Kiro CLI / Qoder CLI / CodeBuddy CLI 等支持原生映射的宿主，可直接输入：`/super-dev 你的需求`。
 3. Codex CLI、Kimi CLI 当前不使用 `/super-dev`；在宿主会话里输入 `super-dev: 你的需求`。
 4. 宿主会先被约束执行“同类产品研究 -> 三文档 -> 等待用户确认 -> Spec -> 前端运行验证 -> 后端/测试/交付”，不会直接跳到写代码。
+5. 如果是缺陷修复，优先使用 `super-dev fix "缺陷描述"`，走轻量 bugfix 路径，而不是完整功能开发路径。
+6. 接手已有项目或复杂仓库时，优先执行 `super-dev repo-map` 生成代码库地图，再让宿主进入开发。
+7. 如果准备重构、改接口、修登录流或修改关键状态流，先执行 `super-dev impact "变更描述" --files ...` 评估影响范围，再动手。
 
 ### 宿主如何理解 Super Dev
 
@@ -443,6 +502,7 @@ super-dev onboard --host iflow --force --yes
 补充说明：
 1. 当前按 slash 宿主适配。
 2. 如果 slash 未出现，先检查项目级命令文件是否已写入。
+3. 如果宿主返回 `Invalid API key provided`，先在 iFlow 会话内执行 `/auth`，或更新 `IFLOW_API_KEY` / `settings.json` 后重启宿主会话。
 
 #### 10. Kimi CLI
 
@@ -612,7 +672,7 @@ super-dev: 你的需求
 
 补充说明：
 1. Codex CLI 当前使用 `super-dev: 你的需求` 作为主触发方式。
-2. 实际依赖 `.codex/AGENTS.md` 与官方用户级 Skill `~/.codex/skills/super-dev-core/SKILL.md`。
+2. 实际依赖 `AGENTS.md` 与官方用户级 Skill `~/.codex/skills/super-dev-core/SKILL.md`。
 3. 如果旧会话没加载新 Skill，重启 `codex` 再试。
 
 #### 18. Trae
@@ -637,4 +697,3 @@ super-dev: 你的需求
 2. 接入一定会写入项目级 `.trae/project_rules.md`、`.trae/rules.md` 和用户级 `~/.trae/user_rules.md`、`~/.trae/rules.md`；如果检测到兼容技能目录，也会增强安装 `~/.trae/skills/super-dev-core/SKILL.md`。
 3. 完成接入后建议重开 Trae 或至少新开一个 Agent Chat，使规则生效；如果兼容 Skill 已安装，也会一起生效。
 4. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
-

{super_dev-2.0.8 → super_dev-2.0.10}/pyproject.toml

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

{super_dev-2.0.8 → super_dev-2.0.10}/super_dev/__init__.py

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

{super_dev-2.0.8 → super_dev-2.0.10}/super_dev/analyzer/__init__.py

@@ -15,6 +15,8 @@ from .models import (
     ProjectType,
     TechStack,
 )
+from .repo_map import RepoMapBuilder, RepoMapItem, RepoMapReport
+from .impact import ImpactAnalyzer, ImpactAnalysisReport, ImpactItem
 
 __all__ = [
     "ProjectAnalyzer",
@@ -27,8 +29,12 @@ __all__ = [
     "TechStack",
     "FrameworkType",
     "ArchitecturePattern",
+    "RepoMapBuilder",
+    "RepoMapItem",
+    "RepoMapReport",
+    "ImpactAnalyzer",
+    "ImpactAnalysisReport",
+    "ImpactItem",
     "detect_project_type",
     "detect_tech_stack",
 ]
-
-

{super_dev-2.0.8 → super_dev-2.0.10}/super_dev/analyzer/analyzer.py

@@ -42,6 +42,26 @@ class ProjectAnalyzer:
             raise FileNotFoundError(f"项目不存在: {self.project_path}")
 
         self._report: ArchitectureReport | None = None
+        self._ignored_dir_names = {
+            "node_modules",
+            "__pycache__",
+            ".git",
+            "venv",
+            ".venv",
+            "env",
+            ".env",
+            "dist",
+            "build",
+            "target",
+            "bin",
+            "obj",
+            ".next",
+            ".nuxt",
+            "coverage",
+            ".pytest_cache",
+            "site-packages",
+            "dist-packages",
+        }
 
     def analyze(self) -> ArchitectureReport:
         """
@@ -101,12 +121,7 @@ class ProjectAnalyzer:
             tree: dict[str, dict | None] = {}
             try:
                 for item in sorted(path.iterdir(), key=lambda x: (not x.is_dir(), x.name)):
-                    # 跳过隐藏文件和目录
-                    if item.name.startswith("."):
-                        continue
-
-                    # 跳过常见忽略目录
-                    if item.name in ["node_modules", "__pycache__", ".git", "venv", "dist", "build"]:
+                    if self._should_ignore_path(item):
                         continue
 
                     if item.is_dir():
@@ -162,16 +177,9 @@ class ProjectAnalyzer:
             ".svelte": "Svelte",
         }
 
-        # 忽略的目录
-        ignore_dirs = {
-            "node_modules", "__pycache__", ".git", "venv", "env",
-            ".venv", "dist", "build", "target", "bin", "obj",
-            ".next", ".nuxt", "coverage", ".pytest_cache",
-        }
-
         for root, dirs, files in os.walk(self.project_path):
             # 过滤忽略的目录
-            dirs[:] = [d for d in dirs if d not in ignore_dirs]
+            dirs[:] = [d for d in dirs if not self._should_ignore_dir_name(d)]
 
             for file in files:
                 suffix = Path(file).suffix
@@ -180,6 +188,8 @@ class ProjectAnalyzer:
                     continue
 
                 file_path = Path(root) / file
+                if self._should_ignore_path(file_path):
+                    continue
                 try:
                     with open(file_path, encoding="utf-8", errors="ignore") as f:
                         lines = len(f.readlines())
@@ -238,10 +248,27 @@ class ProjectAnalyzer:
         patterns: list[DesignPattern] = []
 
         for py_file in self.project_path.rglob("*.py"):
+            if self._should_ignore_path(py_file):
+                continue
             self._check_file_for_patterns(py_file, patterns, "python")
 
         return patterns
 
+    def _should_ignore_dir_name(self, name: str) -> bool:
+        return name in self._ignored_dir_names
+
+    def _should_ignore_path(self, path: Path) -> bool:
+        try:
+            relative = path.resolve().relative_to(self.project_path)
+            parts = relative.parts
+        except Exception:
+            parts = path.parts
+
+        return any(
+            part.startswith(".") or part in self._ignored_dir_names
+            for part in parts
+        )
+
     def _check_file_for_patterns(
         self, file_path: Path, patterns: list[DesignPattern], language: str
     ) -> None: