dsh-sidebar-share

让同一个 DSH 工作区里的所有会话共用同一套右侧栏：文件树、浏览器页、文档预览、终端等 tab 的布局，以及浏览器 tab 当前打开的页面，都会在会话之间同步。

非官方插件。通过 ctx.slots.resolveStore 与 DSH 0.2.1-rc.3 的 store 结构工作，DSH 升级后可能需要适配。

安装

在 DSH 的 插件 页面选择 添加插件，输入包名：

dsh-sidebar-share

也可以在你使用的 profile 下安装：

dsh plugin --profile <profile> add dsh-sidebar-share

例如桌面端 profile 是 desktop，Web 端是 web。

安装后重启 DSH（或重载窗口）加载客户端插件。

行为

• 每个工作区有一个 canonical 侧栏，保存在 localStorage['dsh.sidebar-share.v2.<workspaceId>']。
• canonical 只由活着的、非归档的会话自己的侧栏变化写入；同一工作区里已打开的会话之间实时镜像。
• 某个工作区第一次启用（还没有 canonical）时，用你当前操作的会话作为模板，只采纳一次；之后不再从任何历史会话的存档里重建模板。
• 空就是空：把 tab 全部关掉是一个决定，不是「坏模板」。其余会话会同步变空并收起，之后新开的会话也是空的，不会被旧会话「修」回来。
• 内容为空时一律按收起应用（expanded: false），因此不会出现一个空面板自己弹开。
• 同工作区文件地址 dsh-resource://file/session/... 会改写成接收方会话 id。
• 当前激活的 tab / pane 只属于当前窗口；tab 内容、分栏、浮窗会同步。
• 归档会话不参与：既不作为模板，也不接收同步。

配置：侧边栏范围

右侧栏是「工作区共享」还是「会话独立」是插件配置项，在 侧栏 → 插件 → 已安装插件 → dsh-sidebar-share 的配置区切换（plugins.bundle.config，按包名 dsh-sidebar-share 挂载）：

| 取值 | 行为 | |---|---| | workspace（默认） | 同一个工作区的所有会话共用一套右侧栏，实时镜像 | | session | 每个会话各自保留侧栏，等同 DSH 官方默认；插件不再读写任何 canonical |

• 切换立即生效，不需要刷新。
• 从 session 切回 workspace 时，会用该工作区现有的 canonical 对齐所有已打开会话；没有 canonical 的工作区会采纳一次当前会话。
• 也可以在 profile 的 cordis.patch.yml 里固定：

- id: sidebar-share
  config:
    scope: session

• 值保存在 Host 用户设置文档里，同一 Host 的所有已认证浏览器共享。
• 宿主没有 configForms（ui-settings）时按 workspace 运行，配置区不出现，镜像功能不受影响。

关闭标签页（右键菜单）

右侧栏 tab 的右键菜单里，在宿主自己的「关闭」之后多了两项：

| 菜单项 | 行为 | |---|---| | 关闭其他标签页 | 关掉同一分栏里除当前 tab 以外的所有 tab | | 关闭右侧标签页 | 关掉同一分栏里排在当前 tab 右侧的所有 tab |

• 只作用于当前分栏：分屏后的另一个分栏、浮窗里的 tab 都不会被牵连。
• 从右往左依次关闭，关完焦点落回最靠左的幸存 tab。
• 关闭走 sidebarRight.closeIn()，tab 类型自己的收尾（例如终端的清理）照常执行；宿主没有这个入口时退回 store 的 closeTab。
• 没有可关的 tab 时（只有一个 tab，或已经是最后一个）这两项不显示，不会出现点了没反应的死项。
• 每关一个 tab 是一条可撤销的布局历史；撤销是逐条的。

引用到对话（把侧栏内容送进输入框）

右侧栏任意 tab 的右键菜单里多了一项 「引用到对话」。点一下，就把这个 tab 的内容插入当前会话输入框的光标处：

