@shiplens/cli 1.3.0 → 1.4.0

package/lib/commands/auth.js

@@ -11,17 +11,17 @@ async function handleAuth(subcommand, args, flags, ctx) {
       const deviceEnv = getDeviceEnv();
       if (deviceEnv) {
         return ctx.output({ ok: true, authenticated: false, device_env: 'present', mcp_url: deviceEnv.SHIPLENS_MCP_URL, next: 'Use shiplens auth mcp-config, then complete OAuth in your Agent.' }, () => {
-          console.log(`✅ shiplens.env detected; MCP: ${deviceEnv.SHIPLENS_MCP_URL}`);
-          console.log('Complete OAuth login in your Agent before using MCP.');
+          console.log(`✅ 已发现 shiplens.env；MCP: ${deviceEnv.SHIPLENS_MCP_URL}`);
+          console.log('请在 Agent 中完成 OAuth 登录后使用 MCP。');
         });
       }
       if (!ctx.resolvedAuth.is_present) {
         return ctx.output({
           ok: false,
           authenticated: false,
-          message: 'No credentials detected. Configure via shiplens auth set.',
+          message: '未检测到鉴权密钥，请使用 shiplens auth set 配置',
         }, () => {
-          console.log('⚠️ No valid credentials configured. Run: shiplens auth set');
+          console.log('⚠️ 当前未配置有效凭证。请执行: shiplens auth set');
         });
       }
 
@@ -36,9 +36,9 @@ async function handleAuth(subcommand, args, flags, ctx) {
           email: meResp.email,
           last_verified_at: new Date().toISOString(),
         }, () => {
-          console.log('✅ Authentication valid');
-          console.log(`👤 User ID: ${meResp.user_id} | Email: ${meResp.email}`);
-          console.log(`🔑 Secret Source: ${ctx.resolvedAuth.source} (${ctx.resolvedAuth.masked_secret})`);
+          console.log('✅ 鉴权状态有效');
+          console.log(`👤 用户 ID: ${meResp.user_id} | 邮箱: ${meResp.email}`);
+          console.log(`🔑 密钥来源: ${ctx.resolvedAuth.source} (${ctx.resolvedAuth.masked_secret})`);
         });
       } catch (err) {
         ctx.output({
@@ -48,7 +48,7 @@ async function handleAuth(subcommand, args, flags, ctx) {
           masked_secret: ctx.resolvedAuth.masked_secret,
           error: err.message,
         }, () => {
-          console.log(`❌ Credential verification failed: ${err.message}`);
+          console.log(`❌ 凭证校验失败: ${err.message}`);
         });
       }
       break;
@@ -56,9 +56,9 @@ async function handleAuth(subcommand, args, flags, ctx) {
 
     case 'mcp-config': {
       const deviceEnv = getDeviceEnv();
-      if (!deviceEnv) throw new Error('shiplens.env not found. Run shiplens auth bind and complete email activation first.');
+      if (!deviceEnv) throw new Error('未找到 shiplens.env，请先执行 shiplens auth bind 并完成邮件激活');
       const client = flags.client || 'manual';
-      if (!CLIENTS.includes(client)) throw new Error(`Unsupported MCP client: ${client}. Supported: ${CLIENTS.join(', ')}`);
+      if (!CLIENTS.includes(client)) throw new Error(`不支持的 MCP 客户端: ${client}。支持 ${CLIENTS.join(', ')}`);
       const config = getMcpConfig(client, deviceEnv.SHIPLENS_MCP_URL);
       ctx.output({ ok: true, mcp_config: config, oauth_required: true }, () => console.log(JSON.stringify(config, null, 2)));
       break;
@@ -66,17 +66,17 @@ async function handleAuth(subcommand, args, flags, ctx) {
 
     case 'configure': {
       const deviceEnv = getDeviceEnv();
-      if (!deviceEnv) throw new Error('shiplens.env not found. Run shiplens auth bind and complete email activation first.');
+      if (!deviceEnv) throw new Error('未找到 shiplens.env，请先执行 shiplens auth bind 并完成邮件激活');
       const client = flags.client || args[0];
-      if (!CLIENTS.includes(client)) throw new Error(`Specify target MCP client via --client: ${CLIENTS.join(', ')}`);
+      if (!CLIENTS.includes(client)) throw new Error(`请通过 --client 指定 MCP 客户端：${CLIENTS.join(', ')}`);
       const result = configureMcpClient(client, deviceEnv.SHIPLENS_MCP_URL);
       ctx.output({ ok: true, client, oauth_required: true, ...result }, () => {
         if (client === 'manual') {
           console.log(JSON.stringify(result.config, null, 2));
           return;
         }
-        console.log(result.written ? `✅ Shiplens MCP configuration written to ${client}.` : 'ℹ️ Shiplens MCP config already exists, unchanged.');
-        console.log('Complete OAuth login in your Agent MCP panel.');
+        console.log(result.written ? `✅ 已写入 ${client} 的 Shiplens MCP 配置。` : 'ℹ️ Shiplens MCP 配置已存在，未覆盖。');
+        console.log('请在 Agent 的 MCP 面板中完成 OAuth 登录。');
       });
       break;
     }
@@ -96,7 +96,7 @@ async function handleAuth(subcommand, args, flags, ctx) {
       } else {
         const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
         secret = await new Promise((resolve) => {
-          rl.question('Enter Shiplens Access Secret: ', (ans) => {
+          rl.question('请输入 Shiplens Access Secret: ', (ans) => {
             rl.close();
             resolve(ans.trim());
           });
@@ -104,7 +104,7 @@ async function handleAuth(subcommand, args, flags, ctx) {
       }
 
       if (!secret) {
-        throw new Error('Access Secret cannot be empty.');
+        throw new Error('密钥不能为空');
       }
 
       const tempClient = new APIClient(ctx.client.baseURL, secret);
@@ -123,17 +123,17 @@ async function handleAuth(subcommand, args, flags, ctx) {
         masked_secret: maskSecret(secret),
         email: email || undefined,
         user_id: userId || undefined,
-        message: 'Access Secret saved securely to ~/.shiplens/config.json',
+        message: '鉴权密钥已安全保存至 ~/.shiplens/config.json',
       }, () => {
-        console.log(`✅ Access Secret saved: ${maskSecret(secret)}`);
-        if (email) console.log(`👤 Bound User: ${email} (${userId})`);
+        console.log(`✅ 鉴权密钥已保存: ${maskSecret(secret)}`);
+        if (email) console.log(`👤 绑定用户: ${email} (${userId})`);
       });
       break;
     }
 
     case 'secret': {
       const action = args[0] || 'list';
-      if (!ctx.resolvedAuth.is_present) throw new Error('Run auth set first to configure an Access Secret with administrative rights.');
+      if (!ctx.resolvedAuth.is_present) throw new Error('请先用 auth set 配置可管理 Access Secret');
       if (action === 'list') {
         const response = await ctx.client.listAccessSecrets();
         return ctx.output({ ok: true, access_secrets: response.api_keys || [] }, () => console.log(JSON.stringify(response.api_keys || [], null, 2)));
@@ -143,25 +143,25 @@ async function handleAuth(subcommand, args, flags, ctx) {
         const response = await ctx.client.createAccessSecret({ app_id: flags['app-id'], scopes, expires_at: flags.expires });
         saveSecretToGlobal(response.api_key);
         return ctx.output({ ok: true, api_key_id: response.api_key_id, api_key_preview: response.api_key_preview, app_id: response.app_id, scopes: response.scopes, expires_at: response.expires_at, saved_to_global_config: true }, () => {
-          console.log(`✅ Offline Access Secret created and saved (${response.api_key_preview}).`);
+          console.log(`✅ 离线 Access Secret 已创建并保存（${response.api_key_preview}）。`);
         });
       }
       if (action === 'revoke') {
         const apiKeyId = flags['key-id'] || args[1];
-        if (!apiKeyId) throw new Error('Provide --key-id <api_key_id>.');
+        if (!apiKeyId) throw new Error('请提供 --key-id <api_key_id>');
         const response = await ctx.client.revokeAccessSecret(apiKeyId);
-        return ctx.output({ ok: true, ...response }, () => console.log(`✅ Revoked Access Secret: ${response.api_key_id}`));
+        return ctx.output({ ok: true, ...response }, () => console.log(`✅ 已撤销 Access Secret: ${response.api_key_id}`));
       }
-      throw new Error('Supported auth secret subcommands: list, create, revoke');
+      throw new Error('支持的 auth secret 子命令: list, create, revoke');
     }
 
     case 'whoami': {
       const meResp = await ctx.client.me();
       ctx.output(meResp, () => {
-        console.log(`👤 User ID: ${meResp.user_id}`);
-        console.log(`📧 Email: ${meResp.email}`);
+        console.log(`👤 用户 ID: ${meResp.user_id}`);
+        console.log(`📧 邮箱: ${meResp.email}`);
         if (meResp.project_count) {
-          console.log(`📦 Projects Count: ${meResp.project_count}`);
+          console.log(`📦 拥有项目数: ${meResp.project_count}`);
         }
       });
       break;
@@ -171,17 +171,21 @@ async function handleAuth(subcommand, args, flags, ctx) {
       clearGlobalSecret();
       ctx.output({
         ok: true,
-        message: 'Logged out successfully. Local credentials cleared.',
+        message: '已成功退出登录并清除本地存储凭证',
       }, () => {
-        console.log('🚪 Logged out successfully. Local credentials cleared.');
+        console.log('🚪 已退出登录并清除本地凭证。');
       });
       break;
     }
 
     case 'bind': {
+      // ── auth bind：零弹窗邮箱绑定 ──────────────────────────────────────────
+      // 调用方式：shiplens auth bind --email <email> --json
+      // 自动从 .shiplens.json 读取 app_id / project_name / api_url
+      // 调用 POST /api/auth/email/start 发送 Magic Link，最多重试 2 次
       const email = flags.email || args[0];
       if (!email || !email.includes('@')) {
-        const err = new Error('Provide a valid email address, e.g.: shiplens auth bind --email you@company.com');
+        const err = new Error('请提供有效的邮箱地址，例如：shiplens auth bind --email you@company.com');
         err.code = 'INVALID_EMAIL';
         throw err;
       }
@@ -202,6 +206,7 @@ async function handleAuth(subcommand, args, flags, ctx) {
           device_name: require('os').hostname(),
         });
       } catch (err) {
+        // 网络 / 服务端失败时返回标准错误 JSON，不挂起
         ctx.output({
           ok: false,
           magic_link_sent: false,
@@ -210,7 +215,7 @@ async function handleAuth(subcommand, args, flags, ctx) {
           code: err.code || 'NETWORK_FAILED',
           message: err.message,
         }, () => {
-          console.error(`❌ Failed to send email [${err.code || 'NETWORK_FAILED'}]: ${err.message}`);
+          console.error(`❌ 邮件发送失败 [${err.code || 'NETWORK_FAILED'}]: ${err.message}`);
         });
         process.exitCode = 1;
         return;
@@ -225,17 +230,17 @@ async function handleAuth(subcommand, args, flags, ctx) {
         app_id: appId || undefined,
         project_name: projectName || undefined,
         shiplens_env_written: Boolean(envPath),
-        message: `Activation email sent to ${email}. Click the link to complete registration.`,
+        message: `激活邮件已发送至 ${email}，请点击邮件中的链接完成注册与激活。`,
       }, () => {
-        console.log(`📧 Activation email sent to: ${email}`);
-        if (appId) console.log(`📦 Bound App ID: ${appId}`);
-        console.log('👉 Click the link in your email to activate your 50,000 monthly free events quota.');
+        console.log(`📧 激活邮件已发送至: ${email}`);
+        if (appId) console.log(`📦 绑定项目 ID: ${appId}`);
+        console.log('👉 请点击邮件中的链接完成注册，每月可获得 50,000 事件免费统计额度。');
       });
       break;
     }
 
     default:
-      throw new Error(`Unknown auth subcommand: ${subcommand}. Supported: status, set, secret, whoami, logout, bind, mcp-config, configure`);
+      throw new Error(`未知的 auth 子命令: ${subcommand}。支持 status, set, secret, whoami, logout, bind, mcp-config, configure`);
   }
 }
 

package/lib/commands/context.js

@@ -3,7 +3,7 @@ const path = require('path');
 const { getLocalConfig } = require('../config');
 
 /**
- * Get standard storage path for business context: .shiplens/contexts/<app_id>.md
+ * 获取指定 app_id 的业务上下文标准存储路径: .shiplens/contexts/<app_id>.md
  */
 function getContextFilePath(appId, customFile = null, dir = process.cwd()) {
   if (customFile) return path.resolve(dir, customFile);
@@ -11,7 +11,7 @@ function getContextFilePath(appId, customFile = null, dir = process.cwd()) {
 }
 
 /**
- * Extract declared app_id from Markdown header
+ * 从 Markdown 内容中提取头部声明的 app_id
  */
 function extractAppIdFromMarkdown(content) {
   const match = content.match(/app_id[^\w\n]*[:=]\s*([a-zA-Z0-9_.\-]+)/i);
@@ -19,7 +19,7 @@ function extractAppIdFromMarkdown(content) {
 }
 
 /**
- * Network executor with up to 2 retries and graceful fallback
+ * 带有最多 2 次重试与优雅跳过的网络执行器 (非阻塞容错)
  */
 async function executeWithSafeFallback(fn, maxRetries = 2, baseMs = 500) {
   let lastErr = null;
@@ -37,7 +37,7 @@ async function executeWithSafeFallback(fn, maxRetries = 2, baseMs = 500) {
 }
 
 /**
- * Handle context command (push, pull, show)
+ * 处理 context 命令 (push, pull, show)
  */
 async function handleContext(subcommand, args, flags, ctx) {
   const targetSub = subcommand || 'show';
@@ -50,7 +50,7 @@ async function handleContext(subcommand, args, flags, ctx) {
     case 'push': {
       if (!fs.existsSync(filePath)) {
         const displayPath = path.relative(process.cwd(), filePath) || filePath;
-        const err = new Error(`Local context file not found: ${displayPath}. Generate business context first.`);
+        const err = new Error(`未找到本地上下文文件: ${displayPath}。请先生成对应产品的业务上下文。`);
         err.code = 'FILE_NOT_FOUND';
         throw err;
       }
@@ -58,12 +58,14 @@ async function handleContext(subcommand, args, flags, ctx) {
       const content = fs.readFileSync(filePath, 'utf8');
       const declaredAppId = extractAppIdFromMarkdown(content);
 
+      // 多项目防冲突校验：若文件中显式声明了 app_id，必须与当前目标 app_id 一致
       if (declaredAppId && declaredAppId !== appId) {
-        const err = new Error(`Context file app_id (${declaredAppId}) does not match current target app_id (${appId}). Push rejected.`);
+        const err = new Error(`上下文文件绑定的 app_id (${declaredAppId}) 与当前项目 app_id (${appId}) 不一致，禁止推送！请修正文件头部声明。`);
         err.code = 'PROJECT_ID_MISMATCH';
         throw err;
       }
 
+      // 最多重试 2 次，失败则优雅跳过，不阻断流程
       const syncResult = await executeWithSafeFallback(async () => {
         return ctx.client.uploadProjectContext(appId, {
           context_markdown: content,
@@ -78,7 +80,7 @@ async function handleContext(subcommand, args, flags, ctx) {
           action: 'push',
           app_id: appId,
           file: filePath,
-          message: 'Server connection timed out (2 attempts). Skipped cloud sync without blocking.',
+          message: '连接服务器超时或未成功 (已尝试2次)，已自动跳过云端同步步骤，暂未上传业务上下文。',
         });
         return;
       }
@@ -89,7 +91,7 @@ async function handleContext(subcommand, args, flags, ctx) {
         app_id: appId,
         file: filePath,
         bytes: Buffer.byteLength(content, 'utf8'),
-        message: `Project business context (${path.relative(process.cwd(), filePath)}) synced to cloud successfully.`,
+        message: `项目业务上下文 (${path.relative(process.cwd(), filePath)}) 已成功同步至云端。`,
         updated_at: syncResult.result.updated_at || new Date().toISOString(),
       });
       break;
@@ -98,11 +100,12 @@ async function handleContext(subcommand, args, flags, ctx) {
     case 'pull': {
       if (fs.existsSync(filePath) && !flags.force) {
         const displayPath = path.relative(process.cwd(), filePath) || filePath;
-        const err = new Error(`Local file ${displayPath} already exists. Pass --force to overwrite.`);
+        const err = new Error(`本地已存在 ${displayPath}。若需强制从云端覆盖请追加 --force 参数。`);
         err.code = 'FILE_EXISTS';
         throw err;
       }
 
+      // 最多重试 2 次，失败则优雅跳过，不阻断流程
       const pullResult = await executeWithSafeFallback(async () => {
         return ctx.client.getProjectContext(appId);
       }, 2, 500);
@@ -113,7 +116,7 @@ async function handleContext(subcommand, args, flags, ctx) {
           skipped: true,
           action: 'pull',
           app_id: appId,
-          message: 'Server connection timed out (2 attempts). Skipped cloud pull without blocking.',
+          message: '连接服务器超时或未成功 (已尝试2次)，已自动跳过云端拉取步骤，暂未下载业务上下文。',
         });
         return;
       }
@@ -127,7 +130,7 @@ async function handleContext(subcommand, args, flags, ctx) {
         app_id: appId,
         file: filePath,
         bytes: Buffer.byteLength(pullResult.result.context_markdown, 'utf8'),
-        message: `Business context pulled and saved to ${path.relative(process.cwd(), filePath)}.`,
+        message: `已从云端成功拉取业务上下文并保存至 ${path.relative(process.cwd(), filePath)}。`,
         updated_at: pullResult.result.updated_at,
       });
       break;
@@ -137,10 +140,12 @@ async function handleContext(subcommand, args, flags, ctx) {
       let content = null;
       let source = 'local';
 
+      // 若未加 --cloud 且本地文件存在，优先读取本地
       if (!flags.cloud && fs.existsSync(filePath)) {
         content = fs.readFileSync(filePath, 'utf8');
         source = 'local';
       } else {
+        // 本地不存在或指定 --cloud 时，从云端拉取 (最多尝试 2 次)
         const fetchResult = await executeWithSafeFallback(async () => {
           return ctx.client.getProjectContext(appId);
         }, 2, 500);
@@ -157,7 +162,7 @@ async function handleContext(subcommand, args, flags, ctx) {
           ok: true,
           app_id: appId,
           source: 'none',
-          message: `No context found locally (${displayPath}) or in cloud. Server lookup skipped after timeout.`,
+          message: `本地 (${displayPath}) 与云端暂无该产品的业务上下文。连接服务器超时或未成功 (已尝试2次)，已跳过云端查询。`,
         });
         return;
       }
@@ -173,7 +178,7 @@ async function handleContext(subcommand, args, flags, ctx) {
     }
 
     default:
-      throw new Error(`Unknown context subcommand: ${targetSub}. Supported: push, pull, show`);
+      throw new Error(`未知的 context 子命令: ${targetSub}。支持: push, pull, show`);
   }
 }
 

package/lib/commands/dashboards.js

@@ -10,14 +10,14 @@ async function handleDashboards(subcommand, args, flags, ctx) {
         dashboards: list,
       }, () => {
         if (!list || list.length === 0) {
-          console.log('No custom dashboards found. Create one using shiplens dashboards create.');
+          console.log('暂无自定义看板。可以使用 shiplens dashboards create 创建。');
           return;
         }
-        console.log(`📊 Found ${list.length} dashboard(s):\n`);
+        console.log(`📊 当前项目共有 ${list.length} 个看板:\n`);
         list.forEach((d, i) => {
-          const defTag = d.is_default ? ' [Default]' : '';
+          const defTag = d.is_default ? ' [默认]' : '';
           console.log(`[${i + 1}] ${d.title} (ID: ${d.dashboard_id})${defTag}`);
-          if (d.url) console.log(`    URL: ${d.url}`);
+          if (d.url) console.log(`    看板链接: ${d.url}`);
           console.log('');
         });
       });
@@ -25,16 +25,23 @@ async function handleDashboards(subcommand, args, flags, ctx) {
     }
 
     case 'create': {
+      // ── 支持两种模式 ──────────────────────────────────────────────────────
+      // 模式 A（默认）：POST /api/apps/{app_id}/dashboards
+      //   适用：传入 widgets / query 结构体，支持 --file 与 --prompt
+      // 模式 B（--ai）：POST /api/dashboard
+      //   适用：自然语言 Prompt 驱动，AI 引擎根据 prompt 自动生成看板
+      //   调用示例：shiplens dashboards create --ai --prompt "分析注册流失" --json
       const useAI = Boolean(flags.ai);
-      const title = flags.title || 'AI Telemetry Dashboard';
+      const title = flags.title || 'AI 行为分析看板';
       const prompt = flags.prompt || '';
 
       if (useAI) {
+        // 模式 B：AI 自然语言看板
         let appId = '';
         try { appId = ctx.resolveAppId(); } catch (_) {}
 
         if (!prompt) {
-          throw new Error('Provide natural language dashboard prompt via --prompt when using --ai mode.');
+          throw new Error('使用 --ai 模式时，请通过 --prompt 提供自然语言看板描述');
         }
 
         const reqData = { title, prompt };
@@ -42,38 +49,39 @@ async function handleDashboards(subcommand, args, flags, ctx) {
 
         const resp = await ctx.client.createAIDashboard(reqData);
         ctx.output(resp, () => {
-          console.log('🎉 AI Dashboard created successfully!');
-          console.log(`📌 Title: ${resp.title || title} (ID: ${resp.dashboard_id})`);
-          if (resp.dashboard_url) console.log(`🔗 Dashboard URL: ${resp.dashboard_url}`);
+          console.log('🎉 AI 看板生成成功！');
+          console.log(`📌 看板标题: ${resp.title || title} (ID: ${resp.dashboard_id})`);
+          if (resp.dashboard_url) console.log(`🔗 访问链接: ${resp.dashboard_url}`);
         });
       } else {
+        // 模式 A：标准看板创建
         const appId = ctx.resolveAppId();
-        const reqData = { title, prompt, app_id: appId };
+        const reqData = { title, prompt };
 
         if (flags.file) {
           if (!fs.existsSync(flags.file)) {
-            throw new Error(`Dashboard config file not found: ${flags.file}`);
+            throw new Error(`看板配置文件不存在: ${flags.file}`);
           }
           const fileContent = JSON.parse(fs.readFileSync(flags.file, 'utf8'));
           Object.assign(reqData, fileContent);
         }
 
         if (!reqData.prompt && (!reqData.widgets || reqData.widgets.length === 0)) {
-          throw new Error('Provide generation prompt via --prompt or configuration via --file.');
+          throw new Error('请通过 --prompt 提供生成提示词，或通过 --file 提供看板配置文件');
         }
 
         const resp = await ctx.client.createDashboard(appId, reqData);
         ctx.output(resp, () => {
-          console.log('🎉 Dashboard created successfully!');
-          console.log(`📌 Title: ${resp.title || reqData.title} (ID: ${resp.dashboard_id})`);
-          if (resp.dashboard_url) console.log(`🔗 Dashboard URL: ${resp.dashboard_url}`);
+          console.log('🎉 看板生成成功！');
+          console.log(`📌 看板标题: ${resp.title || reqData.title} (ID: ${resp.dashboard_id})`);
+          if (resp.dashboard_url) console.log(`🔗 访问链接: ${resp.dashboard_url}`);
         });
       }
       break;
     }
 
     default:
-      throw new Error(`Unknown dashboards subcommand: ${subcommand}. Supported: list, create`);
+      throw new Error(`未知的 dashboards 子命令: ${subcommand}。支持 list, create`);
   }
 }
 

package/lib/commands/doctor.js

@@ -9,7 +9,7 @@ async function handleDoctor(args, flags, ctx) {
   let hasFail = false;
   let hasWarn = false;
 
-  // 1. local_config check
+  // 1. local_config 检查
   const localCfg = getLocalConfig(wd);
   if (localCfg && localCfg.app_id) {
     checks.local_config = {
@@ -20,11 +20,11 @@ async function handleDoctor(args, flags, ctx) {
     hasWarn = true;
     checks.local_config = {
       status: 'fail',
-      message: 'No .shiplens.json or missing app_id in current directory',
+      message: '未在当前目录找到 .shiplens.json 或缺少 app_id',
     };
   }
 
-  // 2. sdk_dependency check
+  // 2. sdk_dependency 检查
   const sdkCheck = { status: 'pass' };
   const pkgPath = path.join(wd, 'package.json');
   if (fs.existsSync(pkgPath)) {
@@ -35,27 +35,26 @@ async function handleDoctor(args, flags, ctx) {
         sdkCheck.version = deps['@shiplens/sdk'];
       } else {
         sdkCheck.status = 'warn';
-        sdkCheck.message = '@shiplens/sdk not explicitly found in package.json';
+        sdkCheck.message = 'package.json 中未显式包含 @shiplens/sdk 依赖';
         hasWarn = true;
       }
     } catch (e) {
       sdkCheck.status = 'warn';
-      sdkCheck.message = 'Unable to parse package.json';
+      sdkCheck.message = '无法解析 package.json';
     }
   } else {
     sdkCheck.status = 'warn';
-    sdkCheck.message = 'package.json not found (static HTML or non-Node project)';
+    sdkCheck.message = '未发现 package.json (可能是纯静态或非 Node 项目)';
   }
   checks.sdk_dependency = sdkCheck;
 
-  // 3. code_injection check
+  // 3. code_injection 检查
   const detected = detectProject(wd);
   let injectedFile = '';
   const candidates = [
     'src/app/layout.tsx', 'app/layout.tsx', 'src/app/layout.js', 'app/layout.js',
     'src/pages/_app.tsx', 'pages/_app.tsx', 'src/pages/_app.js', 'pages/_app.js',
     'src/main.tsx', 'src/main.ts', 'src/main.jsx', 'src/main.js',
-    'src/index.tsx', 'src/index.ts', 'src/index.jsx', 'src/index.js',
     'src/App.vue', 'index.html', 'public/index.html', 'shiplens.config.ts',
     'src/components/ShiplensTracker.tsx', 'components/ShiplensTracker.tsx',
   ];
@@ -79,34 +78,26 @@ async function handleDoctor(args, flags, ctx) {
     hasWarn = true;
     checks.code_injection = {
       status: 'warn',
-      message: `No initShiplens call detected in entry files (Framework: ${detected.framework})`,
+      message: `未在常规入口检测到 initShiplens 调用 (框架探测: ${detected.framework})`,
     };
   }
 
-  // 4. ingestion_connectivity check
+  // 4. ingestion_connectivity 检查
   try {
-    const start = Date.now();
-    await ctx.client.me();
+    const latency = await ctx.client.testConnectivity();
     checks.ingestion_connectivity = {
       status: 'pass',
-      latency_ms: Date.now() - start,
+      latency_ms: latency,
     };
   } catch (err) {
-    if (err.statusCode === 401 || err.statusCode === 403) {
-      checks.ingestion_connectivity = {
-        status: 'pass',
-        latency_ms: 50,
-      };
-    } else {
-      hasFail = true;
-      checks.ingestion_connectivity = {
-        status: 'fail',
-        message: `API connection failed: ${err.message}`,
-      };
-    }
+    hasFail = true;
+    checks.ingestion_connectivity = {
+      status: 'fail',
+      message: `连接后端 API 失败: ${err.message}`,
+    };
   }
 
-  // 5. auth_credential check
+  // 5. auth_credential 检查
   if (ctx.resolvedAuth.is_present) {
     checks.auth_credential = {
       status: 'pass',
@@ -115,11 +106,11 @@ async function handleDoctor(args, flags, ctx) {
   } else {
     checks.auth_credential = {
       status: 'warn',
-      message: 'No Access Secret configured (login required for advanced features)',
+      message: '当前未配置 Access Secret (如需使用 projects/sql/dashboards 命令需登录)',
     };
   }
 
-  // 6. email_binding check
+  // 6. email_binding 检查（读取本地状态机中的 bound_email 字段）
   if (localCfg && localCfg.bound_email) {
     checks.email_binding = {
       status: 'pass',
@@ -129,11 +120,11 @@ async function handleDoctor(args, flags, ctx) {
     hasWarn = true;
     checks.email_binding = {
       status: 'warn',
-      message: 'Email not bound. Run: shiplens auth bind --email <you@example.com>',
+      message: '未检测到绑定邮箱，统计数据未激活。执行: shiplens auth bind --email <you@example.com>',
     };
   }
 
-  // 7. schema_freshness check
+  // 7. schema_freshness 检查（本地 schema_last_modified_at 是否超过 7 天未同步）
   if (localCfg && localCfg.schema_last_modified_at) {
     const ageMs = Date.now() - localCfg.schema_last_modified_at * 1000;
     const ageDays = ageMs / (1000 * 60 * 60 * 24);
@@ -142,7 +133,7 @@ async function handleDoctor(args, flags, ctx) {
       checks.schema_freshness = {
         status: 'warn',
         age_days: Math.floor(ageDays),
-        message: `Local schema is ${Math.floor(ageDays)} days old. Run shiplens projects list to refresh.`,
+        message: `本地 Schema 已 ${Math.floor(ageDays)} 天未同步，建议执行 shiplens projects list 刷新`,
       };
     } else {
       checks.schema_freshness = {
@@ -154,7 +145,7 @@ async function handleDoctor(args, flags, ctx) {
   } else {
     checks.schema_freshness = {
       status: 'warn',
-      message: 'No schema_last_modified_at recorded locally. Run shiplens init or projects list.',
+      message: '本地未记录 schema_last_modified_at，请重新执行 shiplens init 或 projects list',
     };
     hasWarn = true;
   }
@@ -174,7 +165,7 @@ async function handleDoctor(args, flags, ctx) {
   };
 
   ctx.output(report, () => {
-    console.log('🏥 Shiplens Environment & Telemetry Diagnostic Report');
+    console.log('🏥 Shiplens 项目环境与链路体检报告');
     console.log('='.repeat(50));
     for (const [name, item] of Object.entries(checks)) {
       let icon = '✅';
@@ -182,18 +173,18 @@ async function handleDoctor(args, flags, ctx) {
       else if (item.status === 'fail') icon = '❌';
 
       console.log(`${icon} [${name}]: ${item.status}`);
-      if (item.app_id) console.log(`   App ID: ${item.app_id}`);
-      if (item.email) console.log(`   Email: ${item.email}`);
-      if (item.version) console.log(`   Version: ${item.version}`);
-      if (item.file) console.log(`   File: ${item.file}`);
-      if (item.latency_ms !== undefined) console.log(`   Latency: ${item.latency_ms} ms`);
-      if (item.source) console.log(`   Credential Source: ${item.source}`);
-      if (item.age_days !== undefined) console.log(`   Schema Age: ${item.age_days} day(s)`);
-      if (item.message) console.log(`   Details: ${item.message}`);
+      if (item.app_id) console.log(`   app_id: ${item.app_id}`);
+      if (item.email) console.log(`   邮箱: ${item.email}`);
+      if (item.version) console.log(`   版本: ${item.version}`);
+      if (item.file) console.log(`   文件: ${item.file}`);
+      if (item.latency_ms !== undefined) console.log(`   网络延迟: ${item.latency_ms} ms`);
+      if (item.source) console.log(`   凭据来源: ${item.source}`);
+      if (item.age_days !== undefined) console.log(`   Schema 距上次同步: ${item.age_days} 天`);
+      if (item.message) console.log(`   说明: ${item.message}`);
     }
     console.log('-'.repeat(50));
-    console.log(`🩺 Overall Status: ${overall}`);
-    console.log(`⏱  Timestamp: ${report.doctor_ran_at}`);
+    console.log(`🩺 总体体检结果: ${overall}`);
+    console.log(`⏱  体检时间: ${report.doctor_ran_at}`);
   });
 }