dsh-fullscreen-input

dsh-fullscreen-input

给 DSH 的输入框加一个全屏输入面板：点开它，在整屏空间里写多行文本，写完点按钮发送。Enter 只换行、只有 Ctrl+Enter 才发送；面板可以移动、可以拖边框改大小，引用与附件都与主输入框共用同一份草稿。

为什么需要一个全屏输入框

DSH 自带的输入框只有窄窄一条：写长提示词时只能在一个很扁的区域里翻来覆去，引用、附件、正文全挤在一起，想通读一遍自己写了什么几乎做不到。

这个面板把输入区放大到整屏：一次能看到的文本量是原来的十几倍；写完之后还能拖标题栏把它挪到别处、拖边框改成想要的宽高，把背后的会话露出来对照着看。它不是只读预览，而是替换掉那条窄输入框的编辑场所——草稿是同一份，在面板里改完关掉，主输入框里就是新内容。

顺带解决的问题

DSH 原有输入框的 Shift+Enter 换行判定依赖一个很短的宽容窗口——输入法组合结束后的 10 毫秒内仍算「正在组合」。中文输入法频繁使用 Shift / Enter（切换中英、确认候选词），很容易落进这个窗口，于是 Shift+Enter 被误判成发送，多行文本根本写不舒服。

面板里没有「Enter 发送」这条路径，所以这个问题在这里不存在。但它是顺带解决的：即使没有这个毛病，一个全屏的输入场所本身也是需要的。

安装

从插件面板（推荐）

打开 DSH 侧栏的 「插件」 页面，点 添加插件，在输入框里填入包名 dsh-fullscreen-input，然后点安装。

那个输入框也接受 Git 地址、压缩包或本地绝对路径——所以没有发布到 npm 的插件同样能从这里装。插件管理页只管理声明了 dsh.bundle 的包，本插件已声明。

命令行

dsh plugin --profile web add dsh-fullscreen-input

装完重启 dsh web，刷新页面。

从本地目录（开发用）

git clone <本仓库> dsh-fullscreen-input
dsh plugin --profile web add link:<克隆下来的绝对路径>

Windows 例：link:D:/example/dsh-fullscreen-input

因为是 link: 安装，改完源码跑一次 node build-client.mjs 重建，刷新页面即生效，不用重装。

怎么用

输入框下方工具栏（「+」按钮所在那一行）会多出一个图标，悬停显示「全屏输入」。点开就是面板；默认 F2 也能唤起它。

键位

按键	行为
Enter	换行
Shift+Enter	换行（与 Enter 等价，Shift 在面板里只表示换行）
Ctrl+Enter / Cmd+Enter	发送
Esc	关闭面板（设置窗口开着时先关设置窗口，面板保留）
Ctrl+0	把面板恢复到默认位置与默认大小（等同双击标题栏）。面板不可达时的自救入口：不要求焦点在面板内，只要面板开着就生效
F2	打开 / 关闭面板（可在设置里改绑为其它功能键）
中文输入法组词中的 Enter / Ctrl+Enter	换行，绝不发送
点击面板之外的区域	关闭面板（等同 Esc；关掉遮罩后不适用）

关闭面板不会丢内容。 面板与主输入框读写的是同一份草稿——不是两份内容互相同步，而是同一个值。所以在面板里敲的字、在主输入框里敲的字，都是同一份。

面板里能做什么

能力	怎么用
写多行	整个面板就是输入区：Enter 换行、Ctrl+Enter 发送
调整大小	拖拽边框或四个角（8 个方向；光标会变成对应的缩放箭头，没有额外的可见把手）。最小 360×240、最大不超过视口。尺寸会被记住，双击标题可连同位置一起复原
移动面板	按住标题那一行拖动（自由拖动，不设边界）；双击标题回到居中。位置默认不记住
看引用	草稿里的 @ 引用显示为带图标的条目，悬停看完整路径
移除引用	引用条目右上角的「×」。它删掉的是草稿里那段文字——引用不是附件，所以在文本框里直接选中删除也一样。点「×」后输入框会失焦（焦点被按钮拿走），点回文本框即可继续输入
看附件	图片显示为缩略图，点击看大图；文件显示类型图标与文件名
移除图片附件	鼠标移到缩略图上，右上角出现「×」
添加文件	面板左下角「+」，走 DSH 自己的文件选择器
粘贴	在面板里直接 Ctrl+V，图片与文件都能贴进来
拖放	把文件直接拖到面板上
滚动背景	鼠标在面板之外滚动滚轮，会滚动背后的会话——边看 LLM 输出边写提示词时不用来回开关面板。面板内部的滚轮仍归面板
唤起快捷键	默认 F2，按一下开、再按一下关。可在设置里改成任意功能键（F1–F12）；Esc 始终关闭
面板底色	想要不透明的面板就开「纯色面板」，想要磨砂质感就开「启用毛玻璃效果」（两者互斥）；两个都关则面板完全透明
关闭遮罩	设置里的「启用遮罩层」可整个关掉遮罩：鼠标从此能直接点击、滚动背后页面。代价是「点击面板外关闭」消失，请用 Esc 或唤起快捷键
使用提示	首次打开面板时会弹一次提示。可勾选「不再提示」；设置最下方有「查看提示」可随时唤回

