# Studio UI 端面补全与 e2e 真跑通 — 需求

- 日期：2026-06-20
- 状态：方向已确认，进入执行
- 范围：muse-studio（用户端）UI 端面 + 全量 e2e 真实跑通 + 测试结论
- 关联：上一轮"未完成验证盘点"（代码核查带 file:line）；[`docs/项目功能与进度总览.md`](../项目功能与进度总览.md)；[`docs/mvp/进度总账.md`](../mvp/进度总账.md)

## 问题 frame

接口覆盖门 233/233 绿（机械口径）只验证了"后端接口层"，**≠ 端到端可用**：
- muse-studio 多个 UI 端面缺失或跑 MSW mock（`muse-studio/src/api/mocks/handlers/` 仍有 account/knowledge/content/ai 完整 mock 层）。
- e2e 此前因 PG 宿主 `100.64.0.8:5433` 离线无法实跑（"待实跑"妥协）。

**关键 unblock（2026-06-20 坐实）**：PG 恢复在线——直连可达、认证通过、Flyway 24 迁移全绿、`public` 165 表、Tailscale 直通无需绕代理。e2e "待实跑"前提消除。

## 目标与成果

1. 横向补全 muse-studio 4 组 UI 端面，每组接真实后端（去 MSW）。
2. **所有需要 e2e 的测试真实跑通**（不再"待实跑"）。
3. 整理一份**测试结论**（哪些绿 / 红 / 阻塞 + 原因），回写进度台账。

## 范围与优先级

本轮纳入（studio 用户端）：
- **P0：AI 候选采纳链 UI** — 编辑器挂 AIPanel/CandidatePanel、接真 `suggestion-merges`。Muse 核心"先审后入"闭环，后端已证、仅前端未接。
- P1：知识库工作台剩余 UI（草稿确认/忽略/recheck、实体关系 CRUD、发布工作流）
- P2：市场生产端 UI（发布/handoff/申诉提交追踪/许可详情）
- P3：个人中心 ~15 端点 UI（安全事件/导出下载/New-API绑定/配额申请/购买授权记录）

不在本轮（scope boundary）：
- admin 管理端 UI（Vben 模板相对完整、未核实缺口，另议）
- 两个未实现硬缺口（Meta impact-preview、AI Security 权限链）——属"未实现"非"缺 UI"，单独立项

## 完成标准（success criteria）

每个端面：① 前端去 MSW、调真实后端；② 前端组件/契约测试绿；③ **e2e 端到端实跑绿**（against 全栈：muse-server 连 PG `100.64.0.8` + Redis + studio）。

全局：④ 既有 9 个 e2e spec（accept-suggestion / knowledge-graph / market-publish / account-security-ack / knowledge-confirm / knowledge-bindings / live-read / agent-create / workspace）全部真实跑一遍，出结论。

## 执行计划

1. 坐实全栈起栈：muse-server 编译 + 起 + 连 PG/Redis；studio 起 dev server。
2. 跑通既有 e2e（先 knowledge-bindings 验证 PG unblock，再全量）。
3. P0：AI 候选采纳链 UI 补齐 + e2e。
4. P1–P3 按序跟进。
5. 整理测试结论台账（回写进度总账，不新增过程文档）。

## 依赖与假设

- PG `100.64.0.8:5433` 持续在线（`muse_slice_live`，user=root，密码在 `~/.config/muse-repo/infra.env`，不入库不外显）。
- Redis `127.0.0.1:6379` 可用。
- 后端可编译起栈（**待坐实**——可能有配置坑）。

## Open questions

- 全栈起栈是否有未知配置坑（待探测）。
- MSW mock 层最终去留（拆除 vs 保留 dev fallback）。
- admin 管理端 UI 缺口是否纳入后续。