在 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 通过将图表模板的审查与发布流程本地化,解决了多项目间图表风格复用难的问题。其核心价值在于提供了一个持久化、可追溯的本地知识库,让图表模板的管理变得可复现。