@ailuntz/minilink 0.9.7 → 0.9.8

package/README.md

@@ -15,18 +15,16 @@
 
 需 Node.js ≥22.16，并已安装 Desktop。
 
-macOS：
+macOS / Windows / Linux：
 
 ```sh
-npm install -g @ailuntz/minilink --allow-scripts=@ailuntz/minilink
+npm install -g @ailuntz/minilink
 minilink on
 ```
 
 完全退出并重开 Desktop。
 
-npm 11 默认可能跳过全局包的安装脚本；上面的单次许可让 MiniLink 完成 Desktop 接入，不会永久允许其他包的脚本。
-
-Windows / Linux 的模型路由和 Desktop 连接已通过手动启动桥验证；当前 npm 包的自动安装脚本仅实现 macOS，不能使用上述命令完成 Windows / Linux 的桌面接入。
+`npm install` 只安装命令；`minilink on` 才接入 Desktop。更新包后再次运行 `minilink on`。
 
 ## 命令
 
@@ -34,12 +32,12 @@ Windows / Linux 的模型路由和 Desktop 连接已通过手动启动桥验证
 | --- | --- |
 | `minilink on` | 开启 |
 | `minilink link` | 选择模型与推理强度 |
-| `minilink off` | 关闭；macOS 同时撤销后续 Desktop 启动的 MiniLink 覆盖 |
+| `minilink off` | 关闭，并撤销后续 Desktop 启动的 MiniLink 覆盖 |
 | `minilink doctor` | 检查配置与运行状态 |
 
 通过 `minilink link` 保存选择后，完全退出并重开 Desktop。
 
-macOS 上 `off` 会让后续启动直接使用 Desktop 自带的 Codex；`on` 会重新接入 MiniLink。已打开的 Desktop 需要完全退出并重开，才会切换启动方式。MiniLink 使用 ChatGPT 当前内置的 `Resources/codex-cli/CodexCLI.app/Contents/MacOS/codex`。
+`off` 会让后续启动直接使用 Desktop 自带的 Codex；`on` 会重新接入 MiniLink。已打开的 Desktop 需要完全退出并重开，才会切换启动方式。
 
 ## 配置
 
@@ -51,9 +49,10 @@ macOS 上 `off` 会让后续启动直接使用 Desktop 自带的 Codex；`on`
 
 ## 卸载
 
-macOS：
+先运行 `minilink off`，再卸载：
 
 ```sh
+minilink off
 npm uninstall -g @ailuntz/minilink
 ```
 

package/bin/minilink.mjs

@@ -6,7 +6,7 @@ import { startUpdate, updateStatus } from '../src/update.mjs';
 import { runProxy } from '../src/proxy.mjs';
 import { pickerEndpoints } from '../src/picker.mjs';
 import { selectModel, text, language } from '../src/terminal.mjs';
-import { installation, environmentStatus, syncLaunchEnvironment } from '../src/install.mjs';
+import { installation, environmentStatus, syncLaunchEnvironment, ensureInstalled } from '../src/install.mjs';
 
 const self = fileURLToPath(import.meta.url), args = process.argv.slice(2);
 const commands = ['on', 'link', 'off', 'doctor'];
