sidekick-chat 0.2.10 → 0.2.11

package/README.md

@@ -58,9 +58,18 @@ sidekick login --url http://47.96.64.66:18792 --token <设备令牌>   # 直连
 ```
 
 - **网页密码**:就是网页版那个 `CORTICO_WEB_PASSWORD`。客户端拿它调站点的 `/api/auth/login`,
-  拿到 `cortico_session` Cookie 存起来,400 天不用重登。服务器地址默认 `https://hkv4.cznorth.cn/chat`。
+  拿到 `cortico_session` Cookie 存起来,400 天不用重登。服务器地址默认 `https://hkv4.cznorth.cn/chat`(香港)。
 - **设备令牌**:部署 `.env` 里的 `SIDEKICK_DEVICE_TOKEN`,和手机 App 用的是同一个。
-  适合备用线路(杭州 `47.96.64.66:18792`)这种没有网页登录接口的直连地址。
+  备用线路没有网页登录接口,要用令牌。
+
+默认线路顺序(主线路连不上或返回 502/503/504 才换,换过去 5 分钟后会先试回主线路):
+
+1. `https://hkv4.cznorth.cn/chat` — 香港主线路
+2. `https://kiro.ch66.top/sk-us/chat` — 美国直连(备用)
+3. `http://47.96.64.66:18792/chat` — 阿里云 frps → 香港 OpenResty → 美国(备用)
+
+用 `--url` 自己指定地址时不会自动加备用线路;要备用就再给 `--alt`(可重复,或逗号分隔),
+也可以写进 `~/.sidekick/config.json` 的 `alts` 数组。`SIDEKICK_ALT` / `SIDEKICK_ALTS` 环境变量同样认。
 
 `sidekick logout` 清掉本机登录态。Cookie 失效时会提示重新 `sidekick login`。
 
@@ -99,6 +108,7 @@ sidekick --device 家里的电脑 "…"   # 换一个署名(默认「终端」)
 | 变量 | 作用 |
 |---|---|
 | `SIDEKICK_URL` | 服务器地址,如 `https://hkv4.cznorth.cn/chat` |
+| `SIDEKICK_ALT` / `SIDEKICK_ALTS` | 备用线路,逗号分隔;主线路连不上时按顺序换 |
 | `SIDEKICK_TOKEN` | 设备令牌(Bearer) |
 | `SIDEKICK_PASSWORD` | 网页登录密码(只在 `sidekick login` 时用,不落盘) |
 | `SIDEKICK_COOKIE` | 直接给 `cortico_session` 的值 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sidekick-chat",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "Sidekick 终端客户端:在终端里和秘书对话",
   "type": "module",
   "license": "PolyForm-Noncommercial-1.0.0",

package/src/api.mjs

@@ -11,22 +11,36 @@ import { authOrigin } from './config.mjs';
 /** 鉴权没过:登录态失效或令牌不对,调用方据此提示重新登录。 */
 export class AuthError extends Error {}
 
-/** 连不上(没拿到响应):只有这种错才换备用线路,4xx / 5xx 不换。 */
+/** 连不上(没拿到响应):只有这种错才换备用线路,4xx 不换。 */
 export class NetworkError extends Error {}
 
-class HttpError extends Error {
+export class HttpError extends Error {
   constructor(status, message) { super(message); this.status = status; }
 }
 
+/** 网关错误通常是隧道断了、上游没起来,换一条线路可能就好了。 */
+function routeFailed(err) {
+  return err instanceof NetworkError || (err instanceof HttpError && [502, 503, 504].includes(err.status));
+}
+
 const REQUEST_TIMEOUT_MS = 20_000;
+/** 换到备用线路后,过这么久再试回主线路。 */
+const PRIMARY_RETRY_MS = 5 * 60_000;
 
 export class SidekickApi {
-  /** `alt` 是备用线路(如杭州 `http://47.96.64.66:18792`),只有主线路连不上才用。 */
-  constructor({ url, alt, token, cookie }) {
+  /**
+   * `alts` 是备用线路列表(美国直连、阿里→香港→美国),按顺序在连不上时换;
+   * `alt` 是旧版的单条写法,仍认。
+   */
+  constructor({ url, alt, alts, token, cookie, now = Date.now, primaryRetryMs = PRIMARY_RETRY_MS }) {
     this.primary = stripSlashes(String(url || ''));
-    this.alt = stripSlashes(String(alt || ''));
+    const list = Array.isArray(alts) ? alts : alts !== undefined ? [alts] : alt !== undefined ? [alt] : [];
+    this.alts = [...new Set(list.map((b) => stripSlashes(String(b || ''))).filter((b) => b && b !== this.primary))];
     /** 当前用着哪条:切到备用线路后就不再每次先撞一次主线路。 */
     this.current = this.primary;
+    this.switchedAt = 0;
+    this.now = now;
+    this.primaryRetryMs = primaryRetryMs;
     this.token = token || '';
     this.cookie = cookie || '';
   }
@@ -42,20 +56,32 @@ export class SidekickApi {
     return h;
   }
 
-  /** 先试当前线路,连不上再试备用线路(只有拿不到响应才算连不上)。 */
+  /**
+   * 当前线路优先;换到备用线路超过 5 分钟后,下一次请求先试回主线路。
+   * 返回的列表里不再包含已经试过的那条当前线路。
+   */
+  routeOrder() {
+    const all = [this.primary, ...this.alts].filter(Boolean);
+    if (this.current === this.primary) return all;
+    const backups = all.filter((b) => b !== this.primary);
+    if (this.now() - this.switchedAt >= this.primaryRetryMs) return [this.primary, ...backups];
+    // 还没到回头试主线路的时候:当前这条优先,其余备用在后面,主线路垫底。
+    return [this.current, ...backups.filter((b) => b !== this.current), this.primary];
+  }
+
+  /** 先试当前线路,连不上再按顺序试备用线路。4xx 是请求本身的问题,不换。 */
   async attempt(run) {
-    const bases = [this.current === this.alt ? this.primary : this.current];
-    if (this.alt && this.alt !== bases[0]) bases.push(this.alt);
     let last;
-    for (const base of bases) {
+    for (const base of this.routeOrder()) {
       try {
         const out = await run(base);
         this.current = base;
+        this.switchedAt = base === this.primary ? 0 : this.now();
         return out;
       } catch (err) {
-        if (!(err instanceof NetworkError)) {
+        if (!routeFailed(err)) {
           // 备用线路上没有网页登录接口:提示改用令牌,别让人以为密码错了。
-          if (err instanceof AuthError && base === this.alt && this.cookie) {
+          if (err instanceof AuthError && base !== this.primary && this.cookie) {
             throw new AuthError('备用线路不认网页登录,改成 sidekick login --token <设备令牌>');
           }
           throw err;

package/src/config.mjs

@@ -7,8 +7,17 @@ import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 
 export const DEFAULT_URL = 'https://hkv4.cznorth.cn/chat';
-/** 主线路连不上时自动换的备用线路(杭州阿里云 frps 把 chat World 的 18792 开在公网)。 */
-export const DEFAULT_ALT = 'http://47.96.64.66:18792';
+/**
+ * 主线路(香港)连不上时按顺序换的备用线路:
+ * 1. 美国直连(kiro.ch66.top 的证书在美机上,`/sk-us` 前缀转到各 World);
+ * 2. 阿里云 frps → 香港 OpenResty → 美国(和主线路同一个后端,只是入口在杭州)。
+ */
+export const DEFAULT_ALTS = [
+  'https://kiro.ch66.top/sk-us/chat',
+  'http://47.96.64.66:18792/chat',
+];
+/** 旧配置里的单条备用线路;仍然是「阿里云 → 美国」,现在中间也经香港。 */
+export const DEFAULT_ALT = DEFAULT_ALTS[1];
 
 export function configPath() {
   return process.env.SIDEKICK_CONFIG || join(homedir(), '.sidekick', 'config.json');
@@ -48,13 +57,17 @@ export function clearConfig() {
 export function resolveSettings(flags = {}) {
   const saved = readConfig();
   const url = String(flags.url || process.env.SIDEKICK_URL || saved.url || DEFAULT_URL).trim();
-  const alt = String(flags.alt || process.env.SIDEKICK_ALT || saved.alt || defaultAltFor(url)).trim();
+  const rawAlts = flags.alts ?? flags.alt ?? process.env.SIDEKICK_ALTS ?? process.env.SIDEKICK_ALT
+    ?? upgradeSavedAlts(saved) ?? defaultAltsFor(url);
+  const alts = normalizeAlts(rawAlts).map(stripTrailingSlash);
   const token = String(flags.token || process.env.SIDEKICK_TOKEN || saved.token || '').trim();
   const cookie = String(process.env.SIDEKICK_COOKIE || saved.cookie || '').trim();
   const device = String(flags.device || process.env.SIDEKICK_DEVICE || saved.device || '终端').trim();
   return {
     url: stripTrailingSlash(url),
-    alt: stripTrailingSlash(alt),
+    /** 旧代码只认单条备用线路,保留第一个。 */
+    alt: alts[0] || '',
+    alts,
     token,
     cookie,
     device,
@@ -64,13 +77,34 @@ export function resolveSettings(flags = {}) {
   };
 }
 
+/** 旧版本登录时会自动把单条杭州备用线路写进 `alt`;读到它就升级成新的两条默认线路。 */
+export function upgradeSavedAlts(saved) {
+  if (Array.isArray(saved.alts)) return saved.alts;
+  if (!saved.alt) return undefined;
+  const old = stripTrailingSlash(String(saved.alt));
+  if (old === 'http://47.96.64.66:18792' || old === 'http://47.96.64.66:18792/chat') return [...DEFAULT_ALTS];
+  return [saved.alt];
+}
+
+/** `--alt` 可重复,也可写成逗号/空格/换行分隔;数组要原样保留。 */
+export function normalizeAlts(value) {
+  if (value === undefined || value === null) return [];
+  const list = Array.isArray(value) ? value : String(value).split(/[,\s]+/);
+  return [...new Set(list.map((v) => String(v ?? '').trim()).filter(Boolean))];
+}
+
 export function stripTrailingSlash(url) {
   return url.replace(/\/+$/, '');
 }
 
 /** 用默认的主线路时自动带上已知的备用线路;自己指定 `--url` 就只走那一条。 */
+export function defaultAltsFor(url) {
+  return stripTrailingSlash(url) === DEFAULT_URL ? [...DEFAULT_ALTS] : [];
+}
+
+/** 兼容旧调用:只要第一条备用线路。 */
 export function defaultAltFor(url) {
-  return stripTrailingSlash(url) === DEFAULT_URL ? DEFAULT_ALT : '';
+  return defaultAltsFor(url)[0] || '';
 }
 
 /** WebUI 的登录接口在站点根上,不在 `/chat/` 这类前缀下面。 */

package/src/main.mjs

@@ -10,7 +10,7 @@ import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { AuthError, SidekickApi, loginWithPassword } from './api.mjs';
 import {
-  DEFAULT_ALT,
+  DEFAULT_ALTS,
   DEFAULT_URL,
   clearConfig,
   configPath,
@@ -54,7 +54,8 @@ const HELP = `Sidekick 终端客户端 ${PACKAGE_VERSION}
 
 参数:
   --url <地址>      服务器地址,默认 ${DEFAULT_URL}
-  --alt <地址>      备用线路,主线路连不上时自动换,默认 ${DEFAULT_ALT}
+  --alt <地址>      备用线路,主线路连不上时按顺序换;可重复或逗号分隔
+                    默认:${DEFAULT_ALTS.join(' , ')}
   --token <令牌>    设备令牌(部署 .env 的 SIDEKICK_DEVICE_TOKEN),跳过密码登录
   --password <密码> 网页登录密码(不给就在终端里问)
   --conv <会话>     指定会话:id、名字或 /conv 列表里的序号,默认和秘书的私聊
@@ -68,13 +69,13 @@ const HELP = `Sidekick 终端客户端 ${PACKAGE_VERSION}
 
 进交互后可用 /help 看命令,/conv 列会话,/to 切换,Ctrl-C 退出。
 
-环境变量(优先于配置文件):SIDEKICK_URL、SIDEKICK_ALT、SIDEKICK_TOKEN、SIDEKICK_PASSWORD、SIDEKICK_DEVICE、SIDEKICK_COOKIE。
+环境变量(优先于配置文件):SIDEKICK_URL、SIDEKICK_ALT / SIDEKICK_ALTS、SIDEKICK_TOKEN、SIDEKICK_PASSWORD、SIDEKICK_DEVICE、SIDEKICK_COOKIE。
 配置放在 ${configPath()}(权限 600)。`;
 
 /** 命令行参数解析:node 自带的 parseArgs,不引第三方依赖。 */
 function parseFlags(argv) {
   const flags = { positional: [] };
-  const takesValue = new Set(['url', 'alt', 'token', 'password', 'conv', 'device', 'wait']);
+  const takesValue = new Set(['url', 'alt', 'alts', 'token', 'password', 'conv', 'device', 'wait']);
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
     if (arg === '--') {
@@ -107,7 +108,9 @@ function parseFlags(argv) {
       if (!takesValue.has(name)) throw new Error(`不认识的参数:--${name}`);
       const value = eq >= 0 ? arg.slice(eq + 1) : argv[++i];
       if (value === undefined) throw new Error(`--${name} 缺一个值`);
-      flags[name] = value;
+      // --alt 可重复:攒成列表交给 resolveSettings。
+      if (name === 'alt') (flags.alts ??= []).push(value);
+      else flags[name] = value;
       continue;
     }
     flags.positional.push(arg);
@@ -143,10 +146,11 @@ async function loginCommand(flags) {
     cookie = await loginWithPassword(url, password);
   }
 
-  const api = new SidekickApi({ url, alt: current.alt, token, cookie });
+  const api = new SidekickApi({ url, alts: current.alts, token, cookie });
   const state = await api.state();
   const primary = state.bots.find((b) => b.primary);
-  const cfg = { ...readConfig(), url, alt: current.alt, device: current.device || '终端', savedAt: new Date().toISOString() };
+  const cfg = { ...readConfig(), url, alts: current.alts, device: current.device || '终端', savedAt: new Date().toISOString() };
+  delete cfg.alt;
   if (token) {
     cfg.token = token;
     delete cfg.cookie;

package/src/quota.mjs

@@ -75,7 +75,12 @@ export function createQuotaReader(settings, { api = new SidekickApi(settings), a
     opencode: () => api.request('GET', 'v1/opencode/quota', undefined, { signal: ctl.signal }),
     codex: () => api.request('GET', 'v1/codex/status', undefined, { signal: ctl.signal }),
     claude: () => {
-      ccApi ??= new SidekickApi({ ...settings, url: ccwebBase(settings.url), alt: ccwebBase(settings.alt) });
+      if (!ccApi) {
+        // 每条线路都换成对应的 ccweb 入口;推不出的(自定义地址)跳过,别让额度查询整个失败。
+        const bases = [settings.url, ...(settings.alts ?? (settings.alt ? [settings.alt] : []))]
+          .flatMap((base) => { try { return [ccwebBase(base)]; } catch { return []; } });
+        ccApi = new SidekickApi({ ...settings, url: bases[0], alts: bases.slice(1) });
+      }
       return ccApi.request('GET', 'v1/agents', undefined, { signal: ctl.signal });
     },
   };