Community影像github.com

diagram-studio

重建、美化並建立圖表(架構圖、流程圖、管線、系統概覽、代理循環),產生清晰且可編輯的 PNG + SVG。核心功能是將現有圖表圖片(模糊、低解析度、AI 生成、雜亂或帶有水印)高保真地重新繪製,保留其精確的文字、佈局、顏色和外觀(手繪或乾淨/扁平),同時使其銳利化。

diagram-studio 是什麼?

Diagram Studio 是一個 AI 代理技能,專門用於重建、美化和建立各種圖表,例如架構圖、流程圖、管線、系統概覽和代理循環。其核心功能是將現有圖表圖片(模糊、低解析度、AI 生成、雜亂或帶有水印)以高保真度重新繪製,保留原始的文字、佈局、顏色和風格(手繪或乾淨/扁平),並輸出為銳利且可編輯的 PNG 和 SVG 向量格式。此技能特別適用於由方框、箭頭和文字組成的圖片,效果優於一般 AI 圖片生成或放大工具,因為它將圖片重建為向量,確保每個文字皆保持精確。它還支援重新風格化圖表(如手繪風、Excalidraw 風格、白板風、藍圖風、乾淨企業風、學術風、暗色風),並可從文字、程式碼或筆記建立新圖表,完整支援中文。此技能適用於 Codex、Claude Code 等代理平台,僅需 Node 18+ 環境即可執行,無需網路連線或套件安裝。其工作流程包括盤點、基於模板撰寫 JSON 規格、渲染、根據檢查清單進行視覺審查,並除錯至零錯誤,最終交付清晰的 PNG、SVG 和 JSON 檔案。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/stlmx/diagram-studio/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Diagram Studio

將 JSON 規格轉換為清晰的圖表。外觀可以完全配置:

  • 手繪風格: 使用 rough.js 的抖動效果和手寫字體。
  • 清晰向量: 無抖動,使用無襯線或襯線字體,柔和陰影。
  • 兩者之間的任何風格。

所有文字都會被轉換為輪廓,因此 SVG 和 PNG 在任何地方看起來都相同。自動檢查工具會捕捉重疊、溢出文字、邊界上的標籤以及穿過方塊的箭頭。

所有功能都已打包:只需要 Node 18+,無需 npm install 且無需網路。 下方的 SKILL_DIR 指的是此技能資料夾的絕對路徑(包含此檔案的資料夾)。

node SKILL_DIR/scripts/render.mjs diagram.json --out out/     # → out/diagram.png (2x), .svg, .report.json, .tiles/

