@ailuntz/minilink 0.8.1 → 0.9.2

package/README.md

@@ -1,32 +1,34 @@
-# minilink
+# MiniLink
 
-在 ChatGPT / Codex Desktop 的原生模型菜单中使用已有 profiles。
-
-读取 `~/.codex/*.config.toml`：有 `model_catalog_json` 就使用该目录，否则继承原生模型列表。支持 API key 的 Responses 连接还会追加 `-Chat`，用于不带工具和工作区上下文的纯文字聊天。
+在 ChatGPT / Codex Desktop 的原生模型菜单中使用自定义模型。
 
 ## 安装
 
-macOS，Node.js ≥22.16。
+支持 macOS，需 Node.js ≥22.16。
 
 ```sh
 npm install -g @ailuntz/minilink
+minilink on
 ```
 
-完全退出并重开 Desktop，然后开启：
+完全退出并重开 Desktop。
 
-```sh
-minilink on
-```
+## 命令
 
 | 命令 | 用途 |
 | --- | --- |
-| `on` | 开启模型选项，打开模型选择页 |
-| `off` | 关闭追加选项和选择页接管 |
-| `doctor` | 检查配置、版本和运行状态 |
+| `minilink on` | 开启 |
+| `minilink link` | 选择模型与推理强度 |
+| `minilink off` | 关闭 |
+| `minilink doctor` | 检查配置与运行状态 |
 
-额度提示挡住菜单时，用 `on` 打开选择页切换。选择持续到交回菜单、执行 `off` 或退出 Desktop。
+## 配置
 
-启动时后台检查更新，每天最多一次。有新版便静默下载安装，断网或失败则继续使用旧版。新版及 profiles、连接、密钥的修改在重启 Desktop 后生效。`MINILINK_NO_UPDATE_CHECK=1` 可关闭自动更新。
+读取 `~/.codex/*.config.toml`。通过 `model_catalog_json` 指定模型目录；未指定时继承原生目录。密钥使用提供商配置的环境变量，也可保存在 `~/.codex/.env`。
+
+支持 Responses API。符合条件的连接提供 `-Chat` 选项，用于纯文字聊天。
+
+供应商示例：[DeepSeek / 豆包](examples/providers/)。
 
 ## 卸载
 
