2 Commits

Include renames

Author	SHA1	Message	Date
what	111665d2e7	fix: HasStatic 让 Stats 越用越偏；borrowStatic 漏标 scoped ... 两个都是静态调用那条路上的。 HasStatic 建了 VM 却不记丢弃。Created 在 load 里加（所有建 VM 的路径都走它）， Dropped 在 staticTarget.finish 里加，而 HasStatic 拿到 VM 后直接返回，不走 finish。每调一次 Created-Dropped 就永久 +1——Stats 是导出的观测结构，这个 偏差会直接体现在监控上。改成走同一套记账。 borrowStatic 同样会注入作用域扩展，却不设 vm.scoped。release 靠这个标志拒绝 把带扩展的 VM 放回池子，漏标就是跨调用泄漏。今天不出事只是因为 staticTarget.finish 永远丢弃——同一个约束靠两套机制守，以后有人把静态 VM 接进 release 就会漏。 测试： - Stats 那条断言「在飞的 VM 数」调用前后不变 - scoped 那条是**内部测试**，直接断言标志位。行为测试盖不住它——borrowStatic 那条路今天靠 finish 兜底，从外面看不出漏标 两条都做了破坏性验证，摘掉修复会红。 顺带把 WithTimeout 的文档补上一句：要新建 VM 的路径上是顶层和函数调用两段 各自计时，墙钟上限是 2×d。行为不改——两段各自计时是合理的，缺的只是说明。	2026-09-10 15:21:17 +08:00
what	0627d49425	feat: 嵌入式 JS 脚本引擎核心 ... 用 goja 承载业务回调，让业务逻辑变更不必重新编译发布 Go 程序。脚本用 ESM + TypeScript 写，Go 侧按名字把它们当普通对象实例化并调用方法。 主要组成： - Engine 编译脚本、管配置，公开 API 不暴露任何 goja 类型 - Script 一份编译好的脚本 + 它的 VM 池，热更新时整体顶替 - Instance 独占一个 VM 的实例，状态留在 JS 侧 - Caller 自定义调用约定，把脚本函数适配成 Go 侧要的签名 - Scope 让同一个 ctx 下的多个脚本共享 Go 侧对象 - Extension 扩展接口：给脚本添全局对象，配套 TS 类型 - Overlay 多层 Loader 叠加，后面的盖前面的 几个关键取舍： - 源码一律先过 esbuild 打包成 ESM，再改写成立即执行函数。goja 不认 import/export，而业务脚本要能拆文件、用 TypeScript。 - VM 池化复用，但每个 VM 单线程。goja 的 Runtime 不是 goroutine 安全的。 - Go 侧函数返回的 error 在脚本里表现为抛异常，不占返回值位置。 - 脚本能看见的全局只有白名单放行的那些，且注入是惰性的——没读到的 全局根本不会被转换。	2026-09-05 22:11:55 +08:00