运行速度调节 yjc925925/dsh-run-speed

description: "DSH 的按会话运行速度选择器，在不改变所选模型或推理强度的前提下，加入并行执行指引。"
kind: "package-bundle"

dsh-run-speed

这个可选 DSH 包给输入框加上 Run speed 菜单，并配套一条 /run-speed 命令。你可以按会话选择智能体向外派发并行后台子代理的激进程度，而所选服务商、模型、推理强度保持原样不变。

| 模式 | 追加的提示词文本 | 并行子代理 | 中文 |
| Standard | 无 | 模型自身的常规策略 | 标准 |
| Fast | 一段动态提示词 | 最多 3 个，在同一条消息里一起启动 | 快速 |
| Turbo | 一段动态提示词 | 4 到 6 个 | 极速 |

插件绝不切换服务商、模型或推理强度，也绝不改动 Harness 核心包。通过 DSH 插件管理器安装或移除这个包；cordis.patch.yml 只贡献一条插件条目（id: run-speed）。

仓库：<https://github.com/yjc925925/dsh-run-speed>

用法

输入框控件和命令是同一状态的两个视图：按钮通过远程命令服务驱动 Host 命令，挂载时从它读回权威模式，切换成功后采用刚应用的模式。英文词和中文对应词都接受；裸 /run-speed 和 /run-speed status 报告当前模式。

/run-speed # -> "Run speed: standard."
/run-speed fast # -> "Run speed set to fast. Model and reasoning effort remain unchanged."
/run-speed 极速 # same as /run-speed turbo

输入框控件位于 conversation.input.right 槽位（顺序 30），会话运行中或已移除时禁用，切换进行中时也禁用。

模型体验

选定的运行速度策略

模型看到什么

Fast 和 Turbo 贡献一段动态系统提示词（user:run-speed，顺序 425）。文本告诉父代理和每个子代理：保持当前服务商、模型和推理强度；把相互独立且可安全并行的工具调用批量发出；依赖性的工作保持串行，不要委派出去；划分文件归属，避免两个智能体写同一个文件。Standard 贡献空段落——段落本身始终注册，但文本是空字符串，因此不消耗 token。

token 影响

Fast 和 Turbo 追加一段简短的固定提示词，并且因为并行运行子代理，整体可能消耗明显更多 token。Standard 不增加模型 token。

KV Cache 影响

切换模式会在下一次模型请求时替换生效的系统提示词，并可能开启新的可复用请求前缀。因此来回切换模式会让下一次请求付出缓存无法复用的代价。

目录结构

| 路径 | 内容 |
| src/index.ts | Host 侧：RUN_SPEED_GUIDANCE、parseRunSpeedMode(input)、user:run-speed 提示词片段，以及 /run-speed 命令 |
| src/types.ts | RunSpeedMode 联合类型（'standard' \| 'fast' \| 'turbo'），两侧共用 |
| src/client/index.ts | 浏览器侧：注册字典，并向 conversation.input.right 插槽贡献内容 |
| src/client/RunSpeedControl.tsx | 输入框菜单组件 |
| src/client/locales.ts | 简体中文（键名来源）与英文字典 |
| src/client/RunSpeedControl.module.css | 控件的样式表 |
| tests/run-speed.client.spec.ts | Vitest 测试套件，覆盖解析、引导文案、按会话隔离 |
| lib/index.js | 预构建的 Host ESM 入口 |
| lib/client.js + lib/client.js.map | 预构建的浏览器 bundle 及其 source map |
| lib/types/*/.d.ts + .d.ts.map | tsc 生成的声明文件及其声明映射 |
| locale/{en,zh}.json | 插件管理器卡片的文案 |

仓库随源码一起提供预构建的 lib/ 产物，因此无需构建步骤即可安装并运行 bundle。源码与产物一同发布，便于审查和后续维护。

开发

本包在 deepseek-harness monorepo 中开发，位于 packages/client/ui-run-speed/。这里提交的是源码、Vitest 测试套件和构建配置，因为 npm tarball 的 files 白名单把它们全部排除了。

独立构建尚未接通。 构建与类型检查配置依赖 monorepo 的脚手架，而本仓库并不包含这些内容：tsdown.config.ts 导入了 ../tsdown.client.ts；tsconfig.host.json 继承 ../../../tsconfig.base.json，并引用五个项目；tsconfig.client.json 继承 ../../../tsconfig.base.client.json，并引用九个。

声明的依赖不是问题。npm install 几秒内就能从公共 registry 解析出所有 @deepseek-ai/dsh- 的固定版本——这些发布带的是 next dist-tag 而不是 latest，所以 npm view <pkg> version 会让人以为它们不存在。真正缺的是构建工具本身：test 脚本需要 vitest，bundle 脚本需要 tsdown，而这两个都没有在 package.json 里声明——它们继承自 monorepo 根目录。因此在裸克隆里，npm test 失败在工具上，而不是源码上。

目前受支持的重建方式仍然是从 deepseek-harness 检出目录操作：

from a deepseek-harness checkout
pnpm --filter dsh-run-speed bundle
pnpm --filter dsh-run-speed test

让本仓库自包含——声明 vitest 和 tsdown，并用仓库内的等价配置替换两个继承的 tsconfig 基础配置——是顺理成章的下一步，但这里还没有做。提交的 lib/ 产物是 0.2.0-rc.2 的构建输出；与原始 npm tarball 相比有意做了些差异——不含构建机路径、附带一份重写后的 client.js.map，以及修正后的 test 脚本——都记录在 CHANGELOG.md 里。

已知限制与延后处理的工作

- 选择只存在于进程本地 —— Host 把选择保存在 WeakMap<Session, RunSpeedMode> 里，DSH 一重启就回到 Standard。控件每次挂载时都会向 Host 查询权威模式，切换成功后就采用刚应用的模式；之后不再轮询 Host，之所以还能保持一致，是因为两边共用同一条命令。
- 这是策略，不是吞吐量保证 —— 插件请求并行工作，但服务商容量、速率限制、任务依赖关系，以及模型自己的拆分决策，仍然决定实际耗时。
- 状态文本是一份通信契约 —— 浏览器端会解析 Host 的 Run speed: <mode>. 回复来获知当前模式，所以这段措辞属于 Host 与浏览器之间的接口，改动时必须两边同时改。

英文摘要

dsh-run-speed 给 DeepSeek Harness 加上按会话生效的 Run speed 选择器。它决定智能体可以把工作铺开给并行后台子代理的激进程度——Standard（不追加提示词文本）、Fast（最多 3 个）、Turbo（4–6 个）——同时明确保留选定的服务商、模型和推理强度。这个选择可以从输入框工具栏和 /run-speed 命令进入，按会话保存在 Host 内存中，DSH 重启后回到 Standard。

许可证

MIT。署名信息见 LICENSE 和 NOTICE。