Repository navigation
Releases
Releases · DragonGong/zotero-math-patch
Zotero Math Patch v0.4.0 (Whole-Note Experiment)
这是整篇笔记 AI 协议的实验预发布,与现有 Render Markdown Math 和 Process Math with AI 并存,便于 A/B 测试。
主要变化
- 新增
Process Whole Note with AI (Experimental):一次发送完整安全文档,让模型利用整篇上下文标注公式。 - 不发送原始 Zotero HTML;代码、链接、附件、引用及特殊节点继续使用受保护占位符。
- 模型必须逐字符回显安全文档,只能插入公式标记并返回 LaTeX 表;普通文本或结构有任何变化都会拒绝写回。
- 协议失败时最多完整重试一次;通过后仍执行现有 DOM、安全、重叠和 LaTeX 校验,并保持预览、并发编辑检查、回滚和原子保存。
- 默认最大输出长度提高到 32768,可配置上限提高到 384000。
- 同时包含 v0.3.9 和 v0.3.10 的完整块归一化与空结果二次审计改进。
安装与隐私
这是预发布版,不会通过当前稳定版 updates.json 自动推送。请手动下载 XPI 覆盖安装并重启 Zotero。整篇实验模式会把笔记中的全部安全文本发送给用户配置的模型服务;响应需要完整回显这些文本,协议失败时可能再发送一次。诊断日志默认保存在本机并可能包含完整正文,请按 README 中的隐私说明使用。
验证
npm test: 全部通过npm run build: 成功- XPI SHA-256:
4911e75d7126932b7319ad0fcaed55a2682e16e7bec21986431d906eb0d35798
Zotero Math Patch v0.3.8
Highlights
- Added the manual
Process Math with AIworkflow for OpenAI-compatible services while preservingRender Markdown Math. - Added the Zotero
Math Patchsettings pane, local credential storage, connection testing, previews, request timeouts, long-note batching, and atomic note saves. - Added seven-day local JSONL diagnostics with credential redaction and configurable storage.
- Added a native Zotero progress indicator with real batch and repair stages.
- Improved the model repair harness for invalid JSON operations, exact source targeting, bounded retries, and truncated responses.
- Exposed existing Zotero formulas as protected mathematical context so fragmented block formulas can be reconstructed and normalized safely.
- Coalesced redundant inline operations already covered by complete block operations while retaining strict rejection of genuine conflicts.
- Retained hard protection for citations, attachments, links, code, media, scripts, styles, and Zotero special nodes.
Verification
- All automated tests pass.
- Replayed the reported 20-operation overlap log: 8 redundant operations were safely coalesced into 12 final operations with no repair request and one atomic save.
- Compatible with Zotero 7.0 through 9.0.x.
Download integrity
zotero-math-patch.xpi
SHA-256: 500a6bbecaf59622212f5dff02cf7e92d8ba08e9c9a75c63513160397c1e7d87
See the README for configuration, privacy, logging, and installation details.
Zotero Math Patch v0.2.4
主要更新
- 保留原有的
Render Markdown Math本地规则命令,并新增手动触发的Process Math with AI。 - 在 Zotero 设置中新增独立的
Math Patch页面,支持 OpenAI Compatible 接口、API Key、模型、超时、分块大小、输出长度和自定义提示词。 - 大模型只接收经过保护和编号的普通文本块,只返回公式操作;插件不会让模型覆盖整篇 HTML。
- 本地严格验证块编号、原文、出现次数、重叠范围和 LaTeX 安全性,全部通过后才会预览并原子保存。
- 支持长笔记分块、跨段块级公式、重复操作去重、冲突拒绝、超时、取消和安全错误提示。
- 修复 Zotero 9 中设置按钮、Firefox 140 凭据存储、XPI 安装元数据和 AI 预览窗口加载问题。
- 原有方括号公式、Markdown 公式和括号内短公式规则保持可用。
隐私
只有用户手动执行 Process Math with AI 时,待处理的普通笔记文本才会发送到用户配置的模型服务。API Key 仅保存在 Zotero/Firefox 本机凭据存储中,不写入仓库或日志。第三方接口的数据处理规则由对应服务商决定。
兼容性
- Zotero 7.0 至 9.0.x
- OpenAI Compatible Chat Completions
- 已在 Windows Zotero 9.0.5 实际验证
安装
下载下方的 zotero-math-patch.xpi,在 Zotero 的 工具 -> 插件 中选择 Install Add-on From File...。覆盖升级后请重启 Zotero。
校验
SHA-256: C88A0622D072EBDB6F47888C94A767E710D72365907B5E78560CEFC98D107E29
测试:npm test 全部通过,npm run build 成功。