Struct LuaRuntimeHostOptions 

pub struct LuaRuntimeHostOptions {

    pub runtime_root: Option<PathBuf>,
    pub managed_runtime_distribution_root: Option<PathBuf>,
    pub managed_runtime_environment_root: Option<PathBuf>,
    pub managed_runtime_config: LuaRuntimeManagedRuntimeConfig,
    pub temp_dir: Option<PathBuf>,
    pub resources_dir: Option<PathBuf>,
    pub lua_packages_dir: Option<PathBuf>,
    pub host_provided_tool_root: Option<PathBuf>,
    pub host_provided_lua_root: Option<PathBuf>,
    pub host_provided_ffi_root: Option<PathBuf>,
    pub system_lua_lib_dir: Option<PathBuf>,
    pub download_cache_root: Option<PathBuf>,
    pub dependency_dir_name: String,
    pub state_dir_name: String,
    pub database_dir_name: String,
    pub skill_config_file_path: Option<PathBuf>,
    pub allow_network_download: bool,
    pub github_base_url: Option<String>,
    pub github_api_base_url: Option<String>,
    pub official_skill_hub_base_url: Option<String>,
    pub enable_private_url_skill_install: bool,
    pub private_skill_source_allowlist: Vec<String>,
    pub default_text_encoding: Option<String>,
    pub sqlite_library_path: Option<PathBuf>,
    pub sqlite_provider_mode: LuaRuntimeDatabaseProviderMode,
    pub sqlite_callback_mode: LuaRuntimeDatabaseCallbackMode,
    pub lancedb_library_path: Option<PathBuf>,
    pub lancedb_provider_mode: LuaRuntimeDatabaseProviderMode,
    pub lancedb_callback_mode: LuaRuntimeDatabaseCallbackMode,
    pub space_controller: LuaRuntimeSpaceControllerOptions,
    pub cache_config: Option<ToolCacheConfig>,
    pub runlua_pool_config: Option<LuaRuntimeRunLuaPoolConfig>,
    pub reserved_entry_names: Vec<String>,
    pub ignored_skill_ids: Vec<String>,
    pub capabilities: LuaRuntimeCapabilityOptions,
}

Host-provided filesystem and runtime paths consumed by the LuaSkills library. 宿主提供给 LuaSkills 库消费的文件系统与运行时路径集合。

Fields

runtime_root: Option<PathBuf>

Optional canonical LuaSkills runtime root used to derive the fixed runtime layout. 用于推导固定运行时布局的可选规范 LuaSkills 运行时根目录。

managed_runtime_distribution_root: Option<PathBuf>

Optional host-configured read-only root containing managed Python and Node distributions. 可选的宿主配置只读根目录，包含受管 Python 与 Node 发行包。

managed_runtime_environment_root: Option<PathBuf>

Optional host-configured writable root containing reusable managed environments. 可选的宿主配置可写根目录，包含可复用受管环境。

managed_runtime_config: LuaRuntimeManagedRuntimeConfig

Host-selected managed Python/Node worker and persistent-session resource policy. 宿主选择的受管 Python/Node Worker 与持久会话资源策略。

temp_dir: Option<PathBuf>

Host-managed temporary directory used by luaexec spill files and similar transient artifacts. 宿主管理的临时目录，供 luaexec 请求文件等短生命周期产物使用。

resources_dir: Option<PathBuf>

Optional host-managed resources directory exposed to Lua as vulcan.runtime.resources_dir. 以 vulcan.runtime.resources_dir 形式暴露给 Lua 的可选宿主管理资源目录。

lua_packages_dir: Option<PathBuf>

Optional lua_packages root used to build package.path and package.cpath. 用于拼接 package.path 与 package.cpath 的可选 lua_packages 根目录。

host_provided_tool_root: Option<PathBuf>

Host-managed root directory used only to probe host-provided tool dependencies. 仅用于探测宿主提供工具依赖的宿主管理根目录。

host_provided_lua_root: Option<PathBuf>

Host-managed root directory used only to probe host-provided Lua package dependencies. 仅用于探测宿主提供 Lua 包依赖的宿主管理根目录。

host_provided_ffi_root: Option<PathBuf>

Host-managed root directory used only to probe host-provided FFI/native dependencies. 仅用于探测宿主提供 FFI/原生依赖的宿主管理根目录。

system_lua_lib_dir: Option<PathBuf>

Optional fixed host-owned system Lua library directory used by system_lua_lib leases. 供 system_lua_lib 租约使用的可选固定宿主系统 Lua 库目录。

download_cache_root: Option<PathBuf>

Host-managed cache directory used for downloaded archives and remote manifests. 宿主管理的下载缓存目录，用于归档文件和远程清单缓存。

dependency_dir_name: String

Fixed sibling directory name used under one skill-root parent to store dependencies. 在单个技能根父目录下存放依赖时使用的固定兄弟目录名称。

state_dir_name: String

Fixed sibling directory name used under one skill-root parent to store skill state. 在单个技能根父目录下存放技能状态时使用的固定兄弟目录名称。