@@ -19,7 +19,7 @@ async function main() {
   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();
+    if (command === 'on') { discoverProfiles(); ensureInstalled(); }
     atomicJSON(configPath(), { version: 1, enabled: command === 'on' });
     syncLaunchEnvironment({ enabled: command === 'on' });
     return output(text(command));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ailuntz/minilink",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "description": "Use your Codex profiles in the Desktop model menu.",
   "type": "module",
   "license": "MIT AND Apache-2.0",
@@ -18,8 +18,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test test/*.test.mjs",
-    "postinstall": "node src/lifecycle.mjs postinstall"
+    "test": "node --test test/*.test.mjs"
   },
   "dependencies": {
     "smol-toml": "1.8.0"

package/src/config.mjs

@@ -1,7 +1,8 @@
-import { readFileSync, readdirSync, mkdirSync, writeFileSync, renameSync, rmSync, existsSync, realpathSync, accessSync, constants } from 'node:fs';
+import { readFileSync, readdirSync, mkdirSync, writeFileSync, renameSync, rmSync, existsSync, realpathSync, accessSync, constants, statSync, copyFileSync, mkdtempSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve, join, dirname, isAbsolute } from 'node:path';
-import { randomUUID } from 'node:crypto';
+import { randomUUID, createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
 import { parseEnv } from 'node:util';
 import { parse } from 'smol-toml';
 import { setting } from './legacy.mjs';
@@ -65,6 +66,37 @@ export function discoverProfiles(home = codexHome()) {
 
 export const bundledCodexRelativePath = 'Contents/Resources/codex-cli/CodexCLI.app/Contents/MacOS/codex';
 export const bundledCodex = app => join(app, bundledCodexRelativePath);
+const windowsExecutables = ['codex.exe', 'codex-code-mode-host.exe', 'codex-windows-sandbox-setup.exe', 'codex-command-runner.exe'];
+function windowsCodex() {
+  const packageRoot = execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', '(Get-AppxPackage OpenAI.Codex).InstallLocation'], { encoding: 'utf8' }).trim();
+  if (!packageRoot) throw new Error('找不到 ChatGPT Windows 应用。');
+  const resources = join(packageRoot, 'app/resources');
+  const files = windowsExecutables.map(name => ({ name, source: join(resources, name) }));
+  const digest = createHash('sha256');
+  for (const file of files) {
+    if (!statSync(file.source).isFile()) throw new Error('ChatGPT 内置 Codex 文件无效。');
+    file.hash = createHash('sha256').update(readFileSync(file.source)).digest('hex');
+    digest.update(file.name).update('\0').update(file.hash).update('\0');
+  }
+  const root = join(process.env.LOCALAPPDATA || join(homedir(), 'AppData/Local'), 'OpenAI/Codex/bin');
+  const version = digest.digest('hex').slice(0, 16), destination = join(root, version);
+  if (!files.every(file => existsSync(join(destination, file.name)) && createHash('sha256').update(readFileSync(join(destination, file.name))).digest('hex') === file.hash)) {
+    mkdirSync(root, { recursive: true });
+    if (existsSync(destination)) rmSync(destination, { recursive: true });
+    const staging = mkdtempSync(join(root, `.staging-${version}-`));
+    try {
+      for (const file of files) copyFileSync(file.source, join(staging, file.name));
+      renameSync(staging, destination);
+    } finally { rmSync(staging, { recursive: true, force: true }); }
+  }
+  return join(destination, 'codex.exe');
+}
+export function officialCodex(platform = process.platform) {
+  if (platform === 'darwin') return bundledCodex(process.env.CODEX_DESKTOP_APP || '/Applications/ChatGPT.app');
+  if (platform === 'linux') return join(process.env.CODEX_DESKTOP_RESOURCES || '/usr/lib/chatgpt/resources', 'codex');
+  if (platform === 'win32') return windowsCodex();
+  return null;
+}
 
 export function findApp() {
   const app = process.env.CODEX_DESKTOP_APP || '/Applications/ChatGPT.app';
@@ -72,8 +104,7 @@ export function findApp() {
 }
 
 export function resolveRealCodex(selfPath) {
-  const app = findApp();
-  const candidate = setting('REAL_CODEX') || (app && bundledCodex(app));
+  const candidate = setting('REAL_CODEX') || officialCodex();
   if (!candidate || !isAbsolute(candidate)) throw new Error('找不到内置 Codex；可用 MINILINK_REAL_CODEX 指定绝对路径。');
   let actual;
   try { actual = realpathSync(candidate); accessSync(actual, constants.X_OK); } catch { throw new Error('真正的 Codex 不存在或不可执行。'); }

package/src/install.mjs

@@ -5,7 +5,7 @@ import { execFileSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { activeRuns } from './runtime.mjs';
 import { legacyInstallation } from './legacy.mjs';
-import { atomicJSON, configPath, codexHome, readConfig, bundledCodexRelativePath } from './config.mjs';
+import { VERSION, atomicJSON, configPath, codexHome, readConfig, resolveRealCodex, bundledCodexRelativePath } from './config.mjs';
 
 const label = 'com.ailuntz.minilink';
 export const installRoot = () => join(homedir(), '.local/share/minilink');
@@ -18,9 +18,26 @@ export function installation(root = installRoot()) {
   try { return JSON.parse(readFileSync(join(root, 'installation.json'), 'utf8')); } catch (e) { if (e.code === 'ENOENT') return null; throw new Error('安装状态损坏，请检查 installation.json。'); }
 }
 
+export function ensureInstalled({ state = installation(), source = sourceRoot, activate = installDesktop } = {}) {
+  try {
+    if (state?.source === source && JSON.parse(readFileSync(join(state.runtime, 'package.json'), 'utf8')).version === VERSION) return state;
+  } catch {}
+  return activate();
+}
+
+function npmDetails() {
+  try {
+    const npm = execFileSync('/usr/bin/which', ['npm'], { encoding: 'utf8' }).trim();
+    const prefix = execFileSync(npm, ['prefix', '-g'], { encoding: 'utf8' }).trim();
+    return { npm, prefix };
+  } catch { return {}; }
+}
+
 // A disabled integration must not remain in Desktop's launch path. The login
 // agent reapplies this state in the Aqua session when the command ran over SSH.
 export function syncLaunchEnvironment({ state = installation(), run = launchctl, enabled, previousWrapper } = {}) {
+  if (process.platform === 'linux') return syncLinux({ state, enabled });
+  if (process.platform === 'win32') return syncWindows({ state, enabled });
   if (process.platform !== 'darwin' || !state?.wrapper) return;
   if (enabled == null) {
     try { enabled = readConfig(state.configPath).enabled; } catch { enabled = false; }
@@ -40,11 +57,80 @@ function atomicFile(path, text, mode) {
   finally { rmSync(temporary, { force: true }); }
 }
 
+export function installDesktop(options) {
+  if (process.platform === 'darwin') return install(options);
+  if (process.platform === 'linux') return installLinux(options);
+  if (process.platform === 'win32') return installWindows(options);
+  throw new Error('不支持此操作系统。');
+}
+
+const linuxLauncher = () => join(homedir(), '.local/share/applications/chatgpt.desktop');
+const linuxOwner = '# MiniLink desktop integration';
+
+function syncLinux({ state = installation(), enabled } = {}) {
+  if (!state?.wrapper) return;
+  if (enabled == null) enabled = readConfig(state.configPath).enabled;
+  const launcher = linuxLauncher();
+  const current = existsSync(launcher) ? readFileSync(launcher, 'utf8') : null;
+  if (current && !current.startsWith(linuxOwner)) throw new Error('用户级 ChatGPT 启动器已存在，无法接入 MiniLink。');
+  if (!enabled) { if (current) rmSync(launcher); return; }
+  const base = readFileSync('/usr/share/applications/chatgpt.desktop', 'utf8');
+  if (!/^Exec=chatgpt %U$/m.test(base)) throw new Error('ChatGPT 启动器格式已改变。');
+  const wrapper = state.wrapper.replaceAll('\\', '\\\\').replaceAll('"', '\\"');
+  const content = `${linuxOwner}\n${base.replace(/^Exec=chatgpt %U$/m, `Exec=env CODEX_CLI_PATH="${wrapper}" /usr/bin/chatgpt %U`)}`;
+  mkdirSync(dirname(launcher), { recursive: true });
+  atomicFile(launcher, content, 0o644);
+}
+
+function installLinux({ root = installRoot(), source = sourceRoot, home = codexHome(), config = configPath(), node = process.execPath } = {}) {
+  const native = resolveRealCodex(join(source, 'bin/minilink.mjs'));
+  const launcher = linuxLauncher();
+  if (existsSync(launcher) && !readFileSync(launcher, 'utf8').startsWith(linuxOwner)) throw new Error('用户级 ChatGPT 启动器已存在，无法接入 MiniLink。');
+  const wrapper = join(root, 'minilink');
+  mkdirSync(root, { recursive: true, mode: 0o700 });
+  atomicFile(wrapper, `#!/bin/sh\nif [ ! -f ${shellQuote(join(source, 'package.json'))} ]; then exec ${shellQuote(native)} "$@"; fi\nexport CODEX_HOME=${shellQuote(home)}\nexport MINILINK_CONFIG=${shellQuote(config)}\nexec ${shellQuote(node)} ${shellQuote(join(source, 'bin/minilink.mjs'))} "$@"\n`, 0o755);
+  const state = { version: 3, platform: 'linux', source, runtime: source, wrapper, node, codexHome: home, configPath: config, installedAt: new Date().toISOString() };
+  atomicJSON(join(root, 'installation.json'), state);
+  return state;
+}
+
+const psQuote = value => "'" + value.replaceAll("'", "''") + "'";
+const powershell = command => execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', command], { encoding: 'utf8' }).trim();
+const windowsEnvironment = () => powershell("[Environment]::GetEnvironmentVariable('CODEX_CLI_PATH','User')") || null;
+function setWindowsEnvironment(value) {
+  const broadcast = 'using System; using System.Runtime.InteropServices; public class MiniLinkBroadcast { [DllImport("user32.dll", CharSet=CharSet.Auto)] public static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, IntPtr wParam, string lParam, uint flags, uint timeout, out IntPtr result); }';
+  powershell(`[Environment]::SetEnvironmentVariable('CODEX_CLI_PATH',${value == null ? '$null' : psQuote(value)},'User'); Add-Type -TypeDefinition ${psQuote(broadcast)}; $result=[IntPtr]::Zero; [MiniLinkBroadcast]::SendMessageTimeout([IntPtr]65535,26,[IntPtr]::Zero,'Environment',2,5000,[ref]$result) | Out-Null`);
+}
+
+function syncWindows({ state = installation(), enabled } = {}) {
+  if (!state?.wrapper) return;
+  if (enabled == null) enabled = readConfig(state.configPath).enabled;
+  const current = windowsEnvironment();
+  if (enabled) {
+    if (current && current !== state.wrapper) throw new Error('CODEX_CLI_PATH 已指向其他程序。');
+    if (!current) setWindowsEnvironment(state.wrapper);
+  } else if (current === state.wrapper) setWindowsEnvironment(state.previousEnv || null);
+}
+
+function installWindows({ root = installRoot(), source = sourceRoot, home = codexHome(), config = configPath(), node = process.execPath } = {}) {
+  const native = resolveRealCodex(join(source, 'bin/minilink.mjs'));
+  const previous = installation(root), wrapper = join(root, 'MiniLinkLauncher.exe');
+  const current = windowsEnvironment();
+  if (current && current !== wrapper) throw new Error('CODEX_CLI_PATH 已指向其他程序。');
+  mkdirSync(root, { recursive: true, mode: 0o700 });
+  if (!existsSync(wrapper)) powershell(`Add-Type -Path ${psQuote(join(source, 'src/platform/windows/MiniLinkLauncher.cs'))} -OutputAssembly ${psQuote(wrapper)} -OutputType ConsoleApplication`);
+  atomicFile(join(root, 'launcher.paths'), [node, join(source, 'bin/minilink.mjs'), native, home, config].join('\n') + '\n', 0o600);
+  const state = { version: 3, platform: 'win32', source, runtime: source, wrapper, node, codexHome: home, configPath: config, previousEnv: previous?.previousEnv || null, installedAt: new Date().toISOString() };
+  atomicJSON(join(root, 'installation.json'), state);
+  return state;
+}
+
 // Each installation has its own files: active Desktop processes keep their
 // original modules and picker assets while the next launch uses the new copy.
 export function install({ root = installRoot(), plist = defaultPlist(), source = sourceRoot, home = codexHome(), config = configPath(), node = process.execPath, npm = process.env.npm_execpath, prefix = process.env.npm_config_prefix, run = launchctl, legacy = root === installRoot() ? legacyInstallation() : null } = {}) {
   if (process.platform !== 'darwin') throw new Error('Desktop 接入目前仅支持 macOS。');
   const previous = installation(root), wrapper = join(root, 'minilink');
+  const packageManager = npm && prefix ? { npm, prefix } : previous?.npm && previous?.prefix ? { npm: previous.npm, prefix: previous.prefix } : npmDetails();
   if (existsSync(plist) && !previous) throw new Error('同名 LaunchAgent 已存在且不属于本次安装。');
   const env = run(['getenv', 'CODEX_CLI_PATH'], false) || null;
   if (env && env !== wrapper && env !== legacy?.state.wrapper) throw new Error('CODEX_CLI_PATH 已指向其他程序，请先移除该覆盖。');
@@ -75,7 +161,7 @@ export function install({ root = installRoot(), plist = defaultPlist(), source =
     }
     if (JSON.parse(readFileSync(join(dependency, 'package.json'), 'utf8')).name !== 'smol-toml') throw new Error('smol-toml 依赖路径无效。');
     cpSync(dependency, join(runtime, 'node_modules/smol-toml'), { recursive: true });
-    const state = { version: 2, source, runtime, wrapper, node, npm: npm || previous?.npm, prefix: prefix || previous?.prefix, codexHome: home, configPath: config, previousEnv: previous?.previousEnv || legacy?.state.previousEnv || null, installedAt: new Date().toISOString() };
+    const state = { version: 2, source, runtime, wrapper, node, npm: packageManager.npm || previous?.npm, prefix: packageManager.prefix || previous?.prefix, codexHome: home, configPath: config, previousEnv: previous?.previousEnv || legacy?.state.previousEnv || null, installedAt: new Date().toISOString() };
     // A Desktop process can retain this launcher after npm removes the state.
     const fallback = `if [ ! -f ${shellQuote(stateFile)} ]; then\n  exec "\${CODEX_DESKTOP_APP:-/Applications/ChatGPT.app}/${bundledCodexRelativePath}" "$@"\nfi`;
     atomicFile(wrapper, `#!/bin/sh\n${fallback}\nexport CODEX_HOME=${shellQuote(home)}\nexport MINILINK_CONFIG=${shellQuote(config)}\nexec ${shellQuote(node)} ${shellQuote(join(runtime, 'bin/minilink.mjs'))} "$@"\n`, 0o755);
@@ -149,4 +235,9 @@ export function reconcile({ root = installRoot(), plist = defaultPlist(), run =
   run(['bootout', `gui/${process.getuid()}/${label}`], false);
 }
 
-export function environmentStatus() { return process.platform === 'darwin' ? launchctl(['getenv', 'CODEX_CLI_PATH'], false) || null : null; }
+export function environmentStatus() {
+  if (process.platform === 'darwin') return launchctl(['getenv', 'CODEX_CLI_PATH'], false) || null;
+  if (process.platform === 'linux') return existsSync(linuxLauncher()) && readFileSync(linuxLauncher(), 'utf8').startsWith(linuxOwner) ? installation()?.wrapper : null;
+  if (process.platform === 'win32') return windowsEnvironment();
+  return null;
+}

package/src/lifecycle.mjs

@@ -1,10 +1,8 @@
-import { install, reconcile } from './install.mjs';
+import { installDesktop, reconcile } from './install.mjs';
 
-if (process.argv[2] === 'postinstall') {
-  if (process.env.npm_config_global === 'true') {
-    try { install(); }
-    catch (error) { process.stderr.write(`minilink: ${error.message}\n`); process.exitCode = 1; }
-  }
+if (process.argv[2] === 'activate') {
+  try { installDesktop(); }
+  catch (error) { process.stderr.write(`minilink: ${error.message}\n`); process.exitCode = 1; }
 } else {
   try { reconcile(); } catch { /* Login and uninstall checks stay silent. */ }
 }

