Files
marqdo/doc/design/ext-cli.md
T
cflmyandCursor 2079577314 fix(web): admin layout, ext add native, keyframes; document quoted CSS ratios
Widen admin main/table display, ensure marqdo ext add builds/copies the
native plugin before mq install, and emit valid @keyframes from style
tables. Prefer quoted cells like "16/9" for CSS values that contain /.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-01 09:59:03 +08:00

2.8 KiB
Raw Permalink Blame History

Official extension installer (marqdo ext)

Status Accepted (v0.1)
Date 2026-08-07
Related ext-llm.md · ext-agent.md · ext-abi.md

Commands

marqdo ext list
marqdo ext add llm
marqdo ext add agent
marqdo ext remove llm
marqdo ext remove agent

Install root

  1. MARQDO_EXT if set
  2. Else ~/.marqdo/ext

Imports use paths like import llm:ext/ai/llm.mq.md (see load.rs).

Source for add

  1. MARQDO_EXT_SOURCE — directory containing ai/llm.mq.md …
  2. Else repo ./ext near cwd / binary

Layout (ext/)

Official extensions live under ext/ai/ (LLM + agent framework only). Do not add flat .mq.md files at ext/ root — keeps the tree from accumulating unrelated modules.

ext/
  ai/
    llm.mq.md
    大模型.mq.md
    agent.mq.md
    智能体.mq.md

Future optional ext domains get their own subdirs (e.g. ext/web/, ext/quantum/), not mixed into ai/.

Catalog

Id Installs under MARQDO_EXT
llm ai/llm.mq.md, ai/大模型.mq.md
agent ai/agent.mq.md, ai/智能体.mq.md, native/libagent.so (or .dylib)
web web/web.mq.md, web/网页.mq.md, native/libweb.so — 见 ext-web.md · roadmap
quantum quantum/quantum.mq.md, quantum/量子.mq.md, native/libquantum.so — 见 ext-quantum.md · roadmap

add agent / add web / add quantum 先定位原生插件,再复制 .mq.md:

  1. 在 CARGO_TARGET_DIR、target/{debug,release}、源码 ext 旁的 target/、可执行文件旁等路径查找 lib{name}.so(或 .dll / .dylib)
  2. 找不到则自动执行 cargo build -p marqdo_plugin_{name},再安装到 MARQDO_EXT/native/
  3. 写入 {name}.plugin 绝对路径提示,供 plugin.native_path 解析

这样不会出现「只装了 .mq.md、运行时报 native plugin not found」的半安装状态。

# 推荐:在仓库根目录
marqdo ext add web
# 等价于找到或编好 libweb.so 后拷入 ~/.marqdo/ext/native/

Without a prior install, runtime still resolves via plugin.native_path name=web (see ext-abi.md): MARQDO_WEB_PLUGIN → CARGO_TARGET_DIR/{debug,release}/ → cwd target/… → beside marqdo binary → MARQDO_EXT/native/.

Tests

tests/gold.rs: ext_cli_add_list_remove_llm, ext_cli_add_agent, ext_agent_framework_smoke, ext_agent_run_live (tests/ext/agent-run-live.mq.md; needs tests/ext/.env + built libagent).

Non-goals

  • Third-party registry
  • Merging into lib/
  • Bundling domain/task helpers in official ext