@@ -34,11 +36,4 @@ minilink on
 npm uninstall -g @ailuntz/minilink
 ```
 
-约两分钟后自动移除接入，重启 Desktop 生效。保留用户配置和运行中任务所需的文件。
-
-## 注意
-
-- 跨连接切换需要任务已保存且空闲；临时任务、尚无历史或含子代理的任务请新建。
-- Chat 仅支持纯文字历史，不支持附件、中途追加和上下文压缩。
-- 切换模型保留当前任务权限。
-- 密钥使用提供商声明的环境变量，也可放在 `~/.codex/.env`。支持 `CODEX_HOME`。
+卸载后完全退出并重开 Desktop。

package/bin/minilink.mjs

@@ -4,32 +4,28 @@ import { fileURLToPath } from 'node:url';
 import { VERSION, readConfig, configPath, codexHome, atomicJSON, discoverProfiles, resolveRealCodex, childEnvironment } from '../src/config.mjs';
 import { startUpdate, updateStatus } from '../src/update.mjs';
 import { runProxy } from '../src/proxy.mjs';
-import { openPicker } from '../src/picker.mjs';
+import { pickerEndpoints } from '../src/picker.mjs';
+import { selectModel, text, language } from '../src/terminal.mjs';
 import { installation, environmentStatus } from '../src/install.mjs';
 
 const self = fileURLToPath(import.meta.url), args = process.argv.slice(2);
-const commands = ['on', 'off', 'doctor'];
+const commands = ['on', 'link', 'off', 'doctor'];
 const output = value => console.log(typeof value === 'string' ? value : JSON.stringify(value, null, 2));
-const help = `minilink
-
-  on           开启 profile 模型选项，并打开模型选择页
-  off          隐藏额外选项，停止选择页接管
-  doctor       检查 profiles、连接和是否需要重启
-
-自动读取 CODEX_HOME 下的 *.config.toml，无需重复配置。
-有 model_catalog_json 时使用生效目录，否则继承客户端模型目录。
-权限仍由当前任务管理。其他 Codex 参数原样透传。`;
 
 async function main() {
   startUpdate();
   const command = args[0];
-  if (['install', 'uninstall'].includes(command)) throw new Error(`请使用 npm ${command} -g @ailuntz/minilink。`);
-  if (!command || ['--help', '-h'].includes(command)) return output(help);
-  if (commands.includes(command) && args.length !== 1) throw new Error(`${command} 不接受额外参数。`);
+  if (['install', 'uninstall'].includes(command)) throw new Error(`${language() === 'zh' ? '请使用' : 'Use'} npm ${command} -g @ailuntz/minilink.`);
+  if (!command || ['--help', '-h'].includes(command)) return output(text('help'));
+  if (commands.includes(command) && args.length !== 1) throw new Error(language() === 'zh' ? `${command} 不接受额外参数。` : `${command} does not accept extra arguments.`);
   if (command === 'on' || command === 'off') {
     if (command === 'on') discoverProfiles();
     atomicJSON(configPath(), { version: 1, enabled: command === 'on' });
-    return output(command === 'off' ? '已关闭额外选项和选择页接管。已有任务保留当前提供商。' : openPicker(codexHome()) ? '已开启，并打开模型选择页。' : '已开启。请完全退出并重开 Desktop；需要选择页时再次运行 on。');
+    return output(text(command));
+  }
+  if (command === 'link') {
+    if (!readConfig().enabled) throw new Error(text('disabled'));
+    return output(await selectModel(pickerEndpoints(codexHome())));
   }
   if (command === 'doctor') {
     const profiles = discoverProfiles(), env = childEnvironment(profiles);

package/examples/providers/.env.example

@@ -0,0 +1,2 @@
+DEEPSEEK_API_KEY=
+ARK_API_KEY=

package/examples/providers/README.md

@@ -0,0 +1,12 @@
+# 供应商配置
+
+将所需的 `.config.toml` 和 `-models.json` 文件放入 `~/.codex/`，按 `.env.example` 将密钥补充到 `~/.codex/.env`，然后重启 Desktop。
+
+| 供应商 | 模型 |
+| --- | --- |
+| DeepSeek | V4.1 Flash、V4 Pro |
+| 豆包 | Seed 2.1 Pro、Seed 2.1 Lite（260915） |
+
+MiniLink 的 Chat 模式仅支持文字。
+
+模型核对：2026-09-24。[DeepSeek](https://api-docs.deepseek.com/quick_start/pricing/) · [豆包](https://docs.volcengine.com/docs/ark/model-list?lang=zh)

package/examples/providers/deepseek-models.json

@@ -0,0 +1,83 @@
+{
+  "models": [
+    {
+      "slug": "deepseek-flash",
+      "display_name": "DeepSeek V4.1 Flash",
+      "description": "DeepSeek V4.1 Flash",
+      "default_reasoning_level": "low",
+      "supported_reasoning_levels": [
+        {
+          "effort": "low",
+          "description": "low"
+        },
+        {
+          "effort": "high",
+          "description": "high"
+        },
+        {
+          "effort": "max",
+          "description": "max"
+        }
+      ],
+      "shell_type": "unified_exec",
+      "visibility": "list",
+      "supported_in_api": true,
+      "priority": 0,
+      "upgrade": null,
+      "base_instructions": "You are a helpful coding assistant. Follow the user instructions, inspect the workspace when needed, and explain results clearly.",
+      "support_verbosity": false,
+      "supports_reasoning_summaries": false,
+      "default_reasoning_summary": "none",
+      "supports_parallel_tool_calls": false,
+      "truncation_policy": {
+        "mode": "bytes",
+        "limit": 10000
+      },
+      "experimental_supported_tools": [],
+      "context_window": 1000000,
+      "input_modalities": [
+        "text",
+        "image"
+      ]
+    },
+    {
+      "slug": "deepseek-v4-pro",
+      "display_name": "DeepSeek V4 Pro",
+      "description": "DeepSeek V4 Pro",
+      "default_reasoning_level": "low",
+      "supported_reasoning_levels": [
+        {
+          "effort": "low",
+          "description": "low"
+        },
+        {
+          "effort": "high",
+          "description": "high"
+        },
+        {
+          "effort": "max",
+          "description": "max"
+        }
+      ],
+      "shell_type": "unified_exec",
+      "visibility": "list",
+      "supported_in_api": true,
+      "priority": 0,
+      "upgrade": null,
+      "base_instructions": "You are a helpful coding assistant. Follow the user instructions, inspect the workspace when needed, and explain results clearly.",
+      "support_verbosity": false,
+      "supports_reasoning_summaries": false,
+      "default_reasoning_summary": "none",
+      "supports_parallel_tool_calls": false,
+      "truncation_policy": {
+        "mode": "bytes",
+        "limit": 10000
+      },
+      "experimental_supported_tools": [],
+      "context_window": 1000000,
+      "input_modalities": [
+        "text"
+      ]
+    }
+  ]
+}

package/examples/providers/deepseek.config.toml

@@ -0,0 +1,9 @@
+model_provider = "deepseek"
+model_catalog_json = "deepseek-models.json"
+
+[model_providers.deepseek]
+name = "DeepSeek"
+base_url = "https://api.deepseek.com"
+env_key = "DEEPSEEK_API_KEY"
+wire_api = "responses"
+requires_openai_auth = false

package/examples/providers/doubao-models.json

@@ -0,0 +1,68 @@
+{
+  "models": [
+    {
+      "slug": "doubao-seed-2-1-pro-260915",
+      "display_name": "Doubao Seed 2.1 Pro",
+      "description": "Doubao Seed 2.1 Pro",
+      "default_reasoning_level": "low",
+      "supported_reasoning_levels": [
+        {
+          "effort": "low",
+          "description": "low"
+        }
+      ],
+      "shell_type": "unified_exec",
+      "visibility": "list",
+      "supported_in_api": true,
+      "priority": 0,
+      "upgrade": null,
+      "base_instructions": "You are a helpful coding assistant. Follow the user instructions, inspect the workspace when needed, and explain results clearly.",
+      "support_verbosity": false,
+      "supports_reasoning_summaries": false,
+      "default_reasoning_summary": "none",
+      "supports_parallel_tool_calls": false,
+      "truncation_policy": {
+        "mode": "bytes",
+        "limit": 10000
+      },
+      "experimental_supported_tools": [],
+      "context_window": 1048576,
+      "input_modalities": [
+        "text",
+        "image"
+      ]
+    },
+    {
+      "slug": "doubao-seed-2-1-lite-260915",
+      "display_name": "Doubao Seed 2.1 Lite",
+      "description": "Doubao Seed 2.1 Lite",
+      "default_reasoning_level": "low",
+      "supported_reasoning_levels": [
+        {
+          "effort": "low",
+          "description": "low"
+        }
+      ],
+      "shell_type": "unified_exec",
+      "visibility": "list",
+      "supported_in_api": true,
+      "priority": 0,
+      "upgrade": null,
+      "base_instructions": "You are a helpful coding assistant. Follow the user instructions, inspect the workspace when needed, and explain results clearly.",
+      "support_verbosity": false,
+      "supports_reasoning_summaries": false,
+      "default_reasoning_summary": "none",
+      "supports_parallel_tool_calls": false,
+      "truncation_policy": {
+        "mode": "bytes",
+        "limit": 10000
+      },
+      "experimental_supported_tools": [],
+      "context_window": 1048576,
+      "input_modalities": [
+        "text",
+        "image"
+      ]
+    }
+  ]
+}

package/examples/providers/doubao.config.toml

@@ -0,0 +1,9 @@
+model_provider = "doubao"
+model_catalog_json = "doubao-models.json"
+
+[model_providers.doubao]
+name = "Doubao"
+base_url = "https://ark.cn-beijing.volces.com/api/v3"
+env_key = "ARK_API_KEY"
+wire_api = "responses"
+requires_openai_auth = false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ailuntz/minilink",
-  "version": "0.8.1",
+  "version": "0.9.2",
   "description": "Use your Codex profiles in the Desktop model menu.",
   "type": "module",
   "license": "MIT AND Apache-2.0",
@@ -13,6 +13,7 @@
   "files": [
     "bin/",
     "src/",
+    "examples/",
     "README.md",
     "LICENSE"
   ],

package/src/picker.mjs

@@ -2,27 +2,27 @@ import { createServer } from 'node:http';
 import { randomBytes } from 'node:crypto';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { execFileSync } from 'node:child_process';
 import { activeRuns } from './runtime.mjs';
 import { VERSION } from './config.mjs';
+import { text } from './terminal.mjs';
 import { additionalModels } from './model-menu.mjs';
 
-// A choice in this page explicitly owns model selection until released. Desktop
-// can substitute its reserve model at submission time, not just hide its menu.
+// Keep the selected model when Desktop substitutes its reserve model at quota.
+// A pending choice belongs to the next user task that starts or sends a message.
 export class Picker {
-  constructor({ bridge, menu, getConfig, serialize, chats = [] } = {}) {
-    Object.assign(this, { bridge, menu, getConfig, serialize, chats });
-    this.pins = new Map(); this.starts = new Map(); this.next = null; this.sequence = 0;
+  constructor({ bridge, getConfig, serialize, configRpc, chats = [] } = {}) {
+    Object.assign(this, { bridge, getConfig, serialize, configRpc, chats });
+    this.pins = new Map(); this.pending = new Map(); this.next = null;
   }
   request(message) {
-    if (!this.getConfig().enabled) { this.pins.clear(); this.starts.clear(); this.next = null; }
+    if (!this.getConfig().enabled) { this.pins.clear(); this.pending.clear(); this.next = null; }
     const params = message?.params;
     if (!params || !Object.hasOwn(message, 'id')) return message;
     let pin = this.pins.get(params.threadId);
-    if (message.method === 'thread/start' && params.threadSource === 'user' && this.next) {
+    if (this.next && ((message.method === 'thread/start' && params.threadSource === 'user') || (message.method === 'turn/start' && params.threadId))) {
       pin = this.next;
       this.next = null;
-      this.starts.set(message.id, pin);
+      this.pending.set(message.id, { pin, threadId: params.threadId });
     }
     if (!pin || !['thread/start', 'thread/resume', 'thread/settings/update', 'turn/settings/update', 'turn/start'].includes(message.method)) return message;
     const updated = { ...params, model: pin.model, effort: pin.effort };
@@ -31,11 +31,12 @@ export class Picker {
     return { ...message, params: updated };
   }
   response(message) {
-    const pin = this.starts.get(message?.id);
-    if (!pin || message.method) return;
-    this.starts.delete(message.id);
-    if (message.result?.thread?.id) this.pins.set(message.result.thread.id, pin);
-    else if (message.error && !this.next) this.next = pin;
+    const pending = this.pending.get(message?.id);
+    if (!pending || message.method) return;
+    const { pin, threadId } = pending;
+    this.pending.delete(message.id);
+    if (message.error) { if (!this.next) this.next = pin; }
+    else if (message.result && (threadId || message.result.thread?.id)) this.pins.set(threadId || message.result.thread.id, pin);
   }
   async catalog() {
     await this.refreshCatalogs?.();
@@ -43,7 +44,7 @@ export class Picker {
     do {
       const page = await this.bridge.rpc('model/list', { limit: 100, includeHidden: false, ...(cursor ? { cursor } : {}) });
       models.push(...page.data); cursor = page.nextCursor;
-      if (models.length > 10000) throw new Error('模型目录过大，请重新打开选择页。');
+      if (models.length > 10000) throw new Error(text('catalogLarge'));
     } while (cursor);
     const config = this.getConfig();
     return [...models, ...(config.enabled ? additionalModels(models, config) : [])].filter(m => !m.hidden);
@@ -51,76 +52,48 @@ export class Picker {
   async state() {
     this.request(null);
     const models = await this.catalog();
-    const threads = [];
-    let cursor;
-    do {
-      const page = await this.bridge.rpc('thread/loaded/list', { limit: 100, ...(cursor ? { cursor } : {}) });
-      for (const id of page.data) {
-        try {
-          const { thread } = await this.bridge.rpc('thread/read', { threadId: id, includeTurns: false });
-          if (thread.parentThreadId || thread.source?.subAgent) continue;
-          this.menu.rememberThread(thread);
-          threads.push({ id, name: thread.name || thread.preview || '未命名任务', cwd: thread.cwd, status: thread.status?.type,
-            model: thread.model, provider: thread.modelProvider, pin: this.pins.get(id) || null });
-        } catch { /* a task may close while the list is being read */ }
-      }
-      cursor = page.nextCursor;
-    } while (cursor);
-    return { threads, next: this.next, models: models.map(m => ({ model: m.model, name: m.displayName || m.model,
+    const { config } = await this.configRpc('config/read', { includeLayers: false });
+    return { next: this.next, selected: { model: config.model, effort: config.model_reasoning_effort }, models: models.map(m => ({ model: m.model, name: m.displayName || m.model,
       effort: m.defaultReasoningEffort, efforts: m.supportedReasoningEfforts || [] })) };
   }
-  async choose({ threadId, model, effort }) {
-    if (!this.getConfig().enabled) throw new Error('路由已关闭，请先运行 minilink on。');
-    if (typeof threadId !== 'string') throw new Error('请选择任务。');
+  async choose({ model, effort }) {
+    if (!this.getConfig().enabled) throw new Error(text('disabled'));
     const entry = (await this.catalog()).find(m => m.model === model);
-    if (!entry) throw new Error('此模型已不在原生目录中，请刷新。');
+    if (!entry) throw new Error(text('missingModel'));
     const supported = entry.supportedReasoningEfforts || [];
     effort = supported.length ? (effort ?? entry.defaultReasoningEffort) : null;
-    if (supported.length && !supported.some(e => e.reasoningEffort === effort)) throw new Error('请选择该模型支持的推理强度。');
-    const pin = { model, effort };
-    if (threadId === 'next') { this.next = pin; return { ok: true }; }
-    const { thread } = await this.bridge.rpc('thread/read', { threadId, includeTurns: false });
-    if (thread.status?.type !== 'idle') throw new Error('请等待任务回复和工具运行结束。');
-    this.menu.rememberThread(thread);
-    const message = { id: `picker-${++this.sequence}`, method: 'thread/settings/update', params: { threadId, model, effort } };
-    await this.bridge.prepare(message);
-    const routed = this.menu.request(message);
-    this.menu.pending.delete(message.id);
-    await this.bridge.rpc(message.method, routed.params);
-    this.pins.set(threadId, pin);
-    return { ok: true };
-  }
-  release({ threadId }) {
-    if (typeof threadId !== 'string') throw new Error('请选择任务。');
-    if (threadId === 'next') this.next = null;
-    else this.pins.delete(threadId);
+    if (supported.length && !supported.some(e => e.reasoningEffort === effort)) throw new Error(text('invalidEffort'));
+    await this.configRpc('config/batchWrite', {
+      edits: [
+        { keyPath: 'model', value: model, mergeStrategy: 'upsert' },
+        { keyPath: 'model_reasoning_effort', value: effort, mergeStrategy: 'upsert' }
+      ],
+      reloadUserConfig: true
+    });
+    this.next = { model, effort };
     return { ok: true };
   }
   async listen() {
     const token = randomBytes(32).toString('hex');
     let origin;
     const server = createServer(async (req, res) => {
-      const reply = (code, body, type = 'application/json') => {
-        res.writeHead(code, { 'content-type': `${type}; charset=utf-8`, 'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
-          'referrer-policy': 'no-referrer', 'content-security-policy': "default-src 'none'; script-src 'self'; style-src 'unsafe-inline'; img-src data:; connect-src 'self'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'" });
-        res.end(type === 'application/json' ? JSON.stringify(body) : body);
+      const reply = (code, body) => {
+        res.writeHead(code, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
+          'referrer-policy': 'no-referrer', 'content-security-policy': "default-src 'none'; frame-ancestors 'none'" });
+        res.end(JSON.stringify(body));
       };
       if (req.headers.host !== new URL(origin).host || (req.headers.origin && req.headers.origin !== origin)) return reply(403, { error: '访问来源不匹配。' });
       const chat = this.chats.find(c => req.url?.startsWith(c.path + '/'));
       if (chat) return chat.handle(req, res);
-      if (req.method === 'GET' && ['/', '/picker.js'].includes(req.url)) {
-        const filename = req.url === '/' ? 'picker.html' : 'picker-client.js';
-        return reply(200, readFileSync(new URL(filename, import.meta.url), 'utf8'), req.url === '/' ? 'text/html' : 'text/javascript');
-      }
-      if (req.headers.authorization !== `Bearer ${token}`) return reply(401, { error: '入口已失效，请重新打开模型选择页。' });
+      if (req.headers.authorization !== `Bearer ${token}`) return reply(401, { error: text('expired') });
       try {
         if (req.method === 'GET' && req.url === '/state') return reply(200, await this.serialize(() => this.state()));
-        if (req.method === 'POST' && ['/choose', '/release'].includes(req.url)) {
+        if (req.method === 'POST' && req.url === '/choose') {
           if (req.headers['content-type'] !== 'application/json') return reply(415, { error: '请求格式不正确。' });
           let raw = ''; for await (const data of req) { raw += data; if (raw.length > 8192) return reply(413, { error: '请求过大。' }); }
           const body = JSON.parse(raw);
           if (!body || typeof body !== 'object' || Array.isArray(body)) throw new Error('请求格式不正确。');
-          return reply(200, await this.serialize(() => req.url === '/choose' ? this.choose(body) : this.release(body)));
+          return reply(200, await this.serialize(() => this.choose(body)));
         }
         reply(404, { error: '没有这个操作。' });
       } catch (error) { reply(400, { error: error instanceof SyntaxError ? '请求格式不正确。' : error.message }); }
@@ -134,19 +107,13 @@ export class Picker {
   close() { for (const chat of this.chats) chat.close(); this.server?.closeAllConnections(); this.server?.close(); }
 }
 
-export function openPicker(home) {
-  const active = [];
+export function pickerEndpoints(home) {
+  const endpoints = [];
   for (const run of activeRuns(home)) if (run.version === VERSION) {
-    try { active.push(JSON.parse(readFileSync(join(run.directory, `${run.pid}.picker.json`), 'utf8'))); } catch {}
-  }
-  if (!active.length) return false;
-  // Each native connection has its own set of loaded tasks. Open all active pages
-  // when Desktop has more than one connection, instead of silently picking one.
-  let opened = false;
-  for (const item of active) {
-    if (!Number.isInteger(item.port) || item.port < 1 || item.port > 65535 || !/^[a-f0-9]{64}$/.test(item.token)) continue;
-    execFileSync('/usr/bin/open', [`http://127.0.0.1:${item.port}/#${item.token}`], { stdio: 'ignore' });
-    opened = true;
+    try {
+      const item = JSON.parse(readFileSync(join(run.directory, `${run.pid}.picker.json`), 'utf8'));
+      if (Number.isInteger(item.port) && item.port > 0 && item.port <= 65535 && /^[a-f0-9]{64}$/.test(item.token)) endpoints.push(item);
+    } catch { /* A Desktop connection may close while being read. */ }
   }