package/src/platform/windows/MiniLinkLauncher.cs

@@ -0,0 +1,50 @@
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Linq;
+using System.Threading.Tasks;
+
+class MiniLinkLauncher {
+  static void Pump(Stream input, Stream output) {
+    byte[] buffer = new byte[4096];
+    int count;
+    while ((count = input.Read(buffer, 0, buffer.Length)) > 0) {
+      output.Write(buffer, 0, count);
+      output.Flush();
+    }
+  }
+
+  static string Quote(string arg) {
+    return "\"" + System.Text.RegularExpressions.Regex.Replace(arg, "(\\\\*)\"", "$1$1\\\"").TrimEnd('\\')
+      + new string('\\', arg.Reverse().TakeWhile(c => c == '\\').Count() * 2) + "\"";
+  }
+
+  static int Main(string[] args) {
+    try {
+      string root = Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location);
+      string[] paths = File.ReadAllLines(Path.Combine(root, "launcher.paths"));
+      bool linked = File.Exists(paths[1]);
+      var info = new ProcessStartInfo(linked ? paths[0] : paths[2]);
+      info.Arguments = String.Join(" ", (linked ? new[] { paths[1] }.Concat(args) : args).Select(Quote));
+      info.UseShellExecute = false;
+      info.CreateNoWindow = true;
+      info.RedirectStandardInput = true;
+      info.RedirectStandardOutput = true;
+      info.RedirectStandardError = true;
+      info.EnvironmentVariables["CODEX_HOME"] = paths[3];
+      info.EnvironmentVariables["MINILINK_CONFIG"] = paths[4];
+      if (!linked) info.EnvironmentVariables.Remove("CODEX_CLI_PATH");
+      using (var process = Process.Start(info)) {
+        Task.Run(() => { try { Pump(Console.OpenStandardInput(), process.StandardInput.BaseStream); process.StandardInput.Close(); } catch {} });
+        var output = Task.Run(() => Pump(process.StandardOutput.BaseStream, Console.OpenStandardOutput()));
+        var error = Task.Run(() => Pump(process.StandardError.BaseStream, Console.OpenStandardError()));
+        process.WaitForExit();
+        Task.WaitAll(output, error);
+        return process.ExitCode;
+      }
+    } catch (Exception error) {
+      Console.Error.WriteLine("minilink launcher: " + error.Message);
+      return 1;
+    }
+  }
+}

package/src/update.mjs

@@ -61,7 +61,8 @@ export async function upgrade(latest, state, { root = installRoot(), exec = exec
     // A manual uninstall during the download must not be undone by the worker.
     if (!existsSync(state.source) || installation(root)?.installedAt !== state.installedAt) return false;
     installing = true;
-    await npm(['install', '-g', '--prefix', state.prefix, candidate, '--offline', '--engine-strict', `--allow-scripts=${name}`]);
+    await npm(['install', '-g', '--prefix', state.prefix, candidate, '--offline', '--engine-strict', '--ignore-scripts']);
+    await exec(state.node, [join(state.source, 'src/lifecycle.mjs'), 'activate'], { env, cwd: directory, timeout: 30000 });
     const active = installation(root);
     if (!active?.runtime || JSON.parse(readFileSync(join(active.runtime, 'package.json'), 'utf8')).version !== latest) throw new Error('Desktop activation failed');
     return true;