- 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。
4.7 KiB
Executable File
4.7 KiB
Executable File
设计:中层标准库第二波(Mid2 · M7–M10)
| 状态 | Accepted · M7–M10 已落地(zip 跳过) |
| 日期 | 2026-09-09 |
| 缺口盘点 | stdlib-gaps-after-mid.md |
| 路线图 | stdlib-mid2.md |
| 宪法 | stdlib-mid.md §3(准入 / 不准入 不变) |
| 目标 | 在 M1–M6 之上补「日历 · URL · 配置 · HTML 安全 · fs 再厚」,仍保持宿主面积极小 |
0. 一句话
Mid2 = 第二档通用原语,不是第二套 stdlib。 仍落在 lib/ + 薄 host_*;禁止借机引入 YAML 全家桶、HTTP 服务端、数据库。
1. 分层与禁止
| 允许 | 禁止 |
|---|---|
新 lib/*.mq.md 中英对偶 |
新开 lib-mid2/ 目录树 |
少数 host_datetime_* / host_url_* / host_toml_parse |
为 Mid 新增 ABI 插件 |
加厚既有 fs / encoding / net / text |
把 ext/web 能力下沉进 lib/net 服务端 |
| TOML 只读 | 完整 YAML 1.2、任意对象反序列化 |
| HTML 转义 | 模板引擎 / CSS 选择器引擎 |
2. M7 — datetime + url
2.1 lib/datetime.mq.md / lib/日期时间.mq.md
| 函数(英) | 中文建议 | 行为 |
|---|---|---|
now |
现在 |
返回结构化时刻(见下)或 ISO 文本(二选一,实现时锁定) |
from_unix / to_unix |
自戳 / 成戳 |
秒级;可选 ms |
parse |
解析 |
支持 RFC3339 / 常见 YYYY-MM-DD[ HH:MM:SS] |
format |
格式化 |
strftime 子集或命名样式 rfc3339/date/time |
add |
加 |
days/hours/minutes/seconds 具名 |
in_zone |
时区 |
IANA 名或 +08:00;失败 → 诊断 |
结构化时刻(建议 map):{unix, zone, iso} 或宿主不透明柄 + _type=datetime。优先 map + 稳定字段,便于 GFM/table 协作。
刻意不做:农历、营业日、完整 tzdb 热更新 UI、闰秒政治。
2.2 lib/url.mq.md / lib/地址.mq.md(或并入 net)
| 函数 | 行为 |
|---|---|
parse |
→ {scheme, userinfo, host, port, path, query, fragment} |
query_parse |
a=1&b=2 → map(多值用列表) |
query_stringify |
map → query |
join |
base + relative(可选,可二期) |
既有 net.url_encode 保留;文档写清:编码单段用 net/encoding,解析整 URL 用 url。
验收:金样解析带 query 的 HTTPS URL;往返 query。
3. M8 — toml + html + encoding 加厚
3.1 lib/toml.mq.md / lib/Toml.mq.md(或 配置表)
| 函数 | 行为 |
|---|---|
parse |
TOML 文本 → Marqdo map/list(只读) |
不做 stringify(首版);需要写出时继续用 JSON。动机对齐 PEP 680:配置引导,而非通用文档格式战争。
3.2 HTML 转义
二选一(实现时定一):
- A:
lib/html.mq.md·escape/unescape - B:
text.html_escape/text.html_unescape
推荐 A(安全语义独立可见)。
3.3 encoding 加厚
| 函数 | 行为 |
|---|---|
base32_encode / base32_decode |
RFC 4648 |
(可选)percent_decode |
与 url 协作 |
4. M9 — fs 加厚
| 函数 | 行为 |
|---|---|
make_dirs |
递归创建 |
remove_tree |
递归删除(目录) |
stat |
{size, mtime_unix, is_file, is_dir} |
walk |
返回路径列表(深度优先或广度;文档锁定) |
不做:权限 ACL、watch/inotify、硬链接全家桶。
5. M10 — 收口糖(可选)
| 项 | 说明 |
|---|---|
lib/stats 或 math.mean/median/stdev |
极薄;非 pandas |
log 结构化字段 |
可选 fields= map;非完整 slog 生态 |
zip 读写 |
默认跳过;有明确 Release 需求再开 |
6. 宿主与 WASM
| Host | WASM |
|---|---|
datetime / url / toml / html / fs.stat |
尽量可进;IANA tz 数据体积需评估(可 host-only + 文档标注) |
fs.walk / remove_tree |
host-only 可接受 |
新 crate 写进 dependencies.md;禁止顺手拉大型框架。
7. 作者面风格
- 中英分文件;形参表声明全部可选并转发
host_*。 - 数据优先 GFM /
table;json仍只 parse/stringify/quote。 - 每波:设计短文 → host → lib →
tests/lib/*→public/features短页。
8. 完成定义(Mid2 整包)
- 作者可用
datetime+url+toml.parse+html.escape写配置驱动脚本,无需 foreign。 fs.stat/make_dirs金样绿。- 研究文高优先级缺口标 closed;YAML/模板/sqlite 仍标明 won't。
- stdlib-modules.md 总表更新;
stdlib.md状态改为 Mid2 进行中/完成。