Harden auth/vault path sanitization and clean WeKnora docs
This commit is contained in:
Agent Board
@@ -0,0 +1,686 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
/**
|
||||
* 热启动 mnote-web 单入口，以及按需启用的 FastAPI。
|
||||
* Page AI 仅走 Pi Lab（/api/page-ai/pi/*）；不再启动 OpenCode。
|
||||
* 可使用以下环境变量调整行为：
|
||||
* - ENABLE_BACKEND：设为 "1" or "true" 时启用默认 FastAPI 后端
|
||||
* - BACKEND_CMD：覆盖 FastAPI 启动命令；设置后即视为显式启用后端
|
||||
* - SKIP_BACKEND：设为 "1" or "true" 可强制跳过 FastAPI 后端
|
||||
* - MNOTE_CONTROL_PLANE_BACKEND：控制面后端，默认 libsql-local；可设 turso-remote / turso-local-replica / turso-synced
|
||||
* - MNOTE_TURSO_LOCAL_PATH：libsql-local 本地库路径，默认 /mnt/Data1T/Mnote_data/control-plane/control-plane-libsql.db
|
||||
* - MNOTE_PAGE_AI_PI_WARMUP：设为 "1" or "true" 时，在 mnote-web 可用后预启动 Pi Lab runtime / MCP cache
|
||||
* - MNOTE_PAGE_AI_PI_WARMUP_SEND：设为 "1" or "true" 时，额外发送一次轻量 prompt 预热模型首包（会产生真实模型请求）
|
||||
* - PYTHON_BIN：只在 BACKEND_CMD 未覆盖时，设置 Python 可执行文件，默认 "python"
|
||||
*/
|
||||
|
||||
const { spawn, execSync } = require("child_process");
|
||||
const path = require("path");
|
||||
const net = require("net");
|
||||
const fs = require("fs");
|
||||
const { runPiLabWarmup } = require("./lib/pi-lab-warmup");
|
||||
|
||||
const rootDir = path.resolve(__dirname, "..");
|
||||
const backendDir = path.join(rootDir, "wolai-backend");
|
||||
|
||||
function resolveBackendExecutable(envName, fallbackName) {
|
||||
const fromEnv = (process.env[envName] || "").trim();
|
||||
if (fromEnv) return fromEnv;
|
||||
|
||||
const isWin = process.platform === "win32";
|
||||
const candidates = isWin
|
||||
? [
|
||||
path.join(backendDir, ".venv", "Scripts", `${fallbackName}.exe`),
|
||||
path.join(backendDir, ".venv312", "Scripts", `${fallbackName}.exe`),
|
||||
path.join(backendDir, "venv", "Scripts", `${fallbackName}.exe`),
|
||||
]
|
||||
: [
|
||||
path.join(backendDir, ".venv-linux", "bin", fallbackName),
|
||||
path.join(backendDir, ".venv", "bin", fallbackName),
|
||||
path.join(backendDir, "venv", "bin", fallbackName),
|
||||
];
|
||||
|
||||
for (const candidate of candidates) {
|
||||
if (fs.existsSync(candidate)) {
|
||||
return candidate;
|
||||
}
|
||||
}
|
||||
|
||||
return fallbackName;
|
||||
}
|
||||
|
||||
const pythonBin = resolveBackendExecutable("PYTHON_BIN", "python");
|
||||
const backendPortFromEnv = Number(process.env.BACKEND_PORT || 8000);
|
||||
const defaultControlPlaneDir = "/mnt/Data1T/Mnote_data/control-plane";
|
||||
|
||||
function hasCommand(command) {
|
||||
try {
|
||||
execSync(`command -v ${command}`, { stdio: "ignore", shell: "/bin/sh" });
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
function shouldUseUvBackendRuntime() {
|
||||
if (String(process.env.PYTHON_BIN || "").trim()) return false;
|
||||
if (!fs.existsSync(path.join(backendDir, "requirements.txt"))) return false;
|
||||
return hasCommand("uv");
|
||||
}
|
||||
|
||||
function buildDefaultBackendCommand(port) {
|
||||
if (shouldUseUvBackendRuntime()) {
|
||||
return `uv run --with-requirements requirements.txt python -m uvicorn app.main:app --reload --port ${port}`;
|
||||
}
|
||||
return `${pythonBin} -m uvicorn app.main:app --reload --port ${port}`;
|
||||
}
|
||||
|
||||
function isEnabledEnv(value) {
|
||||
const normalized = String(value || "").toLowerCase();
|
||||
return normalized === "1" || normalized === "true";
|
||||
}
|
||||
|
||||
function shouldStartBackend(env = process.env) {
|
||||
if (isEnabledEnv(env.SKIP_BACKEND)) return false;
|
||||
if (String(env.BACKEND_CMD || "").trim()) return true;
|
||||
return isEnabledEnv(env.ENABLE_BACKEND);
|
||||
}
|
||||
|
||||
function resolveRuntimePlan(env = process.env) {
|
||||
const frontendPort = Number(env.FRONTEND_PORT || 3000);
|
||||
const skipGateway = false;
|
||||
const publicPort = Number.isFinite(frontendPort) ? Math.floor(frontendPort) : 3000;
|
||||
const controlPlaneBackend = String(env.MNOTE_CONTROL_PLANE_BACKEND || "libsql-local").trim() || "libsql-local";
|
||||
if (controlPlaneBackend === "sqlite") {
|
||||
throw new Error("dev:hot 不再支持 SQLite control-plane fallback；请使用 libsql-local/turso-local-replica/turso-remote/turso-synced");
|
||||
}
|
||||
const controlPlaneEnv = {
|
||||
MNOTE_CONTROL_PLANE_BACKEND: controlPlaneBackend,
|
||||
};
|
||||
if (controlPlaneBackend === "libsql-local" || controlPlaneBackend === "turso-local" || controlPlaneBackend === "turso") {
|
||||
controlPlaneEnv.MNOTE_TURSO_LOCAL_PATH =
|
||||
env.MNOTE_TURSO_LOCAL_PATH || path.join(defaultControlPlaneDir, "control-plane-libsql.db");
|
||||
} else if (controlPlaneBackend === "turso-local-replica" || controlPlaneBackend === "turso-remote-replica") {
|
||||
controlPlaneEnv.MNOTE_TURSO_LOCAL_REPLICA_PATH =
|
||||
env.MNOTE_TURSO_LOCAL_REPLICA_PATH || path.join(defaultControlPlaneDir, "control-plane-replica.db");
|
||||
} else if (controlPlaneBackend === "turso-synced") {
|
||||
controlPlaneEnv.MNOTE_TURSO_SYNCED_PATH =
|
||||
env.MNOTE_TURSO_SYNCED_PATH || env.MNOTE_TURSO_LOCAL_REPLICA_PATH || path.join(defaultControlPlaneDir, "control-plane-synced.db");
|
||||
}
|
||||
|
||||
const plan = {
|
||||
skipGateway,
|
||||
publicPort,
|
||||
publicUrl: `http://localhost:${publicPort}`,
|
||||
mnoteWebCommand: env.MNOTE_WEB_CMD || "cargo run -p mnote-web --bin mnote-web",
|
||||
mnoteWebEnv: {
|
||||
MNOTE_WEB_BIND: env.MNOTE_WEB_BIND || `0.0.0.0:${publicPort}`,
|
||||
MNOTE_WEB_PUBLIC_BIND: env.MNOTE_WEB_PUBLIC_BIND || `127.0.0.1:${publicPort}`,
|
||||
MNOTE_KNOWLEDGE_PROVIDER: env.MNOTE_KNOWLEDGE_PROVIDER || "lightrag_legacy",
|
||||
...controlPlaneEnv,
|
||||
},
|
||||
};
|
||||
return plan;
|
||||
}
|
||||
|
||||
const runtimePlan = resolveRuntimePlan(process.env);
|
||||
const skipMnoteWebGateway = runtimePlan.skipGateway;
|
||||
|
||||
const tasks = [
|
||||
...(skipMnoteWebGateway
|
||||
? []
|
||||
: [
|
||||
{
|
||||
name: "mnote-web",
|
||||
command:
|
||||
process.env.MNOTE_WEB_CMD ||
|
||||
runtimePlan.mnoteWebCommand,
|
||||
cwd: path.join(rootDir, "rust"),
|
||||
},
|
||||
]),
|
||||
...(shouldStartBackend(process.env)
|
||||
? [
|
||||
{
|
||||
name: "backend",
|
||||
command:
|
||||
process.env.BACKEND_CMD ||
|
||||
buildDefaultBackendCommand(8000),
|
||||
cwd: backendDir,
|
||||
},
|
||||
]
|
||||
: []),
|
||||
];
|
||||
|
||||
function findTask(name) {
|
||||
return tasks.find((task) => task.name === name);
|
||||
}
|
||||
|
||||
const children = [];
|
||||
let shuttingDown = false;
|
||||
|
||||
async function isPortFree(host, port, timeoutMs = 400) {
|
||||
return await new Promise((resolve) => {
|
||||
const socket = net.createConnection({ host, port });
|
||||
const timer = setTimeout(() => {
|
||||
socket.destroy();
|
||||
resolve(true);
|
||||
}, timeoutMs);
|
||||
|
||||
socket.once("connect", () => {
|
||||
clearTimeout(timer);
|
||||
socket.end();
|
||||
resolve(false);
|
||||
});
|
||||
|
||||
socket.once("error", () => {
|
||||
clearTimeout(timer);
|
||||
resolve(true);
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
async function findFreePort(startPort) {
|
||||
let port = Number.isFinite(startPort) ? Math.floor(startPort) : 3000;
|
||||
port = Math.max(1, Math.min(65535, port));
|
||||
|
||||
// 最多尝试 20 个端口，避免无限循环。
|
||||
for (let i = 0; i < 20; i += 1) {
|
||||
// eslint-disable-next-line no-await-in-loop
|
||||
const free = await isPortFree("127.0.0.1", port);
|
||||
if (free) return port;
|
||||
port += 1;
|
||||
}
|
||||
|
||||
return startPort;
|
||||
}
|
||||
|
||||
function getListeningPidsByPort(port) {
|
||||
const pids = new Set();
|
||||
|
||||
if (process.platform !== "win32") {
|
||||
try {
|
||||
const out = execSync(`ss -ltnp 'sport = :${port}'`, { encoding: "utf8" });
|
||||
for (const match of out.matchAll(/pid=(\d+)/g)) {
|
||||
const pid = Number(match[1]);
|
||||
if (Number.isFinite(pid) && pid > 0) {
|
||||
pids.add(pid);
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// ignore
|
||||
}
|
||||
|
||||
if (pids.size > 0) {
|
||||
return [...pids];
|
||||
}
|
||||
|
||||
try {
|
||||
const out = execSync(`lsof -nP -iTCP:${port} -sTCP:LISTEN -t`, { encoding: "utf8" });
|
||||
for (const line of out.split(/\r?\n/)) {
|
||||
const pid = Number(line.trim());
|
||||
if (Number.isFinite(pid) && pid > 0) {
|
||||
pids.add(pid);
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// ignore
|
||||
}
|
||||
|
||||
return [...pids];
|
||||
}
|
||||
|
||||
try {
|
||||
// 说明：netstat 输出示例：
|
||||
// TCP 0.0.0.0:3000 0.0.0.0:0 LISTENING 12345
|
||||
const out = execSync("netstat -ano -p tcp", { encoding: "utf8" });
|
||||
for (const line of out.split(/\r?\n/)) {
|
||||
if (!line.includes(`:${port}`)) continue;
|
||||
if (!/LISTENING/i.test(line)) continue;
|
||||
const parts = line.trim().split(/\s+/);
|
||||
const pid = Number(parts[parts.length - 1]);
|
||||
if (Number.isFinite(pid) && pid > 0) {
|
||||
pids.add(pid);
|
||||
}
|
||||
}
|
||||
return [...pids];
|
||||
} catch {
|
||||
return [];
|
||||
}
|
||||
}
|
||||
|
||||
function getProcessNameByPid(pid) {
|
||||
if (process.platform !== "win32") {
|
||||
try {
|
||||
return execSync(`ps -p ${pid} -o comm=`, { encoding: "utf8" }).trim();
|
||||
} catch {
|
||||
return "";
|
||||
}
|
||||
}
|
||||
|
||||
try {
|
||||
// 输出为 CSV，示例：
|
||||
// "Image Name","PID","Session Name","Session#","Mem Usage"
|
||||
// "python.exe","12345","Console","1","12,345 K"
|
||||
const out = execSync(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`, {
|
||||
encoding: "utf8",
|
||||
}).trim();
|
||||
if (!out || /No tasks are running/i.test(out)) return "";
|
||||
const firstLine = out.split(/\r?\n/)[0].trim();
|
||||
if (!firstLine) return "";
|
||||
const cells = firstLine
|
||||
.split('","')
|
||||
.map((s) => s.replace(/^"/, "").replace(/"$/, ""));
|
||||
return (cells[0] || "").trim();
|
||||
} catch {
|
||||
return "";
|
||||
}
|
||||
}
|
||||
|
||||
function getProcessCommandByPid(pid) {
|
||||
if (process.platform === "win32") {
|
||||
try {
|
||||
const out = execSync(`wmic process where ProcessId=${pid} get CommandLine /value`, {
|
||||
encoding: "utf8",
|
||||
});
|
||||
return out.replace(/^CommandLine=/m, "").trim();
|
||||
} catch {
|
||||
return "";
|
||||
}
|
||||
}
|
||||
|
||||
try {
|
||||
return execSync(`ps -p ${pid} -o args=`, { encoding: "utf8" }).trim();
|
||||
} catch {
|
||||
return "";
|
||||
}
|
||||
}
|
||||
|
||||
function getProcessGroupByPid(pid) {
|
||||
if (process.platform === "win32") return pid;
|
||||
try {
|
||||
const pgid = Number(execSync(`ps -p ${pid} -o pgid=`, { encoding: "utf8" }).trim());
|
||||
return Number.isFinite(pgid) && pgid > 0 ? pgid : pid;
|
||||
} catch {
|
||||
return pid;
|
||||
}
|
||||
}
|
||||
|
||||
function terminatePid(pid) {
|
||||
if (process.platform === "win32") {
|
||||
execSync(`taskkill /PID ${pid} /T /F`, { stdio: "ignore" });
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
process.kill(pid, "SIGTERM");
|
||||
} catch {
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
function forceKillPid(pid) {
|
||||
if (process.platform === "win32") {
|
||||
execSync(`taskkill /PID ${pid} /T /F`, { stdio: "ignore" });
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
process.kill(pid, "SIGKILL");
|
||||
} catch {
|
||||
// 进程可能已经退出。
|
||||
}
|
||||
}
|
||||
|
||||
function terminateProcessGroup(pgid) {
|
||||
if (process.platform === "win32") {
|
||||
terminatePid(pgid);
|
||||
return;
|
||||
}
|
||||
try {
|
||||
process.kill(-pgid, "SIGTERM");
|
||||
} catch {
|
||||
terminatePid(pgid);
|
||||
}
|
||||
}
|
||||
|
||||
function forceKillProcessGroup(pgid) {
|
||||
if (process.platform === "win32") {
|
||||
forceKillPid(pgid);
|
||||
return;
|
||||
}
|
||||
try {
|
||||
process.kill(-pgid, "SIGKILL");
|
||||
} catch {
|
||||
forceKillPid(pgid);
|
||||
}
|
||||
}
|
||||
|
||||
function collectStaleMnoteWebCargoPids() {
|
||||
if (process.platform === "win32") return [];
|
||||
const currentPgid = getProcessGroupByPid(process.pid);
|
||||
try {
|
||||
const out = execSync("pgrep -f 'cargo (watch|run).*mnote-web|cargo-watch watch.*mnote-web'", {
|
||||
encoding: "utf8",
|
||||
});
|
||||
return out
|
||||
.split(/\r?\n/)
|
||||
.map((line) => Number(line.trim()))
|
||||
.filter((pid) => Number.isFinite(pid) && pid > 0 && pid !== process.pid)
|
||||
.filter((pid) => getProcessGroupByPid(pid) !== currentPgid)
|
||||
.filter((pid) => {
|
||||
const command = getProcessCommandByPid(pid);
|
||||
return !command.includes("pgrep -f");
|
||||
});
|
||||
} catch {
|
||||
return [];
|
||||
}
|
||||
}
|
||||
|
||||
async function stopStaleMnoteWebCargoProcesses() {
|
||||
const pids = collectStaleMnoteWebCargoPids();
|
||||
if (pids.length === 0) return true;
|
||||
|
||||
const safePids = pids.filter((pid) => {
|
||||
const command = getProcessCommandByPid(pid);
|
||||
return (
|
||||
command.includes("mnote-web") &&
|
||||
command.includes("cargo") &&
|
||||
(command.includes("cargo watch") ||
|
||||
command.includes("cargo-watch watch") ||
|
||||
command.includes("cargo run -p mnote-web"))
|
||||
);
|
||||
});
|
||||
if (safePids.length === 0) return true;
|
||||
|
||||
const pgids = [...new Set(safePids.map(getProcessGroupByPid).filter((pgid) => pgid > 0))];
|
||||
logPrefix("mnote-web", `检测到陈旧 cargo-watch/cargo run，先清理进程组：${pgids.join(", ")}`);
|
||||
pgids.forEach(terminateProcessGroup);
|
||||
|
||||
for (let i = 0; i < 20; i += 1) {
|
||||
// eslint-disable-next-line no-await-in-loop
|
||||
await new Promise((r) => setTimeout(r, 150));
|
||||
const remaining = collectStaleMnoteWebCargoPids().filter((pid) =>
|
||||
safePids.includes(pid) || pgids.includes(getProcessGroupByPid(pid)),
|
||||
);
|
||||
if (remaining.length === 0) return true;
|
||||
}
|
||||
|
||||
pgids.forEach(forceKillProcessGroup);
|
||||
return true;
|
||||
}
|
||||
|
||||
async function ensurePortFree(port, nameForLog) {
|
||||
const free = await isPortFree("127.0.0.1", port);
|
||||
if (free) return true;
|
||||
|
||||
const pids = getListeningPidsByPort(port);
|
||||
if (pids.length === 0) {
|
||||
logPrefix(nameForLog, `检测到端口 ${port} 被占用，但无法定位 PID。`);
|
||||
return false;
|
||||
}
|
||||
|
||||
let killPids = pids;
|
||||
// 安全策略：后端默认只结束 python 进程（避免误杀其他服务）。
|
||||
if (nameForLog === "backend") {
|
||||
killPids = pids.filter((pid) => {
|
||||
const procName = getProcessNameByPid(pid).toLowerCase();
|
||||
return procName.includes("python");
|
||||
});
|
||||
if (killPids.length === 0) {
|
||||
logPrefix(
|
||||
nameForLog,
|
||||
`检测到端口 ${port} 被占用，但没有可安全结束的 python 进程（PIDs=${pids.join(", ")}）。请手动释放端口后重试。`,
|
||||
);
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
logPrefix(nameForLog, `检测到端口 ${port} 被占用，准备重启（结束旧进程）：${killPids.join(", ")}`);
|
||||
for (const pid of killPids) {
|
||||
try {
|
||||
terminatePid(pid);
|
||||
} catch {
|
||||
// ignore
|
||||
}
|
||||
}
|
||||
|
||||
// 等待端口释放
|
||||
for (let i = 0; i < 20; i += 1) {
|
||||
// eslint-disable-next-line no-await-in-loop
|
||||
const ok = await isPortFree("127.0.0.1", port, 250);
|
||||
if (ok) return true;
|
||||
// eslint-disable-next-line no-await-in-loop
|
||||
await new Promise((r) => setTimeout(r, 150));
|
||||
}
|
||||
|
||||
if (process.platform !== "win32") {
|
||||
for (const pid of killPids) {
|
||||
forceKillPid(pid);
|
||||
}
|
||||
|
||||
for (let i = 0; i < 10; i += 1) {
|
||||
// eslint-disable-next-line no-await-in-loop
|
||||
const ok = await isPortFree("127.0.0.1", port, 250);
|
||||
if (ok) return true;
|
||||
// eslint-disable-next-line no-await-in-loop
|
||||
await new Promise((r) => setTimeout(r, 150));
|
||||
}
|
||||
}
|
||||
|
||||
logPrefix(nameForLog, `端口 ${port} 仍未释放，可能有其他程序占用。`);
|
||||
return false;
|
||||
}
|
||||
|
||||
async function isHttpHealthy(url) {
|
||||
if (!url) return false;
|
||||
try {
|
||||
const controller = new AbortController();
|
||||
const timer = setTimeout(() => controller.abort(), 1200);
|
||||
const response = await fetch(url, {
|
||||
method: "GET",
|
||||
headers: { accept: "application/json,text/plain,*/*" },
|
||||
signal: controller.signal,
|
||||
});
|
||||
clearTimeout(timer);
|
||||
return response.ok;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
function loadEnvFile(filePath) {
|
||||
if (!fs.existsSync(filePath)) return {};
|
||||
const content = fs.readFileSync(filePath, "utf8");
|
||||
return content
|
||||
.split(/\r?\n/)
|
||||
.filter((line) => line.trim() && !line.trim().startsWith("#"))
|
||||
.reduce((acc, line) => {
|
||||
const idx = line.indexOf("=");
|
||||
if (idx === -1) return acc;
|
||||
const key = line.slice(0, idx).trim();
|
||||
const value = line.slice(idx + 1).trim();
|
||||
acc[key] = value;
|
||||
return acc;
|
||||
}, {});
|
||||
}
|
||||
|
||||
// 约定：全局仅使用仓库根目录的 .env.all 作为配置来源（生产优先）。
|
||||
const envAllPath = path.join(rootDir, ".env.all");
|
||||
if (!fs.existsSync(envAllPath)) {
|
||||
console.error("[system] 缺少 .env.all：请在仓库根目录创建全局唯一 env 文件后重试。");
|
||||
process.exit(1);
|
||||
}
|
||||
const envFromAll = loadEnvFile(envAllPath);
|
||||
const mergedEnv = {
|
||||
...process.env,
|
||||
...envFromAll,
|
||||
};
|
||||
|
||||
function logPrefix(name, message) {
|
||||
console.log(`[${name}] ${message}`);
|
||||
}
|
||||
|
||||
function startTask(task) {
|
||||
logPrefix(task.name, `启动命令：${task.command}`);
|
||||
const child = spawn(task.command, {
|
||||
cwd: task.cwd,
|
||||
stdio: "inherit",
|
||||
shell: true,
|
||||
env: mergedEnv,
|
||||
});
|
||||
|
||||
child.on("exit", (code, signal) => {
|
||||
if (shuttingDown) {
|
||||
return;
|
||||
}
|
||||
const status =
|
||||
signal !== null ? `因信号 ${signal} 退出` : `退出码 ${code ?? "null"}`;
|
||||
logPrefix(task.name, `进程结束（${status}），准备清理其它任务。`);
|
||||
shutdown(code ?? 0);
|
||||
});
|
||||
|
||||
child.on("error", (err) => {
|
||||
logPrefix(task.name, `启动失败：${err.message}`);
|
||||
shutdown(1);
|
||||
});
|
||||
|
||||
children.push(child);
|
||||
}
|
||||
|
||||
function schedulePiLabWarmup(frontendUrl) {
|
||||
if (!isEnabledEnv(mergedEnv.MNOTE_PAGE_AI_PI_WARMUP)) return;
|
||||
const warmupEnv = {
|
||||
...mergedEnv,
|
||||
MNOTE_PAGE_AI_PI_WARMUP_BASE_URL: mergedEnv.MNOTE_PAGE_AI_PI_WARMUP_BASE_URL || frontendUrl,
|
||||
};
|
||||
runPiLabWarmup(warmupEnv, {
|
||||
rootDir,
|
||||
log: (message) => logPrefix("pi-warmup", message),
|
||||
}).then((result) => {
|
||||
if (result.skipped) {
|
||||
logPrefix("pi-warmup", `已跳过：${result.reason || "disabled"}`);
|
||||
return;
|
||||
}
|
||||
logPrefix(
|
||||
"pi-warmup",
|
||||
`完成：session=${result.sessionId} send=${result.sendEnabled ? "1" : "0"} elapsedMs=${result.elapsedMs}`,
|
||||
);
|
||||
}).catch((error) => {
|
||||
logPrefix("pi-warmup", `失败但不阻塞 dev-hot：${error.message}`);
|
||||
});
|
||||
}
|
||||
|
||||
function shutdown(code) {
|
||||
if (shuttingDown) {
|
||||
return;
|
||||
}
|
||||
shuttingDown = true;
|
||||
logPrefix("system", "收到终止信号，正在关闭所有子进程…");
|
||||
|
||||
for (const child of children) {
|
||||
if (!child.pid) continue;
|
||||
|
||||
// Windows 下，shell 子进程常常无法可靠传播 SIGINT/SIGTERM 到孙进程（例如 uvicorn --reload）。
|
||||
// 这里优先用 taskkill /T /F 确保整个进程树被结束，避免残留占用端口导致下次启动失败。
|
||||
if (process.platform === "win32") {
|
||||
try {
|
||||
execSync(`taskkill /PID ${child.pid} /T /F`, { stdio: "ignore" });
|
||||
continue;
|
||||
} catch {
|
||||
// fallback to signals
|
||||
}
|
||||
}
|
||||
|
||||
if (!child.killed) {
|
||||
child.kill("SIGINT");
|
||||
setTimeout(() => {
|
||||
if (!child.killed) {
|
||||
child.kill("SIGTERM");
|
||||
}
|
||||
}, 5000);
|
||||
}
|
||||
}
|
||||
|
||||
setTimeout(() => process.exit(code), 200);
|
||||
}
|
||||
|
||||
process.on("SIGINT", () => shutdown(0));
|
||||
process.on("SIGTERM", () => shutdown(0));
|
||||
|
||||
async function main() {
|
||||
// 说明：你外网绑定了 3000 端口，这里默认强制使用 3000。
|
||||
// 如果检测到 3000 被占用，则自动结束旧进程后重启，以保证始终跑在 3000。
|
||||
const desiredFrontendPort = runtimePlan.publicPort;
|
||||
const frontendOwnerName = "mnote-web";
|
||||
await stopStaleMnoteWebCargoProcesses();
|
||||
const frontendPortOk = await ensurePortFree(desiredFrontendPort, frontendOwnerName);
|
||||
if (!frontendPortOk) {
|
||||
console.error(`前端端口 ${desiredFrontendPort} 无法释放，已中止启动。`);
|
||||
process.exit(1);
|
||||
}
|
||||
const frontendPort = desiredFrontendPort;
|
||||
const frontendUrl = `http://localhost:${frontendPort}`;
|
||||
|
||||
if (skipMnoteWebGateway) {
|
||||
logPrefix("frontend", `前端地址：${frontendUrl}`);
|
||||
} else {
|
||||
logPrefix("mnote-web", `Rust gateway 公开入口：${frontendUrl}`);
|
||||
const gatewayTask = tasks.find((task) => task.name === "mnote-web");
|
||||
if (gatewayTask) {
|
||||
gatewayTask.command = runtimePlan.mnoteWebCommand;
|
||||
}
|
||||
Object.assign(mergedEnv, runtimePlan.mnoteWebEnv);
|
||||
}
|
||||
|
||||
const desiredBackendPort = backendPortFromEnv;
|
||||
if (shouldStartBackend(process.env) && !process.env.BACKEND_CMD) {
|
||||
const backendPortOk = await ensurePortFree(desiredBackendPort, "backend");
|
||||
if (!backendPortOk) {
|
||||
console.error(`后端端口 ${desiredBackendPort} 无法释放，已中止启动。`);
|
||||
process.exit(1);
|
||||
}
|
||||
const backendTask = findTask("backend");
|
||||
if (!backendTask) {
|
||||
throw new Error("缺少后端任务配置");
|
||||
}
|
||||
backendTask.command = buildDefaultBackendCommand(desiredBackendPort);
|
||||
} else if (isEnabledEnv(process.env.SKIP_BACKEND)) {
|
||||
logPrefix("backend", "已跳过 FastAPI 后端（SKIP_BACKEND=1）。");
|
||||
} else if (!shouldStartBackend(process.env)) {
|
||||
|
||||
}
|
||||
|
||||
if (tasks.length === 0) {
|
||||
console.error("未配置任何可运行的任务，检查环境变量设置。");
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
for (const task of tasks) {
|
||||
startTask(task);
|
||||
}
|
||||
schedulePiLabWarmup(frontendUrl);
|
||||
}
|
||||
|
||||
if (require.main === module) {
|
||||
main().catch((error) => {
|
||||
logPrefix("system", `启动失败：${error.message}`);
|
||||
process.exit(1);
|
||||
});
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
collectStaleMnoteWebCargoPids,
|
||||
ensurePortFree,
|
||||
getListeningPidsByPort,
|
||||
getProcessCommandByPid,
|
||||
getProcessGroupByPid,
|
||||
getProcessNameByPid,
|
||||
isHttpHealthy,
|
||||
isPortFree,
|
||||
resolveRuntimePlan,
|
||||
resolveBackendExecutable,
|
||||
schedulePiLabWarmup,
|
||||
shouldStartBackend,
|
||||
stopStaleMnoteWebCargoProcesses,
|
||||
terminatePid,
|
||||
};
|
||||
Reference in New Issue
Block a user