Files
marqdo/doc
cflmyandCursor 88fe076216 feat(quantum): Q7 density linear algebra and advanced SVG viz
Add density-matrix ops (partial trace, Hermitian eig, Schmidt, Pauli
expect, purity/fidelity, kron) and hinton/city/qsphere/paulivec/multibloch
draw kinds via plugins/quantum ABI, with EN/ZH L1 and gold smokes.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-28 14:23:24 +08:00
..

Marqdo 开发文档

本目录存放各阶段设计、选型与路线图。

目录约定

路径 用途
research/ 外部标准与调研
design/ 语言设计(语法映射等)
adr/ 架构决策记录
roadmap/ 实现路线与里程碑

当前文档

文档 摘要
design/markdown-mapping.md v0.1 语法宪法
design/objects.md # 对象 / ## 函数与方法
design/ai-skill.md AI 接入 Skill(skills/marqdo/)
design/code-vs-comment.md 叙述 / 可执行 / 外联
design/return-hr-and-code-surface.md 语句/返回/输出决议
design/generated-yaml-manifest.md 生成式 OKF 清单(早期方向)
design/okf.md Marqdo OKF 实现规范(catalog v0 + 任务知识包)
design/catalog-cli.md marqdo catalog / sync OKF 清单命令
design/tech-stack.md 实现栈对比
adr/0001-implementation-language.md Accepted:Rust 参考解释器;不用 Flex/Bison
design/dependencies.md 依赖详单(无 Flex/Bison)
design/keywords.md 英文最小关键字 / 内置函数
design/keywords-i18n.md 内核中英双名(无需导入;少而精)
design/module-namespace.md 模块命名空间:导入绑定库名、库.成员 / use(M1+M2 已落地)
design/stdlib.md 标准库:内置 + lib/ + 错误约定
design/stdlib-i18n.md 标准库中英命名:靠库文件名区分,无 lang 开关
design/stdlib-modules.md L1:文件/系统/时间/JSON/网络/数学/外联/插件
design/stdlib-math.md 数学库(数值/随机/作图/轻量求解)
design/stdlib-foreign.md 外联胶水(```lang 具名块)— 已落地
design/ext-abi.md 原生插件 C ABI v1(lib/plugin)
design/ext-llm.md 官方扩展 ext/llm(OpenAI 兼容)
design/ext-agent.md 官方扩展 ext/agent(文档驱动:单步 / 多步工作簿 + 自写回;废弃 thin TOOL 循环)
design/ext-agent-plan.md ## 多步 / ## plan 锁定设计(工作簿文件、subtask 执行、修订循环、step 默认写回)
design/ext-cli.md marqdo ext list/add/remove 官方扩展安装器
design/ext-web.md 官方扩展 ext/web(页面/库表/绑定/后台;ABI + CLI;设计锁定)
design/call-arguments.md 调用:具名 + 位置实参
design/examples-and-tests.md tests/ 金样例目录布局
design/view.md marqdo view / view output 黑白极简 + 静态文档
design/user-site.md 用户站:public/ → gh-pages
design/view-debug.md marqdo debug 独立调试页
design/vscode-extension.md VS Code 扩展:分支 vscode-extension(main 不跟踪源码)
design/vscode-extension-commit.md 扩展提交约定(禁止在 main 提交 vscode-extension/)
design/bytecode.md M5 字节码 / 双后端
design/pipeline-debug.md 流水线 --dump-* 可视调试
dev-setup.md 开发环境配置(Rust M0)
roadmap/interpreter.md 正经解释器路线图
roadmap/next-phase.md 下一阶段:input / 诊断 / 标准库 / view 调试
roadmap/okf-near-match.md 规划:OKF 相近任务命中(精确 sig 之外的可选软复用)
roadmap/agent-streaming.md 流式输出(SSE + complete/step stream;S0–S1 已落地)
roadmap/object-inheritance.md 对象继承(# 子类 = > 父类;I0–I2 已落地)
roadmap/tables-maps-footnotes.md 表格语义(竖表 / 横表字典 / 脚注取元 / 行向记录 / 单元格表达式 T5)
design/table-cell-expressions.md 表数据单元格 = 表达式(同调用实参值语法;Accepted)
roadmap/ext-web.md 实现路线:ext/web(W0–W4;设计见 ext-web.md)
roadmap/ext-quantum.md 规划:ext/quantum 量子模拟(基础门·电路·ABI·ext add)
research/okf-and-marqdo.md OKF 调研

金样例与集成测试:tests/。面向访客的可执行文档:public/。Spike 存档:spike/。

写作原则

  1. 先宪法与路线图,再实现。
  2. 金样例不过 = 未完成。
  3. 示例统一 .mq.md。