ai-yuca 1.0.0

package/examples/sample.txt

@@ -0,0 +1,7 @@
+这是一个示例文本文件，用于测试AI-Yuca工具的文本分析功能。
+
+AI-Yuca是一个简单而强大的文本分析工具，它可以帮助用户快速获取文本的基本统计信息，如字符数、单词数和行数。
+
+此外，AI-Yuca还能够提取文本中的关键词，帮助用户了解文本的主要内容和焦点。
+
+希望这个工具能够为您的文本分析工作带来便利！

package/examples/upload-example.js

@@ -0,0 +1,53 @@
+/**
+ * 上传功能示例
+ */
+const { createStorageClient, uploadFiles } = require('../src/upload');
+
+async function uploadExample() {
+  try {
+    // 创建存储客户端
+    const storageClient = createStorageClient({
+      keyFilename: './path/to/your-keyfile.json'
+    });
+    
+    // 上传单个文件
+    console.log('上传单个文件...');
+    const singleFileResult = await uploadFiles({
+      bucketName: 'your-bucket-name',
+      sourcePath: './examples/sample.txt',
+      destination: 'uploads/sample.txt',
+      storageClient
+    });
+    
+    console.log('单个文件上传结果:', JSON.stringify(singleFileResult, null, 2));
+    
+    // 批量上传多个文件
+    console.log('\n批量上传多个文件...');
+    const multipleFilesResult = await uploadFiles({
+      bucketName: 'your-bucket-name',
+      sourcePath: ['./examples/sample.txt', './README.md'],
+      destination: 'uploads',
+      storageClient
+    });
+    
+    console.log('批量上传结果:', JSON.stringify(multipleFilesResult, null, 2));
+    
+    // 递归上传目录
+    console.log('\n递归上传目录...');
+    const directoryResult = await uploadFiles({
+      bucketName: 'your-bucket-name',
+      sourcePath: './examples',
+      destination: 'uploads/examples',
+      storageClient,
+      recursive: true
+    });
+    
+    console.log('目录上传结果:', JSON.stringify(directoryResult, null, 2));
+    
+  } catch (error) {
+    console.error('上传示例错误:', error.message);
+  }
+}
+
+// 运行示例
+uploadExample();

package/out/test.txt

@@ -0,0 +1 @@
+Hello World from config upload test

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "ai-yuca",
+  "version": "1.0.0",
+  "description": "一个实用的AI辅助工具",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "bin": {
+    "ai-yuca": "./dist/bin/cli.js"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "mocha -r ts-node/register 'test/**/*.ts'",
+    "start": "ts-node src/index.ts",
+    "lint": "eslint . --ext .ts",
+    "dev": "ts-node bin/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "tool",
+    "utility",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "@google-cloud/storage": "^7.17.1",
+    "commander": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.2",
+    "@types/google-cloud__storage": "^2.3.1",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^24.3.1",
+    "@types/sinon": "^17.0.4",
+    "@typescript-eslint/eslint-plugin": "^8.43.0",
+    "@typescript-eslint/parser": "^8.43.0",
+    "chai": "^4.3.4",
+    "eslint": "^9.35.0",
+    "mocha": "^11.7.2",
+    "sinon": "^21.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  }
+}

package/src/config.ts

