前言¶

DeepSeek Harness（dsh）对话窗口通常以纯文本形式展示代码块，缺乏直观的渲染结果。dsh-viewer-kit 是一个给 dsh 用的可插拔内容渲染层，它让代码块除了显示源码外，还能一键切换为渲染结果，例如 HTML 预览、图表或表格。

功能概览¶

该插件提供了一套渲染器，支持多种格式的切换。

1. 代码与预览切换

   • html / svg：支持预览与源码切换。
   • echarts：支持图表与源码切换。

2. 表格渲染

   • csv / tsv：支持表格与源码切换。
   • json：支持表格与源码切换。
   • markdown：支持管道表渲染与源码切换。

3. 原型模式工具

   • 提供 apply_prototype_style 工具，用于注入 HTML 风格规范。

4. 配置项

   • 支持通过配置项自定义渲染行为，例如控制脚本执行权限和替换原型风格规范。

安装¶

使用官方插件安装命令，将插件添加到当前环境中。

dsh plugin add file:E:\path\to\dsh-viewer-kit

典型用法¶

安装并重启 profile 后，可以通过以下方式使用插件功能。

1. 使用原型工具
   在对话中触发模型调用 apply_prototype_style 工具，以注入 HTML 风格规范。

2. 使用围栏进行渲染

   • 使用 html 围栏进行沙箱渲染。
   • 使用 echarts 围栏渲染图表。

3. 配置脚本权限
   在 cordis.patch.yml 中配置 htmlAllowScripts: true，以允许预览中的 HTML 执行脚本。

注意事项¶

1. 依赖版本
   该插件依赖 DSH Desktop 0.2.0-rc.2。

2. 强耦合
   插件强耦合 DSH 内部 DOM，版本升级可能导致失效。

3. 版本状态
   当前版本号小于 1.0，配置键不保证稳定。

4. 渲染限制
   表格渲染有行数和列数上限（500 行 × 40 列）。

5. 安全提示
   开启 htmlAllowScripts 后，仅渲染内容本身可能发起网络请求。