Files
marqdo/doc/design/view-markup-surface.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

2.1 KiB
Executable File
Raw Permalink Blame History

View:Markup 表面保真

状态 Active
日期 2026-09-14
相关 view.md · bracket-call-modifiers.md · collection-access-link.md · markdown-mapping-v0.3.md

1. 目标

marqdo view 的 Structure / 表达式展示应贴近作者写出的 Markup,而不是内部 AST 的旧拼法。读者从 view 抄回源文件时,应仍是合法、推荐的表面。

2. 表面对照

AST / 概念 View 优先显示 备注
Expr::Occluded 正文只读动作说明,实际实现进入侧注 每个片段独立关联,不把整句改成一次赋值
空遮蔽 () 待补充实际逻辑 当前空遮蔽返回 None,不伪装成已接通工具
Expr::Index / InterpPart::Index 保留经典或脚注取元的兼容说明 当前作者程序优先用 access 读取集合;默认链接形是遮蔽
CallExpr + bracket_marked / pre_modifiers 修饰 [callee] 实参… 或 [callee] 实参… 仅经典 > 解析时仍显示 > callee …
赋值 / 返回 保留原叙述句子,在真实执行片段上标明语句或返回 普通链接与字面量不冒充执行遮蔽
foreach - [动作](遍历 集合 为 项) 正文显示动作,控制逻辑见侧注;迭代选择器只切换已有运行记录

3. 非目标

  • 不把 view 做成第二语法;解析真相仍在 mapping / call-arguments。
  • 不删除对脚注取元、旧 > 调用的兼容显示需求时,可用次要提示,但默认推荐面优先。

当前阅读器的实现与验收见 view-readable-actions.md。 可执行知识先展示输入、返回、调用边界、依赖和各项依据;摘要和机器身份按需展开。 源码说明与运行标注分开,展开侧注或知识卡片不会执行代码。

4. 修订历史

日期 说明
2026-09-14 初稿;Index 链接形 + 括号调用修饰表面
2026-09-14 bracket_marked:无修饰的 [callee] 也保真显示