@@ -0,0 +1,104 @@
+/**
+ * 配置文件读取模块
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+
+/**
+ * 配置文件接口
+ */
+export interface VSConfig {
+  upload: {
+    uploadPath: string;
+    s3Static: string;
+  };
+  aws: {
+    Bucket: string;
+    prefix: string;
+    Region: string;
+    HostName: string;
+  };
+  deploy?: {
+    baseUrl: string[];
+    host: string;
+    testHost: string;
+  };
+  crowdin?: {
+    project: string;
+    langMap: string[];
+    workDir: string;
+    reg: string;
+    keysDir: string;
+    Bucket: string;
+    prefix: string;
+    Region: string;
+    FromIni: string;
+    HostName: string;
+  };
+}
+
+/**
+ * 读取配置文件
+ * @param configPath - 配置文件路径，默认为项目根目录下的vs.config.json
+ * @returns 配置对象
+ */
+export function loadConfig(configPath?: string): VSConfig {
+  const defaultConfigPath = path.join(process.cwd(), 'vs.config.json');
+  const finalConfigPath = configPath || defaultConfigPath;
+  
+  if (!fs.existsSync(finalConfigPath)) {
+    throw new Error(`配置文件不存在: ${finalConfigPath}`);
+  }
+  
+  try {
+    const configContent = fs.readFileSync(finalConfigPath, 'utf-8');
+    const config = JSON.parse(configContent) as VSConfig;
+    
+    // 验证必要的配置项
+    if (!config.upload || !config.aws) {
+      throw new Error('配置文件缺少必要的upload或aws配置项');
+    }
+    
+    if (!config.upload.uploadPath || !config.upload.s3Static) {
+      throw new Error('配置文件缺少必要的upload.uploadPath或upload.s3Static配置项');
+    }
+    
+    if (!config.aws.Bucket || !config.aws.prefix) {
+      throw new Error('配置文件缺少必要的aws.Bucket或aws.prefix配置项');
+    }
+    
+    return config;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error(`配置文件格式错误: ${error.message}`);
+    }
+    throw error;
+  }
+}
+
+/**
+ * 获取上传桶名称
+ * @param config - 配置对象
+ * @returns 桶名称
+ */
+export function getBucketName(config: VSConfig): string {
+  return config.aws.Bucket;
+}
+
+/**
+ * 获取上传目标路径
+ * @param config - 配置对象
+ * @returns 目标路径
+ */
+export function getUploadDestination(config: VSConfig): string {
+  return `${config.aws.prefix}/${config.upload.s3Static}`;
+}
+
+/**
+ * 获取本地上传源路径
+ * @param config - 配置对象
+ * @returns 本地源路径
+ */
+export function getUploadSourcePath(config: VSConfig): string {
+  return path.join(process.cwd(), config.upload.uploadPath);
+}

package/src/download.ts

