OhMyDSH
一个 DSH 插件,装齐三样用顺手的东西:峰谷动态(按时段自动换模型路由)、提示词候选(回合结束后给几条下一步可点的建议)、输入历史(空草稿时按 ↑ 召回上一条发过的消息)。
三样原来各自是一个插件(dsh-peak-valley-model、dsh-prompt-candidates、dsh-prompt-history)。合并后仍然是一个包、一次挂载、三个设置页,每一项都能在设置里单独关掉。
| 功能 | 做什么 | 界面位置 | 开关 |
|---|---|---|---|
| 峰谷动态 | 在配置的时段里把会话的模型位换成时段路由,时段外用另一条 | 输入框右侧的开关;设置 → 峰谷动态 | 输入框开关(按会话)+ 设置页顶部的「功能开关」 |
| 提示词候选 | 回合结束后用当前模型生成几条候选,点一下填进输入框 | 输入框上方候选条;设置 → 提示词候选 | 设置页顶部的「功能开关」 |
| 输入历史 | 草稿为空时按 ↑ 逐条往回翻自己发过的消息,↓ 往前翻;Esc 收起,Enter 发送 | 无可见界面(纯键盘);设置 → 输入历史 | 设置页顶部的「功能开关」 |
安装
插件以 bundle 形式安装到当前 profile。在 DSH 会话里调用 plugin_manager:
{ "action": "install_bundle", "target": "/path/to/oh-my-dsh" }
target 换成本机 checkout 的绝对路径。仓库是纯 ESM,不需要构建。
或者直接从插件市场(如果这个仓库被收录)安装 oh-my-dsh。
新装的 bundle 需要重启 DSH 才会加载(运行中的应用不能热加载新的 bundle 行)。之后改配置、开关功能都不需要再重启。
配置
配置写在 profile 的 cordis.patch.yml 里,三段各管一个功能。设置页能改的字段都是 volatile,写完即时生效、不需要重启。
- id: oh-my-dsh
name: oh-my-dsh
config:
peakValley:
enabled: true
timeZone: Asia/Shanghai
peakWindows:
- { start: '09:00', end: '12:00', provider: deepseek-account, model: deepseek-flash }
- { start: '14:00', end: '18:00', provider: deepseek-account, model: deepseek-flash }
offPeakRoute: { provider: deepseek-account, model: deepseek-flash }
sessions:
<session-id>: true
lastToggle: { on: false, at: 0 }
candidates:
enabled: true
maxSuggestions: 2
historyMessages: 12
history:
enabled: true
limit: 100
peakValley
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
整个功能的总开关。关掉后既不对齐模型位,也不响应手动换模型。 |
timeZone |
Asia/Shanghai |
判断「现在是不是峰时」用的时区。静态字段,改完要重载插件。 |
peakWindows |
09:00–12:00、14:00–18:00 两段,路由同谷时 | 每段自带 provider / model。周末一律算谷时。默认两条路由相同,所以装好等于不切换,要到设置页把峰时那两段换成你的另一条路由。 |
offPeakRoute |
deepseek-account / deepseek-flash |
时段之外(含周末)使用的路由,{ provider, model }。 |
sessions |
{} |
按会话的开关状态。默认不开:新会话要自己打开。 |
lastToggle |
{ on: false, at: 0 } |
最近一次手动动作,用来决定新建会话继承「开」还是「关」。 |
官方 provider 有两个:llm-deepseek-account 注册 deepseek-account(桌面端账号登录),llm-deepseek-api-key 注册 deepseek-official(API Key 部署)。
candidates
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
关掉后不再请求候选。 |
maxSuggestions |
2 |
一次最多几条候选,1–5。模型可以给得更少。 |
historyMessages |
12 |
送给模型的最近消息条数,1–40;最近的用户消息一定会带上。 |
maxOutputTokens |
1600 |
候选请求的输出上限(推理模型的思考也算在内)。静态字段。 |
timeoutMs |
25000 |
一次候选请求的端到端时限。静态字段。 |
provider / model |
空 | 可选的路线覆盖;两者都填才生效,否则沿用会话当前模型。 |
debug |
false |
把原始输出打到 Host 终端。 |
history
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
关掉后 ↑/↓ 不再被插件接管,编辑器恢复原生行为。 |
limit |
100 |
一次最多往回翻多少条,1–200。 |
从三个旧插件迁移
字段是一一对应的,只是多套了一层段名:峰谷动态的 enabled/sessions/peakWindows/offPeakRoute/timeZone 前面加 peakValley:,提示词候选的字段前面加 candidates:,输入历史加 history:。
步骤:
- 把
cordis.patch.yml里peak-valley-model那一行替换成oh-my-dsh,把原来的config原样搬到peakValley:下面。旧的timeline字段(0.20 之前的遗留)不用搬,现在由peakWindows决定。 - 提示词候选的配置原来在它自己的 bundle 里,搬到
candidates:下面;输入历史搬到history:下面。 - 从
dsh.profile.bundles和 profile 的dependencies里删掉三个旧包,装上oh-my-dsh。 - 重启 DSH。
lastToggle 一定要一起搬:它记着「最近一次动作是开还是关」,决定新会话的默认状态。丢掉它,新会话会退回「关」。
行为细节
峰谷动态
- 开关是按会话的,没有全局默认开。
lastToggle只影响新建会话的那一次继承。设置页可以一键清空所有会话的覆盖。 - 路由靠改写会话的模型位(
sessionController.selectModel)实现,不拦请求、不改agent/request。改请求会被 Harness 判成proposed X after step preparation fixed Y并报错。 - 换路由时丢掉承自原模型的
reasoningEffort,避免把不支持的强度硬套到另一条路由。 - 用户手动换模型 → 这个会话自动关掉(只删这个会话的键,并记一次
lastToggle)。 - 对齐时机:插件启动、每 15 秒巡检、每轮结束、开关变更。轮次中途到点不切,等这一轮结束再切,避免同一轮前后换路由。
- 子代理会话不对齐。
提示词候选
- 只在会话停在已结束的回合时生成;同一会话按日志长度去重,不会重复请求。
- Tab 只在 composer 卡片内被消费,采纳走
inputActions.captureInsertion()+insertText()。会话日志零写入。 - 用的是会话当前模型(或用
provider/model覆盖),一次请求maxOutputTokens上限,超时按timeoutMs放弃。
输入历史
- 只在「草稿为空」且光标在首行/末行时接管 ↑/↓;多行草稿里把方向键留给光标移动。
- 读的是会话里发出去的消息文本(wire text)。带文件引用的消息召回后是
@[标签](dsh-file:…)这种原文,不会还原成 chip;图片和附件不参与召回。 - 历史按会话隔离,只读,不写会话日志。
已知边界
- 输入历史召回的是线上文本,不是原始编辑态:
@引用的 chip、粘贴的图片都找不回来。 - 提示词候选和输入历史都是只读的旁观者;它们不会改会话内容,也不会替你发消息。
- 峰谷动态依赖「模型位」这条路:如果某个 provider 的模型不在
modelCatalog里,设置页会保留配置值但无法选中它。 - 三个功能都只在 DSH Desktop / Web 的客户端槽位里工作,TUI 下没有这些界面。
开发
npm install # 需要 react / react-dom / jsdom / zod / @deepseek-ai/schemastery
npm test # node --test test/*.test.mjs
| 文件 | 作用 |
|---|---|
index.js |
Host 入口:inject、Config(三段合并)、apply |
lib/peak-valley/index.js |
峰谷动态的宿主半边:配置摊平、路由对齐、手动改动记账 |
lib/peak-valley/period.js |
时段解析与「现在在哪一档」 |
lib/peak-valley/state.js |
routeAt(cfg, now):唯一的时段决策点 |
lib/candidates/index.js |
提示词候选的宿主半边:生成、去重、缓存 |
lib/candidates/candidates.js |
纯函数:重建请求消息、解析输出 |
lib/history/index.js |
输入历史的宿主半边:读会话文本 |
lib/remote.js / lib/typert.js |
Typert Remote 的 spec 与 manifest |
lib/service.js |
服务 ohMyDsh 的两个方法 |
client.js |
浏览器半边:三个功能的槽位与三个设置页 |
cordis.patch.yml |
bundle 的安装行 |
测试分三档:period/state/history 是纯函数,peak-valley-host 用替身跑宿主逻辑,peak-valley-client/peak-valley-interaction/merge 用 jsdom + React 18 真的渲染和点击。
许可
MIT。
No comments yet. Be the first to write one.