# View:执行轨迹与文档面保真 | | | |---|---| | 状态 | **Active** | | 日期 | 2026-10-15 | | 相关 | [view-document-annotations.md](view-document-annotations.md) · [view-frame-selection.md](view-frame-selection.md) · [view.md](view.md) · [view-markup-surface.md](view-markup-surface.md) | --- ## 1. 目标 `marqdo view` Browse Structure 必须同时做到: 1. **标记面**:变量名 / 可执行语句 / 返回值按表面渲染(无源码定界符字面量)。 2. **结构块**:GFM 表、循环(`-`)、分支(`1.`)有正确 HTML 与缩进。 3. **语句后值**:赋值行标注该语句执行后的值,不用入口终态回填。 4. **执行臂**:高亮实际走的分支臂。 5. **多调用帧**:同函数多次调用可用下拉切换经历。 6. **AI 可读**:与 HTML 同源的 `ViewExecutionReport` JSON。 Debug 仍用 AST 卡片 + 断点;不做文档 callout。 ## 2. 标记面 | 源标记 | 显示(无定界符) | class | |--------|------------------|-------| | `` `名` `` / `` `名`=默认 `` | `名`(默认次要后缀) | `mq-anchor mq-decl` | | `**…**`(可执行) | 内层文本 | `mq-anchor mq-code` | | `*…*`(返回) | 内层文本 | `mq-anchor mq-return` | `data-byte-start/end` 仍为源码字节偏移(供 CSS L-leader)。软强调不进 anchor。 ## 3. 结构块 | 块 | 呈现 | |----|------| | GFM 表 | `` | | `-` 循环 | `