jimmyandClaude
bf03ca9535
本次重构将原有1672行的FilePane.vue拆分为多个独立模块，代码减少至1405行（-16%） ## 新增文件 ### Composables - useDragSelection.ts: 拖拽框选功能，包含自动滚动和选择框计算 - useDragAndDrop.ts: 拖放功能，管理拖拽状态和自定义预览 - index.ts: 统一导出所有composables ### Utils - fileOperations.ts: 文件操作工具集（移动、复制、删除、重命名、创建、搜索） ## 主要改进 ### 架构优化 - 将巨型组件拆分为职责单一的模块 - 实现关注点分离，提高代码可读性 - 增强composables复用性，可用于其他组件 ### 功能优化 - 支持双面板独立配置（视图模式、缩放级别） - 优化拖放视觉反馈，完成后绿框自动消失 - 简化拖拽动画效果，视觉更轻盈 - 文件移动支持重名自动处理 ### 代码质量 - 完整的TypeScript类型定义 - 更严格的参数验证和错误处理 - 减少代码重复，提高可测试性 - 优化事件处理器性能 ## 功能完整性 ✅ 拖拽框选文件 ✅ 边缘自动滚动 ✅ 拖放文件/文件夹 ✅ 跨面板移动 ✅ Ctrl+滚轮缩放 ✅ 面板激活状态 ✅ 视图切换（网格/列表） ✅ 实时文件移动预览 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Argus
一个基于 Vue 3 + Go + Gin 构建的现代化相册管理系统，专注于图片的智能处理、管理和展示。
特性
- 现代化界面: 基于 Vue 3 + Naive UI 的响应式前端界面
- 智能图片处理: 支持图片压缩、格式转换、缩略图生成
- EXIF 信息管理: 读取、编辑和删除图片的 EXIF 元数据
- 多路径管理: 支持添加多个照片存储路径，灵活管理相册
- 任务调度: 后台任务处理系统，支持大批量图片处理
- 跨平台: 支持 Windows、Linux、macOS
🛠 技术栈
前端 (Vue 3)
- 框架: Vue 3.5.13 + TypeScript 5.8
- UI 库: Naive UI 2.41.1
- 路由: Vue Router 4.5.0
- 状态管理: Pinia 3.0.1
- HTTP 客户端: Axios 1.9.0
- 图标: @vicons/ionicons5 0.13.0
- 构建工具: Vite 6.2.4
- 开发工具:
- ESLint 9.22.0 (代码规范)
- Prettier 3.5.3 (代码格式化)
- Vitest 3.1.1 (单元测试)
后端 (Go 1.24)
- Web 框架: Gin 1.10.1
- ORM: GORM 1.30.0
- 日志: Zap 1.27.0 + Lumberjack 2.2.1
- UUID: Google UUID 1.6.0
- 文件类型检测: h2non/filetype 1.1.3
- 跨域: gin-contrib/cors 1.7.5
- 性能监控: gin-contrib/pprof 1.5.3
数据库
- SQLite: 默认数据库，适合轻量级部署
- MySQL: 可选的关系型数据库支持
图片处理工具
- ExifTool: 图片 EXIF 信息读取和编辑
- ImageMagick: 图片格式转换和基础处理
- libvips: 高性能图片压缩和处理库
🚀 主要功能
已完成功能
-
资料库管理
- 添加/删除图片存储路径
- 启用/禁用指定路径
- 路径有效性验证
-
图片处理
- EXIF 信息读取、编辑、删除
- 图片格式转换 (JPEG, PNG, WebP, AVIF 等)
- 图片压缩和优化
- 缩略图生成
- 批量处理支持
-
后台任务系统
- 任务队列管理
- 图片索引和处理任务
- 任务状态监控
计划中功能
- 照片相似度检测
- 人脸识别和分类
- 智能标签系统
- 照片地理位置管理
- 全文搜索功能
📦 安装和配置
环境要求
- Node.js 22.x 或更高版本
- Go 1.24 或更高版本
- SQLite 3.x
开发环境搭建
- 克隆项目
git clone https://github.com/yourusername/argus-go.git
cd argus-go
- 安装外部工具依赖
根据你的操作系统，下载并安装以下工具：
Windows:
- 下载 ExifTool 并解压到
src/rear/tools/windows_amd64/exiftool/ - 下载 ImageMagick Portable 并解压到
src/rear/tools/windows_amd64/imagemagick/ - 下载 libvips 并解压到
src/rear/tools/windows_amd64/libvips/
Linux/macOS:
# Ubuntu/Debian
sudo apt-get install exiftool imagemagick libvips-tools
# macOS
brew install exiftool imagemagick vips
- 启动后端服务
cd src/rear
go mod download
go run main.go
- 启动前端服务
cd src/front/argus-front
npm install
npm run dev
- 访问应用
- 前端地址: http://localhost:5173
- 后端 API: http://localhost:8080
生产环境部署
- 构建前端
cd src/front/argus-front
npm run build
- 构建后端
cd src/rear
go build -o argus-server main.go
- 配置数据库 (可选，默认使用 SQLite)
- 修改配置文件中的数据库连接信息
- 支持 MySQL 数据库
- 启动服务
./argus-server
🤝 贡献指南
欢迎贡献代码！请遵循以下规范：
开发规范
-
代码风格
- 前端: ESLint + Prettier 配置
- 后端: Go 标准格式化工具
-
提交规范
- 使用语义化提交信息
- 每个 commit 应该是一个完整的功能点
-
测试要求
- 新功能需要添加相应的单元测试
- 确保现有测试通过
贡献流程
- Fork 项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
📄 许可证
本项目采用 GPL 许可证 - 查看 LICENSE 文件了解详情
📞 联系方式
如有问题或建议，请通过以下方式联系：
🙏 致谢
感谢以下开源项目的支持：