dsh-sidebar-triptych
把 DeepSeek Harness 的左侧栏切成三段,每段一根可点的折叠条;外带工作区置顶(收藏):

| 段 | 对应 DOM | 你侧栏里的内容 |
|---|---|---|
| 功能区 | nav._panelList(折叠条是它的第一行) |
插件 / 自动化任务 / 上下文洞察 / 更多 |
| 工作区 | div._regionArea(折叠条是它的第一行) |
工作区 + 会话列表(默认展开) |
| 状态区 | div._footerActions |
工作区之下、底部「更多」之上的内容:余额卡 / 今日 / 峰谷条 / 番茄钟 / 远程控制 |
底部 div._settingsArea(那行「更多」+ 账号)常驻最底下,不参与折叠;品牌行与新会话按钮也保持常驻。
工作区展开时不额外占一条:折叠箭头直接并进宿主自己的「工作区」标题行右侧([class*="_sectionHeader"]);整行都可以点——点「工作区」标签或行内空白处就折叠,行里的搜索 / 视图选项 / 新建工作区按钮各做各的,鼠标悬停时整行给出和功能区一样的 hover 底色。收起后才换成一条独立的「工作区」折叠条。所以默认状态下侧栏只多两行(功能区 / 状态区),不会出现两个「工作区」。
宿主改版导致标题行找不到时,插件不会把自己唯一的入口藏起来:独立折叠条保留,工作区照样能收放。

