tt-help-cli-ycl 1.4.169 → 1.4.172

package/src/watch/public/index.html

@@ -644,14 +644,63 @@
         <div class="label">命令池</div>
         <div class="value slate" id="wdCmdCount">0</div>
       </div>
+      <div class="stat-card clickable" onclick="wdToggleAllCards()" style="background:rgba(96,165,250,0.05)">
+        <div class="label" id="wdToggleAllLabel" style="font-size:18px">⊞</div>
+        <div class="value" style="font-size:11px;color:#60a5fa">全部展开</div>
+      </div>
       <div class="stat-card clickable" onclick="fetchWatchdogData()" style="background:rgba(96,165,250,0.05)">
         <div class="label" style="font-size:18px">🔄</div>
         <div class="value" style="font-size:11px;color:#60a5fa">刷新</div>
       </div>
     </div>
+    <!-- 订阅中心（Phase 1: 池子管理 + 到期/流量探测 + 引用只读展示，不改节点行为） -->
+    <div id="wdSubsSection"
+      style="margin-bottom:16px;border:1px solid #2a2a3d;border-radius:10px;background:#16161f;padding:12px">
+      <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:10px">
+        <div id="wdSubsHeader" onclick="wdSubsToggle()" title="点击展开/收起订阅列表"
+          style="cursor:pointer;user-select:none;font-size:14px;color:#fbbf24">🛜 订阅中心
+          <span id="wdSubsArrow" style="color:#666;font-size:11px;margin-left:2px"></span>
+          <span id="wdSubsSummary" style="color:#666;font-size:12px;margin-left:8px"></span>
+        </div>
+        <button onclick="wdSubShowAddModal()"
+          style="padding:4px 12px;font-size:12px;background:#fbbf24;color:#000;border:none;border-radius:6px;cursor:pointer;font-weight:600">＋
+          新增订阅</button>
+      </div>
+      <div id="wdSubsList" style="color:#666;font-size:12px">加载中...</div>
+    </div>
     <div id="wdClientsList" style="color:#666;font-size:12px">加载中...</div>
   </div>
 
+  <!-- 订阅中心 新增/编辑弹窗 -->
+  <div id="wdSubModal"
+    style="display:none;position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0,0,0,0.6);z-index:9999;align-items:center;justify-content:center">
+    <div style="background:#1e1e2e;border:1px solid #333;border-radius:12px;padding:24px;width:90%;max-width:560px">
+      <div style="font-size:16px;color:#fbbf24;margin-bottom:4px" id="wdSubModalTitle">＋ 新增订阅</div>
+      <div style="color:#888;font-size:12px;margin-bottom:12px">订阅地址只保存在服务端订阅池，节点不受影响；保存后约 6 小时内自动探测一次，也可在列表里点「检测」立即探测。订阅地址含 token（等于密码），请勿外泄。</div>
+      <div style="margin-bottom:10px">
+        <div style="color:#94a3b8;font-size:12px;margin-bottom:4px">名称（选填，默认自动编号）</div>
+        <input id="wdSubName" placeholder="如：机场A-月付"
+          style="width:100%;box-sizing:border-box;padding:8px 10px;background:#16161e;border:1px solid #333;border-radius:8px;color:#e0e0e0;font-size:12px">
+      </div>
+      <div style="margin-bottom:10px">
+        <div style="color:#94a3b8;font-size:12px;margin-bottom:4px">订阅地址（http/https）</div>
+        <textarea id="wdSubUrl" rows="3" placeholder="https://example.com/api/v1/client/subscribe?token=xxxx"
+          style="width:100%;box-sizing:border-box;padding:10px;background:#16161e;border:1px solid #333;border-radius:8px;color:#e0e0e0;font-size:12px;font-family:monospace;resize:vertical"></textarea>
+      </div>
+      <div style="margin-bottom:10px">
+        <div style="color:#94a3b8;font-size:12px;margin-bottom:4px">备注（选填：重置日 / 套餐名等）</div>
+        <input id="wdSubNote" placeholder="如：每月1号重置流量"
+          style="width:100%;box-sizing:border-box;padding:8px 10px;background:#16161e;border:1px solid #333;border-radius:8px;color:#e0e0e0;font-size:12px">
+      </div>
+      <div style="display:flex;justify-content:flex-end;gap:8px;margin-top:16px">
+        <button onclick="wdSubCloseModal()"
+          style="padding:8px 16px;background:#333;color:#ccc;border:none;border-radius:6px;cursor:pointer;font-size:12px">取消</button>
+        <button onclick="wdSubSave()"
+          style="padding:8px 16px;background:#fbbf24;color:#000;border:none;border-radius:6px;cursor:pointer;font-size:12px;font-weight:600">保存</button>
+      </div>
+    </div>
+  </div>
+
   <!-- 命令编辑弹窗 -->
   <div id="wdCmdModal"
     style="display:none;position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0,0,0,0.6);z-index:9999;align-items:center;justify-content:center">
@@ -785,15 +834,37 @@
   <div id="wdProxyModal"
     style="display:none;position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0,0,0,0.6);z-index:9999;align-items:center;justify-content:center">
     <div style="background:#1e1e2e;border:1px solid #333;border-radius:12px;padding:24px;width:90%;max-width:560px">
-      <div style="font-size:16px;color:#fbbf24;margin-bottom:4px">🛜 代理订阅配置 — <span id="wdProxyUserId"></span></div>
-      <div style="color:#888;font-size:12px;margin-bottom:12px">每行一个订阅地址（http/https），<b style="color:#fbbf24">一行 = 一个独立 mihomo 实例，最多 8 行</b>；<b style="color:#fbbf24">同一地址可配置多行</b>（各自独立使用不同节点）：按行序分配实例 1/2/3…，代理端口依次 127.0.0.1:7897、7898、7899…（API 管理端口 9097 起，同步 +1），业务命令用 --proxy 指定使用哪个端口（客户端卡片“代理订阅”tabs 可查映射）。<br>保存后客户端下次心跳时自动热应用（约 15～30 秒）；订阅名按行序自动编号 sub-1、sub-2…，<b style="color:#f87171">在中间插入/删除行会使后续实例重新编号并重载配置</b>，建议只在末尾追加。临期（&lt;7天）或超量（剩余&lt;10%）在 tab 上标红。</div>
+      <div style="font-size:16px;color:#fbbf24;margin-bottom:4px">🛜 代理订阅配置 — <span id="wdProxyUserId"></span> <span
+          id="wdProxyModeBadge"></span></div>
+      <!-- 自动分配视图（app.js 按模式切换显示） -->
+      <div id="wdProxyAutoView" style="display:none">
+        <div style="color:#888;font-size:12px;margin-bottom:10px">⚡ 自动分配模式：服务端订阅池按「配满 + 粘性槽位 + 跨机器摊开」自动分配订阅，每次心跳惰性重算（池内订阅到期/耗尽/禁用后自动换血，无需手动干预）。<b
+            style="color:#fbbf24">实例 N = 槽位 N</b>：代理端口 7897+N-1、API 端口 9097+N-1。</div>
+        <div style="display:flex;align-items:center;gap:8px;margin-bottom:8px">
+          <span style="color:#e0e0e0;font-size:12px">实例数量：</span>
+          <input id="wdProxyCountInput" type="number" min="1" max="8"
+            style="width:70px;padding:6px 8px;background:#16161e;border:1px solid #333;border-radius:6px;color:#e0e0e0;font-size:13px">
+          <span style="color:#666;font-size:11px">（1～8，每条一个独立 mihomo 实例；修改后按粘性槽位重分配）</span>
+        </div>
+        <div id="wdProxyAllocWarn"></div>
+        <div id="wdProxyAllocTable"
+          style="padding:8px;background:#16161e;border:1px solid #333;border-radius:8px;min-height:60px;font-size:12px">加载中...</div>
+      </div>
+      <!-- 手动编辑视图 -->
+      <div id="wdProxyManualHint" style="color:#888;font-size:12px;margin-bottom:12px">每行一个订阅地址（http/https），<b style="color:#fbbf24">一行 = 一个独立 mihomo 实例，最多 8 行</b>；<b style="color:#fbbf24">同一地址可配置多行</b>（各自独立使用不同节点）：按行序分配实例 1/2/3…，代理端口依次 127.0.0.1:7897、7898、7899…（API 管理端口 9097 起，同步 +1），业务命令用 --proxy 指定使用哪个端口（客户端卡片“代理订阅”tabs 可查映射）。<br>保存后客户端下次心跳时自动热应用（约 15～30 秒）；订阅名按行序自动编号 sub-1、sub-2…，<b style="color:#f87171">在中间插入/删除行会使后续实例重新编号并重载配置</b>，建议只在末尾追加。临期（&lt;7天）或超量（剩余&lt;10%）在 tab 上标红。</div>
       <textarea id="wdProxySubsText" rows="6" placeholder="https://example.com/api/v1/client/subscribe?token=xxxx\nhttps://another-airport.com/sub?token=yyyy"
         style="width:100%;box-sizing:border-box;padding:10px;background:#16161e;border:1px solid #333;border-radius:8px;color:#e0e0e0;font-size:12px;font-family:monospace;resize:vertical"></textarea>
       <div style="display:flex;justify-content:flex-end;gap:8px;margin-top:16px">
         <button onclick="wdCloseProxyModal()"
           style="padding:8px 16px;background:#333;color:#ccc;border:none;border-radius:6px;cursor:pointer;font-size:12px">取消</button>
-        <button onclick="wdSaveProxySettings()"
+        <button id="wdProxySwitchAutoBtn" onclick="wdSwitchProxyAuto()" title="现有列表原样转为自动分配（count=当前条数，切换无感）；之后由服务端订阅池自动换血/摊开"
+          style="display:none;padding:8px 16px;background:#333;color:#4ade80;border:1px solid #4ade80;border-radius:6px;cursor:pointer;font-size:12px">⚡ 切换为自动分配</button>
+        <button id="wdProxySwitchManualBtn" onclick="wdSwitchProxyManual()" title="当前分配结果原样转回手动列表，分配器不再触碰"
+          style="display:none;padding:8px 16px;background:#333;color:#ccc;border:1px solid #555;border-radius:6px;cursor:pointer;font-size:12px">切回手动编辑</button>
+        <button id="wdProxySaveManualBtn" onclick="wdSaveProxySettings()"
           style="padding:8px 16px;background:#fbbf24;color:#000;border:none;border-radius:6px;cursor:pointer;font-size:12px;font-weight:600">保存并热应用</button>
+        <button id="wdProxySaveAutoBtn" onclick="wdSaveProxyCount()"
+          style="display:none;padding:8px 16px;background:#fbbf24;color:#000;border:none;border-radius:6px;cursor:pointer;font-size:12px;font-weight:600">保存数量并下发</button>
       </div>
     </div>
   </div>

package/src/watch/subscription-allocator.js