| tab 类型 | 插入内容 | |---|---| | 文件 / 预览 | @相对路径 （路径含空格时自动变成 @"..."）；发出去后模型会自己去读这个文件 | | 浏览器 | 当前页面的 URL | | 终端 | 终端当前可见屏幕的最后 60 行，包在 ```text 代码块里 |

• 插入走 DSH 的公开输入面（inputActions.captureInsertion() + insertText()），是一次可撤销的纯文本编辑，不会覆盖已有草稿。
• 插入后焦点回到输入框，光标停在刚插入的内容之后，你接着写「把这个页面改成……」即可（不会跳到开头）。
• 如果宿主没有提供插入面（inputActions 未挂载），会退化为复制到剪贴板，并在页面顶部弹出提示，不会出现“点了没反应”。
• 终端只能读到可见屏幕（xterm 的 DOM 渲染器，不含滚动历史）；后台终端 tab 读到的是当时可见的那个终端，请以实际插入内容为准。
• 宿主没有 sidebar.right.tab.menu.item 插槽时，这一项不出现，不影响原有的镜像功能。

在访达 / 文件管理器中显示

文件 tab（预览页、图片、文档等 dsh-resource://file/...）的右键菜单里多了一项：「在访达中显示」。Windows 上是 「在文件资源管理器中显示」，Linux 上是 「在文件管理器中显示」。

• 动作由 Host 执行：插件先把 tab 的地址解析成 Host 上已验证的绝对路径（走了与会话文件预览同一套 workspaceFiles.stat 授权），再调用 session.openWorkspacePath({ action: 'reveal' })。macOS 是 open -R（访达里选中文件），Windows 是资源管理器选中，Linux 是 xdg-open 打开所在目录。
• 平台判定以 Host 为准，不看浏览器：先读 Host 的 open-in-app/apps 目录（Finder / 资源管理器 / filemanager），读不到时再看 Host 的 home 目录拼写（/Users/…、C:\Users\…、/home/…）。所以在 macOS 上远程连 Linux 宿主，看到的是「在文件管理器中显示」，不会误标成访达。
• 只有在完全判断不出宿主是哪个平台、且宿主也声明不能打开路径时，这一项才隐藏；其余情况即使 Host 没有桌面也会显示，点击失败时用顶部提示说明原因（例如远程 / 无显示服务器的宿主）。
• 只对文件 tab 出现；浏览器、终端、文件树页签不会出现。
• 失败不会静默：会弹一条「在访达中显示失败：…」的提示，说明是路径无法解析还是 Host 拒绝。

调试

DevTools console 里：

window.__DSH_SIDEBAR_SHARE__.tabMenu.fileManager()      // 'finder' | 'explorer' | 'directory' | undefined
window.__DSH_SIDEBAR_SHARE__.tabMenu.fileManagerLabel() // 当前菜单文案
window.__DSH_SIDEBAR_SHARE__.tabMenu.resolvePath({ contentId: 'dsh-resource://file/session/<id>/AGENTS.md' })
window.__DSH_SIDEBAR_SHARE__.tabMenu.reveal({ contentId: 'dsh-resource://file/absolute/Users/me/x.md' })
window.__DSH_SIDEBAR_SHARE__.tabMenu.refreshFileManager()

升级到 0.1.6

• 0.1.6 只改浏览器半：tab 右键菜单新增「在访达 / 文件资源管理器中 / 文件管理器中显示」，并让「引用到对话」在没有插入面时退化为复制到剪贴板 + 顶部提示。
• 刷新窗口（Cmd+R / Ctrl+R）即可生效；不需要重启 Host，也不需要重开插件。
• 菜单文案来自 Host 平台，换机器（macOS / Windows / Linux）会显示对应说法。

升级到 0.1.4

• 0.1.4 动了 Host 半（配置 schema 与 settings 命名空间），只按 Cmd+R 不够：需要重启 DSH，或在插件页把 dsh-sidebar-share 关掉再打开一次。
• 之后在插件页出现「侧边栏范围」，取值切换是即时的，不再需要刷新。

从 0.1.2 升级（0.1.3）

• 旧的 dsh.sidebar-share.v1.* canonical 会被删除，并写入一个显式的 reset。
• 升级后第一次加载会把各会话的旧侧栏清空并收起一次——包括此前被归档会话「回填」出来的 tab。
• 这是有意的：v1 的模板可能正是那条旧逻辑反复重建出来的坏数据，无法可靠区分「用户主动清空」与「启动竞态」，所以不做内容迁移，只做一次干净的重置。
• 迁移在插件加载时自动完成，无需手工清 localStorage；console 里会看到 [sidebar-share] migrated v1 canonicals 1。

不共享的内容

• 终端 PTY：每个会话仍是自己的 shell；terminal tab 的布局会同步，底层进程不共享。
• 浏览器页面实例：每个会话仍是自己的 webview/iframe，只是打开同一个 URL；页面内滚动、表单等临时状态不会同步。桌面端的 Cookie / 站点存储本来就按工作区共享。
• 会话内容、草稿、审批状态等其它 store。
• 右栏的展开/收起、全屏模式：每个窗口自己决定（只有「整个工作区为空」时会统一收起）。
• 没有工作区归属的会话（hero / 未分组）不参与。
• 归档会话。

临时关闭

在 DevTools console 里：

localStorage.setItem('dsh-sidebar-share.disabled', '1')

刷新页面即可。恢复时删除该 key 再刷新。

兼容性

• 面向 DSH 0.2.1-rc.3 编写，依赖 ctx.slots.resolveStore 和 sidebar/browser store 的 spec 形状；tab 右键菜单两项额外依赖 sidebar.right.tab.menu.item 插槽，inputActions 输入面（可缺省）以及 remote.session.openWorkspacePath / remote.workspaceFiles.stat。
• 「在访达中显示」的平台判定优先读 Host 的 open-in-app/apps（@deepseek-ai/dsh-host-open-in-app）；该路由不可用时退化为 home 目录拼写判断。
• 侧边栏范围设置依赖 Host 的 settings / configForms（ui-settings）与 schemastery。
• 这些不是公开 API；DSH 升级后可能需要改插件。升级前建议先禁用插件确认侧栏行为。

验证

node test/harness.mjs

harness 覆盖：v1 → v2 迁移、reset 清空并收起、用户打开第一个 tab 解除 reset、跨会话镜像与文件地址改写、关闭全部 tab 后不被 sweep / 新会话复活、归档会话不参与、空工作区一次性采纳、展开状态按窗口隔离，以及「引用到对话」的文件路径 / 浏览器 URL / 终端文本生成、菜单项注册与点击插入。

License

MIT

本包由 dsh-sidebar-share 的浏览器半（dist/client.js）和空的 host 半（dist/index.js）组成；cordis.patch.yml 负责把自身插入 profile 的 bundle 列表。