Files
marqdo/ext/web/_capability/index.mq.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

45 lines
1.7 KiB
Markdown
Executable File

---
markup: occlusion
title: ext/web/_capability
description: >-
Web ABI load skill. Prefer domain modules; call load when diagnosing plugins.
import:
plugin: lib/plugin.mq.md
sys: lib/sys.mq.md
---
This boundary loads the native Go web plugin. Domain render/server tools load
it automatically; pure layout and component constructors do not need it.
```sh
marqdo call ext/web/_capability/index.mq.md load --effects plugin --json
```
Build with bash scripts/build-web-plugin.sh, or install with marqdo ext add web.
For local development set MARQDO_WEB_PLUGIN to the built library's absolute path.
Success returns null; missing libraries also require checking process status.
Only this boundary imports lib/plugin, including through the Chinese facade.
## load
| 返回 | 类型 | 说明 |
|------|------|------|
| result | any | null after a successful load |
Locate the ABI v2 web shared library through plugin.native_path, then
plugin.load it. If the library is missing, print a short install hint and exit
non-zero so CI and agents fail loudly. After a successful load, later web star
names are available in this process. This is the only sanctioned place in the
package that talks to lib/plugin for web. Domain skills call load at the start
of each tool that needs the native server or renderer.
This tool takes no parameters.
We retain **`p` = [Locate the installed native plugin](plugin.native_path(name="web"))**.
1. `p`
We **[Load the native plugin required by this operation](plugin.load(path=`p`))**.
2. *
We **[Print the prepared message](print(text="ext/web: native web plugin not found (build plugins/web or marqdo ext add web)"))**.
We **[End this run with the selected exit status](sys.exit(code=1))**.
Return *None*.