🚀 VSCode SVN - 全平台AI智能版本控制神器

突破传统SVN工具的限制，为现代开发者打造的全平台智能版本控制解决方案

🌟 为什么选择VSCode SVN？

🌍 真正的全平台支持

• 💻 Windows | 🍎 macOS | 🐧 Linux 全平台无缝运行
• 🚀 纯命令行驱动：基于原生SVN命令行工具，无需TortoiseSVN等图形界面
• 🎯 轻量级设计：告别臃肿的第三方工具，VSCode原生集成体验
• ⚡ 性能优异：直接调用SVN命令，响应速度更快

🤖 AI智能加持，效率翻倍

• 🧠 智能提交日志生成：基于代码差异自动生成专业提交信息
• 📊 AI代码分析：深度解读代码变更，提供技术洞察
• 🔧 灵活配置：支持OpenAI、通义千问等多种AI模型，API密钥自主配置
• 💾 智能缓存：30天本地缓存，节省API调用成本

🔓 100%开源透明

• 🌐 完全开源：GitHub仓库 代码完全透明
• 🛠️ 社区驱动：欢迎提交Issue和PR，共同完善功能
• 🔒 数据安全：本地处理，API密钥加密存储，绝不上传敏感信息
• 📝 持续更新：活跃的开发维护，快速响应用户需求

---

🎯 核心功能特性

✅ 已实现功能

🔧 基础SVN操作

• ✅ 单文件/文件夹提交：右键即可快速上传
• ✅ 可视化差异对比：左右对比界面，变更一目了然
• ✅ 智能更新管理：文件、目录、工作区全覆盖
• ✅ 自定义工作副本路径：灵活配置SVN根目录
• ✅ 版本冲突智能处理：自动检测冲突，引导解决

🤖 AI智能功能

• ✅ AI提交日志生成：支持OpenAI、通义千问等主流模型
• ✅ 代码变更AI分析：专业技术解读，深度理解代码变化
• ✅ 智能缓存系统：30天本地缓存，优化API使用成本
• ✅ 多模型支持：灵活切换不同AI服务商

🎨 用户体验

• ✅ 右键菜单集成：无缝融入VSCode工作流
• ✅ 标签式文件筛选：直观的文件类型过滤界面
• ✅ 智能面板管理：多面板智能切换，避免混乱
• ✅ 本地版本显示：清晰标记未同步版本

🚀 快速开始

📦 一键安装

1. 安装SVN命令行工具（如果尚未安装）
   • Windows: 下载 SlikSVN 或 Apache Subversion
   • macOS: brew install subversion
   • Linux: sudo apt-get install subversion (Ubuntu/Debian) 或 sudo yum install subversion (CentOS/RHEL)
2. 验证安装：终端运行 svn --version 确认命令行工具可用
3. 安装插件：VSCode扩展市场搜索 "VSCode SVN" 并安装
4. 重启VSCode，享受智能SVN体验！

💡 重要提示：本插件基于原生SVN命令行工具开发，无需安装TortoiseSVN等图形界面工具！

⚡ 30秒上手

1. 右键任意文件 → 选择 "SVN: 提交文件(显示差异)"
2. 查看可视化差异对比，点击 "使用AI生成提交日志"
3. 一键提交，完成！

🔧 AI配置（可选）

• 命令面板 → "SVN: 配置AI服务"
• 支持OpenAI、通义千问等主流AI模型
• 配置一次，全局使用

---

📖 详细使用指南

文件上传

1. 在资源管理器中右键点击文件
2. 选择"SVN: 上传文件"
3. 输入提交信息
4. 文件将被添加到SVN（如果尚未添加）并提交

文件夹上传

1. 在资源管理器中右键点击文件夹
2. 选择"SVN: 上传文件夹"
3. 系统会显示文件夹提交面板，自动应用过滤规则排除不需要的文件
4. 面板顶部会显示过滤统计信息（如有文件被排除）
5. 文件类型筛选：使用复选框快速筛选不同状态的文件（已修改、新增、已删除等）
6. 文件后缀筛选：使用直观的标签界面筛选特定后缀的文件
   • 每个标签显示后缀名和对应的文件数量，如 .js (5) 表示有5个JavaScript文件
   • 点击标签可切换选择状态，选中的标签会高亮显示
   • 使用"全选"按钮选择所有后缀，"清空"按钮取消所有选择
   • 标签支持悬停效果，提供更好的交互体验
