Scientific Figure Library v0.8.0

Scientific Figure Library v0.8.0

This release adds standalone local clients, a single Skill plus host-native image browsing for ordinary MCP hosts, and republishes the four host plugins. Compare the full source range: v0.7.0...v0.8.0.

SFL still does not execute plotting code. It manages, reviews, searches, previews, and materializes the exact assets you confirm. The standard MCP server now exposes 56 tools (53 in v0.7.0).

Choose a download

Pick the row that matches what you want to install. Every installer and plugin has a matching .sha256 sidecar in the asset list below.

I want to...	Download
Run SFL as a local app on this computer	Local client for your OS and CPU in the next table
Use SFL inside Wisp, Codex, Claude Code, or Cursor	That host's plugin ZIP
Install the MCP CLI from a tarball	scientific-figure-library-0.8.0.tgz

Bundled Node packages include a private Node.js 22 runtime (larger). no-node packages require an already installed Node.js 22+ and are much smaller. Local clients omit gallery images and download previews on demand; plugin ZIPs still include catalog thumbnails.

Local clients

System	Bundled Node (no extra runtime)	Use installed Node.js 22+	How to install
macOS Apple Silicon (M1-M4)	macos-arm64.dmg - 44 MB	macos-arm64-no-node.dmg - 4 MB	Drag the App into Applications. macOS 13+.
macOS Intel	macos-x64.dmg - 46 MB	macos-x64-no-node.dmg - 4 MB	Same as above. Do not mix arm64 and x64.
Windows x64	windows-x64.zip - 35 MB	windows-x64-no-node.zip - 3 MB	Unzip the whole folder, then run Start SFL.cmd.
Linux x64	linux-x64.zip - 45 MB	linux-x64-no-node.zip - 3 MB	Unzip the whole folder, then run ./start-sfl.sh.
Linux arm64	linux-arm64.zip - 45 MB	linux-arm64-no-node.zip - 3 MB	Same as Linux x64.

macOS DMGs are preview builds: ad-hoc signed, not Developer ID signed, and not notarized. After verifying the checksum, allow the app under System Settings -> Privacy & Security if macOS blocks the first open.

Host plugins (Node.js 22+ required)

Host	Download	Size	Install
Wisp Science	scientific-figure-library-wisp-0.8.0.zip	26 MB	Settings -> Plugins
Codex	scientific-figure-library-codex-0.8.0.zip	26 MB	Install the host plugin from the ZIP
Claude Code	scientific-figure-library-claude-0.8.0.zip	26 MB	Install the host plugin from the ZIP
Cursor	scientific-figure-library-cursor-0.8.0.zip	26 MB	Unzip to ~/.cursor/plugins/local/figure-library/
npm tarball	scientific-figure-library-0.8.0.tgz	27 MB	npm install --global ./scientific-figure-library-0.8.0.tgz
Wisp update feed	scientific-figure-library-wisp-update.json	-	Machine-readable feed for a future Wisp Update action

Do not register a raw figure-library MCP server and a host plugin at the same time; that duplicates tools. Plugin install steps: Quickstart.

Changes since v0.7.0

Local clients

• Native SwiftUI macOS app, packaged separately for Apple Silicon (macos-arm64) and Intel (macos-x64).
• Windows x64 and Linux x64 / arm64 local web clients: a bundled Node runtime starts a local page in the default browser.
• Every local client has two editions: bundled Node.js 22, or no-node using an installed Node.js 22+.
• In-app Connect external tools page copies real MCP config, CLI commands, Skill paths, and verification prompts for the current install and Node path.
• Local installers stay small: they do not ship FigureYa / Open Figure Modules gallery images. Previews and reference packs download on demand into the bound Library (indexes/preview-cache/, source-packs/).
• GitHub Pages tutorial covers install, first-run binding, checksums, upgrades, and proxy troubleshooting: 0.8.0 tutorial.

External MCP, Skill, and host-native browsing

• One core Skill (skills/figure-library). Description, organization, and style guidance are on-demand references, not extra Skills.
• figure_library_get_skill returns the same Skill text over MCP and works before Library binding.
• Ordinary MCP hosts can browse without the MCP App: search returns thumbnail URIs, figure_library_get_candidate_images returns labeled images, and figure_library_search_page is available to the model.
• figure_library_create_plot_task_headless hands an explicit user selection to the host as a plotting task. It does not approve preview, materialize, or execute code.
• The MCP App is optional. Hosts without Apps can still search, exact-preview, confirm, and materialize.
• Four host plugins (Wisp, Codex, Claude Code, Cursor) and the npm tarball are rebuilt from this tag.

