JARVIS/development-doc/plan/hermes-update/phase-h6-frontend-hermes-first-session-model.md

# H6 前端 Hermes-first Session Model

## 1. 目标

让前端从“runtime toggle + Jarvis 默认假设”过渡到 **Hermes-first session model**。

## 2. 当前问题

当前前端已经支持：
- `runtime: 'jarvis' | 'hermes'`

但本质上仍存在：
- 默认 runtime = jarvis
- 大量 Jarvis-specific 文案与状态
- runtime 只是一个请求字符串
- session/run metadata 不是一等状态

## 3. 方向

前端长期目标不是让用户一直选 runtime，而是：
- 普通用户默认走 Hermes-first 路径
- runtime toggle 仅保留给灰度、调试、回滚
- conversation/session/run metadata 进入更明确的状态模型

## 4. 推荐调整点

### 4.1 Transport Layer
- `frontend/src/api/conversation.ts`

保持 transport 职责，不再承载过多 runtime 语义。

### 4.2 Chat Runtime State
- `frontend/src/pages/chat/composables/useChatView.ts`
- `frontend/src/stores/conversation.ts`

需要逐步减少：
- `selectedRuntime = 'jarvis'` 这类默认假设
- `jarvisNote` / `JARVIS THINKING` 等强绑定文案
- 仅靠本地拼装 model label 的方式

### 4.3 Session/Run Metadata
建议逐步提升为一等状态：
- active runtime
- run status
- session status（warm/resumed/cold）
- runtime diagnostics summary

## 5. UI 原则

1. chat 仍是消息流，不变成终端模拟器。
2. 普通用户不需要长期理解 runtime 架构。
3. 迁移期保留 toggle，但它属于 admin/dev 工具。
4. 历史 conversation 渲染逻辑应尽量保持稳定。

## 6. 推荐文件变更

- `frontend/src/api/conversation.ts`
- `frontend/src/pages/chat/composables/useChatView.ts`
- `frontend/src/pages/chat/index.vue`
- `frontend/src/stores/conversation.ts`
- `frontend/src/api/agent.ts`

## 7. 完成标准

- [ ] 前端减少 Jarvis-default 假设
- [ ] runtime toggle 可转向灰度/调试用途
- [ ] session/run metadata 开始成为一等状态
- [ ] 普通聊天体验保持稳定