mirror of
https://github.com/pjh456/OxideJS.git
synced 2026-10-24 10:41:11 +08:00
103 lines
3.7 KiB
Rust
103 lines
3.7 KiB
Rust
//! kernel 运行配置：VM 池规模、步数/调用深度/单 run 分配上限、session GC 阈值、
|
||
//! perm interner 重建阈值、日志级别（三预设 minimal/standard/full）。
|
||
|
||
use oxide_log::{Level, SUBSYSTEM_COUNT};
|
||
|
||
/// kernel 运行配置：VM 池规模、步数/调用深度/单 run 分配上限、session GC 阈值、
|
||
/// perm interner 重建阈值、日志级别。由三个预设构造器
|
||
/// （[`KernelConfig::minimal`] / [`KernelConfig::standard`] / [`KernelConfig::full`]）
|
||
/// 或默认值创建。
|
||
#[derive(Clone)]
|
||
pub struct KernelConfig {
|
||
pub min_pool_size: usize,
|
||
pub max_pool_size: Option<usize>,
|
||
/// perm interner 建议重建阈值：唯一键数 `entry_count` **超过**该值时，
|
||
/// 宿主应在安全边界（无存活 VM）整体重建 kernel，并把
|
||
/// [`crate::kernel::KernelCore::should_rebuild_perm`] 返回的建议上限写入新 kernel 配置；
|
||
/// None = 无阈值（三个预设默认值，行为与无旋钮一致）。
|
||
/// 见 [`crate::kernel::KernelCore::should_rebuild_perm`]。
|
||
pub perm_interner_max_entries: Option<u32>,
|
||
pub max_steps: Option<u64>,
|
||
/// 单次 run 的分配上限（epoch + session arena + session 堆账目字节）：
|
||
/// 超限的 run 以 `VM memory limit exceeded` 失败，防单测试 arena 高水位
|
||
/// 拖垮宿主内存。None 为无上限（CLI/嵌入默认；runner 按场景设置）。
|
||
pub max_alloc_bytes: Option<usize>,
|
||
pub max_call_depth: usize,
|
||
pub session_gc_threshold: usize,
|
||
pub max_cached_modules: usize,
|
||
pub log_levels: [Level; SUBSYSTEM_COUNT],
|
||
}
|
||
|
||
impl KernelConfig {
|
||
/// 最小配置：小 VM 池，适合嵌入式或单次执行场景。
|
||
pub fn minimal() -> Self {
|
||
Self {
|
||
min_pool_size: 4,
|
||
max_pool_size: Some(8),
|
||
perm_interner_max_entries: None,
|
||
max_steps: None,
|
||
max_alloc_bytes: None,
|
||
max_call_depth: 1024,
|
||
session_gc_threshold: 4_194_304,
|
||
max_cached_modules: 512,
|
||
log_levels: [Level::Off; SUBSYSTEM_COUNT],
|
||
}
|
||
}
|
||
|
||
/// 标准配置：默认 VM 池大小，池构造时同步预热 min_pool_size 个 Vm。
|
||
pub fn standard() -> Self {
|
||
Self {
|
||
min_pool_size: 1,
|
||
max_pool_size: Some(32),
|
||
perm_interner_max_entries: None,
|
||
max_steps: None,
|
||
max_alloc_bytes: None,
|
||
max_call_depth: 1024,
|
||
session_gc_threshold: 4_194_304,
|
||
max_cached_modules: 512,
|
||
log_levels: [Level::Off; SUBSYSTEM_COUNT],
|
||
}
|
||
}
|
||
|
||
/// 全量配置：无上限 VM 池，为性能场景服务。
|
||
pub fn full() -> Self {
|
||
Self {
|
||
min_pool_size: 16,
|
||
max_pool_size: None,
|
||
perm_interner_max_entries: None,
|
||
max_steps: None,
|
||
max_alloc_bytes: None,
|
||
max_call_depth: 1024,
|
||
session_gc_threshold: 4_194_304,
|
||
max_cached_modules: 512,
|
||
log_levels: [Level::Off; SUBSYSTEM_COUNT],
|
||
}
|
||
}
|
||
|
||
/// 读取 session GC 阈值（字节数）。
|
||
pub fn session_gc_threshold(&self) -> usize {
|
||
self.session_gc_threshold
|
||
}
|
||
|
||
/// 设置 session GC 阈值（字节数），超过后触发一次 session 级 GC。
|
||
pub fn set_session_gc_threshold(&mut self, bytes: usize) {
|
||
self.session_gc_threshold = bytes;
|
||
}
|
||
|
||
/// 读取 code cache 的 module 数量上限。
|
||
pub fn max_cached_modules(&self) -> usize {
|
||
self.max_cached_modules
|
||
}
|
||
|
||
/// 设置 code cache 的 module 数量上限。
|
||
pub fn set_max_cached_modules(&mut self, cap: usize) {
|
||
self.max_cached_modules = cap;
|
||
}
|
||
}
|
||
|
||
impl Default for KernelConfig {
|
||
fn default() -> Self {
|
||
Self::minimal()
|
||
}
|
||
}
|