@c4a/server-cli 0.4.9 → 0.4.10-beta.2

package/index.js

@@ -43013,8 +43013,8 @@ var init_base = __esm(() => {
 var DEFAULT_SERVER_CONFIG;
 var init_serverConfig = __esm(() => {
   DEFAULT_SERVER_CONFIG = {
-    api: {
-      port: 3000,
+    server: {
+      port: 5100,
       host: "0.0.0.0"
     },
     doc_db: {
@@ -47521,6 +47521,9 @@ var init_c4aError = __esm(() => {
 var init_errorCodes = () => {};
 
 // ../core/src/errors/httpStatus.ts
+function mapErrorCodeToStatus(code) {
+  return ERROR_CODE_HTTP_STATUS[code] ?? 500;
+}
 var ERROR_CODE_HTTP_STATUS;
 var init_httpStatus = __esm(() => {
   init_errorCodes();
@@ -47565,6 +47568,16 @@ var init_errors2 = __esm(() => {
 });
 
 // ../core/src/utils/id.ts
+import { createHash, randomUUID } from "node:crypto";
+function generateId(type, parentId, name) {
+  const input = `${type}:${parentId}:${name}`;
+  const hash = createHash("sha256").update(input).digest("hex");
+  const hex32 = hash.slice(0, 32);
+  return `${type}_${hex32}`;
+}
+function generateUUID() {
+  return randomUUID();
+}
 var init_id = () => {};
 
 // ../core/src/utils/hash.ts
@@ -185007,7 +185020,7 @@ async function saveServerConfig(config) {
   if (existsSync2(configPath)) {
     const content = await readFile(configPath, "utf-8");
     const doc = import_yaml2.default.parseDocument(content);
-    applyObjectAtPath(doc, ["api"], config.api);
+    applyObjectAtPath(doc, ["server"], config.server);
     doc.setIn(["doc_db", "provider"], config.doc_db.provider);
     if (config.doc_db.provider === "sqlite") {
       applyObjectAtPath(doc, ["doc_db", "sqlite"], config.doc_db.sqlite);
@@ -197437,7 +197450,7 @@ var createIdGenerator = ({
   }
   return () => `${prefix}${separator}${generator()}`;
 };
-var generateId = createIdGenerator();
+var generateId2 = createIdGenerator();
 function getErrorMessage2(error40) {
   if (error40 == null) {
     return "unknown error";
@@ -199915,7 +199928,7 @@ var OpenAIChatLanguageModel = class {
     for (const toolCall of (_a16 = choice.message.tool_calls) != null ? _a16 : []) {
       content.push({
         type: "tool-call",
-        toolCallId: (_b16 = toolCall.id) != null ? _b16 : generateId(),
+        toolCallId: (_b16 = toolCall.id) != null ? _b16 : generateId2(),
         toolName: toolCall.function.name,
         input: toolCall.function.arguments
       });
@@ -199924,7 +199937,7 @@ var OpenAIChatLanguageModel = class {
       content.push({
         type: "source",
         sourceType: "url",
-        id: generateId(),
+        id: generateId2(),
         url: annotation.url_citation.url,
         title: annotation.url_citation.title
       });
@@ -200105,7 +200118,7 @@ var OpenAIChatLanguageModel = class {
                     });
                     controller.enqueue({
                       type: "tool-call",
-                      toolCallId: (_j = toolCall2.id) != null ? _j : generateId(),
+                      toolCallId: (_j = toolCall2.id) != null ? _j : generateId2(),
                       toolName: toolCall2.function.name,
                       input: toolCall2.function.arguments
                     });
@@ -200133,7 +200146,7 @@ var OpenAIChatLanguageModel = class {
                 });
                 controller.enqueue({
                   type: "tool-call",
-                  toolCallId: (_q = toolCall.id) != null ? _q : generateId(),
+                  toolCallId: (_q = toolCall.id) != null ? _q : generateId2(),
                   toolName: toolCall.function.name,
                   input: toolCall.function.arguments
                 });
@@ -200146,7 +200159,7 @@ var OpenAIChatLanguageModel = class {
               controller.enqueue({
                 type: "source",
                 sourceType: "url",
-                id: generateId(),
+                id: generateId2(),
                 url: annotation.url_citation.url,
                 title: annotation.url_citation.title
               });
@@ -203095,7 +203108,7 @@ var OpenAIResponsesLanguageModel = class {
                 content.push({
                   type: "source",
                   sourceType: "url",
-                  id: (_f = (_e = (_d = this.config).generateId) == null ? undefined : _e.call(_d)) != null ? _f : generateId(),
+                  id: (_f = (_e = (_d = this.config).generateId) == null ? undefined : _e.call(_d)) != null ? _f : generateId2(),
                   url: annotation.url,
                   title: annotation.title
                 });
@@ -203103,7 +203116,7 @@ var OpenAIResponsesLanguageModel = class {
                 content.push({
                   type: "source",
                   sourceType: "document",
-                  id: (_i = (_h = (_g = this.config).generateId) == null ? undefined : _h.call(_g)) != null ? _i : generateId(),
+                  id: (_i = (_h = (_g = this.config).generateId) == null ? undefined : _h.call(_g)) != null ? _i : generateId2(),
                   mediaType: "text/plain",
                   title: annotation.filename,
                   filename: annotation.filename,
@@ -203119,7 +203132,7 @@ var OpenAIResponsesLanguageModel = class {
                 content.push({
                   type: "source",
                   sourceType: "document",
-                  id: (_l = (_k = (_j = this.config).generateId) == null ? undefined : _k.call(_j)) != null ? _l : generateId(),
+                  id: (_l = (_k = (_j = this.config).generateId) == null ? undefined : _k.call(_j)) != null ? _l : generateId2(),
                   mediaType: "text/plain",
                   title: annotation.filename,
                   filename: annotation.filename,
@@ -203135,7 +203148,7 @@ var OpenAIResponsesLanguageModel = class {
                 content.push({
                   type: "source",
                   sourceType: "document",
-                  id: (_o = (_n = (_m = this.config).generateId) == null ? undefined : _n.call(_m)) != null ? _o : generateId(),
+                  id: (_o = (_n = (_m = this.config).generateId) == null ? undefined : _n.call(_m)) != null ? _o : generateId2(),
                   mediaType: "application/octet-stream",
                   title: annotation.file_id,
                   filename: annotation.file_id,
@@ -203219,7 +203232,7 @@ var OpenAIResponsesLanguageModel = class {
         }
         case "mcp_approval_request": {
           const approvalRequestId = (_q = part.approval_request_id) != null ? _q : part.id;
-          const dummyToolCallId = (_t = (_s = (_r = this.config).generateId) == null ? undefined : _s.call(_r)) != null ? _t : generateId();
+          const dummyToolCallId = (_t = (_s = (_r = this.config).generateId) == null ? undefined : _s.call(_r)) != null ? _t : generateId2();
           const toolName = `mcp.${part.name}`;
           content.push({
             type: "tool-call",
@@ -203732,7 +203745,7 @@ var OpenAIResponsesLanguageModel = class {
               ongoingToolCalls[value.output_index] = undefined;
             } else if (value.item.type === "mcp_approval_request") {
               ongoingToolCalls[value.output_index] = undefined;
-              const dummyToolCallId = (_k = (_j = (_i = self2.config).generateId) == null ? undefined : _j.call(_i)) != null ? _k : generateId();
+              const dummyToolCallId = (_k = (_j = (_i = self2.config).generateId) == null ? undefined : _j.call(_i)) != null ? _k : generateId2();
               const approvalRequestId = (_l = value.item.approval_request_id) != null ? _l : value.item.id;
               approvalRequestIdToDummyToolCallIdFromStream.set(approvalRequestId, dummyToolCallId);
               const toolName = `mcp.${value.item.name}`;
@@ -203993,7 +204006,7 @@ var OpenAIResponsesLanguageModel = class {
               controller.enqueue({
                 type: "source",
                 sourceType: "url",
-                id: (_w = (_v = (_u = self2.config).generateId) == null ? undefined : _v.call(_u)) != null ? _w : generateId(),
+                id: (_w = (_v = (_u = self2.config).generateId) == null ? undefined : _v.call(_u)) != null ? _w : generateId2(),
                 url: value.annotation.url,
                 title: value.annotation.title
               });
@@ -204001,7 +204014,7 @@ var OpenAIResponsesLanguageModel = class {
               controller.enqueue({
                 type: "source",
                 sourceType: "document",
-                id: (_z = (_y = (_x = self2.config).generateId) == null ? undefined : _y.call(_x)) != null ? _z : generateId(),
+                id: (_z = (_y = (_x = self2.config).generateId) == null ? undefined : _y.call(_x)) != null ? _z : generateId2(),
                 mediaType: "text/plain",
                 title: value.annotation.filename,
                 filename: value.annotation.filename,
@@ -204017,7 +204030,7 @@ var OpenAIResponsesLanguageModel = class {
               controller.enqueue({
                 type: "source",
                 sourceType: "document",
-                id: (_C = (_B = (_A = self2.config).generateId) == null ? undefined : _B.call(_A)) != null ? _C : generateId(),
+                id: (_C = (_B = (_A = self2.config).generateId) == null ? undefined : _B.call(_A)) != null ? _C : generateId2(),
                 mediaType: "text/plain",
                 title: value.annotation.filename,
                 filename: value.annotation.filename,
@@ -204033,7 +204046,7 @@ var OpenAIResponsesLanguageModel = class {
               controller.enqueue({
                 type: "source",
                 sourceType: "document",
-                id: (_F = (_E = (_D = self2.config).generateId) == null ? undefined : _E.call(_D)) != null ? _F : generateId(),
+                id: (_F = (_E = (_D = self2.config).generateId) == null ? undefined : _E.call(_D)) != null ? _F : generateId2(),
                 mediaType: "application/octet-stream",
                 title: value.annotation.file_id,
                 filename: value.annotation.file_id,
@@ -208769,7 +208782,7 @@ var GoogleGenerativeAILanguageModel = class {
     var _a21;
     this.modelId = modelId;
     this.config = config2;
-    this.generateId = (_a21 = config2.generateId) != null ? _a21 : generateId;
+    this.generateId = (_a21 = config2.generateId) != null ? _a21 : generateId2;
   }
   get provider() {
     return this.config.provider;
@@ -209661,7 +209674,7 @@ var GoogleGenerativeAIImageModel = class {
       baseURL: this.config.baseURL,
       headers: (_a21 = this.config.headers) != null ? _a21 : {},
       fetch: this.config.fetch,
-      generateId: (_b16 = this.config.generateId) != null ? _b16 : generateId
+      generateId: (_b16 = this.config.generateId) != null ? _b16 : generateId2
     });
     const result = await languageModel.doGenerate({
       prompt: languageModelPrompt,
@@ -209963,7 +209976,7 @@ function createGoogleGenerativeAI(options = {}) {
       provider: providerName,
       baseURL,
       headers: getHeaders,
-      generateId: (_a24 = options.generateId) != null ? _a24 : generateId,
+      generateId: (_a24 = options.generateId) != null ? _a24 : generateId2,
       supportedUrls: () => ({
         "*": [
           new RegExp(`^${baseURL}/files/.*$`),
@@ -209993,7 +210006,7 @@ function createGoogleGenerativeAI(options = {}) {
       baseURL,
       headers: getHeaders,
       fetch: options.fetch,
-      generateId: (_a24 = options.generateId) != null ? _a24 : generateId
+      generateId: (_a24 = options.generateId) != null ? _a24 : generateId2
     });
   };
   const provider = function(modelId) {
@@ -211802,7 +211815,7 @@ async function runLogsCommand(options = {}) {
 // src/ops/statusCommand.ts
 import { existsSync as existsSync7 } from "node:fs";
 
-// src/ops/apiProcess.ts
+// src/ops/serverProcess.ts
 import { execSync, spawn as spawnChild } from "node:child_process";
 import { closeSync, existsSync as existsSync6, openSync } from "node:fs";
 import { mkdir as mkdir3, readFile as readFile2, rm, writeFile as writeFile3 } from "node:fs/promises";
@@ -211816,39 +211829,71 @@ var DEFAULT_DEPS = {
   sleep: (ms) => new Promise((resolve2) => setTimeout(resolve2, ms)),
   now: () => Date.now()
 };
-var API_PID_NAME = "api.pid";
-var API_LOG_NAME = "api.log";
-var API_LOG_DIR = path13.join("data", "logs");
-function resolveApiServeEntry() {
+var SERVER_PID_NAME = "server.pid";
+var SERVER_LOG_DIR = "logs";
+function makeServerLogName() {
+  const now = new Date;
+  const ts = [
+    now.getFullYear(),
+    String(now.getMonth() + 1).padStart(2, "0"),
+    String(now.getDate()).padStart(2, "0"),
+    ".",
+    String(now.getHours()).padStart(2, "0"),
+    String(now.getMinutes()).padStart(2, "0"),
+    String(now.getSeconds()).padStart(2, "0")
+  ].join("");
+  return `server.${ts}.log`;
+}
+var cachedRuntime = null;
+function resolveRuntime() {
+  if (cachedRuntime)
+    return cachedRuntime;
+  try {
+    execSync("bun --version", { stdio: "ignore", timeout: 3000 });
+    cachedRuntime = "bun";
+  } catch {
+    cachedRuntime = "node";
+  }
+  return cachedRuntime;
+}
+function resolveServeEntry(runtime) {
   const currentDir = path13.dirname(fileURLToPath(import.meta.url));
   const candidates = [
-    path13.resolve(currentDir, "..", "..", "..", "api", "src", "serve.ts"),
-    path13.resolve(currentDir, "..", "..", "api", "src", "serve.ts"),
-    path13.resolve(currentDir, "..", "..", "api", "dist", "serve.js"),
-    path13.resolve(currentDir, "..", "..", "..", "api", "dist", "serve.js")
+    path13.resolve(currentDir, "serve.js"),
+    path13.resolve(currentDir, "..", "..", "server", "dist", "serve.js"),
+    path13.resolve(currentDir, "..", "..", "..", "server", "dist", "serve.js")
   ];
+  if (runtime === "bun") {
+    candidates.push(path13.resolve(currentDir, "..", "..", "..", "server", "src", "serve.ts"));
+    candidates.push(path13.resolve(currentDir, "..", "..", "server", "src", "serve.ts"));
+  }
   for (const candidate of candidates) {
     if (existsSync6(candidate))
       return candidate;
   }
   return candidates[0];
 }
-function resolveApiPidPath() {
-  return path13.resolve(process.cwd(), "data", API_PID_NAME);
+function resolvePidPath() {
+  return path13.resolve(process.cwd(), "data", SERVER_PID_NAME);
 }
-function resolveApiLogPath() {
-  return path13.resolve(process.cwd(), API_LOG_DIR, API_LOG_NAME);
+function resolveServerLogPath() {
+  return path13.resolve(process.cwd(), SERVER_LOG_DIR, makeServerLogName());
 }
-function resolveApiHealthUrl(config2) {
-  const host = config2.api.host === "0.0.0.0" ? "127.0.0.1" : config2.api.host;
-  const url2 = `http://${host}:${config2.api.port}/api/v1/health`;
-  return { url: url2, host };
+function resolveHealthUrl(config2) {
+  let host = config2.server.host;
+  if (host === "0.0.0.0")
+    host = "127.0.0.1";
+  else if (host === "::")
+    host = "::1";
+  const urlHost = host.includes(":") ? `[${host}]` : host;
+  const url2 = `http://${urlHost}:${config2.server.port}/api/v1/health`;
+  return { url: url2, host: urlHost, tcpHost: host };
 }
-async function ensureApiDirs() {
-  await mkdir3(path13.resolve(process.cwd(), API_LOG_DIR), { recursive: true });
+async function ensureLogDirs() {
+  await mkdir3(path13.resolve(process.cwd(), SERVER_LOG_DIR), { recursive: true });
 }
-async function readApiPidFile() {
-  const pidPath = resolveApiPidPath();
+async function readPidFile() {
+  const pidPath = resolvePidPath();
   if (!existsSync6(pidPath))
     return null;
   const content = await readFile2(pidPath, "utf-8");
@@ -211859,13 +211904,13 @@ async function readApiPidFile() {
   }
   return pid;
 }
-async function writeApiPidFile(pid) {
-  const pidPath = resolveApiPidPath();
+async function writePidFile(pid) {
+  const pidPath = resolvePidPath();
   await mkdir3(path13.dirname(pidPath), { recursive: true });
   await writeFile3(pidPath, String(pid));
 }
-async function removeApiPidFile() {
-  await rm(resolveApiPidPath(), { force: true });
+async function removePidFile() {
+  await rm(resolvePidPath(), { force: true });
 }
 function isProcessAlive(pid, deps) {
   try {
@@ -211898,11 +211943,14 @@ function findPidByPort(port) {
     return null;
   }
 }
-async function waitForHealth(config2, deps, attempts = 10, intervalMs = 500) {
-  const { url: url2 } = resolveApiHealthUrl(config2);
+async function waitForHealth(config2, deps, options = {}) {
+  const attempts = options.attempts ?? 10;
+  const intervalMs = options.intervalMs ?? 1000;
+  const { url: url2 } = resolveHealthUrl(config2);
   for (let i = 0;i < attempts; i++) {
+    options.onAttempt?.(i + 1, attempts);
     const started = deps.now();
-    const timeoutMs = intervalMs > 0 ? Math.min(200, intervalMs) : 500;
+    const timeoutMs = intervalMs > 0 ? Math.min(500, intervalMs) : 500;
     const result = await deps.checkHttp(url2, undefined, timeoutMs);
     if (result.ok && result.status === 200) {
       return true;
@@ -211915,69 +211963,84 @@ async function waitForHealth(config2, deps, attempts = 10, intervalMs = 500) {
   }
   return false;
 }
-async function startApiProcess(config2, deps = {}) {
+async function startServerProcess(config2, deps = {}) {
   const activeDeps = { ...DEFAULT_DEPS, ...deps };
-  const existingPid = await readApiPidFile();
+  const existingPid = await readPidFile();
   if (existingPid && isProcessAlive(existingPid, activeDeps)) {
-    return { pid: existingPid, port: config2.api.port, host: config2.api.host, running: true };
+    return { pid: existingPid, port: config2.server.port, host: config2.server.host, running: true };
   }
   if (existingPid) {
-    await removeApiPidFile();
+    await removePidFile();
   }
-  const { host: healthHost } = resolveApiHealthUrl(config2);
-  const preCheck = await activeDeps.checkHttp(`http://${healthHost}:${config2.api.port}/api/v1/health`, undefined, 500);
+  const { host: healthHost, tcpHost } = resolveHealthUrl(config2);
+  const preCheck = await activeDeps.checkHttp(`http://${healthHost}:${config2.server.port}/api/v1/health`, undefined, 500);
   if (preCheck.ok && preCheck.status === 200) {
-    const orphanPid = findPidByPort(config2.api.port);
+    const orphanPid = findPidByPort(config2.server.port);
     if (orphanPid) {
-      await writeApiPidFile(orphanPid);
-      return { pid: orphanPid, port: config2.api.port, host: config2.api.host, running: true };
+      await writePidFile(orphanPid);
+      return { pid: orphanPid, port: config2.server.port, host: config2.server.host, running: true };
     }
   }
-  await ensureApiDirs();
-  const logPath = resolveApiLogPath();
-  const logFd = openSync(logPath, "a");
-  const serveEntry = resolveApiServeEntry();
-  const child = activeDeps.spawn("bun", [serveEntry], {
+  const tcpCheck = await activeDeps.checkTcp(tcpHost, config2.server.port, 500);
+  if (tcpCheck.ok) {
+    throw new Error(`端口已被占用: ${config2.server.host}:${config2.server.port}`);
+  }
+  await ensureLogDirs();
+  const logPath = resolveServerLogPath();
+  const logFd = openSync(logPath, "w");
+  const runtime = resolveRuntime();
+  const serveEntry = resolveServeEntry(runtime);
+  const child = activeDeps.spawn(runtime, [serveEntry], {
     detached: true,
     cwd: process.cwd(),
     stdio: ["ignore", logFd, logFd]
   });
+  const spawnError = await new Promise((resolve2) => {
+    child.once("error", (err) => resolve2(err));
+    setImmediate(() => resolve2(null));
+  });
   closeSync(logFd);
+  if (spawnError) {
+    throw new Error(`Server 启动失败：无法执行 ${runtime}（${spawnError.message}）`);
+  }
   if (!child.pid) {
-    throw new Error("API 服务启动失败：未获取到 PID");
+    throw new Error("Server 启动失败：未获取到 PID");
   }
   child.unref();
-  await writeApiPidFile(child.pid);
-  const healthy = await waitForHealth(config2, activeDeps);
-  if (!healthy) {
-    const port = config2.api.port;
-    const tcp = await activeDeps.checkTcp(healthHost, port, 1000);
-    if (tcp.ok) {
-      throw new Error(`端口已被占用: ${config2.api.host}:${port}`);
+  await writePidFile(child.pid);
+  const healthy = await waitForHealth(config2, activeDeps, {
+    attempts: 10,
+    intervalMs: 1000,
+    onAttempt: (attempt, total) => {
+      process.stdout.write(`\r等待 Server 就绪... (${attempt}/${total})`);
     }
-    throw new Error(`API 服务启动失败（健康检查未通过）`);
+  });
+  process.stdout.write("\r" + " ".repeat(40) + "\r");
+  if (!healthy) {
+    throw new Error(`Server 启动失败（健康检查未通过，已等待 10s）
+日志: ${logPath}`);
   }
-  return { pid: child.pid, port: config2.api.port, host: config2.api.host, running: true };
+  return { pid: child.pid, port: config2.server.port, host: config2.server.host, running: true };
 }
-async function stopApiProcess(config2, deps = {}) {
+async function stopServerProcess(config2, deps = {}) {
   const activeDeps = { ...DEFAULT_DEPS, ...deps };
-  let pid = await readApiPidFile();
+  let pid = await readPidFile();
   if (!pid && config2) {
-    pid = findPidByPort(config2.api.port);
+    pid = findPidByPort(config2.server.port);
     if (pid) {
-      await writeApiPidFile(pid);
+      await writePidFile(pid);
     }
   }
   if (!pid)
     return;
   if (!isProcessAlive(pid, activeDeps)) {
-    await removeApiPidFile();
+    await removePidFile();
     return;
   }
   try {
     activeDeps.kill(pid, "SIGTERM");
   } catch {
-    await removeApiPidFile();
+    await removePidFile();
     return;
   }
   const start = activeDeps.now();
@@ -211991,25 +212054,25 @@ async function stopApiProcess(config2, deps = {}) {
       activeDeps.kill(pid, "SIGKILL");
     } catch {}
   }
-  await removeApiPidFile();
+  await removePidFile();
 }
-async function getApiProcessInfo(config2, deps = {}) {
+async function getServerProcessInfo(config2, deps = {}) {
   const activeDeps = { ...DEFAULT_DEPS, ...deps };
-  let pid = await readApiPidFile();
+  let pid = await readPidFile();
   if (!pid) {
-    pid = findPidByPort(config2.api.port);
+    pid = findPidByPort(config2.server.port);
     if (pid) {
-      await writeApiPidFile(pid);
+      await writePidFile(pid);
     }
   }
   if (!pid)
     return null;
   if (!isProcessAlive(pid, activeDeps)) {
-    await removeApiPidFile();
+    await removePidFile();
     return null;
   }
-  const healthy = await waitForHealth(config2, activeDeps, 1, 0);
-  return { pid, port: config2.api.port, host: config2.api.host, running: healthy };
+  const healthy = await waitForHealth(config2, activeDeps, { attempts: 1, intervalMs: 0 });
+  return { pid, port: config2.server.port, host: config2.server.host, running: healthy };
 }
 
 // src/ops/statusCommand.ts
@@ -212142,9 +212205,9 @@ async function runStatusCommand(options = {}) {
     }
   }
   printLine(`Embedding (${config2.embedding.provider})`, embeddingResult.ready, embeddingDetail);
-  const apiInfo = await getApiProcessInfo(config2);
-  const apiStatus = getApiStatusLine(apiInfo);
-  printLine("API 服务", apiStatus.ok, apiStatus.detail);
+  const apiInfo = await getServerProcessInfo(config2);
+  const apiStatus = getServerStatusLine(apiInfo);
+  printLine("C4A Server", apiStatus.ok, apiStatus.detail);
   if (staleContainers.length > 0) {
     const names = staleContainers.map((c) => c.name).join(", ");
     console.log(`  ${"提示".padEnd(20, " ")} 发现旧配置容器仍在运行：${names}`);
@@ -212196,7 +212259,7 @@ function printLine(label, ok, detail) {
   const status = ok ? `${GREEN5}运行中${RESET5}` : `${RED2}未就绪${RESET5}`;
   console.log(`  ${label.padEnd(20, " ")} ${status} ${detail}`);
 }
-function getApiStatusLine(info) {
+function getServerStatusLine(info) {
   if (!info) {
     return { ok: false, detail: "未启动" };
   }
@@ -212283,24 +212346,23 @@ async function ensureNebulaInit(composePath, startedServices, projectName) {
   }
   return true;
 }
-async function ensureApiStarted(config2) {
-  const existingApi = await getApiProcessInfo(config2);
-  if (existingApi && existingApi.running) {
-    console.log(`API 服务已在运行 (PID: ${existingApi.pid})`);
+async function ensureServerStarted(config2) {
+  const existing = await getServerProcessInfo(config2);
+  if (existing && existing.running) {
+    console.log(`Server 已在运行 (PID: ${existing.pid})`);
     return true;
   }
-  if (existingApi && !existingApi.running) {
-    console.log(`API 进程存在但服务无响应 (PID: ${existingApi.pid})，尝试重启...`);
-    await stopApiProcess(config2);
+  if (existing && !existing.running) {
+    console.log(`Server 进程存在但服务无响应 (PID: ${existing.pid})，尝试重启...`);
+    await stopServerProcess(config2);
   }
   try {
-    const started = await startApiProcess(config2);
-    console.log(`API 服务已启动 (PID: ${started.pid}, http://${started.host}:${started.port})`);
+    const started = await startServerProcess(config2);
+    console.log(`Server 已启动 (PID: ${started.pid}, http://${started.host}:${started.port})`);
     return true;
   } catch (error40) {
     const message = error40 instanceof Error ? error40.message : String(error40);
-    console.log(`API 服务启动失败: ${message}`);
-    console.log(`错误日志: ${resolveApiLogPath()}`);
+    console.log(`Server 启动失败: ${message}`);
     return false;
   }
 }
@@ -212321,13 +212383,13 @@ async function runStartCommand(options = {}) {
       console.log(`当前配置没有需要启动的 Docker 服务。
 `);
     }
-    const apiOk = await ensureApiStarted(config2);
+    const apiOk = await ensureServerStarted(config2);
     if (!apiOk)
       return;
   } else {
     const optionsList = [
       { label: "全部启动", value: "__all__" },
-      { label: "API 服务", value: "__api__" },
+      { label: "C4A Server", value: "__api__" },
       ...services.map((svc) => ({ label: svc.serviceName, value: svc.serviceName }))
     ];
     const choice2 = await askChoice("选择要启动的服务", optionsList, "__all__");
@@ -212353,13 +212415,13 @@ async function runStartCommand(options = {}) {
         console.log(`当前配置没有需要启动的 Docker 服务。
 `);
       }
-      const apiOk = await ensureApiStarted(config2);
+      const apiOk = await ensureServerStarted(config2);
       if (!apiOk) {
         await pauseBeforeReturn();
         return;
       }
     } else if (choice2 === "__api__") {
-      const apiOk = await ensureApiStarted(config2);
+      const apiOk = await ensureServerStarted(config2);
       if (!apiOk) {
         await pauseBeforeReturn();
         return;
@@ -212390,7 +212452,7 @@ async function runStopCommand(options = {}) {
   const config2 = await loadServerConfig();
   const { composePath, services, projectName } = await getDockerServices(config2);
   const serviceMap = new Map(services.map((svc) => [svc.serviceName, svc.containerName]));
-  const apiInfo = await getApiProcessInfo(config2);
+  const apiInfo = await getServerProcessInfo(config2);
   const apiAvailable = apiInfo !== null;
   if (services.length === 0) {
     console.log(`当前配置没有需要停止的 Docker 服务。
@@ -212413,11 +212475,11 @@ async function runStopCommand(options = {}) {
   let stopApi = false;
   if (mode === "cli") {
     targetServices = runningServices;
-    stopApi = apiAvailable;
+    stopApi = true;
   } else {
     const optionsList = [
       { label: "全部停止", value: "__all__" },
-      ...apiAvailable ? [{ label: "API 服务", value: "__api__" }] : [],
+      { label: "C4A Server", value: "__api__" },
       ...runningServices.map((name21) => ({ label: name21, value: name21 }))
     ];
     const choice2 = await askChoice("选择要停止的服务", optionsList, "__all__");
@@ -212428,7 +212490,7 @@ async function runStopCommand(options = {}) {
     }
     if (choice2 === "__all__") {
       targetServices = runningServices;
-      stopApi = apiAvailable;
+      stopApi = true;
     } else if (choice2 === "__api__") {
       targetServices = [];
       stopApi = true;
@@ -212438,7 +212500,7 @@ async function runStopCommand(options = {}) {
   }
   const dockerTargets = targetServices;
   if (stopApi) {
-    await stopApiProcess(config2);
+    await stopServerProcess(config2);
   }
   if (dockerTargets.length > 0) {
     console.log(`
@@ -214363,19 +214425,19 @@ async function runBackupCommand(options) {
   }
 }
 
-// src/ops/restartApi.ts
-async function restartApiIfRunning(config2, log) {
-  const info = await getApiProcessInfo(config2);
+// src/ops/restartServer.ts
+async function restartServerIfRunning(config2, log) {
+  const info = await getServerProcessInfo(config2);
   if (!info)
     return;
-  log("正在重启 API 服务以刷新数据...");
-  await stopApiProcess(config2);
+  log("正在重启 Server 以刷新数据...");
+  await stopServerProcess(config2);
   try {
-    const started = await startApiProcess(config2);
-    log(`API 服务已重启 (PID: ${started.pid})`);
+    const started = await startServerProcess(config2);
+    log(`Server 已重启 (PID: ${started.pid})`);
   } catch (error40) {
     const message = error40 instanceof Error ? error40.message : String(error40);
-    log(`API 服务重启失败: ${message}`);
+    log(`Server 重启失败: ${message}`);
   }
 }
 
@@ -214438,7 +214500,7 @@ async function runPurgeCommand(options) {
     await facade.close();
   }
   if (result) {
-    await restartApiIfRunning(config2, console.log);
+    await restartServerIfRunning(config2, console.log);
   }
   if (mode === "interactive") {
     await pauseBeforeReturn();
@@ -214448,13 +214510,13 @@ async function runPurgeCommand(options) {
 // src/data/restore.ts
 import path16 from "node:path";
 async function triggerVectorRebuild(config2, log) {
-  const info = await getApiProcessInfo(config2);
+  const info = await getServerProcessInfo(config2);
   if (!info) {
-    log("⚠️  API 服务未运行，向量索引未重建。启动 API 后可调用 POST /api/v1/vectors/rebuild 手动重建。");
+    log("⚠️  Server 未运行，向量索引未重建。启动后可调用 POST /api/v1/vectors/rebuild 手动重建。");
     return;
   }
-  const port = config2.api.port;
-  const host = config2.api.host === "0.0.0.0" ? "127.0.0.1" : config2.api.host;
+  const port = config2.server.port;
+  const host = config2.server.host === "0.0.0.0" ? "127.0.0.1" : config2.server.host;
   const url2 = `http://${host}:${port}/api/v1/vectors/rebuild`;
   log("正在通过 API 重建向量索引...");
   try {
@@ -214605,7 +214667,7 @@ async function runRestoreCommand(options) {
     await facade.close();
   }
   if (result) {
-    await restartApiIfRunning(config2, console.log);
+    await restartServerIfRunning(config2, console.log);
     await triggerVectorRebuild(config2, console.log);
   }
   if (mode === "interactive") {
@@ -215152,8 +215214,8 @@ var SERVER_CONFIG_NAME = "server.yaml";
 var DEFAULT_SERVER_YAML = `# C4A Server Configuration
 # 由 c4a-server 服务设置菜单生成和管理
 
-api:
-  port: 3000
+server:
+  port: 5100
   host: 0.0.0.0
 
 doc_db: