Files
marqdo/doc/design/view-debug.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

1.9 KiB
Executable File
Raw Permalink Blame History

View 调试(marqdo debug)

状态 v1(独立 debug 页)
日期 2026-08-05
相关 next-phase.md P3 · view.md · view-document-annotations.md · pipeline-debug.md

分工

命令 角色
marqdo view 文档浏览器:叙述保真文档面 Structure + Execution + Source;函数大纲与搜索;跑后引出标注;无断点(见 view-document-annotations.md)
marqdo debug 调试宿主(默认端口 7430):IDE 式布局;AST Structure + BP;仅 live

静态 gh-pages / view output 不能真断点。

Debug 布局(对齐常见调试器)

参考 VS Code / Chrome DevTools / Jupyter debugger:

┌ Toolbar: Start · Continue (F5) · Step (F10) · Stop · status ─┐
├ Files ─┬─ Structure (gutter BP) + outline ─┬─ Variables      ┤
│        │                                    ├─ Breakpoints   │
│        │                                    └─ Call stack    │
├────────┴────────────────────────────────────┴────────────────┤
│ Debug Console (session stdout)                               │
└──────────────────────────────────────────────────────────────┘
  • 暂停粒度:语句起点(树遍历)。
  • 无断点时 Start 停在第一句。
  • Structure 为断点面(非 Source 行)。

API

与此前相同:POST /api/debug/start|continue|step|stop|breakpoints(仅 debug 服务)。

View 大纲

Structure 旁(或窄屏下方)函数树:#fn-{line} 锚点 + 搜索框过滤 data-fn / data-fn-path。