mioku-service-webui 4.12.0 → 4.14.0

package/database.ts

@@ -1,3 +1,4 @@
+import { getConfigDefaults, withConfigDefaults } from "mioku";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { Database } from "bun:sqlite";
@@ -359,7 +360,12 @@ export function getPluginConfigs(pluginName: string): Record<string, any> {
 
   for (const file of files) {
     const filePath = path.join(pluginDir, file);
-    result[path.basename(file, ".json")] = readJsonFile(filePath, {});
+    const configName = path.basename(file, ".json");
+    // 磁盘值覆盖插件登记的默认值，缺字段时页面也能拿到完整配置
+    result[configName] = withConfigDefaults(
+      readJsonFile(filePath, {}),
+      getConfigDefaults("plugin", pluginName, configName),
+    );
   }
 
   return result;

package/index.ts

@@ -37,6 +37,7 @@ import {
   createDataManagementRoutes,
   createStrangerRoutes,
   createAccessControlRoutes,
+  createMcpRoutes,
 } from "./routes";
 import { freePort } from "./port-utils";
 
@@ -132,6 +133,7 @@ class WebUIRuntime {
     this.app.route("/api/data-management", createDataManagementRoutes());
     this.app.route("/api/stranger", createStrangerRoutes());
     this.app.route("/api/access-control", createAccessControlRoutes());
+    this.app.route("/api/mcp", createMcpRoutes());
 
     this.app.get(
       "/api/ws/logs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-service-webui",
-  "version": "4.12.0",
+  "version": "4.14.0",
   "description": "Mioku WebUI 服务",
   "main": "index.ts",
   "type": "module",
@@ -26,11 +26,18 @@
     "systeminformation": "^5.31.6"
   },
   "peerDependencies": {
-    "mioku-service-ai": "^4.0.0"
+    "mioku-service-ai": "^4.0.0",
+    "mioku-service-mcp": "^0.1.0"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
     "mioku": "workspace:*",
-    "mioku-service-ai": "workspace:*"
+    "mioku-service-ai": "workspace:*",
+    "mioku-service-mcp": "workspace:*"
+  },
+  "peerDependenciesMeta": {
+    "mioku-service-mcp": {
+      "optional": true
+    }
   }
 }

package/routes/agent.ts

@@ -31,74 +31,44 @@ function sanitizeAccess(input: any): any {
   };
 }
 
