dsh-visualizer

DSH PLUGINUI 与外观

仓库 Moses14159/dsh-visualizer · npm dsh-visualizer

UI 与外观 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH plugin 让模型在对话中实时渲染可视化内容,支持结构化图表(echarts)与流式 SVG/HTML 组件,安全隔离且不修改 DSH 源码。

一句话选型结论

按资料字段整理

dsh-visualizer 是UI 与外观类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类UI 与外观 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 7 复刻 0 · 未关闭 issue 0
最近更新 2026-08-23 创建于 2026-08-22
README 11.6 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add dsh-visualizer@0.3.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2 等 13 个,Node.js 要求 >=20;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2 等 13 个版本版本不匹配时安装会报错
Node.js 要求>=20来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/cordis@^4.0.1、@deepseek-ai/dsh-client-runtime@^0.1.0-rc.8 等 8 个需要同时安装的同级依赖
npm 包名dsh-visualizer可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-visualizer:DeepSeek Harness 的对话内可视化渲染插件

  • 结构化图表渲染
  • 流式 SVG/HTML 组件
  • 双向校验防漂移
  • 沙箱隔离安全执行
  • 优雅降级不报错

上游标签

dsh-plugindsh-plugins

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度稳定按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2 等 13 个),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在UI 与外观场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-visualizer当前 L5 · 运行验证通过 低风险 7 0.2.0-rc.2 等 13 个 有
nuwa-skill 未做沙盒验证 未标注 3.8 万 未标注 有
awesome-dsh-plugin L4 · 沙盒安装通过 低风险 1.8 万 0.1.1-rc.2 有
deepseek-balance-whale-widget L4 · 沙盒安装通过 低风险 4,492 0.1.7-rc.2 等 2 个 有
dsh-better-sidebar L4 · 沙盒安装通过 低风险 4,112 0.1.7-rc.2 等 10 个 有
dsh-deep-whale L4 · 沙盒安装通过 低风险 2,470 未标注 有

仓库档案

UI 与外观
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Moses14159仓库 dsh-visualizer · 默认分支 main
分类UI 与外观skin
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue7 / 0 / 0收录时的数值,非实时
创建 / 更新2026-08-22 · 2026-08-23最后推送 2026-08-23
本站收录2026-08-23首次进入本站目录的时间

README 全文

11.6 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-visualizer

English · 简体中文

> 一个不改动 DSH 源码的外部插件:让模型在对话流里边生成边渲染可视化内容——流式 SVG/HTML 组件,以及结构化图表(ChartSpec → echarts)。





这是什么

在 DSH(DeepSeek Harness)的对话里,让模型直接生成可视内容,安全地渲染到对话流中:

  • 结构化图表——visualize 工具的 spec,用 echarts 渲染(折线 / 柱状 / 面积 / 饼图 / 散点)。
  • SVG / HTML 组件——模型写了 svg /html 围栏,逐 token 流式渲染到沙箱 iframe;也可用 visualize 的 widget 参数整件交付。

它复用 DSH 已有的 assistant/chunk 与 tool/call + tool/result 事件,不改 DSH 源码。

特性

  • 两类产物、三条交付路径:visualize(spec) 出图表;正文 svg /html 围栏流式出组件;visualize(widget) 出完整组件。
  • 流式渲染:复用已有 assistant/chunk 事件拿到逐 token 输出,组件随文本流逐帧更新。
  • 双端校验:host execute 与客户端折叠共用同一套纯函数解析器(chartspec / widget),模型漂移不会静默通过。
  • 安全隔离:组件代码原样插入 sandbox="" iframe + CSP default-src 'none',无 sanitizer 可绕过。
  • 渲染体验:图表主题采样 --dsw-alias-* 令牌;SVG 按固有宽高比自适应高度;卡片带「适应 / 1.5× / 2×」缩放与状态徽标(生成中 / 已截断 / 完成)。
  • 优雅降级:任何校验 / 渲染失败都不留空白、不抛错——退回普通代码块或 JSON 卡。
  • 纯函数、可测试:核心逻辑均为无 DSH 依赖的纯模块,97 个单测在 Node 里独立跑。

效果一览

真实对话截图(DSH Web 客户端内渲染):

结构化图表 · visualize(spec) → echarts(主题跟随 DSH)

组件 · visualize(widget) → 沙箱 iframe

更多渲染示例(由插件自身代码渲染生成):

