发布日期：2026年6月20日
版本状态：Pre‑Release（预发布）
预计正式发布：2026年6月14日（因中期项目调整，延期至今日）
📢 致歉与说明
首先，感谢各位对 Nexknit 的关注与支持。
我们原计划在 6月14日 前发布 v0.3.0 正式版，但由于中期阶段项目优先级调整及部分测试资源紧张，我们不得不将上线时间推迟至今。对此我们深表歉意。
本次发布的 v0.3.0‑pre 为预发布版本，尚未经过完整的生产环境测试，部分边缘场景可能仍存在未知问题。如果您在使用过程中遇到任何异常，请及时通过 [Issue 页面] 或邮件反馈，我们将尽快修复。
🚀 新增功能
离线通知（Offline Notifications）
- Worker 现可在定时任务中自动检测离线节点，并通过 Cloudflare Email Routing 发送邮件告警。
- 支持自定义离线判定阈值（OFFLINE_THRESHOLD_MS，默认 30 分钟）。
- 新增两个 Secrets 用于邮件配置：
- NOTIFICATION_EMAIL – 接收告警的邮箱地址
- MAIL_FROM – 发件人地址（需与 Cloudflare Email Routing 配置一致）
配置示例：
npx wrangler secret put NOTIFICATION_EMAIL
npx wrangler secret put MAIL_FROM
环境变量说明：
| OFFLINE_THRESHOLD_MS | 1800000（30分钟） | 节点连续无响应判定为离线的时长 |
| NOTIFICATION_EMAIL | 空（必填） | 告警邮件接收地址 |
| MAIL_FROM | 空（必填） | 邮件发件人地址 |
🧪 测试套件完善
为提升代码质量与覆盖率，本次新增了 5 个测试文件，覆盖网关、系统平台、HTTP 健康检查、本地存储及集成场景。
新增测试文件
| tests/unit/test_gateway_complete.py | 13 | HTTP 发送、消息解析、载荷创建 |
| tests/unit/test_system_platform.py | 11 | 平台特定实现（CPU/内存/磁盘/网络） |
| tests/unit/test_http_alive_complete.py | 12 | HTTP 健康检查并发与边界测试 |
| tests/unit/test_local_storage_complete.py | 9 | 本地存储完整覆盖 |
| tests/integration/test_gateway_integration_complete.py | 7 | 端到端集成测试 |
测试统计
- 总测试数：138 个（单元测试 116 个，集成测试 22 个）
- 通过率：100%（134 passed，4 skipped 因环境依赖）
📚 文档更新
-
assets/TEST_CN.md
- 更新测试套件结构与用例列表
- 补充覆盖率统计表格及执行命令说明
-
README.md
- 新增 Offline Notifications 章节（英文）
- 包含配置指南与完整环境变量表格
-
assets/README_CN.md
- 新增 离线通知 章节（中文）
🐞 修复的问题
- 修复异步测试配置问题（已安装 pytest-asyncio 并正确配置）
- 修复线程守护标志测试中的断言错误
- 修复部分断言对 int / float 类型的兼容性
- 修复状态消息断言在特定场景下的误报
🔧 如何验证
您可以运行以下命令执行全部测试，确认核心功能正常：
python -m pytest tests/ -v
📝 后续计划
- 在收集反馈后，我们将于充分的评估后发布 v0.3.0 正式版，届时将修复预发布阶段发现的所有问题。
- 同时，我们正在规划 v0.4.0 的功能路线，包括 多通知渠道支持（Webhook、Telegram 等）和 更细粒度的离线策略。
再次感谢您的耐心与支持！
如有任何问题，欢迎随时联系我们。
—— Nexknit 开发团队
