Files
marqdo/doc/roadmap/stdlib-mid.md
T
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

8.7 KiB
Executable File
Raw Permalink Blame History

路线图:中层标准库(数个版本)

状态 M1–M6 已落地(收口)
日期 2026-09-07
设计 stdlib-mid.md
后续 stdlib-mid2.md · stdlib-gaps-after-mid.md
相关 stdlib-modules.md · next-phase.md · ext-cli.md

不预标 SemVer。 每一波随当时产品发版合入;下文用 M1…M6 波次名。每波须可单独演示、可回滚。


0. 总序

M1  文本与编解码地基     re + encoding          ← 最先解锁「无插件写库」
M2  路径与文件中层       path + fs 加厚
M3  完整性与机密         hash + secrets
M4  表格数据与文本加厚   csv + text++
M5  集合与 CLI 糖        table/listx + cli
M6  可观测与标识         log + uuid(+ 可选 yaml)

原则:

  1. 先原语、后糖:正则 / 编解码 / 路径先于 CLI 糖与日志格式。
  2. 每波必须有金样 + public 短页;无文档不算完成。
  3. 并行约束:不阻塞 ext/linalg 等已定领域工作;但新官方能力评审优先问 Mid。
  4. 插件冻结规则:自 M1 起,官方新增「通用」ABI 插件默认 拒绝,除非设计文档论证无法用 host+L1。

1. 现状缺口(开工依据)

能力 现状 后果
正则 无 校验、替换、简单解析只能 foreign 或插件
base64 / hex 无(仅有 url_encode) 令牌、摘要、嵌二进制文本困难
路径代数 fs 只做 I/O 拼接靠字符串,跨平台易错
哈希 / HMAC 无 校验、缓存键、签名只能外联
CSV 无 数据脚本推向外联 Python
lib/text 3 个包装函数 「有 text 库」名不副实
安全随机 仅 math.random 易误用于 token
结构化日志 / flags 无 每个脚本自造

