DSH SMOOTH · DSH 顺滑包
一站式解决 DSH「跑任务就卡、切会话弹重新连接、启动慢」。
纯配置 bundle + 排障 skill：不改核心、不改插件源码、可一键回滚。
它解决什么 / What it fixes
| 现象 Symptom | 处理 Fix |
|---|
| 跑任务整体卡顿、切工作区无响应 | UI 渲染 compact、字号 16、jobs 轮询 200ms |
| 上下文越跑越长、首字越来越慢 | 压缩阈值：必须改 preset 里那份，见 optional/compaction-preset.md |
| 每步都要付工具 schema 的 token | 可选关闭 5 组用不到的工具，见 optional/tool-slimming.yml |
| 账号区反复显示「重新连接」 | 可选层禁用 Agents-Anywhere 桥接并清理设备绑定（optional/reconnect.yml） |
| 启动慢、内存高 | 可选移除加载即报不兼容的 codex / claude-code 子代理（省约 595 MB SDK） |
实测数据 / Measured
| 指标 Metric | 之前 Before | 之后 After |
|---|
| 冷启动 starting→ready | 3.69 s（均值） | 2.61 s（近 8 次均值，-29%） |
| 启动 ValidationError | 2 条/次 | 0 |
| 渲染进程错误（slot crash / feed） | 244 条累计 | 0 |
| 5 次独立命令 vs 1 次批量 | 191 ms | 41 ms（-79%） |
| bundle 数 | 23 | 21（移除不兼容子代理后） |
⚠️ v1.2.0 重要修正（2026-11-04 实测）
v1.1.0 及更早版本里"压缩阈值 0.25→0.35"这一条在 desktop profile 上是无效配置。原因：
@deepseek-ai/dsh-web-app 会把顶层 compaction-basic、command-compact、tool-result-pruner 置为 disabled: true；- 真正运行的是 agent preset（
standard / ptc / cordis）内部的另一份 compaction-basic 实例，且不带 config → 走默认 0.8；
- 因此改顶层那条 config 不会影响任何正在跑的会话。
本版本的处理：
| 项 | 做法 |
|---|
| 核心层第 5 项 | 保留但不再声称有效，注释写明原因 |
| 真正生效的做法 | 覆盖 preset-<id> 声明，见 optional/compaction-preset.md（含验证与回滚） |
| 验证手段 | 复制 profile 后 dsh --profile <副本> --dump-config，看 thresholdRatio 是否出现在 preset-* 之后 |
另一个坑写进了 optional/compaction-preset.md：覆盖 preset 时 persona 不得含 {{cwd}}，
否则 unknown prompt variable "{{cwd}}" 会让整轮对话在提示词组装阶段直接失败。
安装 / Install
// %USERPROFILE%\.dsh\profiles\desktop\package.json
"dependencies": {
"dsh-smooth": "link:E:/path/to/dsh-smooth"
},
"dsh": { "profile": { "bundles": [ ... , "dsh-smooth" ] } }
或 npm：
dsh plugin --profile desktop add dsh-smooth
也可直接从 GitHub tag 安装：
git clone --branch v1.2.0 https://github.com/ayuanxx-max/dsh-smooth.git E:\dsh-smooth
# 然后在 profile 的 package.json 里加 "dsh-smooth": "link:E:/dsh-smooth"，并加入 bundles
完全退出 DSH 再启动才生效。
可选层 / Optional
| 文件 | 作用 |
|---|
optional/compaction-preset.md | 压缩阈值真正生效的做法 + 验证 + 两个必踩的坑 |
optional/tool-slimming.yml | 关闭 5 组用不到的工具，缩短工具表 |
optional/reconnect.yml | 禁用 Agents-Anywhere 桥接，消除「重新连接」按钮 |
optional/legacy-subagents.md | 移除不兼容的 codex / claude-code 子代理 |
回滚 / Rollback
- 从
bundles 移除 dsh-smooth → 全部恢复；
- 单项回滚：在自己的
cordis.patch.yml 里覆盖同一个 id（用户层优先级更高）。
兼容性 / Compatibility
- 只用基础 bundle 的稳定 id：
ui-chat、ui-settings-account、ui-theme、jobs、compaction-basic；
- 只用合法枚举（
compact / standard / detailed）与已验证的键名（pumpPollMs），避免 ValidationError；
- Windows 11 实测；Linux/macOS 未验证，但配置层与平台无关。
License
MIT
