@shiplens/cli 1.4.5 → 1.4.6

package/lib/assets/actions.json

@@ -693,7 +693,7 @@
     },
     {
       "id": "uninstall_cli",
-      "title": "Delete Shiplens CLI",
+      "title": "Delete Shiplens CLI and Restore Project",
       "suffix": "None",
       "category": "Initial Setup",
       "prompt": "Please prioritize calling Shiplens CLI (Action: uninstall_cli) to execute the above requirements. - Windows: npm.cmd uninstall -g @shiplens/cli - macOS/Linux: npm uninstall -g @shiplens/cli",

package/lib/cli.js

@@ -16,7 +16,7 @@ const { handleContext } = require('./commands/context');
 const { handleMcp } = require('./commands/mcp');
 const { handleAction } = require('./commands/action');
 
-let VERSION = '1.4.4';
+let VERSION = '1.4.6';
 try {
   const pkg = require('../package.json');
   if (pkg.version) VERSION = pkg.version;
@@ -90,7 +90,7 @@ Core Commands:
   heatmap       Retrieve click heatmaps and skeleton wireframes
   dashboards    AI dashboard management and one-click creation (list, create [--ai])
   doctor        Run full end-to-end diagnostics on SDK, credentials, and network
-  context       Manage business context dictionary (push, pull, show)
+  context       Manage business context dictionary (generate, push, pull, show)
   action        Retrieve deterministic steps, commands, and theory for analysis actions (list, <action_id>)
   mcp serve     Run local MCP proxy server with device credentials
 

package/lib/commands/context.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const { getLocalConfig } = require('../config');
+const { generateProjectContext } = require('../context-generator');
 
 /**
  * Get standard storage path for business context: .shiplens/contexts/<app_id>.md
@@ -37,7 +38,7 @@ async function executeWithSafeFallback(fn, maxRetries = 2, baseMs = 500) {
 }
 
 /**
- * Handle context command (push, pull, show)
+ * Handle context command (generate, push, pull, show)
  */
 async function handleContext(subcommand, args, flags, ctx) {
   const targetSub = subcommand || 'show';
@@ -47,6 +48,23 @@ async function handleContext(subcommand, args, flags, ctx) {
   const projectName = flags.name || localCfg.project_name || '';
 
   switch (targetSub) {
+    case 'generate':
+    case 'scan':
+    case 'extract': {
+      const genResult = generateProjectContext(process.cwd(), appId, projectName, flags.framework || localCfg.framework);
+      ctx.output({
+        ok: true,
+        action: 'generate',
+        app_id: appId,
+        file: genResult.filePath,
+        rel_file: genResult.relPath,
+        pages_count: genResult.totalPages,
+        buttons_count: genResult.totalButtons,
+        message: `Project business context scanned and saved to ${genResult.relPath} (${genResult.totalPages} pages, ${genResult.totalButtons} buttons).`,
+      });
+      break;
+    }
+
     case 'push': {
       if (!fs.existsSync(filePath)) {
         const displayPath = path.relative(process.cwd(), filePath) || filePath;
@@ -173,7 +191,7 @@ async function handleContext(subcommand, args, flags, ctx) {
     }
 
     default:
-      throw new Error(`Unknown context subcommand: ${targetSub}. Supported: push, pull, show`);
+      throw new Error(`Unknown context subcommand: ${targetSub}. Supported: generate, push, pull, show`);
   }
 }
 

package/lib/commands/init.js

@@ -3,6 +3,7 @@ const { detectProject, detectExistingApp, injectSDK, injectSkill, installSDKDepe
 const { saveLocalConfig } = require('../config');
 const { saveDeviceEnv } = require('../device-env');
 const { resolveTaxonomyFromIDs, formatTaxonomySummary } = require('../taxonomy');
+const { generateProjectContext } = require('../context-generator');
 
 async function handleInit(args, flags, ctx) {
   const start = Date.now();
@@ -124,7 +125,13 @@ async function handleInit(args, flags, ctx) {
     last_synced_at: new Date().toISOString(),
   });
 
-  // 6. Install SDK dependency
+  // 6. Automatically scan page structures & generate UI business context (.shiplens/contexts/<app_id>.md)
+  let contextResult = null;
+  try {
+    contextResult = generateProjectContext(wd, appId, projectName, framework);
+  } catch (e) {}
+
+  // 7. Install SDK dependency
   let installResult = { success: true, manager: 'skipped' };
   if (!flags['no-install'] && detected.package_manager) {
     installResult = await installSDKDependency(wd, detected.package_manager);
@@ -152,7 +159,7 @@ async function handleInit(args, flags, ctx) {
     }
   }
 
-  // 7. Bind email if specified
+  // 8. Bind email if specified
   let targetEmail = flags.email;
   if (targetEmail === 'auto') {
     targetEmail = getGitEmail();
@@ -195,6 +202,10 @@ async function handleInit(args, flags, ctx) {
     sdk_manager: installResult.manager,
     skill_injected: true,
     skill_file: skillFile,
+    context_generated: !!contextResult,
+    context_file: contextResult ? contextResult.relPath : undefined,
+    context_pages_count: contextResult ? contextResult.totalPages : 0,
+    context_buttons_count: contextResult ? contextResult.totalButtons : 0,
     package_manager: detected.package_manager,
     auth_status: authStatus,
     shiplens_env_written: authStatus === 'magic_link_sent',
@@ -227,6 +238,9 @@ async function handleInit(args, flags, ctx) {
     console.log(`Live Dashboard / Activation URL: 🔗 ${dashboardUrl}`);
     console.log(`User Account: ${accountStatusText}`);
     console.log(`🧠 AI Skill Ready: ${skillFile}`);
+    if (contextResult && contextResult.relPath) {
+      console.log(`📑 Business Context: ${contextResult.relPath} (${contextResult.totalPages} pages, ${contextResult.totalButtons} buttons mapped)`);
+    }
     console.log(`🔒 [SHIPLENS_ATOMIC_COMPLETED] Setup completed atomically. No extra commands needed.`);
     console.log(`==================================================\n`);
 

package/lib/context-generator.js

@@ -0,0 +1,174 @@
+const fs = require('fs');
+const path = require('path');
+const { detectProjectPages } = require('./scanner');
+const { extractPageSkeleton } = require('./extractor');
+
+/**
+ * Infer page purpose from headings, descriptions, and route name
+ */
+function inferPagePurpose(page, headings, descriptions, faqs) {
+  if (descriptions && descriptions.length > 0) {
+    return descriptions[0];
+  }
+  if (headings && headings.length > 0) {
+    return headings.join(' / ');
+  }
+  if (page.path === '/') {
+    return 'Primary landing / core product overview page';
+  }
+  const cleanName = page.name.replace(/[^a-zA-Z0-9_\- ]/g, '');
+  return `Core ${cleanName} feature page`;
+}
+
+/**
+ * Infer intent and next step for interactive controls
+ */
+function inferButtonIntent(btn, page) {
+  if (btn.action_hint) {
+    return btn.action_hint;
+  }
+  const t = (btn.text || '').toLowerCase();
+  if (t.includes('start') || t.includes('free') || t.includes('try') || t.includes('get started') || t.includes('免费') || t.includes('试用')) {
+    return 'Primary conversion CTA / onboarding initiation';
+  }
+  if (t.includes('sign up') || t.includes('register') || t.includes('注册')) {
+    return 'User account registration';
+  }
+  if (t.includes('login') || t.includes('sign in') || t.includes('登录')) {
+    return 'User authentication login';
+  }
+  if (t.includes('upgrade') || t.includes('buy') || t.includes('pro') || t.includes('pricing') || t.includes('订阅') || t.includes('购买')) {
+    return 'Monetization checkout / subscription upgrade';
+  }
+  if (t.includes('save') || t.includes('submit') || t.includes('保存') || t.includes('提交')) {
+    return 'Save settings or submit form data';
+  }
+  if (t.includes('delete') || t.includes('remove') || t.includes('删除')) {
+    return 'Delete or purge data item';
+  }
+  if (t.includes('calculate') || t.includes('search') || t.includes('filter') || t.includes('计算') || t.includes('查询')) {
+    return 'Execute calculation / filter workflow';
+  }
+  return `Trigger ${btn.tag} interaction on ${page.path}`;
+}
+
+/**
+ * Generate standard business context markdown and write to .shiplens/contexts/<app_id>.md
+ * @param {string} dir Project root directory
+ * @param {string} appId Target App ID
+ * @param {string} projectName Project Name
+ * @param {string} framework Framework detected
+ * @returns {{ filePath: string, relPath: string, totalPages: number, totalButtons: number, markdown: string }}
+ */
+function generateProjectContext(dir = process.cwd(), appId, projectName = 'My App', framework = 'custom') {
+  const { framework: detectedFramework, pages } = detectProjectPages(dir);
+  const activeFramework = framework || detectedFramework;
+
+  const pageDetails = [];
+  let totalButtonsCount = 0;
+
+  for (const p of pages) {
+    const skeleton = extractPageSkeleton(p.filePath, p.path, p.name);
+    const purpose = inferPagePurpose(p, skeleton.headings, skeleton.descriptions, skeleton.faqs);
+    totalButtonsCount += skeleton.raw_buttons.length;
+    pageDetails.push({
+      ...p,
+      relFilePath: path.relative(dir, p.filePath).replace(/\\/g, '/'),
+      purpose,
+      headings: skeleton.headings,
+      faqs: skeleton.faqs,
+      feature_bullets: skeleton.feature_bullets,
+      descriptions: skeleton.descriptions,
+      buttons: skeleton.raw_buttons.map((b) => ({
+        ...b,
+        intent: inferButtonIntent(b, p),
+      })),
+    });
+  }
+
+  const now = new Date().toISOString();
+  const mdLines = [
+    '# Shiplens Project Business Context & UI Dictionary',
+    '',
+    `> **Project Name**: ${projectName}`,
+    `> **App ID**: ${appId}`,
+    `> **Framework**: ${activeFramework}`,
+    `> **Generated At**: ${now}`,
+    '',
+    '---',
+    '',
+    '## 1. Page & Route Catalog',
+    '',
+  ];
+
+  if (pageDetails.length === 0) {
+    mdLines.push('*No frontend template pages detected during initial static scanning.*');
+    mdLines.push('');
+  } else {
+    for (const p of pageDetails) {
+      mdLines.push(`### Page: ${p.name} (\`${p.path}\`)`);
+      mdLines.push(`- **Source File**: [\`${p.relFilePath}\`](file:///${path.resolve(dir, p.relFilePath).replace(/\\/g, '/')})`);
+      mdLines.push(`- **Page Purpose**: ${p.purpose}`);
+
+      if (p.headings.length > 0) {
+        mdLines.push(`- **Key Headings**: ${p.headings.map((h) => `\`${h}\``).join(', ')}`);
+      }
+      if (p.feature_bullets.length > 0) {
+        mdLines.push('- **Feature Highlights**:');
+        for (const f of p.feature_bullets.slice(0, 5)) {
+          mdLines.push(`  - ${f}`);
+        }
+      }
+      if (p.faqs.length > 0) {
+        mdLines.push('- **FAQ Context**:');
+        for (const f of p.faqs.slice(0, 3)) {
+          mdLines.push(`  - Q: ${f.q}${f.a ? ` -> A: ${f.a}` : ''}`);
+        }
+      }
+
+      if (p.buttons.length > 0) {
+        mdLines.push('');
+        mdLines.push(`#### Interactive Elements & Buttons (${p.buttons.length}):`);
+        mdLines.push('| Button ID | Text / Label | Selector | Inferred Action / Intent |');
+        mdLines.push('| :--- | :--- | :--- | :--- |');
+        for (const b of p.buttons) {
+          const textDisplay = (b.text || '').replace(/\|/g, '\\|').trim() || '(icon/action)';
+          mdLines.push(`| \`${b.id}\` | ${textDisplay} | \`${b.selector}\` | ${b.intent} |`);
+        }
+      } else {
+        mdLines.push('- **Interactive Elements**: *(No buttons or interactive controls found on this page)*');
+      }
+      mdLines.push('');
+    }
+  }
+
+  mdLines.push('---');
+  mdLines.push('');
+  mdLines.push('## 2. Business Metric Grounding');
+  mdLines.push(`- **Total Pages Mapped**: ${pageDetails.length}`);
+  mdLines.push(`- **Total Interactive Controls**: ${totalButtonsCount}`);
+  mdLines.push('- **Usage**: When analyzing drop-offs, funnels, or heatmaps, reference the Button IDs and Page Purposes above to translate technical telemetry into actionable product insights.');
+  mdLines.push('');
+
+  const markdownContent = mdLines.join('\n');
+
+  // Standard storage path: .shiplens/contexts/<app_id>.md
+  const contextDir = path.join(dir, '.shiplens', 'contexts');
+  fs.mkdirSync(contextDir, { recursive: true });
+  const targetFilePath = path.join(contextDir, `${appId}.md`);
+  fs.writeFileSync(targetFilePath, markdownContent, 'utf8');
+
+  return {
+    filePath: targetFilePath,
+    relPath: path.relative(dir, targetFilePath).replace(/\\/g, '/'),
+    totalPages: pageDetails.length,
+    totalButtons: totalButtonsCount,
+    markdown: markdownContent,
+  };
+}
+
+module.exports = {
+  generateProjectContext,
+  inferPagePurpose,
+  inferButtonIntent,
+};

package/lib/extractor.js

@@ -0,0 +1,300 @@
+const fs = require('fs');
+
+/**
+ * 清洗代码字符串，去除注释、import、CSS-in-JS 与复杂逻辑噪音
+ * @param {string} rawCode 原始文件代码
+ * @returns {string} 精简后的模板与文案字符串
+ */
+function cleanCode(rawCode) {
+  return rawCode
+    // 移除多行注释与 JSDoc
+    .replace(/\/\*[\s\S]*?\*\//g, '')
+    // 移除单行注释
+    .replace(/\/\/.*$/gm, '')
+    // 移除 import 语句
+    .replace(/^import\s+[\s\S]*?from\s+['"].*?['"];?/gm, '')
+    // 移除 require 语句
+    .replace(/const\s+.*?=\s*require\(.*?\);?/gm, '');
+}
+
+/**
+ * 深度提取页面内的多维富文本文案：
+ * 包含：H1~H6 标题、FAQ 折叠问答、套餐权益列表 (li)、卡片段落描述 (p)、Badge 标签
+ * @param {string} code 清洗后的代码
+ * @returns {{ headings: string[], faqs: Array<{ q: string, a?: string }>, feature_bullets: string[], descriptions: string[] }}
+ */
+function extractRichPageContent(code) {
+  const headings = [];
+  const faqs = [];
+  const featureBullets = [];
+  const descriptions = [];
+
+  // 1. 提取 H1 到 H6 标题
+  const headingRegex = /<h[1-6][^>]*>([\s\S]*?)<\/h[1-6]>/gi;
+  let match;
+  while ((match = headingRegex.exec(code)) !== null) {
+    const text = cleanTagContent(match[1]);
+    if (text && text.length > 1 && text.length < 120 && !headings.includes(text)) {
+      headings.push(text);
+    }
+  }
+
+  // 2. 提取 FAQ 问答结构 (<details><summary> 或常见 FAQ 容器)
+  const detailsRegex = /<details[^>]*>[\s\S]*?<summary[^>]*>([\s\S]*?)<\/summary>([\s\S]*?)<\/details>/gi;
+  while ((match = detailsRegex.exec(code)) !== null) {
+    const question = cleanTagContent(match[1]);
+    const answer = cleanTagContent(match[2]);
+    if (question && question.length > 2) {
+      faqs.push({
+        q: question,
+        ...(answer ? { a: answer.slice(0, 150) } : {})
+      });
+    }
+  }
+
+  // 匹配 dt/dd 键值问答
+  const dtRegex = /<dt[^>]*>([\s\S]*?)<\/dt>[\s\S]*?<dd[^>]*>([\s\S]*?)<\/dd>/gi;
+  while ((match = dtRegex.exec(code)) !== null) {
+    const q = cleanTagContent(match[1]);
+    const a = cleanTagContent(match[2]);
+    if (q && q.length > 2 && !faqs.some(f => f.q === q)) {
+      faqs.push({ q, ...(a ? { a: a.slice(0, 150) } : {}) });
+    }
+  }
+
+  // 3. 提取套餐权益与核心特性列表 (<li>)
+  const liRegex = /<li[^>]*>([\s\S]*?)<\/li>/gi;
+  while ((match = liRegex.exec(code)) !== null) {
+    const text = cleanTagContent(match[1]);
+    if (text && text.length > 2 && text.length < 100 && !featureBullets.includes(text)) {
+      featureBullets.push(text);
+    }
+  }
+
+  // 4. 提取核心描述段落 (<p> 及含有 desc/title/text 类的元素)
+  const pRegex = /<p[^>]*>([\s\S]*?)<\/p>/gi;
+  while ((match = pRegex.exec(code)) !== null) {
+    const text = cleanTagContent(match[1]);
+    if (text && text.length > 5 && text.length < 200 && !descriptions.includes(text) && !headings.includes(text)) {
+      descriptions.push(text);
+    }
+  }
+
+  return {
+    headings: headings.slice(0, 8),
+    faqs: faqs.slice(0, 10),
+    feature_bullets: featureBullets.slice(0, 12),
+    descriptions: descriptions.slice(0, 6)
+  };
+}
+
+/**
+ * 提取页面内所有的交互按钮、链接和提交控件
+ * 采用状态机/匹配法准确跳过 JSX 属性中的 arrow function `() =>` 和花括号
+ * @param {string} code 清洗后的代码
+ * @returns {Array<{ id: string, tag: string, text: string, selector: string, label?: string, action_hint?: string }>}
+ */
+function extractInteractiveElements(code) {
+  const elements = [];
+  let elementIndex = 1;
+
+  // 匹配所有 <button, <a, <Link, <input, <div, <span 开头的标签
+  const tagStartRegex = /<([a-zA-Z0-9_-]+)\s+/g;
+  let match;
+
+  while ((match = tagStartRegex.exec(code)) !== null) {
+    const tag = match[1];
+    const targetTags = ['button', 'a', 'link', 'input', 'div', 'span'];
+    if (!targetTags.includes(tag.toLowerCase())) {
+      continue;
+    }
+
+    const startIndex = match.index;
+    let index = startIndex + match[0].length;
+    let inQuotes = null;
+    let braceDepth = 0;
+    let isSelfClosing = false;
+    let tagEndIndex = -1;
+
+    // 解析属性直到遇到真正的 '>'
+    while (index < code.length) {
+      const char = code[index];
+      const prevChar = code[index - 1];
+
+      if (inQuotes) {
+        if (char === inQuotes && prevChar !== '\\') {
+          inQuotes = null;
+        }
+      } else if (char === '"' || char === "'" || char === '`') {
+        inQuotes = char;
+      } else if (char === '{') {
+        braceDepth += 1;
+      } else if (char === '}') {
+        braceDepth = Math.max(0, braceDepth - 1);
+      } else if (char === '>' && braceDepth === 0) {
+        tagEndIndex = index;
+        if (code[index - 1] === '/') {
+          isSelfClosing = true;
+        }
+        break;
+      }
+      index += 1;
+    }
+
+    if (tagEndIndex === -1) continue;
+
+    const attrs = code.slice(startIndex + tag.length + 1, tagEndIndex);
+    let innerContent = '';
+
+    if (!isSelfClosing) {
+      // 寻找对应的闭合标签 </tag>
+      const closeTagStr = `</${tag}>`;
+      const closeTagIndex = code.indexOf(closeTagStr, tagEndIndex + 1);
+      if (closeTagIndex !== -1 && closeTagIndex - tagEndIndex < 2000) {
+        innerContent = code.slice(tagEndIndex + 1, closeTagIndex);
+      }
+    }
+
+    // 判断是否可交互
+    const isExplicitButton = /^(button|a|link)$/i.test(tag);
+    const hasClick = /onClick|@click|v-on:click|role=["']button["']/i.test(attrs);
+    const isSubmit = /type=["']submit["']/i.test(attrs);
+
+    if (!isExplicitButton && !hasClick && !isSubmit) {
+      continue;
+    }
+
+    // 提取 id
+    const idMatch = attrs.match(/\bid=["']([^"']+)["']/i);
+    const rawId = idMatch ? idMatch[1] : null;
+
+    // 提取 data-shiplens-label
+    const labelMatch = attrs.match(/data-shiplens-label=["']([^"']+)["']/i);
+    const explicitLabel = labelMatch ? labelMatch[1] : null;
+
+    // 提取 class/className
+    const classMatch = attrs.match(/(?:class|className)=["']([^"']+)["']/i);
+    const classStr = classMatch ? cleanClassName(classMatch[1]) : '';
+
+    // 提取文案
+    const text = cleanTagContent(innerContent) || extractInputValue(attrs);
+
+    // 提取 href / to / onClick 提示
+    const hrefMatch = attrs.match(/(?:href|to)=["']([^"']+)["']/i);
+    const href = hrefMatch ? hrefMatch[1] : '';
+
+    const clickMatch = attrs.match(/(?:onClick|@click)=["']?\{?([^"'>}]+)\}?["']?/i);
+    const clickHandler = clickMatch ? clickMatch[1].trim() : '';
+
+    // 生成稳定 ID
+    const stableId = explicitLabel 
+      || rawId 
+      || generateIdFromTextOrClass(text, classStr, tag, elementIndex);
+
+    // 生成可读 CSS 选择器
+    const selector = rawId 
+      ? `#${rawId}` 
+      : classStr 
+      ? `${tag.toLowerCase()}.${classStr.split(' ')[0]}` 
+      : `${tag.toLowerCase()}`;
+
+    // 动作推断线索
+    let actionHint = '';
+    if (href) actionHint = `navigate to ${href}`;
+    else if (clickHandler) actionHint = `calls ${clickHandler}`;
+    else if (isSubmit) actionHint = 'submit form';
+
+    elements.push({
+      id: stableId,
+      tag: tag.toLowerCase(),
+      text: text || '(图标/无文案)',
+      selector: selector,
+      ...(explicitLabel ? { label: explicitLabel } : {}),
+      ...(actionHint ? { action_hint: actionHint } : {})
+    });
+
+    elementIndex += 1;
+  }
+
+  // 去重保底（相同 id 保留第一个）
+  const seenIds = new Set();
+  return elements.filter(el => {
+    if (seenIds.has(el.id)) return false;
+    seenIds.add(el.id);
+    return true;
+  });
+}
+
+function cleanTagContent(content) {
+  if (!content) return '';
+  return content
+    .replace(/<[^>]*>/g, ' ')
+    .replace(/\{[^}]*\}/g, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function extractInputValue(attrs) {
+  const match = attrs.match(/value=["']([^"']+)["']/i);
+  return match ? match[1].trim() : '';
+}
+
+function cleanClassName(classStr) {
+  if (!classStr) return '';
+  return classStr
+    .split(/\s+/)
+    .filter(c => c && !/^(css-|_[a-z0-9]{5,}|[a-z0-9]{8,})/i.test(c))
+    .slice(0, 2)
+    .join(' ');
+}
+
+function generateIdFromTextOrClass(text, classStr, tag, index) {
+  if (text && text.length >= 2 && text.length <= 30 && /^[\u4e00-\u9fa5a-zA-Z0-9_\-\s]+$/.test(text)) {
+    const slug = text
+      .trim()
+      .toLowerCase()
+      .replace(/\s+/g, '_')
+      .replace(/[\u4e00-\u9fa5]+/g, (match) => `btn_${encodeURIComponent(match).replace(/%/g, '').slice(0, 8)}`)
+      .replace(/[^a-zA-Z0-9_]/g, '');
+    if (slug) return `btn_${slug.slice(0, 20)}`;
+  }
+
+  if (classStr) {
+    const firstClass = classStr.split(' ')[0].replace(/[^a-zA-Z0-9_-]/g, '');
+    if (firstClass) return `btn_${firstClass}`;
+  }
+
+  return `btn_${tag.toLowerCase()}_${index}`;
+}
+
+/**
+ * 完整解析一个页面的结构与富文本骨架
+ * @param {string} filePath 文件路径
+ * @param {string} routePath 对应路由
+ * @param {string} pageName 页面候选名称
+ * @returns {{ path: string, name: string, headings: string[], faqs: Array, feature_bullets: string[], descriptions: string[], raw_buttons: Array }}
+ */
+function extractPageSkeleton(filePath, routePath, pageName) {
+  if (!fs.existsSync(filePath)) {
+    return { path: routePath, name: pageName, headings: [], faqs: [], feature_bullets: [], descriptions: [], raw_buttons: [] };
+  }
+
+  const rawCode = fs.readFileSync(filePath, 'utf-8');
+  const code = cleanCode(rawCode);
+  const richContent = extractRichPageContent(code);
+  const rawButtons = extractInteractiveElements(code);
+
+  return {
+    path: routePath,
+    name: pageName,
+    ...richContent,
+    raw_buttons: rawButtons
+  };
+}
+
+module.exports = {
+  cleanCode,
+  extractRichPageContent,
+  extractInteractiveElements,
+  extractPageSkeleton
+};

package/lib/scanner.js

@@ -0,0 +1,152 @@
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 递归扫描目录中的代码文件
+ * @param {string} dir 目标目录
+ * @param {string[]} extensions 支持的扩展名
+ * @param {string[]} ignoreDirs 忽略的目录
+ * @returns {string[]} 文件绝对路径列表
+ */
+function scanFiles(dir, extensions = ['.tsx', '.jsx', '.vue', '.html', '.svelte', '.js', '.ts'], ignoreDirs = ['node_modules', '.git', '.next', 'dist', 'build', 'out', '.agents']) {
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (!ignoreDirs.includes(entry.name)) {
+        results.push(...scanFiles(fullPath, extensions, ignoreDirs));
+      }
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name).toLowerCase();
+      if (extensions.includes(ext)) {
+        results.push(fullPath);
+      }
+    }
+  }
+  return results;
+}
+
+/**
+ * 自动探测项目类型并提取页面路由列表
+ * @param {string} rootDir 项目根目录
+ * @returns {{ framework: string, pages: Array<{ path: string, filePath: string, name: string }> }}
+ */
+function detectProjectPages(rootDir) {
+  const pages = [];
+  let framework = 'custom';
+
+  // 1. 检测 Next.js App Router (src/app 或 app)
+  const appRouterDir = fs.existsSync(path.join(rootDir, 'src', 'app')) 
+    ? path.join(rootDir, 'src', 'app') 
+    : fs.existsSync(path.join(rootDir, 'app')) 
+    ? path.join(rootDir, 'app') 
+    : null;
+
+  if (appRouterDir) {
+    framework = 'nextjs-app-router';
+    const allFiles = scanFiles(appRouterDir, ['.tsx', '.jsx', '.js', '.ts']);
+    for (const file of allFiles) {
+      const baseName = path.basename(file);
+      if (/^page\.(tsx|jsx|js|ts)$/.test(baseName)) {
+        const relDir = path.relative(appRouterDir, path.dirname(file));
+        const routePath = relDir === '' ? '/' : `/${relDir.replace(/\\/g, '/').replace(/\(.*?\)\/?/g, '')}`;
+        pages.push({
+          path: routePath || '/',
+          filePath: file,
+          name: routePath === '/' ? 'Home (首页)' : routePath
+        });
+      }
+    }
+  }
+
+  // 2. 检测 Next.js / Nuxt Pages Router (src/pages 或 pages)
+  if (pages.length === 0) {
+    const pagesRouterDir = fs.existsSync(path.join(rootDir, 'src', 'pages')) 
+      ? path.join(rootDir, 'src', 'pages') 
+      : fs.existsSync(path.join(rootDir, 'pages')) 
+      ? path.join(rootDir, 'pages') 
+      : null;
+
+    if (pagesRouterDir) {
+      framework = 'pages-router';
+      const allFiles = scanFiles(pagesRouterDir, ['.tsx', '.jsx', '.vue', '.js', '.ts']);
+      for (const file of allFiles) {
+        const rel = path.relative(pagesRouterDir, file);
+        const nameWithoutExt = rel.replace(/\.[^/.]+$/, '').replace(/\\/g, '/');
+        if (nameWithoutExt.startsWith('_') || nameWithoutExt.startsWith('api/')) continue;
+
+        const routePath = nameWithoutExt === 'index' ? '/' : `/${nameWithoutExt.replace(/\/index$/, '')}`;
+        pages.push({
+          path: routePath,
+          filePath: file,
+          name: routePath === '/' ? 'Home (首页)' : routePath
+        });
+      }
+    }
+  }
+
+  // 3. 检测通用 Vite / React / Vue (src/views, src/routes, src/pages, 或扫描全部 .vue/.tsx 组件)
+  if (pages.length === 0) {
+    const candidateDirs = ['src/views', 'src/pages', 'src/routes', 'src/components', 'src'].map(d => path.join(rootDir, d));
+    for (const cDir of candidateDirs) {
+      if (fs.existsSync(cDir)) {
+        const files = scanFiles(cDir, ['.tsx', '.jsx', '.vue', '.html', '.svelte']);
+        for (const file of files) {
+          const base = path.basename(file, path.extname(file));
+          // 过滤通用辅助或原子组件 (如 Button, Icon, Header)
+          if (/^(Page|View|Screen|Home|Pricing|Login|Dashboard|Checkout|Register|Setting|About)/i.test(base)) {
+            const cleanName = base.toLowerCase().replace(/(page|view|screen)$/i, '');
+            const routePath = cleanName === 'home' || cleanName === 'index' ? '/' : `/${cleanName}`;
+            pages.push({
+              path: routePath,
+              filePath: file,
+              name: base
+            });
+          }
+        }
+        if (pages.length > 0) {
+          framework = 'vite-react-vue';
+          break;
+        }
+      }
+    }
+  }
+
+  // 4. 静态 HTML 项目保底
+  if (pages.length === 0) {
+    const htmlFiles = scanFiles(rootDir, ['.html'], ['node_modules', '.git', 'dist']);
+    if (htmlFiles.length > 0) {
+      framework = 'static-html';
+      for (const file of htmlFiles) {
+        const rel = path.relative(rootDir, file).replace(/\\/g, '/');
+        const routePath = rel === 'index.html' ? '/' : `/${rel.replace(/\.html$/, '')}`;
+        pages.push({
+          path: routePath,
+          filePath: file,
+          name: path.basename(file)
+        });
+      }
+    }
+  }
+
+  // 去重保底
+  const uniqueMap = new Map();
+  for (const p of pages) {
+    if (!uniqueMap.has(p.path)) {
+      uniqueMap.set(p.path, p);
+    }
+  }
+
+  return {
+    framework,
+    pages: Array.from(uniqueMap.values())
+  };
+}
+
+module.exports = {
+  scanFiles,
+  detectProjectPages
+};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shiplens/cli",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "description": "Shiplens CLI — Automated Web User Analytics & AI Agent Analysis Engine",
   "main": "lib/index.js",
   "bin": {
-    "cli": "./bin/shiplens.js",
-    "shiplens": "./bin/shiplens.js",
-    "shiplens-cli": "./bin/shiplens.js"
+    "cli": "bin/shiplens.js",
+    "shiplens": "bin/shiplens.js",
+    "shiplens-cli": "bin/shiplens.js"
   },
   "keywords": [
     "shiplens",

package/prompts/prompts_cli_en-US.md

@@ -781,7 +781,7 @@ Delete Shiplens project analytics data and SDK integration (analytics no longer
 Please prioritize calling Shiplens CLI (Action: remove_sdk) to execute the above requirements.
 ```
 
-#### [uninstall_cli] Delete Shiplens CLI (Suffix: None)
+#### [uninstall_cli] Delete Shiplens CLI and Restore Project (Suffix: None)
 ```text
 Please prioritize calling Shiplens CLI (Action: uninstall_cli) to execute the above requirements.
  - Windows: npm.cmd uninstall -g @shiplens/cli