DeepSeek Harness 插件

dsh-plantuml

DSH web plugin: render PlantUML fenced code blocks in conversation messages as SVG diagrams.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
qschen86/dsh-plantuml
最近更新
2026年8月17日
分类
界面增强
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/qschen86/dsh-plantuml
插件名:dsh-plantuml
作者:qschen86

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-plantuml

DeepSeek Harness Web 插件:在会话消息中直接渲染 PlantUML 图表。

功能

  • 识别助手消息里的 ``` `plantuml `` / `` `puml ``` 围栏代码块
  • 自动通过 PlantUML 服务(默认公共服务器,可配置)渲染为 SVG
  • 支持架构图、流程图、时序图、用例图、类图等 PlantUML 支持的图形
  • 渲染失败时显示错误信息,不阻塞消息中的其他 Markdown 内容

安装

dsh plugin --profile web add dsh-plantuml
# 或使用 GitHub Release tarball:
# dsh plugin --profile web add https://github.com/qschen86/dsh-plantuml/releases/download/v0.1.0/dsh-plantuml-0.1.0.tgz
dsh --profile web --dump-config   # 验证条目已加入 bundles
# 重启 dsh web(host 半生效),刷新页面(client 半生效)

卸载

dsh plugin --profile web remove dsh-plantuml

> 注意:本插件使用 assistant-step-5 优先级。若同时安装了 dsh-llm-codex-app-server 的浏览器渲染器(优先级 -10),后者会优先接管助手消息;此时如需 PlantUML 渲染,建议将两套渲染合并或二选一。

配置

通过环境变量配置:

变量默认值说明
DSH_PLANTUML_SERVERhttps://www.plantuml.com/plantumlPlantUML 服务地址,例如自建 http://127.0.0.1:8080/plantuml
DSH_PLANTUML_COMMAND如果设置为本机 plantuml 命令(或可执行文件路径),则优先用本机命令渲染,不访问网络
DSH_PLANTUML_TIMEOUT_MS15000远程渲染超时(毫秒)
DSH_PLANTUML_MAX_SOURCE1048576单个 PlantUML 源码最大字节数

> 环境变量需对 dsh web 进程可见:若服务由 launchd 监督进程托管(如 > com.dsh.web-supervisor),把变量加进其 plist 的 EnvironmentVariables > (或 DSH_START_CMD 前缀),仅写进 ~/.zshrc 不会生效。

使用

模型在回复中输出:

@startuml Alice -> Bob: 你好 @enduml

插件会自动把它替换成渲染后的 SVG 图片。

实现说明

  • 宿主端 lib/index.js 提供 POST /plugin/plantuml 渲染接口;默认使用 PlantUML 官方编码(deflate + 自定义 base64)请求远程服务,也可调用本机 plantuml 命令。
  • 浏览器端 lib/client.js 注册 conversation.chat.nodeassistant-step 低优先级渲染器,在保留原有 Markdown / 推理 / 图片 / JSON 展示的同时,解析 PlantUML 围栏并异步加载图片。