-  return opened;
+  return endpoints;
 }

package/src/proxy.mjs

@@ -1,5 +1,6 @@
 import { setting } from './legacy.mjs';
 import { runtimeDirectory } from './runtime.mjs';
+import { randomUUID } from 'node:crypto';
 import { spawn } from 'node:child_process';
 import { join } from 'node:path';
 import { rmSync, existsSync, readFileSync } from 'node:fs';
@@ -102,7 +103,19 @@ export async function runProxy(args, selfPath) {
         catch { route.error = `Profile ${route.profile} 的模型目录无法加载，请检查 model_catalog_json。`; }
       }
     };
-    Object.assign(picker, { bridge: switches, menu, getConfig, serialize, refreshCatalogs });
+    const configRpc = async (method, params) => {
+      // Use the same alias translation and saved provider identity as Desktop.
+      const id = `minilink-picker-${randomUUID()}`;
+      const request = menu.request({ id, method, params });
+      try {
+        const result = await switches.rpc(method, request.params);
+        return menu.response({ id, result }).result;
+      } catch (error) {
+        menu.response({ id, error: { message: error.message } });
+        throw error;
+      }
+    };
+    Object.assign(picker, { bridge: switches, getConfig, serialize, refreshCatalogs, configRpc });
     for (const chat of chats) Object.assign(chat, { bridge: switches, menu });
     present = async message => {
       picker.response(message);
@@ -114,7 +127,7 @@ export async function runProxy(args, selfPath) {
         });
         ready.catch(() => {});
         try { atomicJSON(pickerPath, { pid: process.pid, ...endpoint }); }