7. 选择要提交的文件
8. 输入提交信息
9. 文件夹中的更改将被提交到SVN

注意：

• 上传文件夹时会自动应用过滤规则，被排除的文件不会显示在文件列表中，也不会被提交到SVN
• 如果文件被直接删除（而非通过SVN删除），系统会自动检测到这些"丢失"状态的文件，并在提交前自动执行svn remove命令将它们标记为删除状态
• 对于丢失状态的文件，您可以点击"恢复"按钮来恢复意外删除的文件
• 智能面板管理：如果已经打开了一个文件夹提交面板，再右键另一个文件夹选择提交时：
  • 如果是相同文件夹，会直接显示现有面板
  • 如果是不同文件夹，会自动关闭旧面板并创建新面板，确保显示正确的文件夹内容

文件差异对比和提交

1. 在资源管理器中右键点击文件
2. 选择"SVN: 提交文件(显示差异)"
3. 如果文件未在SVN控制下，会询问是否添加到SVN
4. 系统会打开一个左右对比界面，左侧显示SVN版本，右侧显示工作副本
5. 在界面底部输入提交日志
6. 点击"提交"按钮完成提交（如果文件有差异，提交按钮才可点击）
7. 您也可以点击"使用AI生成提交日志"按钮，自动生成基于文件差异的提交日志

AI生成提交日志

1. 在提交界面中，点击"使用AI生成提交日志"按钮
2. 系统会分析文件差异，并使用AI生成一个专业的提交日志
3. 生成的提交日志会自动填充到提交日志文本框中
4. 您可以直接使用生成的日志，或根据需要进行修改后提交
5. 首次使用时，系统会提示您设置API密钥

提交前缀管理

1. 在提交界面中，您可以使用前缀功能为提交日志添加统一的前缀
2. 从下拉列表中选择之前使用过的前缀，或在输入框中输入新的前缀
3. 点击"应用前缀"按钮将前缀添加到提交日志的开头
4. 前缀历史记录以用户/本机为单位存储，所有项目都可以共享相同的前缀列表
5. 系统会自动保存最近使用的10个前缀，方便重复使用

文件和文件夹过滤

1. 自动过滤：插件会自动排除配置中指定的文件和文件夹，这些文件不会参与SVN操作
2. 配置管理：通过命令面板执行"SVN: 配置过滤规则"来管理过滤配置
3. 支持的过滤类型：
   • 文件模式：支持glob模式匹配（如 *.log, *.tmp, node_modules）
   • 文件夹：直接指定文件夹名称（如 dist, build, .git）
4. 默认排除项：
   • 文件：*.log, *.tmp, node_modules, .DS_Store, Thumbs.db
   • 文件夹：node_modules, .git, .vscode, dist, build, out, target
5. 配置选项：
   • 配置排除文件模式
   • 配置排除文件夹
   • 查看当前配置
   • 重置为默认配置
6. 查看过滤信息：通过命令面板执行"SVN: 显示过滤信息"查看当前的过滤配置

AI配置

插件支持接入任何兼容OpenAI格式的AI服务，包括但不限于：

• OpenAI GPT系列
• 通义千问
• 文心一言
• 智谱AI
• 本地部署的LLM服务等

配置方式

1. 首次使用自动引导：

   • 首次使用AI功能时，系统会自动弹出配置引导
   • 按照提示依次输入API地址、模型ID和API密钥即可

2. 手动配置：

   • 打开VSCode设置（文件 > 首选项 > 设置）
   • 搜索"vscode-svn.ai"查看所有AI相关配置
   • 配置以下三个必需项：
     • vscode-svn.aiApiUrl：AI服务的API访问地址
     • vscode-svn.aiModelId：AI模型ID或名称
     • vscode-svn.aiApiKey：AI服务的API密钥

配置示例

OpenAI GPT：

• API地址：https://api.openai.com/v1/chat/completions
• 模型ID：gpt-3.5-turbo 或 gpt-4
• API密钥：sk-...

通义千问：

