前言¶
在 DeepSeek Harness(DSH)里使用 DS Bot 时,界面以 DS Bot 为主表面;若要回到 Harness 原生的经典 Agent 界面,通常要走设置或侧边栏入口,步骤略分散。若每个小按钮都单独做一个插件,安装和维护成本也会上去。下面介绍维护者 keliwang 发布的客户端插件 dsh-dsbot-tweaks:把若干 DS Bot 侧 UI 微调收进一个包,当前已实现「一键切到原生 DSH 界面」,且不改动 DS Bot 本体代码,升级 DS Bot 时不易被覆盖。
这是什么¶
dsh-dsbot-tweaks 是面向 DSH 的客户端插件(dsh.client.platform: web,immediately: true),包版本 0.1.0,许可证 MIT。Host 侧 index.js 为空,实际逻辑打在构建产物 client.js 里。设计上「一个 bundle 容纳多个 tweak」,每个 tweak 是小的前端 DOM 注入;DS Bot 官方包不被修改。
社区目录页:https://www.skillhub.cn/plugins/keliwang/dsh-dsbot-tweaks
源码与说明:https://github.com/keliwang/dsh-dsbot-tweaks
Skillhub 等目录站点独立于 DeepSeek / 幻方,并非官方应用商店;插件以当前 DSH 进程权限在浏览器端运行,安装前建议自行阅读源码与许可证。
核心功能¶
资料中已列出的 tweak 如下。
| Tweak | 位置 | 作用 |
|---|---|---|
| Native interface switch | DS Bot 左下角设置齿轮旁 | 单击切换到原生 DSH 界面(classic agent mode) |
切换按钮为圆形,文案为 ⇄,悬停有提示;仅在 DS Bot 表面出现。实现上优先调用 DS Bot 内部的 actions.setSurface('agent')(与设置里同类操作一致),在内存中切换、无需整页重载;若因 DS Bot / React 变更无法从齿轮按钮的 fiber 借到该 action,则回退为写入 localStorage['ds-bot:surface'] 后刷新页面,效果相同但会慢几秒。插件自述无网络请求、无磁盘写入(除回退路径的 localStorage)、不涉及凭据。
Tweak 依赖 DS Bot 渲染的 DOM(例如 .bt-leftcol-foot、button.bt-account、span.bt-you);DS Bot 页脚结构变化时,选择器可能需要随源码更新。
安装与启用¶
目标 Profile 中需已安装 DS Bot(README 注明在 ds-bot 0.3.0 下验证过)。包侧无 host 依赖。
Harness Desktop(macOS、Windows)¶
- 侧边栏打开 Plugins → Add plugin。
- 填写已打包 tgz 的绝对路径,例如
/path/to/dsh-dsbot-tweaks-0.1.0.tgz;开发时也可填仓库目录(link install)。 - 安装后刷新页面(⌘R / Ctrl+R);若 DSH 提示重启,则完全退出后重新打开。
Harness Web / CLI¶
在插件源码目录构建并安装 tgz:
cd dsh-dsbot-tweaks
npm run build
pnpm pack
dsh plugin --profile <profile> add ./dsh-dsbot-tweaks-0.1.0.tgz
日常建议使用固定版本的 tgz;开发期可用 dsh plugin ... add /path/to/dsh-dsbot-tweaks 做 link install,改代码后 npm run build 再刷新即可生效。
典型用法¶
原生界面切换¶
- 安装插件并刷新后,在 DS Bot 左下角页脚,设置齿轮旁会出现切换按钮。
- 单击该按钮,界面切换到原生 DSH(经典 Agent 模式)。
- 若要回到 DS Bot,在原生界面侧栏底部使用 DS Bot 按钮。
扩展与其它说明¶
若要自行增加 tweak:在 src/client/tweaks/ 下新增文件(导出工厂函数,返回 { id, enabled(), apply(), install? }),在 src/client/index.js 的 TWEAKS 中注册,执行 npm run build 后刷新。多个 tweak 共用单个 MutationObserver,apply() 需幂等且轻量;一次性监听或定时器放在 install()。详见仓库 docs/adding-a-tweak.md。
卸载:在 Plugins 页面移除,或执行:
dsh plugin --profile <profile> remove dsh-dsbot-tweaks
刷新后无额外残留。
结尾¶
dsh-dsbot-tweaks 适合已在 Profile 中使用 DS Bot、又需要更快在 DS Bot 与原生 Harness 界面之间来回的用户;也把后续同类 UI 微调收敛到同一插件里维护。查阅安装步骤与限制以 GitHub README 为准。
- 目录页:https://www.skillhub.cn/plugins/keliwang/dsh-dsbot-tweaks
- GitHub:https://github.com/keliwang/dsh-dsbot-tweaks