Repository navigation
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!
如有问题或建议,欢迎反馈。