13071301808/dsh-composer-expand
Composer expand/collapse toggle for DeepSeek Harness (dsh): a ⬆/⬇ button in the composer tool row grows the input to a tall 70vh writing view for long drafts.
已收录
4
Ui
Bundle 已验证
预览
功能介绍
Web UI 输入框展开/收起:composer 工具行新增 ⬆/⬇ 按钮,一键把输入框扩大到 70vh 高度,方便写长 prompt。
适合
- 编写长 prompt 或长草稿、需要一键切换到 70vh 输入视图并保持实用最小高度的 DSH Web 用户。
- 希望展开模式下按 Enter 换行、保留组合键发送,并让浏览器记住展开状态的用户。
不适合
- 默认输入框空间已经足够的短消息工作流。
- 需要按会话保存状态或自由调节展开高度的用户;状态按浏览器保存,展开高度固定为 70vh。
README
dsh-composer-expand
为 DeepSeek Harness(dsh)打造的 composer 展开/收起插件。在 composer 工具行放一个 ⬆/⬇ 按钮,点击在「默认封顶高度」与「70vh 高书写视图」之间切换,长草稿不再挤在一个小窗口里滚动。
为什么需要
DSH 默认把 composer 文本框封顶在一个较小高度(seat 上定义了 --dsh-composer-text-max-height: 336px,限制文本框滚动容器)。草稿变长后,只能在小窗口里滚动几行。本插件对短草稿保持默认行为,写长 prompt 时一键切换到大视图。
功能
-
⬆ 按钮在 composer 工具行 — 位于
conversation.input.right(发送按钮旁官方预留的可点击控件位)。 -
展开到 70vh — 在会话滚动容器上切换 CSS class;composer 卡片与 textarea 同步放宽
max-height。再点一次恢复默认封顶高度。 -
展开最小高度 300px — 输入内容较少时也保持足够的书写空间;内容变多后最高仍受
70vh限制。 -
展开状态回车换行 — 展开时普通回车只插入换行,不触发发送;
Ctrl/Cmd + Enter等带修饰键快捷键仍可用于发送。 -
浏览器内持久化 — 状态写入
localStorage[dsh-composer-expand:expanded],刷新页面、切换工作区都保留。 -
中英文双语 — 按钮文案与提示跟随 DSH 的
locale服务。 - 纯前端 — 无自定义协议、无 host 命令、无 LLM 调用、不进会话日志。
-
不依赖构建哈希 — CSS 锚定 DSH 稳定的
data-conversation-scroll/data-composer-seat/data-input-mirror属性,而不是每次构建都会变的哈希类名。
安装
通过 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 行。
License
MIT
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:13071301808/dsh-composer-expand。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。