左:柱状图 · 右:SVG 组件 · 下左:HTML 组件 · 下右:流式渲染(```svg 围栏逐 token 边生成边更新)

安装

从 GitHub 直接安装(推荐,构建产物已入库):

dsh plugin --profile web add github:Moses14159/dsh-visualizer

也可以先克隆、再从本地路径安装:

git clone https://github.com/Moses14159/dsh-visualizer.git
dsh plugin --profile web add /path/to/dsh-visualizer

> - 从 Git 安装的插件会在安装时通过 prepare 脚本构建。pnpm 为安全起见会拦截构建脚本,若它提示授权,把对应的 allowBuilds 键加到 profile 的 pnpm-workspace.yaml 后再执行即可。
> - 待 dsh-visualizer 发布到 npm 后,也可以用裸名安装:dsh plugin --profile web add dsh-visualizer。
> - 需要本机已安装 DSH(deepseek-harness)并能启动 dsh web。依赖 DSH 的 @deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-tools(见 peerDependencies)。

用法

安装后,在对话里告诉模型即可:

  • 说「用 visualize 画个图」→ 模型调用 visualize 工具传 spec;
  • 说「写一个 SVG 徽章 / HTML 组件」→ 模型在正文直接流式输出 svg /html 围栏,生成过程中即可看到逐帧渲染;
  • 模型也可用 visualize 传 widget 参数整件交付(经 host 校验、持久化、可重放)。

工具载荷

visualize 二选一:

// 结构化图表
{ "spec": {
"kind": "bar",                    // bar | line | area | pie | scatter
"title": "深圳 · 未来 7 天气温",
"xAxis": ["周六", "周日", "周一", "周二", "周三", "周四", "周五"],
"yName": "°C",
"series": [{ "name": "最高温", "data": [32, 32, 30, 31, 29, 31, 32] }]
} }
// SVG / HTML 组件
{ "widget": { "kind": "svg", "code": "…", "title": "卡片标题" } }

流式围栏

```svg
…逐 token 边生成边渲染…
```

示例

在对话里直接这样说,就能看到效果(这些图取自真实对话)。

生成一张天气卡片

> 帮我生成一张深圳现在的天气卡片

模型会调用 visualize 传 widget(HTML),渲染成沙箱组件卡片:

visualize(widget) · 沙箱 iframe 渲染的 HTML 卡片

画一个折线图

> 用 visualize 画一张北京明天 24 小时的气温变化图

模型会传 spec(line),用 echarts 渲染:

visualize(spec) · echarts 渲染(主题跟随 DSH)

边生成边渲染(流式)

> 写一个深圳实时天气的 SVG 卡片

模型会在正文写 ```svg 围栏,边生成边渲染:

正文 ```svg 围栏 · 逐 token 流式渲染

一次要多种

> 同时画一张柱状图、一张饼图,再写一个天气卡片

模型会多次调用 visualize,分别产出图表与组件,在对话流里排开。

> 💡 提示:以上示例要求模型已加载 visualize 工具(安装插件后即注册)。若模型没有主动用该工具,直接描述你想要的内容即可,它会优先调用 visualize。

架构

两条交付路径

产物 触发 会话事件 折叠 渲染
结构化图表 visualize(spec) tool/call + tool/result visualizer-chart echarts
组件(整件交付) visualize(widget) tool/call + tool/result visualizer-widget 沙箱 iframe
组件(流式) 正文 svg /html assistant/chunk visualizer-widget(逐帧更新) 沙箱 iframe

为什么这个形态可行(源码级事实)

  • assistant/chunk 是已存在的会话事件家族:agent-loop 把每个 StreamChunk 落盘为 { turn, step, chunk },Web 客户端的流式文本正是折叠这些事件得来的——插件复用同一事件流即可拿到逐 token 输出,无需新增 host 侧事件家族。
  • conversationEvents 是 cordis Service,外部插件可 inject;visualizer-widget 与内置 assistant-step 并行折叠同一批 assistant/chunk 事件,互不干扰。
  • conversation.chat.node 是 keyed slot(replaceRisk: 'none'),外部插件按字符串名注册 { key: 'visualizer-chart' | 'visualizer-widget' } 即增量贡献。
  • ChatNodeViewProps / ConversationNodeDefinition / ChatNodeDataMap 都是纯类型,构建期擦除,不触发客户端 bundle 的纯度门。
  • 确定性:match 只读当前事件;同一 Context 每个事件携带或独立推导同一稳定 id(step:: / widget:);update 按日志 seq 折叠,可重放。

安全边界

层 处理
模型 → spec / widget host execute 用 parseChartSpec / parseWidgetSpec 校验;非法载荷拒绝执行(工具报错)
正文流 → widget 客户端 WidgetScanner 只认行首 svg /html 围栏;组件代码不做标记校验(流式中任意字节都可能是合法前缀),安全边界在渲染侧
session log → 客户端 Definition 的 update/fallback 对结果文本再次解析;assistant/message 全文是冷回放的恢复源
渲染(组件) 双层隔离:iframe sandbox=""(禁脚本/同源/表单/弹窗/导航,opaque origin)+ srcdoc 注入 CSP default-src 'none';代码原样插入,无 sanitizer 可绕过
渲染(图表) ChartSpec 是纯数据 → echarts setOption;无 HTML/SVG 注入面

任何校验 / 渲染失败都降级(不渲染该节点 / 围栏仍以普通代码块显示 / JSON 卡),绝不让对话流出现空白行或抛错中断。

载荷上限

  • 图表:≤ 8 个 series、≤ 500 个点、标签 ≤ 120 字符;
  • 组件:单件 ≤ 128 KB(UTF-8)、每节点 ≤ 12 件 / 总计 ≤ 512 KB,超限截断或省略并显示「已截断」徽标。

开发

pnpm install
pnpm test        # 纯函数单测(97 用例)
pnpm typecheck   # tsc --noEmit
pnpm build       # tsdown:host + replay + 两渠道 client bundle
pnpm render-demo # 重新生成 docs/ 里的演示图(需本机 Chrome)
  • 纯函数模块(chartspec / widget / to-echarts / to-iframe / svg-geometry / 两个 fold)不 import DSH、不触达 DOM,因此能在 Node 里独立测试。
  • 客户端聚合入口是 src/client/index.tsx;host 工具入口是 src/index.ts。

已知边界

  • 图表仍是「整图出现」:ChartSpec 经工具调用交付,没有逐 token 流式图表(工具参数本身不是流式的);围栏组件才是流式路径。
  • 围栏原文与组件卡并存:模型写出的代码块仍会按普通 markdown 代码块渲染(作为「源码」视图),组件卡在流中增量渲染——两者不互斥。
  • 组件是静态的:sandbox 禁脚本,交互式组件(按钮逻辑、动画脚本)不会执行;需要交互时请用图表或让组件纯展示。
  • 不包含 mermaid:v1 只支持 svg/html 两种围栏,mermaid 图请走普通代码块或后续版本。
  • 围栏必须在行首(≤ 3 空格缩进),行内 svg 不是围栏;围栏内容里的 单独成行会闭合围栏(CommonMark 语义)。
  • echarts 按需 import('echarts') 内联进客户端 bundle(registry 路由只服务单文件,暂不能 code-split)。

兼容性

  • Node:>= 20;DSH:通过外部插件机制加载(profile bundle patch)。
  • peer 依赖:@deepseek-ai/cordis、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-conversation、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-tools、react、react-dom。

许可

MIT · Copyright (c) 2026 Moses14159

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-visualizer 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add dsh-visualizer@0.3.0` 即可。对应的 npm 包名是 `dsh-visualizer`。

dsh-visualizer 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-visualizer 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-visualizer 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-visualizer 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1、0.1.7-alpha.2、0.1.6-alpha.2、0.1.6-alpha.1、0.1.5-rc.2。版本较多,只列出前 8 个。

dsh-visualizer 需要什么运行环境?

Node.js >=20;需要同时安装 @deepseek-ai/cordis@^4.0.1、@deepseek-ai/dsh-client-runtime@^0.1.0-rc.8、@deepseek-ai/dsh-client-ui-conversation@^0.1.0-rc.8、@deepseek-ai/dsh-llm@^0.1.0-rc.8、@deepseek-ai/dsh-tools@^0.1.0-rc.8。环境不满足时安装会失败,建议先确认本机版本。

dsh-visualizer 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-visualizer 有哪些功能?

结构化图表渲染、流式 SVG/HTML 组件、双向校验防漂移、沙箱隔离安全执行、优雅降级不报错。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

2 条
不同作者的仓库分开列,请确认你要装的是哪一个
UI 与外观
按星标排序,可作替代方案

nuwa-skill

nuwa-skill

女娲 DSH plugin 只需输入一个名字,就自动调研、提炼并验证任何人的心智模型、决策启发式与表达 DNA,生成可直接调用的思维视角 S

未标注验证等级 3.8 万 星

awesome-dsh-plugin

awesome-dsh-plugin

A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harnes

L4 · 沙盒安装通过 1.8 万 星

deepseek-balance-whale-widget

DeepSeek-Balance-Whale-Widget

DSH 界面右下角的常驻小鲸鱼余额挂件,实时显示 DeepSeek 账户余额、今日已用与每轮对话消耗,支持拖拽吸附、Q 弹动画与音效,开箱即

L4 · 沙盒安装通过 4,492 星

dsh-better-sidebar

DSH-better-sidebar

面向 DeepSeek Harness 的服务化侧边栏工作台插件,把文件编辑、终端、Git 变更、子代理任务与侧边对话整合进右侧栏与底部面板

L4 · 沙盒安装通过 4,112 星

dsh-deep-whale

dsh-deep-whale

DSH Web 鲸鱼娘皮肤系列(深海女仆工坊 maid-atelier)。

L4 · 沙盒安装通过 2,470 星

deepseek-design

deepseek-design

可视化设计工作室,支持网站、App 原型、海报、信息卡、报告和杂志的模板创建、元素编辑、选区级 AI 草稿衔接与导出。

L4 · 沙盒安装通过 1,438 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。