u1s1-cli 1.15.0 → 1.15.1

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "1.15.0",
+  "version": "1.15.1",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {