<p align="center"><strong>dsh-flash-presets</strong></p> <p align="center"><strong>中文</strong> | <a href="#english-summary">English</a></p>

dsh-flash-presets

面向 DeepSeek V4.1 Flash 这一档路由的 DSH agent 预设，以 DSH 组合包（dsh.bundle）形式交付。安装后向 profile 的插件列表插入若干行 @deepseek-ai/dsh-agent-preset，不改宿主代码，也不动共享工具注册表。

预设影响三件事：预算与轮数（按轮计，不按步计）、工具输出的折叠与裁剪、判定任务完成的标准。它不提升模型能力，只决定一次会话花多少轮、在哪一步停下、用什么标准收尾。

[!IMPORTANT] 当前版本：v0.2.5（分支 main，未发布；npm 上最新为 0.2.4，随 plan mode 一同发布），v3（内部代号 lean-v3）是主版本，对齐 DSH 0.2.1-rc.2 和 v41flash 1017快照。 已验证：三平台安装器回归；模拟安装（临时 DSH_HOME 安装后用 dsh 0.2.1 --dump-config 合成出三个预设，重复安装幂等，卸载后依赖 / bundle 选择 / patch 层无残留）；组合包合成一致性。 未验证：macOS 真机；native 模式的同规模对照。 数字与失效场景见 实测证据 及下文「已知限制」。

预设

预设	id	order	规则条数	压缩	用途
v1	flash-lean-ptc-v1	21	14	0.3 / 50k	上下文余量优先，任务偏长
v2	flash-lean-ptc-v2	22	12	0.25 / 20k	与 v1 同代，更省，保守选择
v3	flash-lean-ptc-v3	27	13	0.25 / 20k	默认

三者可同时安装，在预设列表里逐项选择，但考虑到模型和框架更新，一般使用最新版本（v3）即可，具体适配情况可见release说明。

v3 相对 v2 的改动集中在验证阶段：验收门通过即交付，不再追加随机测试与压测轮。改动针对的实测现象是失败模式从「答案错误」迁移到「超时」与「单个任务耗时过长」。

安装、更新、卸载

npm（推荐）

npm install -g dsh-flash-presets          # 全局装一份，供任意 profile 引用
dsh plugin --profile web add dsh-flash-presets

包地址：https://www.npmjs.com/package/dsh-flash-presets。dsh plugin add 会自动把本包写入该 profile 的依赖并加载 cordis.patch.yml，无需先手动 npm install；上面前一行只在你需要离线副本或想让多个 profile 共用时才有必要。

在 GUI 的「插件 → 添加插件」里填 dsh-flash-presets，效果相同。

版本策略：不带版本号时管理器写入的是 caret 范围（如 ^0.2.2），后续任何 pnpm 操作都可能把它带到 0.2.x 最新版。预设直接决定 agent 行为，要可复现就写死版本：

dsh plugin --profile web add [email protected]   # 锁死到已发布版本

GitHub 直装

dsh plugin --profile web add github:LarryE135/dsh-flash-presets

适合跟未发布的分支或本地改动。同样写在 GUI 的「插件 → 添加插件」里也能装。

--profile 取 web、desktop、headless、acp 之一。管理器把本包写入该 profile 的 dsh.profile.bundles，并把 cordis.patch.yml 里的三个 insert 条目（v1、v2、v3）叠加到该 profile。web 为 live reload，刷新界面即可见；其他 profile 需重启。

更新时重复执行同一条 add，或先 remove 再 add。卸载时把本包从 dsh.profile.bundles 与依赖中移除后重装依赖；由脚本写入的托管块用 scripts/install.sh --uninstall 清除。

脚本

git clone https://github.com/LarryE135/dsh-flash-presets.git
cd dsh-flash-presets

Linux / macOS / WSL / Git Bash：

bash scripts/install.sh                         # DSH 0.1.7+ 写 profile 补丁；更旧版本回退到目录式
bash scripts/install.sh --profile desktop       # 默认 web
bash scripts/install.sh --uninstall
DSH_HOME=/path/to/.dsh bash scripts/install.sh

Windows（PowerShell 5.1+ 或 7）：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install.ps1
.\scripts\install.ps1 -Profile desktop
.\scripts\install.ps1 -Uninstall
.\scripts\install.ps1 -DshHome D:\tmp\.dsh

两个安装器共用 scripts/merge-presets.mjs：先备份 cordis.patch.yml.bak-<时间戳>，再整块替换托管块，可重复执行。

校验

node scripts/verify-presets.mjs                  # 结构与取值断言，可用 DSH_HOME / DSH_PROFILE 指向模拟安装
node scripts/verify-yaml.mjs                     # YAML 与跨平台标签检查
node scripts/compose-bundle-patch.mjs --check    # 断言 cordis.patch.yml 与 presets/* 一致
dsh --profile web --dump-config | grep -A3 'id: preset-flash-lean-ptc-v3'

配置

…