0. 在 Codex、Claude Code 或其他代理中執行

  • SKILL_DIR:
    • 在 Codex 中,使用技能根目錄表擴展技能的相對路徑(例如 r0/diagram-studio/SKILL.md → ~/.codex/skills/diagram-studio)。
    • 在 Claude Code 中,通常位於 ~/.claude/skills/diagram-studio。
    • 總是使用該絕對路徑來呼叫腳本。
  • 檢視圖片是強制性的:原始圖片、網格、圖塊和比較結果。
    • Codex:使用 view_image 工具並指定 PNG 路徑。render.mjs 會為此寫入 name.preview.png(≤ 1400 px),因此無需自行調整圖片大小;如有需要,可使用 name.tiles/*.png 查看細節。
    • Claude Code:使用 Read 工具。
    • 絕不要僅根據 lint 輸出判斷渲染結果。
  • 沙盒友善:
    • 只需要 node。沒有網路呼叫且無需安裝。
    • 輸出到 --out 指定的資料夾;請將其保留在工作區內,例如 ./diagram-out。
    • WebP/HEIC 轉換會寫入系統暫存目錄。
  • 使用者貼了一張圖片而不是給出路徑: 如果你能看到附件路徑,請直接使用它。否則詢問檔案路徑,因為工具需要真實檔案。
  • 完成後: 列出 PNG、SVG 和 JSON 的絕對路徑,以便使用者開啟。

1. 選擇任務

使用者需求任務閱讀下一步
“讓這張圖片更清晰 / 更高解析度 / 更乾淨”、“重新繪製 / 重建 / 復刻 / 高清重建這個”A. 從圖片重建。 以保真度為優先:除非另有說明,否則保持原始風格references/rebuild-from-image.md(必需的)
“美化 / 整理這個圖表”A + 打磨。 與 A 相同,然後改善層級結構、間距和對齊references/rebuild-from-image.md
從描述、程式碼或筆記建立新圖表B. 新建圖表references/spec.md
不同的外觀(“改成手繪風格”、“扁平企業風”、“藍圖風”、“用於學術論文”)C. 重新風格化references/style-guide.md

對於給定的圖片,預設情況下需匹配其風格:手繪風格保持手繪,扁平風格保持扁平,並保留其顏色和字體類別。僅在使用者要求時才改變外觀。預設設定是起點,而非限制;styleOverrides、自訂調色板和自訂字型檔案("fonts")可以重現幾乎任何外觀。僅在請求確實模稜兩可時才詢問保真度等級,例如“美化”但沒有參考風格。否則預設為忠實還原 + 更清晰。

從 templates/ 中最接近的範本開始:將其複製到工作資料夾並編輯副本。預覽圖在 assets/gallery/ 中。範本是一種模式,而非內容:替換 所有 文字,並保持原始來源中的換行和箭頭完全一致。--expect 可以捕捉到遺漏或措辭改變。

範本展示內容
dense-rebuild.json密集架構圖的重建:明確的坐標、卡片、面板、合併的連接器、內聯標籤
pipeline-rag.json由左至右的管線:使用 connect、rightOf 的列、自動調整大小的面板
layered-architecture-zh.json中文分層架構:使用 below 堆疊的列、扇入箭頭、圓柱體
flowchart-decision.json流程圖:藥丸形、菱形、是/否分支、迴圈箭頭
agent-loop.json循環:曲線箭頭、徽章、橢圓形中心樞紐
auto-layout.json無坐標:使用具有群組的 ELK 自動佈局

2. 循環(每個任務)

  1. 先盤點。 逐字列出每個文字字串(將其儲存為 texts.txt,每行一個)、每個節點、每個箭頭(從 → 到,標籤)和每個群組。不要發明或遺漏任何內容。

  2. 撰寫 name.json,從一個範本開始。

  3. 渲染:node SKILL_DIR/scripts/render.mjs name.json --out OUT --expect texts.txt

  4. 修正每個 ERROR;每個錯誤都有具體的 → 修復方式。修正 WARN,除非是故意的,並在相應的元素或箭頭上使用 "ignore": ["code"] 來靜音故意產生的警告。

  5. 查看 OUT/name.png 和 OUT/name.tiles/*.png,並與原始圖片進行比較(使用 scripts/compare.mjs)。執行 prompts/visual-review.md 中的檢查清單;linter 無法判斷意義、平衡或保真度。

  6. 重複步驟 3–5,直到有 0 個錯誤且看起來合理(通常需要 2–4 輪)。

  7. 交付:

    • name.png:2x;用於列印請使用 --scale 3。
    • name.svg:向量格式。
    • name.json:保留以供後續編輯。

    添加一行關於你保留了什麼以及改進了什麼的說明。

3. 60 秒規格

{
  "canvas": { "width": 1600 },
  "style": "marker",
  "title": "Checkout Service",
  "subtitle": "{blue:clients} · {purple:services} · {green:data}",
  "elements": [
    { "id": "web", "title": "Web app", "icon": "app-window", "x": 120, "y": 220 },
    { "id": "api", "title": "API", "color": "purple", "emphasis": true, "rightOf": "web", "gap": 160,
      "lines": ["`POST /checkout`", { "text": "validates cart", "muted": true }] },
    { "id": "db", "type": "cylinder", "title": "Orders DB", "color": "green", "below": "api", "gap": 120 },
    { "id": "core", "type": "panel", "title": "Backend", "color": "purple", "contains": ["api", "db"] },
    { "id": "n1", "type": "note", "text": "Idempotent by **order id**", "rightOf": "core", "gap": 40 }
  ],
  "arrows": [
    { "from": "web", "to": "api", "label": "HTTPS" },
    { "from": "api", "to": "db", "label": "INSERT", "color": "green" }
  ]
}
  • 元素類型: box(預設)、pill、ellipse、circle、diamond、cylinder、note、card、panel、text、icon、badge、image、path(自訂 SVG 形狀),以及佈局輔助元素 row、column 和 group。

  • 定位每個元素,使用以下其中一種方式:

    • 使用左上角的 x/y,或使用中心的 cx/cy。
    • 使用 below / above / rightOf / leftOf 加上 gap。
    • 使用 contains,它會自動將面板調整為適合其子元素的大小。

    大小會自動計算。設定 w/h 以精確匹配原始圖片。

  • 文字: title 為粗體,\n 會換行。lines 是正文行。文字內的標記:

    • **bold**(粗體)
    • `code`(使用等寬字體)
    • {green:span} 和 {muted:span}
    • ->(繪製為箭頭字形)

    中英文可以自由混合。可以為每個元素設定 size、textSize、font、textColor 和 align。

  • 顏色 使用色系(blue purple green orange red teal yellow pink gray navy)、色調(blue.tint)、#hex 或純 CSS 名稱,如 white,透過 color、fill、stroke 和 textColor 設定。

  • 箭頭 連接 from 到 to:

    • 固定一側並使用 "id.right" 或 "id.right+20" 沿該側滑動。
    • 標籤:使用 label,透過 labelPos(above、below、left、right 或 inline)放置,並使用 labelAt 微調位置。
    • 外觀:dash、color、width 和 head(end、start、both 或 none)。
    • 路徑:使用 via 點、points(精確折線)或 "route": "curve"。

每個鍵的詳細說明請參考 references/spec.md。

4. 外觀:風格、調色板、字型、效果

  • 風格預設:

    • 手繪風格:marker(預設)、neat、excalidraw、sketchy、whiteboard、pencil、blueprint、chalk。
    • 清晰風格:clean、paper。

    任何預設欄位都可以透過 styleOverrides 覆蓋:

    • roughness(0 = 完美直線)和 bowing
    • fillStyle(solid、hachure、cross-hatch、dots 或 none)
    • strokeScale、cornerRadius
    • shadow(none、soft 或 hard)
    • font、cjkFont、codeFont、background
  • 調色板: marker、pastel、excalidraw、mono、academic、colorblind、modern、blueprint、chalkboard、midnight。要精確重現原始圖片的顏色,請執行 node SKILL_DIR/scripts/palette.mjs original.png 並貼上結果。

  • 字型:

    • 手寫字型:shantell、kalam、caveat、patrick、architects。
    • 無襯線字型:inter。襯線字型:serif。等寬字型:mono。
    • 中日韓字型(CJK):kai(手寫風格)、kuaile(俏皮風格)、sans-sc(乾淨風格)。
    • 你自己的 .ttf/.otf/.woff:"fonts": {"brand": {"regular": "Brand.ttf", "bold": "Brand-Bold.ttf"}},然後使用 "font": "brand"。
  • 目錄: assets/gallery/styles.png、palettes.png 和 fonts.png。使用 scripts/catalog.mjs 重新生成它們。

  • 圖示: 超過 1500 個 Lucide 圖示。使用 node SKILL_DIR/scripts/icons.mjs search 数据库 robot queue 搜尋,並使用 icons.mjs sheet a,b,c 預覽。

  • 原始圖片工具:

    • grid.mjs:在原始圖片上覆蓋坐標網格。請閱讀紅色軸標籤,不要讀取像素位置。
    • fontmatch.mjs:在原始圖片的放大裁切旁顯示每種字型的範例文字。
    • palette.mjs:提取原始圖片的顏色。
    • crop.mjs:裁切出 Logo、照片或螢幕截圖,作為 image 元素嵌入。
    • compare.mjs:並排檢視;添加 --crop x,y,w,h 可將兩張圖片縮放到同一區域進行比較。
  • 深色或替代版本: 保持相同的規格,僅更改 palette(midnight、blueprint 或 chalkboard)或 style,然後使用另一個 --name 渲染。

  • 用於投影片(PPT、Keynote): "canvas": {"aspect": "16:9"} 會將圖片填充到投影片比例。"background": "transparent" 會產生帶有 Alpha 通道的 PNG。SVG 也可以直接貼上。

5. 清晰度規則(始終適用)

  1. 嚴格保留給定的文字:標籤、程式碼識別碼和中文術語。除非被要求,否則不要發明、翻譯或遺漏文字。
  2. 讓層級結構可視化:
    • 每個方塊使用粗體標題。
    • 將識別碼作為正文或 code 文字。
    • 將解釋作為 muted 文字。
    • 章節標題使用其章節的顏色。
  3. 顏色代表某種意義: 每個區域或角色使用一個色系,並保持一致。箭頭標籤繼承其箭頭的顏色。
  4. 保留呼吸空間:
    • 對於帶有標籤箭頭連接的形狀之間,間距 ≥ 60 px;否則 ≥ 24 px。
    • 使用 contains 來適應面板。
    • 不要讓標籤位於邊界上。
  5. 縮小時仍然可讀:
    • 文字 ≥ 18 px(預設:節點標題 30、正文 25、標籤 24)。
    • 畫布寬度 1400–2200 px,長寬比在 1:2 和 3:1 之間。否則 linter 會發出警告。
    • 超過 6 個節點的長鏈:將其蛇形排列成 2–3 行,或使用 ELK 的 "direction": "DOWN",而不是一個非常長的行。
  6. 減少交叉,避免繞路。 在添加 via 之前,先進行對齊和重新排序。
  7. 在重建任務中,進行打磨而非重新設計: 改善對齊、間距和層級結構,但保留拓撲、閱讀順序和風格識別度。

6. 完成的定義

  • render.mjs 報告 0 個錯誤。任何剩餘的警告都是故意產生並已使用 ignore 靜音。
  • 每個盤點字串都存在且拼寫精確(--expect texts.txt 通過)。
  • 你已檢視 PNG 和圖塊,並對重建的圖片與原始圖片進行了並排比較:結構相同、風格識別度相同、更清晰。
  • 你已交付 PNG、SVG 和 JSON,並附帶簡短的“保留/改進”說明。

7. 疑難排解

  • node: command not found:請安裝 Node 18+。無需其他操作。
  • 當 sips、magick、dwebp、ffmpeg 或 Python PIL 可用時,WebP、HEIC、BMP 或 TIFF 輸入會自動轉換。否則請向使用者索取 PNG 或 JPEG 檔案。
  • 字元呈現為 ?:捆綁的字型涵蓋拉丁字母、GB2312 簡體中文和常見符號。如果缺少字元,請重新措辭,或註冊包含該字元的字型。
  • 有關每個 lint 代碼及其修復方式,請參閱 references/troubleshooting.md。

相關技能