对照:Go 日常高频包(regexp、encoding/*、crypto、path/filepath、slices)与 Python「难写对才进 stdlib」——正是 M1–M5 的选型来源;不把 HTTP 服务端、数据库驱动塞进 Mid(见设计文 §3.2)。


2. 波次明细

M1 — 正则与编解码(最高优先) — done

交付 说明
lib/re.mq.md / lib/正则.mq.md is_match / find / find_all / replace / split
lib/encoding.mq.md / lib/编码.mq.md base64_* / hex_*
Host host_re_*(regex)、host_encoding_*(无第三方编解码 crate)
金样 tests/lib/re-smoke · 正则-烟测 · encoding-smoke · 编码-烟测
文档 stdlib-re.md · stdlib-encoding.md · public 08-re-encoding
验收 无插件:邮箱式校验 + base64/hex 往返

刻意不做: 回溯引用极致兼容、替换回调、完整 PCRE 方言文档化——先 RE2/ Rust regex 语义并写清。


M2 — 路径与文件中层 — done

交付 说明
lib/path.mq.md / lib/路径.mq.md join / split / file_name / parent / extension / normalize / is_absolute
lib/fs 加厚 copy_file / move / make_temp(文本边界;无 read_bytes)
Host host_path_*、host_copy_file / host_move / host_make_temp
金样 path-smoke · 路径-烟测 · fs-copy-move · 文件-复制
文档 stdlib-path.md · stdlib-fs-mid.md · public 09-path-fs
验收 规范化 + 沙箱内复制/移动

刻意不做: 完整 shutil、监视 inotify、权限 ACL 全家桶。


M3 — 哈希与机密 — done

交付 说明
lib/hash.mq.md / lib/哈希.mq.md sha256 / sha1 / md5 / hmac_sha256
lib/secrets.mq.md / lib/机密.mq.md token_hex / token_urlsafe
Host host_hash_*、host_secrets_*(sha2/sha1/md-5/hmac/getrandom)
金样 hash-smoke · 哈希-烟测 · secrets-smoke · 机密-烟测
文档 stdlib-hash.md · stdlib-secrets.md · public 10-hash-secrets
验收 已知向量 + 令牌长度

刻意不做: 密码哈希(Argon2/bcrypt)、完整 TLS、证书管理——仍属服务端/安全产品。


M4 — CSV 与文本加厚 — done

交付 说明
lib/csv.mq.md / lib/逗号表.mq.md parse / stringify(首行表头 → list of maps)
lib/text / 文本 加厚 contains / starts_with / ends_with / replace / to_upper/to_lower / repeat / pad
Host host_csv_*、host_text_*
金样 csv-smoke · 逗号表-烟测 · text-mid-smoke · 文本-加厚-烟测
文档 stdlib-csv.md · stdlib-text-mid.md · public 11-csv-text
验收 CSV 往返 + 文本清洗小例

可选同波: 极简 format({name} 替换),若与引用语法冲突则延后。


M5 — 集合算法与 CLI — done

交付 说明
lib/table / 表 加厚 sort / sort_by / unique / chunk / zip / flatten(reverse 已有)
lib/cli.mq.md / lib/命令行.mq.md parse(--k v / --k=v / --flag;位置参 _)
Host host_list_sort* / unique / chunk / zip / flatten、host_cli_parse
金样 table-list-mid · cli-sort-smoke · 表-命令行-烟测
文档 stdlib-list-cli.md · public 12-list-cli
验收 CSV 按键排序 + 参数解析

刻意不做: 泛型迭代器协议、惰性流、完整 argparse 互斥组。


M6 — 日志、UUID、收口 — done

交付 说明
lib/log.mq.md / lib/日志.mq.md debug/info/warn/error;level 过滤;一行文本
lib/uuid.mq.md / lib/标识.mq.md v4
Host host_log_set_level / host_log_line、host_uuid_v4
金样 log-uuid-smoke · 日志-标识-烟测
文档 stdlib-log-uuid.md · public 13-log-uuid
文档收口 stdlib-modules.md 总表;设计文状态 → M1–M6 已落地
可选未做 yaml 只读子集(默认不做)

3. 跨波次工程清单

每波共用:

  • 中英 L1 对称(stdlib-i18n.md)
  • host_* 形参在 L1 全量转发(stdlib-modules.md §2.1)
  • 双后端金样(tree + bytecode,若该 host 已接线)
  • WASM:标注 host-only 或实现 stub
  • CHANGELOG「标准库」条目
  • skill examples.md 增加 Mid 惯用写法(GFM 优先)

宿主膨胀守卫:

  • 新增 crate 须在 PR/设计中写清:为何不能纯 mq、features 如何裁剪、许可证。
  • 禁止借 Mid 把 ext/web 的服务端栈链进主二进制。

4. 与官方扩展的互动(减插件)

扩展 Mid 落地后可做的减负
ext/web 路由/校验用 re;ETag/缓存键用 hash;静态路径用 path
ext/agent 工具参数校验、密钥材料用 secrets/hash(领域核仍插件)
ext/ai/llm 头/体编解码走 encoding
ext/linalg / quantum 不迁入 Mid;继续插件;仅共用 path/hash 等通用面

跟踪方式:某波完成后,开短 issue/清单「ext X 可删除的原生辅助」,不强迫同波大改。


5. 建议人力切分(示意)

波次 大致体量 可演示产物
M1 中 「正则替换 + base64 往返」用户页
M2 中 「安全拼接路径写文件」
M3 小–中 「下载内容 sha256 校验」
M4 中 「CSV → 表 → 打印」
M5 小–中 「零插件数据 CLI」
M6 小 「带 log level 的脚本」

若只能开一条线:M1 → M3 → M2 → M4 → M5 → M6(完整性校验常比路径代数更刚需时,M3 可紧贴 M1)。


6. 完成定义(整条 Mid 叙事)

当 M1–M6 完成时,对外可宣称:

Marqdo 自带中层标准库:正则、编解码、路径、哈希、CSV、加厚文本与集合/CLI 糖,以及日志与 UUID;写通用脚本与多数扩展库不再需要原生插件。
插件保留给 web 运行时、智能体、量子与线性代数等领域引擎。


7. 一句话

按 M1→M6 把通用原语沉进 lib/,用数个发版周期换掉「事事插件」——领域 ext/ 继续尖,语言本体变宽。