docs: 清理命令行工具注释的私有简称

This commit is contained in:
2026-09-17 16:07:05 +00:00
parent d81777e8b2
commit c458f9541b
4 changed files with 9 additions and 9 deletions
+6 -6
View File
@@ -196,13 +196,13 @@ pub fn run_leak_detect(config: &BenchConfig, kernel: &Arc<KernelCore>, pool: &Ar
ExitCode::SUCCESS ExitCode::SUCCESS
} }
/// S1 校准用例:共享 kernel 下循环 3000 次「新建 VM → 跑微源 → drop」, /// vm_creation 校准用例:共享 kernel 下循环 3000 次「新建 VM → 跑微源 → drop」,
/// 每 100 次采一次 VmRSS,度量 VM 创建/销毁路径(含 session 收尾统一 /// 每 100 次采一次 VmRSS,度量 VM 创建/销毁路径(含 session 收尾统一
/// 释放)的内存增量,期望走平。 /// 释放)的内存增量,期望走平。
/// ///
/// # 注意事项 /// # 注意事项
/// 不走 VM 池:池的锁/condvar 噪音与本测面无关;出斜率先查 harness /// 不走 VM 池:池的锁/condvar 噪音与本用例观测面无关;出斜率先查 harness 污染
/// 污染(allocator 归还 OS 延迟),再疑收尾释放不全。 /// (基准脚手架自身引入的测量噪声,如 allocator 归还 OS 延迟),再疑收尾释放不全。
pub fn run_mem_vm_creation_leak(kernel: &Arc<KernelCore>) -> ExitCode { pub fn run_mem_vm_creation_leak(kernel: &Arc<KernelCore>) -> ExitCode {
const ITERATIONS: usize = 3000; const ITERATIONS: usize = 3000;
const SAMPLE_EVERY: usize = 100; const SAMPLE_EVERY: usize = 100;
@@ -302,7 +302,7 @@ pub fn run_mem_builtin_world_build(kernel: &Arc<KernelCore>) -> ExitCode {
ExitCode::SUCCESS ExitCode::SUCCESS
} }
/// S2 校准用例:单 VM 每轮「新键写脏 object/array/string 三家族原型 → /// dirty_rebuild 校准用例:单 VM 每轮「新键写脏 object/array/string 三家族原型 →
/// full_reset」,共 3000 轮,每 10 轮采一次 VmRSS,输出选择性重建释放 /// full_reset」,共 3000 轮,每 10 轮采一次 VmRSS,输出选择性重建释放
/// 路径的每轮内存增量(斜率 + 窗口总增量)。 /// 路径的每轮内存增量(斜率 + 窗口总增量)。
/// ///
@@ -458,7 +458,7 @@ pub fn run_mem_closure_dead_leak(kernel: &Arc<KernelCore>) -> ExitCode {
/// # 注意事项 /// # 注意事项
/// 不走 VM 池:drop clean 路径与池内归还走同一 `full_reset`,池锁/condvar /// 不走 VM 池:drop clean 路径与池内归还走同一 `full_reset`,池锁/condvar
/// 噪音与本测面无关。重源瞬时对象全 epoch 分配、不逃逸 global;锚 == 0 为 /// 噪音与本测面无关。重源瞬时对象全 epoch 分配、不逃逸 global;锚 == 0 为
/// 确定性主门槛(in-engine,免分配器噪音),RSS 为次锚(进程级,仅判 /// 确定性主门槛(in-engine,免分配器噪音),RSS 序列为次锚(进程级辅助指标,
/// 峰后无新增量——归还 chunk 可能滞留分配器自由链不回 OS,不要求回落 /// 峰后无新增量——归还 chunk 可能滞留分配器自由链不回 OS,不要求回落
/// 峰前)。 /// 峰前)。
pub fn run_mem_pool_high_water(kernel: &Arc<KernelCore>) -> ExitCode { pub fn run_mem_pool_high_water(kernel: &Arc<KernelCore>) -> ExitCode {
@@ -604,7 +604,7 @@ pub fn run_mem_object_churn_peak(kernel: &Arc<KernelCore>) -> ExitCode {
/// 生产字面量短串面)→ 11 采样点 [10k,15k,20k,30k,40k,60k,80k,100k, /// 生产字面量短串面)→ 11 采样点 [10k,15k,20k,30k,40k,60k,80k,100k,
/// 131072,160k,200k] 采 VmRSS。增长相斜率只记录不判定(append-only /// 131072,160k,200k] 采 VmRSS。增长相斜率只记录不判定(append-only
/// 增长,正斜率即预期签名,"斜率>0 即 fail" 契约不适用,独立打印逻辑, /// 增长,正斜率即预期签名,"斜率>0 即 fail" 契约不适用,独立打印逻辑,
/// 不进 `report_series`);重建相验"无存活 VM"边界重建:键数超阈值 → /// 不进 `report_series`);重建相(drop 旧 kernel 重建新 kernel)验"无存活 VM"边界重建:键数超阈值 →
/// `should_rebuild_perm` 返回 `Some(建议上限)`(阈值取 2 的幂后加倍)→ /// `should_rebuild_perm` 返回 `Some(建议上限)`(阈值取 2 的幂后加倍)→
/// drop 旧 kernel → 新 kernel 严格主锚 `entry_count` 恰 0 + 旋钮 `None`。 /// drop 旧 kernel → 新 kernel 严格主锚 `entry_count` 恰 0 + 旋钮 `None`。
/// ///
+1 -1
View File
@@ -36,7 +36,7 @@ pub fn run_benchmarks(config: BenchConfig, kernel: Arc<KernelCore>, pool: Arc<Vm
match config.mode.as_str() { match config.mode.as_str() {
"js" => js_stress::run_js_stress_bench(&config, &kernel, &pool), "js" => js_stress::run_js_stress_bench(&config, &kernel, &pool),
"rust" => rust_bench::run_rust_bench(config.filter.as_deref()), "rust" => rust_bench::run_rust_bench(config.filter.as_deref()),
// leak 模式内按 case 过滤参数分派校准用例;缺省保持原泄漏检测行为。 // leak 模式按 case 过滤参数分派校准用例;无匹配 case 时跑默认的固定脚本内存回归(run_leak_detect)。
"leak" => match config.filter.as_deref() { "leak" => match config.filter.as_deref() {
Some("vm_creation") => leak_detect::run_mem_vm_creation_leak(&kernel), Some("vm_creation") => leak_detect::run_mem_vm_creation_leak(&kernel),
Some("builtin_world_build") => leak_detect::run_mem_builtin_world_build(&kernel), Some("builtin_world_build") => leak_detect::run_mem_builtin_world_build(&kernel),
+1 -1
View File
@@ -16,7 +16,7 @@ const MEMORY_BENCH_NOTES: &str = "\n内存基准用例(mem_*):\n
mem_set_retain 原生盒边持有:Set 持 20000 个对象(各带 payload 字符串) mem_set_retain 原生盒边持有:Set 持 20000 个对象(各带 payload 字符串)
mem_string_rope 拼接 rope 链留存:重复二元拼接形成深 Cons 链(账目按逻辑长度计,数值高于实际足迹) mem_string_rope 拼接 rope 链留存:重复二元拼接形成深 Cons 链(账目按逻辑长度计,数值高于实际足迹)
口径:Peak B/Ret B 为 session 堆账目(对象头 + 堆数据 + 存活串/BigInt);epoch arena 口径:Peak B/Ret B 为 session 堆账目(对象头 + 堆数据 + 存活串/BigInt);epoch arena
的临时驻留无字节账目(既有口径,数量见 JSON 的 epoch_objects)。Peak B 为顶层指令 的临时驻留不计入字节账目(数量见 JSON 的 epoch_objects)。Peak B 为顶层指令
边界采样的 session arena 高水位;单指令内瞬态与 epoch 高水位不计。Ret B 为 workload 后 边界采样的 session arena 高水位;单指令内瞬态与 epoch 高水位不计。Ret B 为 workload 后
晋升 + 完整 GC 的真存活集,至多含一份引擎内部副本:逃逸屏障留 epoch 原件且顶层 晋升 + 完整 GC 的真存活集,至多含一份引擎内部副本:逃逸屏障留 epoch 原件且顶层
寄存器根不回写时,测量时晋升会把原件再克隆一份(object_graph 见留存锚测试)。 寄存器根不回写时,测量时晋升会把原件再克隆一份(object_graph 见留存锚测试)。
+1 -1
View File
@@ -395,7 +395,7 @@ fn repl() -> ExitCode {
input_buf.clear(); input_buf.clear();
if result == ExitCode::FAILURE { if result == ExitCode::FAILURE {
// eval_repl already printed error; keep buffer cleared. // eval_repl 已打印错误,此处仅保持缓冲区已清空,避免重复输出。
} }
} }
Err(ReadlineError::Interrupted) => { Err(ReadlineError::Interrupted) => {