-        catch { process.stderr.write('minilink: 独立模型选择页启动失败，原生菜单仍可使用。\n'); }
+        catch { process.stderr.write('minilink: 终端模型选择入口启动失败，原生菜单仍可使用。\n'); }
       }
       const visible = switches.response(message); return visible == null ? null : menu.response(visible);
     };

package/src/terminal.mjs

@@ -0,0 +1,78 @@
+import { createInterface } from 'node:readline/promises';
+
+export const language = (env = process.env) => /^zh(?:[_-]|$)/i.test(env.LC_ALL || env.LC_MESSAGES || env.LANG || '') ? 'zh' : 'en';
+const messages = {
+  help: ['minilink\n\n  on       开启 MiniLink\n  link     选择模型和推理强度\n  off      关闭额外选项和模型接管\n  doctor   检查配置和运行状态\n\n读取现有 profiles。其他 Codex 参数原样透传。', 'minilink\n\n  on       Enable MiniLink\n  link     Select a model and reasoning effort\n  off      Disable extra models and overrides\n  doctor   Check configuration and status\n\nUses existing profiles. Other arguments are forwarded to Codex.'],
+  on: ['minilink on 已开启，请完全退出并重开 Desktop。', 'MiniLink is enabled. Fully quit and reopen Desktop.'],
+  off: ['已关闭。已有任务保留当前提供商。', 'Disabled. Existing tasks keep their current provider.'],
+  unavailable: ['未连接到 Desktop。请在运行 Desktop 的电脑上完全退出并重开 Desktop，然后运行 minilink link。', 'No Desktop connection. On the computer hosting Desktop, fully quit and reopen Desktop, then run minilink link.'],
+  interactive: ['请在交互终端运行 minilink link；SSH 请使用 ssh -t。', 'Run minilink link in an interactive terminal; use ssh -t over SSH.'],
+  multiple: ['检测到多个 Desktop 连接。请只保留一个连接后重试。', 'Multiple Desktop connections are running. Keep one connection open and try again.'],
+  model: ['模型', 'Model'], effort: ['推理强度', 'Reasoning effort'],
+  prompt: ['输入编号', 'Enter a number'], invalid: ['请输入列表中的编号。', 'Enter a number from the list.'],
+  cancelled: ['已取消，未更改模型。', 'Cancelled. Model unchanged.'],
+  done: ['已保存到 config.toml。请完全退出并重开 Desktop，让模型菜单加载已保存的选择。', 'Saved to config.toml. Fully quit and reopen Desktop to load the saved selection in the model menu.'],
+  empty: ['暂无可用模型，请检查连接后重试。', 'No models available. Check your connection and try again.'],
+  disconnected: ['连接已结束，请重新运行 minilink link。', 'Connection closed. Run minilink link again.'],
+  expired: ['连接已失效，请重新运行 minilink link。', 'Connection expired. Run minilink link again.'],
+  catalogLarge: ['模型目录过大，请检查配置。', 'Model catalog is too large. Check your configuration.'],
+  disabled: ['请先运行 minilink on。', 'Run minilink on first.'],
+  missingModel: ['模型已不在目录中，请重新选择。', 'Model is no longer available. Select again.'],
+  invalidEffort: ['请选择该模型支持的推理强度。', 'Select a supported reasoning effort.'],
+  none: ['关闭', 'None'], minimal: ['轻量', 'Minimal'], low: ['低', 'Low'], medium: ['中', 'Medium'], high: ['高', 'High'], xhigh: ['更高', 'Extra high'], ultra: ['极高', 'Ultra'], persistent: ['持续', 'Persistent'], default: ['默认', 'Default']
+};
+export const text = (key, env) => messages[key]?.[language(env) === 'zh' ? 0 : 1] ?? key;
+
+export async function selectModel(endpoints, { input = process.stdin, output = process.stdout, env = process.env } = {}) {
+  const t = key => text(key, env);
+  if (!input.isTTY || !output.isTTY) return t('interactive');
+  if (!endpoints.length) return t('unavailable');
+  if (endpoints.length !== 1) throw new Error(t('multiple'));
+  const { port, token } = endpoints[0];
+  const api = async (path, body) => {
+    let response;
+    try {
+      response = await fetch(`http://127.0.0.1:${port}${path}`, {
+        method: body ? 'POST' : 'GET', signal: AbortSignal.timeout(15000),
+        headers: { Authorization: `Bearer ${token}`, ...(body ? { 'Content-Type': 'application/json' } : {}) },
+        ...(body ? { body: JSON.stringify(body) } : {})
+      });
+    } catch { throw new Error(t('disconnected')); }
+    if (response.status === 401) throw new Error(t('expired'));
+    const data = await response.json();
+    if (!response.ok) throw new Error(data.error || t('disconnected'));
+    return data;
+  };
+  const state = await api('/state');
+  if (!state.models.length) throw new Error(t('empty'));
+  const preferred = state.next ?? state.selected;
+  const rl = createInterface({ input, output });
+  const abort = new AbortController();
+  rl.on('SIGINT', () => abort.abort());
+  rl.on('close', () => abort.abort());
+  // Catalog labels are external data; strip terminal control sequences.
+  const safe = value => String(value).replace(/\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1b\\))|[\x00-\x1f\x7f-\x9f]/g, '');
+  const select = async (label, options, preferred) => {
+    const index = Math.max(0, options.findIndex(item => item.value === preferred));
+    output.write(`\n${label}\n${options.map((item, i) => `  ${i + 1}. ${safe(item.label)}${i === index ? ' *' : ''}`).join('\n')}\n`);
+    while (!abort.signal.aborted) {
+      const answer = (await rl.question(`${t('prompt')} [${index + 1}]: `, { signal: abort.signal })).trim();
+      const choice = answer === '' ? index : /^\d+$/.test(answer) ? Number(answer) - 1 : -1;
+      if (options[choice]) return options[choice].value;
+      output.write(t('invalid') + '\n');
+    }
+    throw new DOMException('Cancelled', 'AbortError');
+  };
+  try {
+    const model = await select(t('model'), state.models.map(m => ({ value: m.model, label: m.name })), preferred?.model);
+    const entry = state.models.find(m => m.model === model);
+    const efforts = entry.efforts || [];
+    const effort = efforts.length > 1 ? await select(t('effort'), efforts.map(e => ({ value: e.reasoningEffort, label: t(e.reasoningEffort) })), preferred?.model === model ? preferred.effort : entry.effort) : efforts[0]?.reasoningEffort ?? null;
+    if (abort.signal.aborted) return t('cancelled');
+    await api('/choose', { model, effort });
+    return t('done');
+  } catch (error) {
+    if (error.name === 'AbortError' || error.code === 'ERR_USE_AFTER_CLOSE') return t('cancelled');
+    throw error;
+  } finally { rl.close(); }
+}

