`import json:lib/json.mq.md` binds file libraries; `import fmt:time.format` binds member short names (replaces `> use`). Legacy `> path.mq.md` / `> use` now hard-error with a hint. Migrates repo docs, skills, ext, lib, public, examples, man-test and tests; adds a negative gold and updates view/catalog rendering. Co-authored-by: Cursor <cursoragent@cursor.com>
73 lines
2.3 KiB
Markdown
73 lines
2.3 KiB
Markdown
# Official extension installer (`marqdo ext`)
|
|
|
|
| | |
|
|
|---|---|
|
|
| Status | **Accepted (v0.1)** |
|
|
| Date | 2026-08-07 |
|
|
| Related | [ext-llm.md](ext-llm.md) · [ext-agent.md](ext-agent.md) · [ext-abi.md](ext-abi.md) |
|
|
|
|
## Commands
|
|
|
|
```text
|
|
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`](../../src/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.
|
|
|
|
```text
|
|
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](ext-web.md) · [roadmap](../roadmap/ext-web.md) |
|
|
| `quantum` | `quantum/quantum.mq.md`, `quantum/量子.mq.md`, **`native/libquantum.so`** — 见 [ext-quantum.md](ext-quantum.md) · [roadmap](../roadmap/ext-quantum.md) |
|
|
|
|
`add agent` copies the built native plugin into `MARQDO_EXT/native/`. Build it first:
|
|
|
|
```bash
|
|
cargo build -p marqdo_plugin_agent
|
|
marqdo ext add agent
|
|
```
|
|
|
|
Without install, runtime resolves the plugin via `plugin.native_path name=agent` (see [ext-abi.md](ext-abi.md)): `MARQDO_AGENT_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`](../../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
|