merge: resolve manuscript conflicts with latest main comments
This commit is contained in:
+36
-2
@@ -34,6 +34,7 @@ use crate::{
|
||||
endor_host,
|
||||
};
|
||||
|
||||
// 只监听 IPv4 回环固定端口,接口用于本进程原生输入和本机 agent,不是对外网络服务器。
|
||||
pub const API_ADDRESS: &str = "127.0.0.1:4737";
|
||||
const MAX_CODE_SIZE: u64 = endor_host::MAX_SOURCE_BYTES as u64;
|
||||
type Notify = Arc<dyn Fn() + Send + Sync>;
|
||||
@@ -87,12 +88,14 @@ impl RuntimeControl {
|
||||
|
||||
/// 只发出一次退出请求,唤醒 worker 执行清理,并通过完成句柄通知原生循环。
|
||||
pub fn request_shutdown(&self) -> bool {
|
||||
// 原子标志合并重复退出请求;已请求直接返回 true,不在 GUI 线程重复排队清理。
|
||||
if self.requested.swap(true, Ordering::AcqRel) {
|
||||
return true;
|
||||
}
|
||||
if self.sender.try_send(()).is_ok() {
|
||||
true
|
||||
} else {
|
||||
// 控制队列不可用时回滚请求标志,允许调用方识别失败并再次尝试,而非永远卡在假退出状态。
|
||||
self.requested.store(false, Ordering::Release);
|
||||
false
|
||||
}
|
||||
@@ -106,6 +109,7 @@ impl RuntimeControl {
|
||||
let (lock, ready) = &*self.completion;
|
||||
let result = lock.lock().ok()?;
|
||||
let (result, _) = ready
|
||||
// 条件变量处理虚假唤醒,直到完成槽非空或超时;返回 None 也可能来自锁中毒,不能当作清理成功。
|
||||
.wait_timeout_while(result, timeout, |result| result.is_none())
|
||||
.ok()?;
|
||||
result.clone()
|
||||
@@ -138,11 +142,12 @@ struct BuildRequest {
|
||||
submission: u64,
|
||||
}
|
||||
|
||||
/// 建立本模块的执行/服务上下文,并把后续推进交给返回的句柄或驱动。
|
||||
/// 绑定回环 API,启动请求接收与单 VM worker,返回活动日志及一次性退出控制句柄。
|
||||
pub fn start(
|
||||
namespace: Arc<RwLock<NamespaceState>>,
|
||||
proxy: EventLoopProxy<AppEvent>,
|
||||
) -> Result<(Activity, RuntimeControl)> {
|
||||
// 退出控制仅需一个消息槽,正常执行请求另走容量8队列,避免工作排满后无法通知关闭。
|
||||
let (sender, receiver) = sync_channel(1);
|
||||
let control = RuntimeControl {
|
||||
sender,
|
||||
@@ -156,6 +161,7 @@ pub fn start(
|
||||
control: control.clone(),
|
||||
proxy: proxy.clone(),
|
||||
};
|
||||
// 绑定失败在启动阶段反馈,不能假装本机 API 可用;后台通知仅发送 GUI 事件,不直接画窗口。
|
||||
let server = Server::http(API_ADDRESS)
|
||||
.map_err(|error| anyhow::anyhow!(error))
|
||||
.with_context(|| format!("bind Tessera API to {API_ADDRESS}"))?;
|
||||
@@ -203,6 +209,7 @@ fn start_server_observed(
|
||||
shutdown: Option<Shutdown>,
|
||||
native_port: Option<Arc<OnceLock<SyncSender<BuildRequest>>>>,
|
||||
) -> Result<thread::JoinHandle<()>> {
|
||||
// HTTP 接收与 VM 执行分离,最多8个排队请求;源代码只在单个 endor-worker 中操作 VM。
|
||||
let (sender, receiver) = sync_channel::<BuildRequest>(8);
|
||||
if let Some(native_port) = native_port {
|
||||
native_port
|
||||
@@ -218,11 +225,13 @@ fn start_server_observed(
|
||||
.name("tessera-endor-worker".into())
|
||||
.spawn(move || {
|
||||
let mut worker = Worker::default();
|
||||
// 分片请求跨循环保留原 HTTP 请求和继续句柄;同一时刻只推进一个有未完成 VM 执行的输入。
|
||||
let mut pending: Option<(BuildRequest, PendingRequest)> = None;
|
||||
loop {
|
||||
if let Some(shutdown) = &shutdown
|
||||
&& shutdown.receiver.try_recv().is_ok()
|
||||
{
|
||||
// 退出优先于下一量子:先撤去待响应请求,再由 shutdown_runtime 清理 VM 续体与生命周期资源。
|
||||
if let Some((job, input)) = pending.take() {
|
||||
drop(input);
|
||||
let _ = job
|
||||
@@ -230,12 +239,14 @@ fn start_server_observed(
|
||||
.respond(error_response(StatusCode(503), "application is exiting"));
|
||||
}
|
||||
let outcome = worker.shutdown_runtime();
|
||||
// 排队请求全部明确回应503,不能留着客户端无期限等待已经停止的执行线程。
|
||||
while let Ok(job) = receiver.try_recv() {
|
||||
let _ = job
|
||||
.request
|
||||
.respond(error_response(StatusCode(503), "application is exiting"));
|
||||
}
|
||||
if let Ok(mut current) = worker_namespace.write() {
|
||||
// 撤销所有帧的会话/焦点与原生命令,让 GUI 不再把旧资源当成仍可执行的活域。
|
||||
current.runtime_session = 0;
|
||||
current.window_commands.clear();
|
||||
current.document.frame.session = 0;
|
||||
@@ -249,6 +260,7 @@ fn start_server_observed(
|
||||
let (lock, ready) = &*shutdown.control.completion;
|
||||
if let Ok(mut result) = lock.lock() {
|
||||
*result = Some(outcome.clone());
|
||||
// 先在锁内保存清理结果再唤醒等待者,同时用 AppEvent 通知原生事件循环退出,两条路径复用同一 outcome。
|
||||
ready.notify_all();
|
||||
}
|
||||
let _ = shutdown.proxy.send_event(AppEvent::ShutdownComplete {
|
||||
@@ -256,6 +268,7 @@ fn start_server_observed(
|
||||
});
|
||||
break;
|
||||
}
|
||||
// 分片只让出线程,不并行执行后续输入;当前请求完成才回应并处理下一队列项。
|
||||
if let Some((job, input)) = pending.take() {
|
||||
match worker.resume_request(&job, input, &worker_namespace, &worker_notify) {
|
||||
RequestProgress::Pending(input) => {
|
||||
@@ -271,6 +284,7 @@ fn start_server_observed(
|
||||
}
|
||||
continue;
|
||||
}
|
||||
// 空闲输入边界先推进视口刷新与任务,待执行刷新/协作任务时零等待,否则最多100ms检查一次。
|
||||
worker.refresh_viewport(&worker_namespace, &worker_notify);
|
||||
let wait = if worker.repl.as_ref().is_some_and(|(_, runtime)| {
|
||||
runtime.has_pending_refresh() || runtime.has_cooperative_tasks()
|
||||
@@ -306,6 +320,7 @@ fn start_server_observed(
|
||||
&& current.runtime_session != runtime.id
|
||||
})
|
||||
}) {
|
||||
// 当前持久域同时失去 submission 和 runtime_session 归属时退役;不能仅因源码请求排队就误删仍权威的旧域。
|
||||
worker.repl = None;
|
||||
}
|
||||
if wait.is_zero() {
|
||||
@@ -323,6 +338,7 @@ fn start_server_observed(
|
||||
if exiting
|
||||
.as_ref()
|
||||
.is_some_and(|flag| flag.load(Ordering::Acquire))
|
||||
// 退出后拒绝写入/执行路由,GET 与 OPTIONS 仍可读取最近发布值或探测接口。
|
||||
&& !matches!(request.method(), Method::Get | Method::Options)
|
||||
{
|
||||
let _ =
|
||||
@@ -378,8 +394,9 @@ struct ObservedRequest {
|
||||
notify: Notify,
|
||||
}
|
||||
impl ObservedRequest {
|
||||
/// 构造本类型并初始化其状态;资源建立和默认字段以函数体为准。
|
||||
/// 从请求提取允许观察的头部与显示来源,创建活动记录并通知工具界面。
|
||||
fn new(inner: Request, activity: Activity, notify: Notify) -> Self {
|
||||
// 活动观察只保留 Content-Type/Length;X-Tessera-Origin 仅判来源标签,不把任意认证头复制进工具日志。
|
||||
let headers = inner
|
||||
.headers()
|
||||
.iter()
|
||||
@@ -387,6 +404,7 @@ impl ObservedRequest {
|
||||
.map(ToString::to_string)
|
||||
.collect::<Vec<_>>()
|
||||
.join("\n");
|
||||
// console 标记只是显示来源,不提供权限,也不改变 VM 执行语义。
|
||||
let origin = if inner
|
||||
.headers()
|
||||
.iter()
|
||||
@@ -421,7 +439,9 @@ impl ObservedRequest {
|
||||
let status = response.status_code();
|
||||
let headers = response.headers().to_vec();
|
||||
let length = response.data_length();
|
||||
// 响应正文本已在内存 Cursor,记录预览后用原 status/headers/reader/length 重建响应,不消费正文内容。
|
||||
let reader = response.into_reader();
|
||||
// 记录的是已构造响应,即使后面 socket 发送失败也已结束活动记录,不能据此声称客户端成功接收。
|
||||
self.activity.lock().unwrap().finish(
|
||||
self.id,
|
||||
status.0,
|
||||
@@ -462,6 +482,7 @@ fn handle(
|
||||
) {
|
||||
let request = ObservedRequest::new(request, activity.clone(), observer_notify.clone());
|
||||
let method = request.method().clone();
|
||||
// 路由匹配去掉查询串,namespace 从固定路径提取;不把 query 当作命名空间或源代码。
|
||||
let path = request
|
||||
.url()
|
||||
.split('?')
|
||||
@@ -472,6 +493,7 @@ fn handle(
|
||||
let evaluation = namespace_from_route(&path, "/evaluate");
|
||||
let repl = namespace_from_route(&path, "/repl");
|
||||
let event = namespace_from_route(&path, "/events");
|
||||
// PUT/code 完整替换,POST 在 events/repl/evaluate 中分类,DELETE/repl 是持久会话重置;其他交给资源读取/清空路径。
|
||||
let route = if method == Method::Put {
|
||||
namespace_from_path(&path).map(|name| (name, RequestKind::Code))
|
||||
} else if method == Method::Post {
|
||||
@@ -524,6 +546,7 @@ fn code_request(
|
||||
);
|
||||
}
|
||||
|
||||
// GET 返回最近成功发布的 source 而非正在排队的输入,并通过头部暴露 revision/session/window/layout 及逻辑视口。
|
||||
if method == Method::Get {
|
||||
let mut response = text(
|
||||
StatusCode(200),
|
||||
@@ -578,6 +601,7 @@ fn code_request(
|
||||
);
|
||||
return response;
|
||||
}
|
||||
// 释放读锁后才申请写锁,避免同一线程持读锁升级为写锁死锁;修改结束也先解锁再发送 GUI 通知。
|
||||
drop(current);
|
||||
|
||||
match method {
|
||||
@@ -620,6 +644,7 @@ fn submit(
|
||||
return;
|
||||
}
|
||||
};
|
||||
// 读取成功后才保存受限活动正文预览;超长或非法 UTF-8 请求不会进入执行队列。
|
||||
request.record_body(&source);
|
||||
let Ok(mut current) = namespace.write() else {
|
||||
let _ = request.respond(error_response(
|
||||
@@ -632,6 +657,7 @@ fn submit(
|
||||
let _ = request.respond(error_response(StatusCode(404), "namespace is not active"));
|
||||
return;
|
||||
}
|
||||
// 仅完整 Code 请求分配新 submission,事件/REPL/表达式继承当前身份,保留共享域输入顺序。
|
||||
let submission = match if kind == RequestKind::Code {
|
||||
current.next_submission()
|
||||
} else {
|
||||
@@ -651,6 +677,7 @@ fn submit(
|
||||
namespace: addressed.into(),
|
||||
submission,
|
||||
};
|
||||
// 持 namespace 写锁完成入队和接受身份更新;worker 提交使用同一锁,保证接受与发布之间没有竞态窗口。
|
||||
match sender.try_send(job) {
|
||||
// A rejected queue entry never invalidates accepted work. The worker
|
||||
// uses this same lock when committing, so publication is atomic.
|
||||
@@ -659,6 +686,7 @@ fn submit(
|
||||
current.submission = submission;
|
||||
}
|
||||
}
|
||||
// 队列拒绝时不推进 submission,所以已经接受的旧工作不会因为本次失败请求而失去发布资格。
|
||||
Err(TrySendError::Full(job)) => {
|
||||
let _ = job
|
||||
.request
|
||||
@@ -684,6 +712,7 @@ fn superseded(submission: u64) -> Response<std::io::Cursor<Vec<u8>>> {
|
||||
|
||||
/// 从固定路由格式提取命名空间,避免把不匹配的路径当作代码资源。
|
||||
fn namespace_from_route<'a>(path: &'a str, suffix: &str) -> Option<&'a str> {
|
||||
// 同时检查前后缀且命名空间非空、无额外斜杠;不做模糊路径前缀匹配。
|
||||
path.strip_prefix("/v1/namespaces/")?
|
||||
.strip_suffix(suffix)
|
||||
.filter(|namespace| !namespace.is_empty() && !namespace.contains('/'))
|
||||
@@ -701,6 +730,8 @@ fn read_code(request: &mut Request) -> Result<String> {
|
||||
{
|
||||
anyhow::bail!("code exceeds the 1 MiB limit");
|
||||
}
|
||||
// 已知 Content-Length 先预拒绝,再在流上最多读上限+1;防止缺失/不实长度绕过容量限制。
|
||||
// read_to_string 要求 UTF-8,不用有损替换改变用户源码。
|
||||
let mut code = String::new();
|
||||
request
|
||||
.as_reader()
|
||||
@@ -717,6 +748,7 @@ fn read_code(request: &mut Request) -> Result<String> {
|
||||
fn compile_error(error: anyhow::Error) -> Response<std::io::Cursor<Vec<u8>>> {
|
||||
let mut diagnostic =
|
||||
serde_json::json!({ "severity": "error", "message": format!("{error:#}") });
|
||||
// 有 SourceDiagnostic 才附行/列和半开字节范围;其他运行时错误仍保留完整错误链消息,不编造源码位置。
|
||||
if let Some(source) = error.downcast_ref::<frontend::SourceDiagnostic>() {
|
||||
diagnostic["line"] = source.location.line.into();
|
||||
diagnostic["column"] = source.location.column.into();
|
||||
@@ -756,6 +788,7 @@ fn markdown(status: StatusCode, value: String) -> Response<std::io::Cursor<Vec<u
|
||||
|
||||
/// 以明确的内容类型和状态码构造响应,并应用本机 API 的公共响应头。
|
||||
fn text(status: StatusCode, value: &str, content_type: &str) -> Response<std::io::Cursor<Vec<u8>>> {
|
||||
// 公共响应头只允许固定本机 Origin/方法/头名,非通配任意来源;这些头不替代回环绑定与路由校验。
|
||||
let mut response = Response::from_string(value).with_status_code(status);
|
||||
add_header(&mut response, "Content-Type", content_type);
|
||||
add_header(
|
||||
@@ -778,6 +811,7 @@ fn text(status: StatusCode, value: &str, content_type: &str) -> Response<std::io
|
||||
|
||||
/// 向响应追加经过 HTTP 库检查的头字段,不直接拼接未验证的原始报文。
|
||||
fn add_header(response: &mut Response<std::io::Cursor<Vec<u8>>>, name: &str, value: &str) {
|
||||
// 由 HTTP 库验证字段格式,非法头被忽略,不把未校验字符拼进原始响应报文。
|
||||
if let Ok(header) = Header::from_bytes(name, value) {
|
||||
response.add_header(header);
|
||||
}
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
//! 从当前命名空间生成 /agent 使用指南。返回的示例、地址和版本描述来自运行时上下文;这里生成文档,不执行用户源码。
|
||||
//!
|
||||
//! Live agent-facing guide generated from the current namespace.
|
||||
//! 指南正文是返回给客户端的静态 Markdown 模板,只有命名空间、版本、地址和内置示例按参数填充。
|
||||
use super::*;
|
||||
|
||||
/// 用当前命名空间、地址和版本填充在线指南,示例来自项目内置 Endor 源码。
|
||||
/// 为 /agent 生成可提交代码与查询接口的 Markdown 说明。
|
||||
/// format! 使用具名插值注入 namespace.name/revision 与监听地址;示例在编译时嵌入,
|
||||
/// 因而请求不会访问示例文件、执行示例或改变会话。正文中的 JSON/Endor 是文档内容。
|
||||
pub(super) fn agent_guide(namespace: &NamespaceState) -> String {
|
||||
format!(
|
||||
r##"# Tessera Agent API
|
||||
|
||||
@@ -10,6 +10,8 @@ use std::{
|
||||
};
|
||||
|
||||
#[test]
|
||||
/// 模拟 reset 后旧画面仍含编号 2 的窗口,而新 Console VM 恰好再次分配编号 2。
|
||||
/// 关闭 session=0 的旧投影只能移除画面,不能按相同数字误关新 VM 的真实资源。
|
||||
fn preserved_picture_close_does_not_retire_same_number_in_fresh_console_vm() {
|
||||
let (_, mut picture) = endor_host::ReplSession::load(
|
||||
include_str!("../../../examples/windows.endor"),
|
||||
@@ -18,6 +20,7 @@ fn preserved_picture_close_does_not_retire_same_number_in_fresh_console_vm() {
|
||||
150,
|
||||
)
|
||||
.unwrap();
|
||||
// 把旧文档标成无活动 VM 的保留投影;编号相同也不能据此识别当前资源。
|
||||
picture.frame.session = 0;
|
||||
for view in picture.windows.values_mut() {
|
||||
view.frame.session = 0;
|
||||
@@ -80,6 +83,7 @@ fn preserved_picture_close_does_not_retire_same_number_in_fresh_console_vm() {
|
||||
);
|
||||
}
|
||||
|
||||
/// 一次测试独占的临时 HTTP 服务;端口由系统分配,持有线程句柄以便结束时解除阻塞并回收。
|
||||
struct TestServer {
|
||||
server: Arc<Server>,
|
||||
address: SocketAddr,
|
||||
@@ -87,6 +91,8 @@ struct TestServer {
|
||||
}
|
||||
|
||||
impl TestServer {
|
||||
/// 发送带明确 Content-Length 的 UTF-8 文本请求,使用 Connection: close 读至响应结束。
|
||||
/// 返回状态码、原始头和正文;10 秒超时使服务端死锁表现为测试失败而非无限等待。
|
||||
fn request(&self, method: &str, path: &str, body: &str) -> (u16, String, String) {
|
||||
let mut stream = TcpStream::connect(self.address).unwrap();
|
||||
stream
|
||||
@@ -105,6 +111,7 @@ impl TestServer {
|
||||
}
|
||||
|
||||
impl Drop for TestServer {
|
||||
/// 解除服务端 accept 等待并等待线程结束,避免测试之间遗留监听线程。
|
||||
fn drop(&mut self) {
|
||||
self.server.unblock();
|
||||
if let Some(api) = self.api.take() {
|
||||
@@ -114,6 +121,8 @@ impl Drop for TestServer {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 通过 HTTP 提交覆盖 moveTab 的 Page 子类,再发送带帧身份的 tab-drop。
|
||||
/// 检查源覆盖恰好调用一次、页面顺序改变,以及重放旧事件返回 409 而不损坏运行时。
|
||||
fn native_tab_drop_route_reorders_live_pages_and_rejects_reused_frames() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState::default()));
|
||||
@@ -157,6 +166,7 @@ fn native_tab_drop_route_reorders_live_pages_and_rejects_reused_frames() {
|
||||
}),
|
||||
}
|
||||
};
|
||||
// 保留同一事件正文用于重放测试,不能重新读取新 layout_version,否则就不是过期输入。
|
||||
let body = serde_json::to_string(&input).unwrap();
|
||||
let response = client.request("POST", "/v1/namespaces/app.main/events", &body);
|
||||
assert_eq!(response.0, 200, "{}", response.2);
|
||||
@@ -177,6 +187,8 @@ fn native_tab_drop_route_reorders_live_pages_and_rejects_reused_frames() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 零延时任务触发非法窗口尺寸,使后台回调先产生运行时故障。
|
||||
/// 之后多次 REPL 请求都应被拒绝,同时保留原始 stop/window size 诊断,而非用后续错误覆盖。
|
||||
fn background_failure_preserves_its_cause_after_rejected_console_input() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState::default()));
|
||||
@@ -215,6 +227,8 @@ fn background_failure_preserves_its_cause_after_rejected_console_input() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 依次创建未挂载对象、读取共享值、挂载、reset,再用完整 PUT 替换会话。
|
||||
/// 验证未挂载输入不增 revision,reset 清绑定但保留画面,成功 PUT 才切换到新 VM。
|
||||
fn console_keeps_memory_until_reset_or_complete_put_without_erasing_the_page() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState::default()));
|
||||
@@ -226,6 +240,7 @@ fn console_keeps_memory_until_reset_or_complete_put_without_erasing_the_page() {
|
||||
};
|
||||
let repl = "/v1/namespaces/app.main/repl";
|
||||
let code = "/v1/namespaces/app.main/code";
|
||||
// 先创建对象但不 render;返回值可以跨 REPL 请求复用,发布 revision 此时仍为 0。
|
||||
let created = client.request("POST", repl, "title = ui.text(\"中文\")");
|
||||
assert_eq!(created.0, 200, "{}", created.2);
|
||||
let created: serde_json::Value = serde_json::from_str(&created.2).unwrap();
|
||||
@@ -262,6 +277,8 @@ fn console_keeps_memory_until_reset_or_complete_put_without_erasing_the_page() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 经真实 HTTP 完成指南读取、PUT/GET、失败候选、再次 PUT 和 DELETE。
|
||||
/// 同时检查诊断位置、源文本/版本头、空文档、错误 namespace 与通知次数,确保仅成功发布改变版本。
|
||||
fn http_executes_real_endor_preserves_failed_updates_and_supports_delete() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState::default()));
|
||||
@@ -317,6 +334,8 @@ fn http_executes_real_endor_preserves_failed_updates_and_supports_delete() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 直接推进 worker 的 submission,模拟新候选已接受但尚未成功替换的时刻。
|
||||
/// 旧 VM 的 retained 仍可读;clear 撤销 namespace 后再刷新,才释放 live owner。
|
||||
fn queued_candidate_keeps_live_owner_until_delete_revokes_it() {
|
||||
let (runtime, document) = endor_host::ReplSession::load(
|
||||
"retained = ui.state(9)\npage = Page()\npage.render(ui.textOf(retained,\"value\"))",
|
||||
@@ -361,6 +380,8 @@ fn queued_candidate_keeps_live_owner_until_delete_revokes_it() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 用通知回调中的通道阻塞第一轮 worker,再使第二个 PUT 排队。
|
||||
/// 此时 GET/DELETE 仍应可用;释放 worker 后第一请求成功、被 DELETE 超越的候选返回 409,文档保持清空。
|
||||
fn http_delete_remains_available_and_invalidates_queued_put() {
|
||||
use std::{
|
||||
sync::{Mutex, mpsc},
|
||||
@@ -370,6 +391,7 @@ fn http_delete_remains_available_and_invalidates_queued_put() {
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState::default()));
|
||||
let (entered_tx, entered_rx) = mpsc::channel();
|
||||
let (release_tx, release_rx) = mpsc::channel();
|
||||
// 通知是共享闭包;用 Mutex 包装接收端使其满足线程共享约束,只阻塞第一次通知。
|
||||
let release_rx = Mutex::new(release_rx);
|
||||
let calls = AtomicUsize::new(0);
|
||||
let notify: Notify = Arc::new(move || {
|
||||
@@ -384,9 +406,11 @@ fn http_delete_remains_available_and_invalidates_queued_put() {
|
||||
server,
|
||||
api: Some(api),
|
||||
};
|
||||
// Unblock even if a test assertion fails, before scoped threads join.
|
||||
// 析构守卫在 scoped 线程 join 前释放阻塞通知;即使断言 panic 也不能让 worker 永久等通道。
|
||||
// 持有释放信号的发送端;离开作用域即通知 worker 继续,包括异常展开路径。
|
||||
struct Release(mpsc::Sender<()>);
|
||||
impl Drop for Release {
|
||||
// send 失败意味着接收端已结束,此时无需再阻塞测试清理。
|
||||
fn drop(&mut self) {
|
||||
let _ = self.0.send(());
|
||||
}
|
||||
@@ -406,6 +430,7 @@ fn http_delete_remains_available_and_invalidates_queued_put() {
|
||||
}
|
||||
assert_eq!(client.request("GET", route, "").2, example);
|
||||
assert_eq!(client.request("DELETE", route, "").0, 200);
|
||||
// DELETE 已同步清空文档并提升提交身份,现在解除第一请求通知阻塞,让排队候选观察到失效。
|
||||
drop(release);
|
||||
assert_eq!(first.join().unwrap().0, 200);
|
||||
assert_eq!(pending.join().unwrap().0, 409);
|
||||
@@ -415,6 +440,7 @@ fn http_delete_remains_available_and_invalidates_queued_put() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 检查 code 路径解析只接受完整的单段 namespace;缺少后缀和嵌套斜线均返回 None。
|
||||
fn extracts_namespace_only_from_code_routes() {
|
||||
assert_eq!(
|
||||
namespace_from_path("/v1/namespaces/app.main/code"),
|
||||
@@ -425,6 +451,7 @@ fn extracts_namespace_only_from_code_routes() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 对生成的指南做契约回归:保留代码 CRUD、可运行示例和当前地址,移除旧 export scene/display_list 暴露。
|
||||
fn guide_contains_only_code_crud_routes() {
|
||||
let guide = agent_guide(&NamespaceState::default());
|
||||
assert!(guide.contains("Code CRUD"));
|
||||
@@ -435,6 +462,8 @@ fn guide_contains_only_code_crud_routes() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 创建已经就绪的定时任务,先按前台模式刷新再读取计数,确保输入前不抢跑回调。
|
||||
/// 随后允许空闲刷新并推进待完成工作,计数应从 0 变为 1。
|
||||
fn foreground_refresh_does_not_deliver_new_callbacks_ahead_of_input() {
|
||||
let source = r#"
|
||||
class Action {
|
||||
@@ -459,6 +488,7 @@ page.render(TextBlock("input priority"))
|
||||
next_session: 801,
|
||||
};
|
||||
let notify: Notify = Arc::new(|| {});
|
||||
// 前台模式仅处理输入前必须收敛的刷新,不引入新的任务交付。
|
||||
worker.refresh_viewport_mode(&namespace, ¬ify, true);
|
||||
let value = worker
|
||||
.repl
|
||||
@@ -484,6 +514,8 @@ page.render(TextBlock("input priority"))
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 在负世界坐标放置按钮,通过 HTTP 平移/锚定缩放,再发送世界坐标 click。
|
||||
/// 检查相机数值、旧帧重放 409、按钮计数,以及零倍率 400 不导致 VM fault。
|
||||
fn canvas_camera_crosses_real_http_route_and_preserves_negative_world_clicks() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState {
|
||||
@@ -586,6 +618,8 @@ page.render(button)
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 给局部 CanvasViewport 添加父内边距和自身左边框,检验页面坐标到内容相机锚点的转换。
|
||||
/// 成功平移/缩放后核对相机状态;边框、边界与视口外锚点均须返回 400,保留健康运行时。
|
||||
fn explicit_viewport_camera_crosses_http_and_rejects_bad_anchors_without_faulting() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState {
|
||||
@@ -658,6 +692,7 @@ fn explicit_viewport_camera_crosses_http_and_rejects_bad_anchors_without_faultin
|
||||
expected
|
||||
);
|
||||
}
|
||||
// 分别覆盖左边框、右侧边界及远离视口的锚点,避免只校验整个窗口范围。
|
||||
for point in [[25.0, 30.0], [220.0, 30.0], [700.0, 700.0]] {
|
||||
let response = client.request(
|
||||
"POST",
|
||||
@@ -670,6 +705,8 @@ fn explicit_viewport_camera_crosses_http_and_rejects_bad_anchors_without_faultin
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 通过真实 HTTP 检查透视缩放/orbit、正交缩放,再替换为源实现 PanOnly。
|
||||
/// 比较相机数值与自定义控制器结果,并验证视口外锚点和禁用控制器的拒绝状态不会停掉 VM。
|
||||
fn scene3d_controllers_cross_http_and_can_be_replaced_by_endor_code() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState {
|
||||
@@ -761,6 +798,8 @@ fn scene3d_controllers_cross_http_and_can_be_replaced_by_endor_code() {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 在旋转的 Panel3D 上嵌入二维 CanvasViewport,经射线/UV 映射解释相机事件。
|
||||
/// 缺失指针必须拒绝;带指针的平移/缩放只改变面板内相机,外层三维相机保持原值。
|
||||
fn canvas_in_world_ui_uses_ray_uv_coordinates_for_real_http_camera_events() {
|
||||
let server = Arc::new(Server::http("127.0.0.1:0").unwrap());
|
||||
let namespace = Arc::new(RwLock::new(NamespaceState {
|
||||
@@ -833,6 +872,7 @@ fn canvas_in_world_ui_uses_ray_uv_coordinates_for_real_http_camera_events() {
|
||||
.unwrap()
|
||||
};
|
||||
let pan = value("canvas.camera.x");
|
||||
// 面板倾斜后的投影位移不等于 UI 内部位移,不能把屏幕 delta 直接写入局部相机。
|
||||
assert!(pan > 10.);
|
||||
assert_eq!(value("view.camera.x"), 0.);
|
||||
let response = client.request(
|
||||
|
||||
@@ -6,6 +6,7 @@
|
||||
use super::*;
|
||||
|
||||
type HttpResponse = Response<std::io::Cursor<Vec<u8>>>;
|
||||
// 外层 thread::Result 区分 Rust panic,内层 Result 区分可诊断编译/运行错误;正常结果另带待发布窗口命令。
|
||||
type InputOutcome =
|
||||
std::thread::Result<Result<(endor_host::ReplResult, Vec<crate::window::Command>)>>;
|
||||
|
||||
@@ -19,6 +20,7 @@ type CandidateOutcome = std::thread::Result<
|
||||
|
||||
/// 已执行业务部分但仍在等待展示刷新的输入元数据,避免恢复时重放回调。
|
||||
pub(super) struct PendingInput {
|
||||
// 输入开始时所属 submission,与 id(VM 会话)分开;新 PUT 接受时可保留正在执行的原 VM 至输入收敛。
|
||||
epoch: u64,
|
||||
id: u64,
|
||||
event: bool,
|
||||
@@ -27,6 +29,7 @@ pub(super) struct PendingInput {
|
||||
|
||||
/// 挂起 HTTP 请求的阶段:等旧刷新、继续输入或继续隔离候选。
|
||||
pub(super) enum PendingRequest {
|
||||
// 仅等待旧只读刷新结束,业务输入尚未执行;恢复时可重新走入口,而 Input 阶段不能重放业务副作用。
|
||||
BeforeInput,
|
||||
Input(Box<PendingInput>),
|
||||
Candidate(Box<endor_host::ReplSession>),
|
||||
@@ -56,6 +59,7 @@ fn current_viewports(
|
||||
})
|
||||
.map(|(id, size)| (*id, *size))
|
||||
.collect();
|
||||
// 主窗口逻辑视口优先覆盖 map 同名值,主壳可以跨会话沿用;副窗口必须仍属于当前发布世代。
|
||||
if let Some(viewport) = current.viewport {
|
||||
viewports.insert(crate::window::MAIN_WINDOW, viewport);
|
||||
}
|
||||
@@ -77,6 +81,7 @@ impl Worker {
|
||||
error: None,
|
||||
};
|
||||
};
|
||||
// 正常域允许有界关闭回调,故障域只做宿主清理;catch_unwind 防止清理 panic 跳过原生退出通知。
|
||||
let callbacks = !runtime.is_faulted();
|
||||
let result = catch_unwind(AssertUnwindSafe(|| runtime.shutdown()));
|
||||
match result {
|
||||
@@ -108,6 +113,7 @@ impl Worker {
|
||||
namespace: &Arc<RwLock<NamespaceState>>,
|
||||
notify: &Notify,
|
||||
) -> Response<std::io::Cursor<Vec<u8>>> {
|
||||
// 故障/失活资源的专用关闭只处理副窗口,主壳由 OS 关闭控制走全应用退出流程。
|
||||
if input.window == crate::window::MAIN_WINDOW {
|
||||
return error_response(
|
||||
StatusCode(409),
|
||||
@@ -126,6 +132,7 @@ impl Worker {
|
||||
.1
|
||||
.retire_window(input.window)
|
||||
}));
|
||||
// 退役失败不能继续借用半清理 VM,放弃整个活域并在下方清其他帧的会话与命令资格。
|
||||
if !matches!(result, Ok(Ok(()))) {
|
||||
// Never keep a half-cleaned VM live or borrow another generation.
|
||||
self.repl = None;
|
||||
@@ -141,6 +148,7 @@ impl Worker {
|
||||
let Some(view) = current.document.windows.get(&input.window) else {
|
||||
return error_response(StatusCode(409), "window is no longer active");
|
||||
};
|
||||
// 即便副窗口数值 ID 相同,也不能让旧会话的关闭请求删除新会话投影。
|
||||
if view.frame.session != input.session {
|
||||
return error_response(
|
||||
StatusCode(409),
|
||||
@@ -200,6 +208,7 @@ impl Worker {
|
||||
let Some((owner, runtime)) = &mut self.repl else {
|
||||
return;
|
||||
};
|
||||
// submission 变化先尝试保留仍权威的活域所有者,不立即拿旧 epoch 继续发布后台结果。
|
||||
if *owner != epoch {
|
||||
if let Ok(current) = namespace.read() {
|
||||
self.preserve_live_owner(¤t);
|
||||
@@ -218,11 +227,13 @@ impl Worker {
|
||||
}
|
||||
// An accepted foreground input waits only for the existing
|
||||
// refresh; do not keep placing new callbacks ahead of it.
|
||||
// 已有前台请求只等当前刷新,不不断把新任务回调插到它前面,避免忙后台工作饿死用户输入。
|
||||
let completed = if before_input {
|
||||
None
|
||||
} else {
|
||||
runtime.poll_tasks_incremental(&viewports)?
|
||||
};
|
||||
// 任务后续刷新未收敛时可以发布较早已完整的 resize 文档,但暂扣任务产生的命令,防止半完成副作用外泄。
|
||||
if runtime.has_pending_refresh() {
|
||||
// A complete earlier resize may publish; task effects and their
|
||||
// native commands wait until the task's refresh has settled.
|
||||
@@ -235,6 +246,7 @@ impl Worker {
|
||||
Ok(current) => current,
|
||||
Err(_) => return,
|
||||
};
|
||||
// 耗时 VM 工作期间 HTTP 线程可能接受 PUT/DELETE,发布写锁内再核对 submission 与 session 双身份。
|
||||
if current.submission != epoch || current.runtime_session != id {
|
||||
return;
|
||||
}
|
||||
@@ -243,6 +255,7 @@ impl Worker {
|
||||
if let Some(document) = document {
|
||||
(document, Some(commands))
|
||||
} else {
|
||||
// 无新文档也可能有标题/焦点等原生命令;只在实际有投影变化时唤醒 GUI,避免空闲无效重绘。
|
||||
let projected = !commands.is_empty();
|
||||
current.publish_window_commands(id, commands);
|
||||
drop(current);
|
||||
@@ -259,6 +272,7 @@ impl Worker {
|
||||
.chars()
|
||||
.take(1024)
|
||||
.collect(),
|
||||
// 内部 panic 与普通背景错误不同,必须丢弃 VM 并撤销所有原生命令,不能继续运行损坏的域。
|
||||
_ => {
|
||||
self.repl = None;
|
||||
current.runtime_session = 0;
|
||||
@@ -289,6 +303,7 @@ impl Worker {
|
||||
namespace: &Arc<RwLock<NamespaceState>>,
|
||||
notify: &Notify,
|
||||
) -> RequestProgress {
|
||||
// 完整 PUT 独立候选,表达式隔离求值;只有 REPL/事件会进入当前持久域并等待已有刷新。
|
||||
if job.kind == RequestKind::Code {
|
||||
return self.begin_program_request(job, namespace, notify);
|
||||
}
|
||||
@@ -311,6 +326,7 @@ impl Worker {
|
||||
if epoch != job.submission {
|
||||
return RequestProgress::Complete(superseded(job.submission));
|
||||
}
|
||||
// 重置丢弃内存会话但保留显示文档,清帧 session/focus 使旧画面不再接受旧对象事件。
|
||||
if job.kind == RequestKind::ResetRepl {
|
||||
self.repl = None;
|
||||
if let Ok(mut current) = namespace.write() {
|
||||
@@ -336,6 +352,7 @@ impl Worker {
|
||||
{
|
||||
return RequestProgress::Pending(PendingRequest::BeforeInput);
|
||||
}
|
||||
// 事件先做 JSON 结构、kind 白名单和 Input 字段校验,再用权威发布帧核对具体资源能力。
|
||||
let event = if job.kind == RequestKind::Event {
|
||||
let mut input: crate::events::Input = if let Some(input) = &job.native {
|
||||
input.clone()
|
||||
@@ -413,6 +430,7 @@ impl Worker {
|
||||
};
|
||||
&document.frame
|
||||
};
|
||||
// 窗口关闭允许处理已失活/故障副窗口,不像点击一样要求可运行 VM;由专用宿主退役路径处理。
|
||||
if input.kind == "window-close"
|
||||
&& frame.window == input.window
|
||||
&& frame.session == input.session
|
||||
@@ -433,6 +451,7 @@ impl Worker {
|
||||
);
|
||||
}
|
||||
}
|
||||
// 标签拖放同时验证目标窗口的会话、版本、无故障及插入位置,源窗口校验不能替代目标校验。
|
||||
if let Some(target) = &input.tab_drop {
|
||||
let target_frame = if target.window == crate::window::MAIN_WINDOW {
|
||||
Some(¤t.document.frame)
|
||||
@@ -460,6 +479,7 @@ impl Worker {
|
||||
));
|
||||
}
|
||||
}
|
||||
// 统一事件归属门:窗口/session/版本及操作对应资源必须都合法;window-close 特别允许旧布局版本。
|
||||
if frame.window != input.window
|
||||
|| frame.session != input.session
|
||||
|| (input.kind != "window-close" && frame.layout_version != input.layout_version)
|
||||
@@ -473,6 +493,7 @@ impl Worker {
|
||||
input.kind.as_str(),
|
||||
"tab-activate" | "tab-close" | "tab-detach" | "tab-drop"
|
||||
) {
|
||||
// 标签操作的 mount 字段承载 Tab ID,而普通输入承载 Mount ID;两套身份不能混着查询。
|
||||
!frame.tabs.iter().any(|tab| tab.id == input.mount)
|
||||
} else {
|
||||
!frame.mounts.iter().any(|mount| {
|
||||
@@ -480,6 +501,7 @@ impl Worker {
|
||||
&& if input.kind.starts_with("viewport-") {
|
||||
mount.canvas_viewport
|
||||
} else if input.kind.starts_with("scene-") {
|
||||
// 3D 手势还要求显式控制器能力,scroll 要有滚动投影,点击/焦点则要求 interactive。
|
||||
mount.scene3d_viewport && mount.camera_controls
|
||||
} else if input.kind == "scroll" {
|
||||
mount.scroll.is_some()
|
||||
@@ -499,6 +521,7 @@ impl Worker {
|
||||
"event targets an obsolete or inactive frame",
|
||||
));
|
||||
}
|
||||
// 兼容页面仅 Canvas 可缩放,Window 模式不接受 pan;结构合法不等于当前页面模式支持操作。
|
||||
if input.kind == "page-zoom" && frame.surface.mode != crate::page::Mode::Canvas
|
||||
|| input.kind == "page-pan" && frame.surface.mode == crate::page::Mode::Window
|
||||
{
|
||||
@@ -507,6 +530,7 @@ impl Worker {
|
||||
"camera input is unavailable in this Page mode",
|
||||
));
|
||||
}
|
||||
// 缩放锚点须经过面板反投影与内容 clip 检查,不能落在视口边框或被遮挡面板上仍缩放。
|
||||
if matches!(input.kind.as_str(), "viewport-zoom" | "scene-zoom")
|
||||
&& !frame.mounts.iter().any(|mount| {
|
||||
mount.id == input.mount
|
||||
@@ -529,6 +553,7 @@ impl Worker {
|
||||
"zoom anchor is outside content viewport",
|
||||
));
|
||||
}
|
||||
// 世界 UI 的非线性位移变换需要位置锚点;普通二维视口的线性位移可以省略 point。
|
||||
if (input.kind.starts_with("viewport-") || input.kind.starts_with("scene-"))
|
||||
&& input.point.is_none()
|
||||
&& frame
|
||||
@@ -550,6 +575,7 @@ impl Worker {
|
||||
.as_ref()
|
||||
.is_none_or(|(current, _)| *current != epoch)
|
||||
{
|
||||
// 没有当前 epoch 会话时惰性建立空 REPL,每次分配新会话 ID 并检查溢出,禁止复用旧输入身份。
|
||||
self.next_session = match self.next_session.checked_add(1) {
|
||||
Some(id) => id,
|
||||
None => {
|
||||
@@ -594,6 +620,7 @@ impl Worker {
|
||||
} else {
|
||||
session.execute_incremental(&job.source, &job.namespace, &viewports)?
|
||||
};
|
||||
// 业务执行可能已改 VM,但展示未完成时暂不取窗口命令;PendingInput 保存结果并只恢复展示阶段。
|
||||
let commands = if session.has_pending_refresh() {
|
||||
Vec::new()
|
||||
} else {
|
||||
@@ -611,6 +638,7 @@ impl Worker {
|
||||
result,
|
||||
})));
|
||||
}
|
||||
// 启动失败且残留挂起刷新时直接丢弃域,不能保留一个无法安全推进的 HTTP 请求。
|
||||
// A failed start must never leave a request waiting on a broken VM.
|
||||
self.repl = None;
|
||||
}
|
||||
@@ -652,6 +680,7 @@ impl Worker {
|
||||
notify: &Notify,
|
||||
) -> RequestProgress {
|
||||
let viewports = match namespace.read() {
|
||||
// 正在执行输入只要仍属当前提交或仍拥有权威 VM 就可收敛;两项皆失效才彻底废弃。
|
||||
Ok(current)
|
||||
if current.submission == input.epoch || current.runtime_session == input.id =>
|
||||
{
|
||||
@@ -679,6 +708,7 @@ impl Worker {
|
||||
return RequestProgress::Complete(superseded(job.submission));
|
||||
}
|
||||
let resumed = catch_unwind(AssertUnwindSafe(|| -> Result<_> {
|
||||
// 这里只恢复 pending 展示/尺寸工作,不再调用 execute/dispatch,所以前一个量子的源副作用不会重放。
|
||||
let document = session.resize_windows_incremental(&viewports, false)?;
|
||||
if session.has_pending_refresh() {
|
||||
return Ok(None);
|
||||
@@ -723,6 +753,7 @@ impl Worker {
|
||||
let Ok(mut current) = namespace.write() else {
|
||||
return error_response(StatusCode(500), "namespace lock is poisoned");
|
||||
};
|
||||
// 接受新 PUT 会使排队旧输入失效,但已执行的活域输入需先收敛,才能在候选失败时留下内部一致的旧程序。
|
||||
let epoch = if current.submission != epoch {
|
||||
if current.runtime_session != id {
|
||||
drop(current);
|
||||
@@ -744,6 +775,7 @@ impl Worker {
|
||||
match result {
|
||||
Ok(Ok((result, commands))) => {
|
||||
let projected = !commands.is_empty();
|
||||
// rendered 只表示此次交付带新文档,成功执行但页面未变仍可返回 value/session;不因此虚增 revision。
|
||||
let rendered = result.document.is_some();
|
||||
if let Some(document) = result.document {
|
||||
match current.commit(epoch, document) {
|
||||
@@ -769,6 +801,7 @@ impl Worker {
|
||||
// Preserve the first failure of this VM; subsequent
|
||||
// rejected Console input must not hide the callback cause.
|
||||
// A preserved picture from another generation is unrelated.
|
||||
// 同 VM 保留最初故障原因,后续“域已停止”错误不能覆盖真正回调故障;其他世代旧图不沿用故障。
|
||||
let fault = (document.frame.session == id)
|
||||
.then(|| document.frame.fault.clone())
|
||||
.flatten()
|
||||
@@ -790,6 +823,7 @@ impl Worker {
|
||||
for view in document.windows.values_mut() {
|
||||
view.frame.fault = document.frame.fault.clone();
|
||||
}
|
||||
// 输入 panic 保留最近画面但撤销运行时/命令并发布故障条,再将 self.repl 丢弃。
|
||||
current.runtime_session = 0;
|
||||
current.window_commands.clear();
|
||||
let _ = current.commit(epoch, document);
|
||||
@@ -847,6 +881,7 @@ impl Worker {
|
||||
}
|
||||
};
|
||||
let id = self.next_session;
|
||||
// 候选装载运行在独立 ReplSession,未成功前不修改 self.repl,旧程序仍是权威展示来源。
|
||||
let started = catch_unwind(AssertUnwindSafe(|| {
|
||||
endor_host::ReplSession::load_incremental(
|
||||
&job.source,
|
||||
@@ -857,6 +892,7 @@ impl Worker {
|
||||
)
|
||||
}));
|
||||
let result = match started {
|
||||
// 候选业务装载成功但布局未完成,整个候选移进 PendingRequest;不能把 None 当成空文档提交。
|
||||
Ok(Ok((runtime, None))) => {
|
||||
return RequestProgress::Pending(PendingRequest::Candidate(Box::new(runtime)));
|
||||
}
|
||||
@@ -882,6 +918,7 @@ impl Worker {
|
||||
Ok(current) if current.submission == job.submission => {
|
||||
// Secondary native resources still belong to the old VM. Only
|
||||
// the primary shell's current viewport applies to a candidate.
|
||||
// 候选不沿用旧副窗口的视口;副窗口资源归旧 VM,只有主壳当前尺寸可作为新候选分配条件。
|
||||
current
|
||||
.viewport
|
||||
.map(|size| (crate::window::MAIN_WINDOW, size))
|
||||
@@ -905,6 +942,7 @@ impl Worker {
|
||||
if runtime.has_pending_refresh() {
|
||||
return Ok(None);
|
||||
}
|
||||
// 所有刷新结束仍没有 Page 文档时明确失败,不用旧显示值冒充候选自己的输出。
|
||||
let document =
|
||||
document.ok_or_else(|| anyhow::anyhow!("program did not publish a Page"))?;
|
||||
Ok(Some((document, runtime.take_window_commands()?)))
|
||||
@@ -937,6 +975,7 @@ impl Worker {
|
||||
match result {
|
||||
Ok(Ok((runtime, document, commands))) => match current.commit(job.submission, document)
|
||||
{
|
||||
// 写锁内先原子提交文档,再切换命令世代与活域;解锁后唤醒 GUI,新 VM 至此才取代旧 VM。
|
||||
Ok(Some(revision)) => {
|
||||
current.publish_window_commands(id, commands);
|
||||
self.repl = Some((job.submission, runtime));
|
||||
@@ -953,6 +992,7 @@ impl Worker {
|
||||
failed => {
|
||||
// The candidate never mutated the displayed program's heap.
|
||||
// Restore that program's event epoch when a replacement fails.
|
||||
// 候选失败只更新旧活域 epoch,保留其堆与页面;不存在旧域时也不会借用其他会话伪造成功。
|
||||
self.preserve_live_owner(¤t);
|
||||
drop(current);
|
||||
match failed {
|
||||
@@ -973,6 +1013,7 @@ fn build(
|
||||
namespace: &Arc<RwLock<NamespaceState>>,
|
||||
notify: &Notify,
|
||||
) -> Response<std::io::Cursor<Vec<u8>>> {
|
||||
// 隔离表达式不读写持久 REPL 堆,也不发布文档,响应明确 persistent=false。
|
||||
if job.kind == RequestKind::Expression {
|
||||
return match catch_unwind(AssertUnwindSafe(|| endor_host::evaluate(&job.source))) {
|
||||
Ok(Ok(value)) => json(
|
||||
@@ -990,6 +1031,7 @@ fn build(
|
||||
}
|
||||
// Only an independent native snapshot crosses into the published state.
|
||||
// A fresh VM is discarded on success, error and unwind alike.
|
||||
// 一次性构建同样用独立 VM,计算锁外执行,返回后再次核对 submission 才能发布原生快照。
|
||||
let result = catch_unwind(AssertUnwindSafe(|| {
|
||||
endor_host::compile(&job.source, &job.namespace, job.submission)
|
||||
}));
|
||||
|
||||
+74
-10
@@ -33,6 +33,7 @@ pub fn compile(source: &str, namespace: &str, submission: u64) -> Result<RenderD
|
||||
}
|
||||
let source = EndorReader::from_text(format!("{namespace} [submission {submission}]"), source);
|
||||
let plan = endor_script::parse(&source)?;
|
||||
// 各 Script 根共享 AST 计数预算,不能通过拆成很多交互片段绕过整份源码节点上限。
|
||||
let mut budget = AstBudget::default();
|
||||
for ast in plan.roots() {
|
||||
budget.visit_ast_root(ast)?;
|
||||
@@ -46,6 +47,7 @@ pub fn compile(source: &str, namespace: &str, submission: u64) -> Result<RenderD
|
||||
candidate.roots.push(globals);
|
||||
let bridge = ui_bridge::install(&mut candidate.vm, &mut candidate.roots)?;
|
||||
bridge.install_globals(&mut candidate.vm, globals)?;
|
||||
// Script 多段分别执行,指令总额按片段数均分;Module 作为整体获得完整预算,避免每段都重获一百万。
|
||||
let limits = match &plan {
|
||||
SourcePlan::Module(_) => LIMITS,
|
||||
SourcePlan::Script(_) => ExecutionLimits {
|
||||
@@ -67,6 +69,7 @@ pub fn compile(source: &str, namespace: &str, submission: u64) -> Result<RenderD
|
||||
SourcePlan::Script(_) => bridge
|
||||
.rendered(&candidate.vm)?
|
||||
.ok_or_else(|| anyhow::anyhow!("script must call ui.page().render(root)"))?,
|
||||
// 模块先执行定义再调用 main;若 main 未显式 render,可将其返回值转换成展示根。
|
||||
SourcePlan::Module(_) => {
|
||||
let entry = candidate
|
||||
.vm
|
||||
@@ -88,6 +91,7 @@ pub fn compile(source: &str, namespace: &str, submission: u64) -> Result<RenderD
|
||||
Some(root) => Ok(root),
|
||||
None => ui_bridge::snapshot(&candidate.vm, &value),
|
||||
});
|
||||
// 提取快照结果先暂存,成功或失败都释放 main 返回值的拥有根,再传播快照错误。
|
||||
candidate.vm.release_value(value)?;
|
||||
snapshot?
|
||||
}
|
||||
@@ -102,6 +106,7 @@ pub fn compile(source: &str, namespace: &str, submission: u64) -> Result<RenderD
|
||||
document.validate()?;
|
||||
Ok(document)
|
||||
})();
|
||||
// 独立构建在成功与错误路径都显式释放宿主根/回收堆;返回成功文档也要求 cleanup 成功。
|
||||
let cleanup = candidate.close();
|
||||
match (result, cleanup) {
|
||||
(Ok(document), Ok(())) => Ok(document),
|
||||
@@ -117,6 +122,7 @@ pub fn evaluate(source: &str) -> Result<String> {
|
||||
bail!("expression exceeds the 1 MiB limit");
|
||||
}
|
||||
let source = EndorReader::from_text("console expression", source);
|
||||
// 隔离 evaluate 只接受一个表达式,默认编译选项不安装 ui 桥接,也不读已发布程序的 globals。
|
||||
let ast = frontend::parse_source_ast(&source, frontend::ParseMode::Expression)?;
|
||||
AstBudget::default().visit_ast_root(&ast)?;
|
||||
let compiled = compiler::compile_ast(&ast, &source, &compiler::CompileOptions::default())
|
||||
@@ -132,6 +138,7 @@ pub fn evaluate(source: &str) -> Result<String> {
|
||||
.vm
|
||||
.execute_with_limits(code, globals, LIMITS)
|
||||
.map_err(|error| runtime_error(&candidate.vm, error))?;
|
||||
// 只把标量或对象 repr 字符串交回 API,真实 Value 随一次性 VM 清理,不跨线程交付托管引用。
|
||||
let rendered = match &value {
|
||||
Value::Nil => "nil".to_owned(),
|
||||
Value::Bool(v) => v.to_string(),
|
||||
@@ -171,6 +178,7 @@ fn compile_plan_with_globals(
|
||||
// Match Aster module behavior for function forward references. Bindings are
|
||||
// added in source order; every executable statement still uses Aster's own
|
||||
// single-input Interactive compiler and the candidate's shared globals.
|
||||
// 先收集全部函数/类声明名以支持前向引用;普通绑定仍按源码执行次序逐段加入已知全局名。
|
||||
for root in plan.roots() {
|
||||
if let AstRoot::Interactive(input) = root {
|
||||
for statement in &input.statements {
|
||||
@@ -219,6 +227,7 @@ fn compile_plan_with_globals(
|
||||
compiler::compile_ast(root, source, &options)
|
||||
.map_err(|error| source.annotate(error))?,
|
||||
);
|
||||
// 每段编译成功才把绑定/赋值名字加入下一段编译上下文,语法与代码生成都继续委托 Aster。
|
||||
if let AstRoot::Interactive(input) = root {
|
||||
for statement in &input.statements {
|
||||
assigned(statement, &mut globals);
|
||||
@@ -240,6 +249,7 @@ struct PendingPaint {
|
||||
/// 跨 worker 轮次的全窗口刷新状态,保存已完成草稿和当前布局/绘制,直到稳定再发布。
|
||||
struct RefreshWork {
|
||||
// 已完成窗口的草稿先留在本轮;所有窗口收敛后才合成一次完整发布。
|
||||
// RefreshWork 先克隆最近完整文档作为草稿基线,各窗口更新暂存于此;全轮稳定前不写共享 NamespaceState。
|
||||
documents: std::collections::BTreeMap<u64, RenderDocument>,
|
||||
windows: std::collections::VecDeque<u64>,
|
||||
current: Option<u64>,
|
||||
@@ -271,6 +281,7 @@ pub struct ReplSession {
|
||||
ast_nodes: usize,
|
||||
source: String,
|
||||
nodes: Vec<CodeNode>,
|
||||
// 回调/渲染失败后置位,拒绝继续普通业务输入;保留画面不表示堆还能安全执行。
|
||||
faulted: bool,
|
||||
program_root: Option<CodeNode>,
|
||||
documents: std::collections::BTreeMap<u64, RenderDocument>,
|
||||
@@ -330,6 +341,7 @@ impl ReplSession {
|
||||
.into_iter()
|
||||
.collect();
|
||||
let document = runtime.refresh_after_mutation(Some(&viewports))?;
|
||||
// 初始刷新若已完成必须确实有 Page 文档才可接受候选;仍挂起则把整个运行时交 worker 下一量子继续。
|
||||
if !runtime.has_pending_refresh() {
|
||||
anyhow::ensure!(document.is_some(), "program did not publish a Page");
|
||||
runtime
|
||||
@@ -361,6 +373,7 @@ impl ReplSession {
|
||||
runtime
|
||||
.bridge
|
||||
.set_viewport(&mut runtime.candidate.vm, viewport)?;
|
||||
// 完整程序代码在候选自己的真实 globals 中执行,之后保留该堆用于事件与 Console,不通过重放历史恢复状态。
|
||||
let globals = runtime.candidate.globals.expect("program globals");
|
||||
let limits = if matches!(plan, SourcePlan::Script(_)) {
|
||||
ExecutionLimits {
|
||||
@@ -394,6 +407,7 @@ impl ReplSession {
|
||||
.vm
|
||||
.call_with_limits(main, &[], LIMITS)
|
||||
.map_err(|error| runtime_error(&runtime.candidate.vm, error))?;
|
||||
// main 已主动打开 Page 时尊重其选择;否则把返回值经展示协议打开,不能重复创建第二个默认页面。
|
||||
let opened = if runtime.bridge.has_page()? {
|
||||
Ok(())
|
||||
} else {
|
||||
@@ -407,6 +421,7 @@ impl ReplSession {
|
||||
}
|
||||
runtime.source = source.into();
|
||||
runtime.ast_nodes = budget.nodes;
|
||||
// 保存完整程序的 Sources 投影,后续 Console 追加时可移入交互记录树;不把 AST 投影当可执行堆对象。
|
||||
runtime.program_root = Some(architecture(&unit, &plan, namespace, submission));
|
||||
Ok(runtime)
|
||||
}
|
||||
@@ -420,7 +435,7 @@ impl ReplSession {
|
||||
Ok(runtime)
|
||||
}
|
||||
|
||||
/// 构造本类型并初始化其状态;资源建立和默认字段以函数体为准。
|
||||
/// 建立真实持久 VM、全局字典与 UI 桥接根,尚未执行用户输入或产生窗口帧。
|
||||
pub fn new(id: u64) -> Result<Self> {
|
||||
let mut candidate = Candidate::new()?;
|
||||
let globals = candidate.vm.new_dict()?;
|
||||
@@ -474,6 +489,7 @@ impl ReplSession {
|
||||
if source.len() > MAX_SOURCE_BYTES {
|
||||
bail!("input exceeds 1 MiB");
|
||||
}
|
||||
// 持久 Console 限制累计输入次数、源码文本和稍后的 AST 总节点数,用户需显式重置才能重新获得预算。
|
||||
if self.inputs >= 256 || self.source.len() + source.len() + 80 > MAX_SOURCE_BYTES {
|
||||
bail!("console session exceeds 256 inputs or 1 MiB; reset the session to continue");
|
||||
}
|
||||
@@ -490,6 +506,7 @@ impl ReplSession {
|
||||
bail!("console session exceeds 10000 AST nodes; reset the session to continue");
|
||||
}
|
||||
let globals = self.candidate.globals.expect("live console globals");
|
||||
// 从实际 globals 枚举已有名称供增量编译,支持前次输入创建的真实对象,而非靠解析历史猜名称。
|
||||
let names = self
|
||||
.candidate
|
||||
.vm
|
||||
@@ -509,6 +526,7 @@ impl ReplSession {
|
||||
self.bridge.discard_pending(&mut self.candidate.vm)?;
|
||||
self.bridge
|
||||
.reclaim(&mut self.candidate.vm, &mut self.candidate.roots)?;
|
||||
// 解析/编译全部成功后才记本轮输入与源码;之后运行失败仍可能保留此前语句副作用,不做事务回滚。
|
||||
self.inputs += 1;
|
||||
self.ast_nodes += budget.nodes;
|
||||
if let Some(root) = self.program_root.take() {
|
||||
@@ -517,6 +535,7 @@ impl ReplSession {
|
||||
if !self.source.is_empty() && !self.source.ends_with('\n') {
|
||||
self.source.push('\n');
|
||||
}
|
||||
// 交互源码前加 Console input 注释分隔,投影节点行号再整体平移到累计 transcript 中。
|
||||
let offset = line_starts(&self.source).len();
|
||||
self.source
|
||||
.push_str(&format!("// Console input {}\n", self.inputs));
|
||||
@@ -549,6 +568,7 @@ impl ReplSession {
|
||||
self.candidate.vm.release(code)?;
|
||||
let value = executed?;
|
||||
// Keep the actual last result accessible as `_`, including unnamed UI objects.
|
||||
// 绑定/赋值语句展示其新变量实际值,普通表达式展示返回值;不是仅显示该语句执行的 Unit。
|
||||
let display = if let AstRoot::Interactive(input) = ast {
|
||||
match &input.statements[0].kind {
|
||||
StmtKind::Binding(binding) => self
|
||||
@@ -566,6 +586,7 @@ impl ReplSession {
|
||||
} else {
|
||||
value.clone()
|
||||
};
|
||||
// 先算 repr 并把实际最后值写入全局 _,保留未命名 UI 对象;随后释放 execute 返回根,错误也逐项传播。
|
||||
let repr = value_repr(&self.candidate.vm, &display);
|
||||
let retained =
|
||||
self.candidate
|
||||
@@ -588,6 +609,7 @@ impl ReplSession {
|
||||
input: self.inputs,
|
||||
})
|
||||
})();
|
||||
// 失败丢弃未发布展示请求和原生命令,保留已执行业务写入,并在代码投影上明确标记非事务语义。
|
||||
if result.is_err() {
|
||||
self.take_window_commands()?;
|
||||
self.bridge.discard_pending(&mut self.candidate.vm)?;
|
||||
@@ -596,6 +618,7 @@ impl ReplSession {
|
||||
.push_str(" (error; earlier statements may remain live)");
|
||||
}
|
||||
}
|
||||
// 未完成只读续体仍持有临时结果,不在中途执行完整 reclaim;等刷新结束后再回收不可达宿主根。
|
||||
if !self.has_pending_refresh() {
|
||||
self.bridge
|
||||
.reclaim(&mut self.candidate.vm, &mut self.candidate.roots)?;
|
||||
@@ -627,6 +650,7 @@ impl ReplSession {
|
||||
&mut self,
|
||||
viewports: Option<&std::collections::BTreeMap<u64, crate::layout::Size>>,
|
||||
) -> Result<Option<RenderDocument>> {
|
||||
// 无增量视口参数的测试/同步入口排空状态机;worker 提供目标视口时只推进一次并记录重定向依据。
|
||||
let Some(viewports) = viewports else {
|
||||
return self.refresh_document();
|
||||
};
|
||||
@@ -654,6 +678,7 @@ impl ReplSession {
|
||||
|
||||
/// 推进一次刷新状态机,保存挂起的 Work;只有全窗口收敛时才生成可发布文档。
|
||||
fn poll_refresh(&mut self, record_yield: bool) -> Result<RefreshProgress> {
|
||||
// 从 self 取出工作以便可变推进,挂起时放回;首次从已发布各窗口文档克隆初始草稿。
|
||||
let mut work = self.refresh.take().unwrap_or_else(|| RefreshWork {
|
||||
documents: self.documents.clone(),
|
||||
windows: Default::default(),
|
||||
@@ -681,6 +706,7 @@ impl ReplSession {
|
||||
self.refresh = Some(work);
|
||||
Ok(RefreshProgress::Pending)
|
||||
}
|
||||
// 收敛后统一组合文档,再恢复主窗口选择;收尾失败也标故障,不把失败草稿当已发布帧。
|
||||
Ok(true) => {
|
||||
let result = self.finish_refresh(work);
|
||||
self.bridge.select_window(crate::window::MAIN_WINDOW)?;
|
||||
@@ -691,6 +717,8 @@ impl ReplSession {
|
||||
}
|
||||
Err(error) => {
|
||||
self.faulted = true;
|
||||
// 错误时必须显式取消 paint/layout 的 owning VM 续体并恢复检查点,不能仅丢弃 Rust 工作结构。
|
||||
// 进入 paint 后只恢复其原续体和配对文档,不重复布局,也不重跑输入业务语句。
|
||||
if let Some(paint) = work.paint.take() {
|
||||
self.bridge.cancel_paint_frame(
|
||||
&mut self.candidate.vm,
|
||||
@@ -711,6 +739,7 @@ impl ReplSession {
|
||||
/// 执行一个刷新步骤:刷新绑定、选择窗口、准备快照、推进布局或绘制,并决定是否需要下一轮。
|
||||
fn step_refresh(&mut self, work: &mut RefreshWork) -> Result<bool> {
|
||||
// 阶段一:新一轮先刷新绑定,再取得稳定窗口遍历顺序。
|
||||
// 每轮先使属性绑定达到固定点,再取窗口顺序;生命周期或绑定可能改变窗口/页面结构,因此需要多轮确认。
|
||||
if work.pass_start {
|
||||
self.bridge.refresh_bindings(&mut self.candidate.vm)?;
|
||||
work.windows = self.bridge.window_ids()?.into();
|
||||
@@ -725,6 +754,7 @@ impl ReplSession {
|
||||
work.current = Some(id);
|
||||
return Ok(false);
|
||||
}
|
||||
// 任何窗口本轮生成新帧,就再扫描一轮检查依赖和挂载回调是否又引起变化,直到整轮无变化。
|
||||
if work.pass_changed {
|
||||
work.pass_start = true;
|
||||
return Ok(false);
|
||||
@@ -780,6 +810,7 @@ impl ReplSession {
|
||||
};
|
||||
document.frame.session = self.id;
|
||||
document.validate()?;
|
||||
// 跨所有窗口和稳定轮次累计布局工作,空帧也计一,防止持续无几何变化请求绕过收敛预算。
|
||||
work.work += document.frame.mounts.len().max(1);
|
||||
if work.work > 200_000 {
|
||||
bail!("layout dependencies did not stabilize within the rendering work budget");
|
||||
@@ -810,6 +841,7 @@ impl ReplSession {
|
||||
crate::source_paint::Progress::Complete(draft) => {
|
||||
document.frame = draft.frame;
|
||||
document.validate()?;
|
||||
// 只有整个绘制 Complete 且验证通过才替换当前窗口草稿;Pending 保留配对文档和 Work,不对 GUI 可见。
|
||||
work.documents.insert(id, document);
|
||||
work.pass_changed = true;
|
||||
work.changed = true;
|
||||
@@ -820,6 +852,7 @@ impl ReplSession {
|
||||
|
||||
/// 收敛后组合所有窗口文档,保留本轮完整结果;没有变化时不额外制造发布。
|
||||
fn finish_refresh(&mut self, mut work: RefreshWork) -> Result<Option<RenderDocument>> {
|
||||
// 收敛后完成已关闭窗口退役并删其旧文档;没有实际变化时不制造额外 revision。
|
||||
self.bridge.finish_closed(&mut self.candidate.vm)?;
|
||||
let ids = self.bridge.window_ids()?;
|
||||
work.documents.retain(|id, _| ids.contains(id));
|
||||
@@ -840,12 +873,14 @@ impl ReplSession {
|
||||
..Default::default()
|
||||
});
|
||||
main.source = self.source.clone();
|
||||
// 优先采用源码与当前 transcript 相同的窗口代码投影,避免主窗口未重绘时 Sources 仍展示旧输入树。
|
||||
main.root = work
|
||||
.documents
|
||||
.values()
|
||||
.find(|document| document.source == self.source)
|
||||
.and_then(|document| document.root.clone())
|
||||
.or(main.root);
|
||||
// 副窗口统一挂到主文档 windows 一层,子文档自身不再嵌套副窗口,最终 validate 检查完整跨线程值。
|
||||
main.windows = work
|
||||
.documents
|
||||
.iter()
|
||||
@@ -874,6 +909,7 @@ impl ReplSession {
|
||||
let Some(mut work) = self.refresh.take() else {
|
||||
return Ok(());
|
||||
};
|
||||
// 记录实际取消了哪类续体用于诊断;已完成窗口草稿和已发生业务副作用不会因此回滚。
|
||||
let cancelled = work.pending.is_some();
|
||||
let cancelled_paint = work.paint.is_some();
|
||||
if let Some(paint) = work.paint.take()
|
||||
@@ -899,6 +935,7 @@ impl ReplSession {
|
||||
// Keep completed window drafts and callback effects. Only the pending
|
||||
// window's speculative Mount state was restored. A new external target
|
||||
// begins a fresh convergence budget, not a continuation of a bad cycle.
|
||||
// 重新从全窗口稳定轮开始,清当前选择/旧根并重置此次外部尺寸目标的收敛工作预算;草稿 documents 保留。
|
||||
work.windows.clear();
|
||||
work.current = None;
|
||||
work.root = None;
|
||||
@@ -919,6 +956,7 @@ impl ReplSession {
|
||||
if self.faulted {
|
||||
bail!("runtime stopped after a callback or rendering failure");
|
||||
}
|
||||
// 仅目标视口集合确实不同才取消重定向;同一目标的下一 worker 轮继续原续体,不重复从头布局。
|
||||
let retarget = self
|
||||
.refresh
|
||||
.as_ref()
|
||||
@@ -927,6 +965,7 @@ impl ReplSession {
|
||||
if retarget {
|
||||
self.retarget_refresh(viewports)?;
|
||||
}
|
||||
// 同目标 drain=true 同步排空旧刷新并保存完整结果;drain=false 只推进一量子,不能先执行新的尺寸变更。
|
||||
let previous = if self.has_pending_refresh() && !retarget {
|
||||
if drain {
|
||||
let result = self.refresh_document();
|
||||
@@ -939,6 +978,7 @@ impl ReplSession {
|
||||
};
|
||||
let ids = self.bridge.window_ids()?;
|
||||
let mut changed = false;
|
||||
// 仅更新桥接仍注册的窗口;旧 GUI 尺寸记录不应在新域里隐式创建窗口资源。
|
||||
for (id, viewport) in viewports {
|
||||
if ids.contains(id) {
|
||||
self.bridge.select_window(*id)?;
|
||||
@@ -948,6 +988,7 @@ impl ReplSession {
|
||||
}
|
||||
}
|
||||
self.bridge.select_window(crate::window::MAIN_WINDOW)?;
|
||||
// 尺寸没变且无挂起工作则直接返回先前已完成文档,避免制造无意义新帧。
|
||||
if !changed && !self.has_pending_refresh() {
|
||||
return Ok(previous);
|
||||
}
|
||||
@@ -1011,10 +1052,12 @@ impl ReplSession {
|
||||
&mut self,
|
||||
viewports: Option<&std::collections::BTreeMap<u64, crate::layout::Size>>,
|
||||
) -> Result<Option<RenderDocument>> {
|
||||
// 异步回调不能插入只读布局/绘制续体中,即使后台邮箱已有结果也等刷新空闲边界。
|
||||
if self.has_pending_refresh() {
|
||||
return Ok(None);
|
||||
}
|
||||
if self.faulted {
|
||||
// 故障域不执行任何新用户任务,仅取消已有任务并在确实移除工作后回收引用。
|
||||
if self.bridge.cancel_tasks(&mut self.candidate.vm)? > 0 {
|
||||
self.bridge
|
||||
.reclaim(&mut self.candidate.vm, &mut self.candidate.roots)?;
|
||||
@@ -1023,6 +1066,7 @@ impl ReplSession {
|
||||
}
|
||||
let mut completed = false;
|
||||
let result = (|| {
|
||||
// worker 增量轮至多启动一个任务推进,给前台输入和窗口刷新公平机会;同步路径单轮允许64项。
|
||||
let limit = if viewports.is_some() { 1 } else { 64 };
|
||||
if self.bridge.poll_tasks(&mut self.candidate.vm, limit)? == 0 {
|
||||
return Ok(None);
|
||||
@@ -1036,6 +1080,7 @@ impl ReplSession {
|
||||
self.take_window_commands()?;
|
||||
self.bridge.discard_pending(&mut self.candidate.vm)?;
|
||||
}
|
||||
// 任务推进或失败后才需回收,并且不能在仍有只读续体时清理其临时根。
|
||||
if (completed || result.is_err()) && !self.has_pending_refresh() {
|
||||
self.bridge
|
||||
.reclaim(&mut self.candidate.vm, &mut self.candidate.roots)?;
|
||||
@@ -1092,6 +1137,7 @@ impl ReplSession {
|
||||
|
||||
/// 有界关闭任务、挂载和窗口,释放运行时根,并报告清理结果。
|
||||
pub fn shutdown(&mut self) -> Result<(usize, usize, usize)> {
|
||||
// 先取消视觉续体恢复挂载检查点,再判断原域是否允许正常关闭回调,随后标故障禁止后续普通执行。
|
||||
self.cancel_pending_refresh()?;
|
||||
let callbacks = !self.faulted;
|
||||
self.faulted = true;
|
||||
@@ -1104,6 +1150,7 @@ impl ReplSession {
|
||||
// This path is exclusively host cleanup after the domain has stopped.
|
||||
// No language functions, layout, paint or lifecycle hooks may run here.
|
||||
self.faulted = true;
|
||||
// 专用退役只清宿主资源,不调源生命周期;删除已缓存文档和窗口命令,避免后续重发该副窗口。
|
||||
self.bridge.retire_window(&mut self.candidate.vm, id)?;
|
||||
self.documents.remove(&id);
|
||||
let _ = self.take_window_commands()?;
|
||||
@@ -1151,12 +1198,14 @@ impl ReplSession {
|
||||
if self.faulted {
|
||||
bail!("runtime stopped after a callback or rendering failure");
|
||||
}
|
||||
// 即使绕过 HTTP 入口直接调用,也再校验会话身份;共享窗口数值 ID 不提供跨 VM 权限。
|
||||
if input.session != self.id {
|
||||
bail!("event belongs to another runtime session");
|
||||
}
|
||||
if !self.accepts_tab_drop(input) {
|
||||
bail!("drop targets an obsolete presentation");
|
||||
}
|
||||
// 将 ui.window/viewport 等隐式上下文切到事件所属窗口,分发后统一恢复主窗口。
|
||||
self.bridge.select_window(input.window)?;
|
||||
let result = (|| {
|
||||
self.bridge.dispatch(&mut self.candidate.vm, input)?;
|
||||
@@ -1176,6 +1225,7 @@ impl ReplSession {
|
||||
self.bridge.select_window(crate::window::MAIN_WINDOW)?;
|
||||
if result.is_err() {
|
||||
self.take_window_commands()?;
|
||||
// 回调失败属于共享 VM 故障,不只关闭单个按钮;丢弃未发布命令与 pending 请求,但不重放已执行写入。
|
||||
self.faulted = true;
|
||||
self.bridge.discard_pending(&mut self.candidate.vm)?;
|
||||
}
|
||||
@@ -1188,8 +1238,9 @@ impl ReplSession {
|
||||
}
|
||||
|
||||
impl Drop for ReplSession {
|
||||
/// 在 Rust 所有者离开作用域时执行本类型的配套清理;不能用它代替需要报告错误的显式关闭。
|
||||
/// 析构兜底取消会话中未完成的布局/绘制续体;需要观察清理错误或运行退出钩子的路径仍须显式 shutdown。
|
||||
fn drop(&mut self) {
|
||||
// Drop 最后兜底取消未完成视觉工作,错误无法从析构返回;需要报告清理错误的路径必须显式 shutdown。
|
||||
let _ = self.cancel_pending_refresh();
|
||||
}
|
||||
}
|
||||
@@ -1232,9 +1283,11 @@ impl Candidate {
|
||||
|
||||
/// 释放候选拥有的宿主根并清理 VM;通过显式关闭保证错误也能被报告。
|
||||
fn close(&mut self) -> Result<()> {
|
||||
// 清全局字典先断业务对象可达根,再逆序释放宿主分配根;最后执行循环回收并验证对象计数归零。
|
||||
if let Some(globals) = self.globals.take() {
|
||||
self.vm.dict_clear(globals)?;
|
||||
}
|
||||
// pop 逐项移出确保再次 close 不重复释放已成功处理的根;错误仍交显式关闭调用方报告。
|
||||
while let Some(root) = self.roots.pop() {
|
||||
self.vm.release(root)?;
|
||||
}
|
||||
@@ -1247,16 +1300,16 @@ impl Candidate {
|
||||
}
|
||||
|
||||
impl Drop for Candidate {
|
||||
/// 在 Rust 所有者离开作用域时执行本类型的配套清理;不能用它代替需要报告错误的显式关闭。
|
||||
/// 析构调用 Candidate.close 释放候选根和 VM,覆盖提前返回/异常展开;析构不能向调用者报告清理错误。
|
||||
fn drop(&mut self) {
|
||||
// Explicit close reports accounting errors; dropping the fresh VM is
|
||||
// also the final cleanup boundary on every early return or unwind.
|
||||
// 显式 close 可以报告引用计数/清理错误;Drop 则保证提前返回和异常展开仍经过最终清理边界。
|
||||
let _ = self.close();
|
||||
}
|
||||
}
|
||||
|
||||
/// 把 VM 错误与当前源位置/调用栈组合成用户可读的诊断。
|
||||
pub(crate) fn runtime_error(vm: &Vm, error: VmError) -> anyhow::Error {
|
||||
// 错误发生后立即读取 VM traceback,保留函数、源文件与指令偏移;无栈信息时直接保留原 VmError。
|
||||
let locations = vm
|
||||
.last_traceback()
|
||||
.iter()
|
||||
@@ -1286,6 +1339,7 @@ impl Visitor for AstBudget {
|
||||
type Error = anyhow::Error;
|
||||
/// 更新源结构遍历的深度/数量预算,拒绝超出允许范围的语法树。
|
||||
fn enter_node(&mut self, _span: Span) -> Result<()> {
|
||||
// 每次进入节点累计总数和当前深度;leave 只归还深度,整份输入总量不会因退出子树重置。
|
||||
self.depth += 1;
|
||||
self.nodes += 1;
|
||||
if self.depth > MAX_AST_DEPTH || self.nodes > MAX_AST_NODES {
|
||||
@@ -1306,6 +1360,7 @@ fn architecture(
|
||||
namespace: &str,
|
||||
submission: u64,
|
||||
) -> CodeNode {
|
||||
// CodeNode ID 由 namespace/submission 和本次递增序号构成,只是 Sources 投影身份,不是托管对象地址。
|
||||
let mut tree = Architecture {
|
||||
line_starts: line_starts(source.text()),
|
||||
next_id: 0,
|
||||
@@ -1327,6 +1382,7 @@ fn architecture(
|
||||
}
|
||||
}
|
||||
let roots = plan.roots();
|
||||
// 整体范围取首根起点至末根终点,Script 的多个交互片段在原始文本中的 span 已恢复偏移。
|
||||
let span = Span::new(
|
||||
roots.first().map_or(0, |root| root.span().start),
|
||||
roots.last().map_or(0, |root| root.span().end),
|
||||
@@ -1342,6 +1398,7 @@ fn architecture(
|
||||
/// 建立源文本每行起点表,供字节 span 转换为行列位置。
|
||||
fn line_starts(source: &str) -> Vec<usize> {
|
||||
let bytes = source.as_bytes();
|
||||
// 按字节扫描行终止符,CRLF 仅在 LF 记一次,孤立 CR 也换行;空文本仍保留第1行起点0。
|
||||
let mut starts = vec![0];
|
||||
for (offset, byte) in bytes.iter().enumerate() {
|
||||
if *byte == b'\n' || (*byte == b'\r' && bytes.get(offset + 1) != Some(&b'\n')) {
|
||||
@@ -1359,10 +1416,11 @@ struct Architecture {
|
||||
}
|
||||
|
||||
impl Architecture {
|
||||
/// 将相应语法结构投影为带源码范围的 CodeNode,供 Sources 展示和定位。
|
||||
/// 分配本投影内节点 ID,并将半开字节 span 映射为1基起止行,组装 CodeNode。
|
||||
fn node(&mut self, name: String, kind: &str, span: Span, children: Vec<CodeNode>) -> CodeNode {
|
||||
let id = self.next_id;
|
||||
self.next_id += 1;
|
||||
// partition_point 返回不大于 offset 的行首数量,天然得到1基行号;span.end 是半开端,先减1找最后实际字符行。
|
||||
let line = |offset| self.line_starts.partition_point(|start| *start <= offset);
|
||||
CodeNode {
|
||||
id: format!("{}:ast-{id}", self.identity),
|
||||
@@ -1374,11 +1432,12 @@ impl Architecture {
|
||||
}
|
||||
}
|
||||
|
||||
/// 将相应语法结构投影为带源码范围的 CodeNode,供 Sources 展示和定位。
|
||||
/// 区分函数与类声明;类下先投影字段,再投影方法。
|
||||
fn declaration(&mut self, declaration: &Decl) -> CodeNode {
|
||||
match &declaration.kind {
|
||||
DeclKind::Function(function) => self.function(function),
|
||||
DeclKind::Class(class) => {
|
||||
// 类投影先列字段再列方法;只复制显示名称和范围,不把声明 AST 当可执行对象保存。
|
||||
let mut children: Vec<_> = class
|
||||
.fields
|
||||
.iter()
|
||||
@@ -1390,8 +1449,9 @@ impl Architecture {
|
||||
}
|
||||
}
|
||||
|
||||
/// 将相应语法结构投影为带源码范围的 CodeNode,供 Sources 展示和定位。
|
||||
/// 将函数声明及其体内语句投影为一个带源码范围的 function 节点。
|
||||
fn function(&mut self, function: &frontend::ast::Function) -> CodeNode {
|
||||
// 函数投影按函数体语句顺序递归展开,不单独生成参数节点;展示范围仍覆盖完整函数声明。
|
||||
let children = function
|
||||
.body
|
||||
.statements
|
||||
@@ -1406,7 +1466,7 @@ impl Architecture {
|
||||
)
|
||||
}
|
||||
|
||||
/// 将相应语法结构投影为带源码范围的 CodeNode,供 Sources 展示和定位。
|
||||
/// 按赋值、返回、表达式和声明种类构建 Sources 层次,保留真实子表达式关系。
|
||||
fn statement(&mut self, statement: &Stmt) -> CodeNode {
|
||||
match &statement.kind {
|
||||
StmtKind::If(branch) => {
|
||||
@@ -1422,6 +1482,7 @@ impl Architecture {
|
||||
children.extend(loop_.body.statements.iter().map(|s| self.statement(s)));
|
||||
self.node("while".into(), "while", statement.span, children)
|
||||
}
|
||||
// 成员赋值投影两个子表达式:目标对象和右值,成员名作为本节点显示名称。
|
||||
StmtKind::MemberAssignment(assignment) => {
|
||||
let object = self.expression(&assignment.object);
|
||||
let value = self.expression(&assignment.value);
|
||||
@@ -1463,13 +1524,15 @@ impl Architecture {
|
||||
}
|
||||
}
|
||||
|
||||
/// 将相应语法结构投影为带源码范围的 CodeNode,供 Sources 展示和定位。
|
||||
/// 递归投影表达式层次,用简短文本作显示名,并保留完整原始 span。
|
||||
fn expression(&mut self, expr: &Expr) -> CodeNode {
|
||||
let (name, kind, children) = match &expr.kind {
|
||||
ExprKind::Name(name) => (name.clone(), "name", vec![]),
|
||||
ExprKind::Number(value) => (value.clone(), "number", vec![]),
|
||||
// 字符串展示名最多40个 Unicode 字符,但 span 保留整段字面量,截断标签不影响源码选择范围。
|
||||
ExprKind::String(value) => (value.chars().take(40).collect(), "string", vec![]),
|
||||
ExprKind::Symbol(name) => (name.text.clone(), "symbol", vec![]),
|
||||
// 当前代码投影把 Unary 和 Await 共用 unary/negate 显示标签;这是展示简化,不表示 await 执行成取负。
|
||||
ExprKind::Unary { operand, .. } | ExprKind::Await(operand) => {
|
||||
("negate".into(), "unary", vec![self.expression(operand)])
|
||||
}
|
||||
@@ -1482,6 +1545,7 @@ impl Architecture {
|
||||
(name.text.clone(), "member", vec![self.expression(object)])
|
||||
}
|
||||
ExprKind::Call { callee, arguments } => {
|
||||
// 调用目标作为首个孩子,随后按原顺序列实参,Sources 可以区分调用表达式和参数层次。
|
||||
let mut children = vec![self.expression(callee)];
|
||||
children.extend(arguments.iter().map(|expr| self.expression(expr)));
|
||||
("call".into(), "call", children)
|
||||
|
||||
+339
-19
File diff suppressed because it is too large
Load Diff
@@ -26,22 +26,26 @@ impl SourcePlan {
|
||||
}
|
||||
}
|
||||
|
||||
/// 把外部源码或属性表示转换为内部枚举/结构,并反馈不支持的输入。
|
||||
/// 优先解析完整模块,否则按可完成的交互输入分段为 Script,并将 AST/诊断位置映回原文。
|
||||
pub fn parse(source: &SourceUnit) -> Result<SourcePlan> {
|
||||
// 完整模块优先;只有模块解析失败才退回连续交互输入模式,宿主不自行实现 Endor 语法。
|
||||
if let Ok(module) = frontend::parse_source_ast(source, ParseMode::Module) {
|
||||
return Ok(SourcePlan::Module(module));
|
||||
}
|
||||
// 一次词法分析获得原始字节 span,候选分段依赖 token 之间的实际换行而非直接按行切字符串。
|
||||
let tokens = frontend::lex_source(source)?;
|
||||
let mut roots = Vec::new();
|
||||
let mut start = 0;
|
||||
let mut depth = 0_i64;
|
||||
for (index, token) in tokens.iter().enumerate() {
|
||||
// 追踪圆/花括号嵌套,括号内换行不能直接结束输入;最终语法是否合法仍交给 Aster。
|
||||
match token.kind {
|
||||
TokenKind::LeftParen | TokenKind::LeftBrace => depth += 1,
|
||||
TokenKind::RightParen | TokenKind::RightBrace => depth -= 1,
|
||||
_ => {}
|
||||
}
|
||||
let end = token.span.end;
|
||||
// 末尾 token 总是尝试解析;非末尾要求顶层换行,且下一 token 不像成员访问、调用或算术续接。
|
||||
let boundary = tokens.get(index + 1).is_none_or(|next| {
|
||||
depth == 0
|
||||
&& source.text()[end..next.span.start].contains(['\r', '\n'])
|
||||
@@ -58,25 +62,30 @@ pub fn parse(source: &SourceUnit) -> Result<SourcePlan> {
|
||||
if !boundary {
|
||||
continue;
|
||||
}
|
||||
// 当前片段从上一次成功边界 start 开始,保留期间的空白与注释;解析器看到的是片段局部字节位置。
|
||||
match frontend::parse_ast(&source.text()[start..end], ParseMode::Interactive) {
|
||||
Ok(mut root) => {
|
||||
let AstRoot::Interactive(input) = &mut root else {
|
||||
unreachable!("interactive mode");
|
||||
};
|
||||
// 成功后递归加回 start,把整个 AST 的局部 span 转成原文件位置,再推进下一段起点。
|
||||
shift_input(input, start);
|
||||
roots.push(root);
|
||||
start = end;
|
||||
}
|
||||
// An incomplete interactive input can continue on the next line.
|
||||
// Only Aster decides whether its combined syntax is valid.
|
||||
// 错误恰在片段末尾且还有 token 时,视为可能未完成的交互输入,保持 start 不动继续拼接。
|
||||
Err(diagnostic) if index + 1 < tokens.len() && diagnostic.span.start == end - start => {
|
||||
}
|
||||
Err(mut diagnostic) => {
|
||||
// 其他语法错误立即恢复原始偏移,再用 SourceUnit 添加原文件来源与行列诊断。
|
||||
shift_span(&mut diagnostic.span, start);
|
||||
return Err(source.annotate(diagnostic).into());
|
||||
}
|
||||
}
|
||||
}
|
||||
// 空输入不能静默产生空计划;再次委托交互入口给出解析器自己的空输入诊断与来源。
|
||||
if roots.is_empty() {
|
||||
// Produce Aster's original empty-input diagnostic and provenance.
|
||||
frontend::parse_source_ast(source, ParseMode::Interactive)?;
|
||||
@@ -84,8 +93,9 @@ pub fn parse(source: &SourceUnit) -> Result<SourcePlan> {
|
||||
Ok(SourcePlan::Script(roots))
|
||||
}
|
||||
|
||||
/// 递归调整对应语法节点的源码范围,保持片段解析后的错误位置仍指向原输入。
|
||||
/// 为单个半开字节范围加回片段起始偏移,不处理其所属节点的子节点。
|
||||
fn shift_span(span: &mut Span, offset: usize) {
|
||||
// span 采用原文本字节偏移,start/end 同增 offset 保持长度;不是按字符数或行数偏移。
|
||||
span.start += offset;
|
||||
span.end += offset;
|
||||
}
|
||||
@@ -93,6 +103,7 @@ fn shift_span(span: &mut Span, offset: usize) {
|
||||
/// 递归调整对应语法节点的源码范围,保持片段解析后的错误位置仍指向原输入。
|
||||
fn shift_input(input: &mut InteractiveInput, offset: usize) {
|
||||
shift_span(&mut input.span, offset);
|
||||
// 根范围之外,逐条语句递归处理所有内层节点,避免错误只在顶层位置正确。
|
||||
for statement in &mut input.statements {
|
||||
shift_statement(statement, offset);
|
||||
}
|
||||
@@ -134,6 +145,7 @@ fn shift_statement(statement: &mut Stmt, offset: usize) {
|
||||
shift_span(&mut assignment.name.span, offset);
|
||||
shift_expression(&mut assignment.value, offset);
|
||||
}
|
||||
// 成员赋值同时包含目标对象表达式、成员名和右值,三部分都要恢复原始位置。
|
||||
StmtKind::MemberAssignment(assignment) => {
|
||||
shift_span(&mut assignment.span, offset);
|
||||
shift_span(&mut assignment.name.span, offset);
|
||||
@@ -156,6 +168,7 @@ fn shift_declaration(declaration: &mut Decl, offset: usize) {
|
||||
shift_span(&mut declaration.span, offset);
|
||||
match &mut declaration.kind {
|
||||
DeclKind::Function(function) => shift_function(function, offset),
|
||||
// 类的名称、基类、字段类型和方法均保存独立 span,不能仅移动声明外层范围。
|
||||
DeclKind::Class(class) => {
|
||||
shift_span(&mut class.span, offset);
|
||||
shift_span(&mut class.name.span, offset);
|
||||
@@ -179,6 +192,7 @@ fn shift_function(function: &mut frontend::ast::Function, offset: usize) {
|
||||
shift_span(&mut function.span, offset);
|
||||
shift_span(&mut function.name.span, offset);
|
||||
shift_span(&mut function.return_type.span, offset);
|
||||
// 参数自身、名称、类型各有范围;函数返回类型和函数体范围也独立移动。
|
||||
for parameter in &mut function.parameters {
|
||||
shift_span(&mut parameter.span, offset);
|
||||
shift_span(&mut parameter.name.span, offset);
|
||||
@@ -194,6 +208,7 @@ fn shift_function(function: &mut frontend::ast::Function, offset: usize) {
|
||||
fn shift_expression(expression: &mut Expr, offset: usize) {
|
||||
shift_span(&mut expression.span, offset);
|
||||
match &mut expression.kind {
|
||||
// 这些叶节点只用表达式外层 span;Symbol/Member 的名称还保存额外 span,需继续调整。
|
||||
ExprKind::Name(_) | ExprKind::Number(_) | ExprKind::String(_) => {}
|
||||
ExprKind::Symbol(name) => shift_span(&mut name.span, offset),
|
||||
ExprKind::Unary { operand, .. } | ExprKind::Await(operand) => {
|
||||
@@ -207,6 +222,7 @@ fn shift_expression(expression: &mut Expr, offset: usize) {
|
||||
shift_expression(object, offset);
|
||||
shift_span(&mut name.span, offset);
|
||||
}
|
||||
// 调用目标可继续是成员/调用等复合表达式;逐个递归实参而非只改整个 Call 的范围。
|
||||
ExprKind::Call { callee, arguments } => {
|
||||
shift_expression(callee, offset);
|
||||
for argument in arguments {
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
//! 托管事件与订阅的传播实现。Connection 持有回调引用,Event 保存目标、阶段与停止传播状态。
|
||||
//! 分发沿出现关系执行 capture → target → bubble,并处理默认行为;只有同一 VM 中的回调可以接触托管对象。
|
||||
//! 分发沿出现关系执行 capture → target → bubble,记录默认行为阻止状态;只有同一 VM 中的回调可以接触托管对象。
|
||||
//!
|
||||
//! Managed subscriptions and occurrence-specific propagation. A validated VM
|
||||
//! function sequences calls, so all handlers share one execution budget.
|
||||
@@ -9,6 +9,7 @@ use endor_core::{
|
||||
Value, Vm, VmError, WeakObjectRef,
|
||||
};
|
||||
|
||||
// 一次分发最多安排 10000 个处理器,另由共享 VM 驱动约束全部回调的总执行预算。
|
||||
const MAX_DELIVERIES: usize = 10_000;
|
||||
/// 统一构造本模块的参数错误,让调用方停止处理无效输入。
|
||||
fn invalid(message: &'static str) -> VmError {
|
||||
@@ -26,6 +27,7 @@ pub fn validate_handler(
|
||||
let arity = store
|
||||
.call_arity(function)?
|
||||
.ok_or(invalid("event handler requires positional metadata"))?;
|
||||
// 允许无参便捷回调或单 Event 回调;实际递送时优先传 Event(若接受一参),否则零参调用。
|
||||
if !arity.accepts(0) && !arity.accepts(1) {
|
||||
return Err(invalid(
|
||||
"event handler must accept zero arguments or one Event",
|
||||
@@ -37,10 +39,15 @@ pub fn validate_handler(
|
||||
#[derive(Debug, Clone, Default)]
|
||||
/// 本次传播的托管事件状态,包含目标、当前阶段和阻止默认/停止传播控制。
|
||||
pub struct Event {
|
||||
// 弱引用本轮 guard,检测同一 Event 是否正在分发;驱动释放后 guard 消失,事件可再次使用。
|
||||
dispatch: Option<WeakObjectRef>,
|
||||
// 当前传播组,一般对应路径中的一个出现/阶段;目标捕获与目标非捕获共用一组。
|
||||
group: usize,
|
||||
// stopPropagation 记下当前组,只阻止后续其他组;同组余下处理器仍执行。
|
||||
stopped_at: Option<usize>,
|
||||
// stopImmediatePropagation 全局跳过后续 Delivery,连当前组剩余处理器也停止。
|
||||
immediate: bool,
|
||||
// preventDefault 仅记录默认行为是否被阻止;本模块不在这里实现具体的系统默认动作。
|
||||
prevented: bool,
|
||||
}
|
||||
impl ObjectPayload for Event {
|
||||
@@ -122,12 +129,12 @@ enum Method {
|
||||
Connected,
|
||||
}
|
||||
impl NativeCallable for Method {
|
||||
/// 声明宿主可调用对象接受的参数个数,供 VM 在执行前检查。
|
||||
/// 事件与订阅查询/控制方法无显式参数,只接受隐式 Event 或 Subscription 接收者。
|
||||
fn arity(&self) -> Option<endor_core::CallArity> {
|
||||
Some(endor_core::CallArity::exact(1))
|
||||
}
|
||||
|
||||
/// VM 调入本宿主能力的入口;按所属操作解码参数并返回托管值或后续调用。
|
||||
/// 按操作读取或修改连接/传播状态;断开清除真实 handler/compute,停止标志写回同一 Event。
|
||||
fn invoke(&self, cx: &mut NativeContext<'_>, args: &[Value]) -> Result<NativeResult, VmError> {
|
||||
let [Value::Object(owner)] = args else {
|
||||
return Err(invalid("event method receiver"));
|
||||
@@ -139,6 +146,7 @@ impl NativeCallable for Method {
|
||||
.payload::<Subscription>(*owner, "Subscription")?
|
||||
.connection;
|
||||
let connection = cx.upgrade(weak)?;
|
||||
// Subscription 同时包装事件 Connection 和属性 Binding;按 payload 类型清 handler 或 compute。
|
||||
let connected = if let Some(connection) = connection {
|
||||
if cx
|
||||
.store()
|
||||
@@ -152,6 +160,7 @@ impl NativeCallable for Method {
|
||||
.payload::<crate::binding::Binding>(connection, "Binding")?
|
||||
.clone();
|
||||
let connected = data.compute.is_some();
|
||||
// 取消切断真实强拥有边,外部仍可保留 token,但 token 弱引用本身不保活回调或目标。
|
||||
if matches!(self, Self::Disconnect) {
|
||||
data.compute = None;
|
||||
cx.replace_payload(connection, data)?;
|
||||
@@ -210,16 +219,17 @@ impl NativeCallable for Constructor {
|
||||
fn signature(&self) -> Option<endor_core::CallSignature> {
|
||||
self.signature.clone()
|
||||
}
|
||||
/// 声明宿主可调用对象接受的参数个数,供 VM 在执行前检查。
|
||||
/// 至少接收隐式请求 Type 和事件 kind,额外参数留给源子类声明字段。
|
||||
fn arity(&self) -> Option<endor_core::CallArity> {
|
||||
Some(endor_core::CallArity::range(2, usize::MAX))
|
||||
}
|
||||
|
||||
/// VM 调入本宿主能力的入口;按所属操作解码参数并返回托管值或后续调用。
|
||||
/// 先验证事件子类字段数量与注解,再创建原生 Event 并填充声明字段,错误不得留下部分实例。
|
||||
fn invoke(&self, cx: &mut NativeContext<'_>, args: &[Value]) -> Result<NativeResult, VmError> {
|
||||
let [Value::Object(definition), Value::Text(kind), values @ ..] = args else {
|
||||
return Err(invalid("Event requires an event kind"));
|
||||
};
|
||||
// 事件子类构造先验证额外字段参数数量与注解,再创建默认事件并逐字段初始化。
|
||||
let fields = cx
|
||||
.store()
|
||||
.payload::<endor_core::EndorTypeObject>(*definition, "Type")?
|
||||
@@ -250,6 +260,7 @@ pub fn new_event(
|
||||
let event = cx.allocate(Event::default())?;
|
||||
cx.attach_type(event, definition)?;
|
||||
cx.set_attr(event, "kind", Value::Text(kind.into()))?;
|
||||
// 新事件尚未递送,目标、出现与 hit 都为空;kind 保留输入种类,phase 初始 none。
|
||||
for name in ["target", "mount", "currentTarget", "currentMount", "hit"] {
|
||||
cx.set_attr(event, name, Value::Nil)?;
|
||||
}
|
||||
@@ -268,7 +279,7 @@ impl NativeCallable for TypedMethod {
|
||||
fn signature(&self) -> Option<endor_core::CallSignature> {
|
||||
Some(self.signature.clone())
|
||||
}
|
||||
/// VM 调入本宿主能力的入口;按所属操作解码参数并返回托管值或后续调用。
|
||||
/// 把已声明签名的调用交给内部 Method,复用事件/订阅控制实现,不创建第二套状态。
|
||||
fn invoke(&self, cx: &mut NativeContext<'_>, args: &[Value]) -> Result<NativeResult, VmError> {
|
||||
self.method.invoke(cx, args)
|
||||
}
|
||||
@@ -294,6 +305,7 @@ pub fn install(
|
||||
(token_type, "disconnect", Method::Disconnect),
|
||||
(token_type, "isConnected", Method::Connected),
|
||||
] {
|
||||
// isDefaultPrevented/isConnected 返回 Bool 且只读;控制传播和取消方法返回 Unit 并声明 Mutating。
|
||||
let query = matches!(method, Method::Prevented | Method::Connected);
|
||||
let function = vm.allocate(ContextNativeFunction::new(
|
||||
name,
|
||||
@@ -340,18 +352,20 @@ struct Delivery {
|
||||
handler: Handler,
|
||||
}
|
||||
impl NativeCallable for Delivery {
|
||||
/// 声明宿主可调用对象接受的参数个数,供 VM 在执行前检查。
|
||||
/// 单次递送步骤的 Event/handler/阶段已保存在适配器中,执行时不再接收参数。
|
||||
fn arity(&self) -> Option<endor_core::CallArity> {
|
||||
Some(endor_core::CallArity::exact(0))
|
||||
}
|
||||
|
||||
/// VM 调入本宿主能力的入口;按所属操作解码参数并返回托管值或后续调用。
|
||||
/// 轮到该处理器时重查传播状态和连接是否仍有效,更新当前阶段/目标,再按真实回调 arity 发出 VM 调用。
|
||||
fn invoke(&self, cx: &mut NativeContext<'_>, _: &[Value]) -> Result<NativeResult, VmError> {
|
||||
let mut event = cx.store().payload::<Event>(self.event, "Event")?.clone();
|
||||
// 真正轮到处理器时重新读取传播状态,之前回调的 stop 操作立即影响后续项,无需重建序列。
|
||||
if event.immediate || event.stopped_at.is_some_and(|group| group != self.group) {
|
||||
return Ok(NativeResult::Return(Value::Nil));
|
||||
}
|
||||
let (function, mut arguments) = match self.handler {
|
||||
// 序列只捕获 Connection,不快照 handler;前面处理器取消它后,这里看到 None 并跳过。
|
||||
Handler::Token(token) => {
|
||||
let Some(handler) = cx
|
||||
.store()
|
||||
@@ -363,6 +377,7 @@ impl NativeCallable for Delivery {
|
||||
(handler, vec![])
|
||||
}
|
||||
Handler::Legacy(function) => (function, vec![]),
|
||||
// 对象协议在执行到该项时解析实际类型的 onEvent;显式 receiver 先放入实参向量。
|
||||
Handler::ObjectMethod => {
|
||||
let Some(definition) = cx.store().type_of(self.owner)? else {
|
||||
return Err(invalid("untyped event target"));
|
||||
@@ -374,6 +389,7 @@ impl NativeCallable for Delivery {
|
||||
(function, vec![Value::Object(self.owner)])
|
||||
}
|
||||
};
|
||||
// 调用前更新 currentTarget/currentMount/phase,处理器观察到的是当前路径项,不会误用最终目标。
|
||||
event.group = self.group;
|
||||
cx.replace_payload(self.event, event)?;
|
||||
cx.set_attr(self.event, "phase", Value::Text(self.phase.into()))?;
|
||||
@@ -383,6 +399,7 @@ impl NativeCallable for Delivery {
|
||||
"currentMount",
|
||||
self.mount.map(Value::Object).unwrap_or(Value::Nil),
|
||||
)?;
|
||||
// 对象方法总是携带 Event;显式订阅/旧式回调按 arity 决定是否传 Event。
|
||||
if matches!(self.handler, Handler::ObjectMethod)
|
||||
|| cx
|
||||
.store()
|
||||
@@ -398,17 +415,18 @@ impl NativeCallable for Delivery {
|
||||
}
|
||||
}
|
||||
#[derive(Debug)]
|
||||
/// 传播结束后的默认行为收尾步骤。
|
||||
/// 正常传播结束后清理当前目标、阶段和 guard 标记,返回仍保留最终控制状态的 Event。
|
||||
struct Finish(ObjectRef);
|
||||
impl NativeCallable for Finish {
|
||||
/// 声明宿主可调用对象接受的参数个数,供 VM 在执行前检查。
|
||||
/// 派发结束步骤已持有 Event 引用,无需显式输入。
|
||||
fn arity(&self) -> Option<endor_core::CallArity> {
|
||||
Some(endor_core::CallArity::exact(0))
|
||||
}
|
||||
|
||||
/// VM 调入本宿主能力的入口;按所属操作解码参数并返回托管值或后续调用。
|
||||
/// 正常序列结束时清除活跃派发守卫与当前上下文,保留 target/prevented 并返回实际 Event,允许后续重用。
|
||||
fn invoke(&self, cx: &mut NativeContext<'_>, _: &[Value]) -> Result<NativeResult, VmError> {
|
||||
let mut event = cx.store().payload::<Event>(self.0, "Event")?.clone();
|
||||
// 正常序列结束清递送标记与当前上下文,保留原始 target/mount 和 prevented 供调用方读取。
|
||||
event.dispatch = None;
|
||||
cx.replace_payload(self.0, event)?;
|
||||
cx.set_attr(self.0, "phase", Value::Text("none".into()))?;
|
||||
@@ -421,7 +439,7 @@ impl NativeCallable for Finish {
|
||||
/// Snapshot the selected occurrence's route and listener order. Disconnection
|
||||
/// before a listener's turn skips it; newly registered listeners wait for the
|
||||
/// next dispatch. A code event without a Mount visits only its target object.
|
||||
/// 按 Mount 祖先路径执行捕获、目标与冒泡阶段,再处理对应默认行为。
|
||||
/// 快照 Mount 路径和订阅顺序,构造共享预算的 capture/target/bubble 驱动并返回 VM 续调。
|
||||
pub fn dispatch(
|
||||
cx: &mut NativeContext<'_>,
|
||||
owner: ObjectRef,
|
||||
@@ -430,6 +448,7 @@ pub fn dispatch(
|
||||
desktop: ObjectRef,
|
||||
) -> Result<NativeResult, VmError> {
|
||||
let mut event = cx.store().payload::<Event>(event_ref, "Event")?.clone();
|
||||
// 只有 guard 仍存活才禁止重入;此前分发失败但 guard 已释放时,不让旧弱身份永久锁住 Event。
|
||||
if let Some(weak) = event.dispatch
|
||||
&& cx.upgrade(weak)?.is_some()
|
||||
{
|
||||
@@ -441,13 +460,16 @@ pub fn dispatch(
|
||||
if kind.is_empty() || kind.len() > 128 {
|
||||
return Err(invalid("invalid event kind"));
|
||||
}
|
||||
// 路线由目标向外保存。无 Mount 的代码事件只访问目标对象,不猜测共享 Block 属于哪个出现。
|
||||
let mut route = vec![(owner, mount)];
|
||||
if let Some(mount) = mount {
|
||||
let target = cx.store().payload::<Mount>(mount, "Mount")?.clone();
|
||||
// 传入 Mount 必须仍挂接且确实展示 owner;同一 Block 的另一个出现不能替代该上下文。
|
||||
if !target.mounted || target.block != owner {
|
||||
return Err(invalid("event context does not belong to this Block"));
|
||||
}
|
||||
let mut parent = target.parent;
|
||||
// 沿弱 parent 链构建本轮路径快照,检查死亡祖先、脱离与环;不通过 Block 业务孩子关系反推祖先。
|
||||
let mut seen = std::collections::HashSet::from([mount]);
|
||||
while let Some(weak) = parent {
|
||||
let ancestor = cx
|
||||
@@ -463,15 +485,18 @@ pub fn dispatch(
|
||||
route.push((data.block, Some(ancestor)));
|
||||
parent = data.parent;
|
||||
}
|
||||
// 出现祖先之外再加入 Page 上下文,页面本身无 currentMount;弱页已失效则拒绝该旧路线。
|
||||
if let Some(weak) = target.page {
|
||||
let page = cx.upgrade(weak)?.ok_or(invalid("event Page has expired"))?;
|
||||
route.push((page, None));
|
||||
}
|
||||
}
|
||||
// 所有递送和 Finish 显式捕获 guard,Event 只弱引用它;驱动完成/失败释放后 guard 自动结束本轮资格。
|
||||
let guard = cx.new_object()?;
|
||||
let mut calls = Vec::new();
|
||||
let mut group = 0;
|
||||
// Each occurrence is its own propagation group, even for shared Blocks.
|
||||
// 先从最外层向目标递送捕获,再从目标向外递送非捕获;目标两次遍历都标记 phase=target。
|
||||
let traversal = route
|
||||
.iter()
|
||||
.enumerate()
|
||||
@@ -486,6 +511,7 @@ pub fn dispatch(
|
||||
for (index, &(block, current_mount), capture) in traversal {
|
||||
let (_, data) = block::resolve(cx.store(), block)?;
|
||||
let mut handlers = Vec::new();
|
||||
// 本轮先快照符合事件 kind 与 capture 的订阅顺序;回调期间新注册的连接不进入当前分发。
|
||||
for token in &data.subscriptions {
|
||||
let token_data = cx.store().payload::<Connection>(*token, "Connection")?;
|
||||
if token_data.handler.is_some()
|
||||
@@ -496,6 +522,7 @@ pub fn dispatch(
|
||||
}
|
||||
}
|
||||
if !capture {
|
||||
// 非捕获阶段 onEvent 先执行,再按订阅顺序,最后兼容旧 click 回调。
|
||||
handlers.insert(0, Handler::ObjectMethod);
|
||||
if kind == "click"
|
||||
&& let Some(handler) = data.click
|
||||
@@ -507,6 +534,7 @@ pub fn dispatch(
|
||||
if calls.len() >= MAX_DELIVERIES {
|
||||
return Err(invalid("event delivery budget exceeded"));
|
||||
}
|
||||
// 每一项显式保活本轮 Event、guard、目标和可选 Mount/连接;不能仅靠 Rust ObjectRef 值当 GC 根。
|
||||
let mut captures = vec![event_ref, guard, block];
|
||||
if let Some(mount) = current_mount {
|
||||
captures.push(mount);
|
||||
@@ -538,6 +566,7 @@ pub fn dispatch(
|
||||
}
|
||||
// Capture and bubble at the target are one group: stopPropagation at
|
||||
// target capture still permits other target listeners.
|
||||
// 目标捕获后不递增 group,使 stopPropagation 仍允许目标非捕获处理器;其他路径/阶段则隔离为新组。
|
||||
if index != 0 || !capture {
|
||||
group += 1;
|
||||
}
|
||||
@@ -547,10 +576,12 @@ pub fn dispatch(
|
||||
Finish(event_ref),
|
||||
vec![event_ref, guard],
|
||||
))?;
|
||||
// 无论传播是否被停止,Finish 都作为序列最后一项执行,它不受 Delivery 的 stopped 判定影响。
|
||||
calls.push(finish);
|
||||
let driver = crate::vm_sequence::build(cx, calls, "<event dispatch>", desktop)?;
|
||||
event.dispatch = Some(cx.store().downgrade(guard)?);
|
||||
event.group = 0;
|
||||
// 再次使用 Event 时清上一轮停止和默认阻止标志;目标与 Mount 属性也被本轮参数覆盖。
|
||||
event.stopped_at = None;
|
||||
event.immediate = false;
|
||||
event.prevented = false;
|
||||
|
||||
+25
-3
@@ -16,6 +16,7 @@ use winit::event_loop::EventLoopProxy;
|
||||
/// 拖放目标窗口、目标布局版本和插入位置,源标签身份由外层 Input 保存。
|
||||
pub struct TabDrop {
|
||||
pub window: u64,
|
||||
// 事件所依据的已发布布局版本,由执行端校验过期帧;原生连续手势有单独刷新逻辑。
|
||||
pub layout_version: u64,
|
||||
pub index: usize,
|
||||
}
|
||||
@@ -26,15 +27,19 @@ pub struct TabDrop {
|
||||
pub struct Input {
|
||||
#[serde(default = "default_window")]
|
||||
pub window: u64,
|
||||
// 产生事件的运行时会话;重载后即使窗口或 Mount 数值相同也不能沿用旧事件。
|
||||
pub session: u64,
|
||||
pub layout_version: u64,
|
||||
// 捕获的具体出现身份;页面级相机事件使用零,独立视口相机事件要求非零。
|
||||
pub mount: u64,
|
||||
pub kind: String,
|
||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||
// 事件位置或缩放锚点;click 与 press_point 配对,具体坐标语义由事件 kind 决定。
|
||||
pub point: Option<[f32; 2]>,
|
||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||
pub press_point: Option<[f32; 2]>,
|
||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||
// 平移/滚动增量,或缩放的 [倍率,0];不能无差别接受任意事件携带该字段。
|
||||
pub delta: Option<[f32; 2]>,
|
||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||
pub tab_drop: Option<TabDrop>,
|
||||
@@ -48,11 +53,12 @@ fn default_window() -> u64 {
|
||||
}
|
||||
|
||||
impl Input {
|
||||
/// 检查当前输入或发布值的不变量,调用方据校验结果决定是否继续。
|
||||
/// 按事件种类核对可携带字段、坐标范围和 Mount 是否为零;不替代执行端的会话/能力校验。
|
||||
pub fn validate(&self) -> Result<(), &'static str> {
|
||||
if self.window == 0 {
|
||||
return Err("window identity must be nonzero");
|
||||
}
|
||||
// 标签跨窗口放置仅接受目标元信息;禁止同时夹带指针/滚动/屏幕位置,避免混用两套操作。
|
||||
if self.kind == "tab-drop" {
|
||||
let Some(target) = &self.tab_drop else {
|
||||
return Err("tab-drop requires target metadata");
|
||||
@@ -68,9 +74,11 @@ impl Input {
|
||||
}
|
||||
return Ok(());
|
||||
}
|
||||
// 非 tab-drop 不得携带目标窗口信息,即使其他字段恰好合法也拒绝。
|
||||
if self.tab_drop.is_some() {
|
||||
return Err("tab_drop is only accepted for tab-drop");
|
||||
}
|
||||
// 屏幕位置只服务 tab-detach 的新窗口定位,允许负数以支持左侧/上方显示器,但限制绝对范围。
|
||||
if let Some(position) = self.screen_position
|
||||
&& (self.kind != "tab-detach"
|
||||
|| !position
|
||||
@@ -89,7 +97,9 @@ impl Input {
|
||||
| "scene-pan"
|
||||
| "scene-zoom"
|
||||
) {
|
||||
// 独立视口输入可包含负的局部位置(例如捕获拖动移出视口);页面级锚点要求非负。
|
||||
let viewport = self.kind.starts_with("viewport-") || self.kind.starts_with("scene-");
|
||||
// 所有相机操作必须带有限、有界的增量;point 在非缩放操作可省略。
|
||||
let valid_delta = self.delta.is_some_and(|delta| {
|
||||
delta
|
||||
.iter()
|
||||
@@ -112,6 +122,7 @@ impl Input {
|
||||
{
|
||||
return Err("invalid page camera input");
|
||||
}
|
||||
// 缩放必须给锚点并使用正倍率 0.1..=10;第二分量必须为零,不把缩放与二维平移混合编码。
|
||||
if self.kind.ends_with("-zoom")
|
||||
&& (self.point.is_none()
|
||||
|| self
|
||||
@@ -122,6 +133,7 @@ impl Input {
|
||||
}
|
||||
return Ok(());
|
||||
}
|
||||
// 滚动需要当前点与二维有限增量,不接受按下点;Mount 能力与身份由执行端进一步核对。
|
||||
if self.kind == "scroll" {
|
||||
return match (self.point, self.press_point, self.delta) {
|
||||
(Some(point), None, Some(delta))
|
||||
@@ -157,6 +169,8 @@ impl Input {
|
||||
if self.delta.is_some() {
|
||||
return Err("delta is only accepted for scroll input");
|
||||
}
|
||||
// 无指针坐标的离散事件可通过此结构校验;若有指针信息,必须是 click 的按下/释放成对坐标。
|
||||
// 这里不做完整 kind 白名单授权,具体操作仍由后续分发层检查。
|
||||
match (self.point, self.press_point) {
|
||||
(None, None) => Ok(()),
|
||||
(Some(point), Some(press))
|
||||
@@ -228,7 +242,7 @@ impl Inbox {
|
||||
}
|
||||
}
|
||||
impl Client {
|
||||
/// 构造本类型并初始化其状态;资源建立和默认字段以函数体为准。
|
||||
/// 建立容量 64 的发送队列和单个后台中继线程,事件交给原生 VM worker;线程创建失败则返回错误。
|
||||
pub fn new(
|
||||
proxy: EventLoopProxy<crate::app::AppEvent>,
|
||||
namespace: Arc<RwLock<crate::document::NamespaceState>>,
|
||||
@@ -263,7 +277,7 @@ impl Client {
|
||||
})?;
|
||||
Ok(Self(inbox))
|
||||
}
|
||||
/// 通过有界原生输入客户端或本地 HTTP 发送纯数据事件;过期版本按既定协议处理。
|
||||
/// 非阻塞尝试入队;成功仅代表队列接收,满队列或后台线程关闭返回 false。
|
||||
pub fn send(&self, input: Input) -> bool {
|
||||
let Ok(mut q) = self.0.queue.lock() else {
|
||||
return false;
|
||||
@@ -303,6 +317,7 @@ pub(crate) fn refresh_continuous_input(
|
||||
) {
|
||||
return true;
|
||||
}
|
||||
// 选取事件原窗口的权威帧;窗口已经消失时丢弃,不能把手势改投主窗口。
|
||||
let frame = if input.window == crate::window::MAIN_WINDOW {
|
||||
Some(¤t.document.frame)
|
||||
} else {
|
||||
@@ -315,6 +330,7 @@ pub(crate) fn refresh_continuous_input(
|
||||
let Some(frame) = frame else {
|
||||
return false;
|
||||
};
|
||||
// 必须仍属同一运行时会话、帧无故障且原捕获 Mount 具备对应能力,才可更新布局版本。
|
||||
if current.runtime_session != input.session
|
||||
|| frame.session != input.session
|
||||
|| frame.fault.is_some()
|
||||
@@ -333,6 +349,7 @@ pub(crate) fn refresh_continuous_input(
|
||||
{
|
||||
return false;
|
||||
}
|
||||
// 只追随新版本,不改 session/window/mount,不重选目标;每条排队增量仍独立发送。
|
||||
input.layout_version = frame.layout_version;
|
||||
true
|
||||
}
|
||||
@@ -341,6 +358,7 @@ pub(crate) fn refresh_continuous_input(
|
||||
mod tests {
|
||||
use super::*;
|
||||
#[test]
|
||||
/// 重复消费旧帧捕获的连续 pan,允许刷新到当前版本且保留每条 delta;离散 click 不改版本,会话/目标替换拒绝手势。
|
||||
fn queued_native_pan_keeps_each_delta_and_rejects_replaced_targets() {
|
||||
let (mut session, document) = crate::endor_host::ReplSession::load(
|
||||
"view=CanvasViewport(200,100,Scene2D(RectBlock(20,20,0)))\npage=Page()\npage.render(view)",
|
||||
@@ -370,6 +388,7 @@ mod tests {
|
||||
document,
|
||||
..Default::default()
|
||||
};
|
||||
// 反复从旧帧原始手势克隆输入,验证每条增量都被刷新版本并累计,12×3 应得到 36。
|
||||
for _ in 0..12 {
|
||||
let mut queued = original.clone();
|
||||
assert!(refresh_continuous_input(&mut queued, ¤t));
|
||||
@@ -379,6 +398,7 @@ mod tests {
|
||||
session.execute("view.camera.x", "app.main").unwrap().value,
|
||||
"36"
|
||||
);
|
||||
// 离散点击不得自动刷新版本;随后验证会话替换和目标移除都会拒绝连续手势。
|
||||
let mut click = original.clone();
|
||||
click.kind = "click".into();
|
||||
assert!(refresh_continuous_input(&mut click, ¤t));
|
||||
@@ -390,6 +410,7 @@ mod tests {
|
||||
assert!(!refresh_continuous_input(&mut original.clone(), ¤t));
|
||||
}
|
||||
#[test]
|
||||
/// 对 tab-drop 元数据、位置上限与 tab-detach 桌面坐标逐项改坏,检查辅助字段只在对应事件类型和预算内合法。
|
||||
fn drop_metadata_is_scoped_to_its_event_kind_and_bounded() {
|
||||
let mut input:Input=serde_json::from_str(r#"{"window":1,"session":1,"layout_version":2,"mount":3,"kind":"tab-drop","tab_drop":{"window":2,"layout_version":4,"index":1}}"#).unwrap();
|
||||
assert!(input.validate().is_ok());
|
||||
@@ -407,6 +428,7 @@ mod tests {
|
||||
}
|
||||
|
||||
#[test]
|
||||
/// 旧 JSON 未带 window 时默认主窗口以保持兼容;显式 window=0 仍是非法资源,不能当成默认值。
|
||||
fn legacy_event_window_defaults_but_zero_is_never_a_resource() {
|
||||
let mut input: Input =
|
||||
serde_json::from_str(r#"{"session":1,"layout_version":2,"mount":3,"kind":"focus"}"#)
|
||||
|
||||
+35
-3
@@ -18,7 +18,9 @@ use std::{
|
||||
time::Duration,
|
||||
};
|
||||
|
||||
// 文件与 HTTP 返回文本最多 1 MiB,最终必须为有效 UTF-8;长度按字节计算。
|
||||
const MAX_TEXT: usize = 1024 * 1024;
|
||||
// 每个运行时的租约额度,独立于全进程 4 个执行线程和 64 项工作队列。
|
||||
const MAX_ACTIVE: usize = 16;
|
||||
const WORKERS: usize = 4;
|
||||
const QUEUE: usize = 64;
|
||||
@@ -28,6 +30,7 @@ type Completion = Result<String, String>;
|
||||
/// provider 共享的就绪结果与并发计数;内容只有纯数据和弱任务身份。
|
||||
struct Shared {
|
||||
ready: Mutex<HashMap<WeakObjectRef, Completion>>,
|
||||
// 统计当前活租约而非正在执行的 OS 操作;完成结果被取走前,租约仍可能占用名额。
|
||||
active: AtomicUsize,
|
||||
}
|
||||
#[derive(Clone, Debug, Default)]
|
||||
@@ -44,11 +47,13 @@ struct Control {
|
||||
impl Control {
|
||||
/// 撤销当前操作的后续交付资格,并执行对应取消清理。
|
||||
fn cancel(&self) {
|
||||
// 先撤销结果交付资格,再尝试终止当前子进程;文件读取无法用此标记中断,只能丢弃晚到结果。
|
||||
self.cancelled.store(true, Ordering::Release);
|
||||
if let Ok(mut process) = self.process.lock()
|
||||
&& let Some(child) = process.as_mut()
|
||||
{
|
||||
// Reaping belongs to the provider worker, never the VM thread.
|
||||
// VM/租约线程这里只 kill,不 wait;子进程回收由持有 Reaper 的 I/O worker 完成,避免阻塞 VM。
|
||||
let _ = child.kill();
|
||||
}
|
||||
}
|
||||
@@ -68,13 +73,14 @@ pub struct Lease {
|
||||
control: Arc<Control>,
|
||||
}
|
||||
impl Drop for Lease {
|
||||
/// 在 Rust 所有者离开作用域时执行本类型的配套清理;不能用它代替需要报告错误的显式关闭。
|
||||
/// 最后一个 Arc<Lease> 释放时撤销交付资格、删除待交付结果并归还一次并发额度;后台 Job 不延长租约。
|
||||
fn drop(&mut self) {
|
||||
// 租约释放立即取消交付资格;后台 OS 读取即使稍后结束,也不能再次唤醒旧 Task。
|
||||
self.control.cancel();
|
||||
if let Ok(mut ready) = self.shared.ready.lock() {
|
||||
ready.remove(&self.task);
|
||||
}
|
||||
// Lease 包在 Arc 中,只有最后一个拥有者释放才析构并归还一次额度;Job 不持有 Lease。
|
||||
self.shared.active.fetch_sub(1, Ordering::AcqRel);
|
||||
}
|
||||
}
|
||||
@@ -93,18 +99,22 @@ impl Provider {
|
||||
request: Request,
|
||||
replacing: bool,
|
||||
) -> Result<Arc<Lease>, VmError> {
|
||||
// 原子更新同时完成检查和预占,防止并发提交都观察到剩余名额而超配。
|
||||
// replacing 允许替换期间临时多一个租约,旧任务取消后回到正常上限。
|
||||
self.shared
|
||||
.active
|
||||
.fetch_update(Ordering::AcqRel, Ordering::Acquire, |active| {
|
||||
(active < MAX_ACTIVE + usize::from(replacing)).then_some(active + 1)
|
||||
})
|
||||
.map_err(|_| VmError::ExecutionLimit("16 I/O tasks per runtime"))?;
|
||||
// 预占后立即建立 RAII 租约;线程池不可用或队列发送失败时,局部 lease 析构会归还名额。
|
||||
let lease = Arc::new(Lease {
|
||||
shared: self.shared.clone(),
|
||||
task,
|
||||
control: Arc::new(Control::default()),
|
||||
});
|
||||
let sender = pool().map_err(|_| VmError::InvalidArgument("I/O provider unavailable"))?;
|
||||
// 非阻塞入队,不让调用 VM 等待后台吞吐;Job 只带参数、弱任务身份和原生取消/结果状态。
|
||||
sender
|
||||
.try_send(Job {
|
||||
request,
|
||||
@@ -115,7 +125,8 @@ impl Provider {
|
||||
.map_err(|_| VmError::ExecutionLimit("I/O provider queue full or unavailable"))?;
|
||||
Ok(lease)
|
||||
}
|
||||
/// 取走指定弱任务身份的 provider 完成结果;实际托管写入仍由 VM worker 执行。
|
||||
/// 一次取走当前邮箱内全部 (弱任务身份, 纯文本结果),实际托管交付仍由 VM worker 校验后执行。
|
||||
// 一次 drain 所有已就绪结果;移走纯数据不代表任务仍可交付,VM worker 还需检查弱身份和归属。
|
||||
pub fn take_ready(&self) -> Result<Vec<(WeakObjectRef, Completion)>, VmError> {
|
||||
Ok(self
|
||||
.shared
|
||||
@@ -128,6 +139,7 @@ impl Provider {
|
||||
}
|
||||
/// 懒初始化共享工作线程和有界任务队列;初始化失败反馈给提交方。
|
||||
fn pool() -> Result<&'static SyncSender<Job>, &'static str> {
|
||||
// 全进程只初始化一次,初始化失败也会记住失败结果;后续 submit 返回 unavailable,不反复创建线程。
|
||||
static POOL: OnceLock<Result<SyncSender<Job>, String>> = OnceLock::new();
|
||||
POOL.get_or_init(|| {
|
||||
let (sender, receiver) = sync_channel::<Job>(QUEUE);
|
||||
@@ -138,6 +150,7 @@ fn pool() -> Result<&'static SyncSender<Job>, &'static str> {
|
||||
.name(format!("tessera-io-{index}"))
|
||||
.spawn(move || {
|
||||
loop {
|
||||
// std mpsc Receiver 通过 Mutex 共享;锁只覆盖取任务,实际 I/O 在离开该 match 后并行执行。
|
||||
let job = match receiver.lock() {
|
||||
Ok(receiver) => receiver.recv(),
|
||||
Err(_) => break,
|
||||
@@ -145,6 +158,7 @@ fn pool() -> Result<&'static SyncSender<Job>, &'static str> {
|
||||
let Ok(job) = job else {
|
||||
break;
|
||||
};
|
||||
// 执行前先跳过已取消队列项,避免启动无用文件读取或 curl。
|
||||
if job.control.cancelled.load(Ordering::Acquire) {
|
||||
continue;
|
||||
}
|
||||
@@ -152,6 +166,7 @@ fn pool() -> Result<&'static SyncSender<Job>, &'static str> {
|
||||
Request::ReadText(path) => read_text(path),
|
||||
Request::FetchText(url) => fetch_text(url, &job.control),
|
||||
};
|
||||
// 持有 ready 锁后再次检查取消,与 Lease::drop 的取消/移除配合,防止取消后重新留下晚到结果。
|
||||
if let Ok(mut ready) = job.shared.ready.lock()
|
||||
&& !job.control.cancelled.load(Ordering::Acquire)
|
||||
{
|
||||
@@ -168,6 +183,7 @@ fn pool() -> Result<&'static SyncSender<Job>, &'static str> {
|
||||
}
|
||||
/// 读取受字节上限限制的 UTF-8 文件内容,错误作为任务结果交付。
|
||||
fn read_text(path: &str) -> Completion {
|
||||
// 先按路径检查普通文件和已知长度,及早拒绝目录/超大源;实际打开后还会复核文件类型。
|
||||
let metadata = std::fs::metadata(path).map_err(|error| error.to_string())?;
|
||||
if !metadata.is_file() {
|
||||
return Err("text source must be a regular file".into());
|
||||
@@ -184,6 +200,7 @@ fn read_text(path: &str) -> Completion {
|
||||
return Err("text source must be a regular file".into());
|
||||
}
|
||||
let mut bytes = Vec::new();
|
||||
// 再用流读取硬上限检测增长中的文件:多读一个字节即可判断超限,不能只依赖之前 metadata 长度。
|
||||
file.take(MAX_TEXT as u64 + 1)
|
||||
.read_to_end(&mut bytes)
|
||||
.map_err(|error| error.to_string())?;
|
||||
@@ -197,6 +214,7 @@ fn read_text(path: &str) -> Completion {
|
||||
/// Authentication/custom headers are deliberately outside this text GET API.
|
||||
/// 检查网络请求的 URL 协议、长度与凭据等约束,拒绝不受支持的输入。
|
||||
pub fn valid_url(url: &str) -> bool {
|
||||
// 控制字符必须在写 curl config 前拒绝,否则换行等可能破坏单个 url 配置项边界。
|
||||
if url.len() > 8192 || url.chars().any(char::is_control) {
|
||||
return false;
|
||||
}
|
||||
@@ -206,6 +224,8 @@ pub fn valid_url(url: &str) -> bool {
|
||||
if !scheme.eq_ignore_ascii_case("http") && !scheme.eq_ignore_ascii_case("https") {
|
||||
return false;
|
||||
}
|
||||
// 仅检查协议与 authority 基本约束;@ 禁止 userinfo 凭据,空白禁止模糊主机部分。
|
||||
// 这不是完整 URL 解析器,具体 HTTP 解析仍由 curl 负责。
|
||||
let authority = rest.split(['/', '?', '#']).next().unwrap_or("");
|
||||
!authority.is_empty() && !authority.contains('@') && !authority.chars().any(char::is_whitespace)
|
||||
}
|
||||
@@ -214,8 +234,9 @@ pub fn valid_url(url: &str) -> bool {
|
||||
/// 子进程作用域收尾保护,避免取消/失败路径遗留未回收进程。
|
||||
struct Reaper<'a>(&'a Control);
|
||||
impl Drop for Reaper<'_> {
|
||||
/// 在 Rust 所有者离开作用域时执行本类型的配套清理;不能用它代替需要报告错误的显式关闭。
|
||||
/// 取走残留 curl 子进程后尝试 kill/wait,保证失败或取消路径也回收进程,且不持控制锁等待。
|
||||
fn drop(&mut self) {
|
||||
// 从控制槽取出子进程后释放锁,再 kill/wait;只有实际留下的进程才需要回收。
|
||||
let child = self.0.process.lock().ok().and_then(|mut slot| slot.take());
|
||||
if let Some(mut child) = child {
|
||||
let _ = child.kill();
|
||||
@@ -233,6 +254,8 @@ fn fetch_text(url: &str, control: &Control) -> Completion {
|
||||
#[cfg(not(unix))]
|
||||
let executable = "curl.exe";
|
||||
let mut child = Command::new(executable)
|
||||
// --disable 放首项关闭 curlrc,--globoff 禁用 URL 展开,首次请求与重定向均限制 HTTP(S)。
|
||||
// 限制重定向数、连接/总超时和下载大小;--compressed 后仍会用下面字节读取上限限制解压文本。
|
||||
.args([
|
||||
"--disable",
|
||||
"--silent",
|
||||
@@ -263,6 +286,7 @@ fn fetch_text(url: &str, control: &Control) -> Completion {
|
||||
.stderr(Stdio::null())
|
||||
.spawn()
|
||||
.map_err(|_| "HTTP transport unavailable: system curl is required".to_owned())?;
|
||||
// 取走管道后把 Child 放入共享 Control,取消线程可随时 kill;Reaper 覆盖其后的所有提前返回。
|
||||
let mut input = child.stdin.take().expect("piped stdin");
|
||||
let output = child.stdout.take().expect("piped stdout");
|
||||
match control.process.lock() {
|
||||
@@ -278,17 +302,21 @@ fn fetch_text(url: &str, control: &Control) -> Completion {
|
||||
return Err("request cancelled".into());
|
||||
}
|
||||
// URL stays out of process arguments. Reject controls before config escaping.
|
||||
// URL 经 curl 配置的引号/反斜杠转义后走 stdin,避免出现在进程参数;这里不经过 shell。
|
||||
let escaped = url.replace('\\', "\\\\").replace('"', "\\\"");
|
||||
writeln!(input, "url = \"{escaped}\"").map_err(|_| "HTTP transport input failed".to_owned())?;
|
||||
// 关闭 stdin 表示配置结束,否则 curl 可能继续等待输入,无法开始/完成请求。
|
||||
drop(input);
|
||||
let mut bytes = Vec::new();
|
||||
output
|
||||
// 预留结尾换行和三位状态码共 4 字节,再额外读 1 字节探测正文超限。
|
||||
.take(MAX_TEXT as u64 + 5)
|
||||
.read_to_end(&mut bytes)
|
||||
.map_err(|_| "HTTP response read failed".to_owned())?;
|
||||
if bytes.len() > MAX_TEXT + 4 {
|
||||
return Err("HTTP text exceeds 1 MiB".into());
|
||||
}
|
||||
// 读完输出后用 try_wait 检查退出;等待间隔先释放 process 锁,让其他线程仍可取消进程。
|
||||
let status = loop {
|
||||
let mut slot = control
|
||||
.process
|
||||
@@ -299,6 +327,7 @@ fn fetch_text(url: &str, control: &Control) -> Completion {
|
||||
.try_wait()
|
||||
.map_err(|_| "HTTP transport wait failed".to_owned())?
|
||||
{
|
||||
// try_wait 已回收退出状态,移除 Child 后 Reaper 析构不会再次 kill/wait 同一个进程。
|
||||
slot.take();
|
||||
break status;
|
||||
}
|
||||
@@ -308,12 +337,14 @@ fn fetch_text(url: &str, control: &Control) -> Completion {
|
||||
if control.cancelled.load(Ordering::Acquire) {
|
||||
return Err("request cancelled".into());
|
||||
}
|
||||
// --write-out 的末尾四字节应是换行加三位状态码;checked_sub 处理空/短输出,不直接倒数切片。
|
||||
let code = bytes
|
||||
.len()
|
||||
.checked_sub(4)
|
||||
.and_then(|offset| (bytes[offset] == b'\n').then_some(&bytes[offset + 1..]))
|
||||
.and_then(|digits| std::str::from_utf8(digits).ok())
|
||||
.and_then(|digits| digits.parse::<u16>().ok());
|
||||
// 已知 HTTP 3xx/4xx/5xx 优先以 HTTP 错误报告,其他 curl 非零状态再映射为超时、大小或传输失败。
|
||||
if let Some(code) = code
|
||||
&& code >= 300
|
||||
{
|
||||
@@ -330,6 +361,7 @@ fn fetch_text(url: &str, control: &Control) -> Completion {
|
||||
if !code.is_some_and(|code| (200..300).contains(&code)) {
|
||||
return Err("HTTP response status unavailable".into());
|
||||
}
|
||||
// 确认 2xx 与成功退出后才剥去协议附加状态尾部,再严格解码 UTF-8 正文。
|
||||
bytes.truncate(bytes.len() - 4);
|
||||
String::from_utf8(bytes).map_err(|_| "HTTP text must be UTF-8".into())
|
||||
}
|
||||
|
||||
+9
-1
@@ -1,11 +1,19 @@
|
||||
//! 运行时模块入口。VM 生命周期、API、源程序组织、事件与异步任务在这里组合。
|
||||
//!
|
||||
// Module ownership follows the directory; crate-root aliases keep internal call sites stable.
|
||||
// 目录确定模块归属;main 中的 crate 根别名保持内部调用路径稳定。
|
||||
/// 提供 HTTP 路由、有界请求队列与串行 worker,协调候选 VM 和已发布 namespace。
|
||||
pub(crate) mod api;
|
||||
/// 拥有真实 Aster VM 会话,组合源执行、增量刷新、事件、任务和资源清理。
|
||||
pub(crate) mod endor_host;
|
||||
/// 识别并组织 Endor 源输入,保留原始诊断位置,支持脚本和兼容入口形式。
|
||||
pub(crate) mod endor_script;
|
||||
/// 在 VM 中执行捕获/目标/冒泡路由,处理监听器断开、传播停止与事件结果。
|
||||
pub(crate) mod event_dispatch;
|
||||
/// 定义原生输入信封与有界客户端,将窗口输入送往运行时而不跨线程调用源函数。
|
||||
pub(crate) mod events;
|
||||
/// 执行后台文件/HTTP 文本读取,使用租约拒绝取消后的交付;后台不操作 VM 对象。
|
||||
pub(crate) mod io_tasks;
|
||||
/// 维护 owner/key 任务身份、定时器、协作执行与 await 依赖,统一处理替换和取消。
|
||||
pub(crate) mod tasks;
|
||||
/// 封装可恢复 VM 工作的推进次序,使源布局/绘制在预算内保留同一续体而不重放。
|
||||
pub(crate) mod vm_sequence;
|
||||
|
||||
+63
-4
@@ -20,11 +20,13 @@ use endor_core::{
|
||||
|
||||
use crate::{block::Block, mount::Mount, ui_bridge::desktop_type, window::ManagedWindow};
|
||||
|
||||
// 普通对象的私有任务字典属性名;Block/Mount/Window 则把同一拥有关系保存在宿主 payload。
|
||||
const SCOPE: &str = "\0tessera.tasks";
|
||||
const MAX_TASKS: usize = 1024;
|
||||
const MAX_OWNER_TASKS: usize = 64;
|
||||
const MAX_READY: usize = 64;
|
||||
|
||||
// 调度器只保存弱任务身份,不因排队把任务、回调或 owner 隐式保活。
|
||||
type Index = Arc<Mutex<Vec<WeakObjectRef>>>;
|
||||
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
@@ -52,17 +54,22 @@ impl State {
|
||||
#[derive(Debug, Clone)]
|
||||
/// 托管异步对象,保存 owner/key、结果与真正拥有的回调/协程/等待引用。
|
||||
struct Task {
|
||||
// owner 通过 scope 字典强持有 Task,Task 反向弱引用 owner,避免任务把已关闭页面永久保活。
|
||||
owner: WeakObjectRef,
|
||||
key: String,
|
||||
// 单调时钟截止点;ready 与到期是两个独立条件,I/O 完成不受系统日期调整影响。
|
||||
due: Instant,
|
||||
callback: Option<ObjectRef>,
|
||||
state: State,
|
||||
// 定时/协作任务创建即 ready,但仍等 due;I/O 任务等 provider 结果写回后才 ready。
|
||||
ready: bool,
|
||||
text: Option<Arc<str>>,
|
||||
error: Option<Arc<str>>,
|
||||
// 仅任务 payload 持有 I/O 租约;取消/终态清除此边即可撤销后台交付并归还额度。
|
||||
lease: Option<Arc<crate::io_tasks::Lease>>,
|
||||
cooperative: bool,
|
||||
coroutine: Option<ObjectRef>,
|
||||
// 协程 await 的对象是真实托管强边;等待期间由它保活被等待值,不以弱调度索引代替。
|
||||
waiting: Option<ObjectRef>,
|
||||
result: Option<Value>,
|
||||
}
|
||||
@@ -83,6 +90,7 @@ impl ObjectPayload for Task {
|
||||
fn poll_await(&self) -> Result<endor_core::AwaitPoll, VmError> {
|
||||
match self.state {
|
||||
State::Pending | State::Running => Ok(endor_core::AwaitPoll::Pending),
|
||||
// 协作任务优先返回保存的任意 Value,I/O 返回 text,普通定时器默认为 Nil。
|
||||
State::Completed => Ok(endor_core::AwaitPoll::Ready(
|
||||
self.result.clone().unwrap_or_else(|| {
|
||||
self.text
|
||||
@@ -126,6 +134,7 @@ fn object(value: &Value) -> Result<ObjectRef, VmError> {
|
||||
}
|
||||
/// 取得 owner 关联的托管任务作用域,供 key 替换和取消使用。
|
||||
fn scope(store: &ObjectStore, owner: ObjectRef) -> Result<Option<ObjectRef>, VmError> {
|
||||
// scope 的位置依 owner 类别而异;普通对象即使使用私有属性,也要验证该值确为字典。
|
||||
let payload = store.object(owner)?.payload();
|
||||
if let Some(value) = payload.as_any().downcast_ref::<Block>() {
|
||||
return Ok(value.tasks);
|
||||
@@ -153,6 +162,7 @@ fn install_scope(
|
||||
owner: ObjectRef,
|
||||
scope: ObjectRef,
|
||||
) -> Result<(), VmError> {
|
||||
// 宿主 payload 通过 replace_payload 建立受 GC 追踪的强边,普通对象通过 set_attr;均不能绕过写屏障。
|
||||
let payload = cx.store().object(owner)?.payload();
|
||||
if let Some(value) = payload.as_any().downcast_ref::<Block>() {
|
||||
let mut value = value.clone();
|
||||
@@ -178,6 +188,7 @@ fn eligible(store: &ObjectStore, owner: ObjectRef, desktop: ObjectRef) -> Result
|
||||
if !mount.mounted {
|
||||
return Ok(false);
|
||||
}
|
||||
// Mount 仅 mounted 不足以交付,所属 Page 还必须在某个活动窗口页面注册表里,关闭再打开不能恢复旧任务。
|
||||
if let Some(page) = mount.page {
|
||||
// No retained root is needed for this synchronous borrowed lookup.
|
||||
let windows = object(&store.get_attr(desktop, "windows")?)?;
|
||||
@@ -192,6 +203,7 @@ fn eligible(store: &ObjectStore, owner: ObjectRef, desktop: ObjectRef) -> Result
|
||||
}
|
||||
return Ok(false);
|
||||
}
|
||||
// 窗口 owner 要求未 closed;Page owner 要求仍注册,普通非页面业务 owner 没有额外展示资格要求。
|
||||
if let Some(window) = payload.as_any().downcast_ref::<ManagedWindow>() {
|
||||
return Ok(!window.closed);
|
||||
}
|
||||
@@ -218,6 +230,7 @@ fn current(
|
||||
reference: ObjectRef,
|
||||
task: &Task,
|
||||
) -> Result<bool, VmError> {
|
||||
// key 指向的对象必须恰是当前 Task,替换后旧 Task 即使还被外部持有,也不能接收结果或执行回调。
|
||||
Ok(match scope(store, owner)? {
|
||||
Some(scope) => {
|
||||
store.dict_get(scope, &Value::Text(task.key.clone()))? == Some(Value::Object(reference))
|
||||
@@ -233,6 +246,7 @@ pub fn cancel_owner(cx: &mut NativeContext<'_>, owner: ObjectRef) -> Result<(),
|
||||
let Some(scope) = scope(cx.store(), owner)? else {
|
||||
return Ok(());
|
||||
};
|
||||
// 克隆条目后逐个变更字典;取消 pending/running 的执行边,再删除所有 owner/key 拥有边。
|
||||
for (key, value) in cx.store().dict_items(scope)?.to_vec() {
|
||||
let reference = object(&value)?;
|
||||
let mut task = cx.store().payload::<Task>(reference, "Task")?.clone();
|
||||
@@ -276,13 +290,14 @@ impl NativeCallable for After {
|
||||
fn signature(&self) -> Option<endor_core::CallSignature> {
|
||||
Some(self.signature.clone())
|
||||
}
|
||||
/// 声明宿主可调用对象接受的参数个数,供 VM 在执行前检查。
|
||||
/// 直接使用创建时准备的 after/sleep/readText/fetchText/spawn 签名数量,和具体 API 一致。
|
||||
fn arity(&self) -> Option<endor_core::CallArity> {
|
||||
Some(self.signature.arity)
|
||||
}
|
||||
|
||||
/// VM 调入本宿主能力的入口;按所属操作解码参数并返回托管值或后续调用。
|
||||
/// 先拒绝退出或只读域的新工作,再解码 owner/key/提供方参数,取消同键旧任务并建立受作用域管理的新 Task。
|
||||
fn invoke(&self, cx: &mut NativeContext<'_>, args: &[Value]) -> Result<NativeResult, VmError> {
|
||||
// 退出域先拒绝新任务;只读渲染也禁止异步提交,即使某构造操作只分配新的任务对象。
|
||||
if self.quiescing.load(Ordering::Acquire) {
|
||||
return Err(invalid("runtime is exiting; new tasks are forbidden"));
|
||||
}
|
||||
@@ -291,6 +306,7 @@ impl NativeCallable for After {
|
||||
"asynchronous work is forbidden during read-only rendering",
|
||||
));
|
||||
}
|
||||
// 统一解码不同 API 参数:spawn 用零延时与回调,sleep 无回调,I/O 第三个位置是路径/URL。
|
||||
let zero = Value::Number(0_i64.into());
|
||||
let (owner, key, delay, callback) = match args {
|
||||
[owner, key, callback] if self.operation == Operation::Spawn => {
|
||||
@@ -311,6 +327,7 @@ impl NativeCallable for After {
|
||||
};
|
||||
let owner = object(owner)?;
|
||||
let callback = callback.map(object).transpose()?;
|
||||
// 所有回调都按零显式参数执行,必须是 Function 且参数元数据确认接受零参,不能等执行时再碰运气。
|
||||
if let Some(callback) = callback {
|
||||
if !cx.store().object(callback)?.payload().is_function() {
|
||||
return Err(invalid("task callback must be a Function"));
|
||||
@@ -327,6 +344,7 @@ impl NativeCallable for After {
|
||||
let Value::Text(key) = key else {
|
||||
return Err(invalid("task key must be text"));
|
||||
};
|
||||
// key 是 owner 内替换/取消身份,限制 UTF-8 字节长度与控制字符,禁止空 key。
|
||||
if key.is_empty() || key.len() > 128 || key.chars().any(char::is_control) {
|
||||
return Err(invalid("invalid task key"));
|
||||
}
|
||||
@@ -359,6 +377,7 @@ impl NativeCallable for After {
|
||||
"task delay must be an integer number of milliseconds",
|
||||
));
|
||||
};
|
||||
// 定时延迟要求整数毫秒,范围为零到一天;spawn 复用零延迟路径,禁止小数/负数。
|
||||
let milliseconds = delay
|
||||
.as_i64()
|
||||
.filter(|delay| (0..=86_400_000).contains(delay))
|
||||
@@ -370,6 +389,7 @@ impl NativeCallable for After {
|
||||
if !eligible(cx.store(), owner, self.desktop)? {
|
||||
return Err(invalid("task owner is closed or detached"));
|
||||
}
|
||||
// 在分配新任务前找同 key 旧身份,额度检查允许替换但不允许借其他 key 继续增加总量。
|
||||
let existing_scope = scope(cx.store(), owner)?;
|
||||
let previous = existing_scope
|
||||
.map(|scope| cx.store().dict_get(scope, &Value::Text(key.clone())))
|
||||
@@ -381,6 +401,7 @@ impl NativeCallable for After {
|
||||
.index
|
||||
.lock()
|
||||
.map_err(|_| invalid("task index poisoned"))?;
|
||||
// 提交时压缩弱索引,只保留还存活且 pending/running 的任务;终态不占调度名额。
|
||||
let mut live = Vec::new();
|
||||
for weak in index.iter().copied() {
|
||||
if let Some(task) = cx.upgrade(weak)?
|
||||
@@ -401,6 +422,7 @@ impl NativeCallable for After {
|
||||
{
|
||||
return Err(VmError::ExecutionLimit("64 pending tasks per owner"));
|
||||
}
|
||||
// 先分配并设置截止点/状态,再安装 I/O 租约和 owner 字典边;弱 owner 不承担保活作用。
|
||||
let task = cx.allocate(Task {
|
||||
owner: cx.store().downgrade(owner)?,
|
||||
key: key.clone(),
|
||||
@@ -423,6 +445,7 @@ impl NativeCallable for After {
|
||||
})?;
|
||||
cx.attach_type(task, desktop_type(cx.store(), "Task", self.desktop)?)?;
|
||||
if let Some(request) = request {
|
||||
// 只有旧任务仍待完成且真的持有 I/O 租约才使用 provider 临时替换额度,不给普通任务扩大 I/O 上限。
|
||||
let replacing = previous
|
||||
.map(|previous| {
|
||||
cx.store().payload::<Task>(previous, "Task").map(|task| {
|
||||
@@ -440,6 +463,7 @@ impl NativeCallable for After {
|
||||
cx.replace_payload(task, value)?;
|
||||
}
|
||||
|
||||
// 首次提交才安装字典;以后同 owner 复用 scope,key 替换始终在同一拥有表中发生。
|
||||
let task_scope = if let Some(scope) = existing_scope {
|
||||
scope
|
||||
} else {
|
||||
@@ -450,10 +474,12 @@ impl NativeCallable for After {
|
||||
// Publish the new identity before invalidating the old result. Nothing
|
||||
// external is dispatched until the worker accepts this VM generation.
|
||||
let previous_weak = previous.map(|old| cx.store().downgrade(old)).transpose()?;
|
||||
// 替换字典边前临时升级旧任务,避免 dict_set 删除最后拥有边后,清理旧 payload 时对象已被回收。
|
||||
if let Some(weak) = previous_weak {
|
||||
cx.upgrade(weak)?;
|
||||
}
|
||||
cx.dict_set(task_scope, Value::Text(key.clone()), Value::Object(task))?;
|
||||
// 新 key 身份登记成功后再将旧任务取消,切断回调/协程/等待/结果与 I/O 租约,晚到结果不得复活。
|
||||
if let Some(previous) = previous {
|
||||
// The replacement above can release the old Task's last owner edge.
|
||||
// Preserve it through the replacement even without a saved token.
|
||||
@@ -472,6 +498,7 @@ impl NativeCallable for After {
|
||||
}
|
||||
}
|
||||
let weak = cx.store().downgrade(task)?;
|
||||
// 弱索引也移除被替换身份;spawn 额外设置 runnable 唤醒标志,使外层知道存在可推进协程。
|
||||
live.retain(|old| Some(*old) != previous_weak);
|
||||
live.push(weak);
|
||||
*index = live;
|
||||
@@ -503,13 +530,14 @@ impl NativeCallable for Method {
|
||||
fn signature(&self) -> Option<endor_core::CallSignature> {
|
||||
Some(self.signature.clone())
|
||||
}
|
||||
/// 声明宿主可调用对象接受的参数个数,供 VM 在执行前检查。
|
||||
/// Task 方法无显式参数;底层调用包含唯一一个隐式 Task 接收者。
|
||||
fn arity(&self) -> Option<endor_core::CallArity> {
|
||||
Some(endor_core::CallArity::exact(1))
|
||||
}
|
||||
|
||||
/// VM 调入本宿主能力的入口;按所属操作解码参数并返回托管值或后续调用。
|
||||
/// 验证 Task 接收者并按当前状态处理 status/active/result/error/cancel;仍活跃的任务需重新确认 owner/key 身份。
|
||||
fn invoke(&self, cx: &mut NativeContext<'_>, args: &[Value]) -> Result<NativeResult, VmError> {
|
||||
// 方法无显式参数,实际 args 唯一一项是隐式 Task 接收者。
|
||||
let [value] = args else {
|
||||
return Err(invalid("Task methods accept no arguments"));
|
||||
};
|
||||
@@ -528,6 +556,7 @@ impl NativeCallable for Method {
|
||||
false
|
||||
};
|
||||
let value = match self.query {
|
||||
// pending/running 但已失去 owner/key 资格时,对源报告 cancelled;只读查询不因此改写 payload。
|
||||
Query::Status => Value::Text(
|
||||
if pending && !active {
|
||||
State::Cancelled.name()
|
||||
@@ -537,6 +566,7 @@ impl NativeCallable for Method {
|
||||
.into(),
|
||||
),
|
||||
Query::Active => Value::Bool(active),
|
||||
// I/O 回调执行期间可读取已保存 text;协作任务必须真正 Completed 才能读最终 result,错误任务不返回成功值。
|
||||
Query::Result => {
|
||||
if !matches!(task.state, State::Running | State::Completed)
|
||||
|| task.error.is_some()
|
||||
@@ -570,6 +600,7 @@ impl NativeCallable for Method {
|
||||
if pending {
|
||||
task.state = State::Cancelled;
|
||||
task.callback = None;
|
||||
// 回调开始前释放 I/O 名额,已收到的 text 仍留在任务内,可由回调查询。
|
||||
task.lease = None;
|
||||
task.coroutine = None;
|
||||
task.waiting = None;
|
||||
@@ -583,6 +614,7 @@ impl NativeCallable for Method {
|
||||
cx.dict_delete(scope, &Value::Text(task.key))?;
|
||||
}
|
||||
}
|
||||
// 返回本次是否取消了仍有效的待执行任务;重复 cancel 或已失去资格的任务返回 false。
|
||||
Value::Bool(pending && active)
|
||||
}
|
||||
};
|
||||
@@ -601,6 +633,7 @@ pub struct Scheduler {
|
||||
impl Scheduler {
|
||||
/// 停止接收该域的新任务工作,为关闭/替换运行时做准备。
|
||||
pub fn quiesce(&self, vm: &mut Vm) -> Result<usize> {
|
||||
// 先设置不可逆的退出门闩再取消全部任务,防止清理回调间隙继续接收新工作。
|
||||
self.quiescing.store(true, Ordering::Release);
|
||||
self.cancel_all(vm)
|
||||
}
|
||||
@@ -615,6 +648,7 @@ impl Scheduler {
|
||||
anyhow::ensure!((1..=MAX_READY).contains(&limit), "invalid task poll limit");
|
||||
// Provider threads only fill the mailbox. Only this VM worker updates
|
||||
// managed payloads, and delivery below rechecks owner/key generation.
|
||||
// provider 只产纯数据,VM worker 此处重新核对任务 pending、租约仍在、owner 有效且 key 仍当前。
|
||||
for (weak, completion) in self.provider.take_ready()? {
|
||||
if let Some(reference) = vm.upgrade(weak)? {
|
||||
let result = (|| -> Result<()> {
|
||||
@@ -637,6 +671,7 @@ impl Scheduler {
|
||||
if !active? {
|
||||
return Ok(());
|
||||
}
|
||||
// 收到后台结果只设置 ready/text/error,实际终态与回调交付由下面的有界调度扫描决定。
|
||||
task.ready = true;
|
||||
match completion {
|
||||
Ok(text) => task.text = Some(text.into()),
|
||||
@@ -654,6 +689,7 @@ impl Scheduler {
|
||||
.lock()
|
||||
.map_err(|_| anyhow::anyhow!("task index poisoned"))?
|
||||
.clone();
|
||||
// 本轮使用同一 now 判断到期,避免长回调执行后在同轮无限吸收后来才到期的定时器。
|
||||
let now = Instant::now();
|
||||
let mut work = 0;
|
||||
let mut advanced = Vec::new();
|
||||
@@ -677,10 +713,12 @@ impl Scheduler {
|
||||
} else {
|
||||
false
|
||||
};
|
||||
// owner 回收、页面关闭或 key 被替换都使任务取消;取消也计一次 work,避免清理无限占用一轮。
|
||||
if !active {
|
||||
work += 1;
|
||||
return finish(vm, reference, State::Cancelled);
|
||||
}
|
||||
// 被等待对象未就绪则不消费量子;被取消会取消等待者,失败等其他结果交回协程 await 语义处理。
|
||||
if let Some(waiting) = task.waiting {
|
||||
match vm.object(waiting)?.payload().poll_await() {
|
||||
Ok(endor_core::AwaitPoll::Pending) => return Ok(()),
|
||||
@@ -695,7 +733,9 @@ impl Scheduler {
|
||||
return Ok(());
|
||||
}
|
||||
work += 1;
|
||||
// 记录实际推进的任务,轮末移到索引尾部,保证一回调空闲预算下仍能轮转多个协程。
|
||||
advanced.push(weak);
|
||||
// spawn 使用可恢复协程而非普通 call;其余 I/O/定时器回调作为一次完整有界调用执行。
|
||||
if task.cooperative {
|
||||
return advance_coroutine(vm, reference);
|
||||
}
|
||||
@@ -725,6 +765,7 @@ impl Scheduler {
|
||||
.map_err(|error| crate::endor_host::runtime_error(vm, error));
|
||||
match result {
|
||||
Ok(value) => {
|
||||
// 普通异步回调契约要求 Unit;先释放实际返回值,再把不符合契约的回调标失败并向外报告。
|
||||
let unit = matches!(value, Value::Nil);
|
||||
vm.release_value(value)?;
|
||||
if !unit {
|
||||
@@ -761,6 +802,7 @@ impl Scheduler {
|
||||
index.retain(|weak| !advanced.contains(weak));
|
||||
index.extend(advanced);
|
||||
}
|
||||
// 轮末移除终态/死亡任务并重算 runnable,等待外部 I/O 的任务不应导致忙轮询协程。
|
||||
self.prune(vm)?;
|
||||
Ok(work)
|
||||
}
|
||||
@@ -782,6 +824,7 @@ impl Scheduler {
|
||||
.index
|
||||
.lock()
|
||||
.map_err(|_| anyhow::anyhow!("task index poisoned"))?;
|
||||
// cancel_all 返回清空前索引项数,包含升级失败的弱项,不能等同于实际执行过的回调数。
|
||||
let count = index.len();
|
||||
index.clear();
|
||||
self.runnable.store(false, Ordering::Release);
|
||||
@@ -799,6 +842,7 @@ impl Scheduler {
|
||||
if let Some(task) = vm.upgrade(weak)? {
|
||||
let pending = vm.payload::<Task>(task, "Task").map(|task| {
|
||||
let pending = matches!(task.state, State::Pending | State::Running);
|
||||
// 可运行标记仅针对协作任务:无等待对象可立即推进,有等待对象则看其 poll_await 是否不再 Pending。
|
||||
runnable |= pending && task.cooperative && task.waiting.is_none();
|
||||
pending
|
||||
});
|
||||
@@ -828,6 +872,7 @@ impl Scheduler {
|
||||
fn cyclic_wait(vm: &Vm, source: ObjectRef, mut target: ObjectRef) -> Result<bool> {
|
||||
let mut seen = std::collections::HashSet::new();
|
||||
loop {
|
||||
// 等待链到达 source 或重复已有目标都表示环;不是 Task 或没有 waiting 边时链终止,不判环。
|
||||
if target == source || !seen.insert(target) {
|
||||
return Ok(true);
|
||||
}
|
||||
@@ -844,6 +889,7 @@ fn cyclic_wait(vm: &Vm, source: ObjectRef, mut target: ObjectRef) -> Result<bool
|
||||
/// 恢复已保存的源函数帧,处理完成、软量子挂起或 await 等待,保留已发生的副作用。
|
||||
fn advance_coroutine(vm: &mut Vm, reference: ObjectRef) -> Result<()> {
|
||||
let mut task = vm.payload::<Task>(reference, "Task")?.clone();
|
||||
// 首次推进把 callback 转成托管 Coroutine,后续复用同一帧与预算,不重放已发生的源副作用。
|
||||
let coroutine = if let Some(coroutine) = task.coroutine {
|
||||
coroutine
|
||||
} else {
|
||||
@@ -868,6 +914,7 @@ fn advance_coroutine(vm: &mut Vm, reference: ObjectRef) -> Result<()> {
|
||||
}
|
||||
};
|
||||
// Native preparation can itself cancel or replace this Task.
|
||||
// 准备 coroutine 期间原生代码也可能取消/替换任务,必须重读当前状态,不能把旧 task 副本覆盖回去。
|
||||
let current = vm.payload::<Task>(reference, "Task")?.state;
|
||||
if !matches!(current, State::Pending | State::Running) {
|
||||
vm.release(coroutine)?;
|
||||
@@ -876,16 +923,19 @@ fn advance_coroutine(vm: &mut Vm, reference: ObjectRef) -> Result<()> {
|
||||
task.state = State::Running;
|
||||
task.callback = None;
|
||||
task.coroutine = Some(coroutine);
|
||||
// 先由 payload 建立协程拥有边,再释放创建根;安装失败也尝试释放局部根。
|
||||
let installed = vm.replace_payload(reference, task);
|
||||
vm.release(coroutine)?;
|
||||
installed?;
|
||||
coroutine
|
||||
};
|
||||
let result = vm
|
||||
// 每次最多执行 256 指令软量子,达到量子时仅挂起;总 100000 指令上限仍由协程本身累计。
|
||||
.resume_coroutine(coroutine, 256)
|
||||
.map_err(|error| crate::endor_host::runtime_error(vm, error));
|
||||
// Cancellation/replacement from the running function must win. A completed
|
||||
// value still owns a root and must be released even when delivery is stale.
|
||||
// 源代码运行期间可取消自身,取消/替换优先于本轮完成;完成值即使不交付也必须释放其拥有根。
|
||||
let active = matches!(
|
||||
vm.payload::<Task>(reference, "Task")?.state,
|
||||
State::Pending | State::Running
|
||||
@@ -895,6 +945,7 @@ fn advance_coroutine(vm: &mut Vm, reference: ObjectRef) -> Result<()> {
|
||||
if !active {
|
||||
return Ok(());
|
||||
}
|
||||
// 登记等待强边前检查依赖环,拒绝永不满足的互相 await,并把当前任务转失败。
|
||||
if cyclic_wait(vm, reference, awaitable)? {
|
||||
fail_callback(vm, reference, "cyclic task await")?;
|
||||
bail!("cyclic task await");
|
||||
@@ -904,6 +955,7 @@ fn advance_coroutine(vm: &mut Vm, reference: ObjectRef) -> Result<()> {
|
||||
vm.replace_payload(reference, task)?;
|
||||
Ok(())
|
||||
}
|
||||
// 软量子挂起不代表等待外部值,清 waiting 后下一轮仍视作可运行。
|
||||
Ok(endor_core::CoroutineProgress::Pending { .. }) => {
|
||||
if active {
|
||||
let mut task = vm.payload::<Task>(reference, "Task")?.clone();
|
||||
@@ -918,6 +970,7 @@ fn advance_coroutine(vm: &mut Vm, reference: ObjectRef) -> Result<()> {
|
||||
return Ok(());
|
||||
}
|
||||
let mut task = vm.payload::<Task>(reference, "Task")?.clone();
|
||||
// 结果先写入受 trace 管理的 payload,再释放 VM 返回值根,最后 finish 清执行边但保留成功结果。
|
||||
task.result = Some(value.clone());
|
||||
task.waiting = None;
|
||||
let stored = vm.replace_payload(reference, task);
|
||||
@@ -937,6 +990,7 @@ fn advance_coroutine(vm: &mut Vm, reference: ObjectRef) -> Result<()> {
|
||||
/// 记录回调执行失败并沿运行时故障规则停止后续不安全的交付。
|
||||
fn fail_callback(vm: &mut Vm, reference: ObjectRef, message: &str) -> Result<()> {
|
||||
let mut task = vm.payload::<Task>(reference, "Task")?.clone();
|
||||
// 错误预览按字符限长,保证 UTF-8 完整;记录后统一走终态清理而非保留失败协程。
|
||||
task.error = Some(message.chars().take(1024).collect::<String>().into());
|
||||
vm.replace_payload(reference, task)?;
|
||||
finish(vm, reference, State::Failed)
|
||||
@@ -948,6 +1002,7 @@ fn finish(vm: &mut Vm, reference: ObjectRef, state: State) -> Result<()> {
|
||||
if !matches!(task.state, State::Pending | State::Running) {
|
||||
return Ok(());
|
||||
}
|
||||
// finish 只允许从 pending/running 转终态,重复调用不改变既有 Completed/Cancelled/Failed 的语义。
|
||||
task.state = state;
|
||||
task.callback = None;
|
||||
task.lease = None;
|
||||
@@ -960,6 +1015,7 @@ fn finish(vm: &mut Vm, reference: ObjectRef, state: State) -> Result<()> {
|
||||
vm.replace_payload(reference, task.clone())?;
|
||||
if let Some(owner) = vm.upgrade(task.owner)? {
|
||||
let result = (|| -> Result<()> {
|
||||
// 只有 key 仍指向本任务才删 owner 边,避免旧任务结束时误删同 key 新任务。
|
||||
if current(vm.object_store(), owner, reference, &task)?
|
||||
&& let Some(scope) = scope(vm.object_store(), owner)?
|
||||
{
|
||||
@@ -980,6 +1036,7 @@ pub fn install(
|
||||
ui: ObjectRef,
|
||||
desktop: ObjectRef,
|
||||
) -> Result<Scheduler> {
|
||||
// 每个运行时一份弱索引、可运行/退出标记和 provider mailbox,UI API 与 Scheduler 共享这些原生状态。
|
||||
let index = Arc::new(Mutex::new(Vec::new()));
|
||||
let runnable = Arc::new(AtomicBool::new(false));
|
||||
let quiescing = Arc::new(AtomicBool::new(false));
|
||||
@@ -1017,6 +1074,7 @@ pub fn install(
|
||||
endor_core::CallEffect::Mutating
|
||||
},
|
||||
);
|
||||
// I/O 可带可选回调;spawn 去掉延时参数,sleep 去掉回调参数,保留各自正确 arity。
|
||||
if external {
|
||||
signature.arity = endor_core::CallArity::range(3, 4);
|
||||
}
|
||||
@@ -1040,6 +1098,7 @@ pub fn install(
|
||||
roots.push(function);
|
||||
vm.set_attr(ui, name, Value::Object(function))?;
|
||||
}
|
||||
// Task 类型安装 cancel/status/active/result/error:只有 cancel 声明 Mutating,其余只读查询。
|
||||
for (name, query) in [
|
||||
("cancel", Query::Cancel),
|
||||
("status", Query::Status),
|
||||
|
||||
@@ -7,13 +7,17 @@ use endor_core::{
|
||||
VmError,
|
||||
};
|
||||
|
||||
/// 根据当前输入构造本模块的派生结果,具体的验证与资源边界见函数内步骤。
|
||||
/// 将零参数调用列表编成一个托管驱动,按输入顺序执行,返回最后一次调用的值。
|
||||
/// 空列表返回 Nil。所有调用都在调用者的 VM 预算内运行,避免宿主逐个调用时重置预算。
|
||||
/// name 用于诊断位置;desktop 用来给生成函数挂接桌面 Function 类型。
|
||||
pub fn build(
|
||||
cx: &mut NativeContext<'_>,
|
||||
calls: Vec<ObjectRef>,
|
||||
name: &'static str,
|
||||
desktop: ObjectRef,
|
||||
) -> Result<ObjectRef, VmError> {
|
||||
// 每个函数放入常量池。LoadConst/PushNull/Call 组成零参数调用,
|
||||
// 中间结果由 PopTop 丢弃;最后结果留在栈顶交给 ReturnValue。
|
||||
let mut instructions = Vec::with_capacity(calls.len() * 4 + 2);
|
||||
let mut constants: Vec<Value> = calls.into_iter().map(Value::Object).collect();
|
||||
for index in 0..constants.len() {
|
||||
@@ -24,6 +28,7 @@ pub fn build(
|
||||
instructions.push(Instruction::simple(Opcode::PopTop));
|
||||
}
|
||||
}
|
||||
// 没有调用时也必须给 ReturnValue 提供合法栈顶,不能返回一个空栈。
|
||||
if constants.is_empty() {
|
||||
constants.push(Value::Nil);
|
||||
instructions.push(Instruction::new(Opcode::LoadConst, 0));
|
||||
@@ -47,6 +52,8 @@ pub fn repeat_call(
|
||||
name: &'static str,
|
||||
desktop: ObjectRef,
|
||||
) -> Result<ObjectRef, VmError> {
|
||||
// 回调返回 Bool;repeat_while 消费这个条件并决定是否跳回本帧开头。
|
||||
// 退出后显式返回 Nil,回调的继续条件不会泄露为驱动返回值。
|
||||
let mut instructions = vec![
|
||||
Instruction::new(Opcode::LoadConst, 0),
|
||||
Instruction::simple(Opcode::PushNull),
|
||||
@@ -77,6 +84,8 @@ pub fn collect_and_continue(
|
||||
name: &'static str,
|
||||
desktop: ObjectRef,
|
||||
) -> Result<ObjectRef, VmError> {
|
||||
// 常量布局固定为 collector、function、各实参、true。
|
||||
// 先把 collector 的调用前缀压栈,再执行 function,使其返回值直接成为 collector 的唯一实参。
|
||||
let count = arguments.len();
|
||||
let mut constants = vec![Value::Object(collector), Value::Object(function)];
|
||||
constants.extend(arguments);
|
||||
@@ -90,6 +99,7 @@ pub fn collect_and_continue(
|
||||
for index in 0..count {
|
||||
instructions.push(Instruction::new(Opcode::LoadConst, index as u32 + 2));
|
||||
}
|
||||
// 收集器返回值不参与外层调度;丢弃后返回 true,通知重复驱动继续取下一项。
|
||||
instructions.extend([
|
||||
Instruction::new(Opcode::Call, count as u32),
|
||||
Instruction::new(Opcode::Call, 1),
|
||||
@@ -121,8 +131,12 @@ fn driver(
|
||||
/// false falls through. Operand widths include EXTENDED_ARG code units.
|
||||
/// 构造由继续条件决定是否再执行一轮的同帧循环。
|
||||
pub fn repeat_while(instructions: &mut Vec<Instruction>) -> Result<(), VmError> {
|
||||
// 跳转单位是编码后的双字节 code unit,不是 Instruction 数量。
|
||||
// 大操作数会生成 EXTENDED_ARG,因此必须编码后计算实际长度。
|
||||
let body = Instruction::encode_all(instructions)?.len() / 2;
|
||||
let mut back = Instruction::new(Opcode::JumpBackward, 0);
|
||||
// 回跳距离包含自身宽度;而距离变大又可能扩大自身编码宽度。
|
||||
// 迭代到宽度/距离一致后,false 跳过回跳指令,true 回到整个驱动的起点。
|
||||
loop {
|
||||
let units = Instruction::encode_all(&[back])?.len() / 2;
|
||||
let distance = u32::try_from(body + 1 + units)
|
||||
@@ -141,7 +155,10 @@ mod tests {
|
||||
use super::*;
|
||||
use endor_core::{ExecutionLimits, Vm};
|
||||
#[test]
|
||||
/// 生成超过单字节跳距的循环,false 条件正常返回,true 条件只耗尽指令预算而非一帧预算;释放后对象数归零。
|
||||
fn repeated_bytecode_handles_extended_operands_and_keeps_one_frame() {
|
||||
// 300 个 Nop 强制跨越单字节跳转距离:false 应正常退出;true 应耗尽指令预算,
|
||||
// 而非耗尽帧预算,从而验证循环确实复用同一个执行帧。
|
||||
for condition in [false, true] {
|
||||
let mut instructions = vec![Instruction::simple(Opcode::Nop); 300];
|
||||
instructions.push(Instruction::new(Opcode::LoadConst, 0));
|
||||
@@ -177,6 +194,7 @@ mod tests {
|
||||
}
|
||||
vm.release(code).unwrap();
|
||||
vm.release(globals).unwrap();
|
||||
// 释放代码与全局字典后执行循环回收,确认生成的常量/函数没有遗留托管对象。
|
||||
vm.collect_cycles();
|
||||
assert_eq!(vm.object_count(), 0);
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user