+/**
+ * 保存时只做「不该写进这个文件」的剔除，不补默认值。
+ *
+ * 默认值由 agent 插件在 `registerConfig` 时登记、读取时深合并
+ * （`mergeAgentConfig`）——这里再抄一份，加字段时就会两边漂移。
+ */
 function sanitizeBaseForSave(body: any): any {
   if (!body || typeof body !== "object") return body;
   const next = { ...body };
   delete next.persona;
   delete next.roleBindings;
-  next.access = sanitizeAccess(next.access);
-  next.workspaceDir = String(next.workspaceDir ?? "").trim();
-  next.permissionLevel = PERMISSION_LEVELS.has(next.permissionLevel)
-    ? next.permissionLevel
-    : "workspace-write";
-  next.model = String(next.model ?? "").trim();
+  if (next.access !== undefined) next.access = sanitizeAccess(next.access);
+  if (typeof next.workspaceDir === "string") {
+    next.workspaceDir = next.workspaceDir.trim();
+  }
+  if (typeof next.model === "string") next.model = next.model.trim();
+  if (!PERMISSION_LEVELS.has(next.permissionLevel)) delete next.permissionLevel;
   return next;
 }
 
 function sanitizeSettingsForSave(body: any): any {
   if (!body || typeof body !== "object") return body;
   const next = { ...body };
-  const positive = (value: unknown, fallback: number) => {
-    const num = Math.floor(Number(value));
-    return Number.isFinite(num) && num > 0 ? num : fallback;
-  };
-  const nonNegative = (value: unknown, fallback: number) => {
-    const num = Math.floor(Number(value));
-    return Number.isFinite(num) && num >= 0 ? num : fallback;
-  };
+  // 这两个属于 chat 插件的 base 配置，老版本 UI 可能还会带上来
   delete next.temperature;
   delete next.enableMediaRecognition;
-  next.maxIterations = positive(next.maxIterations, 500);
-  next.maxContextTokens = positive(next.maxContextTokens, 524288);
-  next.stream = next.stream !== false;
-  next.enableMarkdownScreenshot = next.enableMarkdownScreenshot !== false;
-  next.compaction = {
-    enabled: next.compaction?.enabled !== false,
-    keepRecentMessages: positive(next.compaction?.keepRecentMessages, 20),
-  };
-  next.webSearch = {
-    enabled: next.webSearch?.enabled !== false,
-    baseUrl: String(next.webSearch?.baseUrl ?? "").trim(),
-    timeoutMs: positive(next.webSearch?.timeoutMs, 8000),
-    defaultLimit: positive(next.webSearch?.defaultLimit, 5),
-    maxLimit: positive(next.webSearch?.maxLimit, 8),
-    maxSearchCount: positive(next.webSearch?.maxSearchCount, 50),
-  };
-  next.webFetch = {
-    enabled: next.webFetch?.enabled !== false,
-    timeoutMs: positive(next.webFetch?.timeoutMs, 15000),
-    maxChars: positive(next.webFetch?.maxChars, 12000),
-  };
-  next.bash = {
-    enabled: next.bash?.enabled !== false,
-    timeoutMs: positive(next.bash?.timeoutMs, 120000),
-    approvalTimeoutMs: positive(next.bash?.approvalTimeoutMs, 300000),
-  };
-  next.skills = {
-    enabled: next.skills?.enabled !== false,
-    extraRoots: Array.isArray(next.skills?.extraRoots)
-      ? next.skills.extraRoots
-          .map((item: unknown) => String(item ?? "").trim())
-          .filter(Boolean)
-      : [],
-    maxInPrompt: positive(next.skills?.maxInPrompt, 50),
-    descriptionMaxLength: positive(next.skills?.descriptionMaxLength, 500),
-    activationTtlMs: positive(next.skills?.activationTtlMs, 3_600_000),
-    rescanIntervalMs: nonNegative(next.skills?.rescanIntervalMs, 2000),
-    maxResourceFiles: positive(next.skills?.maxResourceFiles, 200),
-  };
-  next.dataCollection = { enabled: next.dataCollection?.enabled !== false };
-  next.debug = Boolean(next.debug);
+  if (
+    next.skills &&
+    typeof next.skills === "object" &&
+    Array.isArray(next.skills.extraRoots)
+  ) {
+    next.skills = {
+      ...next.skills,
+      extraRoots: next.skills.extraRoots
+        .map((item: unknown) => String(item ?? "").trim())
+        .filter(Boolean),
+    };
+  }
   return next;
 }
 
@@ -123,6 +93,20 @@ export function createAgentRoutes() {
     return c.json({ ok: true, data: updateAgentConfig("base.json", body) });
   });
 
+  // 记忆配置由 agent 插件自己归一化，这里只做读写
+  app.get("/memory", (c) =>
+    c.json({ ok: true, data: getAgentConfig("memory.json") }),
+  );
+
+  app.put("/memory", async (c) => {
+    const body = await c.req.json();
+    logger.info(`[webui-action] agent.memory.update`, {
+      enabled: body?.enabled,
+      retentionMonths: body?.retentionMonths,
+    });
+    return c.json({ ok: true, data: updateAgentConfig("memory.json", body) });
+  });
+
   app.get("/settings", (c) =>
     c.json({ ok: true, data: getAgentConfig("settings.json") }),
   );

package/routes/ai.ts

@@ -5,12 +5,6 @@ import { listStickerCatalog } from "../database";
 import aiService from "mioku-service-ai";
 import type { AIModelRole, AIProtocol, AIUsageRange } from "mioku";
 
