@apprun/shiqu 0.4.0 → 0.4.1

package/README.md

@@ -13,7 +13,8 @@ Turn Chinese classics into your own illustrated storybooks. Read in your browser
 | You want generation and reading access to continue after closing the control window | Desktop app: stays in the system tray until you stop the service or quit the app |
 | You need startup parameters, environment overrides, or non-interactive operation | CLI: prepare provider configuration and a library path in advance |
 | You use Linux, an Intel Mac, or Windows ARM64 | CLI: install Node 24 yourself; no desktop installer is provided for these platforms. Windows supports API providers or read-only mode |
-| You want QR codes for phone access or built-in internet tunnel controls | Desktop app: internet access requires a separate cloudflared installation. CLI supports trusted LAN access with `--host 0.0.0.0`, without a built-in internet tunnel |
+| You want phone access on the same Wi-Fi | Both entries: CLI prints phone QR codes on startup; desktop shows them in its control window |
+| You need built-in internet tunnel controls | Desktop app: requires a separate cloudflared installation. CLI has no built-in internet tunnel |
 
 **Shared features:** Both entry points provide the same browser interface for story creation, generation queues, pause/resume, reading, library organization, and PDF / PNG export. The desktop window adds library, queue, settings, and service controls; full reading and story creation happen in the browser. Both support OpenAI API, Gemini, and read-only mode. Codex generation is supported on macOS / Linux and requires a separately installed, logged-in Codex CLI; the Shiqu CLI and Codex CLI are different tools.
 
@@ -35,7 +36,7 @@ Requires **Node 24** (recommended: 24.22.1) and its bundled npm / npx. No separa
 npx @apprun/shiqu
 ```
 
-On first use, npx may ask to download the package; confirm to continue. Open the printed URL, normally `http://127.0.0.1:3000`. Keep the terminal running; stop with Ctrl+C. No checkout, build, Docker, or desktop app is needed.
+On first use, npx may ask to download the package; confirm to continue. Open the printed URL, normally `http://127.0.0.1:3000`, or scan a terminal QR code from a phone on the same trusted Wi-Fi. LAN access is enabled by default. Keep the terminal running; stop with Ctrl+C. No checkout, build, Docker, or desktop app is needed.
 
 If you already use pnpm, `pnpm dlx @apprun/shiqu` starts the same app. You can also install it globally with pnpm for a permanent `shiqu` command:
 
@@ -83,14 +84,14 @@ No `.env` is loaded automatically. Existing shell variables beat the selected fi
 
 ```bash
 npx @apprun/shiqu --port 3100 --data-dir ./my-library
-npx @apprun/shiqu --host 0.0.0.0
+pnpm dlx @apprun/shiqu --host 127.0.0.1
 npx @apprun/shiqu --version
 ```
 
 | Option | Environment | Default |
 | --- | --- | --- |
 | `--port` | `PORT` | `3000` |
-| `--host` | `SHIQU_BIND_IP` | `127.0.0.1` |
+| `--host` | `SHIQU_BIND_IP` | `0.0.0.0` (LAN access) |
 | `--data-dir` | `SHIQU_DATA_DIR` | Saved desktop library; otherwise find or ask below |
 | `--config` | — | No env file |
 
@@ -112,7 +113,7 @@ Relative paths resolve from the launch directory. Both entries use the same SQLi
 
 Older CLI releases used `shiqu/library` rather than `com.shiqu.desktop/library` (Windows used LOCALAPPDATA, falling back to APPDATA). Existing data is never moved or merged automatically; pass the old directory with `--data-dir` to continue using it. CLI and desktop now share saved credentials; explicit invocation overrides remain separate and are not saved.
 
-Loopback is the default. `--host 0.0.0.0` enables access from other devices on a trusted LAN; every connected device shares the library and generation permissions. Keep the computer awake while reading from a phone. This CLI does not provide the desktop app's internet tunnel or native control window.
+The CLI listens on `0.0.0.0` by default and prints LAN URLs and phone QR codes when a network interface is available. Every connected device shares the library and generation permissions; use a trusted LAN. Use `--host 127.0.0.1` (or `SHIQU_BIND_IP=127.0.0.1`) for local-only access without phone QR codes. Keep the computer awake while reading from a phone. This CLI does not provide the desktop app's internet tunnel or native control window.
 
 ## Sources and license
 

package/dist/server/cli.js

@@ -5623,6 +5623,15 @@ async function startServer({ root, variables = process.env, localAccess = false
       }
     })();
   }
+  function listen(host2) {
+    return new Promise((resolve, reject) => {
+      server.once("error", reject);
+      server.listen(config.port, host2, () => {
+        server.off("error", reject);
+        resolve();
+      });
+    });
+  }
   function stop() {
     if (stopping) return;
     stopping = true;
@@ -5632,13 +5641,11 @@ async function startServer({ root, variables = process.env, localAccess = false
     void Promise.all([closed, stopCodexProcesses()]).then(closeApplication).then(() => process.exit(0));
   }
   try {
-    await new Promise((resolve, reject) => {
-      server.once("error", reject);
-      server.listen(config.port, config.host, () => {
-        server.off("error", reject);
-        resolve();
-      });
-    });
+    if (config.host === "0.0.0.0") {
+      await listen("127.0.0.1");
+      await new Promise((resolve) => server.close(() => resolve()));
+    }
+    await listen(config.host);
   } catch (error) {
     await closeApplication();
     throw error;
@@ -6022,7 +6029,7 @@ async function cliConfiguration(options, context = {}) {
   return {
     ...variables,
     PORT: options.port ?? variables.PORT ?? "3000",
-    SHIQU_BIND_IP: options.host ?? variables.SHIQU_BIND_IP ?? "127.0.0.1",
+    SHIQU_BIND_IP: options.host ?? variables.SHIQU_BIND_IP ?? "0.0.0.0",
     SHIQU_DATA_DIR: directory
   };
 }
@@ -6033,7 +6040,7 @@ var help = `Usage: shiqu [options]
 Start \u62FE\u8DA3 and open the printed URL in your browser. Requires Node 24.
 
   --port <number>       HTTP port (PORT, default: 3000)
-  --host <address>      Bind address (SHIQU_BIND_IP, default: 127.0.0.1)
+  --host <address>      Bind address (SHIQU_BIND_IP, default: 0.0.0.0)
   --data-dir <path>     Persistent library (SHIQU_DATA_DIR, saved desktop library, otherwise ask)
   --config <env-file>   Load this env file; existing environment variables take precedence
   --configure          Select/edit the shared saved provider, then exit
@@ -6042,7 +6049,8 @@ Start \u62FE\u8DA3 and open the printed URL in your browser. Requires Node 24.
   -v, --version        Show version
 
 Relative paths use the directory you launched from. No .env file is loaded automatically.
-Use --host 0.0.0.0 for trusted LAN access; connected devices share the library.
+LAN access and phone QR codes are enabled by default; use the same trusted Wi-Fi.
+Connected devices share the library. Use --host 127.0.0.1 for local-only access.
 Saved provider settings are shared with the desktop app. First use asks for setup.
 Environment/config overrides apply to this invocation only and are never saved automatically.
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apprun/shiqu",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Turn Chinese classics into illustrated stories in a local browser app.",
   "license": "Apache-2.0",
   "author": "Yiyi Sun",