[xiaoyumuxi]

概要

PHP 插件接入结构化日志 v2 的插件操作事实。本插件是纯声明式插件（languageServers 声明 Intelephense 的 --stdio 启动），没有自己的进程，无法像 SDK 插件那样发送 lithe/log。宿主 1lck/Lithe-IDEA#1720 因此替它记录：languageServer/start（Intelephense 每次启动尝试）写成与 SDK 插件同一组的 plugins.operation.finished / plugins.operation.failed，落到 plugins/io.github.lithe-idea.php-support/host 通道。

插件清单、启动方式和版本都不需要改；本 PR 在 README 里说明插件会得到哪些事实和失败码。

插件会得到的操作事实

• 通道：plugins/io.github.lithe-idea.php-support/host，与 SDK 插件的 lithe/log 同一类通道，日志窗口可按插件筛选。
• 操作：languageServer/start（Intelephense 每次启动尝试）。
• 成功：plugins.operation.finished（INFO，含耗时），条件是 Intelephense 的 initialize 成功。
• 失败：plugins.operation.failed（ERROR），失败码只取自执行阶段，不解析错误文本：
  • host.executableUnavailable：无法解析启动命令
  • host.launchFailed：进程拉起失败
  • host.initializeFailed：初始化握手失败
  • host.exitedEarly：就绪前退出
  • host.timedOut：初始化超时
• 谁记录：启动前的解析失败（找不到可执行文件、准备失败）由 macOS 宿主记录；进入启动后宿主把这次尝试交给 Core，由 Core 记录唯一结果。
• 取消、停止、被取代的尝试不记录；事实不含插件输出、路径或命令行。

README 新增“诊断日志”

• 在启用结构化日志 v2 的 macOS preview 中，宿主按语言服务身份把 Intelephense 的生命周期、window/logMessage 和有界 stderr 写入当前会话的 lsp/php 通道。
• 保留 --stdio 启动方式，脱敏、截断、写入和保留都由宿主统一处理，插件不创建自己的日志 writer。
• PHP 程序和 PHPUnit 的输出仍属于运行/测试控制台，不复制进诊断日志。
• 排障用 Lithe 的日志窗口和诊断导出，详细诊断只临时开启。
• 不要把 PHP 源码、HTTP/数据库内容、环境变量、凭据或完整协议载荷写进日志。
• Windows 仍是 v1，不声明 Windows v2 已验收。
• 本次新增一段：说明上面的宿主代记操作事实和失败码，并链接宿主实现 https://github.com/1lck/Lithe-IDEA/pull/1720。

验证

• 宿主侧：见 feat(logging): 声明式插件由执行方代记插件操作事实 1lck/Lithe-IDEA#1720 的验证（Core plugin_operations 映射表与相关 macOS 回归）。
• 本插件：只改 README，包内容不受影响；本次未在本地重跑 node scripts/package.mjs，交给 CI。
• 真实插件在 Lithe 日志窗口中的插件通道表现尚未验收。

预期的 CI 状态与合并顺序

• CI 只打包并做 Store 规则校验，不检出宿主，预期通过。
• 需在宿主 feat(logging): 声明式插件由执行方代记插件操作事实 1lck/Lithe-IDEA#1720 合入 preview 之后再合并，避免 README 描述的行为先于宿主出现。
• 本 PR 没有改插件版本号。

限制

• 只覆盖 macOS 宿主；Windows 仍是 v1 writer。
• 未在 Lithe 整机日志窗口里做端到端验收。

配套 PR：

• 宿主代记（本插件实际接入）：feat(logging): 声明式插件由执行方代记插件操作事实 1lck/Lithe-IDEA#1720
• 宿主 Core：feat(logging): 插件与调试适配器接入结构化日志 v2 1lck/Lithe-IDEA#1699
• SDK：feat(sdk): 三种 SDK 接入 litheLogging 1 结构化诊断 lithe-plugin-docs#17
• Database 插件：feat(logging): 接入 litheLogging 1 结构化诊断 lithe-plugin-database#2
• Docker 插件：feat(logging): 接入 litheLogging 1 结构化诊断 lithe-plugin-docker#3
• HTTP Client 插件：feat(logging): 接入 litheLogging 1 结构化诊断 lithe-plugin-http-client#5
• Cargo 插件：feat(logging): 接入 litheLogging 1 结构化诊断 lithe-plugin-cargo#5
• SVN 插件：feat(logging): 接入 litheLogging 1 结构化诊断 lithe-plugin-svn#2
• Maven 插件：feat(logging): 接入 litheLogging 1 结构化诊断 lithe-plugin-maven#9
• Lua 插件：feat(logging): LuaLS 日志写入宿主会话日志目录 lithe-plugin-lua#6
• Go 插件：feat(logging): 接入结构化日志 v2 插件操作事实（由宿主代记） lithe-plugin-go#3
• Gradle 插件：feat(logging): 接入结构化日志 v2 插件操作事实（由宿主代记） lithe-plugin-gradle#5
• LLDB 插件：feat(logging): 接入结构化日志 v2 插件操作事实（由宿主代记） lithe-plugin-lldb#3
• PHP 插件：https://github.com/Lithe-IDEA/lithe-plugin-php/pull/3（本 PR）