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 / en

---

License

MIT