# 版本发布

> fabricjs-document-engine 更新日志：每个版本改了什么，从最早的保存和加载，到为 Fabric.js 6 和 7 冻结的 1.0 格式。

Source: https://fabricjs-document-engine.jscrate.dev/zh/docs/overview/releases
Last updated: 2026-09-28

这里是 fabricjs-document-engine 更新日志。每个版本都发布到 npm，并遵循语义化版本。从 1.0 开始，文档格式已经冻结，所有 1.x 版本都能打开旧版本保存的文件。

## 最新版本

下面的时间线读取自 GitHub releases。发布新版本后会自动更新。

- **1.0** (2026-09-28, latest): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v1.0
  - Complete document lifecycle support
  - Production ready public API
  - Stable backward compatible schema
  - Full compatibility test coverage
  - Performance benchmarks documented
  - Complete developer documentation
- **0.9** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.9
  - React hooks included
  - Framework independent state store
  - Document size limits added
  - Imported data safely cleaned
  - Cross-browser testing completed
- **0.8** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.8
  - Create named document versions
  - Restore previous document versions
  - Support older document formats
  - Import normal Fabric JSON
  - Automatic schema migration support
- **0.7** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.7
  - Export PNG and JPEG
  - Export WebP and SVG
  - Export editable document JSON
  - Custom export scale support
  - Validate assets before export
- **0.6** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.6
  - Register custom Fabric objects
  - Preserve custom object properties
  - Validate custom object types
  - Safe custom object loading
  - Custom serialization rules supported
- **0.5** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.5
  - Track document image assets
  - Track required document fonts
  - Detect missing assets early
  - Detect missing fonts early
  - Replace unavailable document assets
- **0.4** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.4
  - Recover work after refresh
  - Recover work after crashes
  - IndexedDB backup while editing
  - Restore temporary local images
  - Detect available recovery sessions
- **0.3** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.3
  - Automatic document autosave support
  - Prevent old save overwrites
  - Track unsaved document changes
  - Retry failed saves automatically
  - Custom storage adapters supported
- **0.2** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.2
  - Reliable undo and redo
  - One action, one history step
  - Group changes using transactions
  - IDs survive history changes
  - History memory limits included
- **0.1** (2026-09-28): https://github.com/re-sohail/fabricjs-document-engine/releases/tag/v0.1
  - Stable IDs for every object
  - Basic document save and load
  - Canvas metadata safely stored
  - Object ordering always preserved
  - Fabric 6 and 7 support

## 版本历史

完整的 changelog 在代码仓库里。简要来说：

| 版本  | 新增内容                                                                                  |
| ----- | ----------------------------------------------------------------------------------------- |
| 1.0.0 | 冻结的文档格式和 JSON Schema、`UNSAVED_CHANGES` 保护、`verifyStorageAdapter` 和兼容性政策 |
| 0.8.0 | 导入文档的安全限制、撤销历史的内存上限、大图撤销更快，并在 Firefox 和 WebKit 中测试       |
| 0.7.0 | React hooks、`createDocumentStateStore` 和 `document:change` 事件                         |
| 0.6.0 | 命名版本和自动版本，并能打开 Fabric.js 5、6 和 Fabric.js 7 的普通 JSON                    |
| 0.5.0 | 导出 PNG、JPEG、WebP、SVG 和 JSON，并在导出前检查                                         |
| 0.4.0 | 基于 IndexedDB 的崩溃恢复                                                                 |
| 0.3.0 | 图片和字体检查、上传和 `replaceImage`                                                     |
| 0.2.0 | 自动保存、同一时间只保存一次、修订号检查和重试                                            |
| 0.1.0 | 撤销和重做，支持事务和键盘快捷键                                                          |
| 0.0.0 | 稳定的 id、带版本的文档格式和安全加载                                                     |

## 1.x 的承诺

完整规则见 [GitHub 上的兼容性政策](https://github.com/re-sohail/fabricjs-document-engine/blob/main/docs/compatibility-policy.md)。简单说：在 1.x 期间，不会删除或重命名任何 API 名称、配置项、事件或错误码，保存过的文档也都能继续打开。新功能可能会加入。[fabricjs-document-engine 更新日志](https://github.com/re-sohail/fabricjs-document-engine/blob/main/CHANGELOG.md)会提前至少一个次版本公告要废弃的内容。

想及时收到 fabricjs-document-engine 更新日志，可以在 GitHub 上关注（watch）这个仓库，或查看 [npm 上的包](https://www.npmjs.com/package/fabricjs-document-engine)。
