wtagent 0.2.0 → 0.2.1

package/README.md

@@ -8,7 +8,9 @@ WTAgent connects ChatGPT, Claude, DeepSeek, Gemini, Kimi, or GLM Web to your loc
 
 ## Quick start
 
-Requires Node.js 20.17+ and Chrome/Chromium. WTAgent supports macOS, Linux, and native Windows. WSL is not currently supported.
+Requires Node.js 20.17+ and Chrome/Chromium. WTAgent supports macOS, Linux, native Windows, and preview support for WSL2 with WSLg. WSL1 and external X11 configurations are best effort.
+
+On WSL, install the Linux Chrome/Chromium package inside the distribution and launch WTAgent from WSL. WTAgent keeps file and command execution in the WSL environment and connects to that Linux browser over local CDP. Display environment variables are only configuration hints; actual GUI availability is confirmed when Chrome starts. Windows-host Chrome is not supported from WSL yet.
 
 ```bash
 npm install -g wtagent
@@ -59,7 +61,9 @@ WTAgent 将 ChatGPT、Claude、DeepSeek、Gemini、Kimi 或 GLM 网页聊天连
 
 ### 快速开始
 
-需要 Node.js 20.17+ 和 Chrome/Chromium。支持 macOS、Linux 和原生 Windows，暂不支持 WSL。
+需要 Node.js 20.17+ 和 Chrome/Chromium。支持 macOS、Linux、原生 Windows，以及预览支持带 WSLg 的 WSL2。WSL1 和外部 X11 配置仅按尽力支持处理。
+
+在 WSL 中使用时，需要在 WSL 发行版内部安装 Linux 版 Chrome/Chromium，并从 WSL 启动 WTAgent。文件读写和命令执行仍然发生在 WSL 环境中，WTAgent 通过本地 CDP 连接这个 Linux 浏览器。图形环境变量仅表示已配置，实际可用性会在 Chrome 启动时确认。当前还不支持从 WSL 直接控制 Windows 主机上的 Chrome。
 
 ```bash
 npm install -g wtagent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtagent",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Turn your own web AI session into a local tool-using agent.",
   "repository": {
     "type": "git",

package/src/cli/main.js

@@ -208,7 +208,14 @@ async function runDoctor(options) {
   }
   console.log(`Data: ${paths.appDataDir}`);
   console.log(`Profile: ${paths.profileDir}`);
-  console.log(report.exitCode === 0 ? "Doctor: OK" : "Doctor: FAILED");
+  const hasWarnings = report.items.some((item) => item.status === "degraded");
+  console.log(
+    report.exitCode !== 0
+      ? "Doctor: FAILED"
+      : hasWarnings
+        ? "Doctor: OK (with warnings)"
+        : "Doctor: OK",
+  );
   process.exitCode = report.exitCode;
 }
 

package/src/platform/windows-diagnostics.js

@@ -55,6 +55,35 @@ export function detectWsl({
   );
 }
 
+export function getWslSupport({
+  platform = process.platform,
+  env = process.env,
+  osRelease = os.release(),
+} = {}) {
+  if (!detectWsl({ platform, env, osRelease })) {
+    return { supported: true, preview: false, reason: null };
+  }
+
+  const display = env.WAYLAND_DISPLAY || env.DISPLAY;
+  if (!display) {
+    return {
+      supported: false,
+      preview: false,
+      reason:
+        "WSL is detected, but no Linux graphical display is configured. Enable WSLg (or an X server), install Chrome/Chromium inside the WSL distribution, and retry.",
+    };
+  }
+
+  return {
+    supported: true,
+    preview: true,
+    reason:
+      `WSL is detected with a ${env.WAYLAND_DISPLAY ? "Wayland" : "X11"} display environment configured. `
+      + "This preview check does not verify that the display is reachable; WTAgent confirms that only when Linux Chrome starts. "
+      + "Windows-host Chrome is not used.",
+  };
+}
+
 export function getNativeWindowsSupport({
   platform = process.platform,
   arch = process.arch,
@@ -100,11 +129,12 @@ export function assertNativeRuntimeSupported(context = {}) {
       `WTAgent requires Node.js 20.17.0 or newer; current runtime is ${version}.`,
     );
   }
-  if (detectWsl(context)) {
-    throw new Error(
-      "WTAgent does not support running inside WSL in v1. Launch it from native Windows PowerShell or CMD against a Windows project path.",
-    );
+
+  const wsl = getWslSupport(context);
+  if (!wsl.supported) {
+    throw new Error(wsl.reason);
   }
+
   const windows = getNativeWindowsSupport(context);
   if (!windows.supported) {
     throw new Error(windows.reason);
@@ -356,11 +386,12 @@ export async function collectDoctorReport({
 
   const isWsl = detectWsl({ platform, env, osRelease });
   if (isWsl) {
+    const wsl = getWslSupport({ platform, env, osRelease });
     add(
       "host",
       "Runtime host",
-      "fail",
-      "WSL is detected. WTAgent v1 must run from native Windows PowerShell or CMD, not from WSL.",
+      wsl.supported ? (wsl.preview ? "degraded" : "pass") : "fail",
+      wsl.reason,
       { required: true },
     );
   } else {