Files
marqdo/doc/roadmap/stdlib-mid2.md
T
cflmyandCursor ff1870cedc docs: Mid2 gap research and M7–M10 design/roadmap
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>
2026-09-09 09:04:29 +08:00

89 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 路线图:中层标准库第二波(M7–M10)
| | |
|---|---|
| 状态 | **Active · 规划** |
| 日期 | 2026-09-08 |
| 设计 | [stdlib-mid2.md](../design/stdlib-mid2.md) |
| 缺口 | [stdlib-gaps-after-mid.md](../research/stdlib-gaps-after-mid.md) |
| 前序 | [stdlib-mid.md](stdlib-mid.md)(**M1–M6 done**) |
| 基线 | v0.3.7+ |
> **不预标 SemVer。** 波次名 **M7…M10**;每波可单独演示、可回滚。
---
## 0. 总序
```text
M7 时间与地址 datetime + url
M8 配置与安全字面 toml(只读) + html.escape + encoding/base32
M9 文件再厚 fs make_dirs / remove_tree / stat / walk
M10 收口糖(可选) stats 薄 · log 字段 · (zip 默认跳过)
```
原则:
1. 继承 Mid1 宪法:通用、难写对、小宿主、可冻 API。
2. **TOML 优先于 YAML**(对齐 PEP 680 教训)。
3. 不阻塞宿主 / ext 产品线;但新「通用」ABI 插件默认拒绝。
---
## 1. 波次明细
### M7 — datetime + url — **todo**
| 交付 | 说明 |
|------|------|
| `lib/datetime` · `日期时间` | now/parse/format/add/unix/zone 子集 |
| `lib/url` · `地址`(或 `net` 加厚) | parse · query_parse/stringify |
| Host | `host_datetime_*` · `host_url_*` |
| 金样 | `tests/lib/datetime-smoke` · `url-smoke` |
| public | 短页「解析带时区的时间戳 / 拆 query」 |
**刻意不做:** 农历、完整 tz 管理 UI、URL 规范化全部 WHATWG 边角。
### M8 — toml + html + encoding — **todo**
| 交付 | 说明 |
|------|------|
| `lib/toml` 只读 `parse` | 配置引导 |
| `lib/html` `escape`/`unescape` | XSS 底线 |
| `encoding` base32 | RFC 4648 |
| 金样 | `toml-smoke` · `html-escape-smoke` · `encoding-base32` |
**刻意不做:** YAML;TOML stringify(可后期)。
### M9 — fs 加厚 — **todo**
| 交付 | 说明 |
|------|------|
| `make_dirs` / `remove_tree` / `stat` / `walk` | 见设计文 |
| 金样 | `fs-mid2-smoke` |
### M10 — 可选收口 — **todo**
| 交付 | 说明 |
|------|------|
| `stats` 或 `math` 均值/中位数 | 薄 |
| `log` 可选 `fields=` | 非远程 sink |
| zip | **默认跳过** |
---
## 2. 进度勾选
- [ ] M7 datetime + url
- [ ] M8 toml + html + base32
- [ ] M9 fs 加厚
- [ ] M10 可选
- [ ] 研究文高优先级缺口 → closed
- [ ] `stdlib-modules.md` / `stdlib.md` 状态同步
---
## 3. 成功标准
对外可宣称:在 Mid1(文本/路径/哈希/CSV/CLI/日志)之上,**日历、URL、TOML 配置、HTML 转义、实用 fs** 无需外联即可完成常见脚本与 catalog 工具——领域能力仍在 `ext/`。