13071301808/dsh-composer-expand

dsh-composer-expand

已收录于 DSH Directory

为 DeepSeek Harness（dsh）打造的 composer 展开/收起插件。在 composer 工具行放一个 ⬆/⬇ 按钮，点击在「默认封顶高度」与「70vh 高书写视图」之间切换，长草稿不再挤在一个小窗口里滚动。

为什么需要

DSH 默认把 composer 文本框封顶在一个较小高度（seat 上定义了 --dsh-composer-text-max-height: 336px，限制文本框滚动容器）。草稿变长后，只能在小窗口里滚动几行。本插件对短草稿保持默认行为，写长 prompt 时一键切换到大视图。

功能

- ⬆ 按钮在 composer 工具行 — 位于 conversation.input.right（发送按钮旁官方预留的可点击控件位）。
- 展开到 70vh — 在会话滚动容器上切换 CSS class；composer 输入区同步放宽 max-height。再点一次恢复默认封顶高度。
- 展开最小高度 300px — 输入内容较少时也保持足够的书写空间；内容变多后最高仍受 70vh 限制。
- 展开状态回车换行 — 展开时普通回车只插入换行，不触发发送；Ctrl/Cmd + Enter 等带修饰键快捷键仍可用于发送；斜杠 / @ 触发菜单打开时不拦截，回车正常选候选。
- 浏览器内持久化 — 状态写入 localStorage[dsh-composer-expand:expanded]，刷新页面、切换工作区都保留。
- 展开状态自愈 — 展开期间监听 DOM 重建：即使 harness 重建了会话滚动容器或 composer 卡片（切视图、切会话），展开样式与"回车换行"行为也会自动重新应用到新的输入框上。
- 中英文双语 — 按钮文案与提示跟随 DSH 的 locale 服务。
- 纯前端 — 无自定义协议、无 host 命令、无 LLM 调用、不进会话日志。
- 不依赖构建哈希 — CSS 锚定 DSH 稳定的 data 属性（data-conversation-scroll / data-composer-seat / data-input-scroll / data-composer-input，并保留 textarea 时代的 data-input-mirror），同时兼容 Lexical 编辑器与旧 textarea 两代 composer，不碰每次构建都会变的哈希类名。
- Lexical composer 适配 — 桌面版 0.1.2-alpha.1+ 的 composer 已换成 Lexical contenteditable：本插件改用 composer seat 上的 capture 阶段 keydown 拦截普通回车（先于 Lexical 的 bubble 监听），展开时回车仍是换行而不是发送。

安装

通过 npm 安装（推荐）

dsh plugin --profile web add dsh-composer-expand

已发布到 npm，包含预构建产物，无需本地构建。

源码本地开发

dsh CLI 必须在 PATH 上。若你只用 npx 跑过 harness，dsh 尚未全局安装，会报 zsh: command not found: dsh——先全局安装：

npm install -g @deepseek-ai/dsh

从本仓库安装：

1. 构建产物（tsdown 生成 lib/index.js + lib/client.js）
pnpm install
pnpm build

2. 加入 web profile
dsh plugin --profile web add ./

3. 以该 profile 重启 harness
dsh --profile web

重启后 ⬆ 按钮出现在 composer 工具行（发送按钮旁）。可在 设置 → 插件 中确认 dsh-composer-expand 已列出。

工作原理

| 环节 | 机制 |
| --- | --- |
| 按钮位 | conversation.input.right 列表槽位（会话作用域）；ctx.slots.inject 注册单个 React 组件 |
| 切换状态 | React useState，初始值读 localStorage[dsh-composer-expand:expanded]；变更时写回 localStorage |
| DOM 挂钩 | document.querySelector('[data-conversation-scroll]').classList.toggle('dsh-composer-expand-on', on) — 会话滚动容器上的官方稳定属性 |
| CSS 契约 | .dsh-composer-expand-on 在 [data-composer-seat] 上覆盖 --dsh-composer-text-max-height（真正的 336px 上限）为 var(--dsh-composer-expand-height)（默认 70vh），并给 [data-input-mirror] 设 min-height: 300px，即使内容很少输入框也会明显变高 |
| 硬依赖 | export const inject = ['slots', 'locale'] — 均为官方 harness 客户端服务 |
| 无 host 命令 | lib/index.js 是空 apply()，整个插件纯客户端 |

构建

pnpm install
pnpm build   # tsdown: lib/index.js（ESM host）+ lib/client.js（ModuleLoader 客户端 bundle）

已知限制

- 状态按浏览器记忆，不按会话。DSH 同一时刻只渲染一个 composer，目前无感知差异；若未来同时渲染多个，需要收窄 DOM 选择器。
- 展开高度固定为 70vh。未来版本可在设置卡片里提供高度滑块。
- --dsh-composer-text-max-height（336px）是 DSH 的设计选择。本插件只放宽 composer 文本框容器，不影响其他 disclosure 行。

许可证

MIT