u1s1-cli 1.15.0 → 1.15.2

package/dist/agents/claude.d.ts

@@ -65,15 +65,48 @@ export declare function withMcpPermissions(settings: Record<string, unknown>): R
  * --settings 的优先级高于项目设置,在这里写回默认值。
  */
 export declare const CLAUDE_SETTINGS_ENV_PINNED: Readonly<Record<string, string>>;
+/** 去掉连接/凭证相关项(SETTINGS_FORBIDDEN、env 里的 SETTINGS_ENV_FORBIDDEN),钉上 CLAUDE_SETTINGS_ENV_PINNED。 */
+export declare function sanitizeClaudeSettings(settings: Record<string, unknown>): Record<string, unknown>;
 /**
  * 网关的 settings → 写给 --settings 的对象:去掉连接/凭证相关项,钉上 CLAUDE_SETTINGS_ENV_PINNED;
  * model 用调用方选好的(用户在 u1s1 config 里定的、仍在阵容里的模型),没给时保留网关的,
  * 网关也没有就用 default_model。
  */
 export declare function claudeSettingsFromConfig(config: AgentConfig, model?: string | null): Record<string, unknown>;
+/** 调用方的 --settings 有问题(缺值、读不了、不是 JSON 对象);runClaude 报出来后以非 0 退出。 */
+export declare class ClaudeSettingsArgError extends Error {
+    name: string;
+}
+/**
+ * Claude Code 的 --settings 只认最后一个(2.1.323 实测),用户参数里再带一个就把启动器的整份设置盖掉。
+ * 所以从用户参数里把它们全抽出来(`--settings <值>` 与 `--settings=<值>`,按出现顺序;`--` 之后不动),
+ * 由启动器合并进自己写的那份。值可以是文件路径,也可以是 JSON 字符串(与 Claude Code 一样)。
+ */
+export declare function extractSettingsArgs(userArgs: readonly string[]): {
+    rest: string[];
+    sources: string[];
+};
+/** 读一个 --settings 的值:以 `{` 开头按 JSON 字符串解析,否则当文件路径(相对 cwd)。必须是 JSON 对象。 */
+export declare function loadCallerSettings(source: string, cwd?: string): Record<string, unknown>;
+/**
+ * 把调用方的设置合并进启动器的:对象逐层合并;hooks 每个事件的数组拼接;其余数组拼接去重;
+ * 标量(含 model、statusLine 这类整项)以调用方为准。合并后调用方还要再过 sanitizeClaudeSettings 与
+ * withMcpPermissions,不能借此换凭证、换地址、改请求形状。
+ */
+export declare function mergeClaudeSettings(base: Record<string, unknown>, caller: Record<string, unknown>): Record<string, unknown>;
+/** 启动器的设置 + 调用方的设置(按顺序)→ 清洗 → MCP 权限:写进 --settings 文件的最终内容。 */
+export declare function finalClaudeSettings(launcher: Record<string, unknown>, callers: readonly Record<string, unknown>[], withMcp: boolean): Record<string, unknown>;
 export declare function writeClaudeSettings(file: string, settings: Record<string, unknown>): void;
 /** 桌面端复用:同一份注入逻辑(embed.ts 导出)。 */
 export declare function agentLaunchEnv(agent: "claude", input: ClaudeLaunchInput): NodeJS.ProcessEnv;
+/**
+ * 带调用方 --settings 时,合并结果写进这个进程自己的文件:Claude Code 会监视 --settings 文件、改了就重读,
+ * 几个进程共用一份的话,后起的会把先起的那个的 hooks(调用方按会话区分的回调)换成自己的。
+ * 没有调用方 --settings 时内容只取决于网关配置,仍用共用的 settingsFile。
+ */
+export declare function processSettingsFile(paths: Pick<ClaudePaths, "root">, pid?: number): string;
+/** 删掉上次没来得及清理(进程被强杀)的每进程设置文件;进程还在的不动。 */
+export declare function cleanStaleSettingsFiles(root: string, alive?: (pid: number) => boolean): void;
 /**
  * `u1s1 claude [参数…]`。返回子进程的退出码(启动前就失败返回 1)。
  */

package/dist/agents/claude.js

@@ -7,6 +7,9 @@
  *   ANTHROPIC_AUTH_TOKEN=<本地 token>                  代理只认 Bearer;不能用 ANTHROPIC_API_KEY(发 x-api-key)
  *   DISABLE_AUTOUPDATER=1                              更新由启动器管(runtime.ts)
  *   --settings <启动器写出的文件>                     网关下发的模型阵容等;文件里没有任何凭证
