AigCode 组件上传工具

一个强大的 VS Code 扩展，用于将 TypeScript React (TSX) 组件文件上传到 AigCode 数据库。支持单文件上传、批量上传和智能路径过滤功能。

✨ 功能特性

🚀 单文件上传：右键菜单快速上传当前 TSX 文件
📁 批量上传：一键上传整个文件夹中的所有 TSX 文件
🎯 智能过滤：支持路径配置，只上传指定路径的文件
📝 增量上传：自动检测文件变更，跳过未修改的文件
🗑️ 缓存管理：支持清除上传缓存，强制重新上传
⚙️ 灵活配置：支持通配符模式的路径包含和排除规则

📦 安装方法

在 VS Code 扩展市场搜索 "aigcode-comp-update"
点击安装
重启 VS Code（如需要）

🎮 使用方法

单文件上传

打开任意 .tsx 文件
右键选择 "上传当前 TSX 文件到数据库"
等待上传完成提示

批量上传文件夹

在资源管理器中右键点击文件夹
选择 "上传文件夹中的所有TSX文件到数据库"
选择上传模式：
- 只上传已修改的文件：跳过未修改的文件（推荐）
- 上传所有文件：强制上传所有符合条件的文件
查看进度条和结果统计

命令面板使用

按 Ctrl/Cmd + Shift + P 打开命令面板，输入以下命令：

上传当前 TSX 文件到数据库
上传文件夹中的所有TSX文件到数据库
清除TSX文件上传缓存
open upload aigcode comps settings

⚙️ 配置设置

快速配置

使用命令面板执行 "open upload aigcode comps settings" 快速打开配置页面。

手动配置

在 VS Code 设置中搜索 aigcodeCompUpdate，或者在 settings.json 中添加：

{
  "aigcodeCompUpdate.allowedPaths": [
    "components/**/*.tsx",
    "src/ui/**/*.tsx",
    "pages/**/*.tsx"
  ],
  "aigcodeCompUpdate.excludedPaths": [
    "**/node_modules/**",
    "**/dist/**",
    "**/build/**",
    "**/.git/**"
  ]
}

配置项说明

`allowedPaths` - 允许上传的路径

类型：字符串数组
默认值：[]（空数组表示允许所有路径）
说明：定义允许上传的文件路径模式
支持通配符：
- *：匹配除路径分隔符外的任意字符
- **：匹配任意字符（包括路径分隔符）
- ?：匹配单个字符

`excludedPaths` - 排除上传的路径

类型：字符串数组
默认值：["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**"]
说明：定义需要排除的文件路径模式
优先级：排除规则优先于允许规则

📝 配置示例

示例 1：只上传特定组件目录

{
  "aigcodeCompUpdate.allowedPaths": [
    "src/components/**/*.tsx",
    "src/pages/**/*.tsx"
  ]
}

示例 2：上传所有文件但排除测试文件

{
  "aigcodeCompUpdate.allowedPaths": [],
  "aigcodeCompUpdate.excludedPaths": [
    "**/node_modules/**",
    "**/dist/**",
    "**/build/**",
    "**/.git/**",
    "**/__tests__/**",
    "**/*.test.tsx",
    "**/*.spec.tsx"
  ]
}

示例 3：特定项目结构配置

{
  "aigcodeCompUpdate.allowedPaths": [
    "packages/ui/src/**/*.tsx",
    "apps/web/components/**/*.tsx",
    "shared/components/**/*.tsx"
  ],
  "aigcodeCompUpdate.excludedPaths": [
    "**/node_modules/**",
    "**/dist/**",
    "**/build/**",
    "**/.git/**",
    "**/temp/**",
    "**/stories/**"
  ]
}

🔧 功能详解

智能缓存机制

扩展会自动计算文件内容的 MD5 哈希值，只上传发生变更的文件：

✅ 文件内容变更：自动检测并上传
⏭️ 文件未变更：跳过上传，显示提示
🔄 强制上传：通过 "上传所有文件" 选项强制上传

上传状态反馈

📊 进度条：显示批量上传的实时进度
📈 统计信息：显示成功、跳过、失败的文件数量
💬 状态提示：详细的成功、警告、错误消息

路径过滤逻辑

排除检查：首先检查文件是否在排除列表中
允许检查：然后检查文件是否在允许列表中
默认行为：如果允许列表为空，则允许所有文件（除了排除的）

🚨 注意事项

确保网络连接正常，扩展需要访问 https://generate-code-eight.vercel.app
大型项目建议使用路径过滤功能，避免上传不必要的文件
批量上传时建议选择 "只上传已修改的文件" 以提高效率
如果遇到上传失败，检查文件内容是否为有效的 TSX 格式

🛠️ 故障排除

上传失败怎么办？

检查网络连接
确认文件是有效的 TSX 格式
查看 VS Code 输出面板的错误信息
尝试清除缓存后重新上传

文件没有上传怎么办？

检查文件路径是否符合 allowedPaths 配置
检查文件是否在 excludedPaths 排除列表中
确认文件扩展名为 .tsx
查看控制台提示信息

如何重置所有设置？

执行 "清除TSX文件上传缓存" 命令
在设置中重置 aigcodeCompUpdate 相关配置
重启 VS Code

📄 许可证

本扩展遵循 MIT 许可证。

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个扩展！

享受高效的组件管理体验！ 🎉

aigcode-comp-update

wayne