dsh-knj-version-control

在 DSH Web 里做 Git 往往要离开界面、依赖命令行或零散入口，本地改了什么、能不能安全提交推送、切分支会不会弄脏工作区，都不直观。dsh-knj-version-control 是 KNJ 家族插件：在右侧栏挂上「Version Control」工作台，把日常 Git 流程收进一块可读的界面，同时坚持「先预览、再确认」的写操作习惯，减少误点带来的风险。

核心能力围绕一条完整闭环：工具栏可看当前分支与领先/落后、刷新与 Update（fetch，快进则直接 ff-only pull，历史分叉则走需确认的 merge 式 pull）；默认「Changes」视图按修改/新增/删除/未跟踪/冲突分组展示本地变更，支持单文件、多选与整组暂存/取消暂存，点文件进入专用 diff 页；分支药丸可搜索并切换本地分支（远程分支在 v1 仅提示预留）；提交区写明作用范围（对勾选路径执行 git commit --only），支持 Commit 与「Commit and Push…」链式二次确认。失败时用可展开、可复制 Git 输出的详情对话框，而不是一闪而过的 toast。

集成方式上，插件只通过公共的 dsh-better-sidebar.registerTab() 注册标签页，不导入、不改动 Better Sidebar 的私有 UI、状态或 Git 实现；peer 依赖标为 optional，宿主缺 sidebar 或版本偏低时安装不阻断，运行期自检告警后优雅退出。所有 Git 调用走 execFile 固定参数，不提供任意命令输入；暂存只改索引、可逆，提交/推送/切分支与分叉更新依赖指纹绑定的预览令牌，仓库状态变化会使令牌失效且一次性消费。

适合已在 DSH Web 中打开工作区、主机 PATH 上有 git、且已自行配置提交身份与凭据的用户——插件不改 identity、remote 或凭证。需要右侧栏里完成「看变更、看 diff、暂存、提交、拉取、推送、换分支」的日常节奏、又希望写操作都有明确确认与失败诊断的人，会最顺手；非 Git 仓库仍可打开并看到非仓库状态，Log/Console 等视图在 v1 为占位，本版仅 Git。