-const DEFAULT_MEMORY_GROUP_HISTORY_LIMIT = 300;
-const DEFAULT_MEMORY_USER_HISTORY_LIMIT = 100;
-const DEFAULT_TOPIC_WINDOW_HOURS = 5;
-const DEFAULT_TOPIC_HISTORY_WINDOW_COUNT = 3;
-const DEFAULT_EXPRESSION_LEARN_AFTER_MESSAGES = 100;
-const DEFAULT_EXPRESSION_SAMPLE_SIZE = 8;
 const usageRanges = new Set<AIUsageRange>(["today", "7d", "30d"]);
 const protocols = new Set<AIProtocol>([
   "openai-chat",
@@ -24,111 +18,50 @@ function getAIApi() {
   return aiService?.api as any;
 }
 
-function normalizePersonalizationConfig(input: any): any {
-  const data =
-    input && typeof input === "object" && !Array.isArray(input)
-      ? { ...input }
-      : {};
-
-  const rawMemory =
-    data.memory && typeof data.memory === "object" && !Array.isArray(data.memory)
-      ? { ...data.memory }
-      : {};
-
-  delete rawMemory.maxIterations;
-  delete rawMemory.timeoutMs;
-
-  const groupHistoryLimit = Number(rawMemory.groupHistoryLimit);
-  const userHistoryLimit = Number(rawMemory.userHistoryLimit);
-
-  rawMemory.groupHistoryLimit =
-    Number.isFinite(groupHistoryLimit) && groupHistoryLimit > 0
-      ? Math.floor(groupHistoryLimit)
-      : DEFAULT_MEMORY_GROUP_HISTORY_LIMIT;
-  rawMemory.userHistoryLimit =
-    Number.isFinite(userHistoryLimit) && userHistoryLimit > 0
-      ? Math.floor(userHistoryLimit)
-      : DEFAULT_MEMORY_USER_HISTORY_LIMIT;
-  rawMemory.enabled =
-    typeof rawMemory.enabled === "boolean" ? rawMemory.enabled : true;
-
-  data.memory = rawMemory;
-
-  const rawTopic =
-    data.topic && typeof data.topic === "object" && !Array.isArray(data.topic)
-      ? { ...data.topic }
-      : {};
-
-  const windowHours = Number(rawTopic.windowHours);
-  const legacyTimeThresholdMs = Number(rawTopic.timeThresholdMs);
-  const historyWindowCount = Number(rawTopic.historyWindowCount);
-
-  rawTopic.enabled =
-    typeof rawTopic.enabled === "boolean" ? rawTopic.enabled : true;
-  rawTopic.windowHours =
-    Number.isFinite(windowHours) && windowHours > 0
-      ? Math.floor(windowHours)
-      : Number.isFinite(legacyTimeThresholdMs) && legacyTimeThresholdMs > 0
-        ? Math.max(1, Math.floor(legacyTimeThresholdMs / 3600_000))
-        : DEFAULT_TOPIC_WINDOW_HOURS;
-  rawTopic.historyWindowCount =
-    Number.isFinite(historyWindowCount) && historyWindowCount > 0
-      ? Math.floor(historyWindowCount)
-      : DEFAULT_TOPIC_HISTORY_WINDOW_COUNT;
-
-  delete rawTopic.messageThreshold;
-  delete rawTopic.timeThresholdMs;
-  delete rawTopic.maxTopicsPerSession;
-
-  data.topic = rawTopic;
-
-  const rawExpression =
+function stripDeadPersonalizationKeys(input: any): any {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return {};
+  const data: Record<string, any> = { ...input };
+
+  delete data.memory;
+  delete data.planner;
+
+  if (
+    data.topic &&
+    typeof data.topic === "object" &&
+    !Array.isArray(data.topic)
+  ) {
+    const topic = { ...data.topic };
+    delete topic.timeThresholdMs;
+    delete topic.messageThreshold;
+    delete topic.maxTopicsPerSession;
+    data.topic = topic;
+  }
+
+  if (
     data.expression &&
     typeof data.expression === "object" &&
     !Array.isArray(data.expression)
-      ? { ...data.expression }
-      : {};
-
-  const learnAfterMessages = Number(rawExpression.learnAfterMessages);
-  const legacyMaxExpressions = Number(rawExpression.maxExpressions);
-  const sampleSize = Number(rawExpression.sampleSize);
-
-  rawExpression.enabled =
-    typeof rawExpression.enabled === "boolean" ? rawExpression.enabled : true;
-  rawExpression.learnAfterMessages =
-    Number.isFinite(learnAfterMessages) && learnAfterMessages > 0
-      ? Math.floor(learnAfterMessages)
-      : Number.isFinite(legacyMaxExpressions) && legacyMaxExpressions > 0
-        ? Math.floor(legacyMaxExpressions)
-        : DEFAULT_EXPRESSION_LEARN_AFTER_MESSAGES;
-  rawExpression.sampleSize =
-    Number.isFinite(sampleSize) && sampleSize > 0
-      ? Math.floor(sampleSize)
-      : DEFAULT_EXPRESSION_SAMPLE_SIZE;
-  delete rawExpression.maxExpressions;
-
-  data.expression = rawExpression;
-
-  const rawEmoji =
-    data.emoji && typeof data.emoji === "object" && !Array.isArray(data.emoji)
-      ? { ...data.emoji }
-      : {};
-  rawEmoji.enabled =
-    typeof rawEmoji.enabled === "boolean" ? rawEmoji.enabled : true;
-  rawEmoji.characters = Array.isArray(rawEmoji.characters)
-    ? rawEmoji.characters
-        .map(String)
-        .map((value: string) => value.trim())
-        .filter(Boolean)
-    : [];
-  rawEmoji.stickers = Array.isArray(rawEmoji.stickers)
-    ? rawEmoji.stickers
-        .map(String)
-        .map((value: string) => value.trim())
-        .filter(Boolean)
-    : [];
-  delete rawEmoji.useAISelection;
-  data.emoji = rawEmoji;
+  ) {
+    const expression = { ...data.expression };
+    delete expression.maxExpressions;
+    data.expression = expression;
+  }
+
+  if (
+    data.emoji &&
+    typeof data.emoji === "object" &&
+    !Array.isArray(data.emoji)
+  ) {
+    const emoji = { ...data.emoji };
+    delete emoji.useAISelection;
+    for (const key of ["characters", "stickers"] as const) {
+      if (!Array.isArray(emoji[key])) continue;
+      emoji[key] = emoji[key]
+        .map((item: unknown) => String(item ?? "").trim())
+        .filter(Boolean);
+    }
+    data.emoji = emoji;
+  }
 
   return data;
 }
@@ -181,13 +114,13 @@ export function createAIRoutes() {
   });
 
   app.get("/personalization", (c) => {
-    const data = normalizePersonalizationConfig(
+    const data = stripDeadPersonalizationKeys(
       getChatConfig("personalization.json"),
     );
     return c.json({ ok: true, data });
   });
   app.put("/personalization", async (c) => {
-    const body = normalizePersonalizationConfig(await c.req.json());
+    const body = stripDeadPersonalizationKeys(await c.req.json());
     logger.info(`[webui-action] ai.personalization.update`);
     return c.json({
       ok: true,
@@ -195,6 +128,19 @@ export function createAIRoutes() {
     });
   });
 
+  // 记忆配置由 chat 插件自己归一化（缺字段/坏值在读取时兜底），这里只做读写
+  app.get("/memory", (c) =>
+    c.json({ ok: true, data: getChatConfig("memory.json") }),
+  );
+  app.put("/memory", async (c) => {
+    const body = await c.req.json();
+    logger.info(`[webui-action] ai.memory.update`, {
+      enabled: body?.enabled,
+      retentionMonths: body?.retentionMonths,
+    });
+    return c.json({ ok: true, data: updateChatConfig("memory.json", body) });
+  });
+
   app.get("/settings", (c) =>
     c.json({ ok: true, data: getChatConfig("settings.json") }),
   );
@@ -405,7 +351,9 @@ export function createAIRoutes() {
           .filter((id: string) => id.includes("/") && id.length > 1),
       ),
     );
-    logger.info(`[webui-action] ai.fallback.update`, { count: fallback.length });
+    logger.info(`[webui-action] ai.fallback.update`, {
+      count: fallback.length,
+    });
     api.setMainFallbackChain(fallback);
     const live = api.getMainFallbackChain?.() ?? fallback;
     return c.json({ ok: true, data: { fallback: live, liveFallback: live } });
@@ -496,9 +444,7 @@ export function createAIRoutes() {
     });
   });
 
