@aalis/plugin-draw 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ace Nyan <ace@acenyan.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/engine.d.ts

@@ -0,0 +1,95 @@
+import { Buffer } from 'node:buffer';
+import type { Logger } from '@aalis/core';
+import { type CanvasPlan } from './plan.js';
+type Page = {
+    setJavaScriptEnabled(v: boolean): Promise<void>;
+    setRequestInterception(v: boolean): Promise<void>;
+    on(event: 'request', handler: (req: InterceptedRequest) => void): void;
+    setViewport(v: {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+    }): Promise<void>;
+    setContent(html: string, opts?: {
+        waitUntil?: string;
+        timeout?: number;
+    }): Promise<void>;
+    evaluate<T>(fn: string | ((...a: never[]) => T), ...args: unknown[]): Promise<T>;
+    screenshot(opts: {
+        type: 'png';
+        clip?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }): Promise<Uint8Array>;
+    close(): Promise<void>;
+};
+type InterceptedRequest = {
+    url(): string;
+    continue(): Promise<void>;
+    abort(reason?: string): Promise<void>;
+};
+interface EngineConfig {
+    headless: boolean;
+    executablePath?: string;
+    /** 空闲多少毫秒后关停 Chromium（0=不关停） */
+    idleShutdownMs: number;
+    /** 单次 setContent/渲染步骤超时 */
+    stepTimeoutMs: number;
+    /** 同时在渲染的 page 数上限（防群内并发画图起无界 page + ffmpeg） */
+    maxConcurrency: number;
+}
+export declare class DrawEngine {
+    private logger;
+    private cfg;
+    private browser;
+    private launching;
+    private idleTimer;
+    private disposed;
+    private active;
+    private waiters;
+    constructor(logger: Logger, cfg: EngineConfig);
+    private ensureBrowser;
+    /** 给 post-load 步骤（evaluate/screenshot——不吃 puppeteer timeout）套墙钟硬上限，防极端 CSS 慢渲染吊死渲染槽。 */
+    private withTimeout;
+    private acquireSlot;
+    private releaseSlot;
+    private touchIdle;
+    /** 开一张硬化后的独立 page，执行 fn 后必关。 */
+    withPage<T>(plan: CanvasPlan, viewportHeight: number, fn: (page: Page) => Promise<T>): Promise<T>;
+    /** 静态渲染：定界（HTML 模式实测内容高）→ 设缩放视口 → clip 截图。 */
+    renderPng(plan: CanvasPlan, scale: number, maxPixels: number): Promise<{
+        png: Buffer;
+        width: number;
+        height: number;
+    }>;
+    /**
+     * 动画渲染：同一页内完成「暂停时钟 → 时长探测 → 逐帧定格截图」。
+     * 双机制必须并用（调研实测 getAnimations() 不暴露 SMIL）：
+     *   SMIL → svg.pauseAnimations() + svg.setCurrentTime(t)
+     *   CSS/WAAPI → document.getAnimations() 逐个 pause() + currentTime=t*1000
+     * 步进与截图之间无真实时间依赖，帧序列字节级确定（调研实测）。
+     * 时长：显式参数 > 文档声明探测（CSS computedTiming / SMIL getSimpleDuration，
+     * 无穷循环按单轮计）> 默认值；帧数受 maxFrames 收口（超出按帧数反推有效时长）。
+     */
+    renderAnimation(plan: CanvasPlan, opts: {
+        fps: number;
+        requestedDurationMs?: number;
+        defaultDurationMs: number;
+        maxDurationMs: number;
+        maxFrames: number;
+        scale: number;
+        maxPixels: number;
+    }): Promise<{
+        frames: Buffer[];
+        width: number;
+        height: number;
+        animationCount: number;
+        durationMs: number;
+    }>;
+    dispose(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/engine.js

@@ -0,0 +1,205 @@
+// ============================================================
+// engine.ts — 硬化渲染引擎（独立 Chromium 实例，懒启动 + 空闲关停）
+//
+// 刻意不复用 plugin-tool-browser 的共享页面池：那里承载可能带登录态的
+// 真实浏览页，本插件渲染的是 LLM 生成的不可信标记，二者不同进程隔离。
+// 每次渲染开独立 page，硬化三件套：
+//   1) setJavaScriptEnabled(false) —— 标记里的 <script> 一律不执行；
+//   2) 请求拦截 default-deny —— 只放 about:blank 与 data:（见 plan.allowRequest）；
+//   3) 视口即画布 —— 定宽定高 + clip 截图，杜绝内联 SVG 随视口伸缩。
+// ============================================================
+import { Buffer } from 'node:buffer';
+import { allowRequest } from './plan.js';
+export class DrawEngine {
+    logger;
+    cfg;
+    browser = null;
+    launching = null;
+    idleTimer = null;
+    disposed = false;
+    active = 0;
+    waiters = [];
+    constructor(logger, cfg) {
+        this.logger = logger;
+        this.cfg = cfg;
+    }
+    async ensureBrowser() {
+        if (this.disposed)
+            throw new Error('渲染引擎已停用');
+        if (this.browser?.connected)
+            return this.browser;
+        if (!this.launching) {
+            this.launching = (async () => {
+                const { default: puppeteer } = (await import('puppeteer'));
+                const browser = await puppeteer.launch({
+                    headless: this.cfg.headless,
+                    ...(this.cfg.executablePath ? { executablePath: this.cfg.executablePath } : {}),
+                    args: ['--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage'],
+                });
+                this.logger.info('绘图引擎 Chromium 已启动（独立实例，不与 browser 工具共享）');
+                return browser;
+            })().finally(() => {
+                this.launching = null;
+            });
+            this.browser = await this.launching;
+            return this.browser;
+        }
+        return this.launching;
+    }
+    /** 给 post-load 步骤（evaluate/screenshot——不吃 puppeteer timeout）套墙钟硬上限，防极端 CSS 慢渲染吊死渲染槽。 */
+    withTimeout(p, label) {
+        return Promise.race([
+            p,
+            new Promise((_r, reject) => setTimeout(() => reject(new Error(`渲染步骤超时（${label}）`)), this.cfg.stepTimeoutMs).unref?.()),
+        ]);
+    }
+    async acquireSlot() {
+        if (this.active < this.cfg.maxConcurrency) {
+            this.active++;
+            return;
+        }
+        await new Promise(resolve => this.waiters.push(resolve));
+        this.active++;
+    }
+    releaseSlot() {
+        this.active--;
+        const next = this.waiters.shift();
+        if (next)
+            next();
+    }
+    touchIdle() {
+        if (this.idleTimer)
+            clearTimeout(this.idleTimer);
+        if (this.cfg.idleShutdownMs <= 0)
+            return;
+        this.idleTimer = setTimeout(() => {
+            const b = this.browser;
+            this.browser = null;
+            if (b) {
+                b.close().catch(() => { });
+                this.logger.info('绘图引擎空闲，Chromium 已关停');
+            }
+        }, this.cfg.idleShutdownMs);
+        // 不阻止进程退出
+        this.idleTimer.unref?.();
+    }
+    /** 开一张硬化后的独立 page，执行 fn 后必关。 */
+    async withPage(plan, viewportHeight, fn) {
+        await this.acquireSlot();
+        let page = null;
+        try {
+            const browser = await this.ensureBrowser();
+            page = await browser.newPage();
+            await page.setJavaScriptEnabled(false);
+            await page.setRequestInterception(true);
+            page.on('request', req => {
+                if (allowRequest(req.url()))
+                    req.continue().catch(() => { });
+                else
+                    req.abort('blockedbyclient').catch(() => { });
+            });
+            await page.setViewport({ width: plan.width, height: viewportHeight, deviceScaleFactor: 1 });
+            await page.setContent(plan.html, { waitUntil: 'load', timeout: this.cfg.stepTimeoutMs });
+            // 等字体就绪（外链字体被拦时会快速 resolve 并回退系统字体，不会挂死——实测行为）
+            await this.withTimeout(page.evaluate('document.fonts ? document.fonts.ready.then(() => true) : true'), 'fonts');
+            return await fn(page);
+        }
+        finally {
+            if (page)
+                await page.close().catch(() => { });
+            this.releaseSlot();
+            this.touchIdle();
+        }
+    }
+    /** 静态渲染：定界（HTML 模式实测内容高）→ 设缩放视口 → clip 截图。 */
+    async renderPng(plan, scale, maxPixels) {
+        const guessHeight = plan.height === 'auto' ? 600 : plan.height;
+        return this.withPage(plan, guessHeight, async (page) => {
+            let height = plan.height;
+            if (height === 'auto') {
+                const measured = await this.withTimeout(page.evaluate('Math.ceil(document.getElementById("aalis-draw").getBoundingClientRect().height)'), 'measure');
+                height = Math.max(16, Math.min(measured || 16, Math.floor(maxPixels / plan.width)));
+            }
+            await page.setViewport({ width: plan.width, height, deviceScaleFactor: scale });
+            const shot = await this.withTimeout(page.screenshot({ type: 'png', clip: { x: 0, y: 0, width: plan.width, height } }), 'screenshot');
+            return { png: Buffer.from(shot), width: plan.width, height };
+        });
+    }
+    /**
+     * 动画渲染：同一页内完成「暂停时钟 → 时长探测 → 逐帧定格截图」。
+     * 双机制必须并用（调研实测 getAnimations() 不暴露 SMIL）：
+     *   SMIL → svg.pauseAnimations() + svg.setCurrentTime(t)
+     *   CSS/WAAPI → document.getAnimations() 逐个 pause() + currentTime=t*1000
+     * 步进与截图之间无真实时间依赖，帧序列字节级确定（调研实测）。
+     * 时长：显式参数 > 文档声明探测（CSS computedTiming / SMIL getSimpleDuration，
+     * 无穷循环按单轮计）> 默认值；帧数受 maxFrames 收口（超出按帧数反推有效时长）。
+     */
+    async renderAnimation(plan, opts) {
+        const guessHeight = plan.height === 'auto' ? 600 : plan.height;
+        return this.withPage(plan, guessHeight, async (page) => {
+            let height = plan.height;
+            if (height === 'auto') {
+                const measured = await this.withTimeout(page.evaluate('Math.ceil(document.getElementById("aalis-draw").getBoundingClientRect().height)'), 'measure');
+                height = Math.max(16, Math.min(measured || 16, Math.floor(opts.maxPixels / plan.width)));
+            }
+            await page.setViewport({ width: plan.width, height, deviceScaleFactor: opts.scale });
+            // 暂停两套动画时钟；顺带数动画数与声明时长（0 动画 = 调用方该提示"这是静态图"）
+            const probe = await page.evaluate(`(() => {
+          let count = 0;
+          let max = 0;
+          for (const svg of document.querySelectorAll('svg')) {
+            try { svg.pauseAnimations(); } catch {}
+            for (const el of svg.querySelectorAll('animate,animateTransform,animateMotion,set')) {
+              count += 1;
+              try {
+                const d = el.getSimpleDuration();
+                if (Number.isFinite(d)) max = Math.max(max, d * 1000);
+              } catch {}
+            }
+          }
+          for (const a of document.getAnimations()) {
+            try {
+              a.pause();
+              count += 1;
+              const t = a.effect.getComputedTiming();
+              const iters = Number.isFinite(t.iterations) ? t.iterations : 1;
+              max = Math.max(max, (t.delay || 0) + (Number(t.duration) || 0) * iters);
+            } catch {}
+          }
+          return { count, durationMs: Math.round(max) };
+        })()`);
+            let durationMs = opts.requestedDurationMs ?? (probe.durationMs > 0 ? probe.durationMs : opts.defaultDurationMs);
+            durationMs = Math.min(durationMs, opts.maxDurationMs);
+            let frameCount = Math.max(2, Math.round((durationMs / 1000) * opts.fps));
+            if (frameCount > opts.maxFrames) {
+                frameCount = opts.maxFrames;
+                durationMs = Math.round((frameCount / opts.fps) * 1000);
+            }
+            const frames = [];
+            for (let i = 0; i < frameCount; i++) {
+                const t = (i / opts.fps).toFixed(6);
+                await page.evaluate(`((t) => {
+            for (const svg of document.querySelectorAll('svg')) {
+              try { svg.setCurrentTime(t); } catch {}
+            }
+            for (const a of document.getAnimations()) {
+              try { a.pause(); a.currentTime = t * 1000; } catch {}
+            }
+          })(${t})`);
+                const shot = await this.withTimeout(page.screenshot({ type: 'png', clip: { x: 0, y: 0, width: plan.width, height } }), `frame ${i}`);
+                frames.push(Buffer.from(shot));
+            }
+            return { frames, width: plan.width, height, animationCount: probe.count, durationMs };
+        });
+    }
+    async dispose() {
+        this.disposed = true;
+        if (this.idleTimer)
+            clearTimeout(this.idleTimer);
+        const b = this.browser ?? (this.launching ? await this.launching.catch(() => null) : null);
+        this.browser = null;
+        if (b)
+            await b.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/gif.d.ts

@@ -0,0 +1,9 @@
+import type { Buffer } from 'node:buffer';
+import type { ProcessService } from '@aalis/api-process';
+import type { StorageService } from '@aalis/api-storage';
+/** palettegen / paletteuse 两遍的 ffmpeg 参数（纯函数，供测试断言） */
+export declare function ffmpegPaletteArgs(fps: number, framePattern: string, palettePath: string): string[];
+export declare function ffmpegEncodeArgs(fps: number, framePattern: string, palettePath: string, outPath: string): string[];
+/** 帧序列编码为 GIF。失败抛错（调用方转用户可读错误）。 */
+export declare function framesToGif(proc: ProcessService, storage: StorageService, frames: Buffer[], fps: number): Promise<Buffer>;
+//# sourceMappingURL=gif.d.ts.map

package/dist/gif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif.d.ts","sourceRoot":"","sources":["../src/gif.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAWlG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAelH;AAED,mCAAmC;AACnC,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/gif.js

@@ -0,0 +1,60 @@
+// ============================================================
+// gif.ts — 帧序列 → GIF（ffmpeg 调色板两遍编码）
+//
+// 走 api-process 的 makeTempDir + execFile 范式（与 plugin-media/ffmpeg.ts 同规）：
+// 二进制不过 stdout（ExecResult.stdout 是 utf-8 字符串，会被解码破坏），
+// 一律写临时文件再经 storage 读回。两遍编码：palettegen 按帧间差分建 256 色
+// 调色板，paletteuse 带抖动回贴——文字清晰、体积小（调研实测 2s@20fps≈133KB）。
+// ============================================================
+/** palettegen / paletteuse 两遍的 ffmpeg 参数（纯函数，供测试断言） */
+export function ffmpegPaletteArgs(fps, framePattern, palettePath) {
+    return [
+        '-y',
+        '-framerate',
+        String(fps),
+        '-i',
+        framePattern,
+        '-vf',
+        'palettegen=max_colors=256:stats_mode=diff',
+        palettePath,
+    ];
+}
+export function ffmpegEncodeArgs(fps, framePattern, palettePath, outPath) {
+    return [
+        '-y',
+        '-framerate',
+        String(fps),
+        '-i',
+        framePattern,
+        '-i',
+        palettePath,
+        '-lavfi',
+        'paletteuse=dither=sierra2_4a',
+        '-loop',
+        '0',
+        outPath,
+    ];
+}
+/** 帧序列编码为 GIF。失败抛错（调用方转用户可读错误）。 */
+export async function framesToGif(proc, storage, frames, fps) {
+    if (frames.length === 0)
+        throw new Error('无帧可编码');
+    const tmp = await proc.makeTempDir('draw-gif');
+    try {
+        for (let i = 0; i < frames.length; i++) {
+            await storage.writeFile(`${tmp.uri}/frame_${String(i).padStart(4, '0')}.png`, frames[i]);
+        }
+        const framePattern = `${tmp.path}/frame_%04d.png`;
+        const palettePath = `${tmp.path}/palette.png`;
+        const outPath = `${tmp.path}/out.gif`;
+        await proc.execFile('ffmpeg', ffmpegPaletteArgs(fps, framePattern, palettePath), { timeout: 60_000 });
+        await proc.execFile('ffmpeg', ffmpegEncodeArgs(fps, framePattern, palettePath, outPath), { timeout: 60_000 });
+        const raw = (await storage.readFile(`${tmp.uri}/out.gif`));
+        const { Buffer: NodeBuffer } = await import('node:buffer');
+        return NodeBuffer.from(raw);
+    }
+    finally {
+        await tmp.cleanup();
+    }
+}
+//# sourceMappingURL=gif.js.map

package/dist/gif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif.js","sourceRoot":"","sources":["../src/gif.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,qCAAqC;AACrC,EAAE;AACF,0EAA0E;AAC1E,sDAAsD;AACtD,oDAAoD;AACpD,uDAAuD;AACvD,+DAA+D;AAM/D,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,YAAoB,EAAE,WAAmB;IACtF,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,MAAM,CAAC,GAAG,CAAC;QACX,IAAI;QACJ,YAAY;QACZ,KAAK;QACL,2CAA2C;QAC3C,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,YAAoB,EAAE,WAAmB,EAAE,OAAe;IACtG,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,MAAM,CAAC,GAAG,CAAC;QACX,IAAI;QACJ,YAAY;QACZ,IAAI;QACJ,WAAW;QACX,QAAQ;QACR,8BAA8B;QAC9B,OAAO;QACP,GAAG;QACH,OAAO;KACR,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAoB,EACpB,OAAuB,EACvB,MAAgB,EAChB,GAAW;IAEX,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,YAAY,GAAG,GAAG,GAAG,CAAC,IAAI,iBAAiB,CAAC;QAClD,MAAM,WAAW,GAAG,GAAG,GAAG,CAAC,IAAI,cAAc,CAAC;QAC9C,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,IAAI,UAAU,CAAC;QACtC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACtG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9G,MAAM,GAAG,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC,CAAe,CAAC;QACzE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC3D,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '@aalis/core';
+import type { ConfigSchema } from '@aalis/schema-config';
+export declare const name = "@aalis/plugin-draw";
+export declare const displayName = "\u7ED8\u56FE";
+export declare const subsystem = "tools";
+export declare const inject: {
+    optional: string[];
+};
+export declare const configSchema: ConfigSchema;
+export declare function apply(ctx: Context, rawConfig: Record<string, unknown>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,WAAW,iBAAO,CAAC;AAChC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,MAAM;;CAAgD,CAAC;AAEpE,eAAO,MAAM,YAAY,EAAE,YAiF1B,CAAC;AA6CF,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkM5E"}

package/dist/index.js

@@ -0,0 +1,318 @@
+// ============================================================
+// @aalis/plugin-draw — 让纯文本模型画图
+//
+// LLM 写标记（SVG 或 HTML+内联 CSS），本插件用硬化的无头浏览器渲染成
+// PNG（后续：CSS/SMIL 动画 → 逐帧 → GIF），落盘 data:/images/ 后由
+// send_attachment 投递进聊天。引擎与安全设计见 engine.ts 头注。
+//
+// 格式分工（工具描述同步教给模型）：
+//   图形/图标/梗图/动画 → SVG（viewBox 定界精确、声明式动画现成）
+//   图文卡片/表格/海报 → HTML+内联 CSS（排版引擎管折行布局，可内嵌 SVG）
+// ============================================================
+import { Buffer } from 'node:buffer';
+import { createProcessGateway } from '@aalis/api-process';
+import { createStorageGateway } from '@aalis/api-storage';
+import { useToolService } from '@aalis/api-tools';
+import { DrawEngine } from './engine.js';
+import { framesToGif } from './gif.js';
+import { lintAnimationSource, resolveCanvas } from './plan.js';
+// ===== 插件元数据 =====
+export const name = '@aalis/plugin-draw';
+export const displayName = '绘图';
+export const subsystem = 'tools';
+export const inject = { optional: ['tools', 'storage', 'process'] };
+export const configSchema = {
+    defaultWidth: {
+        type: 'number',
+        label: '默认画布宽 (px)',
+        default: 800,
+        description: 'HTML 模式与未声明宽度的 SVG 使用的画布宽度',
+    },
+    maxWidth: {
+        type: 'number',
+        label: '画布宽上限 (px)',
+        default: 1600,
+        description: '请求宽与标记声明宽都会被收口到该值',
+    },
+    maxPixels: {
+        type: 'number',
+        label: '画布 CSS 像素上限',
+        default: 4000000,
+        description: 'width×height（CSS 像素）上限，默认 4MP。注意实际光栅内存 = 本值 × scale²（scale 默认 2 即 4 倍）；' +
+            '静态图按 scale 截图，故设备像素天花板是本值的 scale² 倍——调高前算好内存',
+    },
+    maxSourceKB: {
+        type: 'number',
+        label: '输入标记上限 (KB)',
+        default: 256,
+        description: 'source 参数的大小上限',
+    },
+    scale: {
+        type: 'number',
+        label: '截图缩放倍率',
+        default: 2,
+        description: 'deviceScaleFactor：2 = 视网膜清晰度（像素翻倍，文件更大）',
+    },
+    headless: {
+        type: 'boolean',
+        label: '无头模式',
+        default: true,
+        description: '调试时可关闭以观察渲染页面',
+    },
+    executablePath: {
+        type: 'string',
+        label: 'Chrome 路径（留空自动探测）',
+        default: '',
+        description: '留空使用 puppeteer 缓存的 Chrome（与浏览器工具共用同一份二进制，进程独立）',
+    },
+    idleShutdownSec: {
+        type: 'number',
+        label: '空闲关停 (秒)',
+        default: 300,
+        description: '渲染引擎空闲该时长后关停 Chromium 释放内存；0 = 常驻',
+    },
+    maxConcurrency: {
+        type: 'number',
+        label: '渲染并发上限',
+        default: 2,
+        description: '同时进行的渲染任务数上限；群内多人并发画图时超出的排队，防无界 page + ffmpeg 拖垮机器',
+    },
+    animMaxDurationSec: {
+        type: 'number',
+        label: '动图时长上限 (秒)',
+        default: 8,
+        description: 'draw_animation 的动画时长硬上限',
+    },
+    animDefaultFps: {
+        type: 'number',
+        label: '动图默认帧率',
+        default: 15,
+        description: '未显式指定 fps 时使用；上限 25',
+    },
+    animMaxFrames: {
+        type: 'number',
+        label: '动图帧数上限',
+        default: 160,
+        description: '时长×帧率超出时按帧数反推有效时长',
+    },
+    animMaxOutputMB: {
+        type: 'number',
+        label: 'GIF 体积上限 (MB)',
+        default: 9,
+        description: '超出即报错（OneBot 内联投递上限 10MB，留余量）',
+    },
+};
+function resolveConfig(config) {
+    const num = (v, dflt, lo, hi) => {
+        const n = Number(v);
+        return Number.isFinite(n) && n >= lo ? Math.min(hi, Math.floor(n)) : dflt;
+    };
+    return {
+        defaultWidth: num(config.defaultWidth, 800, 16, 4096),
+        maxWidth: num(config.maxWidth, 1600, 16, 4096),
+        maxPixels: num(config.maxPixels, 4_000_000, 65536, 16_000_000),
+        maxSourceBytes: num(config.maxSourceKB, 256, 1, 4096) * 1024,
+        scale: num(config.scale, 2, 1, 3),
+        headless: config.headless ?? true,
+        executablePath: config.executablePath ?? '',
+        idleShutdownSec: num(config.idleShutdownSec, 300, 0, 86400),
+        maxConcurrency: num(config.maxConcurrency, 2, 1, 8),
+        animMaxDurationSec: num(config.animMaxDurationSec, 8, 1, 30),
+        animDefaultFps: num(config.animDefaultFps, 15, 1, 25),
+        animMaxFrames: num(config.animMaxFrames, 160, 2, 600),
+        animMaxOutputMB: num(config.animMaxOutputMB, 9, 1, 9),
+    };
+}
+/** sessionId → 文件系统安全目录名（与 adapter 附件缓存同规，另中和 .. 与前导点做纵深防御）。 */
+function safeSessionDir(sessionId) {
+    return (sessionId
+        .replace(/[:/\\]/g, '_')
+        .replace(/\.\./g, '_')
+        .replace(/^\.+/, '_') || 'nosession');
+}
+export function apply(ctx, rawConfig) {
+    const cfg = resolveConfig(rawConfig);
+    const logger = ctx.logger.child('draw');
+    const storage = createStorageGateway(ctx);
+    const proc = createProcessGateway(ctx);
+    const engine = new DrawEngine(logger, {
+        headless: cfg.headless,
+        executablePath: cfg.executablePath || undefined,
+        idleShutdownMs: cfg.idleShutdownSec * 1000,
+        stepTimeoutMs: 15_000,
+        maxConcurrency: cfg.maxConcurrency,
+    });
+    ctx.onDispose(() => engine.dispose());
+    const tools = useToolService(ctx);
+    tools.registerGroup({
+        name: 'draw',
+        label: '绘图',
+        description: '把模型编写的 SVG/HTML 标记渲染为图片，配合 send_attachment 发进聊天',
+    });
+    tools.register({
+        // 刻意 public：绘图是人人可要求的能力（用户产品决定）——群里谁都能让 bot 画图。
+        // 抗滥用不靠权限档而靠资源治理：单次成本被 maxPixels/maxFrames/体积封顶，
+        // 跨会话并发由引擎信号量排队（不拒绝、只削峰），机器不会被刷图打垮。
+        groups: ['draw'],
+        definition: {
+            type: 'function',
+            function: {
+                name: 'draw_image',
+                description: '把你编写的 SVG 或 HTML 标记渲染成 PNG 图片，落盘后返回 storage_uri（用 send_attachment 的 storage_uri 参数发送到聊天）。\n' +
+                    '**选型**：图形/图标/梗图/示意图 → 写完整 SVG 文档（**必须带 viewBox**，建议同时带 width/height）；' +
+                    '图文卡片/表格/排版类 → 写 HTML 片段+内联 CSS（可内嵌 SVG 图形；不要写 <html>/<body> 外壳）。\n' +
+                    '**硬约束**：渲染页禁用脚本且拦截全部网络请求——<script> 不会执行，外链图片/字体/CSS 一律加载失败，' +
+                    '资源只能内联（data: URI）；中文与 emoji 直接可用（系统字体栈兜底）。' +
+                    '画布定界：SVG 按 viewBox/width 精确定界；HTML 按 width 参数定宽、内容自动量高。',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        source: { type: 'string', description: 'SVG 文档或 HTML 片段' },
+                        width: { type: 'number', description: '画布宽 px（可选；SVG 自带尺寸时按比例覆盖，HTML 默认 800）' },
+                    },
+                    required: ['source'],
+                    additionalProperties: false,
+                },
+            },
+        },
+        handler: async (args, callCtx) => {
+            try {
+                const source = String(args.source ?? '');
+                if (!source.trim())
+                    return JSON.stringify({ error: 'source 为空' });
+                if (Buffer.byteLength(source) > cfg.maxSourceBytes) {
+                    return JSON.stringify({ error: `source 超过大小上限 ${Math.floor(cfg.maxSourceBytes / 1024)}KB` });
+                }
+                // 按 scale² 折算：resolveCanvas 收的是 CSS 像素，但真实光栅 = CSS 像素 × scale²，
+                // 用折算后的 CSS 像素预算让设备像素峰值不超过 maxPixels 的既定内存含义
+                const cssPixelBudget = Math.floor(cfg.maxPixels / (cfg.scale * cfg.scale));
+                const plan = resolveCanvas(source, args.width, { ...cfg, maxPixels: cssPixelBudget });
+                const { png, width, height } = await engine.renderPng(plan, cfg.scale, cssPixelBudget);
+                const digest = await crypto.subtle.digest('SHA-256', new Uint8Array(png));
+                const hash = Buffer.from(digest).toString('hex').slice(0, 16);
+                const dir = safeSessionDir(callCtx.sessionId || 'nosession');
+                const uri = `data:/images/${dir}/draw-${hash}.png`;
+                await storage.writeFile(uri, png);
+                logger.info(`draw_image 渲染完成 mode=${plan.mode} ${width}x${height}@${cfg.scale}x → ${uri}`);
+                return JSON.stringify({
+                    uri,
+                    width,
+                    height,
+                    mode: plan.mode,
+                    message: '已渲染并落盘。用 send_attachment({ kind: "image", storage_uri: uri }) 发送到聊天。',
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                logger.warn(`draw_image 失败: ${message}`);
+                return JSON.stringify({ error: message });
+            }
+        },
+    });
+    tools.register({
+        // public 同 draw_image：人人可画，抗滥用靠资源治理不靠权限档。
+        groups: ['draw'],
+        definition: {
+            type: 'function',
+            function: {
+                name: 'draw_animation',
+                description: '把你编写的带动画的 SVG/HTML 标记渲染成 GIF 动图，落盘后返回 storage_uri（用 send_attachment 发送）。\n' +
+                    '**动画只能用声明式**：SVG 用 SMIL（<animate>/<animateTransform>/<animateMotion>）或 CSS ' +
+                    '@keyframes；脚本驱动的动画不会生效（渲染页禁用 JS）。建议动画时长 2-5 秒并做无缝循环' +
+                    '（首尾状态一致），GIF 默认无限循环播放。\n' +
+                    '**避坑**：同一元素不要同时挂 animateMotion 与位移类 animateTransform（位移复合会漂移）。\n' +
+                    '渲染成功即可**直接 send_attachment 发送**，不需要额外核对。结果里的 check_frames（首帧/中帧）' +
+                    '仅在你对形态没把握时可选地用 analyze_image 看一眼——但视觉识别较慢，通常无必要，别默认调用；' +
+                    '即便核对，核对失败或超时也**不影响发送，直接发 GIF**，不要因核对不成而放弃发送。\n' +
+                    '选型与硬约束同 draw_image：图形动画写 SVG（必须带 viewBox）；外链资源一律被拦，只能内联。',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        source: { type: 'string', description: '带 SMIL/CSS 动画的 SVG 文档或 HTML 片段' },
+                        width: { type: 'number', description: '画布宽 px（可选，动图建议 ≤600 控制体积）' },
+                        duration_seconds: { type: 'number', description: '动画时长秒（可选；缺省自动探测声明时长）' },
+                        fps: { type: 'number', description: '帧率（可选，默认 15，上限 25）' },
+                    },
+                    required: ['source'],
+                    additionalProperties: false,
+                },
+            },
+        },
+        handler: async (args, callCtx) => {
+            try {
+                const source = String(args.source ?? '');
+                if (!source.trim())
+                    return JSON.stringify({ error: 'source 为空' });
+                if (Buffer.byteLength(source) > cfg.maxSourceBytes) {
+                    return JSON.stringify({ error: `source 超过大小上限 ${Math.floor(cfg.maxSourceBytes / 1024)}KB` });
+                }
+                const plan = resolveCanvas(source, args.width, cfg);
+                const reqDur = Number(args.duration_seconds);
+                const reqFps = Number(args.fps);
+                const fps = Number.isFinite(reqFps) && reqFps > 0 ? Math.min(Math.floor(reqFps), 25) : cfg.animDefaultFps;
+                const r = await engine.renderAnimation(plan, {
+                    fps,
+                    requestedDurationMs: Number.isFinite(reqDur) && reqDur > 0 ? Math.round(reqDur * 1000) : undefined,
+                    defaultDurationMs: 3000,
+                    maxDurationMs: cfg.animMaxDurationSec * 1000,
+                    maxFrames: cfg.animMaxFrames,
+                    scale: 1, // 动图按 1x：帧数×像素才是体积主宰，清晰度靠画布宽
+                    maxPixels: cfg.maxPixels,
+                });
+                const gif = await framesToGif(proc, storage, r.frames, fps);
+                if (gif.byteLength > cfg.animMaxOutputMB * 1024 * 1024) {
+                    return JSON.stringify({
+                        error: `GIF ${(gif.byteLength / 1048576).toFixed(1)}MB 超过上限 ${cfg.animMaxOutputMB}MB——` +
+                            '请缩小画布宽、降低 fps 或缩短时长后重试',
+                    });
+                }
+                const digest = await crypto.subtle.digest('SHA-256', new Uint8Array(gif));
+                const hash = Buffer.from(digest).toString('hex').slice(0, 16);
+                const dir = safeSessionDir(callCtx.sessionId || 'nosession');
+                const uri = `data:/images/${dir}/draw-${hash}.gif`;
+                await storage.writeFile(uri, gif);
+                // 检查帧：首帧+中帧落盘，供 agent 在没把握时**可选**用 analyze_image 核对——
+                // 不是默认路径。本地视觉推理慢（33b 单张可达数分钟），默认自检会把 2 秒的动图
+                // 拖成几分钟、还挤占入站识别的产能（实测已踩），故降级为提示、由模型按需取用。
+                const midIdx = Math.floor(r.frames.length / 2);
+                const checkFrames = [];
+                for (const [tag, idx] of [
+                    ['f0', 0],
+                    ['fmid', midIdx],
+                ]) {
+                    const fUri = `data:/images/${dir}/draw-${hash}-${tag}.png`;
+                    await storage.writeFile(fUri, r.frames[idx]);
+                    checkFrames.push(fUri);
+                }
+                const lintWarnings = lintAnimationSource(source);
+                logger.info(`draw_animation 渲染完成 mode=${plan.mode} ${r.width}x${r.height} ${r.frames.length}帧@${fps}fps ` +
+                    `${(gif.byteLength / 1024).toFixed(0)}KB anims=${r.animationCount} → ${uri}`);
+                const warnings = [
+                    ...(r.animationCount === 0
+                        ? ['未检测到任何声明式动画——产物是静态画面的重复帧。动画请用 SMIL 或 CSS @keyframes。']
+                        : []),
+                    ...lintWarnings,
+                ];
+                return JSON.stringify({
+                    uri,
+                    width: r.width,
+                    height: r.height,
+                    frames: r.frames.length,
+                    fps,
+                    duration_seconds: r.durationMs / 1000,
+                    size_kb: Math.round(gif.byteLength / 1024),
+                    check_frames: checkFrames,
+                    ...(warnings.length > 0 ? { warnings } : {}),
+                    message: '已渲染并落盘，可直接用 send_attachment({ kind: "image", storage_uri: uri }) 发送到聊天。' +
+                        'check_frames 仅供没把握时可选核对（analyze_image 较慢，通常无需调用）。',
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                logger.warn(`draw_animation 失败: ${message}`);
+                return JSON.stringify({ error: message });
+            }
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/plan.d.ts

@@ -0,0 +1,62 @@
+export interface DrawCaps {
+    /** HTML 模式与无宽度 SVG 的默认画布宽（px） */
+    defaultWidth: number;
+    /** 画布宽上限（px） */
+    maxWidth: number;
+    /** 画布总像素上限（width × height，防巨图拖垮渲染与投递） */
+    maxPixels: number;
+    /** 输入标记大小上限（字节） */
+    maxSourceBytes: number;
+    /** 截图缩放（deviceScaleFactor） */
+    scale: number;
+}
+export type SourceMode = 'svg' | 'html';
+export interface CanvasPlan {
+    mode: SourceMode;
+    /** 画布宽（CSS px，已 clamp） */
+    width: number;
+    /** 画布高：SVG 按尺寸语义先验可知；HTML 需渲染后实测 */
+    height: number | 'auto';
+    /** 交给浏览器 setContent 的完整文档 */
+    html: string;
+}
+/**
+ * 源分类：剥掉 BOM/空白/XML 序言/DOCTYPE/前导注释后，根元素是 <svg> 即 SVG 文档，
+ * 否则一律按 HTML 片段处理（含"HTML 里嵌 SVG"的混合写法）。
+ */
+export declare function classifySource(source: string): SourceMode;
+/** 从 SVG 根元素上解析尺寸语义（width/height 属性优先，viewBox 兜底）。 */
+export declare function parseSvgCanvas(svg: string): {
+    width?: number;
+    height?: number;
+    aspect?: number;
+};
+/**
+ * 画布定界：
+ * - SVG：width/height 属性直取；只有 viewBox 时按纵横比配默认宽；都没有则默认宽配 3:2。
+ *   （内联 SVG 不定界会随视口伸缩——实测坑，必须显式定死。）
+ * - HTML：宽 = 请求宽或默认宽，高渲染后实测。
+ * 全部经 maxWidth 与 maxPixels 收口。
+ */
+export declare function resolveCanvas(source: string, requestedWidth: number | undefined, caps: DrawCaps): CanvasPlan;
+/**
+ * 外壳文档：body 归零边距；SVG 模式用定宽定高容器把根 SVG 撑满（杜绝随视口伸缩）；
+ * HTML 模式定宽、高度自流。字体栈兜底中文与 emoji（部署机 macOS；模型可在标记内自定覆盖）。
+ */
+export declare function buildShell(source: string, mode: SourceMode, width: number, height: number | 'auto'): string;
+/**
+ * 动画标记 lint：静态检出已知的"作者级"错误类，作为 warning 返回给模型自纠。
+ * 渲染层只能忠实执行写错的动画——已知错误类在这里拦，未知错误类靠检查帧+视觉自检。
+ * 规则刻意窄（宁漏勿噪）：
+ *   R1 同一叶子元素同时挂 animateMotion 与位移类 animateTransform（rotate/translate）
+ *      —— 位移复合，轨迹漂移（本插件首个演示就犯过的错，实证类）。
+ *   R2 @keyframes 无限循环但 0% 与 100% 声明不一致 —— 循环处跳变。
+ */
+export declare function lintAnimationSource(source: string): string[];
+/**
+ * 请求放行判定（default-deny）：渲染页只允许内联资源。
+ * LLM 生成的标记是不可信输入——实测 <script> 会执行、外链会真发请求（SSRF/外泄口），
+ * 引擎层禁 JS + 本判定拦一切网络面：只放 about:blank（setContent 的初始导航）与 data:。
+ */
+export declare function allowRequest(url: string): boolean;
+//# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAyBzD;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAehG;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CA4B5G;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAiB3G;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAiC5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/plan.js

@@ -0,0 +1,159 @@
+// ============================================================
+// plan.ts — 渲染计划（纯函数层：源分类 / 画布定界 / 外壳文档 / 请求放行判定）
+//
+// 引擎是无头浏览器，SVG 与 HTML 对它是同一件事——真正需要区分的只有
+// 「画布怎么定界」：SVG 有 viewBox/width 的精确尺寸语义，直接算；
+// HTML 交给排版引擎流式布局，宽度取参数、高度渲染后实测。
+// 本文件零 IO 零浏览器依赖，全部可单测。
+// ============================================================
+const clampInt = (v, lo, hi) => Math.max(lo, Math.min(hi, Math.floor(v)));
+/**
+ * 源分类：剥掉 BOM/空白/XML 序言/DOCTYPE/前导注释后，根元素是 <svg> 即 SVG 文档，
+ * 否则一律按 HTML 片段处理（含"HTML 里嵌 SVG"的混合写法）。
+ */
+export function classifySource(source) {
+    let s = source.replace(/^/, '');
+    for (;;) {
+        const t = s.trimStart();
+        if (t.startsWith('<!--')) {
+            const end = t.indexOf('-->');
+            if (end < 0)
+                break;
+            s = t.slice(end + 3);
+            continue;
+        }
+        if (/^<\?xml/i.test(t)) {
+            const end = t.indexOf('?>');
+            if (end < 0)
+                break;
+            s = t.slice(end + 2);
+            continue;
+        }
+        if (/^<!doctype/i.test(t)) {
+            const end = t.indexOf('>');
+            if (end < 0)
+                break;
+            s = t.slice(end + 1);
+            continue;
+        }
+        return /^<svg[\s/>]/i.test(t) ? 'svg' : 'html';
+    }
+    return 'html';
+}
+/** 从 SVG 根元素上解析尺寸语义（width/height 属性优先，viewBox 兜底）。 */
+export function parseSvgCanvas(svg) {
+    const root = svg.match(/<svg[^>]*>/i)?.[0] ?? '';
+    const num = (attr) => {
+        // 只认纯数字与 px（em/%/pt 等相对单位对画布定界无意义，忽略走 viewBox）
+        const m = root.match(new RegExp(`\\b${attr}\\s*=\\s*["']\\s*([0-9.]+)\\s*(?:px)?\\s*["']`, 'i'));
+        const v = m ? Number(m[1]) : Number.NaN;
+        return Number.isFinite(v) && v > 0 ? v : undefined;
+    };
+    const width = num('width');
+    const height = num('height');
+    const vb = root.match(/\bviewBox\s*=\s*["']\s*([-0-9.]+)[\s,]+([-0-9.]+)[\s,]+([0-9.]+)[\s,]+([0-9.]+)\s*["']/i);
+    const vbW = vb ? Number(vb[3]) : Number.NaN;
+    const vbH = vb ? Number(vb[4]) : Number.NaN;
+    const aspect = Number.isFinite(vbW) && Number.isFinite(vbH) && vbW > 0 && vbH > 0 ? vbH / vbW : undefined;
+    return { width, height, aspect };
+}
+/**
+ * 画布定界：
+ * - SVG：width/height 属性直取；只有 viewBox 时按纵横比配默认宽；都没有则默认宽配 3:2。
+ *   （内联 SVG 不定界会随视口伸缩——实测坑，必须显式定死。）
+ * - HTML：宽 = 请求宽或默认宽，高渲染后实测。
+ * 全部经 maxWidth 与 maxPixels 收口。
+ */
+export function resolveCanvas(source, requestedWidth, caps) {
+    const mode = classifySource(source);
+    const reqW = requestedWidth && requestedWidth > 0 ? requestedWidth : undefined;
+    let width;
+    let height;
+    if (mode === 'svg') {
+        const c = parseSvgCanvas(source);
+        if (c.width && c.height) {
+            width = clampInt(reqW ?? c.width, 16, caps.maxWidth);
+            height = Math.max(16, Math.round(width * (c.height / c.width)));
+        }
+        else {
+            const aspect = c.aspect ?? 2 / 3;
+            width = clampInt(reqW ?? caps.defaultWidth, 16, caps.maxWidth);
+            height = Math.max(16, Math.round(width * aspect));
+        }
+        // 总像素收口：等比缩小
+        if (width * height > caps.maxPixels) {
+            const k = Math.sqrt(caps.maxPixels / (width * height));
+            width = Math.max(16, Math.floor(width * k));
+            height = Math.max(16, Math.floor(height * k));
+        }
+    }
+    else {
+        width = clampInt(reqW ?? caps.defaultWidth, 16, caps.maxWidth);
+        height = 'auto';
+    }
+    return { mode, width, height, html: buildShell(source, mode, width, height) };
+}
+/**
+ * 外壳文档：body 归零边距；SVG 模式用定宽定高容器把根 SVG 撑满（杜绝随视口伸缩）；
+ * HTML 模式定宽、高度自流。字体栈兜底中文与 emoji（部署机 macOS；模型可在标记内自定覆盖）。
+ */
+export function buildShell(source, mode, width, height) {
+    const base = 'html,body{margin:0;padding:0}' +
+        'body{font-family:"PingFang SC","Hiragino Sans GB","Noto Sans CJK SC","Apple Color Emoji",sans-serif}';
+    if (mode === 'svg') {
+        return (`<!DOCTYPE html><html><head><meta charset="utf-8"><style>${base}` +
+            `#aalis-draw{width:${width}px;height:${height}px;overflow:hidden}` +
+            `#aalis-draw>svg{display:block;width:100%;height:100%}</style></head>` +
+            `<body><div id="aalis-draw">${source}</div></body></html>`);
+    }
+    return (`<!DOCTYPE html><html><head><meta charset="utf-8"><style>${base}` +
+        `#aalis-draw{width:${width}px}</style></head>` +
+        `<body><div id="aalis-draw">${source}</div></body></html>`);
+}
+/**
+ * 动画标记 lint：静态检出已知的"作者级"错误类，作为 warning 返回给模型自纠。
+ * 渲染层只能忠实执行写错的动画——已知错误类在这里拦，未知错误类靠检查帧+视觉自检。
+ * 规则刻意窄（宁漏勿噪）：
+ *   R1 同一叶子元素同时挂 animateMotion 与位移类 animateTransform（rotate/translate）
+ *      —— 位移复合，轨迹漂移（本插件首个演示就犯过的错，实证类）。
+ *   R2 @keyframes 无限循环但 0% 与 100% 声明不一致 —— 循环处跳变。
+ */
+export function lintAnimationSource(source) {
+    const warnings = [];
+    // R1：叶子图形元素（不含嵌套容器，避免"g 下两个子元素各挂一种"的误报）
+    const leafRe = /<(circle|rect|ellipse|path|polygon|polyline|line|text|image|use)\b[^>]*>([\s\S]*?)<\/\1>/gi;
+    for (const m of source.matchAll(leafRe)) {
+        const inner = m[2];
+        const hasMotion = /<animateMotion\b/i.test(inner);
+        const hasShift = /<animateTransform\b[^>]*type\s*=\s*["'](?:rotate|translate)["']/i.test(inner);
+        if (hasMotion && hasShift) {
+            warnings.push(`<${m[1]}> 同时挂了 animateMotion 与位移类 animateTransform——两者位移会复合导致轨迹漂移，` +
+                '沿路径运动只保留 animateMotion 即可');
+            break; // 同类只报一次
+        }
+    }
+    // R2：无限循环 keyframes 首尾不一致
+    const kfRe = /@keyframes\s+([\w-]+)\s*\{([\s\S]*?)\}\s*(?=@|\.|<|$)/g;
+    const norm = (v) => v.replace(/\s+/g, '').replace(/;$/, '');
+    for (const m of source.matchAll(kfRe)) {
+        const nameUsedInfinite = new RegExp(`animation[^;]*\\b${m[1]}\\b[^;]*infinite`, 'i').test(source);
+        if (!nameUsedInfinite)
+            continue;
+        const first = m[2].match(/(?:^|\})\s*(?:0%|from)\s*\{([^}]*)\}/);
+        const last = m[2].match(/(?:^|\})\s*(?:100%|to)\s*\{([^}]*)\}/);
+        if (first && last && norm(first[1]) !== norm(last[1])) {
+            warnings.push(`@keyframes ${m[1]} 是无限循环但 0% 与 100% 状态不一致——循环处会跳变，无缝循环需首尾一致`);
+            break;
+        }
+    }
+    return warnings;
+}
+/**
+ * 请求放行判定（default-deny）：渲染页只允许内联资源。
+ * LLM 生成的标记是不可信输入——实测 <script> 会执行、外链会真发请求（SSRF/外泄口），
+ * 引擎层禁 JS + 本判定拦一切网络面：只放 about:blank（setContent 的初始导航）与 data:。
+ */
+export function allowRequest(url) {
+    return url === 'about:blank' || url.startsWith('data:');
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@aalis/plugin-draw",
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AalisLabs/Aalis.git",
+    "directory": "packages/plugin-draw"
+  },
+  "author": "Ace Nyan <ace@acenyan.com>",
+  "bugs": {
+    "url": "https://github.com/AalisLabs/Aalis/issues"
+  },
+  "homepage": "https://github.com/AalisLabs/Aalis#readme",
+  "description": "让纯文本模型画图：SVG/HTML 标记渲染为图片与 GIF 动图（无头浏览器 + ffmpeg）",
+  "type": "module",
+  "keywords": [
+    "aalis",
+    "aalis-plugin"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aalis/schema-config": ">=0.11.0 <1.0.0",
+    "@aalis/api-process": ">=0.5.1 <1.0.0",
+    "@aalis/api-storage": ">=0.5.5 <1.0.0",
+    "@aalis/api-tools": ">=0.6.0 <1.0.0",
+    "puppeteer": "^24.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "@aalis/core": "0.12.0"
+  },
+  "peerDependencies": {
+    "@aalis/core": ">=0.12.0 <1.0.0"
+  },
+  "aalis": {
+    "service": {
+      "optional": [
+        "tools",
+        "storage",
+        "process"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}