dsh-visualize
在 DSH 对话中生成交互式可视化|Render model-generated interactive cards inside DSH conversations
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Nagi-ovo/dsh-visualize with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Nagi-ovo/dsh-visualize'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/nagi-ovo--dsh-visualize)HTML
<a href="/listings/nagi-ovo--dsh-visualize"><img src="/api/listings/nagi-ovo--dsh-visualize/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
推荐用 npm 装到 DSH 的 `web` profile:
dsh plugin --profile web add @nagi-ovo/dsh-visualize # 如果 dsh web 正在运行,重启后刷新页面
也可以从 GitHub 安装:`dsh plugin --profile web add github:Nagi-ovo/dsh-visualize`。可以运行 `dsh --profile web --dump-config` 确认插件已经进入最终配置。需要修改源码时,克隆仓库并在仓库目录运行 `dsh plugin --profile web add .`;构建产物已经提交,不需要额外构建。使用社区 [plugin-registry](https://github.com/dsh-external/plugin-registry) 的用户也可以从「设置 → 插件」安装。
兼容 DSH 0.1.1-rc.2 到 0.2.0-rc.2。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 105 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # dsh-visualize
- 
- <p align="center">
- <strong>简体中文</strong> | <a href="README.en.md">English</a>
- </p>
- <p align="center">
- <a href="https://dshfind.com/zh/plugins/Nagi-ovo/dsh-visualize?ref=badge"><img src="https://dshfind.com/api/card/Nagi-ovo/dsh-visualize?lang=zh" alt="dsh-visualize 在 dshfind 插件目录上的展示卡" width="440"></a>
- </p>
- 让 DSH 不只回答一段文字。模型调用 `visualize` 后,Web UI 会在对话里直接出现一张可交互卡片,用来做模拟器、图表、对比面板或 UI mockup。
- <div align="center">
- [](assets/demo.mp4)
- </div>
- ## 安装
- **桌面端**:打开侧边栏的「插件」→「添加插件」,填入 `@nagi-ovo/dsh-visualize`,然后重启 DSH。也可以运行 `dsh plugin --profile desktop add @nagi-ovo/dsh-visualize`。
- 已知问题:桌面端点「在新窗口打开」没有反应,页面卡片的「打开页面」也一样,请点「在对话中展开」查看。
- **Web**:用 npm 装到 `web` profile:
- ```sh
- dsh plugin --profile web add @nagi-ovo/dsh-visualize
- # 如果 dsh web 正在运行,重启后刷新页面
- ```
- 也可以从 GitHub 安装:`dsh plugin --profile web add github:Nagi-ovo/dsh-visualize`。可以运行 `dsh --profile web --dump-config` 确认插件已经进入最终配置。需要修改源码时,克隆仓库并在仓库目录运行 `dsh plugin --profile web add .`;构建产物已经提交,不需要额外构建。使用社区 [plugin-registry](https://github.com/dsh-external/plugin-registry) 的用户也可以从「设置 → 插件」安装。
- 兼容 DSH 0.1.1-rc.2 到 0.2.2-rc.3。
- ## 怎么用
- 直接告诉模型你想看什么,例如「做一个能调参数的排序算法可视化」。模型调用 `visualize`,把整段 HTML fragment 直接作为 `fragment` 参数传入(可选 `title`、`mode`),卡片在模型生成参数时就开始渲染。适合并排比较的内容可以使用 `mode: "wide"`。要修正已经画出的卡片,模型用 `action: "update"` 加上卡片的 `path` 和一处 `old_str` → `new_str` 替换,不必重发整段 markup;`path` 只用于 `update`。
- 要做的东西比一张聊天卡片大时,比如带筛选的数据看板、多视图工具、全屏模拟或完整的桌面端 mockup,模型会用 `mode: "page"` 做一个独立页面。对话里显示一张启动卡片:标题、一行说明(`summary` 参数)、页面的实时缩略图和「打开页面」按钮,点按钮后页面在新标签页里全尺寸打开。浏览器拦下新标签页时,可以点「在对话中展开」直接在对话里查看。用 `update` 改过页面后,已经打开的标签页不会自动刷新,再点一次「打开页面」即可。
- 卡片会跟随 DSH 的明暗主题,默认风格使用鲸鱼蓝配色(其他风格见下文)。聊天栏放不下时,点卡片标题行右侧的「在新窗口打开」按钮,可以在新标签页里全尺寸查看,页面沿用打开那一刻的主题,内容仍在同样的 sandboxed iframe 里运行。会话重放时,页面从持久化的工具结果恢复,不依赖原始 fragment 文件仍然存在。
- 每张卡片的 fragment 另存一份到 `~/.dsh/visualize/sessions/<会话 id>/<标题>-<hash>.<style>.html`(设置了 `DSH_HOME` 时在 `$DSH_HOME/visualize/` 下),按会话分开,不写进你的项目目录,`git status` 不会出现 `viz/`。`update` 改写的就是这份文件。旧版本写在工作区 `viz/` 下的卡片仍然可以 `update`,原地修改。插件不会自动清理这些文件,需要时可以直接删除 `~/.dsh/visualize/`,已有会话的卡片照常重放。
- 卡片也能显示它自己加载不了的图片:agent 刚存进工作区的图(matplotlib 画的 PNG、论文里的 figure),或者任意公开的网络图片。模型写 `<img data-viz-src="figs/loss.png">` 或 `<img data-viz-src="https://…">`,调用执行时插件读取文件或下载图片,确认内容确实是 PNG、JPEG、GIF、WebP 或 SVG(单张不超过 5 MB,每张卡片合计不超过 12 MB、最多 16 张),然后存到卡片旁边的 `~/.dsh/visualize/sessions/<会话 id>/images/`。卡片渲染时从那里取图,所以模型的上下文和会话日志里都没有图片字节,日志里每张图只记一条很短的引用。某张图失败时,卡片在原位显示一个带 alt 文字的占位框,其余部分照常渲染;工具结果会告诉模型哪张图失败、原因是什么,方便它改路径。用 `update` 改卡片时,已经下载过的网络图片直接复用,工作区文件重新读取,所以重新生成的图在下一次修改后就会显示出来。这项功能需要 DSH 0.1.7 及以上;更早的版本里卡片只显示占位框,工具结果会说明原因。
- DSH 默认会把已完成回合的工具过程折叠起来。折叠时,这一轮画出的卡片会再显示在最终回答下方,不用展开过程也能看到;「工作步骤展示」选「完全展开」时则只在原位显示。
- 卡片可以把内容交回对话。测验、选项、表单这类卡片在你点下按钮后,会把一句话(比如「我选了 B,帮我解释为什么 A 不对」)填进输入框。消息不会自动发出,你可以改完再发,也可以不发。改选另一个选项时,新的话会替换卡片刚才写进去的那句;输入框里有你自己写或改过的内容时,卡片不会覆盖它,只会弹出一条提示。这项功能需要 DSH 0.1.7 及以上;在新窗口打开的卡片不支持,卡片会隐藏这类按钮。
- 卡片会记住你在里面做的选择:拖过的滑块、勾选的选项、填写的文字、选中的标签页,以及模型用 `dshViz.state` 保存的其他选择(比如选中的节点、当前步骤)。刷新页面、重新打开会话、模型用 `update` 修改卡片之后,卡片都会恢复成你离开时的样子;重新画的新卡片从默认值开始。状态只存在这个浏览器里,放在 DSH 页面的 localStorage 中(键名以 `dsh-visualize:state:` 开头),按会话和卡片分开,不会上传,也不会同步到别的设备或浏览器;换一个端口打开 DSH 也算另一个站点。每张卡片最多 16 KB,所有卡片合计最多 256 KB,超出时最久没改动的卡片先被清掉。想全部清空,在浏览器开发者工具的 Application → Local Storage 里删掉这些键,或者清除这个站点的数据。页面卡片的缩略图和在新窗口打开的卡片会显示已保存的状态,但新窗口里的改动不会保存。浏览器禁止存储时(例如某些隐私模式),状态只在当前页面里保留:切换主题、修改卡片不会丢,刷新后就没了。
- 模型有时会在卡片还没真正交到你手上时就结束回答:最后一次 `visualize` 调用失败了却没有重试;卡片画出来了,但还带着会让它坏掉的 lint 警告(脚本查找不存在的元素 id、沙箱里加载不到的相对 URL);把 HTML/SVG 当代码块贴进了回答;或者说了「我来画一张卡片」就停下了。遇到这些情况,插件会在这一轮结束前给模型发一句简短的提醒(steer),让它在同一轮里接着修好或补上调用。判断偏保守:你要的就是 HTML 代码或文件、这一轮写了项目文件、回合被你中断或出错时都不会提醒;颜色写死这类只影响风格的警告不算;每轮最多提醒 2 次,同一个问题只提醒一次。不需要的话,在 `cordis.patch.yml` 里这个插件的 `config` 下加 `selfRepair: false`。
- ## 卡片风格
- 插件内置 5 种卡片风格,默认是 `whale`。在 DSH 里点左下角「更多」→「设置」→「可视化」,每种风格都有一张按当前明暗主题实时渲染的预览卡,点一下就保存,下一张卡片立即生效,不用重启。
- 这个页面需要 DSH 0.1.7 及以上(宿主的设置表单 `configForms` 和 `/api` 路由;0.1.7 里「设置」在侧边栏左下角)。更早的版本里页面要么不出现,要么只给出下面的写法,请直接在 `<DSH_HOME>/profiles/web/cordis.patch.yml`(默认 `~/.dsh/profiles/web/cordis.patch.yml`)里加:
- ```yaml
- - id: dsh-visualize
- name: "@nagi-ovo/dsh-visualize"
- config:
- style: sketch
- ```
- 设置页保存的也是这一条:它通过宿主的 dsh-settings 写进同一个 `cordis.patch.yml`,保留文件里的其他条目和注释。
- | `style` | 风格 | 适合 |
- | --- | --- | --- |
- | `whale` | 鲸蓝(默认):跟 DSH 界面同一套颜色和系统字体 | 什么都行 |
- | `editorial` | 报刊:衬线标题直接写结论,一条线高亮、其余退成灰,直接标注 | 趋势、比较、「这个数说明了什么」 |
- | `paper` | 论文:衬线、L 形坐标轴、色盲安全配色,颜色加标记形状双重编码,「图 1 ·」图注 | 实验结果、学习曲线、带公式的讲解 |
- | `sketch` | 手绘:手写字体、rough.js 草图线条、荧光笔标注 | 概念、直觉、流程 |
- | `terminal` | 终端:等宽字体、直角、虚线网格、key–value 标签 | 延迟、吞吐、算法逐步执行 |
- 风格分两层。颜色、字体、圆角、图表默认值(网格、轴线、线宽)由卡片外壳注入,每种风格都同时适配明暗主题,背景保持透明;版式和写法(标题怎么写、要不要图注、用不用 rough.js)是一段风格说明,附加在 skill 末尾交给模型。风格说明只替换 `design.md` 里的审美建议,fragment 规则、CSP、主题变量、11px 下限和 lint 都不受影响。产品界面 mockup 不套用风格,按被画产品自己的样子来。
- 每张卡片在持久化的结果和副本文件名里记下它生成时的风格,之后改设置不会改变已有卡片,会话重放、「在新窗口打开」和模型用 `update` 修改时都保持原样。有风格之前保存的卡片文件名里没有风格,`update` 时按当前设置重新渲染。模型还在写卡片时显示的预览,在 DSH 页面加载时读取设置;在设置页里切换会同时更新当前页面,手改 YAML 后刷新已打开的页面即可。`editorial`、`paper`、`sketch`、`terminal` 会从 Google Fonts 加载字体;`paper` 只在卡片里有公式时才加载 KaTeX。
- ### 自定义风格
- 在 Markdown 文件里用自然语言写下你的偏好,例如「主色用墨绿,标题不超过 12 个字,数字保留一位小数」。插件会把它附加在内置风格说明之后:
- - 全局:`~/.dsh/visualize/style.md`(设置了 `DSH_HOME` 时是 `$DSH_HOME/visualize/style.md`),所有会话生效。
- - 工作区:`<工作区>/.dsh/visualize-style.md`,只在这个工作区的会话里生效。
- 这两个文件也可以在「设置 → 可视化」下方直接查看和编辑(同样需要 DSH 0.1.7+),每个工作区一个;内容清空后保存会删除文件。
- 两者冲突时,优先级是:你在对话里说的 > 工作区文件 > 全局文件 > 内置风格。每个文件只读取前 4 KB,文件不存在就跳过。改动在模型下一次加载 visualize skill 时生效(通常是新会话的第一张卡片)。自定义风格只影响模型怎么写卡片,不改变外壳注入的颜色和字体;要换颜色,在说明里写明,模型会在卡片根元素上覆盖对应的主题变量。
- ## 安全
- 卡片运行在不透明来源的 sandboxed iframe 中,不能接触宿主页面。在新窗口打开(包括页面模式的「打开页面」)时,新标签页本身不含任何模型代码,fragment 依旧只在同样 sandbox 和 CSP 的 iframe 里运行,读不到 DSH 的 cookie、localStorage 或登录凭据。CSP 会阻止网络请求、嵌套页面和表单提交,只允许从固定 CDN 加载静态资源。单个 fragment 默认上限为 `1000000` 字节,可以通过 `maxFragmentBytes` 调整。图片不需要放宽这条 CSP:插件在服务端取图,再以 `data:` URL 交给 iframe。工作区图片必须位于会话工作区之内,按路径判断和跟随符号链接之后都要在里面,并且通过 DSH 自己的文件系统服务读取。网络图片只从公网地址下载:每一次连接(包括最多 3 次重定向)都在 DNS 解析之后检查,loopback、内网、link-local 等地址一律拒绝,所以卡片不能被用来访问 `localhost`、局域网或云厂商的 metadata 服务。每次下载有 10 秒超时和大小上限,字节必须符合图片格式;SVG 原样保存,因为它只会通过 `<img>` 渲染,脚本和外部加载在这种方式下都不生效。存下来的图片只提供给已认证的 DSH 页面,并且按下载文件返回,不会作为可渲染的页面打开。卡片往输入框里填内容时,由 DSH 页面这边把关:只接受这张卡片自己的 iframe 发来的、由你的点击触发的请求,限长、限频,只写进空的输入框或替换卡片自己刚写的那句,并且永远不替你发送。卡片保存状态时也是一样:DSH 页面只接受这张卡片自己的 iframe 发来的状态,由页面决定存在哪张卡片名下(卡片没法写别的卡片的状态),并且限制大小。
- ## 限制
- 目前只在 Web UI 中渲染交互卡片,TUI 和 headless 客户端会显示普通工具结果。卡片只能把内容填进输入框,不能直接发送消息。
- 灵感来自 Codex 桌面端的 `/visualize`;skill 的分层 reference 和 Chart.js 优先路线借鉴了 [himself65/finance-skills](https://github.com/himself65/finance-skills/tree/main/plugins/ui-tools/skills/generative-ui)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.