从装上到跑通第一次调用：dsh-visualize 完整操作路径
这篇按顺序走：核版本、装、重启、第一次调用、改一处、换风格。
步骤零 · 先把版本核清楚
README 声明的兼容范围是 DSH 0.1.1-rc.2 到 0.2.1-rc.2。这个包没声明 engines.node，也没声明 dsh 版本约束，只能自己对。
dsh –version
另一条线是 0.1.7：图片能力和「设置 → 可视化」都要它以上。低于这个版本，图片只出占位框，风格页要么不出现，要么只给你一段 YAML。
步骤一 · 装到 web profile
dsh plugin –profile web add @nagi-ovo/dsh-visualize
–profile web 不能省，装到别处不报错，只是永远不生效。也能装源码包：克隆仓库后在那目录跑 dsh plugin –profile web add .。
装完用 dsh –profile web –dump-config 确认条目在。
步骤二 · 重启，然后刷新
两件事缺一不可：插件在 dsh web 启动时注册工具、注入资源，服务要重启；已开的页面拿的是旧资源，要刷新。只做一件，界面里什么都没有，也不报错。
步骤三 · 第一次调用，从最小片段开始
直接说「做一个能调参数的排序算法可视化」，模型会自己调 visualize。想控制得更细，就把这段丢给它当样板：
<div style="padding:16px">
<input id="n" type="range" min="1" max="12" value="4">
<p id="out">4</p>
<script>
const o = document.getElementById('out');
document.getElementById('n').oninput = e => o.textContent = e.target.value;
</script>
</div>
能跑通说明四件事同时成立：fragment 合法、iframe 起来了、内联脚本能执行、事件没被 lint 拦。
卡片在生成参数时就开始渲染，不用等 HTML 写完。想省掉试插件的功夫，完整插件清单与汉化避坑指南 按能力分了类。
步骤四 · 用 wide 做并排比较
默认宽度跟聊天栏走，两三样东西并排就挤。说「用 wide 模式，对比冒泡和快排的交换次数」，模型会带 mode: "wide" 再画一张。
要眼睛来回扫的用 wide，只看一个结果的留默认。
步骤五 · 用 update 改一处
改已有卡片不要让它重画。说「把标题改成『第二轮对比』」，模型会调 action: "update"，带卡片 path 和一处 old_str → new_str。
省的是上下文：整段重发等于几千字再走一遍。path 只服务 update，新卡片带它会被忽略。
步骤六 · 换一种风格
0.1.7 以上，点左下角「更多」→「设置」→「可视化」，每种风格都有按当前明暗主题实时渲染的预览卡，点一下保存，下一张卡片生效。
五种里挑：whale 鲸蓝、editorial 报刊、paper 论文（色盲安全、带图注）、sketch 手绘、terminal 终端。版本不够就在 ~/.dsh/profiles/web/cordis.patch.yml 里写 style: sketch。
步骤七 · 写一份自己的风格说明
全局放 ~/.dsh/visualize/style.md，只对一个工作区生效就放 <工作区>/.dsh/visualize-style.md，写自然语言偏好。
三个边界：每个文件只读前 4 KB；优先级是对话里说的 > 工作区 > 全局 > 内置；它只改模型怎么写，不改注入的颜色字体。
验收清单
一条条对，全过就算装好。
- 卡片出现，滑块和按钮都能用
- 标题行右侧有「在新窗口打开」
- 工具过程折叠时，卡片在回答下方也出现
- 刷新后选择还在，重开会话能重放
- git status 干净，卡片文件在 ~/.dsh/visualize/sessions/ 下
最后一条常被忽略：卡片不进版本控制，插件也不自动清理。还想配别的插件，完整插件清单与汉化避坑指南 里有参数。
三个最容易卡住的地方
坑一 · 装到了别的 profile，或者装完没重启没刷新
现象：装完回界面，说什么都不出卡片，日志也没报错。原因：–profile web 漏了，或者服务是旧进程，或者页面没刷新。解决：带 profile 重装，再重启刷新。
坑二 · 在 TUI 或 headless 里等卡片
现象：命令行里调完只有一段工具结果，没有卡片。原因：这两个客户端只显示普通工具结果，卡片只在 Web UI 渲染。解决：换 Web UI 打开同一会话。
坑三 · 改过 page 模式页面，标签页却不动
现象：模型说改好了，浏览器里还是旧内容。原因：update 改的是磁盘上的 fragment，已开的标签页不会自己刷新。解决：回对话再点一次「打开页面」。
总结
八步里六步是配置，只有两步真在写内容，花时间的常是版本对不上、profile 装错。建议先照 完整插件清单与汉化避坑指南 挑一遍再装。本站的验证等级是 L5 运行时冒烟（真实安装成功），安全扫描结论是含敏感能力、无人工评估。
适合与不适合
适合：把结论画成能拖能点的卡片；并排比较几组数据；给团队做可交互 UI mockup；愿意花十分钟配一次环境。
不适合：日常在 TUI 或 headless 里跑，那两种客户端只显示普通工具结果；需要卡片自己请求接口，CSP 不允许；状态要长期保留，每卡 16 KB 就是上限；要求人工安全评估才能上生产的环境。
标签：dsh-visualize、DeepSeek Harness、dsh 插件、上手教程
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
