dsh-chat-collapse

给 DSH Web GUI 的聊天组件加一枚「一键收缩」
点一下把组件藏起来，角落浮出恢复球；点球即还原，球自己消失。

English | 中文

纯浏览器侧插件，零 DSH 源码改动。不 patch 本体、不注入 bundle、不起宿主服务。

它解决什么

小屏上输入框和工具条常驻，能看的对话就少了那么一截。 本插件在输入框工具行最右侧放一枚 ⌄ 按钮：点一下整条组件收起，纵向空间全给对话； 角落留一颗恢复球，随时点回来。

收起是 CSS 隐藏，DOM 不卸载 —— 草稿、贴的图、光标位置全都留着，展开回来接着写。

交互

动作	结果
点输入框工具行最右侧的 ⌄ 按钮	目标组件收起（草稿 / 图片 / 光标位置全部保留）
收起后	视口角落浮出 恢复球（对话气泡图标）
点恢复球	组件放回来，球自己消失
右键恢复球	在「输入框 / 整个对话区」之间切换收缩目标，并弹一条轻提示
Alt+H	键盘切换收起 / 展开

状态（是否收起、收缩目标、悬浮球位置）写 localStorage['dsh.chatCollapse.v1']，刷新后保持。

收缩目标

target	藏什么	靠什么定位
composer（默认）	只藏输入框那一条座位	[data-composer-seat]
chat	藏整个对话区（消息 + 输入框 + 会话头）	[data-conversation-scroll] 的父节点

显隐由 <html> 上的 data-dsh-cc / data-dsh-cc-target 两个属性 + CSS 选择器驱动 —— 不给官方节点加类名，React 重渲染抹不掉。

安装

dsh plugin --profile web add github:cx2002302-lang/dsh-chat-collapse

装完重启一次 dsh web（新 bundle 要进客户端启动图），再刷新页面：

# 服务名按你自己的部署改；下面是 systemd 用户服务的写法
systemctl --user restart dsh-web.service

刷新后：输入框工具行最右侧即出现 ⌄ 按钮。

本地开发时也可以直接指向目录：

dsh plugin --profile web add /path/to/dsh-chat-collapse

卸载

dsh plugin --profile web remove dsh-chat-collapse

卸载时 ctx.effect 的回收函数会摘掉自己注入的 <style>、按钮、恢复球与 <html> 属性， 不留残留（tests/unit-check.mjs 里有对应断言）。

依赖的官方钩子

钩子	出处
[data-composer-card]	ui-conversation/skeleton/InputBar.tsx
[data-composer-seat]	ui-conversation/skeleton/ConversationRoot.tsx
[data-conversation-scroll]	同上

三个都是源码里的字面量属性，不是 CSS-module 哈希类名，版本内稳定。 在 dsh 0.1.2-rc.1 上实测存在。

隐私

• 无网络请求、无遥测、无宿主侧服务。
• 唯一落盘的是 localStorage['dsh.chatCollapse.v1']（三个布尔 / 枚举值）。
• 宿主半侧 lib/index.js 是空 apply()，不注册任何服务、不读任何文件。
• 插件不接触会话内容，不读取草稿文本。

目录

lib/index.js          宿主半侧：空 apply（只为把 dsh.client 声明登记进 web 名册）
lib/client.js         浏览器半侧：全部功能（__ModuleLoader__ bundle，无 JSX、无构建）
cordis.patch.yml      把本插件 insert 进 web profile 的插件名册
tests/unit-check.mjs  纯 Node 检查：断言真正生成的那张样式表（无需浏览器，17 条）
tests/smoke.html      浏览器功能自测：点击 / 还原 / 目标切换 / 快捷键 / 卸载（24 条）
tests/visual.html     展开 / 收起两态的样子（加 ?state=collapsed 看收起态）

自测

# 1) 纯 Node，无浏览器依赖
node tests/unit-check.mjs

# 2) 浏览器功能自测（headless Chrome）
google-chrome --headless=new --no-sandbox --virtual-time-budget=6000 \
  --dump-dom "file://$PWD/tests/smoke.html" | grep -E 'PASS|FAIL|passed'

改配置

默认值都在 lib/client.js 顶部的 DEFAULTS：collapsed / target / anchor / ball。

• anchor: 'toolRow'（默认）按钮进工具行；改成 'corner' 则贴输入框卡片右上角。
• ball: 'br' | 'bl' | 'tr' | 'tl' 恢复球落点，默认右下。 底边两档的 bottom = BALL_INSET(20) + BALL_SIZE(44)/2 = 42px —— 比基准抬高半个球高， 避开收起后右下角本来就有的常驻控件；要再挪改这两个常量即可。

License

MIT