• API地址：https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
• 模型ID：qwen-turbo 或 qwen-plus
• API密钥：sk-...

本地服务：

• API地址：http://localhost:8000/v1/chat/completions
• 模型ID：根据本地服务配置
• API密钥：根据本地服务要求

更新文件

1. 在资源管理器或编辑器中右键点击文件
2. 选择"SVN: 更新文件"
3. 如果文件有本地修改，系统会询问是否继续更新
4. 更新完成后，如果文件已在编辑器中打开，内容会自动刷新

更新目录

1. 在资源管理器中右键点击文件夹
2. 选择"SVN: 更新目录"
3. 系统会打开一个更新面板，显示更新进度和结果
4. 更新完成后，面板会显示所有更新的文件列表和状态
5. 您可以点击"重新更新"按钮再次更新，或点击"关闭"按钮关闭面板

更新工作区

1. 打开命令面板（按下F1或Ctrl+Shift+P）
2. 执行"SVN: 更新工作区"命令
3. 系统会更新整个工作区（当前打开的项目）
4. 更新面板会显示所有更新的文件列表和状态

设置SVN工作副本路径

如果您的文件不在标准的SVN工作副本结构中，或者需要将文件关联到特定的SVN仓库，可以手动设置SVN工作副本路径：

1. 在资源管理器中右键点击任意文件或文件夹
2. 选择 "SVN: 设置SVN工作副本路径"
3. 在弹出的对话框中选择包含.svn目录的SVN工作副本根目录
4. 设置成功后，插件将使用该路径作为SVN工作副本根目录

您也可以通过命令面板（按下F1或Ctrl+Shift+P）执行"SVN: 设置SVN工作副本路径"命令。

清除SVN工作副本路径设置

如果需要清除之前设置的自定义SVN工作副本路径：

1. 打开命令面板（按下F1或Ctrl+Shift+P）
2. 执行"SVN: 清除SVN工作副本路径"命令

智能版本冲突处理

插件内置了智能的版本冲突检测和处理机制，当提交时遇到版本冲突时会自动引导用户解决：

冲突检测

• 自动检测SVN "out of date"错误（E155011、E170004）
• 当其他人已经提交了对相同文件或文件夹的修改时触发
• 适用于单文件提交和批量文件提交

智能处理选项

当检测到版本冲突时，系统会弹出友好的提示对话框，提供三种处理方式：

1. 自动更新并重试提交（推荐）

   • 自动执行SVN更新操作，将工作副本更新到最新版本
   • 更新完成后询问是否继续提交
   • 如果选择继续，会自动重新执行提交操作
   • 整个过程无需手动干预

2. 仅更新不重试

   • 仅执行SVN更新操作
   • 更新完成后提示用户手动重新提交
   • 适合需要检查更新内容后再决定是否提交的场景

3. 取消操作

   • 不执行任何操作，保持当前状态
   • 用户可以手动处理冲突后再次尝试提交

详细提示信息

• 对话框会详细说明冲突产生的原因
• 提供操作建议和注意事项
• 显示友好的中文提示，便于理解

错误处理

• 如果更新过程中出现错误，会显示具体的错误信息
• 更新失败时不会影响原有的工作副本状态
• 提供完整的错误日志便于问题诊断

编码问题处理

本插件提供了全面的编码问题解决方案，确保在各种编码环境下都能正确显示中文内容：

自动编码检测

• 智能编码识别：自动检测文件的编码格式（UTF-8、GBK、GB2312、Big5等）
• BOM标识支持：正确处理带有字节顺序标记(BOM)的文件
• 编码转换：自动将检测到的编码转换为UTF-8以确保正确显示

编码配置选项

您可以通过VSCode设置来自定义编码处理行为：

1. 默认文件编码 (vscode-svn.defaultFileEncoding)

   • auto（默认）：自动检测文件编码
   • utf8：强制使用UTF-8编码
   • gbk：强制使用GBK编码
   • gb2312：强制使用GB2312编码
   • big5：强制使用Big5编码
   • latin1：强制使用Latin1编码

2. 强制UTF-8输出 (vscode-svn.forceUtf8Output)

   • 默认：true
   • 强制SVN命令输出使用UTF-8编码，建议保持开启

