Skip to content

v1.4.0 - 下一代架构

Choose a tag to compare

@MengBad MengBad released this 13 Jun 05:26
· 0 commits to main since this release

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

升级指南

  1. 覆盖重启即可
  2. 无数据迁移需求
  3. 所有配置项向后兼容
  4. 新增的 StateStore 和 Observatory 功能自动可用

兼容性

  • 向后兼容 v1.3.0
  • 所有现有 API 端点保持不变
  • 新增 API 端点为增量添加