+ *                                                      调用方自己传的 --settings(文件或 JSON,可多个)不转给客户端,
+ *                                                      按顺序合并进这份文件再清洗(Claude Code 只认最后一个 --settings),
+ *                                                      见 extractSettingsArgs / mergeClaudeSettings
  *   --mcp-config <启动器写出的文件>                   u1s1 工具服务(搜索、读网页、生图,见 mcp-server.ts);
  *                                                      文件里只引用环境变量名,代理地址和本地 token 的值在子进程环境里
  *
@@ -14,10 +17,10 @@
  * 再显式写入上面几项;本地 token 只对本进程的签名代理有效,进程退出即作废。
  * 不改二进制,不删除也不禁用它自带的登录方式。
  */
-import { rmSync } from "node:fs";
-import { join } from "node:path";
+import { readdirSync, readFileSync, rmSync } from "node:fs";
+import { join, resolve } from "node:path";
 import { writePrivateFile } from "../config.js";
-import { lang } from "../i18n.js";
+import { lang, tr } from "../i18n.js";
 import { MCP_ENV_NAMES, MCP_SERVER_NAME, MCP_TRACE_ENV, mcpInjectionDisabled, mcpLaunchEnv, mcpServerCommand, } from "../mcp-server.js";
 import { AGENT_PROFILES, agentsRoot, prepareAgentLaunch, runPreparedAgent, } from "./launch.js";
 import { runtimePaths } from "./runtime.js";
@@ -145,13 +148,17 @@ export function withMcpPermissions(settings) {
     permissions["ask"] = mergeRules(permissions["ask"], CLAUDE_MCP_ASK_TOOLS);
     return { ...settings, permissions };
 }
