agentsw 0.7.0 → 0.7.2

package/dist/fsutil.js

@@ -1,6 +1,8 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
 // AGENTSW_HOME is an explicit portable/test override. Native Windows otherwise
 // uses USERPROFILE/os.homedir(), while Unix follows HOME as expected.
 export const home = process.env.AGENTSW_HOME?.trim() ||
@@ -24,14 +26,62 @@ export function expandHome(p) {
     return p.startsWith("~") ? path.join(home, p.slice(1)) : p;
 }
 export function ensureDir(dir) {
-    fs.mkdirSync(dir, { recursive: true });
+    if (isDryRun() || stagedFiles.getStore())
+        return;
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+/** Read exactly one regular file. A broken path or unreadable file is not an empty config. */
+export function readFileSnapshot(file) {
+    try {
+        const stat = fs.lstatSync(file, { bigint: true });
+        if (!stat.isFile())
+            throw new Error(`${file}: not a regular configuration file`);
+        return { text: fs.readFileSync(file, "utf8"), mode: Number(stat.mode & 511n), identity: `${stat.dev}:${stat.ino}` };
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { text: undefined };
+        throw new Error(`${file}: cannot read a regular configuration file`);
+    }
+}
+const stagedFiles = new AsyncLocalStorage();
+function stagedSnapshot(scope, file) {
+    if (scope.closed)
+        throw new Error("configuration transaction already finished");
+    let snapshot = scope.reads.get(file);
+    if (!snapshot) {
+        snapshot = readFileSnapshot(file);
+        scope.reads.set(file, snapshot);
+    }
+    return snapshot;
+}
+/** Scope only this asynchronous adapter invocation, never unrelated filesystem calls. */
+export async function stageFileWrites(operation) {
+    if (stagedFiles.getStore())
+        throw new Error("nested configuration transaction is not supported");
+    const scope = { reads: new Map(), writes: new Map(), dryRun, closed: false };
+    try {
+        const result = await stagedFiles.run(scope, operation);
+        return { result, changes: [...scope.writes.values()], reads: scope.reads, dryRun: scope.dryRun };
+    }
+    finally {
+        scope.closed = true;
+    }
 }
 export function readTextIfExists(file) {
+    const scope = stagedFiles.getStore();
+    if (scope) {
+        file = path.resolve(file);
+        const snapshot = stagedSnapshot(scope, file);
+        return scope.writes.has(file) ? scope.writes.get(file).after : snapshot.text;
+    }
     try {
         return fs.readFileSync(file, "utf8");
     }
-    catch {
-        return undefined;
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
     }
 }
 export function readJsonIfExists(file) {
@@ -40,9 +90,12 @@ export function readJsonIfExists(file) {
         return undefined;
     return JSON.parse(text);
 }
-/** dry-run mode: writeFileAtomic records intents instead of touching disk; backups are skipped */
+/** Compatibility preview switch. Each target captures its value when its scoped work starts. */
 let dryRun = false;
 const pendingWrites = [];
+export function isDryRun() {
+    return stagedFiles.getStore()?.dryRun ?? dryRun;
+}
 export function setDryRun(on) {
     dryRun = on;
     pendingWrites.length = 0;
@@ -50,25 +103,67 @@ export function setDryRun(on) {
 export function drainPendingWrites() {
     return pendingWrites.splice(0);
 }
-/** Atomic write: tmp file + rename. Creates parent dirs. In dry-run mode, records the intent instead. */
+/** Publish previews only after the adapter has validated all of its input files. */
+export function recordPendingWrites(changes) {
+    for (const change of changes) {
+        if (change.before !== change.after && change.after !== undefined) {
+            pendingWrites.push({ file: change.file, content: change.after });
+        }
+    }
+}
+/** Atomic replacement, preserving existing permissions and defaulting new secret files to 0600. */
 export function writeFileAtomic(file, content, mode) {
+    const scope = stagedFiles.getStore();
+    if (scope) {
+        file = path.resolve(file);
+        const expected = stagedSnapshot(scope, file);
+        scope.writes.set(file, { file, before: expected.text, after: content, mode, expected });
+        return;
+    }
     if (dryRun) {
         pendingWrites.push({ file, content });
         return;
     }
+    const existing = readFileSnapshot(file);
+    const permissions = mode ?? existing.mode ?? 0o600;
+    if (!Number.isInteger(permissions) || permissions < 0 || permissions > 0o777) {
+        throw new Error(`${file}: invalid file permissions`);
+    }
     ensureDir(path.dirname(file));
-    const tmp = `${file}.tmp-${process.pid}`;
-    fs.writeFileSync(tmp, content, mode !== undefined ? { mode } : undefined);
-    fs.renameSync(tmp, file);
+    const tmp = path.join(path.dirname(file), `.${path.basename(file)}.agentsw-${randomUUID()}.tmp`);
+    try {
+        fs.writeFileSync(tmp, content, { flag: "wx", mode: permissions });
+        fs.chmodSync(tmp, permissions);
+        fs.renameSync(tmp, file);
+    }
+    finally {
+        fs.rmSync(tmp, { force: true });
+    }
 }
 export const backupsDir = path.join(appDataDir("agentsw"), "backups");
-/** Copy `file` into the backups dir with a timestamp suffix. No-op if file missing. */
+/** Each original gets a private, unique directory even for equal basenames and timestamps. */
 export function backupFile(file) {
-    if (!fs.existsSync(file) || dryRun)
+    const scope = stagedFiles.getStore();
+    if (scope) {
+        stagedSnapshot(scope, path.resolve(file));
+        return undefined;
+    }
+    if (dryRun)
+        return undefined;
+    const snapshot = readFileSnapshot(file);
+    if (snapshot.text === undefined)
         return undefined;
-    ensureDir(backupsDir);
-    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-    const dest = path.join(backupsDir, `${path.basename(file)}.${stamp}`);
-    fs.copyFileSync(file, dest);
+    fs.mkdirSync(backupsDir, { recursive: true, mode: 0o700 });
+    const dir = fs.mkdtempSync(path.join(backupsDir, "file-"));
+    const dest = path.join(dir, path.basename(file));
+    try {
+        fs.chmodSync(dir, 0o700);
+        fs.copyFileSync(file, dest, fs.constants.COPYFILE_EXCL);
+        fs.chmodSync(dest, 0o600);
+    }
+    catch (error) {
+        fs.rmSync(dir, { recursive: true, force: true });
+        throw error;
+    }
     return dest;
 }

package/dist/i18n.js

@@ -38,6 +38,7 @@ const messages = {
     "opt.discover": { en: "list model ids from the provider's /v1/models", "zh-CN": "从供应商 /v1/models 获取模型 id" },
     "opt.include": { en: "keep only models matching comma-separated globs", "zh-CN": "仅保留匹配逗号分隔 glob 的模型" },
     "opt.exclude": { en: "drop models matching comma-separated globs", "zh-CN": "排除匹配逗号分隔 glob 的模型" },
+    "opt.dedup": { en: "deduplicate model snapshot aliases", "zh-CN": "合并重复的模型快照别名" },
     "opt.noDedup": { en: "keep snapshot duplicates (-latest/date suffixes)", "zh-CN": "保留快照重复项(-latest/日期后缀)" },
     "opt.modelsDev": { en: "models.dev provider id for metadata matching", "zh-CN": "用于元数据匹配的 models.dev 供应商 id" },
     "opt.yes": { en: "non-interactive; require all flags", "zh-CN": "非交互模式;要求提供全部参数" },
@@ -45,7 +46,7 @@ const messages = {
     "opt.apps": { en: "comma-separated apps or 'all'", "zh-CN": "逗号分隔的应用或 'all'" },
     "opt.removeApps": { en: "delete only from these apps; keep the agentsw store and other apps unchanged", "zh-CN": "仅从这些智能体删除，保留 agentsw 中央配置和其他智能体配置" },
     "opt.manageDryRun": { en: "preview affected paths without changing files or creating backups", "zh-CN": "仅预览受影响路径，不修改文件或创建备份" },
-    "opt.appsDetailed": { en: "comma-separated apps (claude,codex,omp,pi,prime,opencode,hermes,workbuddy) or 'all'", "zh-CN": "逗号分隔的应用(claude,codex,omp,pi,prime,opencode,hermes,workbuddy)或 'all'" },
+    "opt.appsDetailed": { en: "comma-separated apps (claude,codex,omp,pi,prime,opencode,hermes,workbuddy,dsh) or 'all'", "zh-CN": "逗号分隔的应用(claude,codex,omp,pi,prime,opencode,hermes,workbuddy,dsh)或 'all'" },
     "opt.model": { en: "override default model while switching", "zh-CN": "切换时覆盖默认模型" },
     "opt.dryRun": { en: "preview config diff without writing", "zh-CN": "仅预览配置差异,不写入" },
     "opt.provider": { en: "sync this provider instead of the active one", "zh-CN": "同步指定供应商而非当前供应商" },
@@ -63,62 +64,70 @@ const messages = {
     "menu.selectInstructions": { en: "↑/↓ move · Enter select", "zh-CN": "↑/↓ 移动 · Enter 选择" },
     "import.multiInstructions": { en: "↑/↓ move · Space toggle · Enter confirm", "zh-CN": "↑/↓ 移动 · 空格切换 · Enter 确认" },
     "menu.title": { en: " · interactive menu — Ctrl+C quits, ↑/↓ selects", "zh-CN": " · 交互菜单 — Ctrl+C 退出,↑/↓ 选择" },
-    "menu.noProviders": { en: "no providers configured yet", "zh-CN": "尚未配置供应商" },
-    "menu.noProvidersHint": { en: "no providers configured — choose import existing providers or add/update provider first", "zh-CN": "尚未配置供应商——请先选择导入已有供应商或添加/更新供应商" },
-    "menu.firstScan": { en: "scan existing app configs and import custom providers now?", "zh-CN": "现在扫描应用配置并导入已有自定义供应商?" },
+    "menu.noProviders": { en: "no providers saved in agentsw yet", "zh-CN": "agentsw 中尚未保存供应商" },
+    "menu.noProvidersHint": { en: "no providers saved in agentsw — choose Add provider or Import existing providers first", "zh-CN": "agentsw 中尚未保存供应商，请先选择“添加供应商”或“导入已有供应商”" },
+    "menu.firstScan": { en: "import providers from existing agent configs into agentsw?", "zh-CN": "是否从已有智能体配置中导入供应商到 agentsw？" },
     "menu.what": { en: "what to do?", "zh-CN": "请选择操作" },
-    "menu.add": { en: "add / update provider   (id · protocol · base URL · API key)", "zh-CN": "添加 / 更新供应商      (id · 协议 · base URL · API key)" },
-    "menu.import": { en: "import existing providers (scan app configs · auto-dedupe)", "zh-CN": "导入已有供应商          (扫描应用配置 · 自动去重)" },
-    "menu.use": { en: "switch provider         (use and sync into app configs)", "zh-CN": "切换供应商              (写入并同步到应用配置)" },
-    "menu.status": { en: "status                  (what each app currently points at)", "zh-CN": "查看状态                (各应用当前指向)" },
-    "menu.list": { en: "list providers", "zh-CN": "列出供应商" },
-    "menu.sync": { en: "sync active provider    (re-apply to app configs)", "zh-CN": "同步当前供应商          (重新应用到应用配置)" },
-    "menu.discover": { en: "discover models         (refresh provider list + metadata)", "zh-CN": "发现模型                (刷新供应商模型与元数据)" },
-    "menu.remove": { en: "remove provider", "zh-CN": "删除供应商" },
-    "menu.rename": { en: "rename provider         (migrate references with backups)", "zh-CN": "重命名供应商            （备份并迁移引用）" },
-    "menu.renameProvider": { en: "which provider to rename?", "zh-CN": "重命名哪个供应商？" },
-    "menu.newId": { en: "new provider ID", "zh-CN": "新的供应商 ID" },
-    "menu.renameConfirm": { en: "rename {oldId} to {newId} across configured apps?", "zh-CN": "将 {oldId} 重命名为 {newId}，并迁移已配置智能体的引用？" },
+    "menu.add": { en: "Add / update provider (manual setup)", "zh-CN": "添加或更新供应商（手动设置）" },
+    "menu.import": { en: "Import existing providers", "zh-CN": "导入已有供应商" },
+    "menu.use": { en: "Switch provider and default model", "zh-CN": "切换供应商和默认模型" },
+    "menu.status": { en: "View each agent's current configuration", "zh-CN": "查看各智能体当前配置" },
+    "menu.list": { en: "View providers saved in agentsw", "zh-CN": "查看 agentsw 供应商列表" },
+    "menu.sync": { en: "Re-sync the current provider to agents", "zh-CN": "重新同步当前供应商" },
+    "menu.discover": { en: "Update a provider's model list", "zh-CN": "更新供应商模型列表" },
+    "menu.remove": { en: "Delete provider configuration", "zh-CN": "删除供应商配置" },
+    "menu.rename": { en: "Change a provider ID", "zh-CN": "修改供应商 ID" },
+    "menu.renameProvider": { en: "which provider ID should be changed?", "zh-CN": "选择要修改 ID 的供应商" },
+    "menu.newId": { en: "new provider ID (used in config references)", "zh-CN": "新的供应商 ID（用于配置引用）" },
+    "menu.renameConfirm": { en: "change provider ID from {oldId} to {newId} and update agent config references? Files are backed up first.", "zh-CN": "将供应商 ID 从 {oldId} 改为 {newId}，并更新智能体中的关联配置？修改前自动备份。" },
     "menu.removeScope": { en: "where should this provider be removed?", "zh-CN": "从哪里删除供应商？" },
-    "menu.removeStore": { en: "agentsw store only (keep app configs)", "zh-CN": "仅从 agentsw 删除（保留智能体配置）" },
-    "menu.removeEverywhere": { en: "agentsw and matching app configurations", "zh-CN": "从 agentsw 和匹配的智能体配置中删除" },
-    "menu.removeLocal": { en: "one agent only (including entries not imported into agentsw)", "zh-CN": "仅从一个智能体删除（包括未导入 agentsw 的供应商）" },
-    "menu.noRemovable": { en: "no providers found in this scope", "zh-CN": "这个范围内没有可删除的供应商" },
-    "menu.removeApp": { en: "which agent should this provider be removed from?", "zh-CN": "从哪个智能体删除供应商？" },
-    "menu.removeConfirmScope": { en: "remove {id} from {scope}? Default references will be cleared; files are backed up first.", "zh-CN": "从 {scope} 删除 {id}？相关默认引用将被清理，文件会先备份。" },
-    "menu.apps": { en: "agent versions          (check installed CLIs / upgrade)", "zh-CN": "智能体版本              (检查已安装 CLI / 升级)" },
-    "menu.language": { en: "language / 语言", "zh-CN": "语言 / Language" },
-    "menu.quit": { en: "quit", "zh-CN": "退出" },
+    "menu.removeStore": { en: "Delete only the record in agentsw", "zh-CN": "只删除 agentsw 中的记录" },
+    "menu.removeEverywhere": { en: "Delete the agentsw record and matching agent configs", "zh-CN": "同时删除 agentsw 记录和智能体配置" },
+    "menu.removeLocal": { en: "Delete only one agent's configuration", "zh-CN": "只删除某个智能体中的配置" },
+    "menu.noRemovable": { en: "no provider records found here; return to the menu to choose another scope", "zh-CN": "所选位置没有供应商记录，请返回菜单选择其他删除范围" },
+    "menu.removeApp": { en: "which agent's configuration should be changed?", "zh-CN": "选择要删除配置的智能体" },
+    "menu.removeStoreHelp": { en: "Keep all agent configs; the agents can still use this provider.", "zh-CN": "保留各智能体配置，它们仍可继续使用该供应商。" },
+    "menu.removeEverywhereHelp": { en: "Remove the saved provider and matching agent entries, including related default selections.", "zh-CN": "删除已保存的供应商及各智能体中匹配的配置，并清理相关默认选择。" },
+    "menu.removeLocalHelp": { en: "Keep agentsw and other agents unchanged; also works for providers never imported into agentsw.", "zh-CN": "保留 agentsw 和其他智能体；也支持从未导入 agentsw 的供应商。" },
+    "menu.removeConfirmStore": { en: "delete {id} from agentsw only? All agent configs stay unchanged. Files are backed up first.", "zh-CN": "确认只删除 agentsw 中的供应商 {id}？各智能体配置保持不变，修改前自动备份。" },
+    "menu.removeConfirmEverywhere": { en: "delete {id} from agentsw and matching agent configs? Related default selections will also be cleared. Files are backed up first.", "zh-CN": "确认删除 {id} 的 agentsw 记录和匹配的智能体配置？相关默认选择会一并清理，修改前自动备份。" },
+    "menu.removeConfirmLocal": { en: "delete {id} only from {app}? Keep agentsw and other agents unchanged; syncing later may add it back. Files are backed up first.", "zh-CN": "仅从 {app} 删除 {id}？保留 agentsw 和其他智能体配置，再次同步可能恢复。修改前自动备份。" },
+    "menu.confirmRename": { en: "Change ID", "zh-CN": "确认修改 ID" },
+    "menu.confirmRemove": { en: "Delete configuration", "zh-CN": "确认删除" },
+    "menu.cancelAction": { en: "Cancel, return to menu", "zh-CN": "取消，返回菜单" },
+    "menu.apps": { en: "Check agent versions and updates", "zh-CN": "检查智能体版本和更新" },
+    "menu.language": { en: "Change language / 语言", "zh-CN": "切换界面语言 / Language" },
+    "menu.quit": { en: "Exit menu", "zh-CN": "退出菜单" },
     "menu.yes": { en: "yes", "zh-CN": "是" },
     "menu.no": { en: "no", "zh-CN": "否" },
-    "menu.modelSource": { en: "how to fill the model list?", "zh-CN": "如何填写模型列表?" },
-    "menu.modelDiscover": { en: "discover from the provider's /v1/models (recommended)", "zh-CN": "从供应商 /v1/models 自动发现(推荐)" },
-    "menu.modelManual": { en: "type model ids manually", "zh-CN": "手动输入模型 id" },
-    "menu.pickProvider": { en: "switch to provider", "zh-CN": "切换到供应商" },
+    "menu.modelSource": { en: "how should the model list be obtained?", "zh-CN": "选择模型列表的获取方式" },
+    "menu.modelDiscover": { en: "Fetch from the provider API (recommended)", "zh-CN": "从供应商接口自动获取（推荐）" },
+    "menu.modelManual": { en: "Enter model IDs manually", "zh-CN": "手动输入模型 ID" },
+    "menu.pickProvider": { en: "which provider should agents switch to?", "zh-CN": "选择要切换到的供应商" },
     "menu.defaultModel": { en: "default model", "zh-CN": "默认模型" },
     "menu.keepDefault": { en: "keep current default ({model})", "zh-CN": "保持当前默认模型({model})" },
-    "menu.active": { en: "active", "zh-CN": "当前" },
-    "menu.discoverFor": { en: "discover models for", "zh-CN": "为供应商发现模型" },
-    "menu.pushRefresh": { en: "push refreshed provider into app configs?", "zh-CN": "将刷新后的供应商推送到应用配置?" },
-    "menu.removeProvider": { en: "remove provider", "zh-CN": "删除供应商" },
+    "menu.active": { en: "current in agentsw", "zh-CN": "agentsw 当前" },
+    "menu.discoverFor": { en: "which provider's model list should be updated?", "zh-CN": "选择要更新模型列表的供应商" },
+    "menu.pushRefresh": { en: "also sync this provider to agent configs after updating its model list?", "zh-CN": "更新模型列表后，是否同时将该供应商同步到智能体配置？" },
+    "menu.removeProvider": { en: "which provider configuration should be deleted?", "zh-CN": "选择要删除配置的供应商" },
     "menu.reallyRemove": { en: "really remove {id}?", "zh-CN": "确认删除 {id}?" },
     "menu.pruneConfigs": { en: "also remove its entries from app configs?", "zh-CN": "同时从应用配置中移除其条目?" },
-    "menu.upgrade": { en: "upgrade everything outdated?", "zh-CN": "升级全部过期项?" },
-    "menu.installApp": { en: "install an agent", "zh-CN": "安装智能体" },
+    "menu.upgrade": { en: "upgrade all installed agents that have updates?", "zh-CN": "是否升级所有有新版本的已安装智能体？" },
+    "menu.installApp": { en: "Install a new coding agent", "zh-CN": "安装新的智能体" },
     "menu.pickApp": { en: "which agent to install?", "zh-CN": "安装哪个智能体?" },
     "menu.installConfirm": { en: "install {name} via: {cmd}?", "zh-CN": "通过以下命令安装 {name}: {cmd}?" },
     "menu.allInstalled": { en: "all agents already installed", "zh-CN": "所有智能体均已安装" },
     "menu.bye": { en: "bye", "zh-CN": "再见" },
     "add.id": { en: "provider id (slug)", "zh-CN": "供应商 id(slug)" },
     "add.idAuto": { en: "provider id (leave blank for hostname + protocol)", "zh-CN": "供应商 ID（留空使用完整域名 + 协议）" },
-    "add.idInvalid": { en: "lowercase slug, e.g. glm or my-proxy", "zh-CN": "请用小写 slug,例如 glm 或 my-proxy" },
+    "add.idInvalid": { en: "start with a lowercase letter or digit; use only lowercase letters, digits, - and _, e.g. my-proxy", "zh-CN": "以小写字母或数字开头，仅含小写字母、数字、-、_，如 my-proxy" },
     "add.name": { en: "display name", "zh-CN": "显示名称" },
     "add.protocol": { en: "wire protocol", "zh-CN": "接口协议" },
     "add.openai": { en: "openai (chat completions)", "zh-CN": "openai (chat completions)" },
     "add.anthropic": { en: "anthropic (messages)", "zh-CN": "anthropic (messages)" },
-    "add.baseUrl": { en: "base URL", "zh-CN": "base URL" },
+    "add.baseUrl": { en: "API base URL", "zh-CN": "接口地址（Base URL）" },
     "add.baseUrlInvalid": { en: "must start with http(s)://", "zh-CN": "必须以 http(s):// 开头" },
-    "add.apiKey": { en: "API key", "zh-CN": "API key" },
+    "add.apiKey": { en: "API key", "zh-CN": "API 密钥（API key）" },
     "add.models": { en: "model ids (comma separated, or leave blank to auto-discover)", "zh-CN": "模型 id(逗号分隔，留空则自动发现)" },
     "add.cancelled": { en: "cancelled", "zh-CN": "已取消" },
     "import.already": { en: "already configured as {id}", "zh-CN": "已配置为 {id}" },
@@ -170,7 +179,21 @@ const messages = {
     "quick.noProtocol": { en: "no supported protocol found at this endpoint (tried openai and anthropic)", "zh-CN": "该端点未检测到支持的协议(已尝试 openai 和 anthropic)" },
     "quick.noModelsAfterFilter": { en: "{id}: no models left after filtering, skipping", "zh-CN": "{id}: 过滤后无剩余模型,跳过" },
     "quick.summary": { en: "created {count} provider(s): {ids}", "zh-CN": "创建了 {count} 个供应商: {ids}" },
-    "menu.quickAdd": { en: "quick add (auto-detect protocol + models)", "zh-CN": "快速添加(自动探测协议 + 模型)" },
+    "menu.quickAdd": { en: "Add provider (auto-detect)", "zh-CN": "添加供应商（自动识别）" },
+    "menu.quickAddHelp": { en: "Recommended: enter an API URL and key; detect protocols and models automatically.", "zh-CN": "推荐：只填接口地址和 API key，自动识别协议与模型。" },
+    "menu.addHelp": { en: "Choose the protocol and model setup yourself; use an existing ID to update a provider.", "zh-CN": "自行选择协议和模型获取方式；填写已有 ID 可更新供应商。" },
+    "menu.importHelp": { en: "Read providers from agents or cc-switch into agentsw; leave source configs unchanged.", "zh-CN": "从智能体或 cc-switch 读取配置并保存到 agentsw，不修改来源配置。" },
+    "menu.useHelp": { en: "Select a provider and default model, then write them to compatible agent configs.", "zh-CN": "选择供应商和默认模型，然后写入支持该协议的智能体配置。" },
+    "menu.statusHelp": { en: "Show detected agents, their current providers and config file locations.", "zh-CN": "查看检测到的智能体、所用供应商及配置文件位置。" },
+    "menu.listHelp": { en: "Show only the providers, protocols and default models saved in agentsw.", "zh-CN": "只查看 agentsw 已保存的供应商、协议和默认模型。" },
+    "menu.syncHelp": { en: "Write the current agentsw provider to agent configs without fetching a new model list.", "zh-CN": "将 agentsw 当前供应商写入智能体配置，不重新获取模型列表。" },
+    "menu.discoverHelp": { en: "Fetch models from the provider, fill in model metadata, and optionally sync to agents.", "zh-CN": "从供应商接口重新获取模型并补全模型参数，可选择同步到智能体。" },
+    "menu.renameHelp": { en: "Change the config ID and update references; keep custom display names.", "zh-CN": "修改配置中的标识并更新关联引用，保留自定义显示名称。" },
+    "menu.removeHelp": { en: "Choose where to delete: agentsw only, one agent only, or both.", "zh-CN": "先选择删除范围：仅 agentsw、仅某个智能体，或两处一起。" },
+    "menu.appsHelp": { en: "Compare installed and latest versions, then choose whether to upgrade.", "zh-CN": "对比已安装版本和最新版本，再选择是否升级。" },
+    "menu.installAppHelp": { en: "Choose an agent that is not installed yet, such as Claude Code, Codex or omp.", "zh-CN": "选择尚未安装的编码智能体，如 Claude Code、Codex 或 omp。" },
+    "menu.languageHelp": { en: "Choose English or 简体中文 and save the language for future runs.", "zh-CN": "选择简体中文或 English，保存为后续运行的界面语言。" },
+    "menu.quitHelp": { en: "End this menu session without performing another action.", "zh-CN": "结束本次交互，不执行其他操作。" },
     "import.skip": { en: "skip", "zh-CN": "跳过" },
     "import.modelsCount": { en: "{count} models", "zh-CN": "{count} 个模型" },
     "table.protocol": { en: "PROTOCOL", "zh-CN": "协议" },

package/dist/import.js

@@ -12,12 +12,12 @@ export function normalizeUrl(u) {
 }
 /** True when the path already names the API version, e.g. `.../v1`. */
 const hasApiVersion = (baseUrl) => /\/v\d+(?:beta\d*)?$/.test(baseUrl.split(/[?#]/, 1)[0]);
-/** Apps may append their own API version; all other URL components remain significant. */
+/** Apps may append /v1; other API versions and URL components remain significant. */
 export function endpointKey(baseUrl) {
     const normalized = normalizeUrl(baseUrl);
     const suffixAt = normalized.search(/[?#]/);
     const path = suffixAt < 0 ? normalized : normalized.slice(0, suffixAt);
-    return path.replace(/\/v\d+(?:beta\d*)?$/, "") + (suffixAt < 0 ? "" : normalized.slice(suffixAt));
+    return path.replace(/\/v1$/, "") + (suffixAt < 0 ? "" : normalized.slice(suffixAt));
 }
 /** An unresolved credential is not evidence that two configurations use the same account. */
 export function findMatchingProvider(existing, candidate) {

package/dist/index.js

@@ -6,8 +6,17 @@ import { detectSystemLocale, extractCliLocale, normalizeLocale, setLocale, t } f
 import { cmdMenu } from "./menu.js";
 import { loadStore } from "./store.js";
 import { cmdListLocalProviders, cmdRemoveProvider, cmdRename } from "./provider-actions.js";
+// Locale lookup is best effort: help/version and app-local commands do not need the store.
+function savedLocale() {
+    try {
+        return loadStore().language;
+    }
+    catch {
+        return undefined;
+    }
+}
 // Locale precedence: CLI flag > environment > saved preference > system locale.
-setLocale(extractCliLocale() ?? process.env.AGENTSW_LANG ?? loadStore().language ?? detectSystemLocale());
+setLocale(extractCliLocale() ?? process.env.AGENTSW_LANG ?? savedLocale() ?? detectSystemLocale());
 function parseLocale(value) {
     const locale = normalizeLocale(value);
     if (!locale)
@@ -51,6 +60,7 @@ program
     .option("-d, --discover", t("opt.discover"))
     .option("--include <globs>", t("opt.include"))
     .option("--exclude <globs>", t("opt.exclude"))
+    .option("--dedup", t("opt.dedup"))
     .option("--no-dedup", t("opt.noDedup"))
     .option("--models-dev <id>", t("opt.modelsDev"))
     .option("-y, --yes", t("opt.yes"))
@@ -59,6 +69,9 @@ program
     .command("quick")
     .description(t("cmd.quick"))
     .option("--id <slug>", t("opt.id"))
+    .option("--name <name>", t("opt.name"))
+    .option("--openai-api <flavor>", t("opt.openaiApi"))
+    .option("--models-dev <id>", t("opt.modelsDev"))
     .option("--base-url <url>", t("opt.baseUrl"))
     .option("--api-key <key>", t("opt.apiKey"))
     .option("--default-model <id>", t("opt.defaultModel"))
@@ -66,6 +79,7 @@ program
     .option("--reasoning-effort <level>", t("opt.reasoning"))
     .option("--include <globs>", t("opt.include"))
     .option("--exclude <globs>", t("opt.exclude"))
+    .option("--dedup", t("opt.dedup"))
     .option("--no-dedup", t("opt.noDedup"))
     .option("-y, --yes", t("opt.yes"))
     .action(cmdQuickAdd);
@@ -122,6 +136,7 @@ program
     .option("-a, --apps <apps>", t("opt.appsSync"))
     .option("--include <globs>", t("opt.setInclude"))
     .option("--exclude <globs>", t("opt.setExclude"))
+    .option("--dedup", t("opt.dedup"))
     .option("--no-dedup", t("opt.noDedup"))
     .option("--no-filter", t("opt.noFilter"))
     .action(cmdDiscover);

package/dist/jsonc.js

@@ -1,4 +1,4 @@
-import fs from "node:fs";
+import { readTextIfExists } from "./fsutil.js";
 import { applyEdits, createScanner, getNodeValue, modify, parseTree, printParseErrorCode, } from "jsonc-parser";
 export function isJsonObject(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -34,15 +34,9 @@ function parseJsoncObject(file, text) {
 }
 /** Only missing files initialize to an empty object; unreadable or invalid files must not be replaced. */
 export function readJsoncObject(file) {
-    let text;
-    try {
-        text = fs.readFileSync(file, "utf8");
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return { file, text: "{}\n", value: {} };
-        throw error;
-    }
+    const text = readTextIfExists(file);
+    if (text === undefined)
+        return { file, text: "{}\n", value: {} };
     return { file, text, value: parseJsoncObject(file, text) };
 }
 function comments(text) {

package/dist/menu.js

@@ -13,8 +13,8 @@ function bye() {
     process.exit(0);
 }
 const cancel = { onCancel: () => bye() };
-async function askToggle(message, initial = false) {
-    const { v } = await prompts({ type: "toggle", name: "v", message, active: t("menu.yes"), inactive: t("menu.no"), initial }, cancel);
+async function askToggle(message, initial = false, labels) {
+    const { v } = await prompts({ type: "toggle", name: "v", message, active: labels?.active ?? t("menu.yes"), inactive: labels?.inactive ?? t("menu.no"), initial }, cancel);
     return v === true;
 }
 async function chooseLanguage() {
@@ -77,7 +77,9 @@ async function renameFromMenu() {
         return;
     const next = String(newId).trim();
     await cmdRename(picked.id, next, { dryRun: true });
-    if (await askToggle(t("menu.renameConfirm", { oldId: picked.id, newId: next }))) {
+    if (await askToggle(t("menu.renameConfirm", { oldId: picked.id, newId: next }), false, {
+        active: t("menu.confirmRename"), inactive: t("menu.cancelAction"),
+    })) {
         await cmdRename(picked.id, next);
     }
 }
@@ -88,9 +90,9 @@ async function removeFromMenu() {
         message: t("menu.removeScope"),
         hint: t("menu.selectInstructions"),
         choices: [
-            { title: t("menu.removeStore"), value: "store" },
-            { title: t("menu.removeEverywhere"), value: "everywhere" },
-            { title: t("menu.removeLocal"), value: "local" },
+            { title: t("menu.removeStore"), description: t("menu.removeStoreHelp"), value: "store" },
+            { title: t("menu.removeLocal"), description: t("menu.removeLocalHelp"), value: "local" },
+            { title: t("menu.removeEverywhere"), description: t("menu.removeEverywhereHelp"), value: "everywhere" },
         ],
     }, cancel);
     if (!scope)
@@ -130,8 +132,12 @@ async function removeFromMenu() {
         return;
     const opts = scope === "local" ? { apps: picked.app } : { prune: scope === "everywhere" };
     await cmdRemoveProvider(picked.id, { ...opts, dryRun: true });
-    const scopeLabel = picked.app ?? t(scope === "everywhere" ? "menu.removeEverywhere" : "menu.removeStore");
-    if (await askToggle(t("menu.removeConfirmScope", { id: picked.id, scope: scopeLabel }))) {
+    const confirmation = picked.app
+        ? t("menu.removeConfirmLocal", { id: picked.id, app: picked.app })
+        : t(scope === "everywhere" ? "menu.removeConfirmEverywhere" : "menu.removeConfirmStore", { id: picked.id });
+    if (await askToggle(confirmation, false, {
+        active: t("menu.confirmRemove"), inactive: t("menu.cancelAction"),
+    })) {
         await cmdRemoveProvider(picked.id, opts);
     }
 }
@@ -152,20 +158,20 @@ export async function cmdMenu() {
             message: t("menu.what"),
             hint: t("menu.selectInstructions"),
             choices: [
-                { title: t("menu.add"), value: "add" },
-                { title: t("menu.quickAdd"), value: "quickAdd" },
-                { title: t("menu.import"), value: "import" },
-                { title: t("menu.use"), value: "use" },
-                { title: t("menu.status"), value: "status" },
-                { title: t("menu.list"), value: "list" },
-                { title: t("menu.sync"), value: "sync" },
-                { title: t("menu.discover"), value: "discover" },
-                { title: t("menu.rename"), value: "rename" },
-                { title: t("menu.remove"), value: "remove" },
-                { title: t("menu.apps"), value: "apps" },
-                { title: t("menu.installApp"), value: "install" },
-                { title: t("menu.language"), value: "language" },
-                { title: t("menu.quit"), value: "quit" },
+                { title: t("menu.quickAdd"), description: t("menu.quickAddHelp"), value: "quickAdd" },
+                { title: t("menu.add"), description: t("menu.addHelp"), value: "add" },
+                { title: t("menu.import"), description: t("menu.importHelp"), value: "import" },
+                { title: t("menu.use"), description: t("menu.useHelp"), value: "use" },
+                { title: t("menu.status"), description: t("menu.statusHelp"), value: "status" },
+                { title: t("menu.list"), description: t("menu.listHelp"), value: "list" },
+                { title: t("menu.sync"), description: t("menu.syncHelp"), value: "sync" },
+                { title: t("menu.discover"), description: t("menu.discoverHelp"), value: "discover" },
+                { title: t("menu.rename"), description: t("menu.renameHelp"), value: "rename" },
+                { title: t("menu.remove"), description: t("menu.removeHelp"), value: "remove" },
+                { title: t("menu.apps"), description: t("menu.appsHelp"), value: "apps" },
+                { title: t("menu.installApp"), description: t("menu.installAppHelp"), value: "install" },
+                { title: t("menu.language"), description: t("menu.languageHelp"), value: "language" },
+                { title: t("menu.quit"), description: t("menu.quitHelp"), value: "quit" },
             ],
         }, cancel);
         if (action === undefined || action === "quit")

package/dist/modelsdev.js

@@ -75,9 +75,13 @@ export function findModelMeta(catalog, modelId, providerHint) {
         if (m)
             return { spec: toModelSpec(modelId, m), provider: hinted.id };
     }
-    for (const p of Object.values(catalog)) {
-        if (p === hinted)
-            continue;
+    const providers = Object.values(catalog).filter((p) => p !== hinted);
+    for (const p of providers) {
+        const m = p.models[modelId];
+        if (m)
+            return { spec: toModelSpec(modelId, m), provider: p.id };
+    }
+    for (const p of providers) {
         const m = scan(p);
         if (m)
             return { spec: toModelSpec(modelId, m), provider: p.id };

package/dist/provider-identity.js

@@ -0,0 +1,25 @@
+import { createHash } from "node:crypto";
+/** Previous releases used this lossy encoding; recognize it, never generate it. */
+export function legacyManagedCredentialRef(id) {
+    return `AGENTSW_${id.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_API_KEY`;
+}
+/** Human-readable prefix plus an exact, case-sensitive provider identity digest. */
+export function managedCredentialRef(id) {
+    const prefix = id.toUpperCase().replace(/[^A-Z0-9]/g, "_").slice(0, 48) || "PROVIDER";
+    const digest = createHash("sha256").update(id).digest("hex").slice(0, 24).toUpperCase();
+    return `AGENTSW_${prefix}_${digest}_API_KEY`;
+}
+export function isManagedCredentialRef(ref, id) {
+    return ref === managedCredentialRef(id) || ref === legacyManagedCredentialRef(id);
+}
+/** Account-qualified app-local selector; never embeds endpoints or credentials. */
+export function localProviderId(candidate) {
+    const identity = JSON.stringify([
+        candidate.id,
+        candidate.protocol,
+        candidate.baseUrl,
+        candidate.apiKey ?? null,
+        candidate.keyEnv ?? null,
+    ]);
+    return `local-${createHash("sha256").update(identity).digest("hex").slice(0, 32)}`;
+}