v0.5.2

0.5.2

中文

• 新增 Zotero 10 正式版支持，将插件兼容范围扩展为 Zotero 8.0 到 10.0.*。

English

• Added support for the Zotero 10 stable release and extended the compatibility range from Zotero 8.0 through 10.0.*.

v0.5.1

0.5.1

中文

• 修复论文修改内容较多或单段过长时“检查修改”和“创建版本”原生弹窗超过屏幕高度的问题；弹窗现在显示有长度上限的紧凑预览，完整差异仍可在右侧版本管理和完整对比窗口中查看。
• 修复独立“完整修改对比”窗口中类型筛选下拉重复显示且无法选择的问题，改用兼容 Zotero chrome/XHTML 窗口的分段单选控件。

English

• Fixed Check Changes and Create Version dialogs growing beyond the screen for large or very long manuscript edits. Native dialogs now show a bounded compact preview while the complete diff remains available in Version Management and Full Comparison.
• Fixed duplicated, unresponsive change-type options in the standalone Full Change Comparison window by replacing the native popup selector with a Zotero chrome/XHTML-compatible segmented radio control.

v0.5.0

0.5.0

中文

• 新增面向大规模论文改写的可扩展 .docx 差异引擎，使用唯一锚点、受限精确匹配和结构感知近似匹配，避免为大型文档构建完整二维 LCS 矩阵。
• 完整段落差异现在按章节和来源分页保存在仓库 sidecar 中，metadata schema 升级至 5，并兼容旧版本摘要和懒重建。
• 新增独立的完整修改对比窗口，支持章节导航、搜索、变化类型筛选、分页、移动段落识别和中英文词元高亮。
• 右侧历史详情改为紧凑摘要和按需增量加载，复制及 Markdown 导出可读取完整差异，不再受 20 条记录上限影响。
• 检查和创建版本共用同一次附件字节读取，并增加短期分析缓存、取消机制、路径安全校验和完整差异健康检查。
• 修复右侧“版本管理”标题图标与文字分离的问题。
• 设置页 About 区块中的 Homepage 现在指向开发者 GitHub 主页。

English

• Added a scalable .docx diff engine for large manuscript rewrites using unique anchors, bounded exact matching, and structure-aware approximate matching without allocating a full document-wide LCS matrix.
• Complete paragraph diffs are now stored as section/source-based sidecar pages. Metadata schema 5 preserves compatibility with legacy summaries and supports lazy reconstruction.
• Added a full comparison window with section navigation, search, change-type filters, pagination, moved-paragraph detection, and token-level highlighting for Chinese and Latin text.
• History Details now use compact summaries and incremental loading. Copy and Markdown export read the complete diff instead of being limited to 20 stored records.
• Change checks and version creation share one attachment byte read and add short-lived analysis caching, cancellation, path validation, and diff-storage health reporting.
• Fixed an issue where the right-pane "Version Management" icon could be separated from the title text.
• The Homepage link in the preferences About section now opens the developer's GitHub profile.

v0.4.2

0.4.2

中文

• 导出版本摘要现在会使用设置页保存的迁移导出目录；已配置目录时会直接在该目录自动生成摘要文件，未配置时保持原有保存对话框行为。
• 设置页 About 区块不再默认显示“尚未打开项目链接”，仅在打开项目链接成功或失败时显示状态反馈。
• 右侧栏历史详情新增“复制详情”和“导出该次修改摘要”，可生成适合发给指导老师或提交 issue 的 Markdown 内容。
• 长文档的历史详情现在默认折叠较长修改记录，可按需展开完整修改，减少右侧栏滚动卡顿。
• 健康检查结果新增独立“下一步建议”小节；Git 路径测试在检测到多个可用 Git 时可让用户选择保存的路径。
• 更新插件图标为更统一的 Git 分支与命令行风格，在设置页、右键菜单和 README 中保持一致展示。
• 右侧条目栏标题优化为“版本管理”，并在标题左侧加入插件图标，使其与 Zotero 界面风格更协调。

English

