Inventory stdlib gaps after Mid M1–M6 and lock Mid2 waves (datetime/url, toml/html, fs++, optional stats). Co-authored-by: Cursor <cursoragent@cursor.com>
8.9 KiB
8.9 KiB
中层标准库(Mid Stdlib)
| 状态 | M1–M6 已落地 |
| 日期 | 2026-09-07 |
| 相关 | stdlib.md · stdlib-modules.md · ext-abi.md · roadmap/stdlib-mid.md · 后续 stdlib-mid2.md · stdlib-gaps-after-mid.md |
| 目标 | 在接下来数个发版周期内,把「通用编程」能力沉到 L0.5 宿主 + L1 .mq.md,减少「凡是稍有能力就必须 ABI 插件」的路径依赖 |
1. 为什么现在做
现状分层(已落地):
L0 内置 print / len / split / …
L0.5 宿主原语 src/host/*(供 L1 包装,作者原则上不直调)
L1 官方库 lib/*.mq.md(嵌入二进制 / 可覆盖)
ext 官方扩展 .mq.md + 可选 cdylib(web / agent / quantum / linalg)
痛点:
- 通用语言能力缺口:
lib/text几乎只是trim/split/join;无正则、无编解码、无哈希、无路径代数、无 CSV……日常脚本要么外联 Python,要么新开插件。 - 插件路径过重:ABI 插件适合领域热路径(量子核、公式矩阵、HTTP 服务+SQLite),不适合「再来一个 base64」。每加一个插件都要:crate、Release 资产、
ext add、CI、WASM 缺口。 - 扩展作者被逼进插件:
ext/**禁止host_*。若 L1 没有正则 / 哈希 / 路径,扩展只能plugin.load,导致「库」与「原生模块」边界模糊。 - 对照成熟语言:Go 的
strings/regexp/encoding/*/crypto/path/filepath、Python 的「难写对才进 stdlib」标准——都把通用原语留在语言自带层,把领域产品留给第三方。Marqdo 的「通用」应对齐前者;ext/对齐后者。
中层标准库 = 在现有 L1 之上、在官方 ext 之下,专门补「写通用程序必备、又不该做成插件」的那一档。
2. 分层命名(本波约定)
| 名称 | 位置 | 用户导入 | 实现形态 |
|---|---|---|---|
| 核心 L1 | 已有 lib/{fs,sys,time,json,net,math,…} |
是 | 薄包装 → 已有 host_* |
| 中层 L1(Mid) | 新增 / 加厚 lib/{re,encoding,hash,path,…} |
是(仍属 lib/ / std/) |
优先薄 host_* + L1;能纯 .mq.md 则纯库 |
| 官方 ext | ext/{web,agent,quantum,linalg,ai} |
显式 ext/ |
.mq.md;仅领域热路径允许 ABI 插件 |
| catalog / 用户库 | 发版外收录 | 各自约定 | 应能主要靠 Mid + 核心 L1 写成,默认无插件 |
不新开第三棵目录树。中层仍落在
lib/,用文档与路线图分期交付,避免lib/vslib-mid/分裂。
3. 准入 / 不准入(宪法)
3.1 进入中层的条件(须同时满足多数)
| # | 条件 | 说明 |
|---|---|---|
| 1 | 跨领域高频 | 脚本、站点、智能体、教学示例都会用到 |
| 2 | 难写对或不可移植 | 正则、Unicode、密码学、路径跨平台——纯 Marqdo 成本过高 |
| 3 | 解锁「无插件写库」 | 有了它,更多 ext/ / catalog 可用纯 .mq.md |
| 4 | 宿主面积极小 | 一个或少数 host_* + 稳定 crate;不把巨型框架链进主二进制 |
| 5 | API 可长期冻住 | 宁可窄接口,也不提前做成第二个 Requests |
参考(外部):
- Python:stdlib 准入 与 Language Summit:stdlib 何用——偏「启动器 / 新手脚本 / 难写对的协议」,而非「万物入 std」。
- Go:日常几乎离不开的
strings、regexp、encoding/*、crypto、path/filepath、slices——对标我们的 Mid 候选,而非database/sql驱动全家桶。 - 反面:PEP 594「死电池」——过窄协议、过时格式、与生态脱节的模块不要进 Mid。
3.2 明确不准入(继续走 ext + 可选插件)
| 领域 | 原因 |
|---|---|
| HTTP 服务端 / ASGI / 路由框架 | 产品面;已有 ext/web |
| SQLite / ORM / 管理后台 | 同上 |
| LLM / 智能体编排 / OKF | ext/ai · ext/agent |
| 量子线路 / 密度矩阵核 | ext/quantum |
| 大学线性代数 CAS / 分解可视化 | ext/linalg(公式文档面) |
| 完整图像 / 音视频 / ML | 体积与依赖爆炸 |
| 任意第三方云 SDK | 不属于语言 |
3.3 插件仍保留的边界
ABI 插件 不废除。规则收紧为:
若能力可用「少量 host_* + lib/*.mq.md」表达 → 必须走中层,禁止新开官方插件。
若能力是领域数值核 / 长生命周期服务 / 可选重依赖 → 才允许官方插件。
lib/plugin 继续服务:本地实验、第三方原生、官方领域包。
4. 实现分工(怎么长)
用户 / catalog / 官方 ext(纯 mq 优先)
│ import re:lib/re.mq.md
▼
中层 L1(.mq.md,中英分文件,除 json 类共用外)
│ **> host_re_find …**
▼
L0.5 宿主(Rust:regex / sha2 / …)
│
▼
OS / 算法库(精选 crate,默认 features 最小化)
| 规则 | 说明 |
|---|---|
ext/** 仍禁止 host_* |
中层补齐后,ext 经 lib/re 等调用 |
每个新 host_* |
必须有 L1 包装 + 金样 + 中英对称(见 stdlib-i18n.md) |
| 能纯 mq 的 | 例如在 table 上的 sort_by 若性能可接受,可先纯库;热路径再下沉 host |
| WASM | 新 host 须标注是否进浏览器构建;不能 WASM 的在文档标 host-only |
| 依赖 | 新增 crate 写进 dependencies.md 动机;禁止「顺手」拉大型框架 |
5. 模块候选总表(按优先级波次)
完整排期与验收见 roadmap/stdlib-mid.md。摘要:
| 波次 | 模块(英 / 中) | 典型能力 | 主要形态 |
|---|---|---|---|
| M1 | re / 正则 · encoding / 编码 |
match / find / replace;base64 / hex | done |
| M2 | path / 路径 · fs 加厚 |
join / normalize;copy / move / temp | done |
| M3 | hash / 哈希 · secrets / 机密 |
sha256 / hmac;token | done |
| M4 | csv / 逗号表 · text 加厚 |
parse / stringify;contains / replace | done |
| M5 | table 加厚 · cli / 命令行 |
sort / zip;flags | done |
| M6 | log / 日志 · uuid / 标识 |
level 日志;v4 | done |
| 可选(Mid1) | yaml |
默认 不做 | 见 Mid2:优先 TOML |
Mid1 刻意延后、现已升格到 Mid2: 日历/时区、URL 解析 —— 见 stdlib-mid2.md · stdlib-gaps-after-mid.md。
仍不准入 Mid: 连接池、异步 runtime、模板引擎、完整 collections 类型系统、HTTP 服务端 / SQLite(ext/)。
6. 与现有库的关系
| 现有 | 中层策略 |
|---|---|
lib/text |
加厚,不另起 strings 英文名(保持 Marqdo 习惯);中文 文本 |
lib/table |
Mid 集合算法优先挂这里或薄 listx;避免与 GFM 表语义打架 |
lib/net |
HTTP 客户端保留;编解码类能力与 encoding 边界写清(url 组件归谁) |
lib/math |
保持高中;哈希 / 安全随机不进 math |
lib/json |
仍只 parse/stringify/quote;CSV/YAML 另库 |
lib/plugin |
不变;文档写明「通用能力请先查 Mid」 |
ext/* |
逐步改写依赖:能改用 lib/re 的路由/校验,去掉不必要的原生 |
7. 文档与工程节奏
每个 Mid 波次固定流水线(与现有发版习惯对齐):
- 本设计不变的前提下,在 roadmap 勾选该波次工作项。
doc/design/stdlib-<module>.md(可短)→host_*→lib/中英 →tests/lib/*金样 →public/features短文。- 更新 stdlib-modules.md 模块表。
- 不为 Mid 单开 SemVer 故事;随正常产品发版收进 CHANGELOG「标准库」小节。
- 发版技能 / Release 资产:仅当新增 必须 随 CLI 分发的东西时改 release 脚本——Mid 默认已嵌入 stdlib,无 native zip。
8. 成功标准(数个版本后)
- 用 Mid + 核心 L1 不加载任何插件,能写:日志采集脚本、CSV 清洗、带正则的文本管线、带哈希校验的下载器、简单 CLI 工具。
- 新的官方 非领域 能力默认进
lib/,评审时问:「能否不做成插件?」 ext/web/ext/agent等仍可有插件,但依赖面写进文档:哪些能力已改走 Mid。- 主二进制体积与依赖可解释;WASM 可用性有清单。
9. 一句话
中层标准库把「通用原语」沉回语言自带层,让插件专属于真正的领域引擎——这样 Marqdo 才像一门通用语言,而不是「Markdown + 一堆 .so」。