agentsw 0.7.0 → 0.7.1

package/dist/i18n.js

@@ -63,62 +63,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 +178,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsw",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "CLI provider switcher for coding agents: manage OpenAI/Anthropic-protocol providers in one place and sync them, with models.dev metadata, into Claude Code, Codex, omp, pi, prime-agent, opencode, Hermes, WorkBuddy and DeepSeek Harness",
   "type": "module",
   "repository": {