Skip to content

Persist v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 27 May 08:47
v0.1.0
226887f

概述

Persist v0.1.0 — Stateful Chat Runtime

首个可运行里程碑：Persistent Execution Runtime 的地基版本。Chat 是当前第一种 execution form，具备 Provider 抽象、流式执行、Session 持久化与 Runtime Replay（历史 reconstruction）。

Persist is fundamentally an execution runtime with persistence and replayability.

Added

  • Monorepo 结构（pnpm workspaces）

    • @persist/shared — 唯一契约源（Session / Message / RuntimeChunk / ChatProvider / SessionStore）
    • @persist/runtime — persistence-aware executeChat pipeline
    • @persist/provider — QwenProvider（DashScope OpenAI-compatible HTTP）
    • @persist/storage — SQLite + Drizzle schema + SqliteSessionStore
    • @persist/api — Fastify + SSE transport adapter
    • @persist/web — Next.js UI shell（无 Runtime 逻辑）

  • RuntimeChunk 事件流（Runtime-native，非 OpenAI delta 直通）

    • message-start / text-delta / message-end / usage / error / done

  • REST API（v0.1）

    • POST /api/sessions — 创建 Session
    • GET /api/sessions/:id — 获取 Session 与消息
    • POST /api/sessions/:id/messages — 流式 Chat（SSE）
    • GET /api/sessions/:id/replay — 历史 reconstruction（不重新调用 LLM）

  • 持久化模型

    • Session：userId nullable、metadata JSON
    • Message：Runtime artifact（completionState、providerMetadata、timestamps）

  • 测试 — Vitest：shared contracts、provider mock HTTP、runtime stream

  • CI/CD

    • CI：Prettier → ESLint → typecheck → test → build
    • CD：main 分支构建产物（Actions Artifacts）
    • Release：tag v*.*.* 触发 GitHub Release 与构建包

Architecture

  • Core（shared / runtime）与 Integration（provider / api）分层
  • runtime 仅依赖 ChatProvider 接口，禁止绑定具体 Provider
  • provider 不依赖 runtime（Vendor Protocol Adaptation only）
  • Persistence-first：Runtime 生命周期天然包含持久化

明确未包含（后续 Phase）

  • Memory Runtime（summary-based）
  • Tool Runtime（MCP）
  • Planning Runtime
  • Auth / 多用户 / Vector DB / Agent Loop / Event Bus

快速开始

pnpm install
# 在项目根目录创建 .env（勿提交），配置 DASHSCOPE_API_KEY 等
pnpm run build:packages
pnpm dev        # API :3001
pnpm dev:web    # Web :3000

贡献者

  • lens68
Assets 5
Loading