前言¶
跑智能体编码会话时有个常见的两难:每一步都跑在最强的模型上,效果好但成本高、速度慢;全程用便宜模型,遇到规划、架构设计这类硬活又顶不住。手动在会话间切换模型同样麻烦,打断思路。
oh-my-dsh 解决的就是这个问题:它在单个 DeepSeek Harness(DSH)会话内部做模型分层,规划用强模型、日常执行用便宜模型,图片理解和图像生成也各走各的通道,全程不需要手动切换会话,也不需要编辑 YAML。下面介绍它的功能、安装方式和典型用法。
这是什么¶
oh-my-dsh 是 llmpolska 维护的 DSH 插件,MIT 许可,当前版本 0.1.0。一句话定位:DeepSeek Harness 的分层模型路由插件——将每个会话分为 think/build 两档模型,自动委托视觉模型在后台描述图片,并用普通聊天模型生成图像,全部通过设置页配置。
插件适用于所有 DSH 表面:DSH Desktop、独立 web profile(dsh web)和终端(dsh --profile tui)。
核心功能¶
Think/Build 分层¶
auto 模式下,plan 模式运行强模型(think 档),日常执行运行便宜模型(build 档)。可以用 /omd strong|cheap 按会话覆盖,think/build 作为别名也可用。
视觉委托¶
贴一张图片(比如网站截图)说 “build this frontend”,流程是这样的:
- 消息立即出现在聊天里,图片原样保留;
- 视觉模型在后台描述这张图片,描述按图片的 sha256 缓存,同一张图不会重复调用;
- 当前轮次仍由工作档(think/build)执行:它的第一次请求等待描述完成,然后根据描述作答——视觉模型从不执行轮次,会话模型从不切换;
- 后续轮次中,历史里的图片部分会被替换为描述,纯文本模型不会因为不支持图片内容而报错。
图像生成¶
提供 omd_image 工具和 /omd image <prompt> 命令,用配置的聊天模型生成图像,保存到 ./oh-my-dsh-images/。图像生成的 provider 取自已注册的 providers,插件会推导 base URL 并复用该 provider 的 API key。
高危操作防护与失败自动升级¶
build 档执行期间,插件会拒绝 rm -rf、sudo、强制推送以及凭据/密钥文件编辑,直到会话升级到 think 档。另外,重复出现的模型步骤错误会触发临时升级到 think 档。
Advisor、Reviewer 与子代理分层¶
omd_advisor 和 omd_review 用于按需咨询 think 档,适合在风险决策和高风险合并之前问一次;omd_worker 把有界任务包分派到指定档位的子代理。
系统提示段与设置页¶
每个会话会注入一段系统提示,描述分层结构、/omd 命令映射与路由规则。配置入口在 DSH Desktop 设置的 “oh my dsh” 标签页,可以配置 providers、模型、推理力度、guard 与升级参数,包括路由模式、think/build/vision 三档的模型、图像生成的 provider/model/尺寸/输出目录等。
安装与启用¶
要求:DeepSeek Harness Desktop 或 dsh CLI,外加网络连接。dsh plugin 命令自行管理 pnpm,不需要额外安装别的东西。
安装到你使用的每个表面(每个 profile 相互独立):
# DSH Desktop 桌面应用(设置页就在这个 profile 里)
dsh plugin --profile desktop add github:llmpolska/oh-my-dsh#v0.1.0
# 独立 web 应用(dsh web)
dsh plugin --profile web add github:llmpolska/oh-my-dsh#v0.1.0
# 终端(TUI)
dsh plugin --profile tui add github:llmpolska/oh-my-dsh#v0.1.0
#v0.1.0 后缀固定了 release 标签。这个包没有构建步骤(无 prepare 脚本),pnpm 直接安装,不需要 allowBuilds 配置;安装命令也会自动把插件激活为 profile 层。
安装完成后需要完全重启:DSH Desktop 用 Cmd+Q 退出后重新启动,或者重启 dsh 进程。只刷新窗口是不够的,插件的宿主部分在 profile 启动时加载。
还有一个容易踩的点:只有新会话才会获得插件预设,现有会话保留原来的预设。所以要新建会话才能使用 /omd 命令和 omd_* 工具。
离线或本地开发安装¶
先做打包,再做安装:
cd oh-my-dsh
pnpm pack # 生成 oh-my-dsh-0.1.0.tgz
dsh plugin --profile <profile> add ./oh-my-dsh-0.1.0.tgz
本地路径安装会以链接方式挂载仓库,改完 lib/ 后重启应用即可生效,适合开发调试。
典型用法¶
常用斜杠命令如下:
/omd status
/omd strong | cheap | auto | off # 按会话档位(think/build 别名也可用)
/omd plan # auto + plan 模式 + think 头
/omd models # 列出已注册的 providers 和模型
/omd set <think|build|vision> <provider> <model> [off|high|max]
/omd subagent <inherit|cheap|strong>
/omd advisor <question> # 一次 think 档咨询
/omd review <focus> # think 档评审
/omd image <prompt> # 生成图像(保存到 ./oh-my-dsh-images)
暴露给智能体的工具共七个:omd_status、omd_route、omd_configure、omd_advisor、omd_review、omd_worker、omd_image。
一个可复现的例子:粘贴一张网站截图,说 “build this frontend”。视觉模型在后台生成描述,工作档根据描述作答,会话模型本身不会切换。
各表面的支持情况¶
| 表面 | 设置页 | /omd 与 omd_* 工具 | 视觉描述 | 图像生成 |
|---|---|---|---|---|
| DSH Desktop | 支持 | 支持 | 支持 | 支持 |
dsh web(web profile) |
支持 | 支持 | 支持 | 支持 |
| TUI / headless | 无设置 UI | 支持(agent 平面进程级激活) | 不支持(无图片提示) | 支持 |
插件是一套代码:设置页属于 web 平台的客户端部分,端点和视觉包装挂载在有 web server 的表面上,agent 平面(角色、工具、guard、历史清洗)在 web 表面通过预设激活,在 TUI 中则进程级激活。
适用场景与注意¶
适合的人群:想在 DSH 里让规划和执行跑不同档位模型的开发者;经常贴截图让智能体复刻前端的人;希望在编码会话中顺手生成图像的人。
使用前注意几点:
1、插件以当前 dsh 进程的权限运行,安装任何第三方插件前都建议先检查源码与许可证。本插件为 MIT 许可,源码在 GitHub 上可查。
2、安装后必须完全重启 DSH Desktop 或 dsh 进程,仅刷新窗口不够。
3、必须新建会话才能拿到 /omd 命令和 omd_* 工具,老会话不生效。
4、TUI 表面没有设置 UI,也没有视觉描述(不处理图片提示),但 /omd 命令和图像生成可用。
5、本文引用的插件目录页来自独立社区站点 skillhub.cn,与 DeepSeek / 幻方没有官方从属关系。
结尾¶
oh-my-dsh 把「什么时候用贵模型、什么时候用便宜模型」变成了一次配置:think 档管规划和硬调试,build 档管日常执行,视觉委托和图像生成各走各的通道,高危操作在 build 档被拦住。对于想把 DSH 会话成本压下来又不牺牲规划质量的用户,值得装上试一次。
- 目录页:https://www.skillhub.cn/plugins/llmpolska/oh-my-dsh
- GitHub:https://github.com/llmpolska/oh-my-dsh