v0.0.1-alpha.3

ICEDR v0.0.1-alpha.3

Important

这是一个用于部署验证和早期反馈的预发布版本。升级前请备份 data 目录、SQLite 数据库、本地文件和对象存储配置。

Highlights

• 修复 Windows 二进制启动失败问题。内置 SQLite 原生扩展现在会从可执行文件目录下加载，不再被 Node SEA 当作内置模块解析。
• 已验证二进制运行数据默认保存在可执行文件旁边，包括 data/icedr.sqlite 和 data/native/.../better_sqlite3.node。
• Docker 构建会在安装依赖前复制 pnpm patch 文件，CI 和镜像构建中的 patched dependency 可以正常安装。
• 下载文件继续提供 MD5 和 SHA256 校验信息，便于确认文件完整性。

Changed

• 二进制打包改为先由 Prisma 生成 SQLite 建表 SQL，再用 better-sqlite3 创建内置模板库，避开 Windows 上 prisma db push 的 schema-engine 空错误。
• SEA 启动代码会在加载后端 bundle 前注入全局文件系统 require，确保原生扩展可以从已释放到磁盘的文件加载。

Fixed

• 修复二进制加载 data/native/win32-x64/137/better_sqlite3.node 时出现 ERR_UNKNOWN_BUILTIN_MODULE 的问题。
• 修复打包阶段创建 SQLite 模板库时 Prisma schema-engine 返回空错误的问题。
• 修复 Docker 镜像构建时缺少 patches/entities@7.0.1.patch，导致 pnpm install --frozen-lockfile 失败的问题。
• 修复二进制启动排查时容易表现为在用户目录创建 data 的问题；默认路径现在明确位于可执行文件目录旁。

Upgrade Notes

• 二进制部署请替换为 v0.0.1-alpha.3 对应平台文件，并保留原来的 data 目录。
• Docker 部署请在镜像发布后拉取 corecherry/icedr-po:0.0.1-alpha.3 或 ghcr.io/cloudwhile/icedr-po:0.0.1-alpha.3。
• 预发布版本不会更新 Docker latest 标签，请使用明确的 0.0.1-alpha.3 标签。
• 本次发布不要求修改环境变量。

Known Issues

• 这仍然是预发布版本，稳定版前接口、配置字段和数据库结构仍可能调整。
• 只有 Release 页面列出的平台才提供官方二进制文件。

Compatibility

• Node.js 24
• pnpm 10.18.1
• Docker 镜像：corecherry/icedr-po:0.0.1-alpha.3、ghcr.io/cloudwhile/icedr-po:0.0.1-alpha.3
• Docker 平台：linux/amd64、linux/arm64
• 默认数据库：SQLite
• 可选数据库：PostgreSQL
• 文件存储：默认本地文件系统，可选 S3 / MinIO 兼容对象存储
• 已 smoke 测试二进制：Windows x86_64

Full Changelog

v0.0.1-alpha.2...v0.0.1-alpha.3

Release Assets

File	Size	MD5	SHA256
icedr_0.0.1-alpha.3_linux-arm64	137.0 MB	138178bd0c82c95f40404344abb10bbd	6c915253a95a13336173521e99d9cc02637b0763b370858df5b778911d35856e
icedr_0.0.1-alpha.3_linux-x86_64	139.1 MB	ae44247269086ddc17123d4d066ada49	80a182485be263e6d5a8e54804cf845aa182ae26a7ae39d28ed47c0680b7c44a
icedr_0.0.1-alpha.3_macos-arm64	136.1 MB	b0ec2f117567f19d5ccf26b2044967ab	55d59d3e45803ca74d4dddf5ab3beca1ceb40c06e8aa5c4da6e3cf381fdbc65b
icedr_0.0.1-alpha.3_macos-x86_64	138.3 MB	c609303bd861d394fa27eb2ab20c738b	dc452a1cadc767f9009ec2d6922cc4b25239962335a239e35443468e532ab9a2
icedr_0.0.1-alpha.3_windows-arm64.exe	98.8 MB	c062df7bd0395475919785d1e364d96d	8c627442e1cca2f7e38dffbd8536dc7cc5e905d136992dc6845307bdc41076ae
icedr_0.0.1-alpha.3_windows-x86_64.exe	109.7 MB	47e168f469629b793805b4316589e8c6	4dd965d40964cbf038779e94e7e99265211e87970c00ca84cf29b5cf9a177a41
MD5SUMS.txt	411 B	ee9fc9021da9f3c6e0df895a3e7613ad	7b5fe948382cef15cf1b24c9976f9ec14aa036fb268703d50b892ab19bcd27f5
SHA256SUMS.txt	603 B	11202c6aa6b10044eaf0434dbf149730	511926dcd7d66f3bdb9ef972bd315d3409db43fab2fa39e64bf015aed7157f86
release-manifest.json	1.8 KB	d8a6841bfd14bbc040c8f219ddc68906	d39706fdfb3beeb01980a0814498097bf5e17acee5acfb1c813531c40ae30e6f

File Checksums

下载目标文件和 SHA256SUMS.txt 后，在同一目录运行：

sha256sum -c SHA256SUMS.txt --ignore-missing

如需兼容性校验，也可以下载 MD5SUMS.txt 后运行：

md5sum -c MD5SUMS.txt --ignore-missing

命令输出 OK 表示本地文件与 Release 中记录的 checksum 匹配。