database_dir_name: String

Fixed sibling directory name used under one skill-root parent to store skill databases. 在单个技能根父目录下存放技能数据库时使用的固定兄弟目录名称。

skill_config_file_path: Option<PathBuf>

Optional unified skill config file path owned by the host. 由宿主拥有的可选统一技能配置文件路径。

allow_network_download: bool

Whether the runtime is allowed to perform network downloads while installing dependencies. 运行时在安装依赖时是否允许执行网络下载。

github_base_url: Option<String>

Optional GitHub site base URL override used to rewrite browser download URLs. 可选的 GitHub 站点基址覆盖，用于重写浏览器下载地址。

github_api_base_url: Option<String>

Optional GitHub API base URL override used to resolve release metadata. 可选的 GitHub API 基址覆盖，用于解析 release 元数据。

official_skill_hub_base_url: Option<String>

Optional official LuaSkills Hub base URL used by managed Hub installs. 受管 Hub 安装使用的可选官方 LuaSkills Hub 基址。

enable_private_url_skill_install: bool

Whether trusted system operations may install from private URL manifests. 可信 system 操作是否允许从私有 URL manifest 安装。

private_skill_source_allowlist: Vec<String>

Host-controlled URL prefixes allowed for private skill manifests. 宿主管控的私有技能 manifest 允许 URL 前缀。

default_text_encoding: Option<String>

Optional default text encoding label used by managed IO and process APIs. 托管 IO 与进程 API 使用的可选默认文本编码标签。

sqlite_library_path: Option<PathBuf>

Explicit SQLite dynamic-library path owned by the host. 由宿主显式提供的 SQLite 动态库路径。

sqlite_provider_mode: LuaRuntimeDatabaseProviderMode

SQLite database provider mode selected by the host. 宿主为 SQLite 数据库选择的 provider 模式。

sqlite_callback_mode: LuaRuntimeDatabaseCallbackMode

SQLite callback transport mode selected by the host when provider mode is host_callback. 当 provider 模式为 host_callback 时，宿主为 SQLite 选择的回调传输模式。

lancedb_library_path: Option<PathBuf>

Explicit LanceDB dynamic-library path owned by the host. 由宿主显式提供的 LanceDB 动态库路径。

lancedb_provider_mode: LuaRuntimeDatabaseProviderMode

LanceDB database provider mode selected by the host. 宿主为 LanceDB 数据库选择的 provider 模式。

lancedb_callback_mode: LuaRuntimeDatabaseCallbackMode

LanceDB callback transport mode selected by the host when provider mode is host_callback. 当 provider 模式为 host_callback 时，宿主为 LanceDB 选择的回调传输模式。

space_controller: LuaRuntimeSpaceControllerOptions

Shared controller client options used when one database backend selects space_controller. 当数据库后端选择 space_controller 时所使用的共享控制器客户端选项。

cache_config: Option<ToolCacheConfig>

Host-provided transient cache policy consumed by vulcan.cache. 由宿主提供并供 vulcan.cache 消费的临时缓存策略。

runlua_pool_config: Option<LuaRuntimeRunLuaPoolConfig>

Optional dedicated pool configuration for isolated vulcan.runtime.lua.exec VMs. 供隔离 vulcan.runtime.lua.exec 虚拟机使用的可选独立池配置。

reserved_entry_names: Vec<String>

Host-reserved public entry names that LuaSkills canonical name generation must never occupy directly. 宿主保留的公开入口名称集合，LuaSkills 在生成 canonical 名称时必须直接避开这些名称。

ignored_skill_ids: Vec<String>

Host-forced skill identifiers that must be skipped before dependency or database setup. 宿主强制跳过的技能标识符列表，会在依赖或数据库初始化前生效。

capabilities: LuaRuntimeCapabilityOptions

Host-controlled optional runtime capability toggles. 由宿主控制的可选运行时能力开关集合。

Implementations

impl LuaRuntimeHostOptions

pub fn with_runtime_root(runtime_root: impl Into<PathBuf>) -> Self

Build host options from one canonical runtime root and its fixed derived layout. 基于单个规范运行时根目录及其固定派生布局构造宿主选项。

pub fn runtime_layout(&self) -> Option<LuaRuntimeLayout>

Return the fixed layout when a canonical runtime root has been configured. 当已配置规范运行时根目录时返回固定布局。

pub fn apply_runtime_root_layout(&mut self)

Apply the fixed runtime-root layout to all legacy directory fields. 将固定 runtime-root 布局应用到所有兼容目录字段。

pub fn normalized(self) -> Self

Return a normalized copy where runtime_root owns legacy derived paths and explicit managed roots remain intact. 返回一份规范化副本，其中 runtime_root 拥有旧有派生路径，显式受管根保持不变。

Trait Implementations

impl Clone for LuaRuntimeHostOptions

fn clone(&self) -> LuaRuntimeHostOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LuaRuntimeHostOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LuaRuntimeHostOptions

fn default() -> LuaRuntimeHostOptions

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LuaRuntimeHostOptions

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LuaRuntimeHostOptions

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.