v0.6.11

NextRec v0.6.11 — Release Notes

---

新增功能 | New Features & Improvements

功能 | Features

• 核心运行时从 basic/model.py 重构为 nextrec.engine 模块（trainer/predictor/validator/exporter/model），训练、评估、预测、导出职责拆分更清晰
• 统一模型家族 API 与目录结构：matching / ranking / multitask / pretrain / sequential
• 新增序列建模支持：SASRec（nextrec/models/sequential）
• 新增包级默认日志初始化（导入 nextrec 即提供基础日志输出）
• nextrec.data 新增公开数据处理接口导出（parse_sequence_value, to_object_array）

工程与依赖 | Build & Packaging

• ONNX 与实验追踪改为可选依赖：
  • pip install "nextrec[onnx]"
  • pip install "nextrec[tracking]"
• CLI 预设配置目录统一迁移至 configs/

CLI

• CLI 训练/预测流程跟随新 engine 重构同步升级
• 配置模板与参数校验逻辑更新，命令行可用性测试补齐（test_cli.py）

模型 | Models

• 匹配模型命名统一：retrieval 家族迁移为 matching
• 多任务目录命名统一：multi_task 迁移为 multitask
• RQ-VAE 模块迁移至 pretrain 家族并统一基类接口
• Ranking/Matching/Multitask 模型统一继承方式与基类适配

修复 | Fixes

• 修复流式推理（stream mode infer）相关问题
• 修复 valid_split 相关切分逻辑问题
• 修复/收敛分组评估与部分指标行为不一致问题

测试 | Tests

• 新增：test_cli.py、test_handle_valid_split.py、test_pretrain_models.py、test_utils_onnx.py、test_utils_torch.py
• 更新：test_base_model_fit.py、test_evaluate_grouped.py、test_losses.py、test_predict_expand.py、test_preprocessor.py 等
• 测试命名同步统一：test_match_models.py -> test_matching_models.py

文档 | Docs

• README / README_en、快速上手、CLI、API、教程文档与 Notebook 全面更新
• 示例脚本命名与模型家族命名保持一致（match -> matching）

兼容性说明 | Compatibility Notes

• 存在目录与导入路径变更（如 retrieval -> matching, multi_task -> multitask），旧代码可能需调整 import
• tree_base 与分布式示例相关内容已从当前主干中移除

---

NextRec v0.6.11 — Release Notes

Features

• Refactored core runtime from basic/model.py into the new nextrec.engine modules (trainer/predictor/validator/exporter/model)
• Unified model-family API and package layout: matching / ranking / multitask / pretrain / sequential
• Added sequential model support with SASRec
• Added package-level default logging initialization on import nextrec
• Exposed public data helpers in nextrec.data (parse_sequence_value, to_object_array)

Build & Packaging

• ONNX and experiment tracking are now optional extras:
  • pip install "nextrec[onnx]"
  • pip install "nextrec[tracking]"
• CLI preset configs were reorganized into configs/

CLI

• CLI train/predict flow upgraded to align with the new engine architecture
• Config templates and validation logic refreshed, with dedicated CLI tests added (test_cli.py)

Models

• Renamed model family from retrieval to matching
• Renamed package from multi_task to multitask
• Moved RQ-VAE into the pretrain family with unified base interfaces
• Standardized base-class integration across ranking/matching/multitask models

Fixes

• Fixed stream-mode inference issues
• Fixed valid_split handling bugs
• Fixed grouped evaluation and related metric consistency issues

Tests

• Added test_cli.py, test_handle_valid_split.py, test_pretrain_models.py, test_utils_onnx.py, test_utils_torch.py
• Updated test_base_model_fit.py, test_evaluate_grouped.py, test_losses.py, test_predict_expand.py, test_preprocessor.py, etc.
• Renamed test_match_models.py to test_matching_models.py

Docs

• Refreshed README/README_en, quick-start, CLI/API docs, tutorials, and notebooks
• Synced tutorial/example naming with new family naming (match -> matching)

Compatibility Notes

• Import paths changed in multiple places (e.g., retrieval -> matching, multi_task -> multitask)
• tree_base modules and distributed tutorial examples are no longer present in current mainline