schemdraw — 可編輯的科學示意圖,具備來源可追溯性 是做什麼的?
腳本路徑:本技能安裝於
/skills/weekly-skill/,腳本絕對路徑為/skills/weekly-skill/scripts/(工作目錄是/app/work,不要使用相對路徑)。
產出一張正確、可編輯且符合匯出規範的圖形:每個實體/關係都可追溯至素材,圖例與資料一致,文字保持可選取,且匯出版本達到目標解析度。此技能存在的目的是為了防止以下失敗模式:圖片美觀但實體關係錯誤、基因名稱或濃度為虛構、圖例與資料不符,以及輸出僅為點陣圖而無法編輯。
一句話總結方法: 從素材中提取實體/關係 → 將它們佈局成分層 SVG(分組、可選取文字、箭頭方向依關係類型而定)→ 從相同來源資料建立圖表,並附上明確的圖例/顏色對應 → 匯出 PDF+PNG → 驗證可追溯性與匯出合約。
使用時機
- 輸入:一個案例檔案(預設為
/input/case.json),內含科學素材、可選的實體/關係列表、圖表資料與匯出規格。 - 輸出:在
/app/output下 —figure.svg、chart.svg、figure.pdf、figure.png、entities.json、export_report.json、validation.json、result.json。 - SVG 為可編輯的原始檔;PDF/PNG 為匯出版本。
流程(請依序執行)
階段 1 — 提取與繪圖
python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
- 讀取每個素材(文字/Markdown),合併提供的
entities/relations與從模式中提取的關係:X activates|promotes|enhances Y、X inhibits|suppresses|blocks Y、X -> Y、X --| Y、X binds|interacts with Y、X contains|includes Y。 - 每個關係都帶有
provenance(text-pattern加上來源引用)或來自提供的列表。 - 寫入
entities.json與分層的figure.svg:<g id="arrows">帶有data-source/data-target/data-type,<g id="nodes">每個實體一個群組並包含<text>標籤。箭頭顏色/線條樣式編碼關係類型(綠色 = 激活,紅色 = 抑制,虛線 = 包含)。 - 若案例中有圖表資料,寫入
chart.svg,其長條帶有data-label/data-value,圖例使用與長條相同的調色盤索引。
階段 2 — 匯出
python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300
LibreOffice 以無頭模式將 SVG 轉換為 PDF(向量、可選取文字);PyMuPDF 將 PDF 以要求的 DPI 點陣化為 PNG。寫入 export_report.json。若 LibreOffice 缺失,報告中會說明,且狀態變為 partial — 絕不會靜默失敗。
階段 3 — 驗證
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
檢查:
- 每個關係的端點都是已宣告的實體(無懸空的箭頭);
- 每個關係都有出處或來源引用;
- 圖例標籤與值與來源資料完全匹配;
- SVG 有
<text>(可選取)且至少有 2 層; - PDF 與 PNG 匯出存在,且 PNG 檔案大小不異常地小。
階段 4 — 複製交付物
mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
/app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json 由 validate.py 寫入;若存在也一併複製
必須遵守的規則
- 實體來自素材。 不得虛構基因名稱、濃度或時間點;模型添加的任何內容都必須有來源並標記。
- 關係方向由資料決定。
A activates B繪製為 A → B,不可反向;箭頭類型依關係類型而定。 - 圖例 ⇄ 資料一致性。 圖例標籤與顏色來自與長條相同的陣列;更改資料會改變圖例。
- 可編輯來源 + 符合規範的匯出。 始終同時提供 SVG(可編輯)與 PDF/PNG(匯出)。
- 匯出需經檢查,非預設成立。 DPI、字型嵌入與檔案存在與否皆記錄;匯出失敗會回報。
例外處理
| 情況 | 行為 |
|---|---|
| 無素材 / 空白 | 實體列表為空;仍會寫入帶有標題的 SVG |
| 關係端點未知 | 保留在 entities 中(從模式添加)並繪製 |
| 缺少圖表資料 | 跳過 chart.svg;entities.json.chart_svg = null |
| 缺少 LibreOffice | PDF/PNG 缺失,export_report.status = partial,記錄限制 |
| 無關係 | 僅有節點的 SVG;驗證會記錄 0 個關係 |
自我檢查
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"
必須為 valid: true;模型必須補足確定性提取器遺漏的任何實體/關係,且始終帶有來源。