zeroa234/dsh-preset-minimal-windows
Minimal Windows agent preset + Git Bash tool for DeepSeek Harness: gitbash & pwsh & str_replace_editor, drop-in replacement for the official minimal preset on win32 / DeepSeek Harness 极简模式（Windows）Agent 预设 + Git Bash 工具：Git Bash + PowerShell + str_replace_editor 三工具，官方 minimal 预设的 win32 平替
安装Install
dsh plugin --profile web add github:zeroa234/dsh-preset-minimal-windows把 zeroa234/dsh-preset-minimal-windows 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-preset-minimal-windows
极简模式（Windows） — DeepSeek Harness 的 Windows 版极简 Agent 预设 + Git Bash 工具。 Minimal Windows agent preset + Git Bash tool for DeepSeek Harness.
官方 minimal 预设的 shell 是持久 bash PTY（dsh-terminal-bash 硬编码 /bin/bash），Windows 上不可用。
本仓库提供其 Windows 替代：Git Bash + PowerShell + str_replace_editor 三工具，无持久 shell，每次调用起新进程。
The official minimal preset ships a persistent bash PTY stack (dsh-terminal-bash hardcodes /bin/bash) that does not work on Windows.
This repo provides the Windows replacement: Git Bash + PowerShell + str_replace_editor — no persistent shell, a fresh process per call.
中文说明 · Chinese
特性 · Features
| 工具 Tool | 说明 Description |
|---|---|
gitbash |
通过 ctx.subprocess 直接拉起 Git for Windows 的 bash.exe -c，自动探测安装路径（%ProgramFiles%\Git\bin\bash.exe → usr\bin → x86 → PATH）；输出截断 + spill 落盘；超时终止（默认 120s / 上限 600s）；零外部依赖。Spawns Git for Windows' bash.exe -c via ctx.subprocess, auto-probing install paths; output truncation + spill files; timeout kill (default 120s / cap 600s); zero external dependencies. |
pwsh |
官方 @deepseek-ai/dsh-tool-pwsh，走宿主 ctx.shell（win32 下由 dsh-pwsh-sandbox 支撑），受文件沙箱约束。Official @deepseek-ai/dsh-tool-pwsh over the host ctx.shell (backed by dsh-pwsh-sandbox on win32), sandbox-constrained. |
str_replace_editor |
官方字符串替换文件编辑器（与 fs-local 共享隔离 realm）。Official string-replace file editor (shares the isolated fs realm with fs-local). |
- 固定 persona（
complete: true），不注入运行时上下文，无上下文压缩——与官方minimal相同的极简哲学。Fixed persona (complete: true), no runtime context, no compaction — the same minimal philosophy as the officialminimal. - 非 Windows 部署上自动跳过
pwsh行（disabled: process.platform !== 'win32'）。Thepwshrow is skipped automatically on non-Windows platforms.
安装 · Installation
方式一：复制预设目录（推荐，单步）· Method 1: copy the preset directory (recommended, one step)
把 preset/minimal-windows 整个目录复制到 $DSH_HOME/.agent-presets/ 下（$DSH_HOME 默认是 ~/.dsh，配置过则是 E:\agent\dsh）：
Copy the whole preset/minimal-windows directory into $DSH_HOME/.agent-presets/ ($DSH_HOME defaults to ~/.dsh):
# 把仓库里的 preset/minimal-windows 复制为：
# $DSH_HOME\.agent-presets\minimal-windows\
Copy-Item -Recurse preset\minimal-windows "$env:USERPROFILE\.dsh\.agent-presets\minimal-windows"
预设内的 tool-gitbash 行以相对路径引用 ./lib/gitbash.js，插件文件随目录一起走，无需任何 profile 安装。重启 harness（或新会话）后，在预设列表选择「极简模式（Windows）」。
The preset's tool-gitbash row references ./lib/gitbash.js by a relative path, so the plugin travels with the directory and no profile install is needed. Restart the harness (or start a new session) and pick 极简模式（Windows） in the preset list.
方式二：bundle 全局安装（可选）· Method 2: install the bundle host-wide (optional)
仓库根目录的 gitbash-tool/ 是标准 bundle 包（@dsh-external/dsh-tool-gitbash），想在所有预设的会话里都用上 gitbash 可以全局装：
gitbash-tool/ is a standard bundle package (@dsh-external/dsh-tool-gitbash); install it host-wide to get gitbash in every preset's sessions:
git clone https://github.com/zeroa234/dsh-preset-minimal-windows
cd dsh-preset-minimal-windows
dsh plugin --profile web add ./gitbash-tool
此时预设里的相对路径行与宿主 bundle 注册的 gitbash 工具同名共存（预设层遮蔽宿主层），行为一致，无需二选一。
The preset's relative-path row and the host bundle's gitbash coexist under the same name (the preset layer shadows the host layer); behavior is identical, no need to choose.
与官方 minimal 的差异 · Differences from the official minimal
官方 minimal |
本预设 This preset | |
|---|---|---|
| Shell | 持久 bash PTY（dsh-terminal + dsh-terminal-bash + dsh-tool-bash-persistent）Persistent bash PTY |
gitbash + pwsh，每次调用全新进程 Fresh process per call |
| 文件编辑 File editing | str_replace_editor |
不变 Same |
| 平台 Platform | Linux（/bin/bash 硬编码） |
Windows（win32） |
| Persona | "You are a helpful software engineer assistant." | 同上 + 提示使用 gitbash / pwsh Same + hints to use gitbash / pwsh |
配置 · Configuration
bashPath 可选：不想用自动探测时，在预设的 agent.cordis.yml 或 profile patch 里覆盖：
bashPath is optional — override it in the preset's agent.cordis.yml or a profile patch to skip auto-detection:
- id: tool-gitbash
name: ./lib/gitbash.js # 或 @dsh-external/dsh-tool-gitbash / or @dsh-external/dsh-tool-gitbash
config:
bashPath: 'C:\Program Files\Git\bin\bash.exe'
注意 · Notes
gitbash直接经ctx.subprocess执行，不经过文件沙箱（无 sandbox 集成），命令以 harness 进程权限运行；pwsh则受沙箱约束（读模式 ConstrainedLanguage、管道 EPERM 等）。gitbashruns directly throughctx.subprocesswithout the file sandbox (no sandbox integration), with harness-process privileges;pwshis sandbox-constrained (ConstrainedLanguage in read-only mode, pipe EPERM, etc.).- 两个 shell 均为无状态：
cd、环境变量等不跨调用保留。Both shells are stateless:cdand environment variables do not persist across calls.
仓库结构 · Repository layout
dsh-preset-minimal-windows/
├── preset/
│ └── minimal-windows/ # 预设目录：复制到 $DSH_HOME/.agent-presets/ 即用 · Copy into $DSH_HOME/.agent-presets/ to use
│ ├── agent.cordis.yml
│ ├── preset.yml
│ └── lib/gitbash.js # 自包含插件（仅依赖 node 内置模块）· Self-contained plugin (node builtins only)
├── gitbash-tool/ # 同一工具的 bundle 形态（宿主级安装用）· Bundle form for host-wide install
│ ├── package.json
│ ├── cordis.patch.yml
│ ├── lib/index.js
│ └── README.md
└── LICENSE
许可证 · License
MIT
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…