本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-git-graph

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:1841220388zzzcccxxx-star/dsh-git-graph

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 提交历史图：GitHub 风格提交列表，分支分组折叠、分支着色（本地与远程分支各有独立分组）
• 跟随当前对话：打开哪个对话就显示哪个对话工作区的 git 仓库，切换对话自动跟随；非 git 仓库的对话显示空态提示
• 📂 打开文件夹（v0.11）：不局限于当前对话工作区——点击顶栏「打开」或在空态中点「打开文件夹」，可浏览磁盘（驱动器 → 目录逐层进入，带 git 标记），选择任意文件夹（如另一个工作区的仓库 B）查看其版本管理；添加过的仓库持久保存，顶部下拉随时切换，刷新后仍可继续查看
• 分支过滤：勾选 = 显示该分支 · 不勾 = 完全隐藏（全部不勾选则列表为空）
• 提交详情：提交信息、文件变更列表、单文件 diff、两次提交对比（Ctrl+点击）、📜 文件历史（查看单个文件的所有历史提交）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后立即生效还是需要重启？

服务端代码改动需要重启 dsh web（index.js 注释 + README 都明确说明），web/index.html 内嵌页面刷新即生效；插件自更新完成后也会要求重启 dsh web。

必须事先在 cordis.patch.yml 写 config.repo 才能用吗？

不是必须的。cordis.patch.yml 中的 repo/repos 是可选白名单；不写也能用「打开文件夹」按钮浏览磁盘并添加任意 Git 仓库，添加过的会通过 localStorage 记忆并跨刷新保留（v0.11 起）。

系统没有装 git 可以用吗？

不可以。服务端 index.js:26 通过 execFile('git', ...) 直接调用 git CLI，必须在系统 PATH 中能找到 git。

顶栏的「打开文件夹」和当前会话工作区是什么关系？

没有关系。图谱默认跟随当前对话的 git 工作区，但顶栏「📂 打开」可独立浏览驱动器/目录，挑选任意其他位置的 Git 仓库（甚至不属于当前会话），顶部下拉切换即可。

上万提交的大仓库会卡吗？

不会卡。提交列表每页 200 条，配合「加载更多」按钮按需拉取，总数通过 rev-list --count 实时显示。

自更新失败会破坏当前安装吗？

不会。index.js:142-175 在替换前会先在同级目录创建 .bak- 备份，更新失败自动从备份回滚；成功后也只保留最新一份历史备份。

写操作（还原、推送、删分支）安全吗？

写操作通过 gitop op 走服务端，路径会校验必须在仓库内；但破坏性动作（如 discard、commit、push、delete-branch）由客户端在执行前弹确认框，避免误操作。

能在 PowerShell 5.1 环境用吗？

插件本身不依赖 PowerShell，但 web/index.html 中静态资源需 UTF-8 无 BOM 部署；服务端跨 Windows/macOS/Linux 运行，Windows 上 reveal 操作走 explorer。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.0.1
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则