@yancyyu/openhermit 1.6.12 → 1.6.14

package/bin/alias-loader.mjs

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs';
 import path from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
-const repoRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..');
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 
 const ALIASES = [
   ['@features/', 'src/features/'],

package/bin/hermit.mjs

@@ -16,7 +16,7 @@
 
 import { spawn, execSync } from 'node:child_process';
 import crypto from 'node:crypto';
-import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import os from 'node:os';
 import path from 'node:path';
@@ -55,15 +55,21 @@ Usage:
 
 Options:
   --port <number>    HTTP server port (default: 5680)
-  --no-cc-connect    Do not auto-start bundled cc-connect
+  --no-cc-connect    Do not auto-start bundled runtime service
+  --daemon           Run openHermit in the background
   --version          Show current version
   --help             Show this help message
+  status             Show background service status
+  stop               Stop background service
   update             Check and install updates
 
 Examples:
   npx @yancyyu/openhermit             # Run without installing
   npx @yancyyu/openhermit --port 8080
   openhermit                          # After global install
+  openhermit --daemon
+  openhermit status
+  openhermit stop
   openhermit --version
   openhermit update
 `);
@@ -80,6 +86,10 @@ const portIndex = args.indexOf('--port');
 const port = portIndex !== -1 && args[portIndex + 1] ? args[portIndex + 1] : '5680';
 const skipCcConnect = args.includes('--no-cc-connect') || process.env.HERMIT_NO_CC_CONNECT === '1';
 const hermitHome = process.env.HERMIT_HOME || path.join(os.homedir(), '.hermit');
+const daemonRequested = args.includes('--daemon');
+const daemonChild = process.env.HERMIT_DAEMON_CHILD === '1';
+const daemonPidPath = path.join(hermitHome, 'openhermit.pid');
+const daemonLogPath = path.join(hermitHome, 'logs', 'openhermit.log');
 const ccConnectConfigPath =
   process.env.HERMIT_CC_CONNECT_CONFIG ||
   process.env.CC_CONNECT_CONFIG ||
@@ -142,6 +152,171 @@ async function runUpdate() {
   }
 }
 
+function readDaemonPid() {
+  try {
+    const raw = readFileSync(daemonPidPath, 'utf-8').trim();
+    const pid = Number.parseInt(raw, 10);
+    return Number.isFinite(pid) && pid > 0 ? pid : null;
+  } catch {
+    return null;
+  }
+}
+
+function isPidRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function removeDaemonPidFile() {
+  try {
+    unlinkSync(daemonPidPath);
+  } catch {
+    // Already gone.
+  }
+}
+
+function signalDaemon(pid, signal) {
+  if (!pid) return false;
+  try {
+    process.kill(-pid, signal);
+    return true;
+  } catch {
+    // Fall back to direct process signal.
+  }
+  try {
+    process.kill(pid, signal);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function collectFallbackPids() {
+  const pids = new Set();
+  const commands = [
+    `lsof -tiTCP:${port} -sTCP:LISTEN 2>/dev/null || true`,
+    'lsof -tiTCP:9810 -sTCP:LISTEN 2>/dev/null || true',
+    'lsof -tiTCP:9820 -sTCP:LISTEN 2>/dev/null || true',
+    "pgrep -f '@yancyyu/openhermit|openhermit/bin/hermit\\.mjs|src/main/server\\.ts|cc-connect' 2>/dev/null || true",
+  ];
+
+  for (const command of commands) {
+    try {
+      const out = execSync(command, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+      for (const line of out.split(/\s+/)) {
+        const pid = Number.parseInt(line, 10);
+        if (Number.isFinite(pid) && pid > 0 && pid !== process.pid) {
+          pids.add(pid);
+        }
+      }
+    } catch {
+      // Ignore missing lsof/pgrep or races with exiting processes.
+    }
+  }
+
+  return [...pids];
+}
+
+async function stopFallbackProcesses() {
+  const pids = collectFallbackPids();
+  if (pids.length === 0) return false;
+
+  for (const pid of pids) {
+    signalDaemon(pid, 'SIGTERM');
+  }
+  await new Promise((resolve) => setTimeout(resolve, 2_000));
+  for (const pid of pids) {
+    if (isPidRunning(pid)) {
+      signalDaemon(pid, 'SIGKILL');
+    }
+  }
+  return true;
+}
+
+function printDaemonStatus() {
+  const pid = readDaemonPid();
+  if (pid && isPidRunning(pid)) {
+    console.log(`[openHermit] Running in background (pid ${pid})`);
+    console.log(`[openHermit] Log: ${daemonLogPath}`);
+    process.exit(0);
+  }
+  if (pid) removeDaemonPidFile();
+  const fallbackPids = collectFallbackPids();
+  if (fallbackPids.length > 0) {
+    console.log(`[openHermit] Running without daemon pidfile (pids ${fallbackPids.join(', ')})`);
+    process.exit(0);
+  }
+  console.log('[openHermit] Not running');
+  process.exit(1);
+}
+
+async function stopDaemon() {
+  const pid = readDaemonPid();
+  if (!pid || !isPidRunning(pid)) {
+    if (pid) removeDaemonPidFile();
+    const stoppedFallback = await stopFallbackProcesses();
+    console.log(stoppedFallback ? '[openHermit] Stopped orphaned service processes' : '[openHermit] Not running');
+    process.exit(0);
+  }
+  console.log(`[openHermit] Stopping background service (pid ${pid})...`);
+  signalDaemon(pid, 'SIGTERM');
+  await new Promise((resolve) => setTimeout(resolve, 2_000));
+  if (isPidRunning(pid)) {
+    signalDaemon(pid, 'SIGKILL');
+  }
+  removeDaemonPidFile();
+  console.log('[openHermit] Stopped');
+  process.exit(0);
+}
+
+function startDaemon() {
+  const existingPid = readDaemonPid();
+  if (existingPid && isPidRunning(existingPid)) {
+    console.log(`[openHermit] Already running in background (pid ${existingPid})`);
+    console.log(`[openHermit] Log: ${daemonLogPath}`);
+    process.exit(0);
+  }
+
+  mkdirSync(path.dirname(daemonPidPath), { recursive: true });
+  mkdirSync(path.dirname(daemonLogPath), { recursive: true });
+  const out = openSync(daemonLogPath, 'a');
+  const err = openSync(daemonLogPath, 'a');
+  const childArgs = process.argv.slice(2).filter((arg) => arg !== '--daemon');
+  const child = spawn(process.execPath, [fileURLToPath(import.meta.url), ...childArgs], {
+    cwd: repoRoot,
+    detached: true,
+    env: {
+      ...process.env,
+      HERMIT_DAEMON_CHILD: '1',
+    },
+    stdio: ['ignore', out, err],
+  });
+  child.unref();
+  closeSync(out);
+  closeSync(err);
+  writeFileSync(daemonPidPath, String(child.pid), 'utf-8');
+  console.log(`[openHermit] Started in background (pid ${child.pid})`);
+  console.log(`[openHermit] URL: http://127.0.0.1:${port}`);
+  console.log(`[openHermit] Log: ${daemonLogPath}`);
+  process.exit(0);
+}
+
+if (args.includes('status')) {
+  printDaemonStatus();
+}
+
+if (args.includes('stop')) {
+  await stopDaemon();
+}
+
+if (daemonRequested && !daemonChild) {
+  startDaemon();
+}
+
 // ---------------------------------------------------------------------------
 // Check dependencies
 // ---------------------------------------------------------------------------