@@ -0,0 +1,255 @@
+/**
+ * 订阅自动分配器 — Phase 2 v0（服务端 only，客户端零改动）
+ *
+ * 模式约定（proxySettings[userId]）:
+ *   手动模式（存量兼容）: { subscriptions: [{name,url}] }              —— 无 mode 字段，一个字节不动
+ *   自动模式:           { mode:"auto", count, subscriptions, allocWarn, allocatedAt }
+ *                       subscriptions = 物化后的 alloc（槽位序 = 实例序），
+ *                       仍走既有心跳下发 → agent 签名比对 → daemon 热应用链路。
+ *
+ * 规则卡（v0 拍板，见需求讨论记录）:
+ *   1 配满     alloc 条数 = count 恒成立（可用 ≥ 1）
+ *   2 可用集   池子排除「已禁用/已到期/已耗尽」；临期、告急、探测失败未确认死、
+ *              未探测的新订阅都算可用
+ *   3 粘性     槽位原位保留——订阅还活着就不挪窝（端口 = 槽位序）；
+ *              不在池子的存量 URL 状态未知，同样视为可用（迁移无感）
+ *   4 节点内摊开 同一机器槽位尽量用不同订阅；count > 可用去重数才回绕
+ *   5 跨机器错开 补槽时优先选全集群占用数最少的可用订阅
+ *              （占用数 = 该订阅在所有机器 alloc 里出现的次数）
+ *   6 重复合法  回绕重复按池子顺序取
+ *   7 空保护   可用集为空 → alloc 原地不动 + 标黄，绝不下发空列表
+ *   8 决定性   纯函数 + 池子顺序决胜；心跳重跑输入不变则结果恒等，天然粘性
+ *
+ * 选槽打分（取最小）: (本节点其它槽位已用 ? 1 : 0) → 全局占用数升序 → 池子顺序。
+ * 全局占用数每次现算（遍历所有节点 alloc，几十个节点毫秒级）；分配时机 = 心跳惰性计算，
+ * 结果与存量不同才写回配置（下一行 sendJSON 读到的即是新 alloc，同一个心跳就下发）。
+ *
+ * 迁移 = 方案 A: set-proxy-auto 把现有 URL 列表原样转成 alloc（count = 列表长度），
+ * 切换瞬间分配结果 = 现状，节点完全无感；之后所有变化都走分配器。
+ *
+ * 安全约定: 日志只打订阅名/URL 前缀，不泄漏完整 token。
+ */
+
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { getSubscriptionView } from "./subscription-center.js";
+
+const homeDir = homedir() || process.env.HOME || process.env.USERPROFILE || "";
+const WATCHDOG_CONFIG_PATH = join(homeDir, ".tt-help-watchdog.json");
+
+/** 实例上限：与 discover.js RUNTIME_MAX_INSTANCES=8、handleSetProxySettings MAX_SUBS 对齐 */
+export const ALLOC_MAX_INSTANCES = 8;
+
+// ── 可用性判定（规则 #2/#3） ──
+
+/**
+ * 池子视图是否可用：排除「已禁用 / 已到期 / 已耗尽」。
+ * 临期、余量告急、探测失败未确认死、未知（未探测）都算可用——
+ * 与 Phase 1「报警保留、不自动剔除」一脉相承，只有确凿死亡才退出分配。
+ */
+export function isSubAvailable(view) {
+  if (!view) return false;
+  if (view.enabled === false) return false;
+  const code = view.status && view.status.code;
+  return code !== "expired" && code !== "exhausted";
+}
+
+/** 存量槽位 URL 的粘性可用性：不在池子 = 状态未知 = 可用（迁移无感）；在池子按池子状态 */
+function isAllocUrlAvailable(url, viewByUrl) {
+  if (!url) return false;
+  const v = viewByUrl.get(url);
+  return !v || isSubAvailable(v);
+}
+
+// ── 纯函数分配器（规则 #1-#8） ──
+
+function normEntry(it) {
+  if (typeof it === "string") return { name: "", url: it };
+  return { name: (it && it.name) || "", url: (it && it.url) || "" };
+}
+
+function scoreLess(a, b) {
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return a[i] < b[i];
+  }
+  return false;
+}
+
+/**
+ * 分配（纯函数，决定性）
+ * @param {Array}    available  可用订阅视图数组（池子顺序）
+ * @param {number}   count      目标槽数（1..ALLOC_MAX_INSTANCES）
+ * @param {Array}    prevAlloc  存量 alloc（[{name,url}]，条数任意）
+ * @param {Object}   usage      全局占用数 {url: 出现次数}（其它节点 alloc 现算值）
+ * @param {Function} isAvailUrl (url) => 存量 URL 是否可原位保留
+ * @returns {{ alloc: Array<{name,url}>, warn: string|null }}
+ *          warn: "pool-empty" 可用集为空且存在补不上的槽（规则 #7）
+ */
+export function allocateSubscriptions({ available, count, prevAlloc, usage, isAvailUrl }) {
+  const prev = Array.isArray(prevAlloc) ? prevAlloc.map(normEntry) : [];
+  const n = Math.max(1, Math.min(ALLOC_MAX_INSTANCES, parseInt(count, 10) || 1));
+  const avail = Array.isArray(available) ? available : [];
+  const use = usage && typeof usage === "object" ? usage : {};
+
+  const nodeUsed = new Map(); // 本节点新 alloc 内的占用（含粘性保留槽，跨节点占用走 usage）
+  const globalUsed = (url) => (use[url] || 0) + (nodeUsed.get(url) || 0);
+
+  const result = new Array(n).fill(null);
+
+  // Pass 1 粘性（规则 #3）：原位保留仍可用的槽位；count 缩小 = 砍尾部（规则 #1）
+  for (let i = 0; i < n && i < prev.length; i++) {
+    if (prev[i].url && isAvailUrl(prev[i].url)) {
+      result[i] = { ...prev[i] };
+      nodeUsed.set(prev[i].url, (nodeUsed.get(prev[i].url) || 0) + 1);
+    }
+  }
+
+  const hasGap = result.some((s) => !s);
+
+  // 规则 #7 空保护：可用集为空 → 原地不动（原样返回存量，不截断不换血）+ 标黄
+  if (!avail.length) {
+    return hasGap ? { alloc: prev, warn: "pool-empty" } : { alloc: result, warn: null };
+  }
+
+  // Pass 2 补空槽：打分取最小 — (本节点其它槽位已用) → 全局占用升序 → 池子顺序
+  for (let i = 0; i < n; i++) {
+    if (result[i]) continue;
+    let best = null;
+    let bestScore = null;
+    for (let k = 0; k < avail.length; k++) {
+      const s = avail[k];
+      const inNode = (nodeUsed.get(s.url) || 0) > 0;
+      const score = [inNode ? 1 : 0, globalUsed(s.url), k];
+      if (!bestScore || scoreLess(score, bestScore)) {
+        best = s;
+        bestScore = score;
+      }
+    }
+    if (!best) break; // 防御：avail 非空时不可达
+    result[i] = { name: best.name || "", url: best.url };
+    nodeUsed.set(best.url, (nodeUsed.get(best.url) || 0) + 1);
+  }
+
+  return { alloc: result, warn: null };
+}
+
+// ── 心跳惰性接线（watchdog-server 心跳路径调用，单写者） ──
+
+function readCfg() {
+  try {
+    if (existsSync(WATCHDOG_CONFIG_PATH))
+      return JSON.parse(readFileSync(WATCHDOG_CONFIG_PATH, "utf-8"));
+  } catch {}
+  return {};
+}
+
+function writeCfg(cfg) {
+  try {
+    writeFileSync(WATCHDOG_CONFIG_PATH, JSON.stringify(cfg, null, 2), "utf-8");
+  } catch (e) {
+    console.error(`[订阅分配] 配置写回失败: ${e.message}`);
+  }
+}
+
+/** 槽位变更的人类可读描述（日志只出现订阅名与 URL 归属host，不打 token） */
+function urlHost(url) {
+  try {
+    return new URL(url).host;
+  } catch {
+    return String(url || "").slice(0, 30);
+  }
+}
+
+function describeChange(prev, next, viewByUrl) {
+  const parts = [];
+  const max = Math.max(prev.length, next.length);
+  for (let i = 0; i < max; i++) {
+    const o = prev[i];
+    const w = next[i];
+    if (o && w && o.url === w.url) continue;
+    if (o && !w) {
+      parts.push(`槽${i + 1} 「${o.name || urlHost(o.url)}」回收(count缩小)`);
+      continue;
+    }
+    const oLabel = o ? `「${o.name || urlHost(o.url)}」` : "空";
+    const wLabel = `「${w.name || urlHost(w.url)}」`;
+    let reason = "";
+    if (o) {
+      const v = viewByUrl.get(o.url);
+      reason = v && v.status ? `(${v.status.label})` : "";
+    }
+    parts.push(`槽${i + 1} ${oLabel}${reason} → ${wLabel}`);
+  }
+  return parts;
+}
+
+/**
+ * 心跳路径的分配器接入：userId 处于 auto 模式时重算 alloc，变化才写回配置。
+ * 必须在心跳响应构造（读取 proxySettings）之前调用——同一个心跳就把新 alloc 带下去。
+ * 输入不变则输出恒等（规则 #8），重复心跳零写盘。
+ * @returns {{changed:boolean, alloc?:Array, warn?:string|null}|null} 非 auto 模式返回 null
+ */
+export function reconcileAutoAlloc(userId) {
+  if (!userId) return null;
+  const cfg = readCfg();
+  const ps = cfg.proxySettings && cfg.proxySettings[userId];
+  if (!ps || ps.mode !== "auto") return null;
+
+  const views = getSubscriptionView();
+  const viewByUrl = new Map(views.map((v) => [v.url, v]));
+  const available = views.filter(isSubAvailable);
+
+  // 全局占用数现算：其它节点 alloc 里该 URL 出现的次数（本节点走分配内计数）
+  const usage = {};
+  for (const [uid, entry] of Object.entries(cfg.proxySettings || {})) {
+    if (uid === userId) continue;
+    const list = entry && Array.isArray(entry.subscriptions) ? entry.subscriptions : [];
+    for (const it of list) {
+      const u = it && typeof it === "object" ? it.url : it;
+      if (u) usage[u] = (usage[u] || 0) + 1;
+    }
+  }
+
+  const reqCount = parseInt(ps.count, 10) || 1;
+  const count = Math.max(1, Math.min(ALLOC_MAX_INSTANCES, reqCount));
+  const prevAlloc = Array.isArray(ps.subscriptions) ? ps.subscriptions : [];
+
+  const { alloc, warn } = allocateSubscriptions({
+    available,
+    count,
+    prevAlloc,
+    usage,
+    isAvailUrl: (u) => isAllocUrlAvailable(u, viewByUrl),
+  });
+
+  // count-capped 由 set-proxy-auto 端点落 countCapped 标志（落盘的 count 已截断，
+  // 若按 count>MAX 判断会立刻丢失标红）；pool-empty 由本次分配结果得出
+  const nextWarn = warn || (ps.countCapped ? "count-capped" : null);
+  const nextJson = JSON.stringify(alloc);
+  const prevJson = JSON.stringify(prevAlloc);
+  if (nextJson === prevJson && (ps.allocWarn || null) === nextWarn) {
+    return { changed: false, alloc, warn: nextWarn };
+  }
+
+  // 写回（读-改-写之间无 await，进程内原子；与既有 handler 同一写盘模式）
+  const prevWarn = ps.allocWarn || null;
+  ps.subscriptions = alloc;
+  ps.count = count;
+  ps.allocWarn = nextWarn;
+  ps.allocatedAt = Date.now();
+  writeCfg(cfg);
+
+  const diff = describeChange(prevAlloc, alloc, viewByUrl);
+  const ts = new Date().toLocaleTimeString("zh-CN", { hour12: false });
+  const warnNote =
+    nextWarn && nextWarn !== prevWarn
+      ? ` [${nextWarn === "pool-empty" ? "可用订阅为空,保持现状" : "数量超上限,已截断为" + ALLOC_MAX_INSTANCES}]`
+      : "";
+  console.error(
+    `[订阅分配 ${ts}] ${userId} alloc 更新: ${
+      diff.length ? diff.join("; ") : nextWarn !== prevWarn ? "无槽位变化" : "初始化 " + alloc.length + " 槽"
+    }${warnNote}`,
+  );
+  return { changed: true, alloc, warn: nextWarn };
+}