侧边栏控制 Dax233/dsh-sidebar-control

dsh-sidebar-control

面向智能体的控制面，用来操作 DSH 右侧 Sidebar。只提供一个工具（sidebar），外加一份精简的系统提示词概览；底层是一张标签页类型注册表，而不是再做一个浏览器。

DSH 右侧 Sidebar 承载多种标签页：内置浏览器、终端、文件预览、插件自己的页面。这个插件给模型一份该工作区的分层概览，以及导航动词——打开 / 聚焦 / 关闭 / 展开；各类内容的具体操作仍归各自的工具负责（浏览器页面归 browser_，文件归文件工具，终端归 terminal_）。

sidebar status → tree: tabId, kind, title, url/path, active, mounted
sidebar open {kind:"browser", url} → opens the user-visible in-app browser tab
sidebar open {kind:"browser", url, tabId} → navigates that existing browser tab in place
sidebar open {kind:"file", path, line?} → document-preview tab (relative paths resolve against the Session directory)
sidebar open {kind:"terminal"} → opens a visible terminal tab
sidebar expand {tabId, mode?} → content + the exact tools for it (mode: text/elements/html on browser tabs)
sidebar focus / close {tabId} → navigation verbs

为什么需要它（以及它不做什么）

DSH 内置的 Sidebar 浏览器只面向用户——不注册任何模型工具。生态里已有成熟的 MIT 插件，能给浏览器接上智能体控制；这个插件的设计思路是与它们组合，而不是与它们竞争：

- 浏览器标签页内容由 dsh-agent-browser 读取和点击（browser_read、browser_act、browser_screenshot、browser_navigate 等）。对浏览器标签页执行 sidebar expand 时，会向该插件的 Client 服务商索取页面文本，并把 tabId 交给它。
- 文件标签页通过文档预览的资源地址打开（dsh-resource://file/session/<sessionId>/<path>）；expand 返回一段有长度限制的文本摘录和真实路径，其余交给文件工具。
- 终端标签页通过 Sidebar 的终端类型打开；expand 会列出 terminal_ 工具。v0.1 不声称可见终端标签页与 terminal_ 工具会话是同一个东西——它会如实说明，而不是假装。
- 未知类型（其他插件的页面）只做清点：可列出、可聚焦、可关闭，但不可读取。

这个插件不做的事：从不创建 webview，从不启动回环桥接，也从不重新实现页面读取。它通过 Cordis Inspect 通道与渲染进程通信（一个 Client 服务商，SidebarControl），并通过公开的 ctx.sidebarRight 服务与 Sidebar 通信。

平台事实

- Sidebar 按会话隔离。 命令作用于屏幕上正显示 Sidebar 的那个会话；如果某个会话的 sidebar store 从未被接管，就没有可操作的对象，工具会报告「不在屏幕上」，而不是往没人绘制的界面里写数据。
- 桌面外壳把应用内浏览器与 DSH Host 隔离开。 sidebar open {kind:"browser"} 在浏览器插件抛出裸的 ERR_FAILED (-2) 之前就照此策略处理：凡是 DSH Host 端口上的回环主机名，一律拒绝，并给出明确的策略错误。file:// 按设计不可用；文件标签走资源地址。
- 渐进式披露。 提示词部分最多列出少量标签作为概览；完整内容和确切的后续工具只出现在 sidebar expand 结果里，因此上下文预算随实际需要走。
- 可以访问另一个会话（0.2.x）。 给 status/open/focus/close/expand 传 sessionId。只读的 status 不需要切换。目标会话有实时侧边栏存储时，导航命令直接写入该存储（status 会把该会话标为 live-store），因此完全不碰视图；应用启动后从未显示过的会话没有实时存储，于是请求应用显示它（和点击会话行走的同一条路径），然后再恢复之前的会话——回执会说明涉及哪些会话、切换花了多久（0.2.1-rc.3 上实测约 130–160 ms，也就是大约 200–300 ms 的另一段对话）。对这类会话的第一次操作会预热其存储：此后在本次应用运行期间，对它的每次操作都无缝。switchView: false 拒绝可见切换，而不是让视图闪一下（适合不能打扰用户的智能体）。文件标签的 expand 无需切换即可工作（Host 直接读文件），相对路径按目标会话的工作目录解析。还有两条限制，都来自所采用的浏览器插件的会话级契约：另一个会话浏览器标签的内容读不到（只返回元数据），另一个会话已有的浏览器标签也不能用 tabId 导航（改为在那里开新标签）。为什么首次触碰的切换无法从这一侧去掉，以及能去掉它的上游 API，见 docs/upstream-sidebar-store.md。

安装

dsh plugin --profile desktop add github:Dax233/dsh-sidebar-control

或通过 Plugins 页面（github:Dax233/dsh-sidebar-control）。bundle 补丁挂载 Host 那一半；package.json 的 dsh.client 加载渲染器那一半。插件管理器可以热应用 bundle；否则重启 DSH Desktop。

本地开发安装（file: 拷贝，改完要重装）：

dsh plugin --profile desktop add file:F:/github/dsh-sidebar-control

推荐搭配（浏览器内容）：github:guanhaisen/dsh-agent-browser。

配置

可选，写在配置档的 cordis.patch.yml 里：

- id: dsh-sidebar-control
name: dsh-sidebar-control
config:
maxPromptTabs: 8 # tabs rendered in the system-prompt overview
maxTreeTabs: 40 # tabs rendered by sidebar status
maxExpandChars: 4000 # expand content budget (200..20000)
maxFileBytes: 524288 # files larger than this are not excerpted

模型体验

只有一个工具（sidebar），外加一小段提示词，用来说明工作流和最近看到的标签页树。结果是纯文本的树或回执；除了模型主动请求的内容，不会往对话里注入任何东西。这个工具本身从不接触页面内容，所以提示词注入的风险面仍留在那些会接触页面内容的工具上（它们已经把页面内容当作不可信数据处理了）。

许可证

MIT。