Skip to content

3.7.0

Latest

Choose a tag to compare

@Ruqiehou Ruqiehou released this 05 Sep 07:38
· 21 commits to main since this release

Joha v3.7.0 发版公告

发布日期: 2026-08-16


📋 版本概述

本次版本对 Joha 项目进行了重要的结构修正和功能增强,主要包含 adapter 模块的重新组织、新增完整测试套件、以及多项核心功能优化。


🏗️ 结构修正

Adapter 模块迁回

  • adapter 迁回 joha/ 下: adapter/ 由项目根目录迁回 joha/adapter/
  • 所有导入路径统一为 from joha.adapter import ...
  • 连接配置文件路径: joha/adapter/connection.yaml
  • 传输层 / 协议层 / 兼容导出层的三层架构保持不变

新增测试套件

  • 完整单元测试覆盖: group_conversation / history_manager / message_builder / message_queue / service
  • 运行方式: python -m pytest tests -q

✨ 功能更新

群聊双层记忆系统

  • 短时记忆: managers/group_conversation.py — 群对话上下文管理,存储于 storage/conversations/
  • 长期记忆: managers/group_memory.py — 持久化记忆存储,存储于 storage/memory/

消息队列增强

  • 新增过期消息定期清理功能 (message_queue_manager.process_expired())

多模态与存储优化

  • 优化图片处理逻辑
  • 存储操作增加线程安全保护

决策层重构

  • 合并 reply_config 职责到 reply_decision
  • 意图识别改为纯规则分类,移除 AI 依赖
  • 决策引擎 process() 统一入口,输出 EngineResult

人设系统

  • 支持多人设管理
  • 新增命令: /人设列表、/切换人设、/创建人设、/绑定人设、/删除人设

📚 文档同步

  • README / docs 全部按当前代码结构更新
  • 更新内容包括: adapter 路径、存储目录、命令表、API 参考等

📦 升级指南

导入路径变更

如果您从 v3.6.0 升级,请注意 adapter 导入路径的变化:

# v3.6.0 (旧)
from adapter.core import NapCatClient

# v3.7.0 (新)
from joha.adapter import NapCatClient

配置文件位置

连接配置文件已迁移至:

joha/adapter/connection.yaml

运行测试

python -m pytest tests -q

🐛 已知问题

无重大已知问题。


📝 完整变更日志

详细变更记录请查看 CHANGELOG.md


感谢使用 Joha!

如有问题或建议,欢迎反馈。