Skip to content

PR 详情页可读性改进:知识库参考区块重构+页面小字减量 - #496

Merged
nghqqa merged 4 commits into
mainfrom
ux/rag-references-layout
Oct 21, 2026
Merged

nghqqa merged 4 commits into
mainfrom
ux/rag-references-layout

Conversation

@nghqqa

@nghqqa nghqqa commented Oct 20, 2026 •

Copy link
Copy Markdown
Owner

纯前端可读性波次(不动 RAG 检索/授权/持久化/审查逻辑/审批门禁/API 契约/状态语义)。

第一批:知识库参考区块重构(e512aed)

  1. 双区定性:快照(历史执行证据)vs 实时检索(当前对照),副标题互不冒充
  2. 引用卡片:文档名/行号/相关度主信息;预览限宽换行+3 行截断+展开收起;追溯字段收次级行
  3. 边界声明区块级单次;纯文本渲染零注入;色彩对齐设计系统

第二批:页面小字减量(76e7e43 + 本批,按用户反馈终版口径=做减法不放大学体)

  1. RunTracePanel 零调用收敛:6 张零值统计卡+两个空明细盒 → 一行如实空集说明
    (真实空集/非降级语义保留);有调用时完整布局不变
  2. 删除三段纯解释小字块:发布区块『发布前会自动核对 head…』、『三个动作相互独立…』、
    应用修复区块『应用前自动重核远端 head…』(零测试依赖;置灰/按钮标号已承载语义)
  3. TraceDisclosures 三条边界说明 → 默认收起的 details(文本保留 DOM,语义/测试契约不变)
  4. 字号保持原阶(11/12)——按反馈方向为『去掉一部分』而非放大

测试与验证

  • 前端全量 221/221;vite build 通过;PR CI 全绿
  • 隔离栈真页截图:Skill/RAG 留痕区噪音消除(边界说明默认收起)、无横向溢出

纯前端改进(不改 RAG 检索/授权/持久化/审查逻辑/审批门禁/API 契约):
- 双区定性强化:源 A「审查时保存的引用快照(历史执行证据)」+副标题(执行期检索并
  留存,语料更新不改写);源 B「当前知识库检索(实时对照)」+副标题(打开页面时的
  查询,不写入执行期快照、不代表审查时内容)——历史与实时互不冒充
- 引用卡片化:主信息行(文档名/行号/相关度徽章)→ 纯文本预览(限宽自然换行、
  >160 字符默认 3 行截断+展开全文/收起)→ 次级追溯行(doc/chunk sha、模型@Iv、
  语料分支、trusted=false 单行省略,完整值 title 悬浮)——不与正文重复铺开
- 安全边界声明收敛为区块级单次(语义不移除不弱化);快照区保留不可变说明副标题
- 纯文本渲染:snippet 不解析 Markdown/HTML(不可信文本零注入面)
- 设计系统对齐:色彩改用 console.css :root 变量与 DESIGN.md 色板成员
  (var(--c-inset)/var(--c-border)/var(--c-border-strong)/#1d5da4),零自造色
- 状态全覆盖不变:loading/empty/未记录/provider_unavailable/model_missing/
  no_query_context/error/403·401 隐藏

测试:rag-run-references 冒烟 8/8——R1-R6 语义沿用更新断言,新增 R7(截断→展开
→收起往返)、R8(追溯元数据+XSS 纯文本安全+overflowWrap 样式);前端其余门禁
70/70、构建通过;隔离栈真页桌面 1280/窄屏 375 截图验证无横向溢出、审批区未挤压。
用户实测反馈:整页小字太多、观感差。本批不改任何逻辑/API/状态语义:
- 字阶统一(ReviewArtifactsPanel 全文件):11px→12(纯 meta)、12px→13(说明性
  文字全部升档)——消除 11px 层,建立 meta 12 / 说明 13 / 正文 14(antd 默认)三级
- RunTracePanel 零调用收敛:Skill/RAG 调用留痕在零调用时不再渲染 6 张零值统计卡
  +两个空明细盒(整块视觉噪音)——收敛为一行如实空集说明(真实空集语义保留,
  边界文案三段照常可见);有调用时完整统计与明细不变
- 测试:run-trace 零态断言同步(合并文案+零值卡不再上屏);前端全量 221/221、
  build 通过;隔离栈真页桌面/窄屏截图验证零溢出
@nghqqa nghqqa changed the title PR 详情页知识库参考区块:信息层级与可读性改进 PR 详情页可读性改进:知识库参考区块重构+整页字阶提升+零调用留痕收敛 Oct 20, 2026
用户反馈澄清:『小字太多』要去掉一部分,而不是放大字体。
- 回退第二批的字号放大(ReviewArtifactsPanel 恢复 11/12 原阶;#496 第一批 RAG 区块不变)
- 删除三段纯解释小字块(零测试依赖):
  ① 发布区块『发布前会自动核对 head…』(置灰说明已覆盖该语义)
  ② 『三个动作相互独立…前一步完成不会自动执行下一步』(①②按钮标号已自明)
  ③ 应用修复区块『应用前自动重核远端 head…』(同①模式)
- TraceDisclosures 三条边界说明 → 默认收起的 <details>(文本保留在 DOM,
  语义与既有测试契约不变;点击『边界说明』展开)
- Skill/RAG 零调用收敛保留(一行空集说明,不再渲染 6 张零值卡)

测试:前端全量 221/221;隔离栈截图验证留痕区噪音消除、无横向溢出。
@nghqqa nghqqa changed the title PR 详情页可读性改进:知识库参考区块重构+整页字阶提升+零调用留痕收敛 PR 详情页可读性改进:知识库参考区块重构+页面小字减量 Oct 20, 2026
#496 终审要求:边界说明展开/收起不得以『文本仍在 DOM』作为验收。
- 回归锁定:原生 details+summary 元素、默认收起、激活(浏览器 Enter→click
  映射路径)展开/再收起、展开内容承载三条边界文案
- 样式复用既有 .tech-details(summary 指针态/hover/[open] 分隔线),不新造样式
- happy-dom 不实现 summary Enter 默认动作——用例内显式模拟浏览器映射并注明
@nghqqa
nghqqa merged commit 1a769db into main Oct 21, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant