Struct PluginProcess 

pub struct PluginProcess {
    pub plugin_id: String,
    pub manifest: Manifest,
    pub state: Arc<RwLock<ProcessState>>,
    pub client: Arc<JsonRpcClient>,
    pub data_dir: PathBuf,
    pub restart_count: u32,
    pub pid: Option<u32>,
    /* private fields */
}

Manages a single plugin subprocess instance.

Fields

plugin_id: String

manifest: Manifest

state: Arc<RwLock<ProcessState>>

client: Arc<JsonRpcClient>

data_dir: PathBuf

restart_count: u32

该插件已重启的次数（0 = 初次启动）。 仅用于观测；权威的重启计数器在 PluginRestartContext 中。

pid: Option<u32>

子进程的 PID，用于强制终止（当优雅关闭超时时兜底）。

Implementations

impl PluginProcess

pub async fn spawn( manifest: &Manifest, plugin_dir: &Path, data_dir: &Path, log_dir: &Path, host_call_handler: Arc<dyn HostCallHandler>, crash_tx: Sender<String>, restart_count: u32, locale: &str, ) -> Result<Self, ProtocolError>

Spawn the plugin subprocess, complete the initialize handshake, and start stderr log collection.

crash_tx is a channel sender owned by the PluginHostManager. When the watchdog detects a crash, it sends the plugin_id on this channel so the manager can trigger a re-spawn. 启动插件子进程并完成握手与协议版本兼容性校验。 参数较多（进程/目录/回调/计数/locale），按先例 allow too_many_arguments。

pub async fn discover_components(&self) -> Result<InitResult, ProtocolError>

Run the post-initialization discovery sequence: plugin/get_components, and for each component: plugin/get_settings_schema, plugin/get_settings, plugin/config_actions. 对 ActionExecutor 组件还会额外调用 plugin/supported_target_types 和 plugin/supported_actions，收集真实的 ResultAction 列表。 插件级元数据由宿主从清单构造，不在本序列。

pub fn spawn_watchdog(&self) -> JoinHandle<()>

生成一个看门狗任务，监控子进程的生命周期。 使用事件驱动的等待（child.wait().await）——没有轮询循环。

当进程退出时：

• 如果状态已经是 Stopped（优雅关闭），静默返回。
• 如果 auto_restart=false，将状态设为 Stopped 并返回。
• 否则，将 plugin_id 发到 crash_tx 上，通知 PluginHostManager 重新拉起。管理者（crash_loop）负责追踪重启次数和强制 max_restart 上限。

任务完成即进程已退出；返回的 JoinHandle 供 shutdown 等待。

pub async fn shutdown(self, timeout: Duration)

优雅关闭：关闭 stdin（SDK 进程唯一退出路径是 stdin EOF）→ 等待进程退出（watchdog 完成即进程退出）→ 超时则强杀。