vrr/TauriTavern
2
0
Fork 0
mirror of https://github.com/Darkatse/TauriTavern.git synced 2026-10-19 07:35:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
TauriTavern/docs/CurrentState/README.md
Darkatse 30fb766f44 feat(agent): Add Responses provider state continuation 
- Add run-scoped provider_state for Agent model calls, including
session tracking, message cursors, native continuation metadata, and
OpenAI Responses previous_response_id handling.

- Route OpenAI Responses through WebSocket sessions with incremental
Agent inputs, strip internal provider state from upstream/log payloads,
and persist per-round model responses for diagnostics.

- Document the current Custom OpenAI Responses and Agent provider_state
contracts, replacing stale phase-oriented notes with current behavior.
2026-05-02 02:42:38 -04:00

4 KiB
Raw Blame History

当前现状说明

本目录用于记录 已经落地 的模块现状，而不是方案讨论或未来规划。

它解决的是一个很具体的问题：

当我们要继续开发某个模块时，首先需要知道系统现在实际上怎样工作、边界在哪、哪些约束不能轻易打破。

因此，本目录下的文档应保持简短，并优先回答以下问题：

  1. 当前模块解决了什么问题
  2. 端到端链路现在如何工作
  3. 哪些能力已经支持，哪些明确不支持
  4. 后续开发时最容易误改的契约是什么

与其他文档目录的分工

  • docs/CurrentState/：当前实现快照与持续开发约束

当前条目

  1. docs/CurrentState/ThirdPartyExtensions.md

    • 第三方前端扩展兼容的当前状态
    • 包含前端加载链路、后端资源端点、目录语义与开发约束

  2. docs/CurrentState/MobileStyleAdaptation.md

    • 移动端样式适配现状（edge-to-edge / safe-area / 沉浸模式 / 第三方浮层兜底）
    • 包含 Android 原生注入链路、CSS 变量契约、前端消费与回归要点

  3. docs/CurrentState/EmbeddedRuntime.md

    • 消息内 iframe runtime（JSR/LWB）的生命周期管控现状（budget/park/hydrate/自愈/渲染事务）
    • 包含端到端链路、支持/不支持边界与持续开发约束

  4. docs/CurrentState/StartupOptimization.md

    • 开屏启动优化（Shell/Core/Full 分阶段启动）的当前实现快照
    • 包含前端启动编排、bootstrap 快照、扩展发现/激活、按需加载与可观测性约束

  5. docs/CurrentState/WindowedPayload.md

    • windowed payload（聊天记录分片读写）现状：tail 小窗口、before 分页、windowed patch/save 写入
    • 包含 Prompt-backfill（生成时按需回填）、页缓存与批量 IPC 的端到端链路与持续开发约束

  6. docs/CurrentState/MemoryExtensionApi.md

    • 记忆类扩展 API（window.__TAURITAVERN__.api.chat）的当前落地状态：楼层语义、按需历史、后端定位、纯文本检索与持久化

  7. docs/CurrentState/BootstrapOptimization.md

    • bootstrap / 启动链路中与冷启动内存基线相关的优化现状（如 tokenCache 避免 whole-load）

  8. docs/CurrentState/MediaAssetContract.md

    • <video>/<audio> 依赖的全平台媒体资源契约现状（Range/Content-Range/Android WebView workaround）

  9. docs/CurrentState/Sync.md

    • 同步（LAN Sync v1 / TT-Sync v2）当前实现快照：链路、状态目录、协议与事件语义约束
    • 包含 TT-Sync bundle/zstd、断线重试语义与最易误改的契约清单

  10. docs/CurrentState/DataDirectorySelection.md

  • 桌面端数据目录选择 / 启动期迁移的当前实现快照
  • 包含运行时引导配置、迁移恢复语义、effectively-empty 目录契约与持续开发约束
  1. docs/CurrentState/NativeApiFormats.md
  • Custom 原生 API 格式兼容现状（OpenAI Responses / Claude Messages / Gemini Interactions）
  • 包含端到端链路、支持/不支持边界与持续开发约束（尤其回滚 ST、Responses continuation 与 thought-signatures）
  1. docs/CurrentState/iOSPolicy.md
  • iOS/iPadOS-only 分发 Policy（profile + capabilities snapshot）当前实现快照
  • 包含 settings 契约、baseline 矩阵、后端裁决点与前端 UI 投影的维护约束
  1. docs/CurrentState/AgentFramework.md
  • Agent 框架实时开发进度跟踪
  • 当前记录 canonical model IR、provider native metadata 保真、上下文只读工具、workspace 读改工具循环、前端 dryRun adapter、Host ABI、验证命令与后续限制；具体架构与细节设计见 docs/AgentArchitecture.md、docs/AgentContract.md、docs/AgentImplementPlan.md 与 docs/Agent/
  1. docs/CurrentState/AgentProviderState.md
  • Agent provider_state 当前契约
  • 包含 run-scoped continuation、OpenAI Responses persistent WebSocket / incremental input / previous_response_id、内部字段剥离、native metadata fail-fast 与可观测性约束