Skip to content

Releases: Cedar-wood/formula-forge

Release list

Formula Forge 0.1.0-beta.12 — Windows test preview

Formula Forge 0.1.0-beta.12 — Windows test preview Pre-release
Pre-release

Choose a tag to compare

View all tags
@Cedar-wood Cedar-wood released this 31 Aug 08:45
Immutable release. Only release title and notes can be modified.
v0.1.0-beta.12
6b1ab5b

Formula Forge：Zotero 10 的图表与公式工作台

Formula Forge 是一款面向 Zotero 10 的开源插件，用于从 PDF 中提取图、表和独立公式，并在 Zotero 内完成集中浏览、公式识别、人工审核与可恢复删除。

当前阶段定位为 Windows 测试预览版，采用手动安装 XPI 的方式发布。每个版本的已验证环境、改动和文件哈希以对应 Release 附件为准。

适合谁使用

  • 需要从论文 PDF 中整理图、表或公式的科研人员与学生。
  • 希望在 Zotero 内集中查看多篇文献图表，而不是逐页翻阅 PDF 的用户。
  • 需要把公式图片转换为 LaTeX，并保留人工复核与批准记录的用户。
  • 希望将提取结果写入 Zotero 笔记或标注，同时保留来源定位的用户。

主要能力

  • 本地提取： PDF 读取、页面渲染和版面检测在本机完成，运行时无需下载检测模型。
  • Reader 工作流： 在 Zotero PDF Reader 侧栏中分析并查看图、表和公式，可复制、保存、校正裁图、跳转来源或写入笔记。
  • Formula Forge 图表库： 按“文献 → PDF 附件 → 页码”集中浏览结果，并保留瀑布流和文献分栏两种布局。
  • Formula Review 公式审核： 对公式 LaTeX 候选进行比较、编辑、预览、批准或拒绝；最终批准始终由用户完成。
  • 批量处理： 支持批量分析 Zotero 文献或 PDF 附件，并可创建笔记或 Zotero 图片标注。
  • 安全回收： 单条结果或当前多选可移入保留 30 天的回收区；恢复不会覆盖已经重新分析出的较新数据。
  • 结果导出： 可导出选中的图、表和公式 PNG，并附带 SHA-256 元数据；只有人工批准的公式才会导出 .tex。

一个典型使用流程

  1. 在 Zotero 中打开论文 PDF，通过 Formula Forge Reader 入口分析图、表和公式。
  2. 在“Formula Forge 图表库”中跨文献筛选、查看和勾选所需结果。
  3. 对需要 LaTeX 的公式使用自定义模型服务生成候选。
  4. 在“Formula Review”中人工核对、编辑并批准最终 LaTeX。
  5. 将结果复制、导出、写入笔记或创建 Zotero 标注；误删内容可在 30 天内从设置页恢复。

可恢复删除

  • 图表库和 Reader 支持单条结果移入回收区。
  • 图表库支持最多 1,000 条结果的批量回收。
  • 包含人工批准公式时增加二次确认。
  • 回收事务保留结果记录、图片、缓存、翻译和公式案件，且不改变结果 schema v7。
  • 遇到恢复冲突时保留回收数据，不覆盖较新的分析结果。
  • 已生成的 Zotero 标注不会因结果回收而自动删除。

隐私与网络访问

PDF 解析、版面检测、图片和结果存储默认留在当前设备。Formula Forge 不要求登录 Zotero Sync。

公式 OCR 是可选功能。只有在用户自行配置 OpenAI-compatible 或 Anthropic endpoint 并主动发起任务时，插件才会向该服务发送公式 PNG 裁图；不会发送整页 PDF。API 密钥优先保存到 Zotero 的安全凭证设施，若该能力不可用则仅保存在当前会话内存中。使用第三方模型服务可能产生费用，其数据处理规则由相应服务提供方决定。

安装与兼容范围

  1. 下载目标版本的 formula-forge-<version>.xpi。
  2. 在 Zotero 中打开“工具 → 插件”。
  3. 选择“从文件安装插件”，选中 XPI，并按提示重启 Zotero。

使用前请注意：

  • 当前阶段面向 Windows x64 和 Zotero 10；每个版本实际声明支持的 Windows/Zotero 组合以该版本 Release Notes 和测试报告为准。
  • 分发方式：仅手动安装，不提供自动更新清单。
  • 预览版建议：安装或升级前备份 Zotero 数据目录和 Formula Forge 本地结果。

开源、上游与独立身份

Formula Forge 采用 AGPL-3.0-or-later 许可证，是基于 PDF Figure/Zotero Figure 演进的独立衍生项目。项目保留完整上游署名，同时使用独立的插件 ID、图标、偏好分支、结果目录、凭证命名空间和发布渠道，可与原版同时安装。

Formula Forge 是独立的第三方项目，与 Zotero、Corporation for Digital Scholarship、Polygon、Zotero Figure 或 Stage One Software 均无隶属、授权或背书关系。“Zotero”仅用于说明兼容平台。

发布校验与反馈

每次发布均应提供对应 Git tag、Release Notes、源码包、RELEASE-MANIFEST.json 和 SHA256SUMS.txt。下载后可使用校验和文件核对 XPI 与源码包完整性。

问题反馈时，请提供 Windows 版本、Zotero 精确版本、插件版本、复现步骤和去除个人信息后的日志；不要提交 API 密钥、PDF 原文或 Zotero 数据库。

Loading