SVN智能合并工具 - 用户指南

一个为VSCode提供智能化SVN合并功能的插件，支持高级筛选和AI冲突解决。本指南将帮助您快速上手并充分利用所有功能。

🌟 功能特性

核心优势

🎯 完整的VSCode内合并体验：无需切换工具，在熟悉的编辑器中完成所有SVN合并操作
🔍 高级版本筛选：支持按日期范围、版本号、提交者、关键词等多条件智能筛选
🤖 AI驱动的冲突解决：遇到代码冲突时，AI自动分析并提供修改建议
📋 一体化操作界面：在单一界面完成版本选择、预览和合并操作
👥 跨团队协作支持：自动生成合并报告，便于团队沟通和记录

主要功能模块

✅ 项目管理：图形化管理多个SVN项目（主干/分支/打包/临时项目）
✅ 人员管理：团队成员信息管理，支持SVN账号关联
✅ 智能合并：版本筛选、预览、执行一站式合并流程
✅ 冲突处理：AI辅助的智能冲突解决方案
✅ 配置管理：支持配置导入导出，便于团队同步
✅ 缓存优化：智能缓存机制，提升操作响应速度

📋 安装要求

在开始使用前，请确保您的环境满足以下要求：

VSCode: 1.74.0 或更高版本
SVN: 已安装SVN命令行工具（如TortoiseSVN）
系统: Windows/macOS/Linux

🚀 快速开始

第一步：安装插件

打开VSCode扩展市场（Ctrl+Shift+X）
搜索"SVN智能合并工具"
点击"安装"按钮
重启VSCode以激活插件

第二步：初始化配置

打开侧边栏：点击左侧活动栏中的SVN合并工具图标
添加项目：
- 点击"📁 项目管理" → "➕ 添加新项目"
- 填写项目名称、SVN地址、本地路径
- 选择项目类型（主干/分支/打包/临时）
- 添加项目描述（可选）
配置团队成员：
- 点击"👥 人员管理" → "➕ 添加新成员"
- 填写姓名、SVN账号、联系方式
- 关联相关项目
使用图形界面（推荐）：
- 点击"🖥️ 打开管理界面"进行可视化配置

第三步：开始合并

打开合并面板：点击"🔧 打开合并面板"
设置筛选条件：
- 选择目标项目
- 设置日期范围
- 选择提交者（可选）
- 输入关键词（可选）
选择版本：从筛选结果中选择要合并的版本
执行合并：
- 点击"预览"查看将要合并的内容
- 确认无误后点击"执行合并"
- 如遇冲突，使用AI助手进行智能解决

📖 详细使用指南

📁 项目管理功能

添加和管理项目

新增项目：侧边栏点击"➕ 添加新项目"或在管理界面批量添加
编辑项目：双击项目名称或点击编辑按钮修改项目信息
删除项目：右键菜单选择删除（会提示确认）

项目类型说明

🌿 主干项目：主要开发分支，通常是trunk或main分支
🌲 分支项目：功能开发分支或发布维护分支
📦 打包项目：专门用于打包和发布的项目
⏰ 临时项目：短期使用的临时项目或实验分支

便捷操作

快速跳转：点击项目名称直接在VSCode中打开项目目录
状态查看：实时显示项目本地状态和SVN连接状态
最近访问：自动记录最近使用的项目，便于快速切换

👥 人员管理功能

成员信息管理

添加成员：侧边栏点击"➕ 添加新成员"或批量导入
信息维护：管理成员的姓名、SVN账号、联系方式等
权限设置：为不同成员设置不同的项目访问权限

项目关联

多项目关联：一个成员可以关联多个项目
角色定义：为成员在不同项目中定义不同角色
快速筛选：合并时可按成员快速筛选相关版本

批量操作

CSV导入：支持从Excel等工具导出的CSV文件批量导入成员
数据导出：将成员信息导出为CSV或JSON格式，便于备份和分享
同步更新：支持团队配置文件的统一更新和分发

🖥️ 图形化管理界面

界面布局

顶部导航：项目管理、人员管理、设置配置三个主要标签页
工具栏：常用操作按钮，如新增、批量导入、导出等
搜索栏：支持实时搜索和高级筛选
状态栏：显示当前操作状态和统计信息

📋 项目管理标签页

列表视图：表格形式展示所有项目信息
卡片视图：以卡片形式展示项目，更直观
筛选功能：按项目类型、状态、最近访问时间筛选
搜索功能：支持项目名称、SVN地址、描述的模糊搜索
批量操作：支持多选项目进行批量编辑或删除
快捷操作：双击项目名称直接跳转到项目目录

👥 人员管理标签页

