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 来改进这个扩展!
享受高效的组件管理体验! 🎉