@nick848/sf-cli 1.0.16 → 1.0.17

package/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v1.0.16 (2026-03-22)
+
+**新增参考资源分析阶段**
+
+- ✨ 新增「阶段 3/9: 参考资源分析」- 自动提取需求中的 URL 并分析
+- ✨ 支持网页、设计稿、图片、API 等多种参考类型
+- ✨ 使用 AI 分析参考内容，提取功能点、UI 结构、交互方式
+- 🔧 规格拆分前先获取并理解参考内容，生成更精准的任务
+
+**新工作流**：
+```
+阶段 1: 项目上下文获取
+阶段 2: 需求澄清
+阶段 3: 参考资源分析 ← 新增
+  - 自动提取 URL
+  - 获取资源内容
+  - AI 分析功能/结构
+  - 追加到精炼需求
+阶段 4: 复杂度评估
+阶段 5: BDD 场景拆解
+阶段 6: OpenSpec 规格
+阶段 7-9: TDD → 开发 → 审核
+```
+
 ## v1.0.13 (2026-03-22)
 
 **修复 DeepSeek API Key 验证**

package/dist/cli/index.js

@@ -1414,6 +1414,7 @@ async function handleNew(args, ctx) {
     context: null,
     clarityScore: 0,
     clarificationQuestions: [],
+    referenceResources: [],
     complexity: 0,
     bddScenarios: [],
     specItems: [],
@@ -1456,7 +1457,7 @@ async function executeWorkflow(ctx) {
   const lines = [];
   try {
     if (activeSession.phase === "context") {
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 1/8: \u9879\u76EE\u4E0A\u4E0B\u6587\u83B7\u53D6 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 1/9: \u9879\u76EE\u4E0A\u4E0B\u6587\u83B7\u53D6 \u2501\u2501\u2501"));
       lines.push("");
       activeSession.context = await readProjectContext(ctx.options.workingDirectory);
       lines.push(chalk9__default.default.gray(`  \u9879\u76EE: ${activeSession.context.name}`));
@@ -1470,7 +1471,7 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "clarify") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 2/8: \u9700\u6C42\u6F84\u6E05 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 2/9: \u9700\u6C42\u6F84\u6E05 \u2501\u2501\u2501"));
       lines.push("");
       const clarityResult = analyzeRequirementClarity(
         activeSession.requirement,
@@ -1496,11 +1497,40 @@ async function executeWorkflow(ctx) {
         return { output: lines.join("\n") };
       }
       lines.push(chalk9__default.default.green("  \u2713 \u9700\u6C42\u6E05\u6670\uFF0C\u7EE7\u7EED\u4E0B\u4E00\u6B65"));
+      activeSession.phase = "reference";
+    }
+    if (activeSession.phase === "reference") {
+      lines.push("");
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 3/9: \u53C2\u8003\u8D44\u6E90\u5206\u6790 \u2501\u2501\u2501"));
+      lines.push("");
+      const urls = extractUrls(activeSession.refinedRequirement);
+      if (urls.length > 0) {
+        lines.push(chalk9__default.default.gray(`  \u53D1\u73B0 ${urls.length} \u4E2A\u53C2\u8003\u94FE\u63A5`));
+        lines.push("");
+        for (const url of urls) {
+          lines.push(chalk9__default.default.gray(`  \u{1F4CE} ${url}`));
+          try {
+            const resource = await fetchAndAnalyzeReference(url, ctx);
+            activeSession.referenceResources.push(resource);
+            lines.push(chalk9__default.default.green(`     \u2713 \u5DF2\u5206\u6790`));
+            activeSession.refinedRequirement += `
+
+\u3010\u53C2\u8003\u8D44\u6E90\u5206\u6790 - ${url}\u3011
+${resource.analysis}`;
+          } catch (error) {
+            lines.push(chalk9__default.default.yellow(`     \u26A0 \u83B7\u53D6\u5931\u8D25: ${error.message}`));
+          }
+        }
+        lines.push("");
+        lines.push(chalk9__default.default.green("  \u2713 \u53C2\u8003\u8D44\u6E90\u5206\u6790\u5B8C\u6210"));
+      } else {
+        lines.push(chalk9__default.default.gray("  \u65E0\u5916\u90E8\u53C2\u8003\u94FE\u63A5"));
+      }
       activeSession.phase = "analysis";
     }
     if (activeSession.phase === "analysis") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 3/8: \u590D\u6742\u5EA6\u8BC4\u4F30 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 4/9: \u590D\u6742\u5EA6\u8BC4\u4F30 \u2501\u2501\u2501"));
       lines.push("");
       activeSession.complexity = analyzeComplexity(
         activeSession.refinedRequirement,
@@ -1517,12 +1547,13 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "bdd") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 4/8: BDD \u573A\u666F\u62C6\u89E3 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 5/9: BDD \u573A\u666F\u62C6\u89E3 \u2501\u2501\u2501"));
       lines.push("");
       activeSession.bddScenarios = generateBDDScenarios(
         activeSession.refinedRequirement,
         activeSession.context,
-        activeSession.clarificationQuestions
+        activeSession.clarificationQuestions,
+        activeSession.referenceResources
       );
       for (const scenario of activeSession.bddScenarios) {
         lines.push(chalk9__default.default.white(`  Feature: ${scenario.feature}`));
@@ -1537,13 +1568,14 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "spec") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 5/8: OpenSpec \u89C4\u683C \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 6/9: OpenSpec \u89C4\u683C \u2501\u2501\u2501"));
       lines.push("");
       activeSession.specItems = generateSpecItems(
         activeSession.refinedRequirement,
         activeSession.context,
         activeSession.bddScenarios,
-        activeSession.clarificationQuestions
+        activeSession.clarificationQuestions,
+        activeSession.referenceResources
       );
       const specPath = await saveSpecFile(ctx.options.workingDirectory, activeSession);
       lines.push(chalk9__default.default.green("  \u2713 \u89C4\u683C\u6587\u4EF6\u5DF2\u751F\u6210"));
@@ -1567,7 +1599,7 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "tdd") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 6/8: TDD \u6D4B\u8BD5\u751F\u6210 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 7/9: TDD \u6D4B\u8BD5\u751F\u6210 \u2501\u2501\u2501"));
       lines.push("");
       activeSession.testFiles = await generateTests(ctx.options.workingDirectory, activeSession);
       lines.push(chalk9__default.default.green("  \u2713 \u6D4B\u8BD5\u6587\u4EF6\u5DF2\u751F\u6210"));
@@ -1578,7 +1610,7 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "develop") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 7/8: \u5F00\u53D1\u5B9E\u73B0 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 8/9: \u5F00\u53D1\u5B9E\u73B0 \u2501\u2501\u2501"));
       lines.push("");
       lines.push(chalk9__default.default.yellow("  \u{1F680} \u6B63\u5728\u8C03\u7528 AI \u751F\u6210\u4EE3\u7801..."));
       try {
@@ -1603,7 +1635,7 @@ async function executeWorkflow(ctx) {
     }
     if (activeSession.phase === "review") {
       lines.push("");
-      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 8/8: \u4EE3\u7801\u5BA1\u6838 \u2501\u2501\u2501"));
+      lines.push(chalk9__default.default.cyan("\u2501\u2501\u2501 \u9636\u6BB5 9/9: \u4EE3\u7801\u5BA1\u6838 \u2501\u2501\u2501"));
       lines.push("");
       lines.push(chalk9__default.default.yellow("  \u{1F50D} \u6B63\u5728\u8FDB\u884C\u4EE3\u7801\u5BA1\u6838..."));
       try {
@@ -2145,13 +2177,41 @@ function analyzeComplexity(requirement, context) {
   if (!context.framework) score += 0.5;
   return Math.max(1, Math.min(10, Math.round(score)));
 }
-function generateBDDScenarios(requirement, context, questions) {
+function generateBDDScenarios(requirement, context, questions, references = []) {
   const scenarios = [];
   questions.find((q) => q.category === "ui" && q.answered)?.answer;
   const interactionAnswer = questions.find((q) => q.category === "interaction" && q.answered)?.answer;
   const edgeAnswer = questions.find((q) => q.category === "edge" && q.answered)?.answer;
+  if (references.length > 0) {
+    for (const ref of references) {
+      const refFeatures = extractFeaturesFromReference(ref);
+      for (const feature of refFeatures) {
+        const scenario = {
+          feature: feature.title,
+          description: feature.description,
+          scenarios: []
+        };
+        scenario.scenarios.push({
+          name: `\u6B63\u5E38\u6D41\u7A0B: ${feature.title}`,
+          given: [`\u7528\u6237\u8FDB\u5165\u76F8\u5173\u9875\u9762`],
+          when: [`\u7528\u6237\u6267\u884C "${feature.title}" \u64CD\u4F5C`],
+          then: [`\u7CFB\u7EDF\u5E94\u6B63\u786E\u5904\u7406\u5E76\u8FD4\u56DE\u9884\u671F\u7ED3\u679C`]
+        });
+        if (feature.hasInput) {
+          scenario.scenarios.push({
+            name: `\u8FB9\u754C\u60C5\u51B5: \u8F93\u5165\u9A8C\u8BC1`,
+            given: [`\u7528\u6237\u8FDB\u5165\u8F93\u5165\u754C\u9762`],
+            when: [`\u7528\u6237\u8F93\u5165\u8FB9\u754C\u503C\u6216\u7A7A\u503C`],
+            then: [`\u7CFB\u7EDF\u5E94\u6B63\u786E\u5904\u7406\u8FB9\u754C\u60C5\u51B5`]
+          });
+        }
+        scenarios.push(scenario);
+      }
+    }
+  }
   const features = extractFeatures(requirement);
   for (const feature of features) {
+    if (scenarios.some((s) => s.feature === feature.title)) continue;
     const scenario = {
       feature: feature.title,
       description: feature.description,
@@ -2183,6 +2243,46 @@ function generateBDDScenarios(requirement, context, questions) {
   }
   return scenarios;
 }
+function extractFeaturesFromReference(ref) {
+  const features = [];
+  const analysis = ref.analysis.toLowerCase();
+  if (analysis.includes("\u8F93\u5165") || analysis.includes("\u8868\u5355")) {
+    features.push({
+      title: "\u8F93\u5165\u8868\u5355",
+      description: "\u53C2\u8003\u754C\u9762\u4E2D\u7684\u8F93\u5165\u8868\u5355\u529F\u80FD",
+      hasInput: true
+    });
+  }
+  if (analysis.includes("\u6309\u94AE") || analysis.includes("\u64CD\u4F5C")) {
+    features.push({
+      title: "\u4EA4\u4E92\u6309\u94AE",
+      description: "\u53C2\u8003\u754C\u9762\u4E2D\u7684\u6309\u94AE\u4EA4\u4E92",
+      hasInput: false
+    });
+  }
+  if (analysis.includes("\u8868\u683C") || analysis.includes("\u5217\u8868")) {
+    features.push({
+      title: "\u6570\u636E\u5217\u8868",
+      description: "\u53C2\u8003\u754C\u9762\u4E2D\u7684\u6570\u636E\u5C55\u793A",
+      hasInput: false
+    });
+  }
+  if (analysis.includes("\u56FE\u8868") || analysis.includes("\u53EF\u89C6\u5316")) {
+    features.push({
+      title: "\u56FE\u8868\u5C55\u793A",
+      description: "\u53C2\u8003\u754C\u9762\u4E2D\u7684\u56FE\u8868\u53EF\u89C6\u5316",
+      hasInput: false
+    });
+  }
+  if (features.length === 0) {
+    features.push({
+      title: "\u53C2\u8003\u529F\u80FD\u5B9E\u73B0",
+      description: `\u57FA\u4E8E\u53C2\u8003\u8D44\u6E90 ${ref.url} \u5B9E\u73B0\u7684\u529F\u80FD`,
+      hasInput: true
+    });
+  }
+  return features;
+}
 function extractFeatures(requirement) {
   const features = [];
   const urlMatch = requirement.match(/https?:\/\/[^\s]+/);
@@ -2223,15 +2323,26 @@ function extractFeatures(requirement) {
   }
   return features;
 }
-function generateSpecItems(requirement, context, bddScenarios, questions) {
+function generateSpecItems(requirement, context, bddScenarios, questions, references = []) {
   const items = [];
   let id = 1;
+  for (const ref of references) {
+    items.push({
+      id: `T${id.toString().padStart(3, "0")}`,
+      title: `\u53C2\u8003\u5206\u6790: ${ref.type}`,
+      description: `\u5206\u6790\u53C2\u8003\u8D44\u6E90 ${ref.url}`,
+      priority: "high",
+      files: [],
+      tests: []
+    });
+    id++;
+  }
   for (const scenario of bddScenarios) {
     items.push({
       id: `T${id.toString().padStart(3, "0")}`,
       title: scenario.feature,
       description: scenario.description,
-      priority: id <= 2 ? "high" : "medium",
+      priority: id <= 3 ? "high" : "medium",
       files: [],
       tests: []
     });
@@ -2274,6 +2385,19 @@ function formatSpecFile(session) {
     lines.push("---");
     lines.push("");
   }
+  if (session.referenceResources.length > 0) {
+    lines.push("## \u53C2\u8003\u8D44\u6E90");
+    lines.push("");
+    for (const ref of session.referenceResources) {
+      lines.push(`### ${ref.url}`);
+      lines.push(`> \u7C7B\u578B: ${ref.type}`);
+      lines.push("");
+      lines.push(ref.analysis);
+      lines.push("");
+    }
+    lines.push("---");
+    lines.push("");
+  }
   if (session.clarificationQuestions.some((q) => q.answered)) {
     lines.push("## \u9700\u6C42\u6F84\u6E05");
     lines.push("");
@@ -2379,6 +2503,96 @@ function generateSessionId() {
   const random = Math.random().toString(36).slice(2, 6);
   return `WF-${timestamp}-${random}`.toUpperCase();
 }
+function extractUrls(text) {
+  const urlRegex = /https?:\/\/[^\s<>"{}|\\^`\[\]]+/gi;
+  const matches = text.match(urlRegex);
+  return matches ? [...new Set(matches)] : [];
+}
+async function fetchAndAnalyzeReference(url, ctx) {
+  const type = detectResourceType(url);
+  let content = "";
+  let analysis = "";
+  try {
+    const response = await fetch(url, {
+      headers: {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    content = await response.text();
+    if (ctx.modelService.getCurrentModel()) {
+      analysis = await analyzeReferenceContent(url, content, type, ctx);
+    } else {
+      analysis = extractBasicInfo(content, type);
+    }
+  } catch (error) {
+    throw new Error(`\u65E0\u6CD5\u83B7\u53D6\u53C2\u8003\u8D44\u6E90: ${error.message}`);
+  }
+  return { url, type, content: content.slice(0, 1e4), analysis };
+}
+function detectResourceType(url) {
+  if (url.includes("figma.com") || url.includes("lanhuapp.com")) {
+    return "design";
+  }
+  if (/\.(png|jpg|jpeg|gif|webp|svg)$/i.test(url)) {
+    return "image";
+  }
+  if (/api\//i.test(url)) {
+    return "api";
+  }
+  return "webpage";
+}
+async function analyzeReferenceContent(url, content, type, ctx) {
+  const typePrompts = {
+    webpage: "\u5206\u6790\u8FD9\u4E2A\u7F51\u9875\u7684\u529F\u80FD\u3001UI\u7EC4\u4EF6\u548C\u4EA4\u4E92\u65B9\u5F0F",
+    design: "\u5206\u6790\u8FD9\u4E2A\u8BBE\u8BA1\u7A3F\u7684\u5E03\u5C40\u3001\u7EC4\u4EF6\u548C\u6837\u5F0F",
+    image: "\u63CF\u8FF0\u8FD9\u4E2A\u56FE\u7247\u7684\u5185\u5BB9\u548C\u8BBE\u8BA1\u5143\u7D20",
+    api: "\u5206\u6790\u8FD9\u4E2AAPI\u7684\u7ED3\u6784\u548C\u53C2\u6570"
+  };
+  const prompt2 = `
+\u8BF7\u5206\u6790\u4EE5\u4E0B\u53C2\u8003\u8D44\u6E90\u7684 URL\uFF0C\u63D0\u53D6\u5BF9\u5F00\u53D1\u6709\u7528\u7684\u4FE1\u606F\uFF1A
+
+URL: ${url}
+\u7C7B\u578B: ${type}
+
+\u5185\u5BB9\u6458\u8981:
+${content.slice(0, 5e3)}
+
+${typePrompts[type]}
+
+\u8BF7\u63D0\u53D6\uFF1A
+1. \u4E3B\u8981\u529F\u80FD\u70B9
+2. UI\u7EC4\u4EF6\u7ED3\u6784
+3. \u4EA4\u4E92\u65B9\u5F0F
+4. \u6570\u636E\u7ED3\u6784\uFF08\u5982\u679C\u6709\uFF09
+5. \u6280\u672F\u5B9E\u73B0\u5EFA\u8BAE
+
+\u4EE5\u7B80\u6D01\u7684\u8981\u70B9\u5F62\u5F0F\u8F93\u51FA\u3002
+`;
+  try {
+    const response = await ctx.modelService.sendMessage([
+      { role: "user", content: prompt2 }
+    ], { temperature: 0.3, maxTokens: 2e3 });
+    return response.content;
+  } catch {
+    return extractBasicInfo(content, type);
+  }
+}
+function extractBasicInfo(content, type) {
+  const titleMatch = content.match(/<title[^>]*>([^<]+)<\/title>/i);
+  const descMatch = content.match(/<meta[^>]*name=["']description["'][^>]*content=["']([^"']+)["']/i);
+  const parts = [];
+  if (titleMatch) {
+    parts.push(`\u6807\u9898: ${titleMatch[1]}`);
+  }
+  if (descMatch) {
+    parts.push(`\u63CF\u8FF0: ${descMatch[1]}`);
+  }
+  parts.push(`\u8D44\u6E90\u7C7B\u578B: ${type}`);
+  return parts.join("\n");
+}
 function generateComplexityBar(score) {
   const filled = Math.round(score / 2);
   const empty = 5 - filled;
@@ -2388,6 +2602,7 @@ function getPhaseLabel(phase) {
   const labels = {
     context: "\u9879\u76EE\u4E0A\u4E0B\u6587\u83B7\u53D6",
     clarify: "\u9700\u6C42\u6F84\u6E05",
+    reference: "\u53C2\u8003\u8D44\u6E90\u5206\u6790",
     analysis: "\u590D\u6742\u5EA6\u8BC4\u4F30",
     bdd: "BDD \u573A\u666F\u62C6\u89E3",
     spec: "OpenSpec \u89C4\u683C",
@@ -7468,6 +7683,7 @@ var STEP_DISPLAY_NAMES = {
   "archive": "\u5F52\u6863",
   "context": "\u4E0A\u4E0B\u6587",
   "clarify": "\u6F84\u6E05",
+  "reference": "\u53C2\u8003\u5206\u6790",
   "analysis": "\u5206\u6790",
   "bdd": "BDD",
   "spec": "\u89C4\u683C",
@@ -7484,6 +7700,7 @@ var STEP_COLORS = {
   "archive": chalk9__default.default.gray,
   "context": chalk9__default.default.magenta,
   "clarify": chalk9__default.default.yellow,
+  "reference": chalk9__default.default.blue,
   "analysis": chalk9__default.default.blue,
   "bdd": chalk9__default.default.cyan,
   "spec": chalk9__default.default.green,