DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Seryta /

Seryta/dsh-sidebar-triptych

Verified

DSH 左侧栏三段折叠:功能区 / 工作区 / 状态区,默认只展工作区,状态存 Host 并跨设备同步

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@e2bbea5f

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。

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit e2bbea5f1bed

Community comments

No comments yet. Be the first to write one.