Files
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

3.0 KiB
Executable File
Raw Permalink Blame History

Marqdo 关键字与内置名(v0 最小集)

状态 已定(中英双名)
日期 2026-08-05
原则 少而精;控制流靠 Markdown;内核中英别名等价(见 keywords-i18n.md)
相关 markdown-mapping.md · keywords-i18n.md · stdlib-i18n.md

1. 设计原则

  1. 标记承担架构:函数=#,形参=+,分支=1.…,循环=-,返回=**…**,语句=*…*。因此 不把 def/if/else/while/for/return 做成关键字。
  2. 内核双名:字面量 / 逻辑词 / 五个核心内置函数均有中英别名,无需导入,可混用。
  3. 学 Python 的边界:区分 关键字 vs 内置函数名。
  4. 宁少勿多:扩展能力进可导入标准库(中英分文件,见 stdlib-i18n.md)。

2. 关键字(词法保留,不可作变量名)

英文 中文 含义
True 真 布尔真
False 假 布尔假
None 空 空值
and 且 逻辑与
or 或 逻辑或
not 非 逻辑非

不引入: if else while for def return …(分支臂 * 不是单词 else。)


3. 内置函数(可调用,无需导入)

英文 中文 作用
print 打印 写 stdout
input 输入 读一行;capture / view 用 frontmatter stdin: / 输入:、表单或 --stdin-file 预置
len 长度 文本/表长度
str 文本 转为显示文本
int 整数 转为整数

文本:裸 token 按字面量;需 \n 等转义时用 "..."(见 markdown-mapping.md §7)。

形参别名:

英文 中文 用于
text 内容 print / 打印
prompt 提示 input / 输入
value 值 len/str/int 及其中文名
> print text=Hello
> 打印 内容=你好

*`n` = > 长度 值=`s`*

宿主原语 type / trim / split / join / at 无内核中文别名;文本/表扩展走标准库文件(见 stdlib-i18n.md)。转换错误见 stdlib.md。


4. 与 Markup 调用的关系

# main

> 打印 内容=Hello World!

*`n` = 1*

1. `n` > 0
  > print text=positive
2. *
  > 打印 内容=other
  • > 是调用标记;print / 打印 是同一内置的别名。
  • 用户 # print 或 # 打印 会遮蔽对应名字。

5. 标识符规则(摘要)

  • 变量:`name`;不可为上表任一中英文关键字。
  • 函数名:# 标题;中英文均可。
  • 比较:== > < >= <=;逻辑:and/且、or/或、not/非。

6. 后续可增(未批准)

float、range;以及 break/continue。增加前开短 ADR,并同步考虑是否值得占用双名配额。