@nbtca/prompt 1.0.4 → 1.0.6

package/src/features/docs.ts

@@ -10,6 +10,8 @@ import chalk from 'chalk';
 import open from 'open';
 import inquirer from 'inquirer';
 import { error, info, success, warning } from '../core/ui.js';
+import { spawn } from 'child_process';
+import { t } from '../i18n/index.js';
 
 // 配置marked使用终端渲染器
 marked.setOptions({
@@ -26,6 +28,12 @@ const GITHUB_REPO = {
   branch: 'main'
 };
 
+/**
+ * GitHub Token (可选 - 用于避免 API 速率限制)
+ * 从环境变量读取，如果没有则使用未认证请求
+ */
+const GITHUB_TOKEN = process.env['GITHUB_TOKEN'] || process.env['GH_TOKEN'];
+
 /**
  * 文档结构类型
  */
@@ -56,12 +64,19 @@ async function fetchGitHubDirectory(path: string = ''): Promise<DocItem[]> {
   const url = `https://api.github.com/repos/${GITHUB_REPO.owner}/${GITHUB_REPO.repo}/contents/${path}?ref=${GITHUB_REPO.branch}`;
 
   try {
+    const headers: any = {
+      'Accept': 'application/vnd.github.v3+json',
+      'User-Agent': 'NBTCA-CLI'
+    };
+
+    // 如果有 GitHub Token，添加认证头以避免速率限制
+    if (GITHUB_TOKEN) {
+      headers['Authorization'] = `Bearer ${GITHUB_TOKEN}`;
+    }
+
     const response = await axios.get(url, {
       timeout: 10000,
-      headers: {
-        'Accept': 'application/vnd.github.v3+json',
-        'User-Agent': 'NBTCA-CLI'
-      }
+      headers
     });
 
     return response.data
@@ -90,6 +105,17 @@ async function fetchGitHubDirectory(path: string = ''): Promise<DocItem[]> {
         return a.name.localeCompare(b.name);
       });
   } catch (err: any) {
+    // 提供更详细的错误信息
+    if (err.response?.status === 403) {
+      const rateLimitRemaining = err.response.headers['x-ratelimit-remaining'];
+      const rateLimitReset = err.response.headers['x-ratelimit-reset'];
+
+      if (rateLimitRemaining === '0') {
+        const resetDate = new Date(parseInt(rateLimitReset) * 1000);
+        throw new Error(`GitHub API 速率限制已达上限，将在 ${resetDate.toLocaleTimeString()} 重置。\n提示: 设置 GITHUB_TOKEN 环境变量可获得更高的速率限制。`);
+      }
+      throw new Error(`GitHub API 拒绝访问 (403)。\n提示: 尝试设置 GITHUB_TOKEN 环境变量。`);
+    }
     throw new Error(`无法获取目录内容: ${err.message}`);
   }
 }
@@ -156,22 +182,23 @@ function extractDocTitle(content: string): string | null {
  * 浏览目录并选择文档
  */
 async function browseDirectory(dirPath: string = ''): Promise<void> {
+  const trans = t();
   try {
-    info(dirPath ? `正在加载目录: ${dirPath}` : '正在加载文档列表...');
+    info(dirPath ? `${trans.docs.loadingDir}: ${dirPath}` : trans.docs.loading);
 
     const items = await fetchGitHubDirectory(dirPath);
 
     console.log('\r' + ' '.repeat(60) + '\r'); // 清除加载提示
 
     if (items.length === 0) {
-      warning('该目录为空');
+      warning(trans.docs.emptyDir);
       return;
     }
 
     // 构建选择列表
     const choices = [
       ...(dirPath ? [
-        { name: chalk.gray('[..] Up to parent directory'), value: { type: 'back' } },
+        { name: chalk.gray(trans.docs.upToParent), value: { type: 'back' } },
         new inquirer.Separator()
       ] : []),
       ...items.map(item => ({
@@ -181,14 +208,14 @@ async function browseDirectory(dirPath: string = ''): Promise<void> {
         value: item
       })),
       new inquirer.Separator(),
-      { name: chalk.gray('[ ^] Return to main menu'), value: { type: 'exit' } }
+      { name: chalk.gray(trans.docs.returnToMenu), value: { type: 'exit' } }
     ];
 
     const { selected } = await inquirer.prompt([
       {
         type: 'list',
         name: 'selected',
-        message: dirPath ? `当前目录: ${dirPath}` : '选择文档或目录:',
+        message: dirPath ? `${trans.docs.currentDir}: ${dirPath}` : trans.docs.chooseDoc,
         choices,
         pageSize: 15,
         loop: false
@@ -213,14 +240,14 @@ async function browseDirectory(dirPath: string = ''): Promise<void> {
     }
 
   } catch (err: any) {
-    error('无法加载目录');
-    console.log(chalk.gray(`  错误: ${err.message}`));
+    error(trans.docs.loadError);
+    console.log(chalk.gray(`  ${trans.docs.errorHint}: ${err.message}`));
 
     const { retry } = await inquirer.prompt([
       {
         type: 'confirm',
         name: 'retry',
-        message: '是否重试？',
+        message: trans.docs.retry,
         default: true
       }
     ]);
@@ -231,12 +258,58 @@ async function browseDirectory(dirPath: string = ''): Promise<void> {
   }
 }
 
+/**
+ * 使用系统pager (less/more) 显示内容
+ * 提供类似vim/journalctl的阅读体验
+ */
+async function displayInPager(content: string, title: string): Promise<boolean> {
+  const trans = t();
+  return new Promise((resolve) => {
+    // 检测可用的pager程序
+    const pager = process.env['PAGER'] || 'less';
+
+    // 为内容添加标题
+    const fullContent = `${chalk.cyan.bold(`>> ${title}`)}\n${chalk.gray('='.repeat(80))}\n\n${content}\n\n${chalk.gray('='.repeat(80))}\n${chalk.dim(trans.docs.endOfDocument)}\n`;
+
+    // less的参数: -R (支持颜色), -F (如果内容少于一屏则直接显示), -X (退出时不清屏)
+    const lessArgs = ['-R', '-F', '-X'];
+
+    try {
+      const child = spawn(pager, lessArgs, {
+        stdio: ['pipe', 'inherit', 'inherit'],
+        shell: true
+      });
+
+      // 将内容写入pager的stdin
+      child.stdin.write(fullContent);
+      child.stdin.end();
+
+      child.on('exit', (code) => {
+        resolve(code === 0);
+      });
+
+      child.on('error', () => {
+        // 如果pager失败，回退到直接输出
+        console.error(chalk.yellow(trans.docs.pagerNotAvailable));
+        console.log(fullContent);
+        resolve(false);
+      });
+
+    } catch {
+      // 回退方案: 直接输出
+      console.log(fullContent);
+      resolve(false);
+    }
+  });
+}
+
 /**
  * 查看Markdown文件
  */
 async function viewMarkdownFile(path: string): Promise<void> {
+  const trans = t();
   try {
-    info(`正在加载: ${path}`);
+    info(`${trans.docs.loading.replace('...', '')}: ${path}`);
 
     // 从GitHub获取原始Markdown内容
     const rawContent = await fetchGitHubRawContent(path);
@@ -247,24 +320,16 @@ async function viewMarkdownFile(path: string): Promise<void> {
     // 提取标题
     const title = extractDocTitle(cleanedContent) || path.split('/').pop() || path;
 
-    console.clear();
-    console.log();
-    console.log(chalk.cyan.bold(`>> ${title}`));
-    console.log(chalk.gray(`   ${path}`));
-    console.log();
-    console.log(chalk.gray('='.repeat(80)));
-    console.log();
-
     // 渲染Markdown到终端
-    const rendered = marked(cleanedContent);
-    console.log(rendered);
-    console.log();
-    console.log(chalk.gray('='.repeat(80)));
-    console.log();
-    console.log(chalk.dim('  Note: Some features are only available in browser'));
-    console.log();
+    const rendered = await marked(cleanedContent);
+
+    console.log('\r' + ' '.repeat(60) + '\r'); // 清除加载提示
+
+    // 使用pager显示文档 (类似vim/journalctl的阅读体验)
+    await displayInPager(rendered, `${title}\n${chalk.gray(`   ${path}`)}`);
 
-    success('文档加载完成');
+    console.log(); // 添加空行
+    success(trans.docs.docCompleted);
     console.log();
 
     // 提供后续操作选项
@@ -272,30 +337,34 @@ async function viewMarkdownFile(path: string): Promise<void> {
       {
         type: 'list',
         name: 'action',
-        message: '选择操作:',
+        message: trans.docs.chooseAction,
         choices: [
-          { name: '[ <] Back to docs list', value: 'back' },
-          { name: '[ *] Open in browser', value: 'browser' }
+          { name: trans.docs.backToList, value: 'back' },
+          { name: trans.docs.reread, value: 'reread' },
+          { name: trans.docs.openBrowser, value: 'browser' }
         ]
       }
     ]);
 
     if (action === 'browser') {
       await openDocsInBrowser(path);
+    } else if (action === 'reread') {
+      // 重新阅读文档
+      await viewMarkdownFile(path);
     }
 
   } catch (err: any) {
     console.log('\r' + ' '.repeat(60) + '\r');
-    error('无法加载文档');
-    console.log(chalk.gray(`  错误: ${err.message}`));
-    warning('建议在浏览器中查看');
+    error(trans.docs.loadError);
+    console.log(chalk.gray(`  ${trans.docs.errorHint}: ${err.message}`));
+    warning(trans.docs.openBrowserPrompt.replace('是否', '建议'));
     console.log();
 
     const { openBrowser } = await inquirer.prompt([
       {
         type: 'confirm',
         name: 'openBrowser',
-        message: '是否在浏览器中打开？',
+        message: trans.docs.openBrowserPrompt,
         default: true
       }
     ]);
@@ -310,16 +379,17 @@ async function viewMarkdownFile(path: string): Promise<void> {
  * 在浏览器中打开知识库
  */
 export async function openDocsInBrowser(path?: string): Promise<void> {
+  const trans = t();
   try {
-    info('正在打开浏览器...');
+    info(trans.docs.opening);
     const url = path
       ? `https://docs.nbtca.space/${path.replace(/\.md$/, '')}`
       : 'https://docs.nbtca.space';
     await open(url);
-    success('已在浏览器中打开知识库');
+    success(trans.docs.browserOpened);
   } catch (err) {
-    error('无法打开浏览器');
-    console.log(chalk.gray('  请手动访问: https://docs.nbtca.space'));
+    error(trans.docs.browserError);
+    console.log(chalk.gray(`  ${trans.docs.browserErrorHint}`));
   }
   console.log();
 }
@@ -328,9 +398,10 @@ export async function openDocsInBrowser(path?: string): Promise<void> {
  * 显示知识库菜单
  */
 export async function showDocsMenu(): Promise<void> {
+  const trans = t();
   console.log();
-  console.log(chalk.cyan.bold('  >> Knowledge Base'));
-  console.log(chalk.dim('     Browse documentation from terminal or open in browser'));
+  console.log(chalk.cyan.bold(`  >> ${trans.docs.title}`));
+  console.log(chalk.dim(`     ${trans.docs.subtitle}`));
   console.log();
 
   const choices = [
@@ -339,15 +410,15 @@ export async function showDocsMenu(): Promise<void> {
       value: cat.path
     })),
     new inquirer.Separator(),
-    { name: chalk.gray('[ *] Open in browser'), value: 'browser' },
-    { name: chalk.gray('[ ^] Back to main menu'), value: 'back' }
+    { name: chalk.gray(trans.docs.openBrowser), value: 'browser' },
+    { name: chalk.gray(trans.docs.returnToMenu), value: 'back' }
   ];
 
   const { action } = await inquirer.prompt([
     {
       type: 'list',
       name: 'action',
-      message: '选择文档分类:',
+      message: trans.docs.chooseCategory,
       choices,
       pageSize: 15,
       loop: false

package/src/features/repair.ts

@@ -6,6 +6,7 @@
 import open from 'open';
 import chalk from 'chalk';
 import { error, info, success } from '../core/ui.js';
+import { t } from '../i18n/index.js';
 
 /**
  * 维修服务URL
@@ -16,25 +17,20 @@ const REPAIR_URL = 'https://nbtca.space/repair';
  * 打开维修服务页面
  */
 export async function openRepairService(): Promise<void> {
+  const trans = t();
   try {
     console.log();
-    info('正在打开维修服务页面...');
+    info(trans.repair.opening);
     console.log();
 
     await open(REPAIR_URL);
 
-    success('已在浏览器中打开维修服务页面');
-    console.log();
-    console.log(chalk.gray('  服务内容:'));
-    console.log(chalk.gray('  • 电脑硬件维修'));
-    console.log(chalk.gray('  • 软件安装与配置'));
-    console.log(chalk.gray('  • 系统优化与故障排查'));
-    console.log(chalk.gray('  • 数据恢复与备份'));
+    success(trans.repair.opened);
     console.log();
   } catch (err) {
-    error('无法打开浏览器');
+    error(trans.repair.error);
     console.log();
-    console.log(chalk.yellow('  请手动访问: ') + chalk.cyan(REPAIR_URL));
+    console.log(chalk.yellow('  ' + trans.repair.errorHint));
     console.log();
   }
 }

package/src/features/website.ts

@@ -6,38 +6,40 @@
 import open from 'open';
 import chalk from 'chalk';
 import { error, info, success } from '../core/ui.js';
+import { t } from '../i18n/index.js';
 
 /**
  * 打开指定URL
  */
-export async function openWebsite(url: string, name: string = '网站'): Promise<void> {
+export async function openWebsite(url: string): Promise<void> {
+  const trans = t();
   try {
     console.log();
-    info(`正在打开${name}...`);
+    info(trans.website.opening);
 
     await open(url);
 
-    success(`已在浏览器中打开${name}`);
+    success(trans.website.opened);
     console.log(chalk.gray(`  ${url}`));
     console.log();
   } catch (err) {
-    error('无法打开浏览器');
+    error(trans.website.error);
     console.log();
-    console.log(chalk.yellow('  请手动访问: ') + chalk.cyan(url));
+    console.log(chalk.yellow('  ' + trans.website.errorHint + ': ') + chalk.cyan(url));
     console.log();
   }
 }
 
 /**
- * 打开NBTCA主页
+ * Open NBTCA homepage
  */
 export async function openHomepage(): Promise<void> {
-  await openWebsite('https://nbtca.space', 'NBTCA官网');
+  await openWebsite('https://nbtca.space');
 }
 
 /**
- * 打开GitHub页面
+ * Open GitHub page
  */
 export async function openGithub(): Promise<void> {
-  await openWebsite('https://github.com/nbtca', 'GitHub组织页');
+  await openWebsite('https://github.com/nbtca');
 }

package/src/i18n/index.ts

@@ -0,0 +1,236 @@
+/**
+ * Internationalization (i18n) System
+ * Multi-language support for the application
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export type Language = 'zh' | 'en';
+
+/**
+ * Translation structure
+ */
+export interface Translations {
+  common: {
+    back: string;
+    exit: string;
+    cancel: string;
+    confirm: string;
+    loading: string;
+    error: string;
+    success: string;
+    goodbye: string;
+  };
+  menu: {
+    title: string;
+    events: string;
+    eventsDesc: string;
+    repair: string;
+    repairDesc: string;
+    docs: string;
+    docsDesc: string;
+    website: string;
+    websiteDesc: string;
+    github: string;
+    githubDesc: string;
+    about: string;
+    aboutDesc: string;
+    language: string;
+    languageDesc: string;
+    navigationHint: string;
+    chooseAction: string;
+  };
+  about: {
+    title: string;
+    project: string;
+    version: string;
+    description: string;
+    github: string;
+    website: string;
+    email: string;
+    features: string;
+    feature1: string;
+    feature2: string;
+    feature3: string;
+    feature4: string;
+    license: string;
+    author: string;
+  };
+  calendar: {
+    title: string;
+    subtitle: string;
+    loading: string;
+    noEvents: string;
+    error: string;
+    errorHint: string;
+    dateTime: string;
+    eventName: string;
+    location: string;
+  };
+  docs: {
+    title: string;
+    subtitle: string;
+    loading: string;
+    loadingDir: string;
+    chooseCategory: string;
+    currentDir: string;
+    chooseDoc: string;
+    emptyDir: string;
+    upToParent: string;
+    returnToMenu: string;
+    backToList: string;
+    reread: string;
+    openBrowser: string;
+    loadError: string;
+    errorHint: string;
+    openBrowserPrompt: string;
+    docCompleted: string;
+    chooseAction: string;
+    opening: string;
+    browserOpened: string;
+    browserError: string;
+    browserErrorHint: string;
+    retry: string;
+    pagerNotAvailable: string;
+    endOfDocument: string;
+  };
+  repair: {
+    title: string;
+    subtitle: string;
+    opening: string;
+    opened: string;
+    error: string;
+    errorHint: string;
+  };
+  website: {
+    opening: string;
+    opened: string;
+    error: string;
+    errorHint: string;
+  };
+  language: {
+    title: string;
+    currentLanguage: string;
+    selectLanguage: string;
+    zh: string;
+    en: string;
+    changed: string;
+  };
+}
+
+/**
+ * Language configuration
+ */
+let currentLanguage: Language = 'zh'; // Default to Chinese
+
+/**
+ * Get configuration directory path
+ */
+function getConfigDir(): string {
+  const homeDir = process.env['HOME'] || process.env['USERPROFILE'] || '';
+  return path.join(homeDir, '.nbtca');
+}
+
+/**
+ * Get language configuration file path
+ */
+function getLanguageConfigPath(): string {
+  return path.join(getConfigDir(), 'language.json');
+}
+
+/**
+ * Load language preference from config file
+ */
+export function loadLanguagePreference(): Language {
+  try {
+    const configPath = getLanguageConfigPath();
+    if (fs.existsSync(configPath)) {
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      if (config.language === 'zh' || config.language === 'en') {
+        currentLanguage = config.language;
+      }
+    }
+  } catch (err) {
+    // If loading fails, use default (Chinese)
+  }
+  return currentLanguage;
+}
+
+/**
+ * Save language preference to config file
+ */
+export function saveLanguagePreference(language: Language): void {
+  try {
+    const configDir = getConfigDir();
+    if (!fs.existsSync(configDir)) {
+      fs.mkdirSync(configDir, { recursive: true });
+    }
+    const configPath = getLanguageConfigPath();
+    fs.writeFileSync(configPath, JSON.stringify({ language }, null, 2));
+    currentLanguage = language;
+  } catch (err) {
+    // Silently fail if we can't save preference
+  }
+}
+
+/**
+ * Get current language
+ */
+export function getCurrentLanguage(): Language {
+  return currentLanguage;
+}
+
+/**
+ * Set current language
+ */
+export function setLanguage(language: Language): void {
+  currentLanguage = language;
+  saveLanguagePreference(language);
+}
+
+/**
+ * Load translation file
+ */
+function loadTranslations(language: Language): Translations {
+  try {
+    const translationPath = path.join(__dirname, 'locales', `${language}.json`);
+    const content = fs.readFileSync(translationPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (err) {
+    // Fallback to Chinese if loading fails
+    const fallbackPath = path.join(__dirname, 'locales', 'zh.json');
+    const content = fs.readFileSync(fallbackPath, 'utf-8');
+    return JSON.parse(content);
+  }
+}
+
+/**
+ * Translation cache
+ */
+let translationsCache: Map<Language, Translations> = new Map();
+
+/**
+ * Get translations for current language
+ */
+export function t(): Translations {
+  if (!translationsCache.has(currentLanguage)) {
+    translationsCache.set(currentLanguage, loadTranslations(currentLanguage));
+  }
+  return translationsCache.get(currentLanguage)!;
+}
+
+/**
+ * Clear translation cache (useful when switching languages)
+ */
+export function clearTranslationCache(): void {
+  translationsCache.clear();
+}
+
+// Initialize language preference on module load
+loadLanguagePreference();