Back to home

zhongjie10086

dsh-adaptive-native-standard

Windows-native Adaptive Standard preset for DeepSeek Harness

Stars
1
Language
JavaScript
Created
Aug 16, 2026
Updated
Aug 16, 2026

Introduction

Adaptive Native Standard

面向 Windows 原生 DeepSeek Harness(DSH)的社区 Agent Preset。它以官方 Standard 的完整能力为底座,首请求仅锚定 Minimal persona,之后启用任务自适应路由、按需工具发现和紧凑的 Git Bash 执行器。

当前版本:0.2.0

本项目不是 DeepSeek 官方项目,也不受 DeepSeek 官方背书。

适合谁

  • 在 Windows 10/11 上原生运行 DSH;
  • 希望日常文件操作优先使用 pwsh + read + write + edit + glob + grep
  • 需要 POSIX 命令时,希望模型可以自行发现并解锁 Git for Windows;
  • 希望保留 Standard 的 Web、subagent、workflow、goal、后台任务等能力,但不想把完整工具目录长期塞进每轮请求。

核心能力

  • Standard 能力底座:保留官方 Standard 的上下文、技能、subagent、workflow、goal 和 jobs 体系。
  • 首请求 persona 锚定:只替换首请求的 deployment persona,不复制 Minimal 的工具限制或删除 Standard 上下文。
  • Windows 原生常驻工具:首轮、晋升后和 compaction 恢复期均保留 pwsh/read/write/edit/glob/grep
  • 自适应路由:按任务选择 specreactweak,支持自动模式和手动锁定。
  • we-need 推理风格:作为可关闭的私有推理引导,不要求输出 <think> 标签,也不改变最终回复语言。
  • 按需能力解锁:通过 dev_tool_search 解锁 Git Bash、旧编辑器、Web、subagent、workflow、goal、jobs 等工具。
  • Direct Bash:自动探测 Git for Windows,处理 Windows/MSYS 路径、相对工作目录、超时、取消、进程树终止、长输出截断和完整输出 spill。
  • 清晰的命令结果:stdout/stderr 分开呈现,非零退出作为普通命令结果返回,并明确标记 [exit code: N]
  • 会话隔离:为 Bash 注入安全的 DSH_HOME / DSH_SHELL / DSH_SESSION_ID / DSH_WEB_URL 子集;默认不暴露 DSH_SESSION_JSONL

要求

  • Windows 10/11;
  • DeepSeek Harness 0.1.0-rc.5
  • Git for Windows;
  • DSH 已配置可用的模型 Provider。推荐在 DeepSeek V4 Pro 上使用高推理强度,但 Preset 本身不绑定 API 密钥或 Provider。

DSH 更新可能改变 Cordis composition、工具 schema 或服务边界。升级 DSH 后请先运行兼容检查,再覆盖现有安装。

安装(推荐:DSH bundle)

从 DeepSeek Harness 源码 checkout 运行时:

Set-Location C:\Dev\deepseek-harness
pnpm dsh plugin --profile web add github:zhongjie10086/dsh-adaptive-native-standard
pnpm dsh web

如果使用已经安装到 PATH 的 dsh CLI:

dsh plugin --profile web add github:zhongjie10086/dsh-adaptive-native-standard
dsh web

如果使用 DSH Desktop,请从托盘打开 Open DSH Terminal,安装到 Desktop 当前使用的 profile:

dsh plugin --profile desktop add github:zhongjie10086/dsh-adaptive-native-standard

bundle 首次随 profile 启动时,会把随包 Agent Preset 部署到:

%USERPROFILE%\.dsh\.agent-presets\adaptive-native-standard

已有手动安装与随包内容完全相同时,bundle 会安全接管并写入所有权标记;内容不同则保留原目录并给出警告,不会覆盖。bundle 管理的旧版本在更新前会移入 %USERPROFILE%\.dsh\.preset-backups\

重启后新建会话并选择 Adaptive Native Standard。不要在已有内容的会话中途切换 Preset。

移除 profile 中的 bundle:

Set-Location C:\Dev\deepseek-harness
pnpm dsh plugin --profile web remove dsh-adaptive-native-standard

DSH 当前没有 package-owned preset-root 的卸载钩子,因此移除 bundle 不会自动删除已经部署的 preset;如需同时移除,请继续使用本仓库的 scripts/uninstall.ps1,或在 Agent Presets 设置中删除对应目录。

手动安装(备用)

下载或克隆本仓库后,在 PowerShell 中运行:

Set-Location <仓库目录>
.\scripts\install.ps1

如果已经安装旧版本:

.\scripts\install.ps1 -Update

脚本会安装到:

%USERPROFILE%\.dsh\.agent-presets\adaptive-native-standard

更新时,旧目录会先移动到 %USERPROFILE%\.dsh\.preset-backups\,不会直接覆盖。安装完成后重启:

Set-Location C:\Dev\deepseek-harness
pnpm dsh web

新建会话并选择 Adaptive Native Standard。不要在已有内容的会话中途切换 Preset。

卸载采用可恢复移动:

.\scripts\uninstall.ps1

使用方式

普通 Windows 编码直接让模型工作即可。需要 POSIX shell 时,模型可以调用:

{"toolNames":["bash"]}

这是 dev_tool_search 的参数;解锁后的下一次请求会出现 bash。模型可以自主执行这个流程,不需要用户手工输入 JSON。

长驻开发服务器、watcher 和长测试应使用官方 pwshrun_in_background,再按需解锁 job_list / job_output / job_killsubagentsubagent_fork 使用 continuable 后台模式。Direct Bash 故意不提供后台参数,避免用裸 & 制造孤儿进程。

安全边界

Direct Bash 没有 Windows OS 沙箱,也没有逐命令审批。一旦模型解锁 bash,命令将以 DSH 服务进程当前的 Windows 用户权限运行。

  • 只在可信工作区使用;
  • 建议把会话权限明确设置为 danger-full-access,让界面显示与实际 Bash 权限一致;
  • 如果任务需要严格隔离或逐命令审批,请不要使用本 Preset;
  • 不要把 API 密钥写进仓库、Preset 配置或提示词。

配置

主要配置位于 preset/agent.cordis.yml

配置默认值作用
defaultModeautoauto / spec / react / weak
reasoningStylewe-need可改为 native 关闭风格引导
nearFieldGuidancetrue在后续真实用户消息附近补充短引导
maxFaults3路由层连续故障熔断阈值
managedSessionEnvtrue向 Direct Bash 注入安全 DSH 会话变量子集
includeSessionJsonlfalse是否额外暴露当前会话 JSONL 路径

一般不建议启用 includeSessionJsonl。它可能暴露本地对话工件位置,而且落盘内容可能滞后于当前轮次。

验证

npm run check
npm run verify:dsh -- C:\Dev\deepseek-harness

公开仓库包含功能单元测试和 composition 静态校验。开发阶段另有多轮行为评测,但为避免测试泄漏,benchmark 题目、隐藏断言、原始会话、费用/耗时记录和详细数据报告不随仓库发布。README 只提供设计级描述,不宣称通用能力分数。

设计来源与致谢

本项目组合并改编了以下 MIT 许可项目的思想或代码,并在 NOTICE 中保留详细归属:

开发时还阅读了 myDshPresetsv4-flash-godmode-opencode-go 作为社区设计参考;本仓库不复制它们的源码,也不对其未明确覆盖的内容作许可证推定。公开可读的 GitHub 仓库并不自动等于开源许可。

许可证

MIT。参见 LICENSENOTICE