3. 启用编码检测 (vscode-svn.enableEncodingDetection)

   • 默认：true
   • 启用自动编码检测功能

4. 编码备用列表 (vscode-svn.encodingFallbacks)

   • 默认：["utf8", "gbk", "gb2312", "big5"]
   • 编码检测失败时尝试的备用编码列表

5. 显示编码信息 (vscode-svn.showEncodingInfo)

   • 默认：false
   • 在差异对比界面显示文件编码信息

使用建议

1. 对于大多数用户

   • 保持默认设置即可，插件会自动处理编码问题

2. 如果遇到中文乱码

   • 首先确保 vscode-svn.forceUtf8Output 设置为 true
   • 如果问题依然存在，尝试设置 vscode-svn.defaultFileEncoding 为您的文件实际编码

3. 对于特定编码环境

   • 如果您的项目使用特定编码（如GBK），可以设置为对应的编码格式
   • 调整 vscode-svn.encodingFallbacks 列表，将您常用的编码放在前面

技术实现

1. 环境变量优化

   • 设置了完整的UTF-8环境变量（LANG、LC_ALL等）
   • 针对不同操作系统进行了优化配置
   • Windows下设置代码页为UTF-8（65001）

2. SVN命令增强

   • 为diff命令添加了 --force 和 --internal-diff 参数
   • 增加了缓冲区大小以处理大文件
   • 实时编码转换处理

3. 差异显示优化

   • 支持多种差异行类型的高亮显示
   • 自动处理临时文件的编码转换
   • 提供备用显示方案

故障排除

如果您在使用过程中仍然遇到编码问题：

1. 检查SVN客户端配置

   svn info --show-item revision
   

2. 设置SVN配置文件 在SVN配置文件中添加：

   [miscellany]
   log-encoding = UTF-8
   

3. 检查文件属性 为特殊文件设置SVN属性：

   svn propset svn:mime-type "text/plain;charset=UTF-8" 文件名
   

4. 使用插件配置 打开VSCode设置，搜索"vscode-svn"调整编码相关配置

5. 查看调试信息 打开"输出"面板，选择"SVN"或"SVN差异"查看详细的编码处理日志

查看SVN日志

1. 在资源管理器中右键点击文件或文件夹
2. 选择"SVN: 查看日志记录"
3. 系统会打开一个日志查看面板，左侧显示日志列表，右侧显示详情
4. 面板顶部会显示当前文件或文件夹的本地修订版本号
5. 日志列表中会用橙色边框和"未更新"标记显示尚未更新到本地的版本
6. 点击左侧的日志条目可以查看该版本的详细信息，包括提交信息和变更文件列表
7. 点击变更文件列表中的文件可以查看该文件在该版本的具体变更内容
8. 可以点击"加载更多"按钮查看更多历史记录
9. 点击"刷新"按钮可以刷新日志列表和本地版本号信息

AI代码分析功能

• 智能分析：在右侧详情面板中，点击"🤖 AI分析代码差异"按钮
• 深度解读：AI会分析该修订版本中所有文件的代码变更，提供专业的技术分析
• 分析内容：包括修改目的、功能影响、代码质量评估等
• 便捷操作：分析结果会在新窗口中显示，支持一键复制分析内容
• 智能识别：自动识别新增、修改、删除的文件，并针对不同类型的变更提供相应的分析
• 智能缓存系统：
  • 基于修订版本、文件差异内容和AI模型生成唯一缓存ID
  • 相同的代码差异会自动使用缓存结果，避免重复的AI API调用
  • 缓存有效期为30天，最多保存1000条记录
  • 缓存结果界面会显示明显的"💾 缓存结果"标识和缓存时间
  • 实时分析结果显示"🔄 实时AI分析结果"标识
• 强制重新分析：
  • 对于缓存结果，可以点击"🔄 重新分析"按钮强制获取最新AI分析
  • 重新分析会跳过缓存，直接调用AI API获取最新结果
  • 新的分析结果会自动更新缓存
• 智能文件过滤：
  • 自动排除二进制文件（.exe, .dll, .jpg, .png, .xlsx, .pdf等）
  • 自动排除系统文件和构建产物（node_modules, .git, build/, dist/等）
  • 只分析当前界面显示的文件，提高分析效率和准确性
  • 分析结果中显示详细的过滤统计信息
