Drawing 套件
pi-roundtable-drawing 會在 host 上用 node-canvas 畫 PNG,並把圖片附在 agent 的回覆裡。
它能畫人物關係圖、魔法陣、符印、神聖幾何圖形;如果你提供牌組,也能抽牌排陣。
它不呼叫圖片服務,也不需要 API key。
bun add pi-roundtable-drawing需要 Bun 1.4.4 以上,以及 >=0.50.0 <0.51.0 的 pi-roundtable peer dependency。
canvas 是原生相依套件;支援的平台會下載預先編譯的 binary,其他平台則需要 Cairo、Pango、JPEG、GIF、SVG 開發函式庫和編譯器。
各平台的安裝指令見套件 README(英文)。
import { drawing } from "pi-roundtable-drawing";
export default { // ...其他 roundtable 設定... plugins: [drawing({ deckDir: "./decks" })],};| 選項 | 預設值 | 用途 |
|---|---|---|
deckDir |
無 | 每個牌組各放一個子目錄。不設定時不會註冊 draw_cards 工具。 |
random |
Math.random |
關係圖版面與抽牌使用的亂數來源。套件匯出 seededRandom(seed),可重現結果。 |
minTier |
member |
可使用工具的最低 speaker tier;host 的 toolTiers 可以覆寫。 |
cardPresentation |
套件預設文字 | 可信任的 heading(draw, turn) 依牌組、張數、問題及 host 的 speaker/channel 回傳 {title, subtitle};reversedSuffix 可替換圖片上預設的 " (reversed)"。 |
mapLimits |
80 和 60 | { title?, text? }:關係圖標題與節點/邊線標籤的最長字數;各欄位都是整數(至少 1)。 |
permissive |
false |
接受較寬鬆 host 已傳來的無效請求:排除不存在的牌、共用牌陣位置、關係圖節點重複/留空或自我連結、使用無法解析的顏色;預設都會拒絕並回傳可修正的訊息。 |
套件不讀取環境變數,也不需要資料庫。
抽牌要自行準備 deck.json 和牌面圖;套件沒有附牌面。
牌組目錄不存在或內容無效時,host 會在啟動時停止。
manifest 只接受文件列出的欄位,圖片路徑也必須留在牌組目錄內。
工具與附件限制
Section titled “工具與附件限制”工具有 relationship_map、magic_circle_generate、sigil_generate、sacred_geometry_generate,以及選擇性加入的 draw_cards。
每次呼叫會附上一張圖片。
每輪最多附 10 個檔案,每個最多 10 MiB,合計最多 50 MiB;surface 也可能設更嚴格的限制。
被拒絕的呼叫不會附檔。
host 會在 agent 文字回覆後送出圖片,並使用相同的 speaker 身分。
核心附件規則見回覆附件。
完整工具參數、限制、牌組 manifest、原生相依套件安裝方式和測試範例,見pi-roundtable-drawing README(英文)。