wc772/dsh-minimal

dsh-minimal-v3（极简模式V3）

DeepSeek Harness 自定义 agent preset：Standard 全部能力 + Minimal 锚定首轮，
首轮工具为官方平台 shell（无第三方依赖）。

社区项目，非 DeepSeek 官方出品。

做什么

两阶段设计（与极简模式V2 相同，仅首轮 shell 不同）：

1. 阶段 1（仅第一个请求）：模型可见工具目录收窄为恰好两个——官方平台
shell（win32 为 pwsh，其他平台为 bash）+ read；同时剥离自动注入的
工作区指令（AGENTS.md）与技能目录，让首轮锚定 Minimal 推理轨迹。
2. 阶段 2（晋升后）：出现首个持久信号（promoteOn: either——一次工具调用
或第一条助手消息，先到者为准）即恢复完整 standard 25 项工具目录。
晋升阶段由持久会话事件推导，resume/reload 不丢；压缩后回到受控阶段
（bootstrap 对 + compactionTools 核心工作集），直到跨边界出现新信号
（epoch-aware）。

系统提示词为 complete 形态，携带 Minimal 对齐的推理风格：每一步以
"we need to / I'll / I can / I need" 开头、穿插情态动词、避免 "let me"、
任务先分类（build/fix/weak）、推理全部置于  内不外泄。

不需要 dsh-tool-gitbash 第三方 bundle（V3 相对 V2 的改动：win32 首轮
使用官方 pwsh 工具）。

为什么

DeepSeek V4 Pro 的行为策略被首轮 API 可见工具目录强条件化。Project2 V4.1b
评测：standard 91 分，minimal 99/96，两阶段锚定 98/99。V2/V3 沿用同一锚定，
并加入 V2 推理风格提示词、promoteOn: either（无首轮无工具调用卡死陷阱）、
压缩后 epoch 感知受控阶段。

方法与证据见 xiaobright/modeltest
与 xiaobright/dsh-anchored-standard。

安装

一键安装（从 GitHub 下载最新版）：

irm https://raw.githubusercontent.com/wc772/dsh-minimal/main/install.ps1 | iex

Linux/macOS：

curl -fsSL https://raw.githubusercontent.com/wc772/dsh-minimal/main/install.sh | bash

安装脚本在已有 minimal-v3 预设时会提示（加 -Force / --force 自动备份
后替换），完成后校验四个预设文件并做插件语法检查。

手动安装（克隆本仓库，将 preset 目录复制到用户预设根目录，id 为
minimal-v3）：

$target = Join-Path $env:USERPROFILE '.dsh\.agent-presets\minimal-v3'
if (Test-Path -LiteralPath $target) { throw "Preset already exists: $target" }
New-Item -ItemType Directory -Force -Path (Split-Path -Parent $target) | Out-Null
Copy-Item -Recurse -LiteralPath '.\preset' -Destination $target

Linux/macOS：

dsh_home="${DSH_HOME:-$HOME/.dsh}"
mkdir -p "$dsh_home/.agent-presets"
test ! -e "$dsh_home/.agent-presets/minimal-v3"
cp -R preset "$dsh_home/.agent-presets/minimal-v3"

重启 DeepSeek Harness，新建空白会话，选择极简模式V3。不要切换已有会话。

验证

导出会话 JSONL，检查 request/header 事件：

- 第一个 header 只含 pwsh/read（win32）或 bash/read；
- 首次工具调用或首条助手消息后，下一份变更 header 含完整 standard 目录；
- 后续请求保持完整目录。

兼容性

- DeepSeek Harness 0.1.0-rc.6（Windows + Linux 开发与测试）
- Node.js 24
- win32 首轮使用官方 dsh-tool-pwsh，无 gitbash 依赖
- bootstrap 工具缺失时降级为完整目录并输出一次性警告，不会卡死会话

DSH 为开发者预览版，允许破坏性变更；本预设是 standard 组装的完整快照，
升级前请自查上游变更。

行为说明

- 首轮即使无工具调用，也会在首条助手消息时晋升（promoteOn: either），
目录必然在请求 1 与请求 2 之间变化一次；
- 目录只变化一次，请求前缀缓存连续性也只在首↔次请求之间变化一次；
- 压缩后回到受控阶段：bootstrap 对 + compactionTools
（read/write/edit/glob/grep/todo_write/ask_user_question），直到跨压缩
边界出现新信号；
- 预设信任级别与 shell 访问同级，安装前请审阅文件；
- 插件无网络请求、无遥测。

License

MIT。preset/agent.cordis.yml 派生自 DeepSeek Harness Standard 预设；
preset/tool-bootstrap.mjs 派生自 xiaobright/dsh-anchored-standard。
原始版权与 MIT 声明见 NOTICE。