package/src/picker-client.js

@@ -1,74 +0,0 @@
-const $ = id => document.getElementById(id);
-const token = location.hash.slice(1) || sessionStorage.getItem('picker-token');
-if (token) sessionStorage.setItem('picker-token', token);
-history.replaceState(null, '', '/');
-let state, busy = false;
-const effortNames = { none: '关闭', minimal: '轻量', low: '低', medium: '中', high: '高', xhigh: '更高', ultra: '极高', persistent: '持续', default: '默认' };
-const selectedEffort = () => document.querySelector('input[name="effort"]:checked')?.value;
-const currentThread = () => state?.threads.find(t => t.id === $('thread').value);
-const currentPin = () => currentThread()?.pin || ($('thread').value === 'next' ? state?.next : null);
-const say = (text, error = false) => { $('message').textContent = text; $('message').className = `message${error ? ' error' : ''}`; };
-async function api(path, body) {
-  let response;
-  try { response = await fetch(path, { method: body ? 'POST' : 'GET', headers: { Authorization: `Bearer ${token}`, ...(body ? { 'Content-Type': 'application/json' } : {}) }, ...(body ? { body: JSON.stringify(body) } : {}) }); }
-  catch { throw new Error('连接已结束，请重新运行 minilink on。'); }
-  if (response.status === 401) throw new Error('入口已失效，请重新运行 minilink on。');
-  const data = await response.json(); if (!response.ok) throw new Error(data.error || '操作未完成，请重试。'); return data;
-}
-function fill(select, options, selected) {
-  select.replaceChildren(...options.map(([value, text]) => { const option = document.createElement('option'); option.value = value; option.textContent = text; return option; }));
-  if (options.some(([value]) => value === selected)) select.value = selected;
-}
-function controls() {
-  const thread = currentThread(), available = Boolean(state?.models.length);
-  $('form').setAttribute('aria-busy', String(busy));
-  $('refresh').disabled = busy; $('refresh').dataset.loading = String(busy);
-  $('thread').disabled = busy || !state;
-  $('model').disabled = busy || !available;
-  for (const input of $('effort').querySelectorAll('input')) input.disabled = busy || !available;
-  $('apply').disabled = busy || !available || Boolean(thread && thread.status !== 'idle');
-  $('release').disabled = busy || !currentPin();
-}
-function changeModel(preferred) {
-  const model = state.models.find(m => m.model === $('model').value);
-  const values = model?.efforts?.length ? model.efforts.map(e => e.reasoningEffort) : ['default'];
-  const candidate = preferred ?? model?.effort, selected = values.includes(candidate) ? candidate : values[0];
-  if (values.length > 5) $('effort').dataset.columns = values.length > 6 ? '4' : '3';
-  else delete $('effort').dataset.columns;
-  $('effort').replaceChildren(...values.map(value => {
-    const label = document.createElement('label'), input = document.createElement('input');
-    label.className = 'segment'; input.type = 'radio'; input.name = 'effort'; input.value = value; input.checked = value === selected;
-    label.append(input, document.createTextNode(effortNames[value] || value)); return label;
-  }));
-  controls();
-}
-function changeThread(draft) {
-  const thread = currentThread(), pin = currentPin();
-  $('details').textContent = thread ? thread.status !== 'idle' ? '任务正在运行，完成后可切换。' : `${thread.cwd?.split('/').filter(Boolean).pop() || '当前任务'} · ${pin ? '由此页管理' : '由 Desktop 管理'}` : pin ? '已为下一个新任务设置模型。' : '';
-  $('details').title = thread?.cwd || '';
-  fill($('model'), state.models.length ? state.models.map(m => [m.model, m.name]) : [['', '暂无可用模型']], draft?.model || pin?.model || thread?.model);
-  changeModel(draft?.effort ?? pin?.effort);
-}
-async function refresh(preserve = false) {
-  const selected = $('thread').value, draft = preserve && { model: $('model').value, effort: selectedEffort() };
-  state = await api('/state');
-  fill($('thread'), [['next', '下一个新任务'], ...state.threads.map(t => [t.id, t.name.slice(0, 90)])], selected);
-  changeThread($('thread').value === selected ? draft : null);
-  if (!state.models.length) say('暂无可用模型，请检查连接后刷新。', true);
-}
-async function action(operation) {
-  if (busy) return;
-  busy = true; controls(); say('');
-  try { await operation(); } catch (error) { say(error.message || '操作未完成，请重试。', true); }
-  finally { busy = false; controls(); }
-}
-$('thread').onchange = () => { changeThread(); say(''); };
-$('model').onchange = () => { changeModel(); say(''); };
-$('refresh').onclick = () => action(() => refresh(true));
-$('form').onsubmit = event => { event.preventDefault(); action(async () => {
-  const effort = selectedEffort();
-  await api('/choose', { threadId: $('thread').value, model: $('model').value, effort: effort === 'default' ? null : effort });
-  await refresh(); say('已设置，回到 Desktop 继续。');
-}); };
-$('release').onclick = () => action(async () => { await api('/release', { threadId: $('thread').value }); await refresh(); say('已交回 Desktop。'); });
-action(refresh);

