@lancewu602/mihomo-dash 0.0.0-stage → 0.6.1

package/server/src/http/groups.js

@@ -0,0 +1,386 @@
+/**
+ * 策略组（proxy-groups）增删：文本级增删列表条目，保留原有注释与排版，
+ * 校验「解析结果与预期一致」后写盘 → 热重载；
+ * 删除前检查规则 / 其它组的引用，被引用则拒绝（配置不动）。
+ */
+import { writeFileAtomic } from '../shared/atomic-file.js';
+import { saveConfigWithReload } from './config-files.js';
+import { configPath } from '../shared/paths.js';
+import {
+  assertName,
+  dumpListEntry,
+  findListItemLine,
+  findSection,
+  indentOf,
+  insertAtSectionEnd,
+  keyOf,
+  listIndent,
+  listItemEnd,
+  listSection,
+  loadConfig,
+  normalize,
+  openEmptyFlowSection,
+  removeRange,
+  sectionEnd,
+  verifyRewrite,
+} from './config-sections.js';
+
+const SECTION = 'proxy-groups';
+
+/** 当前支持的组类型（值 = 内核 type，键 = 展示名） */
+export const GROUP_TYPES = { select: '手动选择', 'url-test': '自动选择' };
+
+/** 内核保留名称，不能用作策略组名 */
+const RESERVED = ['DIRECT', 'REJECT', 'REJECT-DROP', 'PASS', 'COMPATIBLE', 'GLOBAL'];
+
+const DEFAULT_TEST_URL = 'https://www.gstatic.com/generate_204';
+const DEFAULT_INTERVAL = 300;
+const DEFAULT_TOLERANCE = 50;
+
+/** 成员名称列表：去空、去重，名称规则与订阅一致 */
+function memberList(raw, label) {
+  const list = Array.isArray(raw)
+    ? raw
+    : raw === undefined || raw === null || raw === ''
+      ? []
+      : [raw];
+  const out = [];
+  for (const item of list) {
+    const n = assertName(item, label);
+    if (!out.includes(n)) out.push(n);
+  }
+  return out;
+}
+
+/** 引用检查：返回引用该策略组的位置描述（rules / sub-rules / 其它组的 proxies） */
+export function groupRefs(doc, name) {
+  const refs = [];
+
+  for (const g of listSection(doc, SECTION)) {
+    if (!g || g.name === name) continue;
+    const proxies = Array.isArray(g.proxies) ? g.proxies : [];
+    if (proxies.includes(name)) refs.push(`策略组「${g.name}」的 proxies`);
+  }
+
+  const scanRules = (rules, label) => {
+    for (const raw of Array.isArray(rules) ? rules : []) {
+      const text = String(raw ?? '').trim();
+      if (!text) continue;
+      if (
+        text
+          .split(',')
+          .map((s) => s.trim())
+          .includes(name)
+      )
+        refs.push(`${label}: ${text}`);
+    }
+  };
+  scanRules(doc.rules, 'rules');
+  const sub = doc['sub-rules'];
+  if (sub && typeof sub === 'object' && !Array.isArray(sub)) {
+    for (const [k, v] of Object.entries(sub)) scanRules(v, `sub-rules「${k}」`);
+  }
+
+  return refs;
+}
+
+/** 校验收到的表单并构造策略组条目（新增与编辑共用，name 由调用方决定） */
+function buildEntry(name, input) {
+  const type = String(input?.type ?? '').trim();
+  if (!Object.prototype.hasOwnProperty.call(GROUP_TYPES, type)) {
+    throw new Error('策略组类型仅支持 select（手动选择）或 url-test（自动选择）');
+  }
+
+  const use = memberList(input?.use, '订阅名称');
+  const proxies = memberList(input?.proxies, '节点/策略组名称');
+  if (proxies.includes(name)) throw new Error('策略组不能引用自己');
+  if (use.length === 0 && proxies.length === 0) {
+    throw new Error('至少选择一个订阅或节点/策略组');
+  }
+
+  const entry = { name, type };
+  if (proxies.length) entry.proxies = proxies;
+  if (use.length) entry.use = use;
+  if (type === 'url-test') {
+    const url = String(input?.url ?? '').trim() || DEFAULT_TEST_URL;
+    if (!/^https?:\/\/\S+$/i.test(url)) throw new Error('测速地址需为 http(s) 开头的 URL');
+    const interval = Number(input?.interval);
+    const tolerance = Number(input?.tolerance);
+    entry.url = url;
+    entry.interval = Number.isFinite(interval) && interval > 0 ? interval : DEFAULT_INTERVAL;
+    entry.tolerance = Number.isFinite(tolerance) && tolerance >= 0 ? tolerance : DEFAULT_TOLERANCE;
+  }
+  return entry;
+}
+
+/**
+ * 新增策略组：写入 `proxy-groups` 列表末尾并热重载。
+ * @param {{ name: string, type: 'select'|'url-test', use?: string[], proxies?: string[],
+ *           url?: string, interval?: number, tolerance?: number }} input
+ */
+export async function addGroup(input) {
+  const name = assertName(input?.name, '策略组名称');
+  if (RESERVED.includes(name.toUpperCase())) {
+    throw new Error(`${name} 是内核保留名称，不能作为策略组名`);
+  }
+
+  const entry = buildEntry(name, input);
+
+  const { text, doc } = loadConfig();
+  const list = listSection(doc, SECTION);
+  if (list.some((g) => g && g.name === name)) throw new Error(`策略组 ${name} 已存在`);
+
+  const lines = text.split('\n');
+  const at = findSection(lines, SECTION);
+  let out;
+  if (at >= 0) {
+    // 兼容 `proxy-groups: []` 这种空流式写法
+    openEmptyFlowSection(lines, at, SECTION);
+    // 缩进跟段内现有条目一致（0 / 2 两种列表写法都保留原样）
+    out = insertAtSectionEnd(lines, at, dumpListEntry(entry, listIndent(lines, at)));
+  } else {
+    out = [...lines, `${SECTION}:`, ...dumpListEntry(entry)];
+  }
+
+  const next = normalize(out);
+  verifyRewrite(next, { ...doc, [SECTION]: [...list, entry] });
+
+  const reload = await saveConfigWithReload(next);
+  return { ok: true, name, ...reload };
+}
+
+/**
+ * 删除策略组：先检查引用（被引用则拒绝，不做任何写入），否则移除条目并热重载。
+ * @param {string} name
+ */
+export async function removeGroup(name) {
+  const groupName = assertName(name, '策略组名称');
+  const { text, doc } = loadConfig();
+  const list = listSection(doc, SECTION);
+  if (!list.some((g) => g && g.name === groupName)) {
+    throw new Error(`config.yaml 中未找到策略组 ${groupName}`);
+  }
+
+  const refs = groupRefs(doc, groupName);
+  if (refs.length) {
+    const err = new Error(
+      `策略组 ${groupName} 仍被引用，请先修改以下引用再删除：\n${refs
+        .map((r) => `· ${r}`)
+        .join('\n')}`,
+    );
+    err.refs = refs;
+    throw err;
+  }
+
+  const rest = list.filter((g) => !g || g.name !== groupName);
+  const lines = text.split('\n');
+  const at = findSection(lines, SECTION);
+  if (at < 0) throw new Error(`config.yaml 中未找到 ${SECTION} 段`);
+
+  let out;
+  let expected;
+  if (rest.length === 0) {
+    // 最后一个策略组：连同 proxy-groups 标题行一起移除
+    out = removeRange(lines, at, sectionEnd(lines, at + 1));
+    expected = { ...doc };
+    delete expected[SECTION];
+  } else {
+    const start = findListItemLine(lines, at + 1, groupName);
+    if (start < 0) throw new Error(`config.yaml 中未找到策略组 ${groupName} 的条目`);
+    // 列表条目：删除后不额外插入空行，与相邻条目直接接上
+    out = removeRange(lines, start, listItemEnd(lines, start), { blank: false });
+    expected = { ...doc, [SECTION]: rest };
+  }
+
+  const next = normalize(out);
+  verifyRewrite(next, expected);
+
+  const reload = await saveConfigWithReload(next);
+  return { ok: true, name: groupName, ...reload };
+}
+
+/**
+ * 读取 config.yaml 中全部策略组条目（原样返回）。
+ * 内核 /proxies 不回传 use / interval / tolerance 等配置项，面板展示时以此为准。
+ */
+export function listGroups() {
+  const { doc } = loadConfig();
+  return listSection(doc, SECTION);
+}
+
+/** 读取某策略组在 config.yaml 中的原始条目（内核 /proxies 不回传 use，编辑时以此为准） */
+export function getGroup(name) {
+  const groupName = assertName(name, '策略组名称');
+  const { doc } = loadConfig();
+  const found = listSection(doc, SECTION).find((g) => g && g.name === groupName);
+  if (!found) throw new Error(`config.yaml 中未找到策略组 ${groupName}`);
+  return found;
+}
+
+/**
+ * 面板表单管理的字段。其余键（`icon` / `disable-udp` / `hidden` / `lazy` / `expected-status` /
+ * `max-failed-times` 等）面板没有输入项，必须在编辑时**原样保留**。
+ */
+const MANAGED_KEYS = ['name', 'type', 'proxies', 'use', 'url', 'interval', 'tolerance'];
+
+/**
+ * 用表单构造的条目覆盖原条目：只动 {@link MANAGED_KEYS}，其余键与它们的值一律保留。
+ * （以前是整条替换，编辑一次就把 `icon` / `disable-udp` / `hidden` 这些丢了。）
+ * @param {Record<string, any>} original config.yaml 里的原条目
+ * @param {Record<string, any>} built 表单构造出来的条目
+ */
+function mergeEntry(original, built) {
+  const merged = { ...original };
+  for (const key of MANAGED_KEYS) {
+    if (key in built) merged[key] = built[key];
+    else delete merged[key];
+  }
+  return merged;
+}
+
+/**
+ * 编辑策略组：就地替换 `proxy-groups` 中的条目（名称不可改，避免影响 rules 等处的引用）。
+ *
+ * 只改面板建模的那几个字段（见 {@link mergeEntry}）；`icon` / `disable-udp` / `hidden` 这类
+ * 面板没有输入项的键原样留着。类型不是 select / url-test 的组（fallback / load-balance …）
+ * 面板没有对应表单，直接拒 —— 以前报的是「类型仅支持 select 或 url-test」，看不出该怎么办。
+ * @param {string} name 现有策略组名
+ * @param {object} input 同 addGroup 的表单字段
+ */
+export async function updateGroup(name, input) {
+  const groupName = assertName(name, '策略组名称');
+  const { text, doc } = loadConfig();
+  const list = listSection(doc, SECTION);
+  const index = list.findIndex((g) => g && g.name === groupName);
+  if (index < 0) throw new Error(`config.yaml 中未找到策略组 ${groupName}`);
+
+  const currentType = String(list[index].type ?? '').toLowerCase();
+  if (!Object.prototype.hasOwnProperty.call(GROUP_TYPES, currentType)) {
+    throw new Error(
+      `策略组 ${groupName} 的类型是 ${list[index].type}：面板只提供手动选择 / 自动选择的编辑表单，` +
+        '要改这个组请去「配置文件」页（直接编辑 config.yaml）',
+    );
+  }
+
+  const entry = mergeEntry(list[index], buildEntry(groupName, input));
+
+  const lines = text.split('\n');
+  const at = findSection(lines, SECTION);
+  if (at < 0) throw new Error(`config.yaml 中未找到 ${SECTION} 段`);
+  const start = findListItemLine(lines, at + 1, groupName);
+  if (start < 0) throw new Error(`config.yaml 中未找到策略组 ${groupName} 的条目`);
+  const end = listItemEnd(lines, start);
+
+  // 缩进沿用原条目（0 / 2 两种列表写法都保留原样）
+  const out = [
+    ...lines.slice(0, start),
+    ...dumpListEntry(entry, indentOf(lines[start])),
+    ...lines.slice(end),
+  ];
+  const next = normalize(out);
+  verifyRewrite(next, { ...doc, [SECTION]: list.map((g, i) => (i === index ? entry : g)) });
+
+  const reload = await saveConfigWithReload(next);
+  return { ok: true, name: groupName, ...reload };
+}
+
+/** 节点名合法性：非空、≤ 128 字符、无换行（允许空格与括号，如「日本 中继-1(1.5x)」） */
+function assertNodeName(name) {
+  const n = String(name ?? '').trim();
+  if (!n) throw new Error('节点名称不能为空');
+  if (n.length > 128) throw new Error('节点名称过长（≤128 字符）');
+  if (/[\n\r]/.test(n)) throw new Error('节点名称不能包含换行');
+  return n;
+}
+
+/** 写回 YAML 的字面量：一律加双引号，避免空格 / 括号 / 井号等破坏解析 */
+const quote = (v) => `"${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+
+/** 组内子键的缩进：条目缩进 + 2（缩进 0 的列表写法，子键就是 2） */
+const childIndentOf = (lines, start) => indentOf(lines[start]) + 2;
+
+/** 组内 `default-selected` 行的行号，找不到返回 -1 */
+function findSelectedLine(lines, start, end) {
+  const indent = childIndentOf(lines, start);
+  for (let i = start + 1; i < end; i++) {
+    if (indentOf(lines[i]) === indent && keyOf(lines[i]) === 'default-selected') return i;
+  }
+  return -1;
+}
+
+/**
+ * 落盘 select 组的「当前节点」：写入 / 覆盖 / 删除 config.yaml 中该组的 `default-selected`。
+ *
+ * 只「校验 → 写盘」，**不热重载**：运行时选择已由面板的 `PUT /proxies/<组>` 生效，
+ * `default-selected` 只影响下次加载；若这里再走一次整包重载，会顺带清掉「规则临时禁用」
+ * 「url-test 固定选择」等仅运行时状态。
+ * url-test / fallback / load-balance 这几种组的配置结构里没有对应字段，无法落盘，直接拒绝。
+ * @param {Record<string, string | null>} selections 组名 → 节点名（null = 删除该项）
+ * @returns {Promise<{ applied: string[], cleared: string[] }>}
+ */
+export async function setDefaultSelected(selections) {
+  const entries = Object.entries(selections ?? {});
+  if (!entries.length) throw new Error('未指定要落盘的策略组选择');
+
+  const { text, doc } = loadConfig();
+  const list = listSection(doc, SECTION);
+  /** @type {Map<string, string | null>} */
+  const changed = new Map();
+  for (const [rawName, rawNode] of entries) {
+    const groupName = assertName(rawName, '策略组名称');
+    const index = list.findIndex((g) => g && g.name === groupName);
+    if (index < 0) throw new Error(`config.yaml 中未找到策略组 ${groupName}`);
+    const type = String(list[index].type ?? '').toLowerCase();
+    if (type !== 'select') {
+      throw new Error(
+        `策略组 ${groupName} 的类型是 ${list[index].type}，只有 select 组能落盘当前节点（该类型内核配置里没有对应字段）`,
+      );
+    }
+    const node = rawNode === null ? null : assertNodeName(rawNode);
+    if ((list[index]['default-selected'] ?? null) === node) continue; // 无变化不写盘
+    changed.set(groupName, node);
+  }
+  if (!changed.size) return { applied: [], cleared: [] };
+
+  const lines = text.split('\n');
+  const at = findSection(lines, SECTION);
+  if (at < 0) throw new Error(`config.yaml 中未找到 ${SECTION} 段`);
+  for (const [groupName, node] of changed) {
+    // 逐个组重新定位（插入 / 删除会改变后续行号）
+    const start = findListItemLine(lines, at + 1, groupName);
+    if (start < 0) throw new Error(`config.yaml 中未找到策略组 ${groupName} 的条目`);
+    const end = listItemEnd(lines, start);
+    const keyLine = findSelectedLine(lines, start, end);
+    const indent = ' '.repeat(childIndentOf(lines, start));
+    if (node === null) {
+      if (keyLine >= 0) lines.splice(keyLine, 1);
+      continue;
+    }
+    const re = /^(\s*default-selected\s*:\s*)(?:"[^"]*"|'[^']*'|[^\s#]+)/;
+    if (keyLine >= 0 && re.test(lines[keyLine])) {
+      lines[keyLine] = lines[keyLine].replace(re, `$1${quote(node)}`);
+    } else if (keyLine >= 0) {
+      lines[keyLine] = `${indent}default-selected: ${quote(node)}`;
+    } else {
+      lines.splice(end, 0, `${indent}default-selected: ${quote(node)}`);
+    }
+  }
+
+  const next = normalize(lines);
+  const expectedList = list.map((g) => {
+    if (!g || !changed.has(g.name)) return g;
+    const copy = { ...g };
+    const node = changed.get(g.name);
+    if (node === null) delete copy['default-selected'];
+    else copy['default-selected'] = node;
+    return copy;
+  });
+  verifyRewrite(next, { ...doc, [SECTION]: expectedList });
+
+  const p = configPath();
+  writeFileAtomic(p, next);
+  return {
+    applied: [...changed].filter(([, n]) => n !== null).map(([g]) => g),
+    cleared: [...changed].filter(([, n]) => n === null).map(([g]) => g),
+  };
+}

package/server/src/http/index.js

@@ -0,0 +1,260 @@
+/** 面板服务：REST 转发 + 静态托管 web/dist + 配置文件读写接口。 */
+import express from 'express';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+import { kernelProxy } from './kernel-proxy.js';
+import { listFiles, readFileInfo, saveConfigWithReload, saveFile } from './config-files.js';
+import { addProvider, listProviders, removeProvider, setProviderProxy } from './providers.js';
+import {
+  addGroup,
+  getGroup,
+  listGroups,
+  removeGroup,
+  setDefaultSelected,
+  updateGroup,
+} from './groups.js';
+import { setSettings } from './settings.js';
+import { addRule, listCustomRules, listSystemRules, removeRule, setSystemRule } from './rules.js';
+import { registerSystemProxyRoutes } from './system-proxy.js';
+import { registerKernelAdminRoutes } from './kernel-admin.js';
+import { getController } from '../kernel/client.js';
+import { detectMihomoDir } from '../shared/paths.js';
+
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require('../../../package.json');
+const DIST_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../../web/dist');
+
+/**
+ * @param {{ port: number, host: string, dev?: boolean }} opts
+ */
+export async function startServer(opts) {
+  const startedAt = Date.now();
+  const app = express();
+  app.use(express.json({ limit: '2mb' }));
+
+  // 探活用：只报进程事实，不碰内核 / 配置，所以任何正常状态下都该立刻返回
+  app.get('/api/health', (_req, res) => {
+    res.json({
+      ok: true,
+      name: 'mihomo-dash',
+      version: PKG_VERSION,
+      pid: process.pid,
+      uptime: process.uptime(),
+      startedAt,
+      dev: !!opts.dev,
+    });
+  });
+
+  app.get('/api/meta', (_req, res) => {
+    res.json({
+      name: 'mihomo-dash',
+      version: PKG_VERSION,
+      uptime: process.uptime(),
+      startedAt,
+      dev: !!opts.dev,
+      kernel: getController().url,
+      mihomoDir: detectMihomoDir(),
+    });
+  });
+
+  // REST：透明转发内核控制接口
+  app.use('/api/kernel', kernelProxy());
+
+  // 配置文件读写（校验 → 写盘 → 热重载）
+  app.get('/api/config', (_req, res) => {
+    try {
+      res.json(readFileInfo('config.yaml'));
+    } catch (err) {
+      res.status(500).json({ error: String(err?.message || err) });
+    }
+  });
+  app.put('/api/config', async (req, res) => {
+    try {
+      // reloaded:false + warning = 内核没在跑，文件已写入（不是失败，页面提示橙色）
+      res.json({ ok: true, ...(await saveConfigWithReload(String(req.body?.content ?? ''))) });
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  app.get('/api/files', (_req, res) => {
+    res.json({ files: listFiles() });
+  });
+  // 不存在不算错：带上 exists / path，前端据此显示「还没有配置，保存一次就会创建」
+  app.get('/api/file', (req, res) => {
+    try {
+      res.json(readFileInfo(String(req.query.name || '')));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+
+  app.put('/api/file', (req, res) => {
+    try {
+      saveFile(String(req.body?.name ?? ''), String(req.body?.content ?? ''));
+      res.json({ ok: true });
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+
+  // 订阅（proxy-providers）：GET 读配置条目（interval / health-check 等仅存在于配置文件），
+  // POST/DELETE 走文本级改写 + 热重载
+  app.get('/api/providers', (_req, res) => {
+    try {
+      res.json({ providers: listProviders() });
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  app.post('/api/providers', async (req, res) => {
+    try {
+      res.json(await addProvider(req.body ?? {}));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  // PUT：改这条订阅的「拉取用代理」（proxy 字段，空串 = 删掉该键回退直连）
+  app.put('/api/providers', async (req, res) => {
+    try {
+      res.json(await setProviderProxy(String(req.query.name ?? ''), req.body?.proxy));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  app.delete('/api/providers', async (req, res) => {
+    try {
+      const keepCache = String(req.query.keepCache ?? '') === '1';
+      res.json(await removeProvider(String(req.query.name ?? ''), { deleteCache: !keepCache }));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+
+  // 策略组（proxy-groups）增删：被规则/其它组引用时拒绝删除（refs 一并返回）
+  app.post('/api/groups', async (req, res) => {
+    try {
+      res.json(await addGroup(req.body ?? {}));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err), refs: err?.refs });
+    }
+  });
+  app.delete('/api/groups', async (req, res) => {
+    try {
+      res.json(await removeGroup(String(req.query.name ?? '')));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err), refs: err?.refs });
+    }
+  });
+  // 读取策略组：带 name 返回单条（编辑回填），不带 name 返回全部条目（展示 interval / tolerance）
+  app.get('/api/groups', (req, res) => {
+    try {
+      const name = String(req.query.name ?? '').trim();
+      res.json(name ? { group: getGroup(name) } : { groups: listGroups() });
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  app.put('/api/groups', async (req, res) => {
+    try {
+      const body = req.body ?? {};
+      res.json(await updateGroup(String(body.name ?? ''), body));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  // 落盘 select 组的当前节点（default-selected）：只写文件，运行时由前端 PUT /proxies 完成
+  app.put('/api/groups/selected', async (req, res) => {
+    try {
+      res.json(await setDefaultSelected(req.body?.selections ?? {}));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+
+  // 面板管理的规则（rules 段标记块内的条目）：GET 读文件里的块，POST 新增 / PUT 重排 / DELETE 删除
+  // 都是文本级改写 + 热重载；块外的手工规则与注释不动
+  app.get('/api/rules', (_req, res) => {
+    try {
+      res.json(listCustomRules());
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  app.post('/api/rules', async (req, res) => {
+    try {
+      res.json(await addRule(req.body ?? {}));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  // 系统规则：固定那几条 GEOSITE + MATCH，逐条启 / 禁（禁用 = 注释掉那行）与改目标
+  app.get('/api/system-rules', (_req, res) => {
+    try {
+      res.json(listSystemRules());
+    } catch (err) {
+      res.status(500).json({ error: String(err?.message || err) });
+    }
+  });
+  app.put('/api/system-rules', async (req, res) => {
+    try {
+      res.json(await setSystemRule(req.body ?? {}));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+  app.delete('/api/rules', async (req, res) => {
+    try {
+      res.json(await removeRule({ raw: req.query.raw }));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+
+  // 快捷设置：改写 config.yaml 顶层键（含 GEO 键）→ 写盘 → 应用
+  // （2026-11 去掉了只读的 GET /api/settings：面板不再标记「自定义 / 内核默认」）
+  app.put('/api/settings', async (req, res) => {
+    try {
+      res.json(await setSettings(req.body ?? {}));
+    } catch (err) {
+      res.status(400).json({ error: String(err?.message || err) });
+    }
+  });
+
+  // 系统代理：读本机系统代理状态 / 开关（只动系统设置，不碰内核）
+  registerSystemProxyRoutes(app);
+
+  // 内核管理：装 / 升 / 卸 / 启停重启 / 日志（面板不再是「只读内核」，见 kernel-admin.js 文件头）
+  registerKernelAdminRoutes(app);
+
+  // 静态：生产托管 web/dist（SPA 回退）；dev 模式由 vite 提供页面
+  const indexPath = path.join(DIST_DIR, 'index.html');
+  if (opts.dev) {
+    app.get('/', (_req, res) => {
+      res.send(
+        '<p>mihomo-dash serve (dev)：请访问 vite 开发服务器（默认 http://127.0.0.1:5173）</p>',
+      );
+    });
+  } else if (fs.existsSync(indexPath)) {
+    app.use(express.static(DIST_DIR));
+    app.use((req, res, next) => {
+      if (req.method !== 'GET' || req.path.startsWith('/api')) return next();
+      res.sendFile(indexPath);
+    });
+  } else {
+    app.get('/', (_req, res) => {
+      res
+        .status(503)
+        .send('<p>前端未构建：项目根目录执行 <code>npm run build</code> 后重启面板</p>');
+    });
+  }
+
+  await new Promise((resolve, reject) => {
+    const server = app.listen(opts.port, opts.host, resolve);
+    server.on('error', reject);
+  });
+
+  console.log(`mihomo-dash 面板已启动: http://${opts.host}:${opts.port}`);
+  console.log(`内核接口: ${getController().url}  配置目录: ${detectMihomoDir()}`);
+}