@@ -0,0 +1,216 @@
+/**
+ * GCP下载功能模块
+ */
+import { Storage, Bucket, File } from '@google-cloud/storage';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as util from 'util';
+import {
+  DownloadFileOptions,
+  DownloadFilesOptions,
+  DownloadSuccessResult,
+  DownloadFailedResult,
+  DownloadResult,
+  DownloadFilesResult
+} from './types/download';
+import { StorageClientOptions } from './types/upload';
+
+const mkdir = util.promisify(fs.mkdir);
+
+/**
+ * 创建GCP存储客户端
+ * @param options - 配置选项
+ * @returns GCP存储客户端实例
+ */
+function createStorageClient(options: Partial<StorageClientOptions> = {}): Storage {
+  const { keyFilename, projectId, credentials } = options;
+  
+  // 如果提供了keyFilename，使用密钥文件认证
+  if (keyFilename) {
+    return new Storage({
+      keyFilename
+    });
+  }
+  
+  // 如果提供了credentials，使用凭证对象认证
+  if (credentials) {
+    return new Storage({
+      projectId,
+      credentials
+    });
+  }
+  
+  // 使用应用默认凭证（ADC）进行免密认证
+  return new Storage();
+}
+
+/**
+ * 确保目录存在，如果不存在则创建
+ * @param dirPath - 目录路径
+ */
+async function ensureDirectoryExists(dirPath: string): Promise<void> {
+  try {
+    if (!fs.existsSync(dirPath)) {
+      await mkdir(dirPath, { recursive: true });
+    }
+  } catch (error) {
+    throw new Error(`创建目录失败: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+/**
+ * 下载单个文件从GCP存储桶
+ * @param options - 下载选项
+ * @returns 下载结果
+ */
+async function downloadFile(options: DownloadFileOptions): Promise<DownloadResult> {
+  const { bucketName, sourcePath, destinationPath, storageClient } = options;
+  
+  if (!bucketName || !sourcePath || !destinationPath || !storageClient) {
+    throw new Error('缺少必要的下载参数');
+  }
+  
+  try {
+    // 获取存储桶
+    const bucket: Bucket = storageClient.bucket(bucketName);
+    const file: File = bucket.file(sourcePath);
+    
+    // 检查文件是否存在
+    const [exists] = await file.exists();
+    if (!exists) {
+      throw new Error(`文件不存在: ${sourcePath}`);
+    }
+    
+    // 确保目标目录存在
+    const destDir = path.dirname(destinationPath);
+    await ensureDirectoryExists(destDir);
+    
+    // 下载文件
+    await file.download({
+      destination: destinationPath
+    });
+    
+    return {
+      success: true,
+      file: sourcePath,
+      localPath: destinationPath
+    };
+  } catch (error) {
+    return {
+      success: false,
+      file: sourcePath,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+
+/**
+ * 列出存储桶中的文件和目录
+ * @param bucket - 存储桶
+ * @param prefix - 前缀路径
+ * @returns 文件和目录列表
+ */
+async function listFiles(bucket: Bucket, prefix: string = ''): Promise<string[]> {
+  try {
+    const options = {
+      prefix: prefix,
+      delimiter: '/'
+    };
+    
+    const [files, , apiResponse] = await bucket.getFiles(options);
+    
+    // 获取文件路径
+    const filePaths = files.map(file => file.name);
+    
+    // 获取目录前缀
+    const prefixes = apiResponse && typeof apiResponse === 'object' && 'prefixes' in apiResponse
+      ? (apiResponse.prefixes as string[] || [])
+      : [];
+    
+    return [...filePaths, ...prefixes];
+  } catch (error) {
+    throw new Error(`列出文件失败: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+/**
+ * 批量下载文件从GCP存储桶
+ * @param options - 下载选项
+ * @returns 下载结果
+ */
+async function downloadFiles(options: DownloadFilesOptions): Promise<DownloadFilesResult> {
+  const { bucketName, sourcePath, destinationPath, storageClient, recursive = false } = options;
+  
+  if (!bucketName || !sourcePath || !destinationPath || !storageClient) {
+    throw new Error('缺少必要的下载参数');
+  }
+  
+  const results: DownloadFilesResult = {
+    success: [],
+    failed: []
+  };
+  
+  try {
+    // 获取存储桶
+    const bucket: Bucket = storageClient.bucket(bucketName);
+    
+    // 确保目标目录存在
+    await ensureDirectoryExists(destinationPath);
+    
+    // 列出源路径下的所有文件
+    const files = await listFiles(bucket, sourcePath);
+    
+    for (const file of files) {
+      // 如果是目录（以/结尾）
+      if (file.endsWith('/')) {
+        if (recursive) {
+          // 递归下载子目录
+          const subSourcePath = file;
+          const subDestinationPath = path.join(destinationPath, path.basename(file));
+          
+          const subResults = await downloadFiles({
+            bucketName,
+            sourcePath: subSourcePath,
+            destinationPath: subDestinationPath,
+            storageClient,
+            recursive
+          });
+          
+          results.success = results.success.concat(subResults.success);
+          results.failed = results.failed.concat(subResults.failed);
+        }
+      } else {
+        // 下载文件
+        const relativePath = file.startsWith(sourcePath) 
+          ? file.substring(sourcePath.length) 
+          : file;
+        
+        const destFilePath = path.join(destinationPath, relativePath);
+        
+        const result = await downloadFile({
+          bucketName,
+          sourcePath: file,
+          destinationPath: destFilePath,
+          storageClient
+        });
+        
+        if (result.success) {
+          results.success.push(result);
+        } else {
+          results.failed.push(result);
+        }
+      }
+    }
+    
+    return results;
+  } catch (error) {
+    throw new Error(`下载文件失败: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+export {
+  createStorageClient,
+  downloadFile,
+  downloadFiles,
+  ensureDirectoryExists
+};

package/src/index.js

@@ -0,0 +1,88 @@
+/**
+ * AI-Yuca 核心功能模块
+ */
+
+/**
+ * 分析文本内容
+ * @param {Object} options - 分析选项
+ * @param {string} [options.file] - 要分析的文件路径
+ * @param {string} [options.text] - 要分析的文本内容
+ * @returns {Object} 分析结果
+ */
+function analyze(options) {
+  const { file, text } = options;
+  
+  if (!file && !text) {
+    console.error('错误: 必须提供文件路径或文本内容');
+    process.exit(1);
+  }
+  
+  let content = '';
+  
+  if (file) {
+    try {
+      const fs = require('fs');
+      content = fs.readFileSync(file, 'utf8');
+    } catch (err) {
+      console.error(`错误: 无法读取文件 ${file}`);
+      console.error(err.message);
+      process.exit(1);
+    }
+  } else if (text) {
+    content = text;
+  }
+  
+  // 执行分析
+  const result = analyzeContent(content);
+  
+  // 输出结果
+  console.log('分析结果:');
+  console.log(JSON.stringify(result, null, 2));
+  
+  return result;
+}
+
+/**
+ * 分析文本内容的核心功能
+ * @param {string} content - 要分析的文本内容
+ * @returns {Object} 分析结果
+ */
+function analyzeContent(content) {
+  // 基本统计
+  const charCount = content.length;
+  // 改进的单词计数，同时支持英文和中文
+  const wordCount = content.match(/[\w\u4e00-\u9fa5]+/g)?.length || 0;
+  const lineCount = content.split('\n').length;
+  
+  // 关键词提取 (简单实现)
+  const words = content.toLowerCase()
+    .replace(/[^\w\s]/g, '')
+    .split(/\s+/)
+    .filter(word => word.length > 3);
+  
+  const wordFrequency = {};
+  words.forEach(word => {
+    wordFrequency[word] = (wordFrequency[word] || 0) + 1;
+  });
+  
+  // 获取前5个最常见的词
+  const topKeywords = Object.entries(wordFrequency)
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, 5)
+    .map(([word, count]) => ({ word, count }));
+  
+  return {
+    statistics: {
+      charCount,
+      wordCount,
+      lineCount
+    },
+    keywords: topKeywords,
+    summary: `文本包含 ${charCount} 个字符, ${wordCount} 个单词, ${lineCount} 行。`
+  };
+}
+
+module.exports = {
+  analyze,
+  analyzeContent
+};

package/src/index.ts

@@ -0,0 +1,98 @@
+/**
+ * AI-Yuca 核心功能模块
+ */
+import * as fs from 'fs';
+import {
+  AnalyzeOptions,
+  Statistics,
+  Keyword,
+  AnalysisResult
+} from './types/analyze';
+
+/**
+ * 分析文本内容
+ * @param options - 分析选项
+ * @returns 分析结果
+ */
+function analyze(options: AnalyzeOptions): AnalysisResult {
+  const { file, text } = options;
+  
+  if (!file && !text) {
+    console.error('错误: 必须提供文件路径或文本内容');
+    process.exit(1);
+  }
+  
+  let content = '';
+  
+  if (file) {
+    try {
+      content = fs.readFileSync(file, 'utf8');
+    } catch (err) {
+      console.error(`错误: 无法读取文件 ${file}`);
+      if (err instanceof Error) {
+        console.error(err.message);
+      }
+      process.exit(1);
+    }
+  } else if (text) {
+    content = text;
+  }
+  
+  // 执行分析
+  const result = analyzeContent(content);
+  
+  // 输出结果
+  console.log('分析结果:');
+  console.log(JSON.stringify(result, null, 2));
+  
+  return result;
+}
+
+/**
+ * 分析文本内容的核心功能
+ * @param content - 要分析的文本内容
+ * @returns 分析结果
+ */
+function analyzeContent(content: string): AnalysisResult {
+  // 基本统计
+  const charCount = content.length;
+  // 改进的单词计数，同时支持英文和中文
+  const wordCount = content.match(/[\w\u4e00-\u9fa5]+/g)?.length || 0;
+  const lineCount = content.split('\n').length;
+  
+  // 关键词提取 (简单实现)
+  const words = content.toLowerCase()
+    .replace(/[^\w\s]/g, '')
+    .split(/\s+/)
+    .filter(word => word.length > 3);
+  
+  const wordFrequency: Record<string, number> = {};
+  words.forEach(word => {
+    wordFrequency[word] = (wordFrequency[word] || 0) + 1;
+  });
+  
+  // 获取前5个最常见的词
+  const topKeywords = Object.entries(wordFrequency)
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, 5)
+    .map(([word, count]) => ({ word, count }));
+  
+  return {
+    statistics: {
+      charCount,
+      wordCount,
+      lineCount
+    },
+    keywords: topKeywords,
+    summary: `文本包含 ${charCount} 个字符, ${wordCount} 个单词, ${lineCount} 行。`
+  };
+}
+
+export {
+  analyze,
+  analyzeContent
+};
+export { createStorageClient, uploadFile, uploadFiles } from './upload';
+export { downloadFiles } from './download';
+export { uploadFilesWithConfig, getConfigSummary } from './uploadWithConfig';
+export { loadConfig, getBucketName, getUploadDestination, getUploadSourcePath } from './config';

package/src/types/analyze.ts

@@ -0,0 +1,37 @@
+/**
+ * 分析功能相关类型定义
+ */
+
+/**
+ * 分析选项接口
+ */
+export interface AnalyzeOptions {
+  file?: string;
+  text?: string;
+}
+
+/**
+ * 分析结果统计接口
+ */
+export interface Statistics {
+  charCount: number;
+  wordCount: number;
+  lineCount: number;
+}
+
+/**
+ * 关键词接口
+ */
+export interface Keyword {
+  word: string;
+  count: number;
+}
+
+/**
+ * 分析结果接口
+ */
+export interface AnalysisResult {
+  statistics: Statistics;
+  keywords: Keyword[];
+  summary: string;
+}