前言¶
DeepSeek Harness (DSH) 的插件生态旨在通过标准化的 Agent 工具和侧边栏扩展提升开发效率。对于使用 Subversion 的团队，直接在 Agent 中调用 svn 命令或查看复杂的版本差异往往需要额外的脚本或外部工具。dsh-svn-tools 插件旨在解决这一问题，它为 Agent 提供了一整套 svn_* 工具，并为用户提供了可视化的 SVN 面板。
插件简介¶
dsh-svn-tools 是一个为 DeepSeek Harness 设计的 Subversion 工具集。它包含 33 个 svn_* Agent 工具，支持 UTF-8 中文提交日志；同时提供一个 SVN 面板，可在 DSH 自带右侧栏或 dsh-better-sidebar 中渲染。该插件由 zengweicheng666 维护，遵循 MIT 协议。
核心功能¶
Agent 工具 (33 个)¶
插件提供完整的 svn_* 工具集，覆盖以下分类：
* 状态 / 信息：svn_status、svn_info
* 差异 / 历史：svn_diff、svn_log、svn_blame
* 仓库浏览：svn_list、svn_cat
* 变更操作：svn_add、svn_delete、svn_mkdir、svn_copy、svn_move、svn_revert
* 提交：svn_commit（支持 UTF-8 日志）
* 更新 / 检出：svn_update、svn_checkout、svn_switch
* 冲突 / 清理：svn_resolve、svn_cleanup
* 属性：svn_propget、svn_propset、svn_proplist
* 分支 / 合并：svn_merge、svn_mergeinfo
* 锁定：svn_lock、svn_unlock
* 分组：svn_changelist
* 其他：svn_import、svn_export、svn_patch
侧边栏面板¶
- 双载体支持：面板可渲染在 DSH 自带右侧栏（
kind: svn分页）或 dsh-better-sidebar 中。载体类型在设置中配置，支持auto（默认）、native、better-sidebar或off（不注册面板）。 - 可视化对比：提供左右版本对比视图，支持差异块导航及直接修改工作副本的操作（采用左侧/右侧/都保留）。
- 主要分页：
- 变更：查看文件状态、批量操作。
- 提交：勾选文件、填写日志（支持 AI 生成日志）、提交前自动整理。
- 历史：查看版本列表、回退/还原操作、只读对比。
模式与兼容性¶
- 离线/只读模式：服务不可达时，历史记录可从本地日志缓存或工作副本元数据读取，且支持只读操作。
- 提交前自动整理：未版本化文件自动
add，缺失文件自动delete，结果如实回报。 - DSH 兼容：兼容 DSH 0.1.0-rc.6 及以上版本（0.2.x 适配配置表单，0.1.x 适配卡片）。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add github:zengweicheng666/dsh-svn-tools
安装后必须重启 dsh 以完成设置注册和面板挂载。
前置条件：
1. 系统中需安装 svn 命令行客户端（Windows 为 svn.exe）。
2. 若需使用侧边栏面板，DSH 版本需 >= 0.1.0-rc.6（自带右侧栏），或安装 dsh-better-sidebar。
典型用法¶
- 查看改动：重启 dsh 后，打开右侧栏的 SVN 分页，查看当前工作目录的改动。
- Agent 操作：在对话中让 Agent 使用工具，例如
svn_status查看改动，随后svn_commit提交。 - 差异操作：在变更页悬停差异块，可选择「采用左侧」或「采用右侧」直接修改工作副本文件。
注意事项¶
- 无前置依赖：面板载体可独立配置，也可完全不注册（仅使用 Agent 工具）。
- 环境要求：中文 Windows 控制台输出优先 UTF-8，失败时回退 GBK。
- 面板载体：面板需要一个载体（DSH 0.1.0-rc.6+ 自带右侧栏或 dsh-better-sidebar）。若两者均不可用，面板不注册，但 Agent 工具不受影响。
总结¶
dsh-svn-tools 通过统一的 Agent 工具和可视化的侧边栏面板，填补了 DeepSeek Harness 在 Subversion 版本控制集成上的空白。它不仅让 Agent 能够执行完整的 SVN 操作，也为人提供了一个直观的版本管理界面。