• 缓存管理：提供缓存统计、清理过期缓存、清空所有缓存等管理功能

日志筛选功能

• 筛选条件：支持按修订版本、日期范围、作者、提交内容进行筛选
• 筛选数量提示：
  • 工具栏显示当前筛选结果数量，如"(筛选结果: 15 条)"
  • 日志列表顶部显示详细的筛选状态信息
  • 筛选状态包含具体的筛选条件，如"🔍 筛选条件: 作者: 张三, 日期: 2024-01-01 至 2024-01-31"
  • 非筛选状态显示为"📄 显示最新记录"或"📄 显示全部记录"
• 筛选模式：
  • 修订版本筛选：默认显示最近50条记录
  • 日期筛选：显示指定日期范围内的所有记录（无数量限制）
• 视觉提示：筛选状态下的数量信息会以橙色显示，便于区分

显示本地修订版本号

1. 在资源管理器中右键点击文件或文件夹
2. 选择"SVN: 显示本地修订版本号"
3. 系统会显示该文件或文件夹当前的本地SVN版本号

恢复文件或文件夹

恢复单个文件

1. 在资源管理器或编辑器中右键点击文件
2. 选择"SVN: 恢复文件"
3. 确认恢复操作（此操作不可撤销）
4. 文件将被恢复到SVN版本库状态，所有本地修改将丢失

恢复整个文件夹

1. 在资源管理器中右键点击文件夹
2. 选择"SVN: 恢复文件夹"
3. 系统会显示确认对话框，警告此操作将恢复文件夹及其所有子文件和子文件夹
4. 确认后，整个文件夹将被递归恢复到SVN版本库状态
5. 所有本地修改（包括新增、修改、删除的文件）都将丢失

注意：

• 恢复操作不可撤销，请谨慎使用
• 恢复文件夹会影响该文件夹下的所有文件和子文件夹
• 被过滤器排除的文件夹不会被恢复
• 如果文件夹不在SVN工作副本中，系统会提示设置SVN工作副本路径

注意事项

• 请确保系统已安装SVN命令行工具
• 文件必须位于SVN工作副本中，或者已通过"设置SVN工作副本路径"功能关联到SVN工作副本
• 请确保您有足够的权限执行SVN操作
• 对于包含特殊字符或二进制文件，差异比较可能无法正常显示，但仍可以提交
• 文件名中包含特殊字符（如@符号）的文件现在可以正常操作，插件会自动处理SVN命令中的特殊字符转义

开发里程碑

4.7.4

• 新增智能版本冲突处理功能：提交时自动检测SVN "out of date"错误并引导用户解决
• 支持自动检测E155011和E170004错误码，识别版本冲突情况
• 提供三种智能处理选项：自动更新并重试提交、仅更新不重试、取消操作
• 友好的中文提示对话框，详细说明冲突原因和解决建议
• 适用于单文件提交和批量文件提交场景
• 完善的错误处理机制，确保操作安全可靠

4.4.1

• 修复SVN特殊字符处理问题：解决了文件名中包含@符号导致SVN命令执行失败的问题
• 增强文件路径处理逻辑，自动处理特殊字符转义
• 提高了插件对特殊字符的兼容性

4.4.0

• 新增文件夹恢复功能：支持将整个文件夹及其所有子文件和子文件夹恢复到SVN版本库状态
• 在文件夹右键菜单中添加"SVN: 恢复文件夹"选项
• 使用svn revert -R命令进行递归恢复，确保所有修改都被撤销
• 添加安全确认对话框，防止意外操作导致数据丢失
• 支持自定义SVN根目录和过滤器规则
• 修复了单文件恢复功能中缺少revert命令的问题

4.3.3

• 修复missing文件提交错误：解决了提交missing文件时出现"ENOENT: no such file or directory"错误的问题
• 优化文件状态检查逻辑，对missing文件进行特殊处理，避免尝试访问已删除的文件
• 增强错误处理机制，确保missing文件能够正常提交

4.3.2