Gallery, cache, and library browsing

• Local navigation is split into Gallery, My Library, and External Galleries.
• Default gallery browse, dual pagination, exact detail, copyable plot prompts, and source-pack download.
• Per-gallery image cache and reference-pack cache, including background tasks and status chips. Copy feedback is a closable toast.
• Optional system HTTP proxy (loopback CONNECT only, for example http://127.0.0.1:7897) so GitHub downloads do not treat Clash fake-ip addresses as the library.
• Extra card checkbox is hidden; title or empty card area still toggles selection. Gallery card titles show in full.
• Local cache is preview images plus source-pack ZIPs under the bound Library. Catalog-matching Open Modules pack ZIPs left unindexed after an interrupted persist can be adopted.
• Local web typography/layout refresh and npm run dev for source development.

Getting started

1. Download the matching file and its .sha256. Verify with shasum -a 256 <file> (Windows: certutil -hashfile <file> SHA256).
2. Local app: follow the installation tutorial. On first launch, bind a global Library and a Local workspace - SFL does not infer them from the current project.
3. Plugin: install for one host, start a new host session, then call figure_library_get_skill or figure_library_source_status. If setup is required, bind the two directories with plan/apply after you confirm the paths.
4. Keep the whole install directory together (runtime, dist, assets, Skill files). Do not move those folders on their own.

Limits and Node-path notes: INSTALL_LOCAL.md. Protocol: PROTOCOL.md.

Upgrade

Quit the app and any MCP process using the old install. Replace only the program directory or plugin; keep the Library and workspace directories. Reopen, check the Node path and Connect external tools page, and back up the Library before upgrading. Deleting the program does not delete your library.

Release provenance

• Tag v0.8.0 points to f7d9f8749598906675acb1bae8af8e9b28146f18.
• Plugin ZIPs, the npm tarball, local-client installers, SHA-256 sidecars, and the Wisp update feed were published from that commit.
• Packaging smoke and isolated tests are not a substitute for installing a real host plugin or completing desktop/provider acceptance.

---

Scientific Figure Library v0.8.0

本版本新增独立本地客户端，向普通 MCP 宿主提供单一核心 Skill 与宿主原生看图，并重新发布四个宿主插件。源码对照：v0.7.0...v0.8.0。

SFL 仍不执行绘图代码，只管理、审阅、检索、预览，并材料化你确认的精确资产。标准 MCP 服务现为 56 个工具（v0.7.0 为 53 个）。

选择下载

先看要安装什么。每个安装包和插件在下方资源列表中都有同名 .sha256 校验文件。

我要...	下载
在本机作为独立应用管理图库	下一表中对应操作系统和 CPU 的本地客户端
在 Wisp、Codex、Claude Code 或 Cursor 中使用	该宿主的插件 ZIP
用 npm 安装 MCP 命令	scientific-figure-library-0.8.0.tgz

内置 Node 包带私有 Node.js 22（体积较大）。no-node 包要求本机已安装 Node.js 22+，体积小很多。本地客户端不含图库图片，预览按需下载；插件 ZIP 仍包含目录缩略图。

本地客户端

系统	内置 Node（无需另装）	使用已安装 Node.js 22+	安装方式
macOS Apple Silicon（M 系列）	macos-arm64.dmg - 44 MB	macos-arm64-no-node.dmg - 4 MB	将 App 拖入“应用程序”。最低 macOS 13。
macOS Intel	macos-x64.dmg - 46 MB	macos-x64-no-node.dmg - 4 MB	同上。arm64 与 x64 不可混用。
Windows x64	windows-x64.zip - 35 MB	windows-x64-no-node.zip - 3 MB	解压整个文件夹，运行 Start SFL.cmd。
Linux x64	linux-x64.zip - 45 MB	linux-x64-no-node.zip - 3 MB	解压整个文件夹，运行 ./start-sfl.sh。
Linux arm64	linux-arm64.zip - 45 MB	linux-arm64-no-node.zip - 3 MB	与 Linux x64 相同。

macOS DMG 是预览版：ad-hoc 签名，尚未 Developer ID 签名，也未公证。校验通过后，若系统拦截首次打开，在“系统设置 -> 隐私与安全性”中允许。

宿主插件（需要 Node.js 22+）

宿主	下载	大小	安装
Wisp Science	scientific-figure-library-wisp-0.8.0.zip	26 MB	设置 -> 插件
Codex	scientific-figure-library-codex-0.8.0.zip	26 MB	按宿主插件方式安装 ZIP
Claude Code	scientific-figure-library-claude-0.8.0.zip	26 MB	按宿主插件方式安装 ZIP
Cursor	scientific-figure-library-cursor-0.8.0.zip	26 MB	解压到 ~/.cursor/plugins/local/figure-library/
npm 包	scientific-figure-library-0.8.0.tgz	27 MB	npm install --global ./scientific-figure-library-0.8.0.tgz
Wisp 更新 feed	scientific-figure-library-wisp-update.json	-	供后续 Wisp「更新」读取的机器可读清单

不要同时安装宿主插件和重复的原始 figure-library MCP 配置，否则工具会重复。插件步骤见 Quickstart。

相对 v0.7.0 的变化

本地客户端

• macOS 原生 SwiftUI App，Apple Silicon（macos-arm64）与 Intel（macos-x64）分别打包。
• Windows x64、Linux x64 / arm64 本地网页客户端：内置 Node 启动本机页面，并用默认浏览器打开。
• 每个平台都提供内置 Node.js 22 版，以及使用已安装 Node.js 22+ 的 no-node 版。
• 应用内「连接外部工具」页可复制当前安装目录和 Node 路径下的 MCP 配置、CLI 命令、Skill 路径和验证指令。
• 本地安装包不再附带 FigureYa / Open Figure Modules 图库图片。预览图和参考包按需下载到已绑定 Library（indexes/preview-cache/、source-packs/）。
• GitHub Pages 增加教程，覆盖安装、首次绑定、校验、升级和代理问题：0.8.0 教程。

外部 MCP、Skill 与宿主原生看图

• 只保留一个核心 Skill（skills/figure-library）。描述、组织、风格改为按需资料，不再作为独立 Skill。
• figure_library_get_skill 通过 MCP 返回同一份 Skill 文本，绑定图库之前即可读取。
• 普通 MCP 宿主可不加载 MCP App：搜索返回缩略图 URI，figure_library_get_candidate_images 返回带身份标签的图片，figure_library_search_page 对模型开放。
• figure_library_create_plot_task_headless 把用户明确选中的候选交给宿主作为绘图任务；它不批准预览、材料化或执行代码。
• MCP App 变为可选。没有 App 的宿主仍可完成搜索、精确预览、确认和材料化。
• Wisp、Codex、Claude Code、Cursor 四个插件和 npm 包均按本 tag 重新打包。

图库、缓存与本地浏览

• 本地导航拆成「图库」「我的图库」「外部图库」。
• 默认浏览、双分页、精确详情、复制绘图提示词、下载参考包。
• 按图库缓存预览图和参考包，支持后台任务和状态标记。复制成功用可关闭的 toast 提示。
• 可选系统 HTTP 代理（仅本机回环 CONNECT，例如 http://127.0.0.1:7897），避免把 Clash fake-ip 当成图库地址。
• 去掉卡片上多余的选择框；点击标题或空白区域仍可选择。卡片标题完整显示。
• 本地缓存只保留预览图和 source-pack ZIP，放在已绑定 Library 下。中断写入后、与当前 Catalog 匹配但未编入清单的 Open Modules 压缩包可以被接纳。
• 本地网页排版与布局调整，并提供 npm run dev 开发入口。

开始使用

1. 下载对应文件和同名 .sha256，用 shasum -a 256 文件名 校验（Windows 可用 certutil -hashfile 文件名 SHA256）。
2. 本地客户端按 安装教程 操作。首次启动绑定全局 Library 和 Local workspace；SFL 不会从当前项目推断这两个目录。
3. 插件：只装一个宿主，新开会话后调用 figure_library_get_skill 或 figure_library_source_status。若需要设置，确认路径后再 plan/apply 绑定。
4. 保留完整安装目录（runtime、dist、assets、Skill），不要单独挪走这些文件夹。

限制与 Node 路径见 INSTALL_LOCAL.md。协议见 PROTOCOL.md。

升级

退出 App 以及仍在使用旧程序的 MCP 进程。只替换程序目录或插件，保留 Library 与 workspace。重新打开后检查 Node 路径和「连接外部工具」页。升级前备份 Library。删除程序不会删除图库。

发布来源

• 标签 v0.8.0 指向 f7d9f8749598906675acb1bae8af8e9b28146f18。
• 四个插件 ZIP、npm 包、本地客户端安装包、SHA-256 校验文件和 Wisp 更新 feed 均来自该提交。
• 打包 smoke 与隔离测试不能代替真实宿主插件安装或桌面端验收。