You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maka.apache.org by wy...@apache.org on 2026/10/12 09:43:18 UTC
(maka) branch feat/runtime-host-rust updated: docs: clarify JavaScript execution adapter terminology
This is an automated email from the ASF dual-hosted git repository.
M4n5ter pushed a commit to branch feat/runtime-host-rust
in repository https://gitbox.apache.org/repos/asf/maka.git
The following commit(s) were added to refs/heads/feat/runtime-host-rust by this push:
new 1bef4e70bc docs: clarify JavaScript execution adapter terminology
1bef4e70bc is described below
commit 1bef4e70bc99c31b29d21d0428fa79e34e1df3e3
Author: Wang <m4...@gmail.com>
AuthorDate: Mon Oct 12 17:43:12 2026 +0800
docs: clarify JavaScript execution adapter terminology
Generated-by: Codex
---
ARCHITECTURE.md | 2 +-
ARCHITECTURE.zh-CN.md | 2 +-
README.md | 2 +-
README.zh-CN.md | 2 +-
platform/README.md | 2 +-
platform/README.zh-CN.md | 2 +-
platform/host-js/README.md | 2 +-
platform/host-js/README.zh-CN.md | 2 +-
platform/host-runtime/README.md | 2 +-
platform/host-runtime/README.zh-CN.md | 2 +-
platform/ui-js/README.md | 2 +-
platform/ui-js/README.zh-CN.md | 2 +-
platform/ui-runtime/README.md | 2 +-
platform/ui-runtime/README.zh-CN.md | 2 +-
products/maka/cli/README.md | 2 +-
products/maka/cli/README.zh-CN.md | 2 +-
products/maka/desktop/README.md | 2 +-
products/maka/desktop/README.zh-CN.md | 2 +-
18 files changed, 18 insertions(+), 18 deletions(-)
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 5a7399e43c..38b7d0bf1c 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -29,7 +29,7 @@ Maka assembles applications from plugins. A package declares what it provides an
A `package.ts` identifies an authored plugin. A Cargo crate identifies code compiled together. They need not correspond one-to-one: an Agent service can use several domain crates, while related plugin entries can share one native implementation crate.
-The Host and UI owners use the same lifecycle kernel. JavaScript execution is injected through `host-js` and `ui-js`; native renderers and owners can compile without V8 or the Agent engine. Shared fact types remain explicit dependencies where persistence or presentation needs them.
+The Host and UI owners use the same lifecycle kernel. The `host-js` and `ui-js` adapters execute JavaScript plugins; native renderers and owners can compile without V8 or the Agent engine. Shared fact types remain explicit dependencies where persistence or presentation needs them.
## From package to running application
diff --git a/ARCHITECTURE.zh-CN.md b/ARCHITECTURE.zh-CN.md
index 9d4766d8f4..7b9659da42 100644
--- a/ARCHITECTURE.zh-CN.md
+++ b/ARCHITECTURE.zh-CN.md
@@ -29,7 +29,7 @@ Maka 通过插件组装应用。包声明自己提供和需要的能力,组合
`package.ts` 标识一个开发者声明的插件,Cargo crate 标识一起编译的代码。两者不必一一对应:Agent 服务可以使用多个领域 crate,相关插件入口也可以共用一个原生实现 crate。
-Host 与 UI 所有者使用相同的生命周期内核,通过 `host-js` 和 `ui-js` 注入 JavaScript 执行。原生渲染器和所有者无需 V8 或 Agent 引擎即可编译;存储与呈现所需的共用事实类型仍作为显式依赖存在。
+Host 与 UI 所有者使用相同的生命周期内核,通过 `host-js` 和 `ui-js` 执行适配器运行 JavaScript 插件。原生渲染器和所有者无需 V8 或 Agent 引擎即可编译;存储与呈现所需的共用事实类型仍作为显式依赖存在。
## 从包到运行中的应用
diff --git a/README.md b/README.md
index 002e9172fb..693518b0c0 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,7 @@ just run
| Directory | Purpose |
| --- | --- |
-| [platform/](platform/README.md) | Application kernel, Host/UI owners, JavaScript backends and native renderers |
+| [platform/](platform/README.md) | Application kernel, Host/UI owners, JavaScript execution adapters and native renderers |
| [plugins/](plugins/README.md) | Authored plugin declarations, business implementations and shared domain contracts |
| [products/maka/](products/maka/README.md) | Native factory selection, product composition, CLI and desktop entry points |
| `tools/schema/` | Contract/schema export without building the product |
diff --git a/README.zh-CN.md b/README.zh-CN.md
index f4cc67de60..ff873dc1ae 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -42,7 +42,7 @@ just run
| 目录 | 用途 |
| --- | --- |
-| [platform/](platform/README.zh-CN.md) | 应用内核、Host/UI owner、JavaScript 后端和原生渲染器 |
+| [platform/](platform/README.zh-CN.md) | 应用内核、Host/UI owner、JavaScript 执行适配器和原生渲染器 |
| [plugins/](plugins/README.zh-CN.md) | 插件声明、业务实现及共享领域契约 |
| [products/maka/](products/maka/README.zh-CN.md) | 原生工厂选择、产品组合、CLI 和桌面入口 |
| `tools/schema/` | 无需构建完整产品的契约与 schema 导出 |
diff --git a/platform/README.md b/platform/README.md
index 3edffa91f2..d32ae9be43 100644
--- a/platform/README.md
+++ b/platform/README.md
@@ -33,6 +33,6 @@ The platform loads packages, checks compositions, owns execution resources and p
| I/O and isolation | [network](network/README.md), [process](process/README.md), [sandbox](sandbox/README.md), [computer-use](computer-use/README.md) |
| Connections and health | [transport](transport/README.md), [background-health](background-health/README.md) |
-Host and UI share the plugin lifecycle kernel. JavaScript runs through optional backend adapters. Renderers consume committed frames and own native resources; they do not choose product pages.
+Host and UI share the plugin lifecycle kernel. Optional execution adapters run JavaScript plugins. Renderers consume committed frames and own native resources; they do not choose product pages.
The dependency boundary is deliberate: Host, UI and the renderers can compile without V8 or the Agent engine. Some platform code still depends on shared Agent facts for storage and presentation. Those data dependencies are visible in the Cargo manifests.
diff --git a/platform/README.zh-CN.md b/platform/README.zh-CN.md
index 0a72464712..84ab0fbdfd 100644
--- a/platform/README.zh-CN.md
+++ b/platform/README.zh-CN.md
@@ -33,6 +33,6 @@
| I/O 与隔离 | [network](network/README.zh-CN.md)、[process](process/README.zh-CN.md)、[sandbox](sandbox/README.zh-CN.md)、[computer-use](computer-use/README.zh-CN.md) |
| 连接与健康状态 | [transport](transport/README.zh-CN.md)、[background-health](background-health/README.zh-CN.md) |
-Host 和 UI 共用插件生命周期内核,通过可选后端接入 JavaScript。渲染器消费已提交帧、管理原生资源,不选择产品页面。
+Host 和 UI 共用插件生命周期内核,通过可选的执行适配器运行 JavaScript 插件。渲染器消费已提交帧、管理原生资源,不选择产品页面。
依赖边界是明确的:Host、UI 和渲染器无需 V8 或 Agent 引擎即可编译。部分平台代码仍依赖存储与呈现所需的 Agent 共用事实类型;这些数据依赖明确列在 Cargo 配置中。
diff --git a/platform/host-js/README.md b/platform/host-js/README.md
index 658d254a7b..44d984b37f 100644
--- a/platform/host-js/README.md
+++ b/platform/host-js/README.md
@@ -21,6 +21,6 @@
[简体中文](README.zh-CN.md)
-Runs JavaScript Host services through the backend interface of `maka-host-runtime`. `factory` creates the adapter with explicit limits. Guest calls retain the original Host context, imports and attachment slots; the adapter supplies execution, while the Host decides admission and owns cleanup. Native-only embeddings can omit this crate.
+Runs JavaScript Host services through the execution interface of `maka-host-runtime`. `factory` creates the adapter with explicit limits. Guest calls retain the original Host context, imports and attachment slots; the adapter supplies execution, while the Host decides admission and owns cleanup. Native-only embeddings can omit this crate.
[Source](src/lib.rs) · [Cargo manifest](Cargo.toml)
diff --git a/platform/host-js/README.zh-CN.md b/platform/host-js/README.zh-CN.md
index 716cc31caf..031db0e86b 100644
--- a/platform/host-js/README.zh-CN.md
+++ b/platform/host-js/README.zh-CN.md
@@ -21,6 +21,6 @@
[English](README.md)
-通过 `maka-host-runtime` 的后端接口执行 JavaScript Host 服务。`factory` 接收显式运行限制并创建适配器。Guest 调用沿用原始 Host 上下文、导入绑定和附件槽位;适配器负责执行,Host 负责准入和清理。只使用原生实现的嵌入程序可以不依赖本 crate。
+通过 `maka-host-runtime` 的执行接口执行 JavaScript Host 服务。`factory` 接收显式运行限制并创建适配器。Guest 调用沿用原始 Host 上下文、导入绑定和附件槽位;适配器负责执行,Host 负责准入和清理。只使用原生实现的嵌入程序可以不依赖本 crate。
[源码](src/lib.rs) · [Cargo 配置](Cargo.toml)
diff --git a/platform/host-runtime/README.md b/platform/host-runtime/README.md
index 2f6c0012d6..f8a7309532 100644
--- a/platform/host-runtime/README.md
+++ b/platform/host-runtime/README.md
@@ -21,7 +21,7 @@
[简体中文](README.zh-CN.md)
-Runs checked service compositions and owns call admission, activation and retirement. Products supply native factories and, when needed, a JavaScript backend. See `application` for the owner and client API; `application/native_context.rs` is the starting point for native services.
+Runs checked service compositions and owns call admission, activation and retirement. Products supply native factories and, when needed, a JavaScript execution adapter. See `application` for the owner and client API; `application/native_context.rs` is the starting point for native services.
A committed source is desired configuration. It becomes effective only after its instances converge. Updates preserve unchanged activations and their captured bindings; replacements wait for accepted calls and native resources to settle. Mutation receipts distinguish business results from cleanup, so a lost reply must be resolved through its original receipt.
diff --git a/platform/host-runtime/README.zh-CN.md b/platform/host-runtime/README.zh-CN.md
index 54803647ff..47218d8b36 100644
--- a/platform/host-runtime/README.zh-CN.md
+++ b/platform/host-runtime/README.zh-CN.md
@@ -21,7 +21,7 @@
[English](README.md)
-执行经过校验的服务组合,负责调用准入、激活和退役。产品提供原生工厂,并按需注入 JavaScript 后端。所有者与客户端 API 见 `application`;编写原生服务可从 `application/native_context.rs` 开始。
+执行经过校验的服务组合,负责调用准入、激活和退役。产品提供原生工厂,并按需注入 JavaScript 执行适配器。所有者与客户端 API 见 `application`;编写原生服务可从 `application/native_context.rs` 开始。
提交的配置表示期望状态,实例完成收敛后才成为有效状态。更新保留未改变的激活及其绑定;替换必须等待已接受调用和原生资源完成清理。操作回执区分业务结果与清理状态,丢失响应后应查询原回执。
diff --git a/platform/ui-js/README.md b/platform/ui-js/README.md
index 2616aa77c1..e818cd198c 100644
--- a/platform/ui-js/README.md
+++ b/platform/ui-js/README.md
@@ -21,6 +21,6 @@
[简体中文](README.zh-CN.md)
-Executes JavaScript component callbacks for `maka-ui-runtime`. `execution` creates the backend options used by a product embedding. The adapter runs activation and callback code within guest limits; the UI owner validates and commits the resulting batch. Native input resources, mutation receipts and mount cleanup stay with that owner.
+Executes JavaScript component callbacks for `maka-ui-runtime`. `execution` configures the execution adapter for a product embedding. The adapter runs activation and callback code within guest limits; the UI owner validates and commits the resulting batch. Native input resources, mutation receipts and mount cleanup stay with that owner.
[Source](src/lib.rs) · [Cargo manifest](Cargo.toml)
diff --git a/platform/ui-js/README.zh-CN.md b/platform/ui-js/README.zh-CN.md
index 6edec3e97f..9aa13f6f95 100644
--- a/platform/ui-js/README.zh-CN.md
+++ b/platform/ui-js/README.zh-CN.md
@@ -21,6 +21,6 @@
[English](README.md)
-为 `maka-ui-runtime` 执行 JavaScript 组件回调。`execution` 创建产品嵌入方使用的后端配置。适配器在 guest 限制内执行激活与回调代码,UI 所有者校验并提交结果批次。原生输入资源、操作回执和挂载清理仍归该所有者管理。
+为 `maka-ui-runtime` 执行 JavaScript 组件回调。`execution` 为产品嵌入方配置执行适配器。适配器在 guest 限制内执行激活与回调代码,UI 所有者校验并提交结果批次。原生输入资源、操作回执和挂载清理仍归该所有者管理。
[源码](src/lib.rs) · [Cargo 配置](Cargo.toml)
diff --git a/platform/ui-runtime/README.md b/platform/ui-runtime/README.md
index 5ed832bac0..bca178aec0 100644
--- a/platform/ui-runtime/README.md
+++ b/platform/ui-runtime/README.md
@@ -21,7 +21,7 @@
[简体中文](README.zh-CN.md)
-Owns component activation, state, input dispatch and atomic frame updates. `Application` runs a checked UI composition; `NativeRegistry` supplies compiled factories and a scene compiler. Products inject JavaScript execution through `backend` when needed.
+Owns component activation, state, input dispatch and atomic frame updates. `Application` runs a checked UI composition; `NativeRegistry` supplies compiled factories and a scene compiler. Products inject a JavaScript execution adapter through the `backend` module when needed.
A callback proposes state, a frame and one-shot actions. The runtime validates the whole batch before committing it. Renderers consume committed frames and own platform resources; they do not execute guest code during layout or paint. Terminal and desktop scenes have separate languages.
diff --git a/platform/ui-runtime/README.zh-CN.md b/platform/ui-runtime/README.zh-CN.md
index 46b2386fe9..af892e40b4 100644
--- a/platform/ui-runtime/README.zh-CN.md
+++ b/platform/ui-runtime/README.zh-CN.md
@@ -21,7 +21,7 @@
[English](README.md)
-管理组件激活、状态、输入分发和帧的原子更新。`Application` 执行经过校验的 UI 组合,`NativeRegistry` 提供编译进程序的工厂和场景编译器。需要 JavaScript 时,由产品通过 `backend` 注入。
+管理组件激活、状态、输入分发和帧的原子更新。`Application` 执行经过校验的 UI 组合,`NativeRegistry` 提供编译进程序的工厂和场景编译器。需要 JavaScript 时,由产品通过 `backend` 模块注入执行适配器。
回调提交状态、帧和一次性动作的候选结果,运行时校验整个批次后再提交。渲染器消费已提交帧并管理平台资源,不在布局或绘制时执行 guest 代码。终端和桌面使用各自的场景语言。
diff --git a/products/maka/cli/README.md b/products/maka/cli/README.md
index 49d285cac5..5c4aa04410 100644
--- a/products/maka/cli/README.md
+++ b/products/maka/cli/README.md
@@ -21,7 +21,7 @@
[简体中文](README.zh-CN.md)
-Builds the `maka` executable. It starts the terminal product, serves Hosts, exposes ACP and provides application inspection, composition and installation commands. Product startup wires native factories and JavaScript backends into the platform owners.
+Builds the `maka` executable. It starts the terminal product, serves Hosts, exposes ACP and provides application inspection, composition and installation commands. Product startup wires native factories and JavaScript execution adapters into the platform owners.
From the repository root, run `just run` or `just run --help`. Development builds load `../bundle/dist`; `just run` rebuilds that bundle before Cargo starts. Release builds embed it. Desktop runs in a separate sibling executable.
diff --git a/products/maka/cli/README.zh-CN.md b/products/maka/cli/README.zh-CN.md
index 4f07684058..0be23daf1a 100644
--- a/products/maka/cli/README.zh-CN.md
+++ b/products/maka/cli/README.zh-CN.md
@@ -21,7 +21,7 @@
[English](README.md)
-构建 `maka` 可执行文件,负责终端产品启动、Host 服务、ACP,以及应用检查、组合和安装命令。产品启动将原生工厂和 JavaScript 后端接入平台所有者。
+构建 `maka` 可执行文件,负责终端产品启动、Host 服务、ACP,以及应用检查、组合和安装命令。产品启动将原生工厂和 JavaScript 执行适配器接入平台所有者。
在仓库根目录执行 `just run` 或 `just run --help`。开发构建读取 `../bundle/dist`,`just run` 会先重建该 bundle 再启动 Cargo。发布构建将其嵌入程序。桌面端使用独立的同目录可执行文件。
diff --git a/products/maka/desktop/README.md b/products/maka/desktop/README.md
index 499f720d9b..0df728efc6 100644
--- a/products/maka/desktop/README.md
+++ b/products/maka/desktop/README.md
@@ -21,7 +21,7 @@
[简体中文](README.zh-CN.md)
-Builds the `maka-desktop` executable and owns native windows. It loads a committed Desktop composition, injects the UI JavaScript backend and uses `maka-render-gpui` to present frames. Pages and workflows come from plugin packages.
+Builds the `maka-desktop` executable and owns native windows. It loads a committed Desktop composition, injects the UI JavaScript execution adapter and uses `maka-render-gpui` to present frames. Pages and workflows come from plugin packages.
Build with `just build`, then launch an installed Desktop deployment with `target/debug/maka desktop --root PATH --deployment UUID --connections FILE`. The CLI starts its sibling frontend. Window shutdown waits for native resource release, accepted operations and Host connection cleanup. Platform-specific IME and accessibility behavior needs verification in a real window.
diff --git a/products/maka/desktop/README.zh-CN.md b/products/maka/desktop/README.zh-CN.md
index 5d054e9464..2a879af604 100644
--- a/products/maka/desktop/README.zh-CN.md
+++ b/products/maka/desktop/README.zh-CN.md
@@ -21,7 +21,7 @@
[English](README.md)
-构建 `maka-desktop` 可执行文件并管理原生窗口。它加载已提交的 Desktop 组合,注入 UI JavaScript 后端,并通过 `maka-render-gpui` 呈现帧。页面与工作流来自插件包。
+构建 `maka-desktop` 可执行文件并管理原生窗口。它加载已提交的 Desktop 组合,注入 UI JavaScript 执行适配器,并通过 `maka-render-gpui` 呈现帧。页面与工作流来自插件包。
使用 `just build` 构建,再以 `target/debug/maka desktop --root PATH --deployment UUID --connections FILE` 启动已安装的 Desktop 部署。CLI 会启动同目录前端。窗口关闭需要等待原生资源释放、已接受操作和 Host 连接清理。平台特有的 IME 与无障碍行为需要在真实窗口中验证。
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For additional commands, e-mail: commits-help@maka.apache.org