@xcanwin/manyoyo 8.7.0 → 8.7.2

package/lib/model-services.js

@@ -0,0 +1,363 @@
+'use strict';
+
+const JSON5 = require('json5');
+const { isDeepStrictEqual } = require('util');
+
+// 「模型服务」：一套模型服务 = 一个 runs.<名>（Key 写在它的 env 里），不新增配置结构。
+// 这里只放纯逻辑：认出已有的服务、给出“这个 Key 也能给另一个 Agent 用”的建议、构造要写入的配置改动；
+// 读写文件与接口在 lib/web/model-services.js，写盘走 lib/setup-config + lib/secure-file。
+const { AGENT_ENV_SCHEMA } = require('./init-config');
+const { parseEnvEntry } = require('./runtime-normalizers');
+const { providersForAgent, findProviderByBaseUrl } = require('./provider-presets');
+const { identifyRunAgent, buildAgentRunProfile } = require('./setup');
+const { upsertValueByPath, removeValueByPath } = require('./json5-text-edit');
+
+// 界面上说清楚是命令行工具（不是网页版 / 桌面版）
+const AGENT_DISPLAY_LABELS = { claude: 'Claude Code CLI', codex: 'Codex CLI' };
+function agentLabelOf(agent) {
+    return AGENT_DISPLAY_LABELS[agent] || AGENT_ENV_SCHEMA[agent].label;
+}
+
+const RUN_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,39}$/;
+// 订阅登录用的长期令牌；保存它时要删掉同一个运行配置里会盖过订阅的 API Key 类变量（Claude Code 同时有 Key 时优先用 Key）
+const CLAUDE_OAUTH_KEY = 'CLAUDE_CODE_OAUTH_TOKEN';
+const CLAUDE_API_KEYS = ['ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_API_KEY'];
+
+// Claude Code 服务额外可编辑的模型变量（档位别名、子 Agent）与压缩窗口
+// 顺序即强弱：Fable（顶级）> Opus（高级）> Sonnet（标准）> Haiku（轻量）
+const CLAUDE_MODEL_KEYS = ['ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_OPUS_MODEL', 'ANTHROPIC_DEFAULT_SONNET_MODEL', 'ANTHROPIC_DEFAULT_HAIKU_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL'];
+// 自动压缩窗口：纯数字（以后模型的上下文可能更大，不写死上限）
+const AUTO_COMPACT_PATTERN = /^[1-9][0-9]{4,9}$/;
+const AUTO_COMPACT_KEY = 'CLAUDE_CODE_AUTO_COMPACT_WINDOW';
+
+function isPlainObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function envText(env, key) {
+    const value = isPlainObject(env) ? env[key] : undefined;
+    return typeof value === 'string' || typeof value === 'number' ? String(value).trim() : '';
+}
+
+function keyTail(secret) {
+    const text = String(secret || '');
+    // 太短的 Key 末 4 位已经泄露了一大半，只显示省略号
+    return text.length >= 12 ? `…${text.slice(-4)}` : (text ? '…' : '');
+}
+
+// 这个运行配置里实际生效的凭据变量：按 schema 的优先顺序取第一个非空的
+function findKey(spec, env) {
+    for (const name of spec.requiredAnyOf) {
+        const value = envText(env, name);
+        if (value) return { name, value };
+    }
+    return null;
+}
+
+/** 列出已有的模型服务；响应里只有 Key 的末 4 位，绝不带出 Key 本身 */
+function listModelServices(config) {
+    const runs = isPlainObject(config && config.runs) ? config.runs : {};
+    const services = [];
+    for (const [name, run] of Object.entries(runs)) {
+        const agent = identifyRunAgent(name, run);
+        if (!agent) continue;
+        const spec = AGENT_ENV_SCHEMA[agent];
+        const env = isPlainObject(run) ? run.env : null;
+        const key = findKey(spec, env);
+        if (!key) continue;
+        const baseUrl = envText(env, spec.baseUrlKey);
+        const provider = findProviderByBaseUrl(agent, baseUrl);
+        const subscription = key.name === CLAUDE_OAUTH_KEY;
+        // 这家服务必需的附加变量里，运行配置里还没有（或值不对）的：界面据此提示“一键修复”
+        const missingExtraEnv = {};
+        if (provider && !subscription) {
+            for (const [extraKey, extraValue] of Object.entries(provider.extraEnv || {})) {
+                if (envText(env, extraKey) !== extraValue) missingExtraEnv[extraKey] = extraValue;
+            }
+        }
+        const claudeExtra = agent === 'claude'
+            ? {
+                models: Object.fromEntries(CLAUDE_MODEL_KEYS.map(key => [key, envText(env, key)])),
+                autoCompactWindow: envText(env, AUTO_COMPACT_KEY)
+            }
+            : {};
+        services.push({
+            name,
+            agent,
+            agentLabel: agentLabelOf(agent),
+            providerId: provider ? provider.id : '',
+            providerLabel: subscription ? '订阅登录' : (provider ? provider.label : (baseUrl ? '自定义地址' : '官方')),
+            authMode: subscription ? 'subscription' : 'key',
+            baseUrl,
+            keyEnv: key.name,
+            keyTail: keyTail(key.value),
+            model: envText(env, spec.modelKey),
+            missingExtraEnv,
+            ...claudeExtra
+        });
+    }
+    return services;
+}
+
+function keyValueOf(config, name) {
+    const run = config.runs && config.runs[name];
+    const agent = identifyRunAgent(name, run);
+    const found = agent ? findKey(AGENT_ENV_SCHEMA[agent], run.env) : null;
+    return found ? found.value : '';
+}
+
+/** “这个 Key 也能给另一个 Agent 用”：同一服务商在另一个 Agent 上有预设、且还没有用同一个 Key 的服务 */
+function suggestReuse(config) {
+    const services = listModelServices(config);
+    const seen = new Set(services.map(item => `${item.agent}|${item.providerId}|${keyValueOf(config, item.name)}`));
+    const suggestions = [];
+    for (const item of services) {
+        if (!item.providerId || item.authMode !== 'key') continue;
+        const secret = keyValueOf(config, item.name);
+        for (const target of ['claude', 'codex']) {
+            if (target === item.agent) continue;
+            if (!providersForAgent(target).some(p => p.id === item.providerId)) continue;
+            const id = `${target}|${item.providerId}|${secret}`;
+            if (seen.has(id)) continue;
+            seen.add(id);
+            suggestions.push({
+                from: item.name,
+                agent: target,
+                providerId: item.providerId,
+                label: `${item.providerLabel} 的 Key 也能给 ${agentLabelOf(target)} 用`
+            });
+        }
+    }
+    return suggestions;
+}
+
+function uniqueRunName(runs, base) {
+    const taken = isPlainObject(runs) ? runs : {};
+    const root = String(base).replace(/[^A-Za-z0-9_.-]/g, '-').replace(/^[^A-Za-z0-9]+/, '').slice(0, 36) || 'model';
+    if (!taken[root]) return root;
+    for (let i = 2; i < 1000; i += 1) {
+        if (!taken[`${root}-${i}`]) return `${root}-${i}`;
+    }
+    throw new Error('无法生成不重名的名字');
+}
+
+function assertRunName(name) {
+    if (!RUN_NAME_PATTERN.test(String(name || ''))) {
+        throw new Error('名字只能包含字母、数字、下划线、点和横线，且以字母或数字开头，最长 40 个字符');
+    }
+}
+
+function presetFor(agent, providerId) {
+    const preset = providersForAgent(agent).find(item => item.id === providerId);
+    if (!preset) throw new Error(`${agentLabelOf(agent)} 没有这个服务商的预设`);
+    return preset;
+}
+
+/**
+ * 新增一套服务，返回要写入的 { name, profile }；绝不覆盖已有的运行配置。
+ * input：{ agent, providerId | baseUrl, key, model?, name?, subscription? }
+ */
+function buildNewService(config, input, options = {}) {
+    const agent = String(input.agent || '').trim();
+    const spec = AGENT_ENV_SCHEMA[agent];
+    if (!spec) throw new Error(`不支持的 Agent: ${agent}`);
+    const runs = isPlainObject(config && config.runs) ? config.runs : {};
+    const secret = String(input.key || '').trim();
+    if (!secret) throw new Error(input.subscription ? '请粘贴订阅令牌' : '请填写 API Key');
+
+    const env = {};
+    let baseName = agent;
+    if (input.subscription) {
+        if (agent !== 'claude') throw new Error('订阅登录令牌目前只支持 Claude Code');
+        env[CLAUDE_OAUTH_KEY] = secret;
+        baseName = `${agent}-subscription`;
+    } else if (input.providerId) {
+        const preset = presetFor(agent, String(input.providerId));
+        env[preset.keyEnv] = secret;
+        env[spec.baseUrlKey] = preset.baseUrl;
+        const model = String(input.model || '').trim() || preset.defaultModel;
+        if (model) env[spec.modelKey] = model;
+        Object.assign(env, preset.extraEnv);
+        baseName = `${agent}-${preset.id}`;
+    } else {
+        const baseUrl = String(input.baseUrl || '').trim();
+        if (baseUrl && !/^https?:\/\//i.test(baseUrl)) throw new Error('Base URL 必须以 http:// 或 https:// 开头');
+        env[spec.requiredAnyOf.find(name => !name.includes('OAUTH')) || spec.requiredAnyOf[0]] = secret;
+        if (baseUrl) env[spec.baseUrlKey] = baseUrl;
+        const model = String(input.model || '').trim();
+        if (model) env[spec.modelKey] = model;
+        baseName = `${agent}-custom`;
+    }
+    if (agent === 'claude') {
+        const models = isPlainObject(input.models) ? input.models : {};
+        for (const [key, raw] of Object.entries(models)) {
+            if (!CLAUDE_MODEL_KEYS.includes(key)) throw new Error(`不支持的模型变量: ${key}`);
+            const value = String(raw === null || raw === undefined ? '' : raw).trim();
+            if (value) {
+                parseEnvEntry(`${key}=${value}`);
+                env[key] = value;
+            }
+        }
+        const window = String(input.autoCompactWindow === undefined || input.autoCompactWindow === null ? '' : input.autoCompactWindow).trim();
+        if (window) {
+            if (!AUTO_COMPACT_PATTERN.test(window)) throw new Error('自动压缩的上下文大小要填纯数字，例如 1000000');
+            env[AUTO_COMPACT_KEY] = window;
+        }
+    }
+    if (agent === 'codex' && env[spec.baseUrlKey] && !env[spec.modelKey]) {
+        throw new Error('Codex CLI 接兼容服务必须填写模型名');
+    }
+    const name = input.name ? String(input.name).trim() : uniqueRunName(runs, baseName);
+    assertRunName(name);
+    if (runs[name]) throw new Error(`已有名为 ${name} 的运行配置，请换一个名字`);
+    const profile = buildAgentRunProfile(agent, env);
+    profile.containerName = `my-${name}-{now}`;
+    return { name, profile };
+}
+
+/** 把已有服务的 Key 复用给另一个 Agent（同一服务商）。返回 { name, profile } */
+function buildReuseService(config, fromName, targetAgent, options = {}) {
+    const services = listModelServices(config);
+    const source = services.find(item => item.name === fromName);
+    if (!source) throw new Error(`找不到模型服务: ${fromName}`);
+    if (!source.providerId || source.authMode !== 'key') throw new Error('这个服务不能直接复用给别的 Agent');
+    const built = buildNewService(config, {
+        agent: targetAgent,
+        providerId: source.providerId,
+        key: keyValueOf(config, fromName)
+    }, options);
+    const sourceRun = config.runs[fromName];
+    // 原来那套指定过自己的目录就照抄；是默认工作目录根（老版本写进去的）就不抄
+    const sourceHost = typeof sourceRun.hostPath === 'string' ? sourceRun.hostPath.replace(/\/+$/, '') : '';
+    const defaultRoot = String(options.defaultHostPath || '').replace(/\/+$/, '');
+    if (sourceHost && sourceHost !== defaultRoot && !built.profile.hostPath) {
+        built.profile.hostPath = sourceRun.hostPath;
+    }
+    return built;
+}
+
+/**
+ * 编辑已有服务：key 留空表示不改。返回配置改动列表 ops（set / remove，路径从根开始）。
+ * 订阅令牌：换成订阅令牌时删掉同一个运行配置里的 API Key 类变量和 Base URL。
+ */
+function buildServiceEdit(config, name, patch) {
+    const runs = isPlainObject(config && config.runs) ? config.runs : {};
+    const run = runs[name];
+    const agent = identifyRunAgent(name, run);
+    if (!agent) throw new Error(`找不到模型服务: ${name}`);
+    const spec = AGENT_ENV_SCHEMA[agent];
+    const current = findKey(spec, run.env);
+    const ops = [];
+    const setEnv = (key, value) => {
+        parseEnvEntry(`${key}=${value}`);
+        ops.push({ type: 'set', path: ['runs', name, 'env', key], value: String(value) });
+    };
+    if (patch.applyPresetExtras) {
+        const service = listModelServices(config).find(item => item.name === name);
+        for (const [key, value] of Object.entries(service ? service.missingExtraEnv : {})) setEnv(key, value);
+    }
+    const secret = String(patch.key || '').trim();
+    if (secret) {
+        if (patch.subscription) {
+            if (agent !== 'claude') throw new Error('订阅登录令牌目前只支持 Claude Code');
+            setEnv(CLAUDE_OAUTH_KEY, secret);
+            [...CLAUDE_API_KEYS, spec.baseUrlKey].forEach(key => {
+                if (isPlainObject(run.env) && key in run.env) ops.push({ type: 'remove', path: ['runs', name, 'env', key] });
+            });
+        } else {
+            setEnv(current && current.name !== CLAUDE_OAUTH_KEY ? current.name : spec.requiredAnyOf.find(n => !n.includes('OAUTH')), secret);
+        }
+    }
+    if (patch.baseUrl !== undefined) {
+        const baseUrl = String(patch.baseUrl).trim();
+        if (baseUrl && !/^https?:\/\//i.test(baseUrl)) throw new Error('Base URL 必须以 http:// 或 https:// 开头');
+        if (baseUrl) setEnv(spec.baseUrlKey, baseUrl);
+        else if (isPlainObject(run.env) && spec.baseUrlKey in run.env) ops.push({ type: 'remove', path: ['runs', name, 'env', spec.baseUrlKey] });
+    }
+    if (patch.model !== undefined) {
+        const model = String(patch.model).trim();
+        if (model) setEnv(spec.modelKey, model);
+        else if (isPlainObject(run.env) && spec.modelKey in run.env) ops.push({ type: 'remove', path: ['runs', name, 'env', spec.modelKey] });
+    }
+    if (patch.models !== undefined || patch.autoCompactWindow !== undefined) {
+        if (agent !== 'claude') throw new Error('档位模型和自动压缩只支持 Claude Code');
+        const hasKey = key => isPlainObject(run.env) && key in run.env;
+        const models = isPlainObject(patch.models) ? patch.models : {};
+        for (const [key, raw] of Object.entries(models)) {
+            if (!CLAUDE_MODEL_KEYS.includes(key)) throw new Error(`不支持的模型变量: ${key}`);
+            const value = String(raw === null || raw === undefined ? '' : raw).trim();
+            if (value) setEnv(key, value);
+            else if (hasKey(key)) ops.push({ type: 'remove', path: ['runs', name, 'env', key] });
+        }
+        if (patch.autoCompactWindow !== undefined) {
+            const window = String(patch.autoCompactWindow === null ? '' : patch.autoCompactWindow).trim();
+            if (window) {
+                if (!AUTO_COMPACT_PATTERN.test(window)) throw new Error('自动压缩的上下文大小要填纯数字，例如 1000000');
+                setEnv(AUTO_COMPACT_KEY, window);
+            } else if (hasKey(AUTO_COMPACT_KEY)) {
+                ops.push({ type: 'remove', path: ['runs', name, 'env', AUTO_COMPACT_KEY] });
+            }
+        }
+    }
+    // Codex 有地址就必须有模型（不会从环境变量读默认模型，缺了请求直接报错）
+    if (agent === 'codex' && ops.some(op => [spec.baseUrlKey, spec.modelKey].includes(op.path[op.path.length - 1]))) {
+        const after = { ...(isPlainObject(run.env) ? run.env : {}) };
+        for (const op of ops) {
+            const key = op.path[op.path.length - 1];
+            if (op.type === 'set') after[key] = op.value;
+            else delete after[key];
+        }
+        if (envText(after, spec.baseUrlKey) && !envText(after, spec.modelKey)) throw new Error('Codex CLI 接兼容服务必须填写模型名');
+    }
+    return { agent, ops };
+}
+
+// 把改动列表落到配置原文上（局部替换，保留注释和其它字段）
+function applyConfigOps(baseRaw, ops) {
+    let raw = baseRaw;
+    for (const op of ops) {
+        raw = op.type === 'remove'
+            ? removeValueByPath(raw, op.path)
+            : upsertValueByPath(raw, op.path, JSON.stringify(op.value, null, 4));
+    }
+    return raw;
+}
+
+function valueAtPath(root, pathParts) {
+    let node = root;
+    for (const key of pathParts) {
+        if (node === null || typeof node !== 'object' || !Object.prototype.hasOwnProperty.call(node, key)) return undefined;
+        node = node[key];
+    }
+    return node;
+}
+
+/**
+ * 写盘前核对：把改动落到原文后重新解析，每条 set 必须读回同样的值、每条 remove 必须读不到。
+ * 局部文本替换遇到带转义的键名等边角情况可能“静默没改到”或在前面多插一个同名键，不核对就会回报成功却没生效。
+ */
+function assertOpsApplied(nextRaw, ops) {
+    const parsed = JSON5.parse(nextRaw);
+    for (const op of ops) {
+        const actual = valueAtPath(parsed, op.path);
+        if (op.type === 'remove' ? actual !== undefined : !isDeepStrictEqual(actual, JSON.parse(JSON.stringify(op.value)))) {
+            throw new Error(`配置里 ${op.path.join('.')} 没能${op.type === 'remove' ? '删除' : '写入'}，请在「显示 JSON 设置」里手动修改`);
+        }
+    }
+}
+
+module.exports = {
+    agentLabelOf,
+    assertOpsApplied,
+    RUN_NAME_PATTERN,
+    listModelServices,
+    suggestReuse,
+    buildNewService,
+    buildReuseService,
+    buildServiceEdit,
+    applyConfigOps,
+    assertRunName,
+    keyValueOf,
+    uniqueRunName,
+    keyTail
+};

package/lib/provider-presets.js

@@ -4,71 +4,87 @@
 // 只收录实测可用（Base URL 不带 Key 请求得到 401）且官方文档给了接入方式的服务商。
 // claude：Anthropic 兼容接口；codex：Responses 接口（只收官方文档确认支持 Responses 的）。
 // models 只作“模型”输入框的占位提示，不会自动写入配置；defaultModel 是官方文档要求必须填的，用户可改。
-// Codex 不认环境变量 OPENAI_BASE_URL（0.160 / 0.164 实测），向导写的仍是环境变量，
-// 由 lib/agent-adapters 的 withCodexBaseUrl 在容器里展开成 `-c openai_base_url=…` 才生效。
+// Codex 0.164 实测：exec 不认 OPENAI_BASE_URL / OPENAI_API_KEY / OPENAI_MODEL，向导写的仍是环境变量，
+// 由 lib/agent-adapters 的 withCodexBaseUrl 在容器里展开成自定义 model_provider + --model 才生效，所以 Codex 条目必须有 defaultModel。
+// extraEnv：这家服务必须附带的变量（写进同一个运行配置）。Claude Code 2.1.310 的“工具搜索”会把工具收进 ToolSearch，
+// 智谱的兼容接口用不了（实测模型看不到 Bash），要 ENABLE_TOOL_SEARCH=false；DeepSeek 实测不需要。其余没有 Key 实测的先带上（代价只是多耗一点 token）。
 // 智谱的接口把鉴权失败写在 200 响应体里（`{"code":401,...}`），其余三家直接返回 HTTP 401。
 const PROVIDER_PRESETS = [
+    {
+        id: 'anthropic',
+        label: 'Anthropic（官方）',
+        docUrl: 'https://docs.claude.com/en/api/overview',
+        claude: { baseUrl: 'https://api.anthropic.com', keyEnv: 'ANTHROPIC_API_KEY' }
+    },
+    {
+        id: 'openai',
+        label: 'OpenAI（官方）',
+        docUrl: 'https://platform.openai.com/docs/api-reference/responses',
+        // 官方 Key 的用法没有实测过（没有 Key）：模型名要自己填
+        codex: { baseUrl: 'https://api.openai.com/v1', keyEnv: 'OPENAI_API_KEY', models: ['gpt-5-codex'] }
+    },
     {
         id: 'deepseek',
         label: 'DeepSeek',
         docUrl: 'https://api-docs.deepseek.com/guides/coding_agents',
-        claude: { baseUrl: 'https://api.deepseek.com/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', models: ['deepseek-flash[1m]'], defaultModel: 'deepseek-flash[1m]' }
+        claude: { baseUrl: 'https://api.deepseek.com/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', models: ['deepseek-flash[1m]'], defaultModel: 'deepseek-flash[1m]' },
+        codex: { baseUrl: 'https://api.deepseek.com', keyEnv: 'OPENAI_API_KEY', models: ['deepseek-flash'], defaultModel: 'deepseek-flash' }
     },
     {
         id: 'zhipu',
         label: '智谱 GLM',
         docUrl: 'https://docs.bigmodel.cn/cn/coding-plan/tool/claude',
-        claude: { baseUrl: 'https://open.bigmodel.cn/api/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN' },
-        codex: { baseUrl: 'https://open.bigmodel.cn/api/v1', keyEnv: 'OPENAI_API_KEY', docUrl: 'https://docs.bigmodel.cn/cn/coding-plan/tool/codex' }
+        claude: { baseUrl: 'https://open.bigmodel.cn/api/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', extraEnv: { ENABLE_TOOL_SEARCH: 'false' } },
+        codex: { baseUrl: 'https://open.bigmodel.cn/api/v1', keyEnv: 'OPENAI_API_KEY', models: ['glm-5.3'], defaultModel: 'glm-5.3', docUrl: 'https://docs.bigmodel.cn/cn/coding-plan/tool/codex' }
     },
     {
         id: 'zai',
         label: 'Z.ai（智谱国际）',
         docUrl: 'https://docs.z.ai/devpack/tool/claude',
-        claude: { baseUrl: 'https://api.z.ai/api/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN' }
+        claude: { baseUrl: 'https://api.z.ai/api/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', extraEnv: { ENABLE_TOOL_SEARCH: 'false' } }
     },
     {
         id: 'kimi',
         label: 'Kimi',
         docUrl: 'https://platform.kimi.com/docs/guide/claude-code-kimi.md',
-        claude: { baseUrl: 'https://api.moonshot.cn/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN' },
+        claude: { baseUrl: 'https://api.moonshot.cn/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', extraEnv: { ENABLE_TOOL_SEARCH: 'false' } },
         codex: { baseUrl: 'https://api.moonshot.cn/v1', keyEnv: 'OPENAI_API_KEY', docUrl: 'https://platform.kimi.com/docs/guide/codex-kimi.md' }
     },
     {
         id: 'kimi-code',
         label: 'Kimi Code（订阅，海外）',
         docUrl: 'https://www.kimi.com/code/docs/en/third-party-tools/claude-code.html',
-        claude: { baseUrl: 'https://api.kimi.ai/coding/', keyEnv: 'ANTHROPIC_API_KEY' }
+        claude: { baseUrl: 'https://api.kimi.ai/coding/', keyEnv: 'ANTHROPIC_API_KEY', extraEnv: { ENABLE_TOOL_SEARCH: 'false' } }
     },
     {
         id: 'aliyun',
         label: '阿里云百炼',
         docUrl: 'https://help.aliyun.com/zh/model-studio/claude-code',
-        claude: { baseUrl: 'https://coding.dashscope.aliyuncs.com/apps/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN' }
+        claude: { baseUrl: 'https://coding.dashscope.aliyuncs.com/apps/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', extraEnv: { ENABLE_TOOL_SEARCH: 'false' } }
     },
     {
         id: 'tencent',
         label: '腾讯云',
         docUrl: 'https://cloud.tencent.com/document/product/1823/130097',
-        claude: { baseUrl: 'https://api.lkeap.cloud.tencent.com/coding/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', models: ['glm-5'] }
+        claude: { baseUrl: 'https://api.lkeap.cloud.tencent.com/coding/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', models: ['glm-5'], extraEnv: { ENABLE_TOOL_SEARCH: 'false' } }
     },
     {
         id: 'volcengine',
         label: '火山方舟',
         docUrl: 'https://www.volcengine.com/docs/82379/1928262',
-        claude: { baseUrl: 'https://ark.cn-beijing.volces.com/api/coding', keyEnv: 'ANTHROPIC_AUTH_TOKEN' },
+        claude: { baseUrl: 'https://ark.cn-beijing.volces.com/api/coding', keyEnv: 'ANTHROPIC_AUTH_TOKEN', extraEnv: { ENABLE_TOOL_SEARCH: 'false' } },
         codex: { baseUrl: 'https://ark.cn-beijing.volces.com/api/coding/v3', keyEnv: 'OPENAI_API_KEY' }
     },
     {
         id: 'minimax',
         label: 'MiniMax',
         docUrl: 'https://platform.minimax.cn/docs/token-plan/claude-code',
-        claude: { baseUrl: 'https://api.minimax.cn/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN' },
+        claude: { baseUrl: 'https://api.minimax.cn/anthropic', keyEnv: 'ANTHROPIC_AUTH_TOKEN', extraEnv: { ENABLE_TOOL_SEARCH: 'false' } },
         codex: { baseUrl: 'https://api.minimax.cn/v1', keyEnv: 'OPENAI_API_KEY', docUrl: 'https://platform.minimax.cn/docs/token-plan/codex' }
     }
 ];
 
-/** 某个 Agent 可用的预设（扁平：{id, label, docUrl, baseUrl, keyEnv, models, defaultModel}） */
+/** 某个 Agent 可用的预设（扁平：{id, label, docUrl, baseUrl, keyEnv, models, defaultModel, extraEnv}） */
 function providersForAgent(agentId) {
     return PROVIDER_PRESETS
         .filter(item => item[agentId])
@@ -79,8 +95,35 @@ function providersForAgent(agentId) {
             baseUrl: item[agentId].baseUrl,
             keyEnv: item[agentId].keyEnv,
             models: [...(item[agentId].models || [])],
-            defaultModel: item[agentId].defaultModel || ''
+            defaultModel: item[agentId].defaultModel || '',
+            extraEnv: { ...(item[agentId].extraEnv || {}) }
         }));
 }
 