@@ -342,12 +517,13 @@ if (!skipCcConnect) {
   const ccBaseUrl = process.env.CC_CONNECT_BASE_URL || 'http://127.0.0.1:9820';
   const alreadyRunning = await waitForCcConnect(ccBaseUrl, ccTokens.managementToken, 1_000);
   if (alreadyRunning) {
-    console.log(`[openHermit] cc-connect already running: ${ccBaseUrl}`);
+    console.log(`[openHermit] Runtime service already running: ${ccBaseUrl}`);
   } else {
-    console.log('[openHermit] Starting bundled cc-connect...');
-    console.log(`[openHermit] cc-connect config: ${ccConnectConfigPath}`);
+    console.log('[openHermit] Starting bundled runtime service...');
+    console.log(`[openHermit] Runtime config: ${ccConnectConfigPath}`);
     ccConnectProcess = spawn(process.execPath, [resolveCcConnectRunner(), '-config', ccConnectConfigPath], {
       cwd: repoRoot,
+      detached: true,
       env: {
         ...process.env,
         CC_CONNECT_TOKEN: ccTokens.managementToken,
@@ -358,7 +534,7 @@ if (!skipCcConnect) {
     });
     const ready = await waitForCcConnect(ccBaseUrl, ccTokens.managementToken, 30_000);
     if (!ready) {
-      console.warn('[openHermit] cc-connect did not become ready within 30s; openHermit will keep trying via API.');
+      console.warn('[openHermit] Runtime service did not become ready within 30s; openHermit will keep trying via API.');
     }
   }
 }
@@ -402,6 +578,7 @@ console.log('[openHermit] Launching server...\n');
 
 const serverProcess = spawn(process.execPath, ['--import', resolveAliasLoaderRegister(), '--import', resolveTsxLoader(), 'src/main/server.ts'], {
   cwd: repoRoot,
+  detached: true,
   env: {
     ...process.env,
     PORT: port,
@@ -417,22 +594,34 @@ const serverProcess = spawn(process.execPath, ['--import', resolveAliasLoaderReg
 });
 
 serverProcess.on('exit', (code) => {
+  if (shuttingDown) return;
+  signalDaemon(ccConnectProcess?.pid, 'SIGTERM');
   if (code !== 0) {
     console.error(`[openHermit] Server exited with code ${code}`);
     process.exit(code ?? 1);
   }
 });
 
-process.on('SIGINT', () => {
+let shuttingDown = false;
+function shutdown(exitCode = 0) {
+  if (shuttingDown) return;
+  shuttingDown = true;
   console.log('\n[openHermit] Shutting down...');
-  serverProcess.kill('SIGINT');
-  ccConnectProcess?.kill('SIGINT');
+  signalDaemon(serverProcess?.pid, 'SIGTERM');
+  signalDaemon(ccConnectProcess?.pid, 'SIGTERM');
+  setTimeout(() => {
+    signalDaemon(serverProcess?.pid, 'SIGKILL');
+    signalDaemon(ccConnectProcess?.pid, 'SIGKILL');
+    process.exit(exitCode);
+  }, 2_000).unref();
+}
+
+process.on('SIGINT', () => {
+  shutdown(0);
 });
 
 process.on('SIGTERM', () => {
-  console.log('\n[openHermit] Shutting down...');
-  serverProcess.kill('SIGTERM');
-  ccConnectProcess?.kill('SIGTERM');
+  shutdown(0);
 });
 
 console.log(`[openHermit] Server starting on http://127.0.0.1:${port}`);

package/bin/postinstall.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+let version = 'unknown';
+try {
+  version = JSON.parse(readFileSync(path.join(packageRoot, 'package.json'), 'utf-8')).version;
+} catch {
+  // Keep install non-blocking.
+}
+
+let runtimeVersion = 'bundled';
+try {
+  runtimeVersion = JSON.parse(readFileSync(require.resolve('cc-connect/package.json'), 'utf-8')).version;
+} catch {
+  // Keep install non-blocking.
+}
+
+const hermitHome = process.env.HERMIT_HOME || path.join(os.homedir(), '.hermit');
+
+console.log(`[openHermit] Installed ${version}`);
+console.log(`[openHermit] Bundled runtime service: ${runtimeVersion}`);
+console.log(`[openHermit] Data directory: ${hermitHome}`);
+console.log('[openHermit] Start with: openhermit');
+console.log('[openHermit] Background mode: openhermit --daemon');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yancyyu/openhermit",
   "type": "module",
-  "version": "1.6.12",
+  "version": "1.6.14",
   "description": "openHermit: team-oriented agent management workbench atop cc-connect.",
   "license": "AGPL-3.0",
   "author": {
@@ -34,6 +34,7 @@
     "dev:server": "tsx watch src/main/server.ts",
     "dev:web": "vite --config vite.web.config.ts",
     "build:web": "vite build --config vite.web.config.ts --outDir ../../dist-renderer --emptyOutDir",
+    "postinstall": "node ./bin/postinstall.mjs",
     "prepack": "pnpm build:web",
     "start": "node bin/hermit.mjs",
     "typecheck": "tsc --noEmit",

package/src/main/server.ts

@@ -1037,25 +1037,16 @@ app.delete<{ Params: { name: string }; Querystring: { deleteFiles?: string } }>(
       try {
         const result = await cc.deleteProject(teamName);
         restartRequired = result.restart_required === true;
-        await svc.updateTeam(teamName, {
-          pendingDelete: true,
-          restartRequired,
-        });
       } catch (err) {
         request.log.warn({ err, teamName }, 'delete cc-connect project failed or project missing');
-        try {
-          await svc.updateTeam(teamName, {
-            pendingDelete: true,
-            restartRequired: true,
-          });
-          restartRequired = true;
-        } catch {
-          // Local metadata may already be gone; keep deletion best-effort.
-        }
       }
-      if (request.query.deleteFiles === 'true') {
-        await svc.deleteTeam(teamName, { deleteFiles: true });
+
+      try {
+        await svc.deleteTeam(teamName, { deleteFiles: request.query.deleteFiles === 'true' });
+      } catch (err) {
+        request.log.warn({ err, teamName }, 'delete local team metadata failed or already missing');
       }
+
       return { ok: true, restartRequired };
     } catch (err) {
       return reply.code(500).send(reply500(err));

package/src/renderer/components/settings/sections/PlatformsSection.tsx

@@ -7,6 +7,8 @@
 
 import { useCallback, useEffect, useState } from 'react';
 
+import { api } from '@renderer/api';
+import { confirm } from '@renderer/components/common/ConfirmDialog';
 import { Button } from '@renderer/components/ui/button';
 import {
   Dialog,
@@ -198,14 +200,20 @@ async function addPlatform(
   projectName: string,
   type: string,
   options: Record<string, string>
-): Promise<void> {
+): Promise<{ restartRequired: boolean }> {
   const res = await fetch(`/api/v1/projects/${encodeURIComponent(projectName)}/add-platform`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({ type, options }),
   });
-  const json = (await res.json()) as { ok: boolean; error?: string };
+  const json = (await res.json()) as {
+    ok: boolean;
+    error?: string;
+    data?: { restart_required?: boolean };
+    restart_required?: boolean;
+  };
   if (!json.ok) throw new Error(json.error ?? '添加失败');
+  return { restartRequired: json.data?.restart_required === true || json.restart_required === true };
 }
 
 // ---------------------------------------------------------------------------
@@ -482,8 +490,19 @@ function AddPlatformDialog({
         else if (v === 'false') ccOptions[k] = false;
         else ccOptions[k] = v;
       }
-      await addPlatform(projectName, platformType, ccOptions as Record<string, string>);
+      const result = await addPlatform(projectName, platformType, ccOptions as Record<string, string>);
       onAdded(projectName);
+      if (result.restartRequired) {
+        const shouldRestart = await confirm({
+          title: '重启 cc-connect',
+          message: '渠道已添加。需要重启 cc-connect 才会生效。',
+          confirmLabel: '立即重启',
+          cancelLabel: '稍后重启',
+        });
+        if (shouldRestart) {
+          await api.ccSettings.restart();
+        }
+      }
     } catch (e) {
       setError(e instanceof Error ? e.message : '添加失败');
     } finally {

package/src/renderer/components/team/TeamDetailView.tsx

@@ -1833,9 +1833,8 @@ export const TeamDetailView = ({
         const result = await deleteTeam(teamName);
         if (result.restartRequired) {
           const shouldRestart = await confirm({
-            title: '需要重启 cc-connect',
-            message:
-              '已调用 cc-connect 删除团队配置。cc-connect 需要重启后才会真正移除该团队并停止相关运行时。',
+            title: '重启 cc-connect',
+            message: '团队已从配置中删除。需要重启 cc-connect 才会停止对应运行时。',
             confirmLabel: '立即重启',
             cancelLabel: '稍后重启',
             variant: 'danger',

package/src/renderer/components/team/TeamListView.tsx

@@ -531,9 +531,9 @@ export const TeamListView = (): React.JSX.Element => {
           return;
         }
         const confirmed = await confirm({
-          title: '移入回收站',
-          message: `确定将团队“${teamDisplayName}”移入回收站吗？之后可以恢复。`,
-          confirmLabel: '移入回收站',
+          title: '删除团队',
+          message: `确定删除团队“${teamDisplayName}”吗？此操作会同步删除 cc-connect 项目并移除本地团队数据。`,
+          confirmLabel: '删除',
           cancelLabel: '取消',
           variant: 'danger',
         });
@@ -542,9 +542,8 @@ export const TeamListView = (): React.JSX.Element => {
             const result = await deleteTeam(teamName);
             if (result.restartRequired) {
               const shouldRestart = await confirm({
-                title: '需要重启 cc-connect',
-                message:
-                  '已调用 cc-connect 删除团队配置。cc-connect 需要重启后才会真正移除该团队并停止相关运行时。',
+                title: '重启 cc-connect',
+                message: '团队已从配置中删除。需要重启 cc-connect 才会停止对应运行时。',
                 confirmLabel: '立即重启',
                 cancelLabel: '稍后重启',
                 variant: 'danger',