Switch ext add / gold / release builds to scripts/build-web-plugin.sh, drop the Rust archive from the Cargo workspace, and resolve libweb from plugins/web/build (and target copies) without MARQDO_WEB_PLUGIN. Co-authored-by: Cursor <cursoragent@cursor.com>
3.5 KiB
3.5 KiB
Official extension installer (marqdo ext)
| Status | Accepted (v0.3.5 prep) — prebuilt native download |
| Date | 2026-09-04 |
| Related | ext-llm.md · ext-agent.md · ext-abi.md · 08-ext-deploy-coupling.md |
Commands
marqdo ext list
marqdo ext add llm
marqdo ext add agent
marqdo ext add web
marqdo ext remove llm
Install root
MARQDO_EXTif set- Else
~/.marqdo/ext
Imports use paths like import llm:ext/ai/llm.mq.md (see load.rs).
Goal: no local Rust required
End users who install Marqdo from GitHub Releases should run:
marqdo ext add web
and get both L1 .mq.md and the matching native plugin (.dll / .so) without cargo build.
Resolution order (add with native crate)
- Local artifact (
MARQDO_*_PLUGIN,plugins/web/buildfor web,target/{debug,release}, besidemarqdo,MARQDO_EXT_SOURCE/native, …) - Download
marqdo-{VER}-native-{target}.zipfrom the GitHub Release for this CLI version → cache under~/.marqdo/cache/ - Local rebuild fallback:
- web →
./scripts/build-web-plugin.sh(Go c-sharedlibweb; requires Go 1.22+ / cgo) - other plugins →
cargo build -p marqdo_plugin_*when Rust/cargois available
- web →
- Else fail with a clear message pointing at the Release assets
L1 sources:
MARQDO_EXT_SOURCE/ repo./ext/ beside binary- Else download
marqdo-{VER}-ext.zipinto~/.marqdo/cache/ext-src-v{VER}/
Env knobs
| Variable | Meaning |
|---|---|
MARQDO_EXT_VERSION |
Override SemVer used for Release asset names (default: CLI CARGO_PKG_VERSION) |
MARQDO_EXT_NO_DOWNLOAD=1 |
Never hit the network (CI / air-gap); local/cargo only |
MARQDO_WEB_PLUGIN / MARQDO_AGENT_PLUGIN / MARQDO_QUANTUM_PLUGIN |
Explicit native path |
Windows Release zip also ships ext/ + ext/native/*.dll next to marqdo.exe so a portable unzip works offline after one download.
Source for add (developers)
MARQDO_EXT_SOURCE— directory containingai/llm.mq.md…- Else repo
./extnear cwd / binary - Else Release
marqdo-*-ext.zip(see above)
Layout (ext/)
ext/
ai/ # llm + agent L1
web/
quantum/
Installed tree (~/.marqdo/ext or MARQDO_EXT):
web/web.mq.md
web/网页.mq.md
native/libweb.so # or web.dll / libweb.dylib
web.plugin # absolute path hint
Catalog
| Id | Installs under MARQDO_EXT |
|---|---|
llm |
ai/llm.mq.md, ai/大模型.mq.md |
agent |
ai/agent.mq.md, ai/智能体.mq.md, native agent |
web |
web/web.mq.md, web/网页.mq.md, native web |
quantum |
quantum/quantum.mq.md, quantum/量子.mq.md, native quantum |
Release assets (native)
| Asset | Platform |
|---|---|
marqdo-VER-native-x86_64-pc-windows-msvc.zip |
Windows x64 (native/*.dll) |
marqdo-VER-native-x86_64-unknown-linux-gnu.zip |
Linux x64 (native/lib*.so) |
macOS: use local cargo build until CI adds Darwin natives (same zip naming pattern reserved).
Tests
tests/gold.rs: ext_cli_add_list_remove_llm, ext_cli_add_agent, ext_cli_add_web (local build path; set MARQDO_EXT_NO_DOWNLOAD=1 in sandboxes if needed).
Unit: ext_fetch URL / triple tests.
Non-goals
- Third-party registry
- Merging domain helpers into
lib/ - Guaranteeing plugin source ABI stability (author
.mq.mdAPI is the contract)