dsh-minimal

by wc772

1 开发与运行时github未核验到 manifest收录于 08-16

DSH最小化版本可用

安装

dsh plugin --profile web add github:wc772/dsh-minimal

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

README

目录

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)、推理全部置于 <think> 内不外泄。

不需要 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。

原始 README: https://github.com/wc772/dsh-minimal/blob/main/README.zh-CN.md ↗