Ship runnable public how-to pages, T_ascii/转置文本 one-step display, explicit auto-simplify, and mark formula-doc F1–F3 complete. Co-authored-by: Cursor <cursoragent@cursor.com>
4.5 KiB
4.5 KiB
官方扩展:ext/linalg 实现路线图
| 状态 | L0–L6 + 公式文档面 F1–F3 已落地 · L7+ 远期 |
| 日期 | 2026-09-07 |
| 锁定设计 | design/ext-linalg.md · design/ext-linalg-formula-doc.md |
| 调研 | research/ext-linalg-formula.md |
| 相关 | ext-cli.md · ext-abi.md · stdlib-math.md · view.md · 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 |
| 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
ext/linalgCATALOG 含linalg- 插件
ping→ ok - 文档:
marqdo ext add linalg
L1
(AB)^\top→simplify→B^T*A^T(无 dense)- 形状错误含行列信息
- CLI
ascii/showSVG 通道 - 中英 L1 各一 smoke
L2
from_formula吸收$$数值阵solve与手算 2×2 一致- 超维
explicit硬错误(单元测护栏)
L3
- 分块乘
collapse后块级正确 - Kronecker 默认不膨胀元素个数(惰性
A⊗B)
L4
- SVD/特征结果对象字段稳定
- SVG 含可断言标记(如
data-linalg="eig") factorize+ 二次solve复用(LU)
L5
- 至少 1 个 examples 可
marqdo run - public/features 或 tutorial 短页
- skill / CHANGELOG Unreleased 条目
L6
lstsq/norm/cond/rank金样dtype=complex基线(Frobenius;分解仍为实数)draw theme=light|dark|bw与 quantum Q8 令牌对齐(data-theme)
F1
ascii/latex/show默认 simplify- 金样:
.T后直接ascii得B^T*A^T(无需显式 simplify) - 设计文 ext-linalg-formula-doc.md 落地
F2
- 符号引入降噪(选定候选) — GFM
@表 +la.declare - 至少 1 个 example 以代数面为主叙述 —
examples/linalg-transpose/
F3
T_ascii/转置文本一步展示糖explicit默认先 simplify(raw=可关)- 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. 建议开发顺序(下一手)
- L7+ 仅当用户明确要求更深符号(微积分等)。公式文档面 F1–F3 已收口。
6. 一句话
代数面像讲义、计算面是步骤;跑通即在规则集内正确;每阶段都有可跑金样。