外观与行为设置

面板头部的小太阳图标按钮（八齿造型，看起来更像太阳而不是齿轮）→「全屏输入设置」：

遮罩层

• 启用遮罩层（默认开）
• 遮罩层不透明度：默认完全透明（0%）
• 遮罩层雾化：默认不雾化（0%）

面板底色

• 启用毛玻璃效果：默认关闭
• 纯色面板：默认关闭，与毛玻璃互斥——只铺底色、不加模糊；开启时会把「面板不透明度」推到 100%，直接得到一个不透明的纯色面板
• 面板雾化（默认 40%）、面板不透明度（默认 25%）、面板颜色：「跟随主题」、6 个固定色，最后那个格子是系统颜色选择器——点它选任意颜色
• 底色共三种状态：两个开关都关 = 面板完全透明；只开「纯色面板」= 铺色但不模糊；只开「启用毛玻璃效果」= 铺色 + 模糊

面板行为

• 记住面板大小（默认开）、记住面板位置（默认关）：两者独立，都关掉时每次打开都回到默认大小与居中
• 唤起快捷键（默认 F2）：点一下按钮，再按一个功能键即可改绑
• 使用提示：点「查看提示」再次显示首次使用的提示弹窗

设置会持久保存，刷新与重开都保留。

⚠️ 一点需要知道的行为：「遮罩层雾化」调高会模糊整个屏幕背景（含面板背后），因为遮罩层本身是全屏的。这是当前实现的行为，不是故障。

兼容性

• DSH >=0.2.0-rc.1 <0.3.0-0（即 0.2.x 发行线）。面板深度依赖宿主的槽位 props、inputActions 与 insertReference 的 revision-CAS 语义，这些正是次要版本最可能变动的地方，所以上界是刻意收窄的——旧版声明的 ≥ 0.2.0-rc.1 会无声地宣称兼容未来的 0.3.0+。
• Node ≥ 20（仅构建源码时需要）
• 纯浏览器侧插件：host 侧是空实现，不产生任何网络请求，不读写会话数据

权限

本插件不需要任何权限档位、审批放宽或沙箱调整即可工作。它请求的能力面刻意保持在最小：

能力	用途
ctx.effect	注册样式表与 locale 字典的清理（卸载时完整回滚，无残留）
ctx.inject(['slots','locale','sessions','conversation'])	等待并取得这四个服务；全部是读取或驱动宿主自己的输入动作
slots.inject + slots.register	往 conversation.input.left 槽位贡献一个工具栏按钮

未使用：ctx.fs、ctx.network、ctx.shell、ctx.resources。它不注册任何 Agent 工具，因此不会扩展模型的工具面。

唯一的本机持久化是一个 localStorage 键（面板外观偏好）；唯一接触文件的路径是驱动宿主自己的隐藏文件输入框，且请求文件对话框必须在你的点击或粘贴手势内完成。完整的攻击面说明与漏洞报告方式见 SECURITY.md。

改源码

node build-client.mjs      # 把 src/client.js 包成 lib/client.js
npm run check              # 语法检查（三个文件）

文件	说明
src/client.js	唯一手写实现（浏览器侧，全部 UI 与逻辑）
lib/client.js	构建产物，运行时实际加载的就是这个
lib/index.js	host 侧，空实现
build-client.mjs	构建脚本，纯文本包裹，无任何依赖
cordis.patch.yml	bundle 补丁，挂载 row id fullscreen-input

改完 src/ 一定要重建，否则刷新页面看到的还是旧代码。

License

MIT