plugin-draw — 让纯文本模型画图

包名: @aalis/plugin-draw
源码: packages/plugin-draw/src/index.ts

概述

让纯文本模型画图：模型编写 SVG 或 HTML+内联 CSS 标记，插件用硬化的无头浏览器渲染为 PNG；调用 draw_animation 时，带声明式动画（SMIL / CSS @keyframes）的标记会被逐帧截图，再由 ffmpeg 合成 GIF。产物落盘到本插件在会话媒体目录里的子目录 data:/images/<会话目录>/draw/（会话媒体的目录约定），由 send_attachment 投递进聊天；会话 id 为空的调用回工具错误。/clear 与删除会话经 memory:clear 清这个子目录（登记清理类型 image，所选类型含它时，会话级清这个会话的，/clear all 清各会话的），存储不在时不清、不出结果行。格式分工：图形、图标、梗图、动画用 SVG；图文卡片、表格、海报用 HTML+内联 CSS。渲染引擎由 util-offline-render 提供，使用独立 Chromium 实例（懒启动、空闲关停），每次渲染开独立浏览器上下文，禁用页面 JavaScript。资源只从调用者提供的内存映射读取，data: / blob: 可用；其余请求被拦截，解析规则与代理再把漏过的连接送往本机死端口。绘图默认尝试启用 Chromium 沙箱，启动失败后告警并回落到无沙箱模式。

加载、等字体、量内容高与截图各限时 15 秒，超时会关闭这一代 Chromium，同一代其他在飞任务也会失败，下次渲染重新启动；其余单条浏览器协议调用上限 30 秒。这是卡住检测，与等多久无关。浏览器随插件生命周期关闭，不接管宿主的 SIGINT 退出。注册工具组 draw，含 draw_image（PNG）与 draw_animation（GIF）两个工具。

两个工具都声明可转后台（让出时限用执行器的默认 30 秒）：排队与渲染久时，在前台等满让出时限还没结束就由 plugin-tools 的执行器转到后台，正常结束时通知起它的会话。渲染请求与动图的两遍 ffmpeg 编码都带上执行器给这次调用的中止信号，编码不另设超时；中止时渲染与编码停住，结果带 error。

插件声明

typescript

export default definePlugin({
  name: '@aalis/plugin-draw',
  displayName: '绘图',
  subsystem: 'tools',
  uses: {
    tools: optional(tools),
    storage: optional(storage),
    processService: optional(processService),
    logger,
    lifecycle,
    config,
  },
  apply(caps) { /* 见源码 */ },
});

配置

字段	类型	默认值	说明
`defaultWidth`	number	`800`	默认画布宽 (px)：HTML 模式与未声明宽度的 SVG 使用的画布宽度
`maxWidth`	number	`1600`	画布宽上限 (px)：请求宽与标记声明宽都会被收口到该值
`maxPixels`	number	`4000000`	画布 CSS 像素上限：width×height（CSS 像素）上限，默认 4MP。注意实际光栅内存 = 本值 × scale²（scale 默认 2 即 4 倍）；静态图按 scale 截图，故设备像素天花板是本值的 scale² 倍——调高前算好内存
`maxSourceKB`	number	`256`	输入标记上限 (KB)：source 参数的大小上限
`scale`	number	`2`	截图缩放倍率：deviceScaleFactor：2 = 视网膜清晰度（像素翻倍，文件更大）
`headless`	boolean	`true`	无头模式：调试时可关闭以观察渲染页面
`executablePath`	string	`''`	Chrome 路径（留空自动探测）：留空使用 puppeteer 缓存的 Chrome（与浏览器工具共用同一份二进制，进程独立）；填写时须为绝对路径
`idleShutdownSec`	number	`300`	空闲关停（秒）：渲染引擎空闲该时长后关停 Chromium 释放内存；0 = 常驻
`maxConcurrency`	number	`2`	渲染并发上限：同时进行的渲染任务数上限；群内多人并发画图时超出的排队，防无界 page + ffmpeg 拖垮机器
`animMaxDurationSec`	number	`8`	动图时长上限（秒）：draw_animation 的动画时长硬上限
`animDefaultFps`	number	`15`	动图默认帧率：未显式指定 fps 时使用；上限 25
`animMaxFrames`	number	`160`	动图帧数上限：时长×帧率超出时按帧数反推有效时长
`animMaxOutputMB`	number	`9`	GIF 体积上限 (MB)：超出即报错（OneBot 内联投递上限 10MB，留余量）

显式给出无效的 executablePath 或 headless 时，插件拒绝激活，不会启动浏览器。画布与动画数值仍按既有规则取整、夹到上限；低于有效下限时取字段默认值。

系统依赖

中文与 emoji 字体：外壳文档的字体栈为 PingFang SC / Hiragino Sans GB / Noto Sans CJK SC / Apple Color Emoji，macOS 自带前两者与 Apple Color Emoji。Linux 需自行安装 Noto CJK 与 Noto Color Emoji，否则中文与 emoji 会渲染成方块。Debian / Ubuntu：apt install fonts-noto-cjk fonts-noto-color-emoji。
ffmpeg：draw_animation 用 ffmpeg 把逐帧截图编码为 GIF，需在 PATH 中可用（Debian / Ubuntu：apt install ffmpeg）。只用 draw_image 时不需要。

plugin-draw — 让纯文本模型画图 ​

概述 ​

插件声明 ​

配置 ​

系统依赖 ​

相关 ​

plugin-draw — 让纯文本模型画图

概述

插件声明

配置

系统依赖

相关