在 Claude Science 或 Wisp 等智能體環境中生成科學圖表時,經常面臨樣式複用困難、代碼版本管理混亂的問題。本地圖表庫插件 Scientific Figure Library(SFL)提供了一套解決方案。它允許你在本地導入、審查併發布不可變的圖表模板,然後在多個項目中複用這些精確的模板。
是什麼¶
這是一個面向科學圖表的本地優先 MCP 服務器和 MCP 應用。作者爲 xuzhougeng。它將圖表及其代碼作爲不可變的 Release 存儲在用戶指定的磁盤目錄中,支持在 Pi、DeepSeek Harness (dsh)、Claude、Codex、Cursor 和 Wisp 等多個主機中複用。
核心功能¶
- 本地優先架構:MCP 服務器和 MCP 應用均基於本地運行,不依賴遠程存儲。
- 發佈與複用:導入圖表與代碼,審查後發佈不可變的 Release 到全局庫,隨後在項目中複用精確模板。
- MCP App 畫廊:提供瀏覽、精確預覽和用戶確認的界面,用於選擇模板。
- 檢索與物化:支持搜索、描述、預覽,最終確認並物化(materialize)一個精確的模板。
- 便攜管理:支持對庫進行便攜式的備份、恢復和分支操作。
安裝與啓用¶
- 前置條件:確保已安裝 Node.js 22+。
- 安裝插件:在 DeepSeek Harness 中執行以下命令。注意
--profile參數通常需要指定爲web。
dsh plugin --profile web add scientific-figure-library
- 重啓配置文件:安裝後需要重啓對應的配置文件以加載插件。
dsh --profile web
# 或
dsh web
- 基礎測試:安裝完成後,建議先測試以下工具以確保連接正常。
figure_library_get_skillfigure_library_source_status
典型用法¶
- 檢查狀態:調用
figure_library_source_status查看當前庫的狀態。如果寫入功能被禁用,需要幫助綁定一個絕對的全局庫目錄。 - 初始化工作區:如果提示
setup_required,在搜索前需要綁定一個本地工作區。 - 檢索模板:在 MCP App 中搜索本地已發佈的模板。
- 確認與物化:等待用戶確認一個模板卡片,然後規劃將其物化(materialize)到指定的空文件夾中。
適用場景與注意¶
- 適用場景:需要統一科研圖表風格、保持代碼與圖表版本一致性的團隊或個人。
- 運行機制:插件以當前 dsh 進程的權限運行。安裝前應檢查源碼與許可證。
- 環境要求:需要安裝 Node.js 22+。
- 執行權限:服務器不執行繪圖代碼,不包含模型,僅負責文件的哈希、版本管理和發佈。
- 檢索順序:默認檢索順序爲本地已發佈 → FigureYa → Open Figure Modules → 啓用的動態個人提供者。
- 社區快照:捆綁的社區快照是凍結的,且默認搜索中排除(
includeInDefaultSearch: false)。本地已發佈內容是事實來源。 - 首次設置:如果
setup_required,搜索前必須綁定本地工作區。
總結¶
Scientific Figure Library 通過將圖表模板的審查與發佈流程本地化,解決了多項目間圖表風格複用難的問題。其核心價值在於提供了一個持久化、可追溯的本地知識庫,讓圖表模板的管理變得可復現。