• Version summary exports now use the migration export directory saved in preferences. When configured, summary files are generated directly in that folder; otherwise the existing save-dialog behavior is preserved.
• The About section no longer shows the initial "Project link has not been opened yet" placeholder and only displays status feedback after opening a project link succeeds or fails.
• History Details in the right pane now include Copy Details and Export This Change Summary actions that generate Markdown suitable for advisor review or issue reports.
• Long document diffs in History Details are collapsed by default and can be expanded on demand, reducing right-pane scrolling friction.
• Health check results now include a separate Next Steps section, and Git path testing lets users choose which detected Git executable to save when multiple candidates are available.
• Updated the plugin icon to a unified Git-branch and command-line style across preferences, context menus, and the README.
• The right-side item pane title is now "Version Management" with the plugin icon shown beside it for a more native Zotero feel.

v0.4.0

中文

重要更新⚠

• 本次为重要更新：版本历史导入/导出已改为针对单个 Zotero 条目操作。现在请在条目右键菜单的“论文版本”中导出或导入当前条目的历史，避免误操作整个库。
• 右侧“论文版本”栏新增“历史详情”，可查看单次版本的说明、创建时间、文件信息、变化摘要和全部已保存修改记录。

历史详情

• 历史详情现在以右侧栏内嵌详情面板展示。

条目级导入导出

• 导入备份到当前条目时，可从备份包中选择一个来源历史并映射到当前条目；如果当前条目已有版本历史，插件会跳过导入，不会覆盖已有记录。
• 导出当前条目版本历史时，只打包 git4zotero 保存的本地历史，不包含 Zotero 原始附件文件。

设置与兼容性

• 迁移导出目录支持直接粘贴路径并自动保存；导出时会在该目录自动生成备份 ZIP 文件名。
• 优化 Windows/Zotero 下目录选择和 ZIP 导入的兜底提示，文件选择器不可用时可通过粘贴路径继续完成操作。

English

Highlights⚠

• Important update: version-history import/export now works on one Zotero item at a time. Use Paper Versions from the item context menu to export or import the selected item's history, reducing the risk of whole-library operations.
• The right-side Paper Versions pane now includes History Details for each saved version, showing the note, creation time, file information, change summary, and all saved change records.

History Details

• History Details now open as an inline panel in the right pane.

Item-Level Import and Export

• When importing into the current item, you can choose one source history from a backup and map it to the selected item; if that item already has history, import is skipped without overwriting.
• Exporting an item's version history packages only git4zotero's local history, not Zotero's original attachment files.

Preferences and Compatibility

• The migration export folder can be pasted and auto-saved; exports automatically create the backup ZIP filename in that folder.
• Improved fallback guidance for folder selection and backup ZIP import on Windows/Zotero, including pasted-path recovery when the file picker is unavailable.

v0.3.0

中文

• 修复设置页静态按钮重复绑定导致“打开 Git 安装指南”可能打开两个浏览器标签页的问题。
• 移除首次使用向导中的“论文条目”步骤，保留 Git、数据目录、迁移备份和排错准备四个环境配置与诊断步骤。
• 保留之前预发布版本的修改

English

• Fixed duplicate static preference button binding that could make “Open Git Install Guide” open two browser tabs.
• Removed the “Manuscript Item” step from the first-use guide while keeping the Git, data directory, migration backup, and troubleshooting setup steps.
• Retain changes from the previous pre-release version

v0.2.5

中文

• 新增迁移导出目录设置：可在设置页指定“导出全部版本历史...”的默认保存目录，迁移备份时保存对话框会优先打开该目录。
• 将首次使用向导升级为设置页内交互式弹窗：按 Git 准备、数据目录、迁移备份、论文条目和排错准备分步显示状态，并提供可执行检查与配置按钮。

English

• Added a migration export directory setting: the preferences pane can now set the default save directory for “Export All Version History...”, so migration backups open the save dialog in that directory first.
• Upgraded the first-use guide to an interactive preferences-pane modal: it now walks through Git setup, data directory, migration backup, manuscript item, and troubleshooting steps with status checks and action buttons.

v0.2.4

中文