• 修复文件删除检测问题：解决了当文件被直接删除（而非通过SVN删除）时，文件夹提交无法检测到删除操作的问题
• 新增对"missing"状态文件的处理，自动将丢失的文件标记为删除状态
• 在提交前自动执行svn remove命令处理丢失的文件
• 为丢失状态的文件添加恢复按钮，允许用户恢复意外删除的文件
• 优化AI提交日志生成，正确处理删除和丢失状态的文件

4.3.1

• 完善文件夹上传的过滤功能：在文件夹提交面板中集成排除系统
• 文件夹上传时自动应用过滤规则，排除不需要的文件
• 在提交面板顶部显示过滤统计信息
• 被排除的文件不会显示在文件列表中，提升用户体验

4.3.0

• 新增本地修订版本号显示功能
• 在SVN日志面板中标记尚未更新到本地的版本
• 优化了日志界面布局，避免标记遮挡提交者名称
• 添加了SVN日志面板筛选功能的支持
• 增加了本地版本与服务器版本对比功能

4.2.6

• 新增文件和文件夹过滤功能：支持配置排除文件和文件夹，这些文件和文件夹将不参与SVN操作（提交、更新、添加等）
• 支持glob模式匹配文件名
• 提供配置界面管理过滤规则
• 默认排除常见的临时文件和构建目录

4.2.5

• 增加文件|文件夹目录获取 svn 记录界面
• 提交前缀存储优化：将SVN提交前缀的存储方式从项目级别改为用户/本机级别，现在所有项目都可以共享相同的前缀历史记录

4.2.4

• 目录提交界面 修复状态刷新问题

4.2.3

1. 对比按钮功能优化

   • 根据文件状态显示不同的按钮文本和行为
   • 修改状态(modified)的文件：显示"对比"按钮，点击后显示左右对比视图
   • 其他状态的文件：显示"打开"按钮，点击后直接在编辑器中打开文件

2. 恢复按钮功能添加

   • 为修改状态(modified)和删除状态(deleted)的文件添加"恢复"按钮
   • 点击恢复按钮会弹出确认对话框
   • 确认后执行 svn revert 操作
   • 操作成功后自动刷新文件状态列表

3. 界面布局优化

   • 调整了按钮的样式和布局，使用更紧凑的设计
   • 优化了文件状态显示的宽度和对齐方式
   • 添加了按钮的 tooltip 提示文本
   • 使用 grid 布局确保各列宽度合理分配

4. 文件状态显示优化

   • 根据不同的文件状态显示不同的颜色
   • 添加了状态图标的 tooltip 提示
   • 优化了状态文本的显示效果

4.1.2

• 完善单个文件上传流程
• 修改了提示词 加快了生成速度
• 增加了文件夹上传功能

---

🎉 加入我们的社区

🌟 为什么选择开源？

我们坚信开源的力量，透明的代码让每个人都能：

• 🔍 审查代码：确保安全性和质量
• 🛠️ 定制功能：根据团队需求进行个性化修改
• 🤝 贡献代码：与全球开发者共同完善产品

📞 联系我们

• 🐛 发现问题：提交Issue
• 💡 功能建议：GitHub Discussions
• 🔧 贡献代码：提交Pull Request
• ⭐ 支持项目：GitHub Star

🏆 成为贡献者

无论你是：

• 👨‍💻 开发者：提交代码、修复Bug
• 📝 文档专家：完善文档、翻译内容
• 🎨 设计师：优化界面、提升体验
• 🧪 测试人员：发现问题、验证功能

我们都欢迎你的参与！

---

💝 支持项目

如果这个项目对你有帮助，请考虑：

1. ⭐ 给项目点个Star - 这是对我们最大的鼓励
2. 🔄 分享给同事朋友 - 让更多人受益
3. 📝 提供反馈 - 帮助我们不断改进
4. 🤝 参与贡献 - 成为项目的一部分

---

1.0.0 - 正式版本

• [ ] 完整功能集
• [ ] 性能优化
• [ ] 用户体验改进

技术栈

• TypeScript
• VS Code Extension API
• SVN命令行工具集成
• OpenAI API（用于生成提交日志）

贡献指南

欢迎提交问题报告和功能请求。如果您想贡献代码，请先开issue讨论您想要更改的内容。

许可证

MIT