前言¶
在开发 DeepSeek Harness(DSH)智能体或使用 Web 界面时,助手经常会生成包含代码、表格或引用的 HTML 方案。这些内容如果散落在对话流中,难以管理和查看。我们需要一种方式,将结构化的方案持久化存储,并以可交互的方式展示在对话右侧。
dsh-soln-panel 插件通过在对话右侧提供一个可展开/收缩的抽屉面板,解决了这一问题。它支持多标签页切换、宽度拖拽调整以及未读提示,并且能根据工作区独立存储方案数据。
插件介绍¶
- 名称:dsh-soln-panel
- 功能定位:对话右侧方案面板,支持 HTML 方案展示、多标签页、宽度拖拽、未读提示、按工作区持久化。
- 维护者:PastSheep
- 许可:MIT
- 类别:客户端
核心功能¶
- HTML 方案展示:支持渲染 HTML 内容,表格、代码块、引用等样式均能原样显示。
- 多标签页:支持多个方案并存,以浏览器式标签切换,标签过多时自动压缩并支持滚动。
- 宽度拖拽:面板宽度支持从 280px 到 900px 的动态调整。
- 未读提示:当方案更新且未被查看时,对应标签变为橙色,点击后清除未读状态。
- 按工作区持久化:数据存储在当前工作区的指定目录,重启后保留,跨会话可见,且严格隔离不同工作区。
- 免构建:插件代码直接可用,无需构建步骤。
安装与启用¶
- 在终端执行以下命令安装插件:
dsh plugin --profile web add "github:PastSheep/dsh-soln-panel#main"
- 安装完成后重启 DeepSeek Harness。
- 在会话界面右侧会出现“方案”标签,点击即可展开面板。
如需卸载,请执行:
dsh plugin --profile web remove dsh-soln-panel
典型用法¶
插件通过宿主级注册的工具 show_solution 推送方案。调用该工具时,可通过参数控制方案的追加、更新、展开及清空。
工具参数说明¶
| 参数 | 说明 |
|---|---|
id |
方案 ID。提供此参数时为更新方案,省略时为追加新方案。 |
title |
方案标题。更新时可省略,保留原值。 |
html |
方案 HTML 内容。更新时可省略,保留原值。 |
activate |
是否跳转至该方案标签。追加时默认为 true,更新时默认为 false。 |
openPanel |
是否展开面板。省略时保持当前状态。 |
clear |
清空当前工作区全部方案并收起面板。 |
调用逻辑¶
- 追加方案:不提供
id,activate默认为true(自动跳转)。 - 更新方案:提供
id,activate默认为false(不跳转),title和html可选择性提供。 - 清空方案:调用时参数
clear设为true。
每次调用后,工具会返回当前工作区所有方案的摘要信息(包含 id、标题和未读状态)。
数据与隔离¶
- 数据文件位置:
<工作区>/.dsh/soln-panel.json。 - 隔离机制:插件根据当前会话的工作区信息读取对应的方案池。若当前会话没有工作区信息,则返回空池,不会发生跨工作区数据泄漏。
适用场景与注意¶
该插件适合需要向用户展示结构化 HTML 内容的场景,例如生成文档、代码片段列表或复杂的表格数据。
注意:作为第三方插件,安装前建议检查其源码与许可证。插件依赖 DSH 宿主环境的特定 API 版本(如 @deepseek-ai/dsh-tools 等)。
结语¶
dsh-soln-panel 为 DSH 提供了一个轻量级、免构建的方案管理解决方案。通过持久化和交互式面板,它能够显著提升助手生成内容的可用性。更多详情可查阅插件目录或源码仓库。