• 增加恢复前可解释安全检查：恢复前显示目标版本、完整 Git hash、当前文件 hash、目标版本 hash、备份路径、文件可读/可写状态和 Git 工作树状态。
• 增强恢复执行保护：恢复时复用预检生成的备份路径，并在写入前重新校验当前文件 hash，避免确认后文件又被外部程序修改。
• 扩展健康检查建议，针对 Git、数据目录、写权限、已删除条目历史、metadata schema 以及 Git/index/metadata 一致性给出诊断和建议，不自动修复。
• 新增设置页“导出全部版本历史...”与“导入版本历史...”，用于备份、换电脑和迁移本地 git4zotero 版本仓库；导入只补充缺失仓库，不覆盖已有历史。
• 新增设置页“首次使用向导”“打开数据目录”“复制 issue 模板”“打开 Git 安装指南”等低风险入口。
• 右侧 论文版本 面板新增状态卡片，展示是否启用、Git 是否可用、最近版本、最近检查和未提交修改状态。
• 创建版本前新增确认摘要，尤其对 .doc 明确提示仅做文件级跟踪，不解析正文差异。
• README 增加首次使用、数据安全与恢复、导入/导出、诊断与健康检查和常见文件占用问题说明。

English

• Added explainable restore preflight checks that show target version, full Git hash, current file hash, target file hash, backup path, file read/write status, and Git working tree status before restore.
• Hardened restore execution by reusing the preflight backup path and re-checking the current file hash before writing, preventing accidental overwrite if the file changes after confirmation.
• Expanded health-check suggestions for Git, data directory, write permission, deleted-item history, metadata schema, and Git/index/metadata consistency without automatic repair.
• Added preference-pane “Export All Version History...” and “Import Version History...” actions for backup, computer migration, and local git4zotero repository migration; import only fills missing repositories and never overwrites existing history.
• Added low-risk preference-pane actions: first-use guide, open data directory, copy issue template, and open Git install guide.
• Added status cards to the right-side Paper Versions pane for enabled state, Git availability, latest version, latest check, and uncommitted-change state.
• Added a clearer confirmation summary before creating a version, including explicit .doc file-level tracking guidance.
• Expanded README coverage for first use, data safety and restore, import/export, diagnostics and health checks, and common file-lock issues.

v0.2.3

中文

• 在设置页增加“复制诊断信息”，用于生成默认脱敏的插件版本、Zotero 版本、系统、locale、Git、数据目录、当前条目状态和最近错误报告。
• 在设置页增加“运行健康检查”，覆盖 Git、数据目录、写权限、已删除条目历史和 metadata schema 检查。
• 增加最近错误持久化记录，Zotero 重启后仍可复制最近一次错误信息。
• 增加错误分级提示，区分用户可处理问题、Git 问题、文件状态问题和插件内部错误，并给出对应处理建议。

English

• Added “Copy Diagnostics” in the preferences pane to generate a redacted report with plugin version, Zotero version, system, locale, Git, data directory, current item status, and the most recent error.
• Added “Run Health Check” in the preferences pane for Git, data directory, write permission, deleted-item history, and metadata schema checks.
• Added persistent recent-error recording so the latest error remains available after Zotero restarts.
• Added categorized error guidance for user-actionable issues, Git issues, file-state issues, and internal plugin errors.

v0.2.2

中文

• 增加 Zotero 条目永久删除监听：移入回收站时保留版本历史，永久删除或清空回收站后自动清理对应插件仓库。
• 增加 git4zotero/index.json 仓库索引，用于匹配 Zotero 条目、附件和本地版本仓库。
• 增加设置页“已删除条目留下的版本历史”检查与清理入口，用于处理升级前遗留的无对应条目的版本历史。
• 增加安全校验，清理前确认路径位于插件数据目录且版本元数据与删除事件匹配。

English

• Added Zotero item deletion handling: repository history is retained when items move to trash and cleaned only after permanent deletion or trash emptying.
• Added a git4zotero/index.json repository index to map Zotero items, attachments, and local version repositories.
• Added preference-pane orphan history checks and cleanup for legacy unmanaged repository directories.
• Added safety checks so cleanup only removes plugin repositories whose paths and metadata match the deleted Zotero item.