From 877ffe02947ed0afd8da08068080e25b6b76fd99 Mon Sep 17 00:00:00 2001 From: Yao Jingxi <23722032@bjtu.edu.cn> Date: Wed, 4 Nov 2026 10:54:16 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=E8=AF=B4=E6=98=8E=E7=BB=93?= =?UTF-8?q?=E6=9E=84=E5=8C=96=E6=97=A5=E5=BF=97=20v2=20=E4=B8=8B=E7=9A=84?= =?UTF-8?q?=E8=AF=8A=E6=96=AD=E6=97=A5=E5=BF=97=E5=8E=BB=E5=90=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README 新增“诊断日志”一节：说明宿主记录到哪个通道、哪些输出留在控制台、 排障时用什么入口，以及哪些内容不应写入日志 - 注明 Windows 仍为 v1 日志，未声明 Windows v2 验收 --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 7b515c9..df50910 100644 --- a/README.md +++ b/README.md @@ -43,6 +43,18 @@ 在调试控制台里输入 `` ` `` 加 lldb 命令（例如 `` `bt``）。命令补全来自插件声明的列表和 `lldb-dap` 自己的补全。 +## 诊断日志 / Diagnostic logs + +此插件通过宿主的通用 DAP 传输启动 `lldb-dap`，没有独立后端或日志 writer。 +结构化日志 v2 的 Core 生命周期和操作分类记录到 `debug/lldb-dap` 通道； +关键生命周期为 INFO，运行/暂停等内部状态为 DEBUG，超时和适配器拒绝为 ERROR，取消不算失败。 +原生启动和进程异常退出的固定阶段/退出码记录到 `debug`。程序输出、调试表达式和变量内容属于调试控制台， +不得复制到诊断日志。适配器原始 stderr 仍由宿主调试控制台呈现，不代表已作为 v2 文件持久化。 + +排障时使用 Lithe 的独立日志窗口和诊断导出，并同时检查调试控制台。 +不要启用 `LLDBDAP_LOG`、完整 DAP 通信转储或以变量、内存、源码和环境内容补充诊断日志。 +日志文件不得写入插件安装目录。Windows 的日志实现仍为 v1；本文没有声明 Windows 已完成 v2 验收。 + ## 开发 / Development ```text From 4608197a5c33b80968797def076866d7ddcb5c4e Mon Sep 17 00:00:00 2001 From: Xiaoyumuxi <3075514079@qq.com> Date: Wed, 4 Nov 2026 14:43:16 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs(logging):=20=E8=AF=B4=E6=98=8E?= =?UTF-8?q?=E5=AE=BF=E4=B8=BB=E4=BB=A3=E8=AE=B0=E7=9A=84=E6=8F=92=E4=BB=B6?= =?UTF-8?q?=E6=93=8D=E4=BD=9C=E4=BA=8B=E5=AE=9E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index df50910..6298aad 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,14 @@ 原生启动和进程异常退出的固定阶段/退出码记录到 `debug`。程序输出、调试表达式和变量内容属于调试控制台， 不得复制到诊断日志。适配器原始 stderr 仍由宿主调试控制台呈现，不代表已作为 v2 文件持久化。 +插件没有自己的进程发送 `lithe/log`，宿主因此替插件把每次 `lldb-dap` 启动尝试记成与 SDK 插件 +同一组的操作事实，写入 `plugins/io.github.lithe-idea.lldb-debug/host` 通道，操作名为 +`debugAdapter/start`：调试会话就绪记 `plugins.operation.finished`（INFO，含耗时）；失败记 +`plugins.operation.failed`（ERROR），失败码只取自启动阶段——`host.executableUnavailable`（无法解析 +`lldb-dap` 启动命令）、`host.launchFailed`（进程拉起失败）、`host.initializeFailed`（DAP 初始化失败）、 +`host.exitedEarly`（就绪前退出）、`host.timedOut`（初始化超时）。用户停止和取消不记录；事实不含程序输出、 +变量、路径或命令行。插件不需要任何日志代码，宿主实现见 https://github.com/1lck/Lithe-IDEA/pull/1720。 + 排障时使用 Lithe 的独立日志窗口和诊断导出，并同时检查调试控制台。 不要启用 `LLDBDAP_LOG`、完整 DAP 通信转储或以变量、内存、源码和环境内容补充诊断日志。 日志文件不得写入插件安装目录。Windows 的日志实现仍为 v1；本文没有声明 Windows 已完成 v2 验收。