Skip to content
Back to search

dsh-git-bash

DeepSeek Harness 插件:让DSH使用Git Bash,能够保持read-only, workspace-write, full-access权限控制依旧可用

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/inmny--dsh-git-bash/badge.svg)](/listings/inmny--dsh-git-bash)

HTML

<a href="/listings/inmny--dsh-git-bash"><img src="/api/listings/inmny--dsh-git-bash/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 111 lines
  1. # dsh-plugin-git-bash
  2. 让 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 在 Windows 上默认使用 Git for Windows Bash,并保留 DSH 的 `read-only`、`workspace-write` 和 `danger-full-access` 权限语义。
  3. ![Git Bash 在 DeepSeek Harness 中运行](assets/teaser.png)
  4. ## 使用方法
  5. 插件安装到 profile 后,`standard`、`code`、`cordis` 和 `minimal` preset 会使用 Git Bash 代替 PowerShell。前台命令、后台命令和 Web Agent preset 共用同一个 executor。
  6. 新建会话后可以运行以下命令确认 shell:
  7. ```sh
  8. printf 'shell=%s\nversion=%s\nmsystem=%s\n' "$BASH" "$BASH_VERSION" "$MSYSTEM"
  9. ```
  10. `MSYSTEM` 应为 `MINGW64` 或 `MINGW32`。
  11. Web 界面中的 Bash 工具行可以展开查看 command、cwd、stdout/stderr 和 exit status。`run_code` 内的 nested Bash 调用使用同一套 terminal 详情;过长的 command 会自动换行,output 则保留终端横向滚动,以维持日志和表格的列对齐。
  12. 插件只作为 bundle layer 安装到目标 profile,不修改 DSH 安装目录。
  13. ## 安装或更新
  14. 从 npm 安装固定版本到 Web profile:
  15. ```sh
  16. dsh plugin --profile web add dsh-plugin-git-bash@0.3.3
  17. ```
  18. 更新现有安装时使用同一条命令。安装完成后重启 `dsh web`,让 Host 和浏览器 client 同时加载新版本,然后新建会话。
  19. 安装最新版时可以省略版本号:
  20. ```sh
  21. dsh plugin --profile web add dsh-plugin-git-bash
  22. ```
  23. 开发本地版本时传入 checkout 路径:
  24. ```powershell
  25. dsh plugin --profile web add C:\path\to\dsh-git-bash
  26. ```
  27. ## 权限模式
  28. ### `read-only` 和 `workspace-write`
  29. 受限命令仍由 DSH Windows ACL sandbox 创建 `WRITE_RESTRICTED` token。插件在 sandbox 内先运行 native guard,再由 guard 启动 Git Bash:
  30. ```text
  31. DSH ACL runner -> msys-token-guard.exe -> bash.exe -> child processes
  32. ```
  33. - `read-only` 可以启动 Git Bash,但不能写 workspace。
  34. - `workspace-write` 只能写 DSH 授权的 workspace 和 private temp。
  35. ### `danger-full-access`
  36. 该模式不经过 native guard,直接运行 Git Bash,与插件 0.1.x 的执行方式一致。
  37. ## 配置 Git Bash 路径
  38. 插件会自动探测 Program Files、用户安装目录和 Scoop 中的 Git Bash。Web GUI 中打开 `设置 -> 插件 -> 插件配置`,展开 `Git Bash` 卡片后可以直接输入 `bash.exe` 路径,或通过 `选择 Git 安装目录` 调用系统路径选择窗口。保存后,后续 Bash 命令会立即使用新路径;恢复默认值会回到 profile 配置或自动探测结果。
  39. 无 GUI 场景可以在启动 DSH 前设置 `DSH_GIT_BASH_PATH`:
  40. ```powershell
  41. $env:DSH_GIT_BASH_PATH = 'D:\Apps\Git\bin\bash.exe'
  42. dsh web
  43. ```
  44. 也可以直接在 profile 的 `cordis.patch.yml` 中为 provider 配置 `executable`:
  45. ```yaml
  46. - id: git-bash-shell
  47. name: dsh-plugin-git-bash
  48. config:
  49. executable: D:\Apps\Git\bin\bash.exe
  50. ```
  51. ## 平台支持
  52. 运行时要求:
  53. - Windows x64
  54. - Node.js 24 或更高版本
  55. - DSH `0.1.2-rc.1`
  56. - Git for Windows x64
  57. npm 包包含预编译的 `msys-token-guard.exe` 和 `msys-token-guard-hook.dll`,普通安装不需要 Visual Studio 或 CMake。当前 native guard 仅支持 `win32-x64`;其他架构在受限模式下返回 `SANDBOX_UNAVAILABLE`,不会降级到未隔离执行。
  58. Microsoft Detours 4.0.1 源码按 MIT 许可存放在 `native/vendor/detours`,许可文本随 npm 包分发。Detours 的 DLL path 参数使用 Windows ANSI API,因此插件安装路径必须能由当前系统代码页无损表示,并且不能超过 `MAX_PATH`;不满足条件时 guard 会 fail closed。
  59. ## 开发
  60. 安装依赖并运行完整验证:
  61. ```sh
  62. pnpm install
  63. pnpm test
  64. pnpm run pack:check
  65. ```
  66. 在 Windows 上重建 native artifact 还需要 Visual Studio C++ Build Tools 和 CMake 3.25 或更高版本。`pnpm test` 会以 C++20、静态 MSVC runtime、CFG、CET、ASLR 和 NX 构建 native guard,然后运行 Windows ACL permission matrix、fail-closed、Web client 和 package metadata 测试。
  67. 非 Windows 主机不会交叉编译 native guard,只会检查预编译 artifact 是否存在。
  68. ## License
  69. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.