-module.exports = { PROVIDER_PRESETS, providersForAgent };
+function normalizeUrl(value) {
+    return String(value || '').trim().replace(/\/+$/, '').toLowerCase();
+}
+
+/** 按 Base URL 找某个 Agent 的预设，对不上返回 null */
+function findProviderByBaseUrl(agentId, baseUrl) {
+    const url = normalizeUrl(baseUrl);
+    if (!url) return null;
+    return providersForAgent(agentId).find(item => normalizeUrl(item.baseUrl) === url) || null;
+}
+
+/**
+ * Codex 接了第三方（env 里有 OPENAI_BASE_URL）时的模型下拉：只列这家的预设模型和当前模型。
+ * `codex app-server` 的目录永远是 OpenAI 的模型名，选了第三方会直接报错。不是第三方返回 null。
+ */
+function thirdPartyCodexModels(env) {
+    const source = env && typeof env === 'object' ? env : {};
+    const baseUrl = typeof source.OPENAI_BASE_URL === 'string' ? source.OPENAI_BASE_URL.trim() : '';
+    if (!baseUrl) return null;
+    const provider = findProviderByBaseUrl('codex', baseUrl);
+    const names = [...(provider ? provider.models : [])];
+    const current = typeof source.OPENAI_MODEL === 'string' ? source.OPENAI_MODEL.trim() : '';
+    if (current && !names.includes(current)) names.push(current);
+    return names.map(value => ({ value, label: value, description: provider ? provider.label : '' }));
+}
+
+module.exports = { PROVIDER_PRESETS, providersForAgent, findProviderByBaseUrl, thirdPartyCodexModels };

