移动端适配盒 charysrinathsc/dsh-agentbox

dsh-agentbox

针对 DeepSeek Harness（DSH）web shell 的移动端与小屏修复，打包成插件而不是补丁——这样 DSH 升级后它还能活下来。

起因是把 DSH 当成一台常开的智能体盒子来跑，主要用手机操作。DSH 的 web shell 是桌面优先的：整份样式表里只有一个媒体查询（prefers-reduced-motion），没有任何响应式断点，所以在手机宽度下，它照旧渲染桌面三栏布局，不做重排。

它做什么

所有功能都放在开关后面，默认开启。

| 开关 | 效果 |
| mobileCss | 仅 ≤640px：收回 56px 的侧边栏，让展开的侧边栏浮在聊天区上方，而不是把它挤扁；点会话时自动收起侧边栏；不再让对话记录透过输入框。 |
| usageDockCompact | 让用量指示器保持一行。 |
| usageDockTerse | 把用量栏改写成符号（↓319M ·↑937K ·⚡100%），去掉那些吵闹的指标。 |
| enterNewline | 在移动端，Enter 换行，发送按钮负责发送——这是移动端的惯例。原版 DSH 是 Enter 发送，只有 Shift+Enter 才换行，在手机键盘上得别扭地按两下。 |

外加一些小修正：输入框加上不透明背景，这样对话记录不会透过它周围那条带子显出来；用量栏设为换行而不是裁切。

安装

into a profile — dsh plugin forwards to pnpm in the profile directory
dsh plugin --profile web add github:charysrinathsc/dsh-agentbox

then sign the profile
dsh restart

包里带了一个 dsh.bundle.patch，所以它会自动合成进配置档。要关掉某个功能，在配置档的 cordis.patch.yml 里覆盖它：

- id: dsh-agentbox
config:
enterNewline: false

要求

- 带 web 配置档的 DSH
- 移动端那部分需要浏览器宽度 ≤640px；其余部分在任何宽度都生效

老实说的坑

- 输入框仍然会被 iOS 键盘挡住。 iOS Safari 会缩小视觉视口，但不缩布局视口，于是输入框的工具栏那一行就落到键盘下面去了。试过把框架尺寸改成 visualViewport.height，结果更糟，已经回退——见 INTERNALS.md。把这个问题当成上游问题吧。
- 类名是哈希过的（_3WPZCG_toggle、yhfFVG_card）。靠子串匹配，天生脆弱。tools/health.mjs 会拿 25 条关键假设去核对一个运行中的实例，DSH 一动东西它就非零退出。
- 只针对一个 DSH 版本开发和验证过。它依赖 CSS 和 DOM 结构；DSH 升级后记得重新检查。

开发

INTERNALS.md 是工程日志：每一次测量、每一条死路、每一个陷阱——包括三次自己造成的回归，以及是什么把它们抓出来的。如果你要改这个插件，先读它；能帮你省下同样的几个下午。
源工作区的同级 tools/ 目录里放着两个测试工具：

- health.mjs —— 这个插件依赖的选择器还在不在？（假设）
- regress.mjs —— 功能还能用吗？（行为，跑在 WebKit 上，因为 Chromium 和 iOS Safari 测量文本的方式不一样）

两者失败时都会以非零状态退出。

License

MIT