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 |
|
cflmy
|
d9aef957f7
|
Release 2.7.0: executable handbooks and native user-site workflows
|
2026-11-10 17:03:06 +08:00 |
|
 cflmyandCursor
|
687c168014
|
feat(parse): use nested YAML import: maps instead of one-liner binds
Frontmatter imports are now valid YAML (`import:` / `导入:` with bind→target
entries), removing spaced keys. Add `marqdo migrate imports`, hard-error the
old one-liner form, and migrate lib/ext/examples/tests/docs accordingly.
Co-authored-by: Cursor <cursoragent@cursor.com>
|
2026-10-23 19:33:58 +08:00 |
|
cflmy
|
8c24d96626
|
docs(examples): 遮蔽改用裸赋值 名 = [描述](实现),不再包进粗体
用户指出:`**留存 = [客户留存率,模拟数据](0.42)**` 在阅读器/高亮里
描述被粗体吞成"代码味",人话反而不显眼。
改为裸赋值形式(与粗体形式语义完全等价,实测四项一致):
`留存` = [客户留存率,模拟数据](0.42)
`待接` = [搜索接入,接口未接,待开发]()
`取第一` = [第一颗](access(`篮子`, "1"))
`个数` = [篮子有几颗](table.len(`篮子`))
`表取` = [用 table.get 读同一个键](table.get(`饮品价`, "美式"))
`长度` = [名字长度](len(`名`))
等价性实测(b.mq.md):留存=0.42 / 待接=None / 取第一=苹果 / 个数=2,
check 只报同一条 label.empty_payload,labels 命中同样两处。
并在第 5 节补一句为什么这样写:粗体是给"表达式赋值"用的紧凑写法,
而遮蔽的前提是"描述给人读",所以描述不该被强调形式包住。
顺带说明(不是本次改动):view 的代码区展示的是**高亮后的源码**,
不是 Markdown 渲染,所以 `[..](..)` 在两种写法下都不是可点链接;
真正的呈现改进(描述为正文、实现为代码块)属于 M8 未做部分。
|
2026-10-22 16:03:59 +08:00 |
|
cflmy
|
4a2f5bf226
|
docs(examples): 新增 examples/syntax-tour — 一页跑通全部现行语法
十个板块,全部可执行(marqdo run 实测通过):
1 变量与插值 2 函数与契约 3 调用四种形态(> 前缀 / 括号位置 / 逗号 /
嵌套 / 带空格函数名) 4 取值 access / table.len / table.get
5 遮蔽(普通 + 空载荷桩) 6 循环(遮蔽循环 + while 式递减)
7 分支 8 表格三态(竖表 List / 横表 Map / 行向 List[Map])
9 值类型 10 收尾
写作过程中踩到的真实约束(都已按现行语义修正):
- `##` 是函数定义,正文分节不能用 `##`(改用散文分隔行)
- 函数内看不到模块级变量,`计税` 改为自包含的分支查表
- 反引号插值只接受变量名,不能写 `len(`名`)`,需先算出变量
- `()` 内的 payload 是表达式,空格形调用要写成括号形
(`table.get(表, 键)` 而非 `table.get map=… key=…`)
实测:run 输出 25 行符合预期;check 仅 1 条有意保留的
label.empty_payload(正是第 5 节要演示的空载荷规则);
labels 命中 2 个已申报桩。
|
2026-10-22 15:57:48 +08:00 |
|