ai-yuca 1.0.0

package/.eslintrc.js

@@ -0,0 +1,25 @@
+module.exports = {
+  env: {
+    node: true,
+    commonjs: true,
+    es2021: true,
+    mocha: true
+  },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended'
+  ],
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 12,
+    sourceType: 'module'
+  },
+  plugins: ['@typescript-eslint'],
+  rules: {
+    'no-unused-vars': 'off',
+    '@typescript-eslint/no-unused-vars': 'warn',
+    'no-console': 'off',
+    'indent': ['error', 2],
+    'semi': ['error', 'always']
+  }
+};

package/CONFIG_UPLOAD.md

@@ -0,0 +1,154 @@
+# 基于配置文件的上传功能
+
+## 概述
+
+本项目新增了基于 `vs.config.json` 配置文件的批量上传功能，可以自动读取配置信息并执行上传操作，无需手动指定桶名称、源路径和目标路径。
+
+## 配置文件格式
+
+在项目根目录创建 `vs.config.json` 文件，格式如下：
+
+```json
+{
+  "upload": {
+    "uploadPath": "out",
+    "s3Static": "static/aiAgent"
+  },
+  "aws": {
+    "Bucket": "your-bucket-name",
+    "prefix": "your-prefix",
+    "Region": "us-east-1",
+    "HostName": "https://your-cdn-domain.com"
+  }
+}
+```
+
+### 配置项说明
+
+- `upload.uploadPath`: 本地上传源文件夹路径（相对于项目根目录）
+- `upload.s3Static`: 存储桶中的子路径
+- `aws.Bucket`: GCP 存储桶名称
+- `aws.prefix`: 存储桶中的前缀路径
+- `aws.Region`: 存储区域
+- `aws.HostName`: CDN 域名
+
+**最终上传路径**: `{aws.prefix}/{upload.s3Static}`
+
+## 使用方法
+
+### 1. 命令行使用
+
+#### 基本上传
+```bash
+# 使用默认配置文件上传
+node dist/bin/cli.js upload-config
+
+# 指定自定义配置文件
+node dist/bin/cli.js upload-config -c /path/to/custom-config.json
+
+# 使用服务账号密钥文件
+node dist/bin/cli.js upload-config -k /path/to/service-account.json
+```
+
+#### 覆盖配置选项
+```bash
+# 自定义源路径（覆盖配置文件中的 uploadPath）
+node dist/bin/cli.js upload-config -s /custom/source/path
+
+# 自定义目标路径（覆盖配置文件中的目标路径）
+node dist/bin/cli.js upload-config -d custom/destination/path
+
+# 禁用递归上传
+node dist/bin/cli.js upload-config --no-recursive
+
+# 禁用 GZIP 压缩
+node dist/bin/cli.js upload-config --no-compression
+```
+
+#### 查看配置信息
+```bash
+# 显示当前配置信息（不执行上传）
+node dist/bin/cli.js upload-config --show-config
+```
+
+#### 查看帮助信息
+```bash
+# 查看 upload-config 命令的详细帮助
+node dist/bin/cli.js upload-config --help
+```
+
+### 2. 代码中使用
+
+```typescript
+import { uploadFilesWithConfig, getConfigSummary } from 'ai-yuca';
+
+// 基本使用
+async function uploadWithConfig() {
+  try {
+    const result = await uploadFilesWithConfig();
+    console.log(`上传完成: 成功 ${result.success.length}, 失败 ${result.failed.length}`);
+  } catch (error) {
+    console.error('上传失败:', error.message);
+  }
+}
+
+// 自定义选项
+async function uploadWithCustomOptions() {
+  const result = await uploadFilesWithConfig({
+    configPath: '/path/to/custom-config.json',
+    storageClientOptions: {
+      keyFilename: '/path/to/service-account.json'
+    },
+    customSourcePath: '/custom/source',
+    customDestination: 'custom/destination',
+    recursive: true,
+    enableCompression: true
+  });
+}
+
+// 获取配置信息
+function showConfig() {
+  const config = getConfigSummary();
+  console.log('桶名称:', config.bucketName);
+  console.log('源路径:', config.sourcePath);
+  console.log('目标路径:', config.destination);
+}
+```
+
+## 功能特性
+
+1. **自动配置读取**: 自动读取 `vs.config.json` 配置文件
+2. **路径自动组合**: 自动组合 `aws.prefix` 和 `upload.s3Static` 作为目标路径
+3. **灵活覆盖**: 支持通过命令行参数覆盖配置文件中的设置
+4. **配置验证**: 自动验证配置文件的必要字段
+5. **错误处理**: 详细的错误信息和异常处理
+6. **压缩支持**: 自动对 js、css、json、html、woff 文件启用 GZIP 压缩
+7. **递归上传**: 支持递归上传目录中的所有文件
+
+## 示例配置
+
+根据提供的配置文件，实际的上传行为如下：
+
+- **源路径**: `{项目根目录}/out`
+- **目标桶**: `decom-cdn`
+- **目标路径**: `fed/static/aiAgent`
+- **完整 URL**: `https://cdn.cn2u.xyz/fed/static/aiAgent/{文件名}`
+
+## 错误处理
+
+常见错误及解决方法：
+
+1. **配置文件不存在**: 确保项目根目录存在 `vs.config.json` 文件
+2. **配置格式错误**: 检查 JSON 格式是否正确
+3. **缺少必要配置**: 确保包含 `upload` 和 `aws` 配置项
+4. **源路径不存在**: 确保 `uploadPath` 指定的目录存在
+5. **认证失败**: 确保 GCP 认证配置正确
+
+## 与原有功能的关系
+
+新的 `upload-config` 命令是对原有 `upload` 命令的补充：
+
+- `upload`: 需要手动指定所有参数，适合临时上传
+- `upload-config`: 基于配置文件，适合项目中的常规上传操作
+
+两个命令可以并存使用，根据不同场景选择合适的方式。

