@shiplens/cli 1.4.2 → 1.4.3

package/lib/injector.js

@@ -95,7 +95,7 @@ function detectProject(dir = process.cwd()) {
     }
   }
 
-  // 若无 description，尝试从 README.md 提取第一段有效文本
+  // Extract description fallback from README if missing
   if (!result.description) {
     const readmeCandidates = ['README.md', 'readme.md', 'README.MD'];
     for (const r of readmeCandidates) {
@@ -113,7 +113,7 @@ function detectProject(dir = process.cwd()) {
     }
   }
 
-  // 4 级分类自动推断
+  // 4-level taxonomy inference
   const taxonomy = inferTaxonomy({
     name: result.project_name,
     description: result.description,
@@ -286,7 +286,7 @@ function injectCRA(dir, appId) {
       if (content.includes('@shiplens/sdk') || content.includes('initShiplens') || content.includes(appId)) {
         return cand;
       }
-      const injection = `\n// Shiplens SDK - 用户行为数据采集\nconst { initShiplens } = require('@shiplens/sdk');\ninitShiplens({ appId: '${appId}' });\n`;
+      const injection = `\n// Shiplens SDK - User Analytics\nconst { initShiplens } = require('@shiplens/sdk');\ninitShiplens({ appId: '${appId}' });\n`;
       fs.writeFileSync(p, content + injection, 'utf8');
       return cand;
     }
@@ -351,7 +351,7 @@ async function installSDKDependency(dir, pkgManager = 'npm') {
   const sources = [
     {
       id: 'npmjs',
-      name: 'NPM 官方源 (npm registry)',
+      name: 'npm registry',
       getCommand: (pm) => {
         if (pm === 'pnpm') return `pnpm${ext} add @shiplens/sdk`;
         if (pm === 'yarn') return `yarn${ext} add @shiplens/sdk`;
@@ -361,7 +361,7 @@ async function installSDKDependency(dir, pkgManager = 'npm') {
     },
     {
       id: 'npmmirror',
-      name: '阿里云/淘宝镜像源 (npmmirror)',
+      name: 'Alibaba Cloud mirror (npmmirror)',
       getCommand: (pm) => {
         const mirror = '--registry=https://registry.npmmirror.com';
         if (pm === 'pnpm') return `pnpm${ext} add @shiplens/sdk ${mirror}`;
@@ -372,7 +372,7 @@ async function installSDKDependency(dir, pkgManager = 'npm') {
     },
     {
       id: 'github',
-      name: 'GitHub 源码镜像',
+      name: 'GitHub mirror',
       getCommand: (pm) => {
         const repoUrl = 'https://github.com/Hyperlong/shiplens-sdk.git';
         if (pm === 'pnpm') return `pnpm${ext} add ${repoUrl}`;
@@ -383,7 +383,7 @@ async function installSDKDependency(dir, pkgManager = 'npm') {
     },
     {
       id: 'cdn',
-      name: 'Shiplens 官方 CDN 镜像',
+      name: 'Shiplens CDN mirror',
       getCommand: (pm) => {
         const cdnUrl = 'https://cdn.shiplens.dev/packages/shiplens-sdk.tgz';
         if (pm === 'pnpm') return `pnpm${ext} add ${cdnUrl}`;
@@ -394,8 +394,8 @@ async function installSDKDependency(dir, pkgManager = 'npm') {
     },
   ];
 
-  const TIER1_DELAY_MS = 20 * 1000; // 20秒阶梯
-  const TOTAL_TIMEOUT_MS = 5 * 60 * 1000; // 5分钟总超时
+  const TIER1_DELAY_MS = 20 * 1000; // 20s
+  const TOTAL_TIMEOUT_MS = 5 * 60 * 1000; // 5min
 
   return new Promise((resolve) => {
     let isDone = false;
@@ -473,25 +473,25 @@ async function installSDKDependency(dir, pkgManager = 'npm') {
         cleanupAndFinish({
           success: false,
           manager: pkgManager,
-          error: '4 个下载源均已失败或超时',
+          error: 'All 4 download sources failed or timed out',
         });
       }
     };
 
-    // t = 0s: 启动 Tier 1 (npmjs)
+    // t = 0s: Start Tier 1 (npmjs)
     runSource(sources[0]);
 
-    // t = 20s: 若仍未完成，保持 npmjs 并发启动 npmmirror + GitHub + CDN
+    // t = 20s: If still running, keep npmjs alive and start npmmirror + GitHub + CDN
     tier2Timer = setTimeout(() => {
       startBackupSources();
     }, TIER1_DELAY_MS);
 
-    // t = 5min: 全部源总超时
+    // t = 5min: Total timeout across all sources
     totalTimer = setTimeout(() => {
       cleanupAndFinish({
         success: false,
         manager: pkgManager,
-        error: '所有下载源在 5 分钟后均已超时',
+        error: 'SDK installation timed out after 5 minutes across all download sources',
       });
     }, TOTAL_TIMEOUT_MS);
   });
@@ -508,14 +508,14 @@ function getGitEmail() {
 function injectSkill(dir = process.cwd()) {
   const { SKILL_CONTENT } = require('./assets/skill');
   
-  // 1. 生成通用 Agent Skill 目录 (.agents/skills/shiplens/SKILL.md)
+  // 1. Generate generic Agent Skill (.agents/skills/shiplens/SKILL.md)
   const agentSkillDir = path.join(dir, '.agents', 'skills', 'shiplens');
   try {
     fs.mkdirSync(agentSkillDir, { recursive: true });
     fs.writeFileSync(path.join(agentSkillDir, 'SKILL.md'), SKILL_CONTENT, 'utf8');
   } catch (e) {}
 
-  // 2. 生成 Cursor 专属规则 (.cursor/rules/shiplens.mdc)
+  // 2. Generate Cursor rule (.cursor/rules/shiplens.mdc)
   const cursorRulesDir = path.join(dir, '.cursor', 'rules');
   try {
     fs.mkdirSync(cursorRulesDir, { recursive: true });
@@ -526,7 +526,7 @@ function injectSkill(dir = process.cwd()) {
 }
 
 function detectExistingApp(dir = process.cwd()) {
-  // 1. 检查本地 .shiplens.json 状态机
+  // 1. Check local .shiplens.json state machine
   const cfgPath = path.join(dir, '.shiplens.json');
   if (fs.existsSync(cfgPath)) {
     try {
@@ -543,7 +543,7 @@ function detectExistingApp(dir = process.cwd()) {
     } catch (e) {}
   }
 
-  // 2. 检查代码入口中的插桩
+  // 2. Check code files for existing instrumentation
   const checkFiles = [
     'src/app/layout.tsx', 'app/layout.tsx',
     'src/app/layout.jsx', 'app/layout.jsx',
@@ -567,7 +567,6 @@ function detectExistingApp(dir = process.cwd()) {
     if (fs.existsSync(p)) {
       try {
         const content = fs.readFileSync(p, 'utf8');
-        // 匹配 appId: 'sl_live_...' 或 data-app-id="sl_live_..."
         const matchAppId = content.match(/appId\s*:\s*['"]([^'"]+)['"]/);
         if (matchAppId && matchAppId[1]) {
           return {
@@ -584,7 +583,6 @@ function detectExistingApp(dir = process.cwd()) {
             source_file: rel,
           };
         }
-        // 如果包含 @shiplens/sdk 或 cdn.shiplens.dev 但未提取到具体 ID
         if (content.includes('@shiplens/sdk') || content.includes('cdn.shiplens.dev/sdk.js') || content.includes('initShiplens')) {
           return {
             has_existing: true,
@@ -596,7 +594,7 @@ function detectExistingApp(dir = process.cwd()) {
     }
   }
 
-  // 3. 检查 package.json 依赖
+  // 3. Check package.json dependencies
   const pkgPath = path.join(dir, 'package.json');
   if (fs.existsSync(pkgPath)) {
     try {
@@ -625,4 +623,3 @@ module.exports = {
   installSDKDependency,
   getGitEmail,
 };
-

package/lib/mcp-config.js

@@ -38,7 +38,7 @@ function getMcpServer(client, url) {
 }
 
 function getMcpConfig(client, url) {
-  if (!CLIENTS.includes(client)) throw makeError(`不支持的 MCP 客户端: ${client}`, 'UNSUPPORTED_MCP_CLIENT');
+  if (!CLIENTS.includes(client)) throw makeError(`Unsupported MCP client: ${client}`, 'UNSUPPORTED_MCP_CLIENT');
   return { mcpServers: { shiplens: getMcpServer(client, url) } };
 }
 
@@ -49,7 +49,7 @@ function readJsonConfig(filePath) {
     if (!value || Array.isArray(value) || typeof value !== 'object') throw new Error('root must be object');
     return value;
   } catch (error) {
-    throw makeError(`无法读取 MCP 配置 ${filePath}：请先修复 JSON 后重试`, 'INVALID_MCP_CONFIG');
+    throw makeError(`Failed to read MCP config at ${filePath}: invalid JSON`, 'INVALID_MCP_CONFIG');
   }
 }
 
@@ -70,8 +70,8 @@ function mergeJsonMcpConfig(client, url, filePath) {
 }
 
 function configureMcpClient(client, url, options = {}) {
-  if (!CLIENTS.includes(client)) throw makeError(`不支持的 MCP 客户端: ${client}`, 'UNSUPPORTED_MCP_CLIENT');
-  if (!url) throw makeError('MCP 地址不能为空', 'MCP_URL_REQUIRED');
+  if (!CLIENTS.includes(client)) throw makeError(`Unsupported MCP client: ${client}`, 'UNSUPPORTED_MCP_CLIENT');
+  if (!url) throw makeError('MCP URL is required', 'MCP_URL_REQUIRED');
 
   if (client === 'manual') {
     return { written: false, already_configured: false, path: null, config: getMcpConfig('manual', url) };
@@ -88,7 +88,7 @@ function configureMcpClient(client, url, options = {}) {
   try {
     exec(codexCommand, ['mcp', 'add', 'shiplens', '--', process.platform === 'win32' ? 'npx.cmd' : 'npx', '--yes', 'shiplens-cli', 'mcp', 'serve'], { stdio: 'ignore' });
   } catch (error) {
-    throw makeError('无法调用 Codex MCP 配置命令，请确认 Codex Desktop 已安装并可在终端中运行 codex。', 'CODEX_MCP_CONFIG_FAILED');
+    throw makeError('Failed to configure Codex MCP. Ensure Codex Desktop is installed and codex CLI is available in PATH.', 'CODEX_MCP_CONFIG_FAILED');
   }
   return { written: true, already_configured: false, path: configPath, config: getMcpConfig('codex', url) };
 }

package/lib/taxonomy.js

@@ -11,7 +11,6 @@ function loadTaxonomy() {
     if (fs.existsSync(filePath)) {
       taxonomyCache = JSON.parse(fs.readFileSync(filePath, 'utf8'));
     } else {
-      // 容错兜底
       taxonomyCache = { genres: [] };
     }
   } catch (e) {
@@ -74,15 +73,15 @@ function buildIndex() {
 }
 
 const CATEGORY_DISPLAY_NAMES = {
-  core_features: '核心功能',
-  monetization: '变现模式',
-  social_engagement: '社交促活',
-  technical_platform: '技术平台',
-  content_theme: '内容与合规',
+  core_features: 'Core Features',
+  monetization: 'Monetization',
+  social_engagement: 'Social & Growth',
+  technical_platform: 'Technical Platform',
+  content_theme: 'Content & Compliance',
 };
 
 /**
- * 根据项目的名称、简介、依赖、目录特征自动推断最契合的 4 级分类与特性标签
+ * Automatically infer 4-level taxonomy and feature tags from project context
  */
 function inferTaxonomy(projectContext = {}) {
   const { genresMap, subgenresMap, tagsMap } = buildIndex();
@@ -103,7 +102,7 @@ function inferTaxonomy(projectContext = {}) {
   let matchedSubgenreId = 'developer_tools';
   const matchedTags = new Set();
 
-  // 1. 判断是否为 Game
+  // 1. Game detection
   const isGame =
     depKeys.some((d) => ['phaser', 'pixi.js', 'three', 'kaboom', 'melonjs'].includes(d)) ||
     /\b(game|arcade|rpg|puzzle|casual|roguelike|fps|chess|cards)\b/.test(combinedText);
@@ -112,7 +111,7 @@ function inferTaxonomy(projectContext = {}) {
     matchedGenreId = 'game_casual_puzzle';
     matchedSubgenreId = 'merge_mechanic_puzzle';
   } else {
-    // App 分支推断
+    // App branch inference
     if (/\b(vpn|proxy|shadowsocks|v2ray|wireguard|clash)\b/.test(combinedText)) {
       matchedGenreId = 'utilities';
       matchedSubgenreId = 'net_vpn_proxy';
@@ -120,7 +119,6 @@ function inferTaxonomy(projectContext = {}) {
       matchedGenreId = 'utilities';
       matchedSubgenreId = 'system_cleaner_optimizer';
     } else if (/\b(calc|turnip|price|profit|currency|converter|calculator|finance|financial|stock|crypto|accounting|tax|invoice|budget)\b/.test(combinedText)) {
-      // 计算器 / 金融理财 / 价格收益预测
       matchedGenreId = 'finance_fintech';
       if (/\b(stock|trading|invest)\b/.test(combinedText)) {
         matchedSubgenreId = 'stock_trading_investment';
@@ -150,7 +148,7 @@ function inferTaxonomy(projectContext = {}) {
     }
   }
 
-  // 确保 genre 和 subgenre 真实有效
+  // Ensure valid genre and subgenre
   if (!genresMap.has(matchedGenreId)) {
     matchedGenreId = genresMap.keys().next().value || 'utilities';
   }
@@ -161,11 +159,11 @@ function inferTaxonomy(projectContext = {}) {
 
   const currentSubObj = currentGenreObj.subgenres.get(matchedSubgenreId) || subgenresMap.get(matchedSubgenreId);
 
-  // 2. 从当前 Sub-genre 的 5 大类别中智能挑选特性标签 (Feature Tags)
+  // 2. Pick feature tags from categories
   if (currentSubObj && currentSubObj.tag_categories) {
     const cats = currentSubObj.tag_categories;
 
-    // A. 核心功能 (Core Features) - 选 2~3 个
+    // A. Core Features (select 2~3)
     const coreList = cats.core_features || [];
     if (coreList.length > 0) {
       let added = 0;
@@ -184,7 +182,7 @@ function inferTaxonomy(projectContext = {}) {
       }
     }
 
-    // B. 变现模式 (Monetization) - 选 1 个
+    // B. Monetization (select 1)
     const monList = cats.monetization || [];
     if (monList.length > 0) {
       let monTag = null;
@@ -198,7 +196,7 @@ function inferTaxonomy(projectContext = {}) {
       if (monTag) matchedTags.add(monTag.tag_id);
     }
 
-    // C. 技术平台 (Technical Platform) - 选 1 个
+    // C. Technical Platform (select 1)
     const techList = cats.technical_platform || [];
     if (techList.length > 0) {
       let techTag = techList[0];
@@ -212,14 +210,14 @@ function inferTaxonomy(projectContext = {}) {
       if (techTag) matchedTags.add(techTag.tag_id);
     }
 
-    // D. 社交与促活 (Social Engagement) - 选 1 个
+    // D. Social Engagement (select 1)
     const socList = cats.social_engagement || [];
     if (socList.length > 0) {
       matchedTags.add(socList[0].tag_id);
     }
   }
 
-  // 最终组装结构化对象
+  // Assemble tag details
   const tagDetails = [];
   for (const tagId of matchedTags) {
     const info = tagsMap.get(tagId);
@@ -231,12 +229,11 @@ function inferTaxonomy(projectContext = {}) {
         category_name: CATEGORY_DISPLAY_NAMES[info.category] || info.category,
       });
     } else {
-      // 兜底虚拟 tag
       tagDetails.push({
         tag_id: tagId,
         name: tagId.replace(/_/g, ' '),
         category: 'core_features',
-        category_name: '核心功能',
+        category_name: 'Core Features',
       });
     }
   }
@@ -257,7 +254,7 @@ function inferTaxonomy(projectContext = {}) {
 }
 
 /**
- * 格式化输出为 4-Level 汇报格式
+ * Format taxonomy summary into 4-Level structure
  */
 function formatTaxonomySummary(taxonomy) {
   if (!taxonomy || !taxonomy.genre) return '';
@@ -273,9 +270,9 @@ function formatTaxonomySummary(taxonomy) {
   }
 
   const lines = [
-    `  • 一级大类 (Genre): ${genreStr}`,
-    `  • 二级子类 (Sub-genre): ${subgenreStr}`,
-    `  • 特性标签 (Feature Tags):`,
+    `  • Genre (L1): ${genreStr}`,
+    `  • Sub-genre (L2): ${subgenreStr}`,
+    `  • Feature Tags:`,
   ];
 
   for (const [catKey, items] of Object.entries(categorized)) {
@@ -287,7 +284,7 @@ function formatTaxonomySummary(taxonomy) {
 }
 
 /**
- * 校验或通过 ID 组合反查
+ * Resolve taxonomy from genreId, subgenreId, and tagIdList
  */
 function resolveTaxonomyFromIDs(genreId, subgenreId, tagIdList = []) {
   const { genresMap, subgenresMap, tagsMap } = buildIndex();
@@ -327,7 +324,7 @@ function resolveTaxonomyFromIDs(genreId, subgenreId, tagIdList = []) {
         tag_id: tid,
         name: tid.replace(/_/g, ' '),
         category: 'core_features',
-        category_name: '核心功能',
+        category_name: 'Core Features',
       });
     }
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shiplens/cli",
-  "version": "1.4.2",
-  "description": "Shiplens CLI — Web 用户行为数据统计与 AI Agent 智能分析引擎",
+  "version": "1.4.3",
+  "description": "Shiplens CLI — Automated Web User Analytics & AI Agent Analysis Engine",
   "main": "lib/index.js",
   "bin": {
     "cli": "./bin/shiplens.js",