-/** settings.env 里绝不能出现的键(契约上网关也不会发,这里再兜一层)。 */
-const SETTINGS_ENV_FORBIDDEN = new Set([
-    "ANTHROPIC_BASE_URL",
-    "ANTHROPIC_AUTH_TOKEN",
-    "ANTHROPIC_API_KEY",
-    "CLAUDE_CODE_OAUTH_TOKEN",
-    "CLAUDE_CONFIG_DIR",
+/**
+ * settings.env 里绝不能出现的键(契约上网关也不会发,这里再兜一层;调用方的 --settings 合并进来后同样过这一遍):
+ * CLAUDE_ENV_DROP 里换凭证、换地址、换云厂商、改 u1s1 工具服务连接的那些。模型变量可以由调用方改
+ * (等同于改 model);两个请求形状变量另由 CLAUDE_SETTINGS_ENV_PINNED 钉回默认值。
+ */
+const SETTINGS_ENV_ALLOWED_FROM_DROP = new Set([
+    "ANTHROPIC_MODEL",
+    "ANTHROPIC_SMALL_FAST_MODEL",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL",
 ]);
 /** 会让客户端去别处取凭证的设置项。 */
 const SETTINGS_FORBIDDEN = new Set(["apiKeyHelper"]);
@@ -165,35 +172,149 @@ export const CLAUDE_SETTINGS_ENV_PINNED = {
     CLAUDE_CODE_ATTRIBUTION_HEADER: "1",
     CLAUDE_CODE_EXTRA_BODY: "{}",
 };
-/**
- * 网关的 settings → 写给 --settings 的对象:去掉连接/凭证相关项,钉上 CLAUDE_SETTINGS_ENV_PINNED;
- * model 用调用方选好的(用户在 u1s1 config 里定的、仍在阵容里的模型),没给时保留网关的,
- * 网关也没有就用 default_model。
- */
-export function claudeSettingsFromConfig(config, model) {
+const SETTINGS_ENV_FORBIDDEN = new Set(CLAUDE_ENV_DROP.filter((key) => !SETTINGS_ENV_ALLOWED_FROM_DROP.has(key) && !(key in CLAUDE_SETTINGS_ENV_PINNED)));
+function isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+/** 去掉连接/凭证相关项(SETTINGS_FORBIDDEN、env 里的 SETTINGS_ENV_FORBIDDEN),钉上 CLAUDE_SETTINGS_ENV_PINNED。 */
+export function sanitizeClaudeSettings(settings) {
     const out = {};
-    for (const [key, value] of Object.entries(config.settings ?? {})) {
+    for (const [key, value] of Object.entries(settings)) {
         if (!SETTINGS_FORBIDDEN.has(key))
             out[key] = value;
     }
-    const rawEnv = out["env"];
-    if (rawEnv && typeof rawEnv === "object" && !Array.isArray(rawEnv)) {
-        const env = {};
-        for (const [key, value] of Object.entries(rawEnv)) {
+    const env = {};
+    if (isPlainObject(out["env"])) {
+        for (const [key, value] of Object.entries(out["env"])) {
             if (!SETTINGS_ENV_FORBIDDEN.has(key))
                 env[key] = value;
         }
-        out["env"] = { ...env, ...CLAUDE_SETTINGS_ENV_PINNED };
-    }
-    else {
-        out["env"] = { ...CLAUDE_SETTINGS_ENV_PINNED };
     }
+    out["env"] = { ...env, ...CLAUDE_SETTINGS_ENV_PINNED };
+    return out;
+}
+/**
+ * 网关的 settings → 写给 --settings 的对象:去掉连接/凭证相关项,钉上 CLAUDE_SETTINGS_ENV_PINNED;
+ * model 用调用方选好的(用户在 u1s1 config 里定的、仍在阵容里的模型),没给时保留网关的,
+ * 网关也没有就用 default_model。
+ */
+export function claudeSettingsFromConfig(config, model) {
+    const out = sanitizeClaudeSettings(config.settings ?? {});
     if (model)
         out["model"] = model;
     else if (out["model"] === undefined && config.defaultModel)
         out["model"] = config.defaultModel;
     return out;
 }
+// ---------------------------------------------------------------- 调用方的 --settings
+/** 调用方的 --settings 有问题(缺值、读不了、不是 JSON 对象);runClaude 报出来后以非 0 退出。 */
+export class ClaudeSettingsArgError extends Error {
+    name = "ClaudeSettingsArgError";
+}
+/**
+ * Claude Code 的 --settings 只认最后一个(2.1.323 实测),用户参数里再带一个就把启动器的整份设置盖掉。
+ * 所以从用户参数里把它们全抽出来(`--settings <值>` 与 `--settings=<值>`,按出现顺序;`--` 之后不动),
+ * 由启动器合并进自己写的那份。值可以是文件路径,也可以是 JSON 字符串(与 Claude Code 一样)。
+ */
+export function extractSettingsArgs(userArgs) {
+    const rest = [];
+    const sources = [];
+    for (let i = 0; i < userArgs.length; i++) {
+        const arg = userArgs[i];
+        if (arg === "--") {
+            rest.push(...userArgs.slice(i));
+            break;
+        }
+        if (arg === "--settings") {
+            const value = userArgs[i + 1];
+            if (value === undefined || value === "")
+                throw new ClaudeSettingsArgError(tr("--settings 后面缺少文件路径或 JSON。", "--settings needs a file path or a JSON string."));
+            sources.push(value);
+            i++;
+        }
+        else if (arg.startsWith("--settings=")) {
+            const value = arg.slice("--settings=".length);
+            if (value === "")
+                throw new ClaudeSettingsArgError(tr("--settings= 后面缺少文件路径或 JSON。", "--settings= needs a file path or a JSON string."));
+            sources.push(value);
+        }
+        else {
+            rest.push(arg);
+        }
+    }
+    return { rest, sources };
+}
+/** 读一个 --settings 的值:以 `{` 开头按 JSON 字符串解析,否则当文件路径(相对 cwd)。必须是 JSON 对象。 */
+export function loadCallerSettings(source, cwd = process.cwd()) {
+    const inline = source.trimStart().startsWith("{");
+    let text;
+    if (inline) {
+        text = source;
+    }
+    else {
+        const file = resolve(cwd, source);
+        try {
+            text = readFileSync(file, "utf8");
+        }
+        catch (e) {
+            const reason = e.code ?? e.message;
+            throw new ClaudeSettingsArgError(tr(`读不了 --settings 文件 ${file}(${reason})。`, `Couldn't read the --settings file ${file} (${reason}).`));
+        }
+    }
+    const what = inline ? tr("--settings 的 JSON", "The --settings JSON") : tr(`--settings 文件 ${resolve(cwd, source)}`, `The --settings file ${resolve(cwd, source)}`);
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (e) {
+        throw new ClaudeSettingsArgError(tr(`${what} 不是合法的 JSON:${e.message}`, `${what} is not valid JSON: ${e.message}`));
+    }
+    if (!isPlainObject(parsed))
+        throw new ClaudeSettingsArgError(tr(`${what} 必须是一个 JSON 对象。`, `${what} must be a JSON object.`));
+    return parsed;
+}
+function mergeArrays(base, extra, dedupe) {
+    if (!dedupe)
+        return [...base, ...extra];
+    const out = [...base];
+    const seen = new Set(out.map((item) => JSON.stringify(item)));
+    for (const item of extra) {
+        const key = JSON.stringify(item);
+        if (!seen.has(key)) {
+            seen.add(key);
+            out.push(item);
+        }
+    }
+    return out;
+}
+function mergeValue(base, extra, path) {
+    if (isPlainObject(base) && isPlainObject(extra)) {
+        const out = { ...base };
+        for (const [key, value] of Object.entries(extra)) {
+            if (key === "__proto__")
+                continue;
+            out[key] = Object.hasOwn(out, key) ? mergeValue(out[key], value, [...path, key]) : value;
+        }
+        return out;
+    }
+    // hooks.<事件> 按原样拼接(调用方的回调排在后面);其余数组(permissions.allow/ask/deny 等)拼接去重
+    if (Array.isArray(base) && Array.isArray(extra))
+        return mergeArrays(base, extra, !(path.length === 2 && path[0] === "hooks"));
+    return extra;
+}
+/**
+ * 把调用方的设置合并进启动器的:对象逐层合并;hooks 每个事件的数组拼接;其余数组拼接去重;
+ * 标量(含 model、statusLine 这类整项)以调用方为准。合并后调用方还要再过 sanitizeClaudeSettings 与
+ * withMcpPermissions,不能借此换凭证、换地址、改请求形状。
+ */
+export function mergeClaudeSettings(base, caller) {
+    return mergeValue(base, caller, []);
+}
+/** 启动器的设置 + 调用方的设置(按顺序)→ 清洗 → MCP 权限:写进 --settings 文件的最终内容。 */
+export function finalClaudeSettings(launcher, callers, withMcp) {
+    const merged = sanitizeClaudeSettings(callers.reduce(mergeClaudeSettings, launcher));
+    return withMcp ? withMcpPermissions(merged) : merged;
+}
 export function writeClaudeSettings(file, settings) {
     writePrivateFile(file, JSON.stringify(settings, null, 2) + "\n");
 }
@@ -204,10 +325,59 @@ export function agentLaunchEnv(agent, input) {
     return claudeLaunchEnv(input);
 }
 // ---------------------------------------------------------------- run
+const PROCESS_SETTINGS = /^settings-(\d+)\.json$/;
+/**
+ * 带调用方 --settings 时,合并结果写进这个进程自己的文件:Claude Code 会监视 --settings 文件、改了就重读,
+ * 几个进程共用一份的话,后起的会把先起的那个的 hooks(调用方按会话区分的回调)换成自己的。
+ * 没有调用方 --settings 时内容只取决于网关配置,仍用共用的 settingsFile。
+ */
+export function processSettingsFile(paths, pid = process.pid) {
+    return join(paths.root, `settings-${pid}.json`);
+}
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === "EPERM";
+    }
+}
+/** 删掉上次没来得及清理(进程被强杀)的每进程设置文件;进程还在的不动。 */
+export function cleanStaleSettingsFiles(root, alive = pidAlive) {
+    let names;
+    try {
+        names = readdirSync(root);
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        const m = PROCESS_SETTINGS.exec(name);
+        if (m && !alive(Number(m[1])))
+            rmSync(join(root, name), { force: true });
+    }
+}
 /**
  * `u1s1 claude [参数…]`。返回子进程的退出码(启动前就失败返回 1)。
  */
 export async function runClaude(userArgs) {
+    // 调用方的 --settings 先读出来:有错在登录、联网之前就报。只查版本的快速路径原样不动。
+    let launchArgs = userArgs;
+    let callerSettings = [];
+    if (!isBareVersionQuery(userArgs)) {
+        try {
+            const { rest, sources } = extractSettingsArgs(userArgs);
+            launchArgs = rest;
+            callerSettings = sources.map((source) => loadCallerSettings(source));
+        }
+        catch (e) {
+            if (!(e instanceof ClaudeSettingsArgError))
+                throw e;
+            console.error(e.message);
+            return 1;
+        }
+    }
     const paths = claudePaths();
     const prepared = await prepareAgentLaunch(AGENT_PROFILES.claude, paths);
     if (typeof prepared === "number")
@@ -216,7 +386,9 @@ export async function runClaude(userArgs) {
         ? undefined
         : mcpLaunchEnv({ proxyBaseUrl: prepared.proxy.baseUrl, localToken: prepared.proxy.localKey, features: prepared.features, lang: lang() });
     const settings = claudeSettingsFromConfig(prepared.config, prepared.model);
-    writeClaudeSettings(paths.settingsFile, mcp ? withMcpPermissions(settings) : settings);
+    cleanStaleSettingsFiles(paths.root);
+    const settingsFile = callerSettings.length ? processSettingsFile(paths) : paths.settingsFile;
+    writeClaudeSettings(settingsFile, finalClaudeSettings(settings, callerSettings, !!mcp));
     if (mcp)
         writePrivateFile(paths.mcpConfigFile, JSON.stringify(claudeMcpConfig(), null, 2) + "\n");
     else
@@ -228,6 +400,12 @@ export async function runClaude(userArgs) {
         configDir: paths.configDir,
         mcp,
     });
-    const args = claudeLaunchArgs(paths.settingsFile, userArgs, mcp ? paths.mcpConfigFile : undefined);
-    return runPreparedAgent({ agent: "claude", paths, prepared, args, env, userArgs });
+    const args = claudeLaunchArgs(settingsFile, launchArgs, mcp ? paths.mcpConfigFile : undefined);
+    try {
+        return await runPreparedAgent({ agent: "claude", paths, prepared, args, env, userArgs });
+    }
+    finally {
+        if (settingsFile !== paths.settingsFile)
+            rmSync(settingsFile, { force: true });
+    }
 }

package/dist/agents/pi.js

@@ -20,7 +20,7 @@ import { deployHintText, markNudge, shouldShowDeployHint } from "../nudges.js";
 import { createGatewayTelemetry } from "../telemetry.js";
 import { installCommand, siteLinks, siteOf } from "../site.js";
 import { lang, tr } from "../i18n.js";
-const PACKAGE_NAME = "u1s1-cli";
+import { globalUpdateCommand, latestVersionUrl } from "../update.js";
 /** 启动时检测到的可自动安装的新版;TUI 退出后才装(见 installPendingUpdate)。 */
 let pendingUpdate;
 /**
@@ -36,7 +36,7 @@ let pendingUpdate;
 async function checkForUpdate() {
     let latest;
     try {
-        const url = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+        const url = latestVersionUrl();
         const res = await fetch(url, {
             headers: { Accept: "application/json" },
             signal: AbortSignal.timeout(5_000),
@@ -82,9 +82,7 @@ async function checkForUpdate() {
         : userAgent.startsWith("yarn") ? "yarn"
             : userAgent.startsWith("bun") ? "bun"
                 : "npm";
-    const installCmd = pm === "npm"
-        ? `npm install -g --loglevel=error ${PACKAGE_NAME}@latest`
-        : `${pm} add -g ${PACKAGE_NAME}@latest`;
+    const installCmd = globalUpdateCommand(pm);
     pendingUpdate = { latest, installCmd };
     setUpdateNotice(tr(`⬆ 发现新版 v${latest},退出后自动更新`, `⬆ v${latest} available, will update on exit`));
 }

package/dist/config.d.ts

@@ -1,13 +1,23 @@
 import { type webcrypto } from "node:crypto";
-import { type Site } from "./site.js";
+import { type Site, type SiteId } from "./site.js";
 export declare const VERSION: string;
+/**
+ * npm 上同一份构建发两个包(scripts/make-cli-npm-packages.mjs):u1s1-cli 默认国际站,
+ * u1s1-cli-cn 默认中国站,只差 package.json 的 name 和 u1s1.defaultSite。仓库、便携包、
+ * 桌面版内嵌的 package.json 不带标记,按中国站(老行为)。升级/查新版都用自己的包名。
+ */
+export declare const PACKAGE_NAME: string;
+export declare const PACKAGE_DEFAULT_SITE: SiteId;
 /**
  * 便携包安装(install.sh / install.ps1):包根旁边带自己的 node 运行时,
  * npm 更新碰不到这份拷贝,升级只能整包重装。npm 全局安装的包在 node_modules
  * 下,按父目录名先排除,避免撞上恰好叫 node 的目录误判。
  */
 export declare function isPortableInstall(): boolean;
-/** 默认连中国站;国际站由安装脚本写入 baseUrl 或 `u1s1 login --site global` 切换。 */
+/**
+ * 本机还没有 ~/.u1s1/config.json 时连的站(包标记决定)。配置文件已存在但没写 baseUrl 的
+ * 一律是中国站:中国站历来不写 baseUrl,翻默认站不能把存量用户和他们的凭证带去国际站。
+ */
 export declare const DEFAULT_BASE_URL: string;
 export declare const PROVIDER_ID = "u1s1";
 export declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
@@ -225,12 +235,18 @@ export declare function resolvePreferredModel(cfg: Pick<CliConfig, "model" | "mo
 export declare function loadConfig(): CliConfig;
 /** 只看配置文件、不叠加环境变量覆盖的配置(判断「文件里存的是哪个站」用)。 */
 export declare function loadFileConfig(): CliConfig;
+/**
+ * 配置文件在、却没写 baseUrl(老中国站用户)→ 显式写成中国站固定下来,以后换装
+ * 默认国际站的包也不会把人带走。只补这一个字段,其它原样保留;读不懂的文件不碰。
+ */
+export declare function pinLegacySiteBaseUrl(): void;
 /**
  * 配置文件内容 + 环境变量 → 生效配置。环境变量优先于文件;文件里的历代中国站
  * API 根换成当前中国站 apiBase(migrateStoredBaseUrl),下次 saveConfig 时落盘。
- * env / currentCnApiBase 可注入,供测试模拟 P1 换主域后的迁移。
+ * 都没有 baseUrl 时用 fallback 站(见 fallbackSite)。
+ * env / currentCnApiBase / fallback 可注入,供测试模拟 P1 换主域后的迁移和不同包的默认站。
  */
-export declare function configFromFile(file: Partial<CliConfig>, env?: NodeJS.ProcessEnv, currentCnApiBase?: string): CliConfig;
+export declare function configFromFile(file: Partial<CliConfig>, env?: NodeJS.ProcessEnv, currentCnApiBase?: string, fallback?: SiteId): CliConfig;
 /**
  * 当前生效站点(按 loadConfig().baseUrl 判定,含 U1S1_BASE_URL 覆盖)。手里没有 cfg 的
  * 文案/链接(模块级提示、生成的扩展、错误人话化)用它;有 cfg 的地方直接 siteOf(cfg)。

package/dist/config.js

@@ -7,7 +7,15 @@ import { fileURLToPath } from "node:url";
 import { resetLang, setLangResolver, tr } from "./i18n.js";
 import { migrateStoredBaseUrl, SITES, siteOf } from "./site.js";
 const require = createRequire(import.meta.url);
-export const VERSION = require("../package.json").version;
+const pkg = require("../package.json");
+export const VERSION = pkg.version;
+/**
+ * npm 上同一份构建发两个包(scripts/make-cli-npm-packages.mjs):u1s1-cli 默认国际站,
+ * u1s1-cli-cn 默认中国站,只差 package.json 的 name 和 u1s1.defaultSite。仓库、便携包、
+ * 桌面版内嵌的 package.json 不带标记,按中国站(老行为)。升级/查新版都用自己的包名。
+ */
+export const PACKAGE_NAME = typeof pkg.name === "string" && /^[a-z0-9][a-z0-9._-]*$/.test(pkg.name) ? pkg.name : "u1s1-cli";
+export const PACKAGE_DEFAULT_SITE = pkg.u1s1?.defaultSite === "intl" ? "intl" : "cn";
 /**
  * 便携包安装(install.sh / install.ps1):包根旁边带自己的 node 运行时,
  * npm 更新碰不到这份拷贝,升级只能整包重装。npm 全局安装的包在 node_modules
@@ -22,8 +30,11 @@ export function isPortableInstall() {
         : join(pkgRoot, "..", "node", "bin", "node");
     return existsSync(portableNode);
 }
-/** 默认连中国站;国际站由安装脚本写入 baseUrl 或 `u1s1 login --site global` 切换。 */
-export const DEFAULT_BASE_URL = SITES.cn.apiBase;
+/**
+ * 本机还没有 ~/.u1s1/config.json 时连的站(包标记决定)。配置文件已存在但没写 baseUrl 的
+ * 一律是中国站:中国站历来不写 baseUrl,翻默认站不能把存量用户和他们的凭证带去国际站。
+ */
+export const DEFAULT_BASE_URL = SITES[PACKAGE_DEFAULT_SITE].apiBase;
 export const PROVIDER_ID = "u1s1";
 /**
  * Make a short alias from a model id by stripping common prefixes:厂商前缀
@@ -336,19 +347,39 @@ export function resolvePreferredModel(cfg) {
     }
     return { provider: PROVIDER_ID, id: defaultModelId() };
 }
+/** 配置里没写 baseUrl 时按哪个站:没有配置文件 → 包的默认站;有文件(老中国站用户)→ 中国站。 */
+function fallbackSite() {
+    return existsSync(configFile) ? "cn" : PACKAGE_DEFAULT_SITE;
+}
 export function loadConfig() {
-    return configFromFile((readJsonFile(configFile) ?? {}));
+    return configFromFile((readJsonFile(configFile) ?? {}), process.env, SITES.cn.apiBase, fallbackSite());
 }
 /** 只看配置文件、不叠加环境变量覆盖的配置(判断「文件里存的是哪个站」用)。 */
 export function loadFileConfig() {
-    return configFromFile((readJsonFile(configFile) ?? {}), {});
+    return configFromFile((readJsonFile(configFile) ?? {}), {}, SITES.cn.apiBase, fallbackSite());
+}
+/**
+ * 配置文件在、却没写 baseUrl(老中国站用户)→ 显式写成中国站固定下来,以后换装
+ * 默认国际站的包也不会把人带走。只补这一个字段,其它原样保留;读不懂的文件不碰。
+ */
+export function pinLegacySiteBaseUrl() {
+    const file = readJsonFile(configFile);
+    if (!file || Array.isArray(file) || file.baseUrl)
+        return;
+    try {
+        writePrivateFile(configFile, JSON.stringify({ ...file, baseUrl: SITES.cn.apiBase }, null, 2) + "\n");
+    }
+    catch {
+        // 写不进去也照样按中国站判定(fallbackSite),下次启动再试
+    }
 }
 /**
  * 配置文件内容 + 环境变量 → 生效配置。环境变量优先于文件;文件里的历代中国站
  * API 根换成当前中国站 apiBase(migrateStoredBaseUrl),下次 saveConfig 时落盘。
- * env / currentCnApiBase 可注入,供测试模拟 P1 换主域后的迁移。
+ * 都没有 baseUrl 时用 fallback 站(见 fallbackSite)。
+ * env / currentCnApiBase / fallback 可注入,供测试模拟 P1 换主域后的迁移和不同包的默认站。
  */
-export function configFromFile(file, env = process.env, currentCnApiBase = SITES.cn.apiBase) {
+export function configFromFile(file, env = process.env, currentCnApiBase = SITES.cn.apiBase, fallback = "cn") {
     const envJwk = (name) => {
         const raw = env[name];
         if (!raw)
@@ -366,7 +397,9 @@ export function configFromFile(file, env = process.env, currentCnApiBase = SITES
         deviceId: file.deviceId,
         devicePrivateJwk: envJwk("U1S1_DEVICE_PRIVATE_JWK") || file.devicePrivateJwk,
         devicePublicJwk: envJwk("U1S1_DEVICE_PUBLIC_JWK") || file.devicePublicJwk,
-        baseUrl: env["U1S1_BASE_URL"] || migrateStoredBaseUrl(file.baseUrl, currentCnApiBase) || currentCnApiBase,
+        baseUrl: env["U1S1_BASE_URL"]
+            || migrateStoredBaseUrl(file.baseUrl, currentCnApiBase)
+            || (fallback === "intl" ? SITES.intl.apiBase : currentCnApiBase),
         // 有效性不在这里裁决:端点列表可能还没拉回来,交给 resolvePreferredModel
         model: file.model,
         modelProvider: typeof file.modelProvider === "string" ? file.modelProvider : undefined,

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { printConsoleBanner } from "./brand.js";
-import { activeSite, loadConfig, readSettings, VERSION } from "./config.js";
+import { activeSite, loadConfig, pinLegacySiteBaseUrl, readSettings, VERSION } from "./config.js";
 import { siteLinks, siteOf } from "./site.js";
 import { isEnglish, tr } from "./i18n.js";
 import { isLauncherWord, launcherHelpLines, launcherHelpRows, runLauncher } from "./launcher.js";
@@ -229,6 +229,8 @@ function rejectMistypedCommand(cmd, argCount) {
     return true;
 }
 async function run() {
+    // 老中国站配置(有文件没 baseUrl)先钉成中国站,再做任何按站点的判断
+    pinLegacySiteBaseUrl();
     const args = process.argv.slice(2);
     const cmd = args[0];
     const rest = args.slice(1);

package/dist/update.d.ts

@@ -1,7 +1,21 @@
+import { PACKAGE_NAME } from "./config.js";
 export declare const VERSION: string;
-export declare const PACKAGE_NAME = "u1s1-cli";
+export { PACKAGE_NAME };
+/** 中国站的 npm 包名;u1s1-cli 自 1.15 起是国际站的包(见 config.ts PACKAGE_NAME)。 */
+export declare const CN_PACKAGE_NAME = "u1s1-cli-cn";
 /** Detect the package manager that installed u1s1. */
 export declare function detectPackageManager(): string;
+/** npm registry 上本包 latest 的元数据地址(两个包各查各的)。 */
+export declare function latestVersionUrl(packageName?: string): string;
+/** 全局升级本包的包管理器参数(execFileSync 用,不经 shell)。 */
+export declare function globalUpdateArgs(pm: string, packageName?: string): string[];
+/** 同上,拼成一行命令(退出后自动更新、给用户看的提示用)。 */
+export declare function globalUpdateCommand(pm: string, packageName?: string): string;
+/**
+ * 装的是默认国际站的 u1s1-cli、连的却是中国站(老用户):提示改装 u1s1-cli-cn,只提示不自动换包。
+ * 两个包都提供 u1s1 命令,要先卸再装,否则 npm 报 bin 冲突。返回要打印的行;不需要提示时为空。
+ */
+export declare function cnPackageHint(pm: string, siteId: string, packageName?: string, defaultSite?: string): string[];
 /** Fetch the latest published version from npm registry. */
 export declare function getLatestVersion(): Promise<string | undefined>;
 export declare function compareVersions(a: string, b: string): number;

package/dist/update.js

@@ -5,14 +5,16 @@ import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { activeSite, isPortableInstall } from "./config.js";
+import { activeSite, isPortableInstall, PACKAGE_DEFAULT_SITE, PACKAGE_NAME } from "./config.js";
 import { tr } from "./i18n.js";
 import { installCommand } from "./site.js";
 import { readJsonResponseCapped, readResponseTextCapped } from "./api.js";
 const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
 export const VERSION = pkg.version;
-export const PACKAGE_NAME = "u1s1-cli";
+export { PACKAGE_NAME };
+/** 中国站的 npm 包名;u1s1-cli 自 1.15 起是国际站的包(见 config.ts PACKAGE_NAME)。 */
+export const CN_PACKAGE_NAME = "u1s1-cli-cn";
 const MAX_NPM_METADATA_BYTES = 64 * 1024;
 const MAX_INSTALL_SCRIPT_BYTES = 1024 * 1024;
 function publishedVersion(value) {
@@ -39,9 +41,39 @@ export function detectPackageManager() {
         return "bun";
     return "npm";
 }
+/** npm registry 上本包 latest 的元数据地址(两个包各查各的)。 */
+export function latestVersionUrl(packageName = PACKAGE_NAME) {
+    return `https://registry.npmjs.org/${packageName}/latest`;
+}
+/** 全局升级本包的包管理器参数(execFileSync 用,不经 shell)。 */
+export function globalUpdateArgs(pm, packageName = PACKAGE_NAME) {
+    return pm === "npm"
+        ? ["install", "-g", "--loglevel=error", `${packageName}@latest`]
+        : ["add", "-g", `${packageName}@latest`];
+}
+/** 同上,拼成一行命令(退出后自动更新、给用户看的提示用)。 */
+export function globalUpdateCommand(pm, packageName = PACKAGE_NAME) {
+    return [pm, ...globalUpdateArgs(pm, packageName)].join(" ");
+}
+/**
+ * 装的是默认国际站的 u1s1-cli、连的却是中国站(老用户):提示改装 u1s1-cli-cn,只提示不自动换包。
+ * 两个包都提供 u1s1 命令,要先卸再装,否则 npm 报 bin 冲突。返回要打印的行;不需要提示时为空。
+ */
+export function cnPackageHint(pm, siteId, packageName = PACKAGE_NAME, defaultSite = PACKAGE_DEFAULT_SITE) {
+    if (siteId !== "cn" || defaultSite !== "intl" || packageName === CN_PACKAGE_NAME)
+        return [];
+    const remove = pm === "npm" ? `npm uninstall -g ${packageName}` : `${pm} remove -g ${packageName}`;
+    const add = pm === "npm" ? `npm install -g ${CN_PACKAGE_NAME}` : `${pm} add -g ${CN_PACKAGE_NAME}`;
+    return [
+        tr(`提示:你连的是中国站。npm 包 ${packageName} 现在默认国际站,中国站专用包是 ${CN_PACKAGE_NAME},建议改装(登录状态和设置都保留):`, `Note: you're on the China site. The npm package ${packageName} now defaults to the international site; the China site package is ${CN_PACKAGE_NAME}. We suggest switching (your sign-in and settings are kept):`),
+        `  ${remove}`,
+        `  ${add}`,
+        tr("  不改装也能照常用,当前仍连中国站。", "  You can keep using this package; it still connects to the China site."),
+    ];
+}
 /** Fetch the latest published version from npm registry. */
 export async function getLatestVersion() {
-    const url = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+    const url = latestVersionUrl();
     try {
         const res = await fetch(url, {
             headers: { Accept: "application/json" },
@@ -211,6 +243,11 @@ async function portableSelfUpdate(latest) {
     }
 }
 export async function update() {
+    if (!isPortableInstall()) {
+        const hint = cnPackageHint(detectPackageManager(), activeSite().id);
+        if (hint.length)
+            console.log(hint.join("\n") + "\n");
+    }
     console.log(tr("正在检查更新…", "Checking for updates…"));
     const latest = await getLatestVersion();
     if (!latest) {
@@ -246,10 +283,7 @@ export async function update() {
     console.log(tr(`正在用 ${pm} 更新 ${PACKAGE_NAME}…`, `Updating ${PACKAGE_NAME} with ${pm}…`));
     try {
         // npm 压掉 EBADENGINE 等警告墙,对新手只有噪音;出错时 error 仍会显示
-        const args = pm === "npm"
-            ? ["install", "-g", "--loglevel=error", `${PACKAGE_NAME}@latest`]
-            : ["add", "-g", `${PACKAGE_NAME}@latest`];
-        execFileSync(pm, args, { stdio: "inherit" });
+        execFileSync(pm, globalUpdateArgs(pm), { stdio: "inherit" });
         console.log(tr(`\n✅ 已更新到 v${latest}，重启 u1s1 后生效。`, `\n✅ Updated to v${latest}. Restart u1s1 to use it.`));
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "1.15.0",
+  "version": "1.15.2",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {
@@ -25,7 +25,6 @@
     "build": "tsc",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build && npm test",
     "test": "U1S1_LANG=zh tsx --test test/*.test.ts && U1S1_LANG=zh node scripts/render-regression.mjs",
     "postinstall": "node scripts/patch-pi.js",
     "package": "bash ../../scripts/package.sh",
@@ -56,5 +55,8 @@
     "@types/node": "^22.20.1",
     "tsx": "^4.23.12",
     "typescript": "^5.9.3"
+  },
+  "u1s1": {
+    "defaultSite": "cn"
   }
 }