package/src/picker.html

@@ -1,39 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="color-scheme" content="light dark">
-<title>选择模型 · minilink</title>
-<link rel="icon" href="data:,">
-<style>
-:root{font:14px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC",sans-serif;color:#1d1d1f;background:#f5f5f7;color-scheme:light dark;--surface:#fff;--control:#f5f5f7;--line:#e8e8ed;--muted:#6e6e73;--accent:#007aff;--focus:#007aff55;--selected:#fff;--error:#c9342e;--success:#248a3d}
-*{box-sizing:border-box}body{margin:0;min-height:100svh;display:grid;place-items:center;padding:40px 20px;-webkit-font-smoothing:antialiased}main{width:min(100%,520px)}.panel{padding:26px 28px 22px;background:var(--surface);border:1px solid var(--line);border-radius:16px;box-shadow:0 4px 24px #00000004}.toolbar{display:flex;align-items:center;justify-content:space-between;margin-bottom:24px}.brand{font-size:19px;font-weight:650;letter-spacing:-.6px}button,select,input{font:inherit}button{cursor:pointer}button:disabled{cursor:default}button,select{transition:background .15s,box-shadow .15s,opacity .15s}button:focus-visible,select:focus-visible,.segment:has(input:focus-visible){outline:3px solid var(--focus);outline-offset:3px}.refresh{width:30px;height:30px;display:grid;place-items:center;padding:0;border:1px solid var(--line);border-radius:8px;color:var(--muted);background:var(--surface)}.refresh:hover:not(:disabled){background:var(--control);color:inherit}.refresh svg{width:16px;height:16px;fill:none;stroke:currentColor;stroke-width:1.6;stroke-linecap:round;stroke-linejoin:round}.refresh[data-loading=true] svg{animation:rotate 1s linear infinite}h1{margin:0;font-size:22px;line-height:1.3;font-weight:650;letter-spacing:-.6px}.subtitle{margin:7px 0 22px;color:var(--muted);font-size:13px}.fields{border-top:1px solid var(--line)}.field{padding:15px 0;border-bottom:1px solid var(--line)}.field>label,.effort-title{display:block;margin-bottom:8px;font-size:13px;font-weight:600}.select-wrap{position:relative}.select-wrap svg{position:absolute;right:12px;top:11px;width:16px;height:16px;fill:none;stroke:var(--muted);stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;pointer-events:none}select{appearance:none;-webkit-appearance:none;display:block;width:100%;min-width:0;height:38px;padding:0 34px 0 12px;border:1px solid var(--line);border-radius:8px;background:var(--control);color:inherit;text-overflow:ellipsis}select:disabled{opacity:.5}.details{margin:9px 1px 0;font-size:12px;color:var(--muted);overflow-wrap:anywhere}.details:empty{display:none}.effort-row{display:flex;align-items:center;justify-content:space-between;gap:16px;min-height:62px}.effort-title{margin:0;flex-shrink:0}.segments{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:2px;padding:3px;border-radius:9px;background:var(--control);max-width:100%;min-width:156px}.segments[data-columns]{display:grid;min-width:198px;grid-template-columns:repeat(4,minmax(0,1fr))}.segments[data-columns="3"]{grid-template-columns:repeat(3,minmax(0,1fr))}.segments[data-columns] .segment{min-width:0;padding-inline:7px}.segment{position:relative;display:flex;align-items:center;justify-content:center;min-height:28px;min-width:46px;flex:1;padding:3px 10px;border-radius:6px;color:var(--muted);font-size:12px;white-space:nowrap;cursor:pointer}.segment input{position:absolute;opacity:0;width:1px;height:1px}.segment:has(input:checked){background:var(--selected);color:#1d1d1f;box-shadow:0 1px 4px #00000012}.segment:has(input:disabled){cursor:default;opacity:.5}.actions{padding-top:22px}.apply{width:100%;min-height:38px;border:0;border-radius:8px;background:var(--accent);color:#fff;font-size:13px;font-weight:600}.apply:hover:not(:disabled){background:#0071e3}.apply:active:not(:disabled){background:#0065cc}.apply:disabled{opacity:.4}.release{display:block;margin:12px auto 0;padding:5px 12px;border:0;border-radius:6px;background:transparent;color:var(--muted);font-size:12px}.release:hover:not(:disabled){color:var(--accent);background:var(--control)}.release:disabled{opacity:.45}.message{margin:14px 0 0;font-size:12px;color:var(--success);text-align:center;overflow-wrap:anywhere}.message:empty{display:none}.message.error{color:var(--error)}footer{margin-top:16px;text-align:center;color:var(--muted);font-size:12px}footer p{margin:0}
-@keyframes rotate{to{transform:rotate(360deg)}}
-@media(max-width:480px){body{padding:24px 16px}.panel{padding:22px 20px 18px}.toolbar{margin-bottom:22px}.effort-row{gap:10px;flex-wrap:wrap}.segments{min-width:144px}.segment{min-width:38px;padding-inline:8px}}
-@media(prefers-color-scheme:dark){:root{background:#161618;color:#f5f5f7;--surface:#242426;--control:#303033;--line:#3a3a3d;--muted:#a1a1a6;--accent:#0a84ff;--focus:#0a84ff77;--selected:#56565b;--error:#ff6961;--success:#6bd68b}.panel{box-shadow:0 8px 32px #00000016}.segment:has(input:checked){color:#fff}.apply:hover:not(:disabled){background:#2994ff}}
-@media(prefers-reduced-motion:reduce){*,*:before,*:after{animation:none!important;transition:none!important}}
-</style>
-</head>
-<body>
-<main>
-<section class="panel" aria-labelledby="title">
-<header>
-<div class="toolbar"><span class="brand">minilink</span><button id="refresh" class="refresh" type="button" aria-label="刷新" title="刷新" disabled><svg viewBox="0 0 20 20" aria-hidden="true"><path d="M16 7A6.3 6.3 0 1 0 16 13M16 3v4h-4"/></svg></button></div>
-<h1 id="title">选择模型</h1><p class="subtitle">为下一条回复选择模型。</p>
-</header>
-<form id="form" aria-busy="true">
-<div class="fields">
-<div class="field"><label for="thread">任务</label><div class="select-wrap"><select id="thread" aria-describedby="details" required disabled><option>正在连接…</option></select><svg viewBox="0 0 16 16" aria-hidden="true"><path d="m4 6 4 4 4-4"/></svg></div><p id="details" class="details"></p></div>
-<div class="field"><label for="model">模型</label><div class="select-wrap"><select id="model" required disabled><option>正在读取模型…</option></select><svg viewBox="0 0 16 16" aria-hidden="true"><path d="m4 6 4 4 4-4"/></svg></div></div>
-<div class="field effort-row"><span id="effort-label" class="effort-title">推理强度</span><div id="effort" class="segments" role="radiogroup" aria-labelledby="effort-label"></div></div>
-</div>
-<div class="actions"><button id="apply" class="apply" type="submit" disabled>使用此模型</button><button id="release" class="release" type="button" disabled>交回 Desktop</button></div>
-<p id="message" class="message" role="status" aria-live="polite"></p>
-</form>
-</section>
-<footer><p>设置后，回到 Desktop 继续。</p></footer>
-</main>
-<script src="/picker.js"></script>
-</body>
-</html>