[xiaoyumuxi]

概要

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

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

插件会得到的操作事实

• 通道：plugins/io.github.lithe-idea.lldb-debug/host，与 SDK 插件的 lithe/log 同一类通道，日志窗口可按插件筛选。
• 操作：debugAdapter/start（lldb-dap 每次启动尝试）。
• 成功：plugins.operation.finished（INFO，含耗时），条件是调试会话进入就绪。
• 失败：plugins.operation.failed（ERROR），失败码只取自执行阶段，不解析错误文本：
  • host.executableUnavailable：无法解析启动命令
  • host.launchFailed：进程拉起失败
  • host.initializeFailed：初始化握手失败
  • host.exitedEarly：就绪前退出
  • host.timedOut：初始化超时
• 谁记录：macOS 宿主的 DAP 会话在解析、拉起、初始化的真实边界推进阶段并记录结果；用户停止和取消不记录。
• 取消、停止、被取代的尝试不记录；事实不含插件输出、路径或命令行。

README 新增“诊断日志 / Diagnostic logs”

• 本插件通过宿主的通用 DAP 传输启动 lldb-dap，没有独立后端或日志 writer。
• Core 的生命周期和操作分类记录到 debug/lldb-dap：关键生命周期为 INFO，运行/暂停等内部状态为 DEBUG，超时和适配器拒绝为 ERROR，取消不算失败。
• 原生启动失败、进程异常退出的固定阶段和退出码记录到 debug。
• 程序输出、调试表达式和变量内容属于调试控制台，不复制进诊断日志；适配器原始 stderr 仍只在调试控制台显示，不作为 v2 文件持久化。
• 排障用 Lithe 的日志窗口和诊断导出，同时查看调试控制台。
• 不要开启 LLDBDAP_LOG、完整 DAP 通信转储，也不要用变量、内存、源码或环境内容补充日志；日志文件不能写进插件安装目录。
• 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 插件：https://github.com/Lithe-IDEA/lithe-plugin-lldb/pull/3（本 PR）
• PHP 插件：feat(logging): 接入结构化日志 v2 插件操作事实（由宿主代记） lithe-plugin-php#3