默认与持久化
- 默认:工作区展开,功能区与状态区折叠。
- 状态存在 Host 侧:
$DSH_HOME/sidebar-triptych.json(默认~/.dsh/sidebar-triptych.json)。 - 跨设备同步:任意设备点折叠 / 置顶 → POST 到 Host → Host 通过 SSE 推给所有在线浏览器,其它设备 1 秒内跟着变。新开的页面进来先 GET 一次,直接拿到当前状态。
- 只合并改动的那一段:POST body 只带被改的部分(
{collapsed:{foot:false}}、{pin:{id,before}}、{unpin:{id}}),Host 按字段合并。两台设备同时改不同的段时不会互相覆盖。 - 首帧用浏览器
localStorage里的上一次状态(折叠 + 置顶列表)上色,避免「先按默认画一次再被服务器纠正」的闪烁;Host 仍是唯一权威,SSE / pull 一到就覆盖本地副本。 - 断线不影响使用:本地乐观生效,SSE 断了每 20 秒 pull 一次收敛。
工作区置顶(收藏)
鼠标移到侧栏任一工作区行上,行尾会多出一枚星标;点一下把它置顶到列表最前,再点取消。
- 置顶列表与折叠状态存在同一份 Host 状态里(
pinned: [{ id, before }]);任意设备置顶 / 取消,其它设备通过 SSE 跟着变。 - 排序走宿主自己的
workspaces.insertBefore(工作区注册表顺序),不是手改 DOM 顺序:React 重渲染不会把顺序冲掉,工作区选择器等其它界面看到的也是同一顺序。 - 每项记一个
before锚点 = 置顶那一刻「紧跟其后的第一个未置顶工作区」;取消置顶时按它放回原位。锚点已被删除、或锚点本身后来也被置顶了,就放回末尾——置顶区永远只在最前。 - 星标插在宿主工作区行的
_rowActions里([data-row-key="workspace:<id>"]行内的 hover 按钮容器),沿用宿主自己的 hover / 触屏显隐;置顶后标题右侧另有一枚常显小星。 - 只接管侧栏工作区列表(
_regionArea内,排除搜索结果树)。宿主切成「一个列表」扁平视图时没有工作区行,也就没有星标。 - 置顶是真的改注册表顺序:卸载插件后顺序停在最后一次置顶 / 取消后的样子,插件不会自动还原。
宿主侧 API
GET /plugins/dsh-sidebar-triptych/state -> { collapsed:{panels,region,foot}, pinned:[{id,before}], rev, updatedAt }
POST /plugins/dsh-sidebar-triptych/state <- { collapsed?, pin?:{id,before?}, unpin?:{id} }(只合并给出的部分)
GET /plugins/dsh-sidebar-triptych/events -> SSE,event: state
collapsed[key] === true 表示该区折叠。pinned 最近置顶的在前,before === null 表示置顶前它在末尾。
鉴权:装配里有宿主的 connection 服务时,两个端点都由它裁决(Host/Origin fence + 浏览器 cookie 认证)——没有有效会话 cookie 的请求拿到 401,跨源请求拿到 403。没有 connection 服务的装配(headless / 嵌入式,那种装配也没有浏览器页面)退回严格同源检查:没有 Origin 头的请求一律 403。
其它响应:不支持的方法 405(带 Allow),非法 JSON 400,pin / unpin 缺少合法 id 或 id 超长 400,请求体超过 8 KiB 413(先把响应写出去再丢弃剩余请求体,不会把连接重置掉)。
状态文件原子写(临时文件 + rename),写失败只告警、不回滚 UI;写失败时 rev 不推进,避免进程重启后客户端拿旧 rev 把服务器状态永久丢掉。旧版状态文件(只有 collapsed)读进来时 pinned 自动补成空数组。
安装
两条路二选一,别同时装:
# 1) 作为 profile bundle(推荐,长期使用)
dsh plugin --profile web add "file:/absolute/path/dsh-sidebar-triptych"
# 2) 运行时注入(不写 profile,可随时撤回;不要与上面的同时存在)
dsh> dev_inject_plugin /absolute/path/dsh-sidebar-triptych
同时装两份会让宿主侧对同一 (exact, path) 重复注册,而宿主对重复路由是直接抛错(不是覆盖)。
装完刷新页面(F5)即可看到折叠条;宿主侧路由随 dsh 重启生效(浏览器半边只要刷新)。置顶的 pinned 字段也在宿主侧:重启前点星标只会改当前页面与注册表顺序,刷新后置顶状态会丢——要跨设备持久化,等宿主重启。旧版 Host 不认识 pin 字段,不会报错,只是把这次 POST 当成一次普通状态写入。
测试
scripts/test-browser.sh # 宿主路由语义 + 浏览器 DOM 行为(需要 chromium)
scripts/test-browser.sh --no-dom # 只跑宿主侧断言(不需要浏览器)
harness 用真实的 lib/index.js 与 lib/client.js:宿主侧挂在最小的 node:http 上(桩只提供 webServer / effect / get('connection')),浏览器侧按宿主构建产物还原的 DOM 层级跑 headless chromium(0.2.2-rc.3 的 _scrollRegion > _scrollArea CSS grid 滚动视口、_panelList/_regionArea 的 grid-row 钉位、工作区行、_rowActions、data-row-key 都按 dsh-client-ui-sidebar / dsh-client-ui-workspace 的真实结构,并带一个会真的移动 _groupSection 的 workspaces.insertBefore 桩)。86 条断言覆盖:默认状态、三段位置、折叠条必须占满整行(防止又掉进 grid 的 4px 装订线列)、折叠条与下一段的间距等于宿主自己的段间距、工作区标题行整行可点而行内控件不被抢、折叠/展开、窄条、折叠条与宿主标题行的度量对齐、宿主重建容器后的补回与重标、dispose 清理、认证、413、字段级合并、rev 单调、状态文件权限、SSE 帧格式、无 connection 时的降级,以及工作区置顶(星标插进行内 actions、点击不触发行的展开、排到最前、锚点还原与「锚点也被置顶时退回末尾」、重渲染补回、Host 落盘、旧状态文件兼容)。
浏览器成对回收:脚本退出(正常 / 失败 / Ctrl-C / 被 kill)都会杀掉本轮的 chromium 并删掉 profile,结束时打印 leftover profiles=0 leftover processes=0。
边界与已知限制
纯 DOM 增强:不注册 slot、不改 React 树;折叠靠
<html>的data-dsh-tp-*属性 + 一条!important规则,React 重渲染不会把状态冲掉。折叠条被重渲染删掉时由
MutationObserver补回(rAF 去抖),另有 2 秒兜底sync()。侧栏收成 <96px 图标窄条时,三段强制展开,折叠条与并进标题行的小箭头都隐藏;此时点不到任何折叠入口,也就不会悄悄改掉你别的设备上的偏好。
依赖宿主侧栏的 6 个 CSS Modules 类名后缀(不写死构建哈希):
后缀 用途 失配后果 _panelList功能区锚点 功能区不折叠 _regionArea工作区锚点 工作区不折叠 _footerActions状态区锚点(只在 _footArea内找)状态区不折叠 _footArea状态区容器 状态区不折叠 _settingsArea从「按位置收块」里排除设置行 折叠可能连设置行一起收 _sectionHeader工作区展开态的唯一折叠入口 自动退回独立折叠条(功能不受影响,只多一行) 失配时只是不出现折叠条或退回独立条,不会破坏页面。
折叠条插在容器内部,而不是容器的兄弟位置:宿主 0.2.2-rc.3 起,侧栏滚动视口
_scrollArea是 CSS grid,_panelList(第 2 行)与_regionArea(第 4 行)的网格位置是写死的;插在它们前面的兄弟节点会被自动排进最左侧那条 4px 装订线列,折叠条只剩几像素宽、标签被压成 0 宽——dsh 0.2.2-rc.3 升级时正是这样把「功能区」变成了一个隐形小块。所以折叠条现在是_panelList/_regionArea的第一行,被折叠的是容器的其余子节点;状态区(_footArea一直是 flex 列)仍用兄弟位置。宿主再次改布局时,回归断言(折叠条宽度 == 容器宽度、标签宽度 > 40px、折叠条到下一段的间距 = 宿主的 8px margin + 2px grid 间隔)会先失败。三段是同一套行:功能区 / 状态区的折叠条与宿主「工作区」标题行同度量——高 36px、左内边距
var(--dsh-sidebar-row-padding,12px)、右 1px、color: label-tertiary、border-radius: var(--dsw-radius-md,12px)、字号直接font: inherit(不写死 px)。宿主改字号/间距时折叠条跟着走。docs/*.png按当前版本重拍,里面的工作区与会话名是占位符(截图时替换过),实际界面以运行时为准。置顶另依赖宿主 client 的
workspaces服务(workspaces.insertBefore)与工作区行的data-row-key="workspace:<id>"/_rowActions。拿不到服务时星标仍可点、状态仍会跨设备同步,但不会真正排序(只在 console 里留一条 warn);行结构失配时星标不出现,折叠功能不受影响。置顶的排序列是 Host 注册表顺序(所有客户端共用)。取消置顶按置顶时记下的
before锚点还原;锚点所在工作区已被删除、或锚点后来也被置顶时,退回末尾,不是原像素位置。扁平「一个列表」视图没有工作区行、窄条 rail 也不显示工作区行,这两种视图下没有置顶入口。
与其它「改同一批行」的插件(如 dsh-sidebar-fold / sections / panel-buttons)不要同时开。
状态自己落在
$DSH_HOME/sidebar-triptych.json,没有用宿主的ctx.storage:取舍是零额外服务依赖(除运行时可选读connection/workspaces外不声明任何必需服务)+ 同机多个 profile 共享同一套偏好;代价是没有宿主侧的备份与 schema 迁移。写盘用临时文件 + rename,坏一半的 JSON 不会出现。删除
dsh.plugin.json不是回归:当前宿主只读package.json的dsh.bundle.patch、dsh.client与exports["./client"],那份文件从来没人读。
卸载
- 正式安装:
dsh plugin --profile web remove dsh-sidebar-triptych - 运行时注入:
dev_uninject_plugin dsh-sidebar-triptych
删除后状态文件 ~/.dsh/sidebar-triptych.json 可留可删(留着下次装上还是同一套偏好)。
License
MIT。
No comments yet. Be the first to write one.