前言¶
DSH 社区采用插件化方式扩展能力,web profile 也可以通过插件增加浏览器侧功能。对于使用 dsh web 的开发者来说,常见需求是把当前对话中涉及的文档、网页、图片集中展示出来,并且能在右侧直接查看工作区文件、运行终端命令、预览 HTML 或图片。
dsh-summary-sidebar 是一个面向 DeepSeek Harness(dsh)web profile 的独立客户端插件。它把「摘要」和「侧边栏」打包在一起:摘要负责汇总当前对话中的文档、网页、图片;侧边栏提供文件夹、终端、浏览器、文档阅读器、图片阅读器五个工具。
这是什么¶
dsh-summary-sidebar 是 DeepSeek Harness Web 的「摘要 + 侧边栏」插件,维护者为 az790871109,许可证为 MIT,当前版本为 0.4.0。
它是一个完全独立、可单独部署的插件,不依赖任何其它已安装插件。插件主要解决两件事:
1、在会话头部提供「摘要」,集中展示当前对话输出的文档、网页、图片。
2、在右侧提供「侧边栏」,包含文件夹、终端、浏览器、文档阅读器、图片阅读器五个标签。
核心功能¶
摘要¶
点击会话头部右上角的「摘要」按钮后,插件会汇总当前对话输出的文档、网页、图片。摘要只输出这些可点击条目,不输出推导/叙述文本。
摘要来源来自当前会话的工具调用与结果文本,例如 read / glob 工具、web_fetch / web_search 结果中的 URL。
每个摘要条目都可以点击:
- 文件:打开侧边栏,并用对应工具预览/编辑该文件。
- 链接:打开侧边栏「浏览器」加载该网址。
- 图片:打开侧边栏「图片阅读器」。
侧边栏¶
侧边栏是右侧抽屉面板,包含五个标签:
| 标签 | 能力 |
|---|---|
| 文件夹 | 浏览、打开、新建文件、新建文件夹、重命名、删除 |
| 终端 | 独立 PTY 终端(node-pty),输入命令、Ctrl+C、清空、重启 |
| 浏览器 | 地址栏 + iframe 预览工作区 HTML 或外部网址,含 iframe 内嵌检测 |
| 文档阅读器 | 打开文本文件进行阅读与编辑,保存回工作区 |
| 图片阅读器 | 查看工作区图片(png/jpg/gif/webp/svg 等) |
侧边栏打开时,插件通过 Harness 右侧 details 列预留 360px,对话框自动左移让位,侧边栏贴合预留区,不遮挡对话内容。
安装与启用¶
先确认前置条件:已安装 DeepSeek Harness(dsh),并使用 web profile(dsh web);本机已安装 node-pty。如果 Harness 的部署目录或 $DSH_HOME/profiles/node_modules 中已有 node-pty 即可;没有则执行下面命令安装:
pnpm add node-pty
GitHub 安装(推荐)¶
执行下面命令,从 GitHub 安装插件:
dsh plugin --profile web add github:az790871109/dsh-summary-sidebar
安装后,在 $DSH_HOME/profiles/web/cordis.patch.yml 中追加 insert 条目,使 web profile 组合该插件:
- insert:
- id: summary-sidebar
name: dsh-summary-sidebar
本地安装¶
如果本地已有插件目录,可以用 file: 方式安装:
dsh plugin --profile web add file:/path/to/dsh-summary-sidebar
也可以直接把插件目录复制到 node_modules:
cp -R /path/to/dsh-summary-sidebar "$DSH_HOME/profiles/web/node_modules/dsh-summary-sidebar"
重启 web profile 并硬刷新浏览器:
dsh web
卸载¶
执行下面命令卸载插件:
dsh plugin --profile web remove dsh-summary-sidebar
也可以手动删除 $DSH_HOME/profiles/web/cordis.patch.yml 中的 insert 条目,以及 node_modules/dsh-summary-sidebar 目录。
典型用法¶
启用后,从会话头部右上角开始操作:
1、点击「摘要」,查看当前对话涉及并输出的文档、网页、图片。
2、点击摘要中的文件、链接或图片,侧边栏会自动切换到对应工具:文件用于预览/编辑,链接用于浏览器加载,图片用于图片阅读器查看。
3、点击「侧边栏」,直接打开文件夹、终端、浏览器、文档阅读器、图片阅读器。
在侧边栏中:
- 文件夹里可以浏览工作区文件,执行新建文件、新建文件夹、打开、重命名、删除等操作。
- 终端中可以执行命令、发送
Ctrl+C、清空或重启终端。 - 浏览器中可输入地址,预览工作区 HTML 或外部网址;外部网址受站点自身
X-Frame-Options/ CSP 限制,插件会做 iframe 内嵌检测,并提供新标签页打开。 - 文档阅读器中可以打开文本文件进行阅读与编辑,并保存回工作区。
- 图片阅读器中可查看
png/jpg/gif/webp/svg等工作区图片。
适用场景与注意¶
适合在 dsh web profile 中使用,需要把对话产物和工作区工具集中起来的场景,例如:
- 长对话后快速回顾当前会话涉及并输出的文件、网页、图片;
- 在浏览器中直接查看工作区 HTML、文本文件、图片;
- 在侧边栏中维护工作区文件,并在独立 PTY 终端中执行命令。
使用插件前注意以下事项:
1、插件以当前 dsh 进程权限运行;安装前应检查源码、许可证和来源。
2、终端、文件、浏览器能力依赖宿主端 /sbs JSON API,包括文件列表/读写/新建/重命名/删除、终端流、/sbs/frame-check 帧检测;请确保插件安装在 web profile。
3、插件宿主端不注册模型侧工具。
4、摘要来源来自当前会话的工具调用与结果文本;bash 等命令中的文件路径仅做保守提取。
5、外部网址预览受站点自身 X-Frame-Options / CSP 限制;插件已做 iframe 内嵌检测与新标签页打开处理。
6、终端依赖 node-pty,请确保 web profile 运行环境中可用。
获取¶
GitHub 仓库:
https://github.com/az790871109/dsh-summary-sidebar
DSH 社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。具体目录页请以当前 DSH 社区入口或本地插件目录查询结果为准。