跳到主内容

dsh-git-graph 使用指南

为 DSH Web 对话框提供 git 分支选择器和 Git 提交图谱面板,host 进程真实执行 git switch/create。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

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

快速上手

dsh-ui-web

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @captain1275/dsh-client-ui-git-graph

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

— 源: plugins.install

关键要点

  • 毛玻璃输入框:高斯模糊(backdrop-filter 30px)+ 半透明玻璃底 + 细边框 + 内高光
  • 自定义背景:URL / 本地图片 / 动图(GIF/WebP)/ 视频(mp4/webm) / 透明度 / 模糊调节,
  • 仿Claude Code推理等级滑块:点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、
  • 用户消息气泡毛玻璃:与输入框统一的玻璃质感
  • 图片资源(社区同人资源,codex-pet-DeepSeek-girl)

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件做什么?

在 DSH Web 对话框上方加一个 git 分支选择胶囊与可搜索分支列表,并提供 Git 提交图谱面板,让用户在不离开 DSH 的情况下切换/创建分支并查看历史。

它会在模型上下文里出现 git 操作记录吗?

不会。git switch/create 由 host 进程直接对磁盘工作树执行,不写入会话日志,也不作为工具调用喂给模型(见 src/index.ts:7-9 注释)。

切换分支会影响哪些会话?

影响整个工作区:插件在仓库根目录执行 git switch --no-guess <branch>,该工作区所有会话共用同一棵工作树;不会给既有会话单独换 cwd(见 src/host/git-service.ts:152-159)。

在非 git 目录里会出现分支胶囊吗?

不会。插件在工作区不是 git 仓库时隐藏分支胶囊;切换到 git 目录后下次刷新会出现(见 src/client/chips/BranchChip.tsx:85)。

切换被阻止时常见原因有哪些?

仓库里有未解决的合并冲突、有进行中的 git 操作(merge/rebase/cherry-pick 等)、目标分支被其他 worktree 检出,或本地修改会被目标分支覆盖,插件会以人类可读错误提示(见 src/client/chips/error-copy.ts)。

怎么卸载?

在 web profile 中移除插件包即可:dsh plugin --profile web remove @captain1275/dsh-client-ui-git-graph(见 README.md:65-66)。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: ^22.19.0 || >=24.0.0
  • Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源:通用规则