-  app.get("/stickers", (c) =>
-    c.json({ ok: true, data: listStickerCatalog() }),
-  );
+  app.get("/stickers", (c) => c.json({ ok: true, data: listStickerCatalog() }));
 
   app.get("/usage", (c) => {
     const api = getAIApi();
@@ -512,8 +458,7 @@ export function createAIRoutes() {
         ? (rawRange as AIUsageRange)
         : "today";
     const rawBotId = c.req.query("botId");
-    const botId =
-      rawBotId && rawBotId !== "all" ? Number(rawBotId) : undefined;
+    const botId = rawBotId && rawBotId !== "all" ? Number(rawBotId) : undefined;
 
     if (botId !== undefined && !Number.isFinite(botId)) {
       return c.json({ ok: false, error: "INVALID_BOT_ID" }, 400);

package/routes/index.ts

@@ -9,3 +9,4 @@ export { createStoreRoutes } from "./store";
 export { createDataManagementRoutes } from "./data-management";
 export { createStrangerRoutes } from "./stranger";
 export { createAccessControlRoutes } from "./access-control";
+export { createMcpRoutes } from "./mcp";

package/routes/mcp.ts

@@ -0,0 +1,136 @@
+import { Hono } from "hono";
+import { logger, servicesRegistry } from "mioku";
+import type { McpServerInput, McpServiceApi } from "mioku-service-mcp";
+
+/** 服务可能没装或没起来，统一走注册表按名查，缺失时返回 503 */
+function mcp(): McpServiceApi | undefined {
+  return servicesRegistry.mcp as McpServiceApi | undefined;
+}
+
+function unavailable(c: { json: (body: unknown, status: 503) => Response }): Response {
+  return c.json({ ok: false, error: "MCP_SERVICE_UNAVAILABLE" }, 503);
+}
+
+function badRequest(
+  c: { json: (body: unknown, status: 400) => Response },
+  error: string,
+): Response {
+  return c.json({ ok: false, error }, 400);
+}
+
+function normalizeLimit(value: string | undefined, fallback: number): number {
+  const num = Math.floor(Number(value));
+  if (!Number.isFinite(num) || num <= 0) return fallback;
+  return Math.min(num, 500);
+}
+
+export function createMcpRoutes() {
+  const app = new Hono();
+
+  app.get("/overview", (c) => {
+    const api = mcp();
+    if (!api) return unavailable(c);
+    const config = api.getConfig();
+    return c.json({
+      ok: true,
+      data: {
+        autoConnect: config.autoConnect,
+        reconnectDelayMs: config.reconnectDelayMs,
+        maxConcurrency: config.maxConcurrency,
+        maxTools: config.maxTools,
+        maxResultChars: config.maxResultChars,
+        maxResultImages: config.maxResultImages,
+        revision: api.revision(),
+        toolCount: api.listTools().length,
+        catalogOnlyCount: api.listAllTools().filter((tool) => tool.catalogOnly).length,
+        servers: api.listServers(),
+        configs: api.listServerConfigs(),
+      },
+    });
+  });
+
+  app.post("/servers", async (c) => {
+    const api = mcp();
+    if (!api) return unavailable(c);
+    const body = (await c.req.json().catch(() => ({}))) as McpServerInput;
+    const name = String(body?.name ?? "").trim().toLowerCase();
+    if (!name) return badRequest(c, "请填写服务器名称");
+    logger.info("[webui-action] mcp.server.upsert", { name });
+    const result = await api.upsertServer({ ...body, name });
+    if ("error" in result) return badRequest(c, result.error);
+    return c.json({ ok: true, data: result });
+  });
+
+  app.delete("/servers/:name", async (c) => {
+    const api = mcp();
+    if (!api) return unavailable(c);
+    const name = c.req.param("name");
+    const removed = await api.removeServer(name);
+    if (!removed) return badRequest(c, `服务器 "${name}" 不存在`);
+    logger.info("[webui-action] mcp.server.remove", { name });
+    return c.json({ ok: true, data: { name } });
+  });
+
+  app.put("/servers/:name/enabled", async (c) => {
+    const api = mcp();
+    if (!api) return unavailable(c);
+    const name = c.req.param("name");
+    const body = (await c.req.json().catch(() => ({}))) as { enabled?: unknown };
+    const enabled = body?.enabled !== false;
+    const result = await api.setServerEnabled(name, enabled);
+    if ("error" in result) return badRequest(c, result.error);
+    logger.info(`[webui-action] mcp.server.${enabled ? "enable" : "disable"}`, { name });
+    return c.json({ ok: true, data: result });
+  });
+
+  for (const action of ["connect", "disconnect", "reconnect"] as const) {
+    app.post(`/servers/:name/${action}`, async (c) => {
+      const api = mcp();
+      if (!api) return unavailable(c);
+      const name = c.req.param("name");
+      logger.info(`[webui-action] mcp.server.${action}`, { name });
+      const result = await api[action](name);
+      if ("error" in result) return badRequest(c, result.error);
+      return c.json({ ok: true, data: result });
+    });
+  }
+
+  app.get("/servers/:name/tools", (c) => {
+    const api = mcp();
+    if (!api) return unavailable(c);
+    const name = c.req.param("name");
+    if (!api.getServer(name)) return badRequest(c, `服务器 "${name}" 不存在`);
+    const tools = api
+      .listAllTools()
+      .filter((tool) => tool.server === name)
+      .map((tool) => ({
+        publicName: tool.publicName,
+        tool: tool.tool,
+        description: tool.description,
+        catalogOnly: tool.catalogOnly,
+        parameters: tool.parameters,
+      }));
+    return c.json({ ok: true, data: tools });
+  });
+
+  app.post("/probe", async (c) => {
+    const api = mcp();
+    if (!api) return unavailable(c);
+    const body = (await c.req.json().catch(() => ({}))) as McpServerInput;
+    const name = String(body?.name ?? "").trim().toLowerCase();
+    if (!name) return badRequest(c, "请填写服务器名称");
+    logger.info("[webui-action] mcp.probe", { name });
+    const result = await api.probe({ ...body, name });
+    return c.json({ ok: true, data: result });
+  });
+
+  app.get("/logs", (c) => {
+    const api = mcp();
+    if (!api) return unavailable(c);
+    const server = c.req.query("server") || undefined;
+    const limit = normalizeLimit(c.req.query("limit"), 100);
+    return c.json({ ok: true, data: api.recentLogs(server, limit) });
+  });
+
+  return app;
+}

package/system.ts

@@ -4,7 +4,13 @@ import * as path from "node:path";
 import process from "node:process";
 import AdmZip from "adm-zip";
 import systemInfo from "systeminformation";
-import { buildAdapterReport, connectedBots, logger } from "mioku";
+import {
+  buildAdapterReport,
+  connectedBots,
+  getConfigDefaults,
+  logger,
+  withConfigDefaults,
+} from "mioku";
 import type { AdapterInstanceStatus, Bot } from "mioku";
 import type {
   InstallRequest,
@@ -2389,9 +2395,21 @@ export async function getSaying(): Promise<{ text: string }> {
   return fetchYiyan();
 }
 
+/**
+ * 读插件配置：磁盘值覆盖默认值。
+ *
+ * 默认值只由插件在 `registerConfig` 时登记一次（见 mioku 的 config-defaults），
+ * WebUI 这边不再手抄字段——以前每加一个配置项，要在这里和插件各改一遍。
+ */
+function readPluginConfig(dir: string, owner: string, fileName: string): any {
+  const stored = readJsonFile(path.join(dir, fileName), {});
+  const name = fileName.replace(/\.json$/, "");
+  const defaults = getConfigDefaults("plugin", owner, name);
+  return withConfigDefaults(stored, defaults);
+}
+
 export function getChatConfig(fileName: string): any {
-  const filePath = path.join(CHAT_CONFIG_DIR, fileName);
-  return readJsonFile(filePath, {});
+  return readPluginConfig(CHAT_CONFIG_DIR, "chat", fileName);
 }
 
 export function updateChatConfig(fileName: string, data: any): any {
@@ -2401,8 +2419,7 @@ export function updateChatConfig(fileName: string, data: any): any {
 }
 
 export function getAgentConfig(fileName: string): any {
-  const filePath = path.join(AGENT_CONFIG_DIR, fileName);
-  return readJsonFile(filePath, {});
+  return readPluginConfig(AGENT_CONFIG_DIR, "agent", fileName);
 }
 
 export function updateAgentConfig(fileName: string, data: any): any {