成员列表：显示所有团队成员的详细信息
关联视图：查看成员与项目的关联关系
角色管理：为成员分配不同项目的角色和权限
联系信息：管理成员的联系方式，便于沟通
活跃度统计：显示成员的提交活跃度和参与项目情况

🔄 智能合并功能

版本筛选

时间范围：选择特定日期范围内的版本
版本号：直接输入版本号或版本范围
提交者：按团队成员筛选版本
关键词：在提交信息中搜索关键词
文件类型：按修改的文件类型筛选

合并预览

变更列表：显示将要合并的所有文件变更
差异对比：查看每个文件的具体修改内容
冲突预警：提前识别可能的合并冲突
影响分析：分析合并对项目的潜在影响

AI冲突解决

自动分析：AI自动分析冲突的性质和严重程度
解决建议：提供多种冲突解决方案供选择
代码审查：AI辅助进行代码质量检查
学习优化：根据历史解决方案不断优化建议质量

💾 配置管理功能

导出功能

JSON格式：适合程序处理和版本控制
CSV格式：适合Excel编辑和数据分析
完整配置：导出所有项目和人员配置
增量配置：仅导出最近修改的配置

导入功能

配置迁移：从其他工具或系统导入现有配置
团队同步：导入团队统一的配置文件
批量更新：通过导入文件批量更新配置
冲突处理：智能处理导入时的配置冲突

❓ 常见问题解答

安装和配置问题

Q: 插件安装后在侧边栏找不到图标？ A: 请确保VSCode版本在1.74.0以上，重启VSCode后图标会出现在左侧活动栏中。

Q: 无法连接到SVN服务器？ A: 请检查：

SVN命令行工具是否正确安装
SVN服务器地址是否正确
网络连接是否正常
是否有访问权限

Q: 项目路径设置后无法访问？ A: 确保本地路径存在且有读写权限，建议使用绝对路径。

使用问题

Q: 版本筛选结果为空？ A: 请检查：

筛选条件是否过于严格
日期范围是否正确
提交者名称是否准确
SVN仓库是否有对应版本

Q: 合并时出现冲突怎么办？ A:

使用AI助手自动分析冲突
查看冲突详情和建议解决方案
手动解决复杂冲突
使用预览功能验证结果

Q: AI冲突解决不准确？ A: AI建议仅供参考，复杂冲突建议：

结合业务逻辑判断
咨询原代码作者
进行充分测试验证

性能问题

Q: 版本列表加载缓慢？ A:

启用智能缓存功能
缩小筛选范围
检查网络连接速度
定期清理缓存

Q: 界面响应慢？ A:

关闭不必要的VSCode扩展
检查系统资源使用情况
更新到最新版本
重启VSCode

⚙️ 高级设置

配置文件位置

插件配置文件存储在用户目录下：

Windows: %USERPROFILE%\.vscode\extensions\svn-merge-tool\config\
macOS: ~/.vscode/extensions/svn-merge-tool/config/
Linux: ~/.vscode/extensions/svn-merge-tool/config/

缓存管理

缓存位置: 与配置文件同目录的cache文件夹
自动清理: 系统会自动清理过期缓存
手动清理: 在设置中可以手动清理所有缓存
缓存大小: 默认限制100MB，可在设置中调整

性能优化设置

并发数量: 设置同时处理的SVN操作数量
超时时间: 设置SVN命令的超时时间
缓存策略: 选择积极缓存或保守缓存策略
日志级别: 设置日志详细程度，便于问题排查

🔒 安全说明

数据安全

所有配置数据存储在本地，不会上传到云端
SVN密码建议使用系统凭据管理器存储
敏感信息会进行加密处理

权限管理

插件仅访问必要的文件和目录
SVN操作遵循用户权限设置
不会修改系统配置或其他应用数据

📞 获取帮助

技术支持

如果您在使用过程中遇到问题，可以通过以下方式获取帮助：

查看文档: 仔细阅读本用户指南和常见问题解答
检查日志: 在VSCode输出面板查看插件日志信息
重启尝试: 重启VSCode或重新加载窗口
反馈问题: 通过以下渠道反馈问题

反馈渠道

功能建议: 在VSCode中通过命令面板打开反馈界面
Bug报告: 提供详细的错误信息和复现步骤
使用问题: 描述具体的使用场景和遇到的困难

版本更新

自动更新: VSCode会自动检测并提示插件更新
更新日志: 查看每个版本的新功能和修复内容
兼容性: 确保VSCode版本与插件版本兼容

🎉 结语

感谢选择SVN智能合并工具！

本工具致力于为开发团队提供高效、智能的SVN合并体验。我们会持续优化功能，提升用户体验。如果您觉得这个工具有帮助，欢迎推荐给团队成员使用！

祝您使用愉快，开发高效！ 🚀

SVN智能合并工具

doubleg-svn