前言¶
在 DeepSeek Harness(DSH)里跑长任务时,停止按钮和会话时长、日志体积都是日常可见的硬事实。社区插件生态按「一切皆插件」拆分能力:有的插件改工作流,有的只动界面。dsh-brake-pedal 属于后者——它不评测产品、不替你做安全结论,只是在输入框旁加一颗「制动自检」入口,用虚构的六脚全力制动动画和一份官僚体《情况说明》做开发者自嘲式表演。下面介绍它是什么、怎么装、用起来要注意什么。
这是什么¶
- 名称:
dsh-brake-pedal(npm 包名与仓库同名) - 维护者:zhanshenovo
- 分类:客户端(
dsh.client,platform: "web") - 版本(资料中的当前发布):0.2.0
- 仓库:https://github.com/zhanshenovo/dsh-brake-pedal
- 目录页:https://www.skillhub.cn/plugins/zhanshenovo/dsh-brake-pedal
一句话:DeepSeek Harness 客户端插件,给长任务一场「6 脚全力制动测试」——支架随机断在第 2–6 脚(约 1/8 不裂)。纯表演,从不接管、不拦截、不延迟任何停止动作。
核心功能¶
界面与交互¶
输入框旁边多一颗「🛞 制动自检」胶囊。点开后浮层上演 6 脚全力制动测试:支架随机断在第 2–6 脚,偶尔(约 1/8)不断裂,随后弹出虚构的《情况说明》。面板会列出每一脚的「踏板力」、支架状态、与会话相关的辅助信息(如已运行时长、日志体积等);界面上标明踏板力为推导值,不是实测。
胶囊位置:默认贴在发送键正上方;按住可拖到任意位置,位置写入 localStorage 键 dsh-brake-pedal.pos。双击胶囊,或点面板里「复位位置」,回到发送键上方。找不到发送键时(例如空会话)落在视口右下角。
三条设计规矩(README 原文要点)¶
- 从不拦截真实停止。 不接管 Stop;「6 脚」只是浮层表演。真实停止仍由你按「停止」或
Esc Esc;面板里的「挂 P 挡(停止会话)」是在 DOM 里保守地查找文案为停止/Stop的可见、未禁用按钮并触发点击,找不到则提示「未找到制动踏板」,不会乱点其它按钮。 - 数字不编。 「踏板力」等由宿主提供的会话起始时间、已运行时长、日志体积等推导;取不到事实时整场标为「演示数据」。
- 失败静默。 注入失败、路由 404、渲染报错等只写一条 console,不破坏原界面。
随机规则¶
断裂概率数组(第 2–6 脚及「未复现」):
BREAK_ODDS = [0.12, 0.26, 0.24, 0.16, 0.10, 0.12]
种子 = 会话 id + 第几次自检,使用 mulberry32。同一会话第一次点开结果固定;换会话换结果;点「再来一次」才重掷。另有「未复现模式」等面板操作(见仓库 README 示例)。
宿主与客户端分工¶
| 半边 | 内容 |
|---|---|
| 宿主 | lib/index.js,路由 GET /dsh-brake-pedal/facts?session=<id> |
| 客户端 | client/client.js,注册进 shell.overlay(帧级浮层,与会话无关) |
facts 响应字段包括:source(host / partial / none / error)、sessionId、matched(exact / latest)、cwd、createdAt、elapsedMs、logBytes、logMtimeMs。宿主对会话日志只读、仅 GET,写方法返回 405。主题配色走宿主 --dsw-alias-* 令牌。
免责声明(使用与转载时建议保留)¶
这是开发者自嘲性质的虚构段子,不是安全评测或产品评价。弹窗《情况说明》为原创官僚体文本,不指向任何真实企业、品牌或事件;界面无厂商名。公开场合展示时请一并说明:这是个段子,别当数据看。
安装与启用¶
装完后必须重启 DeepSeek Harness(插件页「重启」,或关闭再打开),再刷新页面。
① 从 GitHub 安装(整仓,含视频工具链)
在 DSH「插件 → 添加插件」中输入:
github:zhanshenovo/dsh-brake-pedal
② 克隆后本地安装
git clone https://github.com/zhanshenovo/dsh-brake-pedal.git
cd dsh-brake-pedal
node tools/install.mjs # 装进 desktop profile
node tools/install.mjs --profile web
脚本会改 dependencies、dsh.profile.bundles 并建 node_modules junction;改 package.json 前会备份为 package.json.bak-brake-pedal。
③ 本地 tarball(GitHub 连不上时)
从 Releases 下载 dsh-brake-pedal-0.2.0.tgz,在「添加插件」里填绝对路径,例如:
D:\Downloads\dsh-brake-pedal-0.2.0.tgz
资料说明:插件市场镜像不代理 GitHub 仓库本身,大陆网络下 github: 可能不可用,切换 npmmirror 也解决不了该路径。
环境要求(来自 package.json):Node >=20,DSH >=0.1.2-rc.1;可选 peer @deepseek-ai/dsh-client-locale。
卸载:
node tools/uninstall.mjs
典型用法¶
- 安装并重启 DSH,刷新页面。
- 在有意进行长任务的会话中,找到发送键上方的「🛞 制动自检」胶囊(或拖到你习惯的位置)。
- 点开观看六脚动画;需要不同结局时点「再来一次(随机)」;演示固定断点可在同一会话内先点开一次确认结果(同会话首次结果由种子固定)。
- 若要结束真实会话,仍使用 Harness 自带的停止;或面板「挂 P 挡」在找到合法停止按钮时触发同一次停止。
开发自检(仓库内,非终端用户必需):
node test/smoke.mjs
录制演示(可选):DevTools 可设 localStorage.setItem('dsh-brake-pedal.lock', '3') 或 'none' 锁定断点;视频渲染见 README 中 node tools/video/render.mjs 等命令。
适用场景与注意¶
适合谁:已在用 DSH、想给长任务界面加一点无害彩蛋的开发者;需要向同事演示「停止与会话事实如何被 UI 引用」时,也可当作交互样例(仍须强调是段子)。
权限与安全:插件以当前 DSH 进程权限运行;安装前应阅读 源码与 LICENSE(MIT),自行判断是否纳入环境。不要把面板数字当作评测或运维依据。
生态说明:社区目录(如 skillhub.cn)为独立站点,与 DeepSeek / 幻方无官方从属关系;本文安装命令均来自仓库 README,未使用未在资料中出现的 CLI 拼接形式。
结尾¶
dsh-brake-pedal 把会话时长、日志体积等硬事实变成一场可重复的「制动自检」小剧场,并明确写死三条规矩:不挡真停止、不伪造推导以外的数据、出错不炸界面。若你要安装或围观实现细节,可从目录页进入说明,或直接打开 GitHub 仓库阅读 README 与 VIDEO.md。