package/lib/setup-cli.js

@@ -10,6 +10,7 @@ const readline = require('readline');
 const { Writable } = require('stream');
 const JSON5 = require('json5');
 const { listSetupAgents, buildAgentRunProfile, validateSetupPassword, listMirrorPresets } = require('./setup');
+const { uniqueRunName } = require('./model-services');
 const { baseRawOf, buildAgentConfigRaw, buildPasswordConfigRaw, shouldWriteMirrors, buildMirrorsConfigRaw } = require('./setup-config');
 const { normalizeMirrors } = require('./runtime-normalizers');
 const { writeConfigFileSecure } = require('./secure-file');
@@ -155,6 +156,8 @@ async function runSetupCli(deps) {
             keyName = agent.requiredAnyOf[keyIndex];
         }
         let defaultModel = '';
+        // 名字里的服务商标记：选了预设用预设 id，官方 Key 是 official，自定义地址是 custom
+        let nameTag = modeIndex === 1 ? 'custom' : 'official';
         if (modeIndex === 1) {
             const providers = agent.providers || [];
             const baseUrlItems = [
@@ -168,6 +171,8 @@ async function runSetupCli(deps) {
                 env[agent.baseUrlKey] = provider.baseUrl;
                 keyName = provider.keyEnv;
                 defaultModel = provider.defaultModel;
+                nameTag = provider.id;
+                Object.assign(env, provider.extraEnv || {});
                 log(`官方说明：${provider.docUrl}`);
             } else if (baseIndex < providers.length + agent.baseUrlPresets.length) {
                 env[agent.baseUrlKey] = agent.baseUrlPresets[baseIndex - providers.length].value;
@@ -188,7 +193,11 @@ async function runSetupCli(deps) {
         env[keyName] = key;
         const model = String(await prompter.ask(defaultModel
             ? `模型（${agent.modelKey}，回车使用 ${defaultModel}）: `
-            : `模型（${agent.modelKey}，可选，回车跳过）: `)).trim() || defaultModel;
+            : `模型（${agent.modelKey}，${agent.id === 'codex' && modeIndex === 1 ? '必填' : '可选，回车跳过'}）: `)).trim() || defaultModel;
+        if (!model && agent.id === 'codex' && modeIndex === 1) {
+            log('Codex 接兼容服务必须指定模型，已退出，没有改动任何配置。');
+            return 1;
+        }
         if (model) env[agent.modelKey] = model;
 
         log('\n第 3 / 4 步 · 工作目录');
@@ -215,14 +224,18 @@ async function runSetupCli(deps) {
         const exists = fs.existsSync(configPath);
         const snapshot = { exists, raw: exists ? fs.readFileSync(configPath, 'utf-8') : '' };
         const parsed = exists && snapshot.raw.trim() ? JSON5.parse(snapshot.raw) : {};
-        const existingRun = parsed.runs && typeof parsed.runs === 'object' ? parsed.runs[agent.id] : undefined;
-        const profile = buildAgentRunProfile(agent.id, env, { existingRun, hostPath });
-        let nextRaw = buildAgentConfigRaw(baseRawOf(snapshot), agent.id, profile);
+        // 已有同名运行配置时新增一套（名字带服务商），绝不覆盖；第一次配置仍叫 Agent 的名字
+        const runs = parsed.runs && typeof parsed.runs === 'object' ? parsed.runs : {};
+        const runName = runs[agent.id] ? uniqueRunName(runs, `${agent.id}-${nameTag}`) : agent.id;
+        // 默认工作目录根不写进运行配置：新建容器各自建 <根>/<时间> 子目录
+        const profile = buildAgentRunProfile(agent.id, env, { hostPath: hostPath === path.resolve(defaultWork) ? '' : hostPath });
+        if (runName !== agent.id) profile.containerName = `my-${runName}-{now}`;
+        let nextRaw = buildAgentConfigRaw(baseRawOf(snapshot), runName, profile);
         nextRaw = buildPasswordConfigRaw(nextRaw, password);
         if (shouldWriteMirrors(parsed, mirrors)) nextRaw = buildMirrorsConfigRaw(nextRaw, normalizeMirrors(mirrors));
         JSON5.parse(nextRaw);
         writeConfigFileSecure(configPath, nextRaw);
-        log(`已保存到 ${configPath}（权限 0600）：Agent ${agent.id}、工作目录 ${hostPath}、登录密码${Object.keys(mirrors).length > 0 ? '、软件源' : ''}。`);
+        log(`已保存到 ${configPath}（权限 0600）：运行配置 ${runName}（${agent.id}）、工作目录 ${hostPath}、登录密码${Object.keys(mirrors).length > 0 ? '、软件源' : ''}。`);
     } catch (error) {
         if (error instanceof InputClosedError) {
             log('输入已结束，没有改动任何配置。');

package/lib/setup-config.js

@@ -38,4 +38,9 @@ function buildBooleanConfigRaw(baseRaw, key, value) {
     return upsertValueByPath(baseRaw, [key], value ? 'true' : 'false');
 }
 
-module.exports = { buildBooleanConfigRaw, EMPTY_CONFIG_RAW, baseRawOf, buildAgentConfigRaw, buildPasswordConfigRaw, shouldWriteMirrors, buildMirrorsConfigRaw, buildAgentInstructionsConfigRaw };
+// 向导“跳过”要落盘，否则刷新后又弹
+function buildSetupSkippedConfigRaw(baseRaw) {
+    return upsertValueByPath(baseRaw, ['serve', 'setupSkipped'], 'true');
+}
+
+module.exports = { buildSetupSkippedConfigRaw, buildBooleanConfigRaw, EMPTY_CONFIG_RAW, baseRawOf, buildAgentConfigRaw, buildPasswordConfigRaw, shouldWriteMirrors, buildMirrorsConfigRaw, buildAgentInstructionsConfigRaw };