dsh-svn-plugin
SVN（Subversion）版本控制面板插件，面向 DeepSeek Harness Web GUI。以独立 tab 融入
dsh-better-sidebar 右侧边栏，覆盖 IDEA SVN 的基本功能（状态、提交、历史、对比、
搁置、冲突解决、分支/标签、仓库浏览、属性、分组、锁定、代码标注），并注入 svn_*
模型工具，让 Agent 也能直接操作 SVN。
适用场景：团队仍在使用 SVN 管理代码，同时用 DeepSeek Harness 的 Web GUI 编程。
该插件把 Git 面板同款的体验带到 SVN 工作副本上。
功能
| 面板 | 说明 |
|---|---|
| 本地修改 | svn status --xml 状态树，Git 面板风格：更改 / 未版本化 / 已忽略分组，字母徽章（M/A/D/?/!/C…）+ 图标操作；分组与目录均可折叠，条目按目录树组织 |
| .gitignore 忽略 | 自动读取工作副本（含父目录）的 .gitignore，按 gitignore 规则把匹配的未版本化文件归入「已忽略」分组并默认隐藏（与 Git 行为一致） |
| 提交 | 底部提交栏（Ctrl+Enter）+ 提交信息 + 选择文件，未版本化文件自动 svn add |
| 更新 / 还原 / 清理 | svn update、svn revert、svn cleanup |
| 代码对比 | 工作副本 vs BASE 或版本区间 diff，彩色 unified 渲染 |
| 历史记录 | svn log --xml -v，Git 风格历史行（r123 + 摘要 / 作者 · 时间 · 文件数）；选中提交的详情区悬浮固定在底部，列表独立滚动；点击变更文件即展开该文件的单文件 diff（A/M/D 均支持，红色删除 / 绿色新增高亮），再次点击收起 |
| 搁置（Shelve） | svn shelve / unshelve / shelve-delete / shelve --list（IDEA 同款暂存） |
| 冲突解决 | svn resolve --accept working / mine-full / theirs-full |
| 代码标注 | svn blame 逐行标注版本与作者 |
| 分支 / 标签 | svn copy 建分支、svn switch 切换、svn merge -r a:b URL 合并 |
| 仓库浏览 | svn list 浏览远程目录树，可检出 |
| 属性 / 分组 / 锁定 | svn:ignore 等属性、ChangeList 分组提交、lock/unlock |
| 检出 | 非工作副本目录内联检出 |
| Agent 工具 | svn_status / svn_log / svn_diff / svn_commit / svn_update / svn_revert / svn_add / svn_shelve / svn_unshelve / svn_shelve_list / svn_blame |
UI 风格：与 dsh-better-sidebar 的「源代码管理（Git）」面板共用同一套
DSW 设计 token（--dsw-alias-*颜色 /--dsw-font-*字号）与图标
（@deepseek-ai/dsh-client-ui-primitives），视觉上保持一致。
依赖条件
| 依赖 | 版本要求 | 说明 |
|---|---|---|
| DeepSeek Harness（DSH） | 0.1.0-rc.8+ |
宿主平台；dsh web 可正常运行 |
| dsh-better-sidebar | ≥ 0.14.0 |
必须安装：提供 ctx.betterSidebar 侧边栏宿主服务，插件以 tab 形式注入其中 |
| SVN 命令行客户端 | 任意（含 1.14.x） | 系统 svn 可执行文件；Windows 上 TortoiseSVN 自带 svn.exe，需加入 PATH |
| Node.js | 与 DSH 宿主一致 | 仅在开发/构建时需要（pnpm install / pnpm build） |
搁置（Shelve）可用性：插件启动时检测
svn help是否包含shelve子命令。
TortoiseSVN 自带的svn.exe（≤1.14.x）刻意不包含 shelve 命令，此时「搁置」
面板会显示提示并禁用相关按钮，其余功能不受影响；改用上游 Apache Subversion
官方二进制（含shelve）后自动恢复。
安装
从 GitHub 发布包 / npm 安装
# 确保已安装 dsh-better-sidebar（本插件的宿主插件）
dsh plugin --profile web add dsh-better-sidebar
# 安装本插件
dsh plugin --profile web add dsh-svn-plugin本地开发安装
dsh plugin --profile web add e:/dsh_project/dsh-svn-plugin装完重启 dsh web 宿主进程（宿主端路由与工具需重启加载），再硬刷新浏览器
（Ctrl+Shift+R）。侧边栏 + 菜单中应出现「SVN」tab。
开发
pnpm install
pnpm build # tsc 编译宿主端 → lib/，tsdown 打包 client → client/client.js宿主端：src/index.ts（/svn/api 路由 + svn_* 工具注册）。
客户端：src/client/index.tsx（ctx.betterSidebar.registerTab）。
架构
src/
├── index.ts # 宿主端：/svn/api/* JSON API + svn_* 工具（trust-fence）
├── svn.ts # svn 命令封装（spawn + --xml 解析）
├── gitignore.ts # .gitignore 解析 + 匹配（git check-ignore 语义子集）
├── wire.ts # HTTP 信封 / 错误码
├── trust-fence.ts # loopback / trustedHosts 信任围栏
└── client/
├── index.tsx # 注册 dsh-svn tab（better-sidebar 服务）
├── api.ts # /svn/api 类型化 fetch
├── SvnView.tsx # 主面板：Git 面板风格状态页 + 操作中心
├── HistoryView / DiffView / ShelveView / RepoBrowserView /
│ BranchView / PropsView / ChangeListView / BlameView / AgentToolsView
├── ui.tsx # DSW-token 原子组件（Btn/IconBtn/SectionHeader/…）
└── locales.ts # zh / enLicense
MIT