package/CONTRIBUTING.md

@@ -0,0 +1,58 @@
+# 贡献指南
+
+感谢您考虑为AI-Yuca项目做出贡献！以下是一些指导方针，帮助您参与项目开发。
+
+## 开发环境设置
+
+1. 克隆仓库
+
+```bash
+git clone https://github.com/yourusername/ai-yuca.git
+cd ai-yuca
+```
+
+2. 安装依赖
+
+```bash
+npm install
+```
+
+3. 运行测试
+
+```bash
+npm test
+```
+
+## 代码风格
+
+本项目使用ESLint进行代码风格检查。在提交代码前，请确保您的代码通过了lint检查：
+
+```bash
+npm run lint
+```
+
+## 提交Pull Request
+
+1. Fork本仓库
+2. 创建您的特性分支 (`git checkout -b feature/amazing-feature`)
+3. 提交您的更改 (`git commit -m 'Add some amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 打开一个Pull Request
+
+## 功能建议
+
+如果您有新功能的想法，请先开一个issue讨论您想要添加的内容，以确保它符合项目的方向。
+
+## 报告Bug
+
+如果您发现了bug，请创建一个issue，并尽可能详细地描述问题，包括：
+
+- 问题的简要描述
+- 复现步骤
+- 预期行为
+- 实际行为
+- 环境信息（操作系统、Node.js版本等）
+
+## 许可证
+
+通过贡献代码，您同意您的贡献将在MIT许可证下发布。

package/INSTALLATION.md

@@ -0,0 +1,192 @@
+# AI-Yuca CLI 安装指南
+
+本文档介绍如何将 AI-Yuca CLI 工具注册到系统中，使其可以在任何地方使用。
+
+## 方法一：本地开发链接（推荐用于开发）
+
+如果你正在开发或测试这个项目，可以使用 `npm link` 将项目链接到全局：
+
+```bash
+# 在项目根目录下执行
+npm run build  # 确保项目已编译
+npm link       # 创建全局链接
+```
+
+执行后，你就可以在任何地方使用 `ai-yuca` 命令了：
+
+```bash
+# 在任何目录下都可以使用
+ai-yuca --help
+ai-yuca init
+ai-yuca upload-config --show-config
+```
+
+### 取消链接
+
+如果不再需要全局链接，可以取消：
+
+```bash
+npm unlink -g ai-yuca
+```
+
+## 方法二：发布到 NPM Registry
+
+### 准备发布
+
+1. **确保项目信息完整**：
+   ```json
+   {
+     "name": "ai-yuca",
+     "version": "1.0.0",
+     "description": "一个实用的AI辅助工具",
+     "author": "你的名字",
+     "license": "MIT",
+     "repository": {
+       "type": "git",
+       "url": "https://github.com/你的用户名/ai-yuca.git"
+     }
+   }
+   ```
+
+2. **登录 NPM**：
+   ```bash
+   npm login
+   ```
+
+3. **发布包**：
+   ```bash
+   npm publish
+   ```
+
+### 用户安装
+
+发布后，其他用户可以通过以下方式安装：
+
+```bash
+# 全局安装
+npm install -g ai-yuca
+
+# 使用 yarn
+yarn global add ai-yuca
+
+# 使用 pnpm
+pnpm add -g ai-yuca
+```
+
+## 方法三：直接从 Git 安装
+
+用户也可以直接从 Git 仓库安装：
+
+```bash
+# 从 GitHub 安装
+npm install -g git+https://github.com/你的用户名/ai-yuca.git
+
+# 从特定分支安装
+npm install -g git+https://github.com/你的用户名/ai-yuca.git#分支名
+```
+
+## 方法四：本地安装包
+
+如果你有打包好的 `.tgz` 文件：
+
+```bash
+# 创建包文件
+npm pack
+
+# 安装本地包
+npm install -g ./ai-yuca-1.0.0.tgz
+```
+
+## 验证安装
+
+无论使用哪种方法，安装完成后都可以验证：
+
+```bash
+# 检查命令是否可用
+ai-yuca --version
+ai-yuca --help
+
+# 检查所有子命令
+ai-yuca analyze --help
+ai-yuca upload --help
+ai-yuca download --help
+ai-yuca upload-config --help
+ai-yuca init --help
+```
+
+## 卸载
+
+```bash
+# 卸载全局安装的包
+npm uninstall -g ai-yuca
+
+# 使用 yarn
+yarn global remove ai-yuca
+
+# 使用 pnpm
+pnpm remove -g ai-yuca
+```
+
+## 故障排除
+
+### 权限问题
+
+如果在 macOS 或 Linux 上遇到权限问题：
+
+```bash
+# 使用 sudo（不推荐）
+sudo npm install -g ai-yuca
+
+# 或者配置 npm 使用不同的目录（推荐）
+npm config set prefix ~/.npm-global
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### 命令找不到
+
+如果安装后命令找不到，检查：
+
+1. **PATH 环境变量**：
+   ```bash
+   echo $PATH
+   npm config get prefix
+   ```
+
+2. **npm 全局目录**：
+   ```bash
+   npm list -g --depth=0
+   ```
+
+3. **重新加载 shell**：
+   ```bash
+   source ~/.bashrc  # 或 ~/.zshrc
+   ```
+
+## 开发者注意事项
+
+### package.json 配置
+
+确保 `package.json` 中的 `bin` 字段正确配置：
+
+```json
+{
+  "bin": {
+    "ai-yuca": "./dist/bin/cli.js"
+  }
+}
+```
+
+### 构建脚本
+
+确保在发布前运行构建：
+
+```json
+{
+  "scripts": {
+    "prepublishOnly": "npm run build"
+  }
+}
+```
+
+这样可以确保每次发布前都会自动构建最新版本。

package/README.md

@@ -0,0 +1,80 @@
+# AI-Yuca
+
+一个实用的AI辅助命令行工具
+
+## 安装
+
+```bash
+npm install -g ai-yuca
+```
+
+## 使用方法
+
+```bash
+ai-yuca <命令> [选项]
+```
+
+### 可用命令
+
+- `help`: 显示帮助信息
+- `version`: 显示版本信息
+- `analyze`: 分析文本内容
+- `upload`: 上传文件到GCP存储桶
+
+### 示例
+
+```bash
+# 分析文本文件
+ai-yuca analyze --file example.txt
+
+# 上传单个文件到GCP存储桶（使用密钥文件）
+ai-yuca upload --source path/to/file.txt --bucket your-bucket-name --key-file path/to/keyfile.json
+
+# 使用应用默认凭证免密上传（需先设置GOOGLE_APPLICATION_CREDENTIALS环境变量）
+ai-yuca upload --source path/to/file.txt --bucket your-bucket-name
+
+# 批量上传多个文件
+ai-yuca upload --source file1.txt file2.txt file3.txt --bucket your-bucket-name --key-file path/to/keyfile.json
+
+# 递归上传目录中的所有文件
+ai-yuca upload --source path/to/directory --bucket your-bucket-name --key-file path/to/keyfile.json --recursive
+```
+
+## 特性
+
+- 简单易用的命令行界面
+- 强大的文本分析功能
+- GCP文件上传功能，支持批量和递归上传
+- 支持多种GCP认证方式，包括密钥文件和应用默认凭证（免密上传）
+- 完整的TypeScript类型支持
+- 可扩展的插件系统
+
+## 开发
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 构建
+
+```bash
+npm run build
+```
+
+### 开发模式运行
+
+```bash
+npm run dev
+```
+
+### 运行测试
+
+```bash
+npm test
+```
+
+## 许可证
+
+MIT

package/bin/cli.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const pkg = require('../package.json');
+const { analyze } = require('../src/index');
+const { createStorageClient, uploadFiles } = require('../src/upload');
+
+// 设置版本和描述
+program
+  .version(pkg.version, '-v, --version')
+  .description(pkg.description);
+
+// 添加analyze命令
+program
+  .command('analyze')
+  .description('分析文本内容')
+  .option('-f, --file <path>', '指定要分析的文件路径')
+  .option('-t, --text <text>', '直接分析提供的文本')
+  .action((options) => {
+    analyze(options);
+  });
+
+// 添加upload命令
+program
+  .command('upload')
+  .description('上传文件到GCP存储桶')
+  .option('-s, --source <paths...>', '指定要上传的文件或目录路径（支持多个）')
+  .option('-b, --bucket <name>', 'GCP存储桶名称')
+  .option('-d, --destination <path>', '目标路径（存储桶中的路径）')
+  .option('-k, --key-file <path>', 'GCP服务账号密钥文件路径')
+  .option('-r, --recursive', '递归上传目录中的文件', false)
+  .action(async (options) => {
+    try {
+      const { source, bucket, destination, keyFile, recursive } = options;
+      
+      if (!source || !bucket || !keyFile) {
+        console.error('错误: 必须提供源文件路径、存储桶名称和密钥文件路径');
+        process.exit(1);
+      }
+      
+      // 创建存储客户端
+      const storageClient = createStorageClient({ keyFilename: keyFile });
+      
+      console.log('开始上传文件...');
+      
+      // 执行上传
+      const results = await uploadFiles({
+        bucketName: bucket,
+        sourcePath: source,
+        destination,
+        storageClient,
+        recursive
+      });
+      
+      // 输出结果
+      console.log('\n上传完成!');
+      console.log(`成功: ${results.success.length} 个文件`);
+      console.log(`失败: ${results.failed.length} 个文件`);
+      
+      if (results.success.length > 0) {
+        console.log('\n成功上传的文件:');
+        results.success.forEach(file => {
+          console.log(`- ${file.file} (${file.url})`);
+        });
+      }
+      
+      if (results.failed.length > 0) {
+        console.log('\n上传失败的文件:');
+        results.failed.forEach(file => {
+          console.log(`- ${file.file}: ${file.error}`);
+        });
+      }
+    } catch (err) {
+      console.error(`上传错误: ${err.message}`);
+      process.exit(1);
+    }
+  });
+
+// 解析命令行参数
+program.parse(process.argv);
+
+// 如果没有提供任何命令，显示帮助信息
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}