Files
marqdo/doc
cflmyandCursor f240bdf156 Stream child agent events into view SSE without jumpy drip.
Forward quiet file-subtask EventBus frames while wait blocks, coalesce
DOM updates per rAF, and keep one SSE write per event so Stream stays
live during child work instead of freezing or dumping bursts.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-11 09:45:08 +08:00
..
2026-08-07 09:50:03 +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/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 表格语义(竖表 / 横表字典 / 脚注取元 / 行向记录;T0–T4 已落地)
roadmap/ext-web.md 规划:ext/web 动态网页(env/DB init·迁移·样式脚手架·ABI)
roadmap/ext-quantum.md 规划:ext/quantum 量子模拟(基础门·电路·ABI·ext add)
research/okf-and-marqdo.md OKF 调研

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

写作原则

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