Files
marqdo/doc/roadmap/ext-linalg.md
T
cflmyandCursor 3ade036d34 feat(linalg): F3 formula-doc public pages and T_ascii
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>
2026-09-07 16:13:22 +08:00

4.5 KiB
Raw Blame History

官方扩展: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/linalg CATALOG 含 linalg
  • 插件 ping → ok
  • 文档:marqdo ext add linalg

L1

  • (AB)^\top → simplify → B^T*A^T(无 dense)
  • 形状错误含行列信息
  • CLI ascii / show SVG 通道
  • 中英 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. 建议开发顺序(下一手)

  1. L7+ 仅当用户明确要求更深符号(微积分等)。公式文档面 F1–F3 已收口。

6. 一句话

代数面像讲义、计算面是步骤;跑通即在规则集内正确;每阶段都有可跑金样。