From 2b9a4193fef82ef7cd0d1f572a1eabd694783f4f 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 | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index b610b75..b2221a1 100644 --- a/README.md +++ b/README.md @@ -96,6 +96,17 @@ GRADLE=/path/to/gradle node scripts/test.mjs [插件契约](https://github.com/Lithe-IDEA/lithe-plugin-docs/blob/main/contract/v1/README.md) 和[构建工具接入指南](https://github.com/Lithe-IDEA/lithe-plugin-docs/blob/main/guides/build-tool-integration.md)。 +## 诊断日志 + +此插件只声明 Gradle 命令及模型导出脚本，没有独立的常驻后端或日志 writer。 +启用结构化日志 v2 的 Lithe macOS preview 由宿主将构建、运行与测试的进程终态、退出码和耗时 +记录到当前会话的 `run` 通道；Gradle 的编译输出和测试报告继续留在 Build Output 与测试界面。 +模型与依赖树 JSON 是工作流数据，不是日志，仍通过宿主提供的临时输出文件返回。 + +排障时使用 Lithe 的独立日志窗口和诊断导出。不启用 Gradle `--debug` 来复制环境、凭据、 +完整命令行或构建正文，也不将 Gradle User Home、daemon 状态或输出文件迁入日志目录。 +Windows 的日志实现仍为 v1；本文没有声明 Windows 已完成 v2 验收。 + ## 发布新版本 1. 修改 `plugin.json` 的 `version`（例如 `0.2.0`），合入 `main`。 From 65fd9058e5e0215d2431768a50dc8e4a71cdbdb1 Mon Sep 17 00:00:00 2001 From: Xiaoyumuxi <3075514079@qq.com> Date: Wed, 4 Nov 2026 14:43:17 +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 | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index b2221a1..fbf975e 100644 --- a/README.md +++ b/README.md @@ -103,6 +103,15 @@ GRADLE=/path/to/gradle node scripts/test.mjs 记录到当前会话的 `run` 通道；Gradle 的编译输出和测试报告继续留在 Build Output 与测试界面。 模型与依赖树 JSON 是工作流数据，不是日志，仍通过宿主提供的临时输出文件返回。 +模型导出和依赖树命令同样由宿主执行。宿主替插件把每次执行记成与 SDK 插件同一组的操作事实，写入 +`plugins/io.github.lithe-idea.gradle-build/host` 通道，操作名为 `lithe/build/model` 和 +`lithe/build/dependencies`（与由插件后端提供时的请求名相同）：结果成功解码记 +`plugins.operation.finished`（INFO，含耗时）；失败记 `plugins.operation.failed`（ERROR），失败码只取自 +执行阶段——`host.planFailed`（无法生成命令计划）、`host.executableUnavailable`（无法解析 Gradle 或 +wrapper）、`host.launchFailed`（进程拉起失败）、`host.timedOut`（超时）、`host.commandFailed`（命令失败 +退出）、`host.outputInvalid`（输出文件无法解码）。取消和被新请求取代的结果不记录；事实不含 Gradle 输出、 +路径或命令行。插件不需要任何日志代码，宿主实现见 https://github.com/1lck/Lithe-IDEA/pull/1720。 + 排障时使用 Lithe 的独立日志窗口和诊断导出。不启用 Gradle `--debug` 来复制环境、凭据、 完整命令行或构建正文，也不将 Gradle User Home、daemon 状态或输出文件迁入日志目录。 Windows 的日志实现仍为 v1；本文没有声明 Windows 已完成 v2 验收。