dsh-visualize README

The project's README from github.com/Nagi-ovo/dsh-visualize. As one markdown file: README.md.

dsh-visualize

dsh-visualize

简体中文 | English

dsh-visualize 在 dshfind 插件目录上的展示卡

让 DSH 不只回答一段文字。模型调用 visualize 后,Web UI 会在对话里直接出现一张可交互卡片,用来做模拟器、图表、对比面板或 UI mockup。

DSH 对话内生成交互式可视化演示

安装

推荐直接从 GitHub 安装到 DSH 的 web profile:

dsh plugin --profile web add github:Nagi-ovo/dsh-visualize
# 如果 dsh web 正在运行,重启后刷新页面

可以运行 dsh --profile web --dump-config 确认插件已经进入最终配置。需要修改源码时,克隆仓库并在仓库目录运行 dsh plugin --profile web add .;构建产物已经提交,不需要额外构建。使用社区 plugin-registry 的用户也可以从「设置 → 插件」安装。

怎么用

直接告诉模型你想看什么,例如「做一个能调参数的排序算法可视化」。模型会写出一份 HTML fragment,再调用 visualize(path, title?, mode?) 把它放进对话。适合并排比较的内容可以使用 mode: "wide"。

卡片会跟随 DSH 的明暗主题和鲸鱼蓝配色。会话重放时,页面从持久化的工具结果恢复,不依赖原始 fragment 文件仍然存在。

安全

卡片运行在不透明来源的 sandboxed iframe 中,不能接触宿主页面。CSP 会阻止网络请求、嵌套页面和表单提交,只允许从固定 CDN 加载静态资源。单个 fragment 默认上限为 1000000 字节,可以通过 maxFragmentBytes 调整。

限制

目前只在 Web UI 中渲染交互卡片,TUI 和 headless 客户端会显示普通工具结果。卡片内的按钮暂时不能向主对话发送 follow-up 消息。

灵感来自 Codex 桌面端的 /visualize;skill 的分层 reference 和 Chart.js 优先路线借鉴了 himself65/finance-skills。

dsh-visualize (Nagi-ovo/dsh-visualize)

Searching Database…

What is this?dsh-visualize is a plugin for DeepSeek Harness (DSH) that lets the model render interactive visual cards - simulators, charts, comparison panels, or UI mockups - right inside a chat conversation instead of just replying with text.
Is this a standalone app or a DSH plugin?It is a DSH plugin: the model calls a 'visualize' tool with an HTML fragment, and DSH's Web UI renders that fragment as an interactive card inside the conversation.
How do I install it into DSH?Install it straight from GitHub into your DSH web profile, then confirm with 'dsh --profile web --dump-config'. To modify the source, clone the repo and run 'dsh plugin --profile web add .' (build artifacts are already committed, no build step needed). Users of the community plugin-registry can also install it from Settings -> Plugins.
Do I need anything beyond DSH itself?No separate build tools or accounts are needed - the compiled artifacts are already committed to the repo, so installing into a DSH web profile is enough.
Does the interactive card work everywhere?Cards only render in the Web UI; TUI and headless DSH clients just show the plain tool-result text instead. Buttons inside a card also can't send follow-up messages back into the main conversation yet.
How do I actually trigger a visualization?Just describe what you want to see, e.g. a sorting algorithm visualizer with tunable parameters. The model writes an HTML fragment and calls visualize(path, title?, mode?); use mode: 'wide' for side-by-side layouts.
Does the card match DSH's own look?Yes, cards follow DSH's light/dark theme and whale-blue color scheme, and on session replay they restore from the persisted tool result rather than depending on the original fragment file still existing.
Is there a size limit on a card's content?Each HTML fragment defaults to a 1,000,000-byte cap, though this can be raised via the maxFragmentBytes setting.
What inspired this plugin?It was inspired by Codex desktop's '/visualize' command, and the skill's layered reference docs plus Chart.js-first approach were borrowed from himself65/finance-skills.
Creator
Nagi-ovo
Size
1.2 MB
Stars
309
Updated
CommitSep 29
Age
2mo
Commits · 90 Days