可视化 Git 图谱 yaanlaan/dsh-gitui

dsh-gitui 🌿

DeepSeek Harness（桌面端与 Web 端）的可视化 Git 图谱与仓库控制插件。
直接嵌入 DeepSeek Harness 右侧边栏，提供 VSCode Git Graph 风格的平滑连续贝塞尔地铁图、交互式分支操作、提交查看、文件 diff 查看器与暂存控制。

📸 预览

1. DAG 拓扑节点图（2D 自由缩放/平移拓扑关系图）

DAG Topology View

2. 地铁折线图（VSCode Git Graph 风格平滑贝塞尔曲线）

Subway Git Graph

3. 分支网络概览（分支派生状态与一键管理）

Branch Network View

✨ 功能

- 三重视图可视化切换（3 Visual View Modes）：
- 🚇 列表图谱（Subway Table Graph）：类似 VSCode Git Graph 的全局平滑三次贝塞尔曲线连续轨道、分支分流与合流，高对比度剔除外描边与详细提交表格。
- 🕸️ DAG 拓扑节点图（DAG Topology Graph）：自由 2D 画布，将 Git 提交以真实有向无环图节点呈现，支持：
- 自由平移与缩放：支持鼠标滚轮缩放、拖拽平移、一键适应视口与 1:1 重置；
- 纵向/横向排版流向切换：支持时间由上至下流动（纵向）与由左至右流动（横向）；
- 拓扑箭头指示：演进流向（父→子）与溯源流向（子→父）自由切换；
- 血缘链路悬停高亮：鼠标悬停任意提交节点时自动高亮其父节点与子节点全路径；
- 节点卡片与抽屉详情：点击节点卡片直接展开文件变更统计与语法高亮 Diff 抽屉。
- 🌿 分支拓扑网络（Branch Network）：分支聚合视图，直观查看所有本地/远程分支最新提交、检出、合并到当前、跳转对应图谱与删除。
- 无缝集成 DeepSeek Harness 右侧边栏：
- 注册为 DeepSeek Harness 原生侧边栏 Tab（dsh-gitui）与引导卡片；
- 自动绑定当前活跃会话的工作区（cwd），支持工作区快速切换；
- 支持右侧边栏折叠、全屏放大与多标签分栏。
- 全功能交互式 Git 仓储操作：
- 右键上下文菜单：检出、基于提交建分支、创建标签、Cherry-pick、Revert、Reset、复制 SHA 等；
- 快速工具栏：分支过滤、一键刷新、新建分支、Stash 暂存与弹出、Fetch、Pull、Push；
- 快捷键盘支持：新建分支/标签/Stash 对话框支持按 Enter 快速提交。
- 工作区变更与快速暂存/提交：
- 实时检测未暂存与已暂存文件改动；
- 一键暂存全部（Stage All）、取消暂存全部；
- 侧边栏内直接输入 Commit Message 进行一键提交。
- 高性能 & 安全沙箱隔离：
- 安全子进程调用与临时文件重定向管道，彻底避免沙箱环境下的 EPERM 错误。

🚀 安装

1. 将 dsh-gitui 克隆或链接到 DeepSeek Harness 配置档目录（例如 ~/.dsh/profiles/desktop）：

cd ~/.dsh/profiles/desktop/node_modules
On Windows PowerShell:
New-Item -ItemType Junction -Target "C:\Users\<user>\Documents\deepseek\extension\dsh-gitui" -Path "dsh-gitui"

2. 将 dsh-gitui 添加到 ~/.dsh/profiles/desktop/package.json：

{
"dependencies": {
"dsh-gitui": "link:../../../../Documents/deepseek/extension/dsh-gitui"
},
"dsh": {
"bundles": [
"dsh-gitui"
]
}
}

3. 构建客户端 bundle（如果你从源码开发）：

pnpm run build
or node build.mjs

4. 启动或重新加载 DeepSeek Harness。在任意会话中，点击右侧边栏的 dsh-gitui，或从「开始」（Guide）标签页进入，开始可视化探索你的 Git 历史！

🛠️ 开发

- build.mjs：将客户端 React 组件编译为标准 DSH Cordis 客户端 bundle（lib/client.js）。
- src/git-graph-view.js：前端 UI、分支布局求解器与贝塞尔拓扑生成器。
- src/styles.js：匹配 DSH 暗色主题 token 的作用域样式。
- lib/git-service.js：宿主侧 Git 操作与解析服务。
- lib/index.js：宿主插件入口，暴露 /api/git-graph/* 端点。

📄 许可证

MIT © yaanlaan