@lancewu602/mihomo-dash 0.0.0-stage → 0.6.1

package/server/src/http/config-sections.js

@@ -0,0 +1,278 @@
+/**
+ * config.yaml 文本级改写工具：定位顶层段落与条目、删除时压缩空行、写盘前校验解析结果。
+ * 由 providers.js（映射形式段落）、groups.js（列表形式段落）、rules.js（标记块）与
+ * settings.js（顶层标量键）共用，改写时保留原注释与排版。
+ */
+import yaml from 'js-yaml';
+import { readFile } from './config-files.js';
+
+/** 名称合法性：非空、≤64 字符、不含换行 / 冒号 / 井号 */
+export function assertName(name, label = '名称') {
+  const n = String(name ?? '').trim();
+  if (!n) throw new Error(`${label}不能为空`);
+  if (n.length > 64) throw new Error(`${label}过长（≤64 字符）`);
+  if (/[\n\r:#]/.test(n)) throw new Error(`${label}不能包含 : # 或换行`);
+  return n;
+}
+
+/** 读取 config.yaml 原文与解析结果 */
+export function loadConfig() {
+  const text = readFile('config.yaml');
+  let doc;
+  try {
+    doc = yaml.load(text) ?? {};
+  } catch (e) {
+    throw new Error(`config.yaml 解析失败: ${e.message}`);
+  }
+  if (typeof doc !== 'object' || doc === null || Array.isArray(doc)) {
+    throw new Error('config.yaml 结构异常（顶层应为映射）');
+  }
+  return { text, doc };
+}
+
+/** 映射形式段落（非映射时视作空），如 proxy-providers */
+export function mapSection(doc, section) {
+  const v = doc[section];
+  return v && typeof v === 'object' && !Array.isArray(v) ? v : {};
+}
+
+/** 列表形式段落（非数组时视作空），如 proxy-groups */
+export function listSection(doc, section) {
+  const v = doc[section];
+  return Array.isArray(v) ? v : [];
+}
+
+export const indentOf = (line) => line.match(/^\s*/)[0].length;
+
+/** 取行首键名（兼容引号键；列表项与注释返回 null） */
+export function keyOf(line) {
+  const t = line.trim();
+  if (!t || t.startsWith('#') || t.startsWith('- ')) return null;
+  const m = line.match(/^\s*(?:"([^"]*)"|'([^']*)'|([^:#]*?))\s*:/);
+  if (!m) return null;
+  return (m[1] ?? m[2] ?? m[3] ?? '').trim();
+}
+
+/** 取列表项 `- name: xxx` 的名称（非列表项或无名返回 null） */
+export function itemNameOf(line) {
+  const m = line.match(/^\s*-\s*(?:"name"|'name'|name)\s*:\s*(.+?)\s*$/);
+  if (!m) return null;
+  return m[1].replace(/^["']|["']$/g, '').trim();
+}
+
+/**
+ * 取标量列表项的值（`- DOMAIN-SUFFIX,a.com,组`，去首尾引号）。
+ * 映射形式条目（`- name: xxx`）、注释、空行返回 null，供 rules 这类纯字符串列表使用。
+ */
+export function scalarItemOf(line) {
+  const m = line.match(/^\s*-\s+(.*?)\s*$/);
+  if (!m) return null;
+  const v = m[1].trim();
+  if (!v || v.startsWith('#')) return null;
+  if (/^[^\s:]+:(\s|$)/.test(v)) return null; // 映射条目，交回 itemNameOf / keyOf
+  return v.replace(/^["']|["']$/g, '').trim();
+}
+
+/** 定位顶层段落所在行号，找不到返回 -1 */
+export function findSection(lines, section) {
+  for (let i = 0; i < lines.length; i++) {
+    if (indentOf(lines[i]) === 0 && keyOf(lines[i]) === section) return i;
+  }
+  return -1;
+}
+
+/**
+ * 缩进 0 的块序列条目（`- xxx`）。YAML 允许序列与它的键**同缩进**：
+ *
+ * ```yaml
+ * rules:
+ * - MATCH,DIRECT
+ * ```
+ *
+ * 这与缩进 2 的写法等价（内核两种都认），所以段落扫描必须把它当成段落内容，
+ * 否则 `sectionEnd` 会在第一条 `- xxx` 就收尾，所有基于段落定位的编辑（规则 / 策略组 / 订阅）
+ * 都会在 verifyRewrite 那一步报「改写后的 config.yaml 解析失败」。
+ */
+export const isSeqItem = (line) => /^-\s/.test(line);
+
+/** 段落里第一条内容行的缩进（跳过空行与注释）；第一条内容不是 `- ` 条目时返回 null */
+function firstSeqIndent(lines, start) {
+  for (let i = start; i < lines.length; i++) {
+    const text = lines[i].trim();
+    if (!text || text.startsWith('#')) continue;
+    return isSeqItem(lines[i]) ? indentOf(lines[i]) : null;
+  }
+  return null;
+}
+
+/**
+ * 顶层段落结束行：其后第一个「非空且缩进为 0」的行。
+ *
+ * 缩进 0 的 `- ` 条目不算结束（见 {@link isSeqItem}）。另外，**当这个段落的列表条目就是
+ * 缩进 0 写法时**，缩进 0 的注释也算段落内容 —— 面板自己就会往 `rules` 段里写
+ * `# >>> mihomo-dash 自定义规则` 这种标记行（缩进跟着条目走，也是 0）。
+ * 缩进 2 的常规写法保持原行为：缩进 0 的注释仍然是段落结束（不能把别处的注释卷进来）。
+ */
+export function sectionEnd(lines, start) {
+  const zeroIndentList = firstSeqIndent(lines, start) === 0;
+  let i = start;
+  while (i < lines.length) {
+    const line = lines[i];
+    if (!line.trim()) {
+      i++;
+      continue;
+    }
+    if (indentOf(line) === 0) {
+      if (isSeqItem(line)) {
+        i++;
+        continue;
+      }
+      if (zeroIndentList && line.trim().startsWith('#')) {
+        i++;
+        continue;
+      }
+      break;
+    }
+    i++;
+  }
+  return i;
+}
+
+/**
+ * 列表段落里条目的缩进（取第一条 `- ` 条目；段内没有条目时默认 2）。
+ * 新增条目按它写：缩进 0 的写法（`rules:` 换行 `- MATCH,DIRECT`）也支持。
+ */
+export function listIndent(lines, sectionLine) {
+  const end = sectionEnd(lines, sectionLine + 1);
+  for (let i = sectionLine + 1; i < end; i++) {
+    if (isSeqItem(lines[i])) return indentOf(lines[i]);
+  }
+  return 2;
+}
+
+/** 段落写成 `section: []` 时改为 `section:`，便于追加块状条目；就地修改 lines 并返回是否改动 */
+export function openEmptyFlowSection(lines, at, section) {
+  const re = new RegExp(`^(\\s*)(?:"${section}"|'${section}'|${section})\\s*:\\s*\\[\\s*\\]\\s*$`);
+  if (at < 0 || !re.test(lines[at])) return false;
+  lines[at] = lines[at].replace(/\[\s*\]\s*$/, '').replace(/\s+$/, '');
+  return true;
+}
+
+/** 删除 [start, end) 并压缩拼接处的连续空行；blank=false 时不额外插入分隔空行（列表条目用）。
+ *  纯函数（不改传入数组），与 Array.prototype.splice 同名不同义，故另起名字。 */
+export function removeRange(lines, start, end, { blank = true } = {}) {
+  const head = lines.slice(0, start);
+  const tail = lines.slice(end);
+  while (head.length && !head[head.length - 1].trim()) head.pop();
+  while (tail.length && !tail[0].trim()) tail.shift();
+  if (!tail.length) return head;
+  return blank ? [...head, '', ...tail] : [...head, ...tail];
+}
+
+/** 在段落末尾（跳过尾部空行）插入若干行，返回新行数组 */
+export function insertAtSectionEnd(lines, sectionStart, block) {
+  let at = sectionEnd(lines, sectionStart + 1);
+  while (at > sectionStart + 1 && !lines[at - 1].trim()) at--;
+  return [...lines.slice(0, at), ...block, ...lines.slice(at)];
+}
+
+/** 规范化换行并保证以单个换行结尾 */
+export const normalize = (lines) => `${lines.join('\n').replace(/\n+$/, '')}\n`;
+
+/** 递归排序键的稳定序列化，用于比对解析结果 */
+export function stableStringify(v) {
+  if (Array.isArray(v)) return `[${v.map(stableStringify).join(',')}]`;
+  if (v && typeof v === 'object') {
+    return `{${Object.keys(v)
+      .sort()
+      .map((k) => `${JSON.stringify(k)}:${stableStringify(v[k])}`)
+      .join(',')}}`;
+  }
+  return JSON.stringify(v) ?? 'null';
+}
+
+/** 写盘前的最后一道防线：改写后的文本必须能解析成与预期一致的结构 */
+export function verifyRewrite(text, expected) {
+  let parsed;
+  try {
+    parsed = yaml.load(text);
+  } catch (e) {
+    throw new Error(`改写后的 config.yaml 解析失败（已放弃写入）: ${e.message}`);
+  }
+  if (stableStringify(parsed) !== stableStringify(expected)) {
+    throw new Error('改写后的 config.yaml 与预期不一致（已放弃写入）');
+  }
+}
+
+/** 在映射形式段落内定位条目（缩进 2）所在行号，找不到返回 -1 */
+export function findMapEntryLine(lines, from, name) {
+  for (let i = from; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.trim()) continue;
+    const indent = indentOf(line);
+    if (indent === 0) break; // 段落结束
+    if (indent === 2 && keyOf(line) === name) return i;
+  }
+  return -1;
+}
+
+/** 映射条目的结束行：其后第一个「非空且缩进 ≤2」的行 */
+export function mapEntryEnd(lines, start) {
+  let i = start;
+  while (i < lines.length) {
+    if (!lines[i].trim()) {
+      i++;
+      continue;
+    }
+    if (indentOf(lines[i]) <= 2) break;
+    i++;
+  }
+  return i;
+}
+
+/** 在列表形式段落内定位条目行号，找不到返回 -1（缩进 0 / 2 的列表写法都支持） */
+export function findListItemLine(lines, from, name) {
+  const end = sectionEnd(lines, from);
+  for (let i = from; i < end; i++) {
+    if (itemNameOf(lines[i]) === name) return i;
+  }
+  return -1;
+}
+
+/**
+ * 列表条目的结束行：其后第一个「段落结束」或「下一个条目」的行。
+ * 条目尾部的注释行（缩进 ≤2，如 `  # 组注释`）与空行不归该条目，
+ * 这样替换/删除条目时不会连带吞掉属于下一条目的注释。
+ */
+export function listItemEnd(lines, start) {
+  let i = start + 1;
+  let end = start + 1; // 最后一条确属该条目的内容行之后
+  while (i < lines.length) {
+    const line = lines[i];
+    const text = line.trim();
+    if (!text) {
+      i++;
+      continue;
+    }
+    const indent = indentOf(line);
+    if (indent === 0) break; // 段落结束
+    if (indent <= 2 && /^\s*-\s/.test(line)) break; // 下一个条目
+    if (indent <= 2 && text.startsWith('#')) {
+      i++;
+      continue; // 条目之间的注释
+    }
+    end = i + 1;
+    i++;
+  }
+  return end;
+}
+
+/** 生成缩进到段落内的块状 YAML 行（列表条目：映射块状、内部数组流式，贴合手工排版） */
+export function dumpListEntry(entry, indent = 2) {
+  const pad = ' '.repeat(indent);
+  return yaml
+    .dump([entry], { indent: 2, lineWidth: 100, noRefs: true, flowLevel: 2 })
+    .trimEnd()
+    .split('\n')
+    .map((l) => (l ? pad + l : l));
+}

package/server/src/http/default-config.js

@@ -0,0 +1,69 @@
+/**
+ * 面板生成的最小默认配置。
+ *
+ * 只有**首次安装内核**（落点原本没有二进制）时会写到配置目录；面板没有「让用户在这儿一键写默认配置」
+ * 的入口（2026-11 按用户要求去掉了），要自定义就在「配置文件」页自己写并保存。
+ * 单独一个文件是为了让 kernel-admin.js 与别处都能用，不成环。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { writeFileAtomic } from '../shared/atomic-file.js';
+import { KERNEL_CONFIG_DIR, resetMihomoDirCache } from '../shared/paths.js';
+import { resetControllerCache } from '../kernel/client.js';
+
+/**
+ * 装完还没有配置时生成的默认配置：只保证「内核能起来」，**全部直连**（没有节点，不冒充有代理可用）。
+ * external-controller 故意不写内核默认的 9090：那个端口最容易被别的 clash / mihomo 客户端占着，
+ * 这里用 8190 避开。**必须显式写出来**：内核只听配置文件里的，面板 `getController()` 读不到时才回退 9090。
+ * `profile.store-selected`（**2026-11 按用户要求不再生成，默认配置里没有这个键**）：它决定节点选择以
+ * 配置还是以缓存为准 —— 写成 `false` 时「配置说了算」（面板切 select 组会把选中项写进该组的
+ * `default-selected`）；不写就是内核默认的「开」，那时启动会拿 `cache.db` 里缓存的选择**覆盖**配置，
+ * 手改 `default-selected` 会看起来「没生效」。面板切组两边都会写（运行时 `PUT /proxies/<组>` + 落盘），
+ * 所以平时感觉不出差别，只有手改配置文件时会。要恢复这个行为：在默认配置里加回
+ * `profile: { store-selected: false }`（或用户在面板/配置文件页自己加）。
+ *
+ * GEO 那四项（geodata-mode / geo-auto-update / geo-update-interval / geox-url）默认值指向 jsDelivr 镜像：
+ * 内核自带的 GitHub 直链在国内网络基本拉不动（release 直链 302 到 `objects.githubusercontent.com`
+ * 之后卡住、raw 连不上），2026-11 按用户要求改成镜像。要下的四个文件落在配置目录里，名字分别是
+ * GeoSite.dat / GeoIP.dat / geoip.metadb / GeoLite2-ASN.mmdb。
+ *
+ * `rules`：**只留一条 `MATCH,DIRECT` 兜底**（2026-11 按用户要求去掉了原先预置的 `proxy-groups`
+ * （成员只有 DIRECT 的 select 组）与 6 条 `GEOSITE`（private / category-ads-all / cn / gfw /
+ * category-scholar-!cn / category-ai-!cn）—— 默认配置不该替用户预设分流策略）。
+ * 那几条规则并没有丢：规则页的「系统规则」卡片固定列着它们（`SYSTEM_RULES`），想用哪条点一下开关即可，
+ * 启用时会连着目标一起写进 `rules` 段；`MATCH` 是兜底规则，卡片上固定启用、不给开关。
+ *
+ * 生成出来的文件**只留首行那条官方文档链接**：2026-11 按用户要求把「生成说明」「键序说明」「GEO 说明」
+ * 这类解释性注释全去掉了（要留着看的知识都写在这段 JSDoc 里），文件里就是干净的键值。
+ */
+export const DEFAULT_CONFIG = `# Document: https://wiki.metacubex.one/config/
+mixed-port: 7890
+ipv6: true
+mode: rule
+log-level: warning
+external-controller: 127.0.0.1:8190
+geodata-mode: true
+geo-auto-update: true
+geo-update-interval: 12
+geox-url:
+  geosite: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geosite.dat"
+  geoip: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geoip.dat"
+  mmdb: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geoip.metadb"
+  asn: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/GeoLite2-ASN.mmdb"
+rules:
+  - MATCH,DIRECT
+`;
+/**
+ * 写一份最小默认配置到指定目录（会建目录，**已有 config.yaml 直接覆盖**），并让两个缓存失效：
+ * 目录缓存（不然本进程会一直记得「刚才没找到」）与接口缓存（里面存的可能就是这份新的 external-controller）。
+ * @param {string} [dir]
+ * @returns {string} config.yaml 的绝对路径
+ */
+export function writeDefaultConfig(dir = KERNEL_CONFIG_DIR) {
+  fs.mkdirSync(dir, { recursive: true });
+  const file = path.join(dir, 'config.yaml');
+  writeFileAtomic(file, DEFAULT_CONFIG);
+  resetMihomoDirCache();
+  resetControllerCache();
+  return file;
+}