boardx / boardx/workspacex

v2 工作台缺三样可观测面:消息级上下文快照 / 逐条思考链 / 权威 run 状态条

Open
#3,023 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
0
Forks
0
Avg merge
1h 7m
Merged PRs (30d)
969

Description

## 现象

三样旧屏有、v2 没有的可观测面,**仓库里已经以注释形式登记过,但没有 issue 跟踪**:

`apps/web/lib/copilotkit-v2-run-progress.ts:43-49`(原文):

> · **上下文快照 L1-L3(`MessageContextSnapshot`)/ 逐条思考链(`MessageThinkingChain`)/ `AgentRunStatus` 权威状态条** —— ❌ v2 侧**没有**真实数据源:这三样读的都是 `AgentRunView` 上 AG-UI 协议里根本不存在的字段(上下文层级、思考步骤明细、权威 run 状态)。本轮如实登记为不做,写进 backlog,不伪造一个看起来像那么回事的假面板。

这条 backlog 从未被开成 issue。#2890 把旧屏的最后一条可达路由也去掉之后,它从「v2 上暂时没有」变成了「产品里没有」。

## 逐条影响

### ① 消息级上下文快照(`context-snapshot-toggle` / `context-snapshot-detail`)

- 渲染点:`apps/web/components/chat/message-context-snapshot.tsx`
- 唯一消费者:`chat-live-message-panel.tsx:1201`(旧屏)
- 后端端点 `GET /agent-runs/:runId/context-snapshot` 因此**在产品里没有任何 UI 消费者**——F157 落地时特意补的那个"四层上下文组装对用户可见"的口子被整个抹掉了。
- 卡住的 e2e:`context-engine.spec.ts` 两条(L2 摘要 / F190 工具轨迹回喂)的后半段、`chat-agent-skill-context.spec.ts` 的 F155。

### ② 权威 run 状态条(`chat-live-agent-run-status`)

- 渲染点:`apps/web/components/chat/chat-live-message-panel-helpers.tsx:222-223`,携带 `data-run-status` / `data-result-message-id`。
- v2 只有 `copilotkit-v2-running-indicator`(`role="status"` 的 `sr-only` 活动区)+ `run-trace-panel`,**没有权威终态**(`succeeded` / `failed`)也没有写回消息 id。
- 用户影响:run 失败时界面上没有一个说得清"这一轮到底成没成"的位置;e2e 影响:多条用例原本靠它等终态,现在只能改成直连 `GET /agent-runs/:id` 轮询——把一件本该用户可见的事降级成了 API 事实。

### ③ 逐条思考链(`MessageThinkingChain`)

同 ①,唯一消费者是旧屏。

## 相关

issue #2997。请在裁决"补哪几样"之前不要把上述 spec 的断言删掉或改宽。

## 真栈实测(2026-09-08,SHA `94f6dda03`)

深链页面上 `context-snapshot-toggle` 计数为 **0**;`chat-live-agent-run-status` 计数为 **0**。

## 连带的 e2e 代价(已在 issue #2997 的 PR 里如实落地)

因为没有权威 run 状态条,原本"在界面上等这一轮 run 走到 succeeded"的用例只能改成直连 `GET /agent-runs/:id` 轮询——**把一件本该用户可见的事降级成了 API 事实**。受影响的 helper 见:

- `apps/web/e2e/context-engine.spec.ts` 的 `sendAndAwaitReply`
- `apps/web/e2e/chat-agent-skill-context.spec.ts` 的 `sendMessage` / `sendAndAwaitRun`
- `apps/web/e2e/chat-attachment-image-vision-extraction.spec.ts`

快照徽标那半的断言原文保留为 `test.fixme`,没有删、没有改宽。

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the backlog comment in apps/web/lib/copilotkit-v2-run-progress.ts:43-49, then inspect the listed v2 and legacy rendering points and issue #2997. Review the affected e2e specs and their helpers, preserving the existing test.fixme assertions. Done requires an agreed decision about which missing surfaces to implement and corresponding UI-visible data sources and tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
frontend, observability
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.