# 官方扩展:`ext/linalg` 实现路线图 | | | |---|---| | 状态 | **L0–L6 + 公式文档面 F1–F3 已落地 · L7+ 远期** | | 日期 | 2026-09-07 | | **锁定设计** | [design/ext-linalg.md](../design/ext-linalg.md) · [design/ext-linalg-formula-doc.md](../design/ext-linalg-formula-doc.md) | | 调研 | [research/ext-linalg-formula.md](../research/ext-linalg-formula.md) | | 相关 | [ext-cli.md](../design/ext-cli.md) · [ext-abi.md](../design/ext-abi.md) · [stdlib-math.md](../design/stdlib-math.md) · [view.md](../design/view.md) · [ext-quantum-q7.md](../design/ext-quantum-q7.md) | | 安装(规划) | `marqdo ext add linalg`(`linalg` / `线性代数`) | 本文只跟踪**实现阶段**。作者面、公式规则、展示以设计文为准。 --- ## 1. 目标回顾(一句) **可运行的线性代数公式文档**:矩阵公式可化简、可 KaTeX 展示;跑通即在规则集内正确;需要时再稠密求值与分解,并内嵌结构 SVG。 --- ## 2. 落地阶段 | 阶段 | 内容 | 状态 | |------|------|------| | **L0** | CATALOG + `plugins/linalg` ping + L1 `ensure_plugin`;`ext add` 条目 | **done** | | **L1** | MatExpr:`symbol` / 稠密叶子 / `mul`·`add`·`T`·`inv`;`simplify` R1–R5;`latex`·`ascii`·`show` | **done** | | **L2** | `explicit` / 小阵 gemm·解系·`det`·`trace`;维数护栏;金样 `linalg-basic-smoke` | **done** | | **L3** | `block` + `collapse`;`kron` 惰性 + R7;金样 `linalg-block-kron` | **done** | | **L4** | `factorize` LU/QR/SVD/eig(+ 可选 chol);结构 SVG `svd|qr|ge|eig`;金样 `linalg-factor-smoke` | **done** | | **L5** | `heatmap`/`hinton`;examples(最小二乘 / SVD 示意);public + skill 摘要 | **done** | | **L6** | 复数 dtype;`lstsq`;`norm`/`cond`;主题令牌对齐 | **done** | | **F1** | 展示路径默认 simplify;公式文档金样 | **done** | | **F2** | 符号引入降噪;examples 讲义化 | **done** | | **F3** | 紧凑糖 + public「如何写公式文档」 | **done** | | **L7+** | 矩阵微积分 / 更大 BLAS 依赖(仅当用户明确要求) | **deferred** | 验收金样(规划路径):`tests/ext/linalg-*-smoke.mq.md`;示例:`examples/linalg-least-squares/`、`examples/linalg-svd/`。 --- ## 3. 每阶段出口检查 ### L0 - [x] `ext/linalg` CATALOG 含 `linalg` - [x] 插件 `ping` → ok - [x] 文档:`marqdo ext add linalg` ### L1 - [x] `(AB)^\top` → `simplify` → `B^T*A^T`(无 dense) - [x] 形状错误含行列信息 - [x] CLI `ascii` / `show` SVG 通道 - [x] 中英 L1 各一 smoke ### L2 - [x] `from_formula` 吸收 `$$` 数值阵 - [x] `solve` 与手算 2×2 一致 - [x] 超维 `explicit` 硬错误(单元测护栏) ### L3 - [x] 分块乘 `collapse` 后块级正确 - [x] Kronecker 默认不膨胀元素个数(惰性 `A⊗B`) ### L4 - [x] SVD/特征结果对象字段稳定 - [x] SVG 含可断言标记(如 `data-linalg="eig"`) - [x] `factorize` + 二次 `solve` 复用(LU) ### L5 - [x] 至少 1 个 examples 可 `marqdo run` - [x] public/features 或 tutorial 短页 - [x] skill / CHANGELOG Unreleased 条目 ### L6 - [x] `lstsq` / `norm` / `cond` / `rank` 金样 - [x] `dtype=complex` 基线(Frobenius;分解仍为实数) - [x] `draw theme=light|dark|bw` 与 quantum Q8 令牌对齐(`data-theme`) ### F1 - [x] `ascii` / `latex` / `show` 默认 simplify - [x] 金样:`.T` 后直接 `ascii` 得 `B^T*A^T`(无需显式 simplify) - [x] 设计文 [ext-linalg-formula-doc.md](../design/ext-linalg-formula-doc.md) 落地 ### F2 - [x] 符号引入降噪(选定候选) — GFM `@` 表 + `la.declare` - [x] 至少 1 个 example 以代数面为主叙述 — `examples/linalg-transpose/` ### F3 - [x] `T_ascii` / `转置文本` 一步展示糖 - [x] `explicit` 默认先 simplify(`raw=` 可关) - [x] public `07-linalg` / `07-线性代数`「如何写公式文档」 --- ## 4. 依赖与并行 | 依赖 | 说明 | |------|------| | ABI v2 + ext CLI | 已有 | | view KaTeX / plot | 已有;L1 `show` 接现成通道 | | Release native zip | 随首次含 `plugins/linalg` 的发版接入 | | quantum 数值核 | **可选**私有复用;不阻塞 L1–L2 | 不阻塞项:浏览器 WASM 上的 linalg(默认 host/native;WASM 另议)。 --- ## 5. 建议开发顺序(下一手) 1. **L7+** 仅当用户明确要求更深符号(微积分等)。公式文档面 F1–F3 已收口。 --- ## 6. 一句话 **代数面像讲义、计算面是步骤;跑通即在规则集内正确;每阶段都有可跑金样。**