前言¶

在 DSH 中使用 Agent 时，一次任务可能同时产出报告、图表、图片、PDF 和数据文件。若这些结果只散落在工作区目录或工具记录里，检查、对比和分享都不够直接。DSH Right Sidebar 为 DSH Web 增加一个右侧产物工作区，让 Agent 在会话中生成的交付物留在对话旁边。

这是什么¶

DSH Right Sidebar 是 Limitinfinitude 维护的 DSH 插件，许可证为 MIT。它为 DeepSeek Harness 提供原生右侧产物工作区，把报告、图表、图片、数据和文档等结果集中到会话旁边；源码、配置等项目内部文件仍由 DSH 工作区负责。

下面介绍它的核心能力、安装方式和典型用法。

核心能力¶

会话绑定的产物栏¶

• 常驻右侧入口，可自动展开，也可手动收起和恢复。
• 产物与会话绑定；切换会话时同步切换标签、排序和关闭状态。
• Agent 更新同一路径的产物后，当前预览自动刷新。
• 顶部堆叠标签支持关闭和拖拽重排，狭窄侧栏仍保留可读文件名。
• 底部“本会话产物”目录可重新打开已关闭的结果，超过七项时独立滚动。

支持读取的文件¶

插件支持 Agent 明确输出的 HTTP(S) 文件 URL，以及工作区内唯一匹配的不完整文件路径。

自动产物包括：

• Markdown
• MDX
• PDF
• SVG
• PNG
• JPEG
• WebP
• GIF
• AVIF
• BMP

按需产物包括：

• TXT
• JSON
• JSONL
• CSV
• TSV

按需产物仅在 Agent 回复中明确提到文件路径或名称时显示。

不展示的文件包括：

• 源码
• HTML/HTM
• 配置
• 日志
• YAML
• TOML
• XML
• INI
• CONF 等项目内部文件

预览与操作¶

• Markdown 可直接在渲染内容上编辑，并在停止输入后静默保存。
• 支持复制路径、复制内容、下载、打开所在目录、置顶与隐藏。
• JSON/JSONL 支持可折叠结构树、搜索、全部展开/收起、格式化原文及错误行提示。
• CSV/TSV 支持筛选、数值/文本排序、分页和列宽调整，并正确处理引号与多行字段。
• TXT 支持行号、全文搜索、匹配计数、自动换行，大文件按 250 行分页。
• 图片/SVG 支持适应窗口、原始尺寸、缩放、拖拽平移、尺寸信息和透明背景棋盘格。
• PDF 使用浏览器内置 PDF 阅读器，并提供刷新和外部打开。

安装与启用¶

DSH Right Sidebar 需要 DSH Web 提供会话级 details.overlay 插槽和具名详情栏 API。先确认当前环境是 DSH Web，再在仓库目录中执行安装命令。

下面命令会克隆仓库、安装依赖、构建插件，并把当前目录添加到 DSH Web profile：

git clone https://github.com/Limitinfinitude/DSH-Right-Sidebar.git
cd DSH-Right-Sidebar
npm install
npm run build
dsh plugin --profile web add .

经过上面的步骤后，刷新 DSH Web 会话。

运行要求¶

插件会在 DSH 客户端环境中运行，并访问工作区文件、产物内容或网络产物。使用上需要注意以下配置声明：

• package.json 声明 peerDependencies: @deepseek-ai/cordis ^4.0.1。
• package.json 声明 dsh.client.platform 为 web。
• package.json 声明注入以下客户端包：
• @deepseek-ai/dsh-client-runtime
• @deepseek-ai/dsh-client-locale
• @deepseek-ai/dsh-client-connection
• @deepseek-ai/dsh-client-ui-layout

典型用法¶

1. 让 DSH 生成报告、图表、图片、PDF 或数据文件。
2. Markdown、PDF、SVG 和图片等富预览产物出现时，右侧栏自动展开并打开最新产物。
3. TXT、JSON 和 CSV 等数据文件只在 Agent 明确提到时进入产物列表，且不会抢占当前富预览。
4. 使用标签在不同产物之间切换；关闭后可从底部目录重新打开。
5. 需要源码或项目文件时，使用“打开所在目录”回到 DSH 工作区。

性能与安全¶

侧栏空闲时不轮询文件或端口。产物内容只在用户选中后读取，复杂预览按需初始化。JSON 搜索只遍历数据一次，表格限制为最多 10,000 行，TXT 分页渲染。浏览器端包体积约为 185 KB gzip。

工作区内文件会校验路径。工作区外产物通过 DSH 同源授权后限时访问，外部授权根目录最多保留 256 个，6 小时后过期。Markdown 和 SVG 在渲染前净化，二进制文件保持只读，HTML/HTM 源文件不会嵌入到 Dock。

网络产物必须由同源 DSH 页面先授权，再通过无 Cookie、无认证头的受限代理读取；仅允许受支持的文件扩展名，单个响应上限 16 MB，10 秒超时。不完整路径仅在已注册工作区中有唯一匹配时解析，遇到多个同名文件会拒绝猜测。

适合谁¶

适合在 DSH Web 中使用 Agent 生成文档、图表、图片和数据文件，并希望把交付物集中在会话旁边查看的开发者。由于插件以当前 dsh 进程权限运行，安装前应检查源码与 MIT 许可证。

结尾¶

DSH Right Sidebar 的价值在于把会话产物从工作区和工具记录中收拢到一个稳定的右侧位置：富预览自动出现，数据文件按需进入列表，关闭后可以重新打开，源码仍回到 DSH 工作区处理。

• 仓库：https://github.com/Limitinfinitude/DSH-Right-Sidebar
• 目录页：https://www.skillhub.cn/plugins/Limitinfinitude/DSH-Right-Sidebar