v1.4.0 - 下一代架构
v1.4.0 - 下一代架构:StateStore 统一、Runtime Event 增强、Observatory 深化、WebUI 重构
核心亮点
1. StateStore 统一抽象层
- 新增 �nima/state_store/ 包,提供统一的状态存储接口
- StateSource 协议:统一的状态源接口
- JsonStateSource:JSON 文件原子读写
- MarkdownStateSource:Markdown 文件原子读写
- JsonlStateSource:JSONL 文件 append-only
- StateStore 主类:snapshot/diff/rollback/metadata
- 17 个新测试覆盖
2. Runtime Event Timeline 增强
- EventSnapshot:事件快照数据类
- EventDiff:事件差异数据类
- RuntimeEventBus 新方法:
- snapshot():创建事件快照
- diff():计算事件差异
ollback():回滚到指定快照
- compact():压缩旧事件
- get_snapshot() / list_snapshots() / delete_snapshot():快照管理
- 3 个新测试覆盖
3. Cognitive Observatory UI 深化
- 新增 8 个 API 端点:
- /api/event_search:事件全文搜索
- /api/state_snapshot:创建状态快照
- /api/state_rollback:回滚到指定快照
- /api/state_diff:计算快照差异
- /api/snapshot_list:列出所有快照
- /api/snapshot_delete:删除指定快照
- /api/cross_session_trend:跨会话趋势对比
- /api/event_compact:压缩旧事件
- 6 个新测试覆盖
4. WebUI 重构
- 将 1616 行单文件重构为 10 个清晰的逻辑段落
- CSS 按功能分组:变量、头部导航、内容面板、观测卡片、时间线、响应式
- JavaScript 模块化:核心工具、观测加载器、时间线加载器、初始化
- 移除外部 Google Fonts 依赖,使用系统字体栈
- 保持所有 14+ 观测面板功能
5. Python 3.14 兼容
- pytest.ini 添加警告过滤器
- 测试输出从 50 warnings 降为 0
测试结果
ext 435 passed, 0 warnings in 30.32s
升级指南
- 覆盖重启即可
- 无数据迁移需求
- 所有配置项向后兼容
- 新增的 StateStore 和 Observatory 功能自动可用
兼容性
- 向后兼容 v1.3.0
- 所有现有 API 端点保持不变
- 新增 API 端点为增量添加