mslxdff 0.1.3 → 0.1.4

package/README.md

@@ -46,16 +46,21 @@ Priority: `-port` arg > persisted port > `PORT` env > default `8989`.
 
 ### Daemon (background, stays resident)
 
+Just run `mslxdff` (no args): if no daemon is running yet, it **starts a background
+daemon and exits** — the command never holds your terminal, so `npx mslxdff` works
+the same way. If a daemon is already up, the bare command shows status + help.
+
 ```
-mslxdff -d        # start detached background daemon
-mslxdff -stop     # stop it
+mslxdff        # starts the background daemon (if none running); exits immediately
+mslxdff -d     # same, explicit
+mslxdff -stop  # stop it
 ```
 
 Logs go to `~/.config/mslxdff/daemon.log`, the daemon pid to `daemon.pid` (both overridable via `MSLXDFF_DAEMON_DIR`). The daemon keeps running after your shell exits.
 
 ### Status
 
-Running `mslxdff` with no args shows a status panel when a daemon is already up (or use `mslxdff -status` anytime): the free model list, the last 5 calls (model/status/latency), and the most recent error. Call and error history are stored as JSON-lines at `calls.log` / `errors.log` in the state dir.
+Running `mslxdff` with no args shows a status panel when a daemon is already up: joined groups with their members, failover targets, the free model list, the last 5 calls (model/status/latency), and the most recent error (`mslxdff -status` for status only, `mslxdff -help` for the full command reference). Call and error history are stored as JSON-lines at `calls.log` / `errors.log` in the state dir.
 
 ```
 $ mslxdff -status

package/bin/mslxdff.js

@@ -250,10 +250,22 @@ if (args.includes("-d") || args.includes("--daemon")) {
   // we ARE the daemon; stdout/stderr already point at the log file via startDaemon stdio
 }
 
-// Bare run: if a daemon is already running, show status + help instead of starting another.
-if (!process.env.MSLXDFF_DAEMON && readPid()) {
-  await printStatus();
-  printHelp();
+// Bare run: show status + help when the daemon is already up; otherwise spawn it
+// as a background daemon and exit — never holds the terminal (npx-friendly).
+if (!process.env.MSLXDFF_DAEMON) {
+  if (readPid()) {
+    await printStatus();
+    printHelp();
+    process.exit(0);
+  }
+  const port = effectivePort();
+  const spawnedPid = startDaemon([]);
+  await waitForHealth(port, 4000);
+  console.log(`mslxdff v${VERSION} started as a background daemon (pid ${spawnedPid})`);
+  console.log(`endpoint:   http://localhost:${port}/v1`);
+  console.log(`log:        ${logFile()}`);
+  console.log(`pid:        ${pidFile()}`);
+  console.log(`status:     run \`mslxdff\` again (or \`mslxdff -status\`)`);
   process.exit(0);
 }
 
@@ -383,7 +395,7 @@ function printHelp() {
   console.log(`mslxdff v${VERSION} — OpenCode Free OpenAI-compatible proxy
 
 Usage:
-  mslxdff                          start the server (if none running); shows status when a daemon is already up
+  mslxdff                          start as a background daemon and exit (status + help if one is already running)
   mslxdff -d                       start as a background daemon
   mslxdff -status                  show current status (daemon, models, recent calls, last error)
   mslxdff -stop                    stop the running daemon

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mslxdff",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "测试项目，请勿使用。",
   "type": "module",
   "bin": {