@fecommunity/reactpress 4.0.0-beta.13 → 4.0.0-beta.15

package/README.md

@@ -1,13 +1,36 @@
 # @fecommunity/reactpress
 
-ReactPress 4 CLI — zero-dependency publishing platform. Initialize a local SQLite site and bundled API with a single command.
+> **Not a CMS. A publishing platform for modern developers.**
+>
+> WordPress-style editing · Next.js delivery · One CLI to ship.
 
-Monorepo docs: [github.com/fecommunity/reactpress](https://github.com/fecommunity/reactpress) · Chinese overview: [README-zh_CN.md](../README-zh_CN.md)
+[![npm version](https://img.shields.io/npm/v/@fecommunity/reactpress/beta.svg?label=beta)](https://www.npmjs.com/package/@fecommunity/reactpress/v/beta)
+[![npm latest](https://img.shields.io/npm/v/@fecommunity/reactpress.svg?label=latest)](https://www.npmjs.com/package/@fecommunity/reactpress)
+[![npm downloads](https://img.shields.io/npm/dm/@fecommunity/reactpress.svg)](https://www.npmjs.com/package/@fecommunity/reactpress)
+[![License: MIT](https://img.shields.io/npm/l/@fecommunity/reactpress.svg)](https://github.com/fecommunity/reactpress/blob/master/LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)
+
+The official **ReactPress CLI** — install a complete, self-hosted publishing stack in ~60 seconds. CMS API, Web Admin, and Next.js theme support ship together. No Docker, nginx, or external database required for local development.
+
+| Layer | What you get |
+| :---- | :----------- |
+| **CMS API** | Headless NestJS REST — SQLite locally, MySQL in production |
+| **Admin** | Writing console at `/admin/` — posts, pages, media, plugins, themes |
+| **Themes** | npm-installable Next.js frontends — swap without touching content |
+| **CLI** | `init`, `doctor`, `logs` — operate and diagnose from the terminal |
+
+Built for frontend teams who want WordPress-grade editing without wiring five repos together.
+
+[Documentation](https://reactpress-docs.vercel.app/) · [Live demo](https://blog.gaoredu.com) · [Theme demo](https://reactpress-theme-starter.vercel.app) · [GitHub](https://github.com/fecommunity/reactpress) · [Chinese overview](../README-zh_CN.md)
 
 ## Install
 
 ```bash
-npm install -g @fecommunity/reactpress
+# 4.x pre-release (recommended until 4.0.0 stable)
+npm install -g @fecommunity/reactpress@beta
+
+# stable (3.x — legacy)
+# npm install -g @fecommunity/reactpress
 ```
 
 Requires Node.js 18+. On first install, `postinstall` downloads bundled server runtime dependencies (~1–2 minutes).
@@ -19,24 +42,39 @@ mkdir my-site && cd my-site
 reactpress init
 ```
 
-- Site: `http://localhost:3001`
-- Admin: `http://localhost:3001/admin/` (`admin` / `admin`)
-- API: `http://127.0.0.1:3002/api`
+| Surface | URL |
+| :------ | :-- |
+| **Public site** | http://localhost:3001 |
+| **Admin** | http://localhost:3001/admin/ (`admin` / `admin`) |
+| **API** | http://127.0.0.1:3002/api |
+
+Run `reactpress doctor` if something does not start correctly.
 
 ## Commands
 
 | Command | Description |
-|---------|-------------|
-| `reactpress init [dir]` | Initialize project |
+| :------ | :---------- |
+| `reactpress init [dir]` | Initialize a new publishing site |
 | `reactpress doctor [dir]` | Diagnose Node.js, ports, database, and services |
-| `reactpress doctor logs [dir]` | Tail API logs (error / request / response) for debugging |
+| `reactpress logs [dir]` | Tail API logs (error / request / response) |
+| `reactpress stop [dir]` | Stop API and site services |
 
 ## Requirements
 
 - Node.js 18+
 - macOS / Linux / Windows
-- No Docker, nginx, or MySQL required (embedded SQLite + bundled API)
+- Embedded SQLite + bundled API (no Docker or MySQL for local dev)
+
+## Ecosystem
+
+| Package | Role |
+| :------ | :--- |
+| [`@fecommunity/reactpress-toolkit`](../toolkit/) | TypeScript SDK — API clients, theme SSR, plugin hooks |
+| [`@fecommunity/reactpress-web`](../web/) | Admin SPA — static assets and Node mount helpers |
+| [`@fecommunity/reactpress-server`](../server/) | Standalone API (deprecated — use CLI bundled API) |
 
 ## License
 
-MIT © FECommunity
+MIT © [FECommunity](https://github.com/fecommunity)
+
+<p align="center"><sub>Part of <a href="https://github.com/fecommunity/reactpress">ReactPress</a> — content owned by the system, frontend owned by developers.</sub></p>

package/out/bin/reactpress-theme-client.js

@@ -11,11 +11,15 @@ const fs = require('fs');
 const { spawn, spawnSync } = require('child_process');
 const { hasUsableProductionBuild } = require('../lib/theme-prod');
 const { getPm2ClientMemoryRestart, resolveBuildNodeEnv } = require('../lib/prod-memory');
+const { resolvePm2Bin } = require('../lib/pm2-runtime');
 const { readActiveThemeManifest } = require('../lib/theme-runtime');
 const { ensureAdminStaticForTheme, shouldRebuildThemeAfterAdminSync, } = require('../core/services/admin-static');
+const { patchThemeApiProxyRoute } = require('../lib/theme-api-proxy-patch');
 const originalCwd = process.env.REACTPRESS_ORIGINAL_CWD || process.cwd();
 const args = process.argv.slice(2);
 const usePM2 = args.includes('--pm2');
+const useBackground = args.includes('--bg');
+const usePm2Background = args.includes('--pm2-bg');
 const clientDir = process.env.REACTPRESS_THEME_DIR
     ? path.resolve(process.env.REACTPRESS_THEME_DIR)
     : null;
@@ -33,9 +37,13 @@ function runStartCommand() {
 }
 function ensureBuilt() {
     const adminSynced = ensureAdminStaticForTheme(originalCwd, clientDir);
+    const apiProxyPatched = patchThemeApiProxyRoute(clientDir);
     const { activeTheme } = readActiveThemeManifest(originalCwd);
     const themeId = process.env.REACTPRESS_THEME_ID || activeTheme || path.basename(clientDir);
-    const needsRebuild = adminSynced || shouldRebuildThemeAfterAdminSync(clientDir) || !hasUsableProductionBuild(clientDir, themeId);
+    const needsRebuild = adminSynced ||
+        apiProxyPatched ||
+        shouldRebuildThemeAfterAdminSync(clientDir) ||
+        !hasUsableProductionBuild(clientDir, themeId);
     if (!needsRebuild)
         return;
     console.log('[ReactPress Client] Client not built yet. Building…');
@@ -47,30 +55,9 @@ function ensureBuilt() {
     if (build.status !== 0)
         process.exit(build.status || 1);
 }
-function startWithPm2() {
-    ensureBuilt();
-    const [cmd, cmdArgs] = runStartCommand();
-    const visitorPort = process.env.CLIENT_PORT || process.env.PORT || '3001';
-    const apiPort = process.env.SERVER_PORT || '3002';
-    const nginxEntry = (process.env.REACTPRESS_NGINX_ENTRY_URL || process.env.NGINX_ENTRY_URL || '')
-        .replace(/\/$/, '');
-    const pm2Env = {
-        ...process.env,
-        NODE_ENV: 'production',
-        PORT: String(visitorPort),
-        CLIENT_PORT: String(visitorPort),
-        REACTPRESS_ORIGINAL_CWD: originalCwd,
-        REACTPRESS_THEME_DIR: clientDir,
-        REACTPRESS_API_URL: process.env.REACTPRESS_API_URL || `http://127.0.0.1:${apiPort}/api`,
-        SERVER_API_URL: process.env.SERVER_API_URL || `http://127.0.0.1:${apiPort}/api`,
-        NEXT_PUBLIC_REACTPRESS_API_URL: process.env.NEXT_PUBLIC_REACTPRESS_API_URL ||
-            (nginxEntry ? `${nginxEntry}/api` : `http://127.0.0.1:${apiPort}/api`),
-        ...(nginxEntry
-            ? { REACTPRESS_NGINX_ENTRY_URL: nginxEntry, NGINX_ENTRY_URL: nginxEntry }
-            : { REACTPRESS_SKIP_DEV_PORT_REDIRECT: '1' }),
-    };
+function buildPm2ClientArgs(cmd, cmdArgs) {
     const pm2Mem = getPm2ClientMemoryRestart();
-    const pm2Args = cmd === 'node'
+    return cmd === 'node'
         ? [
             'start',
             cmd,
@@ -79,6 +66,7 @@ function startWithPm2() {
             '--update-env',
             '--max-memory-restart',
             pm2Mem,
+            '-f',
             '--',
             ...cmdArgs,
         ]
@@ -90,16 +78,47 @@ function startWithPm2() {
             '--update-env',
             '--max-memory-restart',
             pm2Mem,
+            '-f',
             '--',
             ...cmdArgs,
         ];
-    const child = spawn('pm2', pm2Args, { stdio: 'inherit', cwd: clientDir, env: pm2Env });
+}
+function startWithPm2() {
+    ensureBuilt();
+    const [cmd, cmdArgs] = runStartCommand();
+    const pm2Env = productionThemeEnv();
+    const pm2Bin = resolvePm2Bin(originalCwd) || 'pm2';
+    const pm2Args = buildPm2ClientArgs(cmd, cmdArgs);
+    const child = spawn(pm2Bin, pm2Args, { stdio: 'inherit', cwd: clientDir, env: pm2Env, shell: cmd !== 'node' });
     child.on('close', (code) => process.exit(code ?? 0));
     child.on('error', (err) => {
-        console.error('[ReactPress Client] PM2 failed:', err);
+        console.error('[ReactPress Client] Failed to start site:', err);
         process.exit(1);
     });
 }
+function startWithPm2Background() {
+    ensureBuilt();
+    const [cmd, cmdArgs] = runStartCommand();
+    const pm2Env = productionThemeEnv();
+    const pm2Bin = resolvePm2Bin(originalCwd);
+    if (!pm2Bin) {
+        startWithNodeBackground();
+        return;
+    }
+    const result = spawnSync(pm2Bin, buildPm2ClientArgs(cmd, cmdArgs), {
+        cwd: clientDir,
+        env: pm2Env,
+        stdio: 'inherit',
+        shell: cmd !== 'node' && process.platform === 'win32',
+    });
+    if (result.status !== 0) {
+        console.warn('[ReactPress Client] Falling back to background node start');
+        startWithNodeBackground();
+        return;
+    }
+    console.log('[ReactPress Client] Site started in background');
+    process.exit(0);
+}
 function productionThemeEnv() {
     const visitorPort = process.env.CLIENT_PORT || process.env.PORT || '3001';
     const apiPort = process.env.SERVER_PORT || '3002';
@@ -121,6 +140,49 @@ function productionThemeEnv() {
         REACTPRESS_SKIP_DEV_PORT_REDIRECT: '1',
     };
 }
+function resolveBackgroundStartCommand() {
+    if (startScript) {
+        return { cmd: 'node', args: [startScript], env: {} };
+    }
+    const env = productionThemeEnv();
+    const port = String(env.PORT || '3001');
+    const nextBin = path.join(clientDir, 'node_modules', 'next', 'dist', 'bin', 'next');
+    if (fs.existsSync(nextBin)) {
+        return {
+            cmd: process.execPath,
+            args: [nextBin, 'start', '-p', port],
+            env: { INIT_CWD: clientDir },
+        };
+    }
+    return { cmd: 'npm', args: ['run', 'start'], env: {}, shell: process.platform === 'win32' };
+}
+function startWithNodeBackground() {
+    ensureBuilt();
+    const { cmd, args: cmdArgs, env: envExtra = {}, shell = false } = resolveBackgroundStartCommand();
+    const logDir = path.join(originalCwd, '.reactpress', 'logs', 'client');
+    fs.mkdirSync(logDir, { recursive: true });
+    const outPath = path.join(logDir, 'stdout.log');
+    const errPath = path.join(logDir, 'stderr.log');
+    const outFd = fs.openSync(outPath, 'a');
+    const errFd = fs.openSync(errPath, 'a');
+    const child = spawn(cmd, cmdArgs, {
+        detached: true,
+        stdio: ['ignore', outFd, errFd],
+        cwd: clientDir,
+        shell,
+        env: {
+            ...productionThemeEnv(),
+            ...envExtra,
+        },
+    });
+    child.unref();
+    fs.closeSync(outFd);
+    fs.closeSync(errFd);
+    const { writeClientPid } = require('../lib/process');
+    writeClientPid(originalCwd, child.pid);
+    console.log(`[ReactPress Client] Started in background (pid ${child.pid})`);
+    process.exit(0);
+}
 function startWithNode() {
     ensureBuilt();
     process.chdir(clientDir);
@@ -135,6 +197,12 @@ function startWithNode() {
 if (usePM2) {
     startWithPm2();
 }
+else if (usePm2Background) {
+    startWithPm2Background();
+}
+else if (useBackground) {
+    startWithNodeBackground();
+}
 else {
     startWithNode();
 }

package/out/bin/reactpress.js

@@ -13,8 +13,8 @@ const { brand, divider } = require('../ui/theme');
 const { initMonorepoProject, isMonorepoCheckout } = require('../lib/bootstrap');
 const { initProject } = require('../core/services/init');
 const { runLifecycleCommand } = require('../lib/lifecycle');
-const { runNodeScript } = require('../lib/spawn');
-const { getThemeBin, getCliVersion } = require('../lib/paths');
+const { startClientInBackground } = require('../lib/client-lifecycle');
+const { getCliVersion } = require('../lib/paths');
 const { loadServerSiteUrl, loadAdminConsoleUrl, loadClientSiteUrl, getApiPrefix, } = require('../lib/http');
 const { t } = require('../lib/i18n');
 const { describeProject } = require('../lib/project-type');
@@ -36,6 +36,21 @@ const LEGACY_COMMANDS = new Set([
     'desktop',
     'client',
 ]);
+function attachLogsOptions(cmd) {
+    return cmd
+        .option('--tail <n>', t('cli.logs.tailOption'), '50')
+        .option('--source <name>', t('cli.logs.sourceOption'), 'error')
+        .option('--grep <pattern>', t('cli.logs.grepOption'))
+        .option('--list', t('cli.logs.listOption'));
+}
+function createLogsAction() {
+    return async (directory, options) => {
+        const projectRoot = path.resolve(directory || '.');
+        process.env.REACTPRESS_ORIGINAL_CWD = projectRoot;
+        const code = await runDoctorLogs(projectRoot, options);
+        process.exit(code);
+    };
+}
 if (!process.env.REACTPRESS_LOCAL_MODE) {
     process.env.REACTPRESS_LOCAL_MODE = '1';
 }
@@ -68,26 +83,22 @@ async function startServices(projectRoot) {
         process.exit(code);
     const { ensureDefaultTheme } = require('../core/services/theme-bootstrap');
     await ensureDefaultTheme(projectRoot);
-    printRunningPanel(projectRoot);
     try {
-        const themeBin = getThemeBin(projectRoot);
-        const { resolveThemeDirectory, readActiveThemeManifest } = require('../lib/theme-runtime');
-        const { activeTheme } = readActiveThemeManifest(projectRoot);
-        const themeDir = resolveThemeDirectory(projectRoot, activeTheme);
-        await runNodeScript(themeBin, [], {
-            cwd: projectRoot,
-            env: themeDir ? { REACTPRESS_THEME_DIR: themeDir } : undefined,
-        });
+        const clientCode = await startClientInBackground(projectRoot);
+        if (clientCode !== 0)
+            process.exit(clientCode);
     }
     catch (err) {
         if (err.code === 'REACTPRESS_THEME_NOT_FOUND' ||
             err.code === 'REACTPRESS_THEME_BIN_NOT_FOUND') {
+            printRunningPanel(projectRoot);
             console.log(brand.dim(t('init.apiOnlyHint')));
             return;
         }
         console.error(chalk.red('[reactpress]'), err.message || err);
         process.exit(err.exitCode ?? 1);
     }
+    printRunningPanel(projectRoot);
 }
 async function runInit(directory = '.', options = { force: false }) {
     const projectRoot = path.resolve(directory);
@@ -111,22 +122,22 @@ program
     .action(async (directory, options) => {
     await runInit(directory || '.', options);
 });
+attachLogsOptions(program.command('logs [directory]').description(t('cli.logs.description'))).action(createLogsAction());
+program
+    .command('stop [directory]')
+    .description(t('cli.stop.description'))
+    .action(async (directory) => {
+    const projectRoot = path.resolve(directory || '.');
+    process.env.REACTPRESS_ORIGINAL_CWD = projectRoot;
+    await runLifecycleCommand('stop', projectRoot);
+    process.exit(0);
+});
 const doctorCommand = program
     .command('doctor')
     .description(t('cli.doctor.description'));
-doctorCommand
+attachLogsOptions(doctorCommand
     .command('logs [directory]')
-    .description(t('cli.doctor.logs.description'))
-    .option('--tail <n>', t('cli.doctor.logs.tailOption'), '50')
-    .option('--source <name>', t('cli.doctor.logs.sourceOption'), 'error')
-    .option('--grep <pattern>', t('cli.doctor.logs.grepOption'))
-    .option('--list', t('cli.doctor.logs.listOption'))
-    .action(async (directory, options) => {
-    const projectRoot = path.resolve(directory || '.');
-    process.env.REACTPRESS_ORIGINAL_CWD = projectRoot;
-    const code = await runDoctorLogs(projectRoot, options);
-    process.exit(code);
-});
+    .description(t('cli.logs.descriptionAlias'))).action(createLogsAction());
 doctorCommand
     .command('check [directory]', { isDefault: true })
     .description(t('cli.doctor.description'))
@@ -144,7 +155,8 @@ program.on('--help', () => {
     for (const line of [
         t('cli.help.init'),
         t('cli.help.doctor'),
-        t('cli.help.doctorLogs'),
+        t('cli.help.logs'),
+        t('cli.help.stop'),
         t('cli.help.zeroDep'),
     ]) {
         console.log(brand.dim(line));

package/out/core/services/local-site.js

@@ -123,10 +123,11 @@ async function initLocalProject(projectRoot, options = {}) {
     const paths = (0, paths_1.getProjectPaths)(projectRoot);
     const port = options.port ?? 3002;
     if ((await fs_extra_1.default.pathExists(paths.configPath)) && !options.force) {
+        const { t } = require('../../lib/i18n');
         return {
-            ok: false,
+            ok: true,
             projectRoot,
-            message: '目录已是 ReactPress 项目。使用 --force 覆盖配置。',
+            message: t('init.alreadyInitialized'),
         };
     }
     await fs_extra_1.default.ensureDir(projectRoot);

package/out/lib/client-lifecycle.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-nocheck
+const ora = require('ora');
+const { getThemeBin } = require('./paths');
+const { loadClientSiteUrl } = require('./http');
+const { runNodeScript } = require('./spawn');
+const { readClientPid, isProcessRunning, clearClientPidFile } = require('./process');
+const { PM2_CLIENT_APP, isPm2RuntimeAvailable, isPm2AppOnline, getPm2AppPid, } = require('./pm2-runtime');
+const { t } = require('./i18n');
+function stopClient(projectRoot) {
+    const pid = readClientPid(projectRoot);
+    if (pid && isProcessRunning(pid)) {
+        try {
+            process.kill(pid, 'SIGTERM');
+            console.log(t('lifecycle.clientStopped', { pid }));
+        }
+        catch (err) {
+            console.warn(t('lifecycle.stopClientPidFailed', { pid }), err.message);
+        }
+    }
+    clearClientPidFile(projectRoot);
+}
+async function startClientInBackground(projectRoot) {
+    const preferPm2 = isPm2RuntimeAvailable(projectRoot);
+    if (preferPm2 && isPm2AppOnline(projectRoot, PM2_CLIENT_APP)) {
+        const pid = getPm2AppPid(projectRoot, PM2_CLIENT_APP);
+        console.log(t('lifecycle.clientAlreadyRunning', { pid: pid ?? PM2_CLIENT_APP }));
+        return 0;
+    }
+    const existing = readClientPid(projectRoot);
+    if (!preferPm2 && existing && isProcessRunning(existing)) {
+        console.log(t('lifecycle.clientAlreadyRunning', { pid: existing }));
+        return 0;
+    }
+    clearClientPidFile(projectRoot);
+    const themeBin = getThemeBin(projectRoot);
+    const { resolveThemeDirectory, readActiveThemeManifest } = require('./theme-runtime');
+    const { activeTheme } = readActiveThemeManifest(projectRoot);
+    const themeDir = resolveThemeDirectory(projectRoot, activeTheme);
+    const bgFlag = preferPm2 ? '--pm2-bg' : '--bg';
+    await runNodeScript(themeBin, [bgFlag], {
+        cwd: projectRoot,
+        env: themeDir ? { REACTPRESS_THEME_DIR: themeDir } : undefined,
+    });
+    const supervised = isPm2AppOnline(projectRoot, PM2_CLIENT_APP);
+    const pid = supervised ? getPm2AppPid(projectRoot, PM2_CLIENT_APP) : readClientPid(projectRoot);
+    if (!supervised && !pid) {
+        console.error(t('lifecycle.clientPidMissing'));
+        return 1;
+    }
+    const clientUrl = loadClientSiteUrl(projectRoot);
+    const spinner = ora({
+        text: t('lifecycle.waitingClient', { url: clientUrl }),
+        color: 'magenta',
+        spinner: 'dots',
+    }).start();
+    const deadline = Date.now() + 180_000;
+    let ready = false;
+    while (Date.now() < deadline) {
+        const alive = supervised
+            ? isPm2AppOnline(projectRoot, PM2_CLIENT_APP)
+            : pid
+                ? isProcessRunning(pid)
+                : false;
+        if (!alive) {
+            spinner.fail(t('lifecycle.clientExitedEarly', { pid: pid ?? '—' }));
+            return 1;
+        }
+        if (await require('./http').isHttpResponding(clientUrl)) {
+            ready = true;
+            break;
+        }
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    if (!ready) {
+        spinner.fail(t('lifecycle.clientTimeout', { url: clientUrl }));
+        return 1;
+    }
+    const readyPid = supervised ? getPm2AppPid(projectRoot, PM2_CLIENT_APP) ?? PM2_CLIENT_APP : pid;
+    spinner.succeed(t('lifecycle.clientReady', { url: clientUrl, pid: readyPid }));
+    return 0;
+}
+module.exports = {
+    startClientInBackground,
+    stopClient,
+};
+//# sourceMappingURL=client-lifecycle.js.map

package/out/lib/i18n/strings.js

@@ -76,6 +76,13 @@ const STRINGS = {
         'cli.doctor.logs.sourceOption': 'Log source: error, request, response, or all',
         'cli.doctor.logs.grepOption': 'Filter log lines by regex',
         'cli.doctor.logs.listOption': 'List available log files only',
+        'cli.logs.description': 'View recent API logs (error, request, response)',
+        'cli.logs.descriptionAlias': 'View API logs (alias of reactpress logs)',
+        'cli.logs.tailOption': 'Number of lines to show per log file',
+        'cli.logs.sourceOption': 'Log source: error, request, response, or all',
+        'cli.logs.grepOption': 'Filter log lines by regex',
+        'cli.logs.listOption': 'List available log files only',
+        'cli.stop.description': 'Stop API and site services started by init',
         'cli.db.description': 'Database operations',
         'cli.db.backup': 'Backup current project database with mysqldump',
         'cli.db.backup.output': 'Output SQL file path',
@@ -86,7 +93,9 @@ const STRINGS = {
         'cli.help.examples': 'Usage:',
         'cli.help.init': '  reactpress init [dir]        Initialize project',
         'cli.help.doctor': '  reactpress doctor            Diagnose environment issues',
-        'cli.help.doctorLogs': '  reactpress doctor logs       Tail API logs for quick debugging',
+        'cli.help.logs': '  reactpress logs              Tail API logs for quick debugging',
+        'cli.help.stop': '  reactpress stop              Stop the background API',
+        'cli.help.doctorLogs': '  reactpress doctor logs       Alias of reactpress logs',
         'cli.help.zeroDep': '  Zero deps: Node.js 18+ only — no Docker, nginx, or MySQL',
         'cli.plugin.description': 'Manage ReactPress plugins',
         'cli.plugin.install.description': 'Install a local plugin into .reactpress/plugins',
@@ -112,10 +121,11 @@ const STRINGS = {
         'init.label.site': 'Site',
         'init.label.admin': 'Admin',
         'init.label.api': 'API',
-        'init.hint': 'Admin login: admin / admin · Press Ctrl+C to stop',
+        'init.hint': 'Login: admin / admin · Services run in background · Stop: reactpress stop · Logs: reactpress logs',
+        'init.alreadyInitialized': 'Project already initialized — ensuring services are running',
         'init.apiOnlyHint': 'API is running. Install a theme in Admin → Appearance to enable the public site.',
         'init.unknownCommand': 'Unknown command: {cmd}',
-        'init.useInitOnly': 'ReactPress 4 supports: reactpress init · reactpress doctor',
+        'init.useInitOnly': 'ReactPress 4: reactpress init · doctor · logs · stop',
         'banner.subtitle': '· Publishing platform · v4.0',
         'banner.tagline': 'Zero deps · SQLite · ship in ~60s',
         /** Left label for the decorative pulse bar (not a URL — the repo link
@@ -415,8 +425,10 @@ const STRINGS = {
         'doctor.checking': 'Checking {name}…',
         'doctor.summary': '{passed} passed  ·  {failed} failed  ·  {total} total',
         'doctor.fixesHeader': 'Suggested fixes',
-        'doctor.logsHint': 'Tip: run reactpress doctor logs --tail 100 to inspect API error logs',
-        'doctor.logs.title': 'ReactPress Doctor · Logs',
+        'doctor.logsHint': 'Tip: run reactpress logs --tail 100 to inspect API error logs',
+        'logs.title': 'ReactPress Logs',
+        'logs.subtitle': 'API log viewer',
+        'doctor.logs.title': 'ReactPress Logs',
         'doctor.logs.subtitle': 'API log viewer',
         'doctor.logs.dir': 'Log dir   {path}',
         'doctor.logs.empty': 'No API log files found yet.',
@@ -428,7 +440,7 @@ const STRINGS = {
         'doctor.logs.noPid': 'No API pid file at {path}',
         'doctor.logs.pidRunning': 'API pid {pid} (recorded in {path})',
         'doctor.logs.pidStale': 'Stale pid {pid} in {path} — process not running',
-        'doctor.logs.moreHint': 'Use --tail, --source, --grep, or --list for more control (see reactpress doctor logs --help)',
+        'doctor.logs.moreHint': 'Use --tail, --source, --grep, or --list for more control (see reactpress logs --help)',
         'status.title': 'ReactPress project status',
         'status.dir': 'Project     {path}',
         'status.apiSource': 'API source  {source}',
@@ -489,6 +501,14 @@ const STRINGS = {
         'lifecycle.apiTimeout120': '[reactpress] API not ready within 120s: {url}',
         'lifecycle.apiExitedEarly': '[reactpress] API process exited early (pid {pid})',
         'lifecycle.apiReady': '[reactpress] API ready: {url}',
+        'lifecycle.clientStopped': '[reactpress] Site process stopped (pid {pid})',
+        'lifecycle.stopClientPidFailed': '[reactpress] Failed to stop site pid {pid}:',
+        'lifecycle.clientAlreadyRunning': '[reactpress] Site already running (pid {pid})',
+        'lifecycle.clientPidMissing': '[reactpress] Site failed to start (no pid recorded)',
+        'lifecycle.waitingClient': 'Waiting for site at {url}…',
+        'lifecycle.clientTimeout': '[reactpress] Site not ready within 180s: {url}',
+        'lifecycle.clientExitedEarly': '[reactpress] Site process exited early (pid {pid})',
+        'lifecycle.clientReady': '[reactpress] Site ready: {url} (pid {pid})',
         'lifecycle.apiStatusTitle': '[reactpress] API status',
         'lifecycle.source': '  Source: {source}',
         'lifecycle.source.monorepo': 'monorepo server/',
@@ -500,6 +520,7 @@ const STRINGS = {
         'lifecycle.httpReachable': 'reachable',
         'lifecycle.httpUnreachable': 'unreachable',
         'lifecycle.unknownCommand': 'Unknown lifecycle command: {command}',
+        'lifecycle.processSupervisorFallback': '[reactpress] Process supervisor unavailable — falling back to background node start',
         'docker.stopping': '[reactpress] Stopping Docker services…',
         'docker.stopped': '[reactpress] Docker services stopped.',
         'docker.stopFailed': '[reactpress] Failed to stop Docker:',
@@ -730,6 +751,13 @@ const STRINGS = {
         'cli.doctor.logs.sourceOption': '日志类型：error、request、response 或 all',
         'cli.doctor.logs.grepOption': '用正则过滤日志行',
         'cli.doctor.logs.listOption': '仅列出可用日志文件',
+        'cli.logs.description': '查看 API 日志（error / request / response）',
+        'cli.logs.descriptionAlias': '查看 API 日志（同 reactpress logs）',
+        'cli.logs.tailOption': '每个日志文件显示的行数',
+        'cli.logs.sourceOption': '日志类型：error、request、response 或 all',
+        'cli.logs.grepOption': '用正则过滤日志行',
+        'cli.logs.listOption': '仅列出可用日志文件',
+        'cli.stop.description': '停止 init 启动的 API 与站点服务',
         'cli.db.description': '数据库运维',
         'cli.db.backup': '使用 mysqldump 备份当前项目数据库',
         'cli.db.backup.output': '输出 SQL 文件路径',
@@ -740,7 +768,9 @@ const STRINGS = {
         'cli.help.examples': '用法:',
         'cli.help.init': '  reactpress init [dir]        初始化项目',
         'cli.help.doctor': '  reactpress doctor            诊断环境问题',
-        'cli.help.doctorLogs': '  reactpress doctor logs       查看 API 日志，快速定位问题',
+        'cli.help.logs': '  reactpress logs              查看 API 日志，快速定位问题',
+        'cli.help.stop': '  reactpress stop              停止后台 API',
+        'cli.help.doctorLogs': '  reactpress doctor logs       reactpress logs 的别名',
         'cli.help.zeroDep': '  零依赖：仅需 Node.js 18+，无需 Docker、nginx 或 MySQL',
         'cli.plugin.description': '管理 ReactPress 插件',
         'cli.plugin.install.description': '安装本地插件到 .reactpress/plugins',
@@ -766,10 +796,11 @@ const STRINGS = {
         'init.label.site': '站点',
         'init.label.admin': '后台',
         'init.label.api': 'API',
-        'init.hint': '后台账号：admin / admin · 按 Ctrl+C 停止',
+        'init.hint': '账号 admin / admin · 服务已在后台运行 · 停止：reactpress stop · 日志：reactpress logs',
+        'init.alreadyInitialized': '项目已初始化 — 正在确保服务运行',
         'init.apiOnlyHint': 'API 已运行。请在管理后台「外观 → 主题」安装主题以启用访客站。',
         'init.unknownCommand': '未知命令：{cmd}',
-        'init.useInitOnly': 'ReactPress 4 支持：reactpress init · reactpress doctor',
+        'init.useInitOnly': 'ReactPress 4 支持：reactpress init · doctor · logs · stop',
         'banner.subtitle': '· 发布平台 · v4.0',
         'banner.tagline': '零依赖 · SQLite · 约 60 秒上线',
         /** 左侧装饰性进度条标签（不是网址；仓库地址放在卡片顶部 Title 正下方）。 */
@@ -1068,8 +1099,10 @@ const STRINGS = {
         'doctor.checking': '正在检查 {name}…',
         'doctor.summary': '通过 {passed}  ·  失败 {failed}  ·  共 {total} 项',
         'doctor.fixesHeader': '修复建议',
-        'doctor.logsHint': '提示：运行 reactpress doctor logs --tail 100 查看 API 错误日志',
-        'doctor.logs.title': 'ReactPress Doctor · 日志',
+        'doctor.logsHint': '提示：运行 reactpress logs --tail 100 查看 API 错误日志',
+        'logs.title': 'ReactPress 日志',
+        'logs.subtitle': 'API 日志查看',
+        'doctor.logs.title': 'ReactPress 日志',
         'doctor.logs.subtitle': 'API 日志查看',
         'doctor.logs.dir': '日志目录  {path}',
         'doctor.logs.empty': '尚未找到 API 日志文件。',
@@ -1081,7 +1114,7 @@ const STRINGS = {
         'doctor.logs.noPid': '未找到 API pid 文件：{path}',
         'doctor.logs.pidRunning': 'API 进程 pid {pid}（记录在 {path}）',
         'doctor.logs.pidStale': 'pid 文件 {path} 中的 {pid} 已失效（进程未运行）',
-        'doctor.logs.moreHint': '可用 --tail、--source、--grep、--list 进一步筛选（见 reactpress doctor logs --help）',
+        'doctor.logs.moreHint': '可用 --tail、--source、--grep、--list 进一步筛选（见 reactpress logs --help）',
         'status.title': 'ReactPress 项目状态',
         'status.dir': '项目目录    {path}',
         'status.apiSource': 'API 来源    {source}',
@@ -1142,6 +1175,14 @@ const STRINGS = {
         'lifecycle.apiTimeout120': '[reactpress] API 在 120s 内未就绪: {url}',
         'lifecycle.apiExitedEarly': '[reactpress] API 进程已提前退出 (pid {pid})',
         'lifecycle.apiReady': '[reactpress] API 已就绪: {url}',
+        'lifecycle.clientStopped': '[reactpress] 已停止站点进程 (pid {pid})',
+        'lifecycle.stopClientPidFailed': '[reactpress] 停止站点 pid {pid} 失败:',
+        'lifecycle.clientAlreadyRunning': '[reactpress] 站点已在运行 (pid {pid})',
+        'lifecycle.clientPidMissing': '[reactpress] 站点启动失败（未记录 pid）',
+        'lifecycle.waitingClient': '等待站点就绪 {url}…',
+        'lifecycle.clientTimeout': '[reactpress] 站点在 180s 内未就绪: {url}',
+        'lifecycle.clientExitedEarly': '[reactpress] 站点进程已提前退出 (pid {pid})',
+        'lifecycle.clientReady': '[reactpress] 站点已就绪: {url} (pid {pid})',
         'lifecycle.apiStatusTitle': '[reactpress] API 状态',
         'lifecycle.source': '  来源: {source}',
         'lifecycle.source.monorepo': 'monorepo server/',
@@ -1153,6 +1194,7 @@ const STRINGS = {
         'lifecycle.httpReachable': '可访问',
         'lifecycle.httpUnreachable': '不可访问',
         'lifecycle.unknownCommand': '未知 lifecycle 命令: {command}',
+        'lifecycle.processSupervisorFallback': '[reactpress] 进程守护不可用 — 已回退到后台 Node 启动',
         'docker.stopping': '[reactpress] 正在停止 Docker 服务…',
         'docker.stopped': '[reactpress] Docker 服务已停止。',
         'docker.stopFailed': '[reactpress] 停止 Docker 失败:',