axon-code 2.4.0

package/dist/utils/platform.js

@@ -0,0 +1,748 @@
+/**
+ * 跨平台工具模块
+ * 处理 Windows/macOS/Linux 平台差异
+ */
+import * as os from 'os';
+import * as path from 'path';
+import * as fs from 'fs';
+import { spawn, execSync, spawnSync } from 'child_process';
+export function getPlatform() {
+    switch (os.platform()) {
+        case 'win32':
+            return 'windows';
+        case 'darwin':
+            return 'macos';
+        case 'linux':
+            return 'linux';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * 检查是否为 Windows 平台
+ */
+export function isWindows() {
+    return os.platform() === 'win32';
+}
+/**
+ * 检查是否为 macOS 平台
+ */
+export function isMacOS() {
+    return os.platform() === 'darwin';
+}
+/**
+ * 检查是否为 Linux 平台
+ */
+export function isLinux() {
+    return os.platform() === 'linux';
+}
+/**
+ * 检查是否在 WSL 环境中运行
+ */
+export function isWSL() {
+    if (os.platform() !== 'linux')
+        return false;
+    try {
+        // 检查 /proc/version 是否包含 Microsoft 或 WSL
+        const version = fs.readFileSync('/proc/version', 'utf-8').toLowerCase();
+        return version.includes('microsoft') || version.includes('wsl');
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查是否在 Windows 上使用 Windows NPM (而非 WSL NPM)
+ */
+export function isWindowsNpmInWSL() {
+    if (!isWSL())
+        return false;
+    // 检查当前可执行文件路径是否在 /mnt/c 或 /mnt/d 等
+    const execPath = process.execPath;
+    return execPath.startsWith('/mnt/');
+}
+// ============================================================================
+// 路径处理
+// ============================================================================
+/**
+ * 获取用户主目录
+ */
+export function getHomeDir() {
+    return os.homedir();
+}
+/**
+ * 获取配置目录 (~/.axon 或 %USERPROFILE%\.axon)
+ */
+export function getConfigDir() {
+    const home = getHomeDir();
+    return path.join(home, '.axon');
+}
+/**
+ * 获取会话存储目录
+ */
+export function getSessionsDir() {
+    return path.join(getConfigDir(), 'sessions');
+}
+/**
+ * 获取临时目录
+ * 支持 AXON_TMPDIR 环境变量覆盖
+ */
+export function getTempDir() {
+    if (process.env.AXON_TMPDIR) {
+        return process.env.AXON_TMPDIR;
+    }
+    if (isWindows()) {
+        return process.env.TEMP || 'C:\\Temp';
+    }
+    return '/tmp';
+}
+/**
+ * 获取安全的临时目录路径（用于 shell 命令）
+ * 在 Windows 上，临时目录路径可能包含 \t 或 \n 这样的字符序列，
+ * 这些会被 shell 误解为转义序列（制表符或换行符）。
+ * 此函数确保路径在传递给 shell 时是安全的。
+ */
+export function getSafeTempDir() {
+    const tmpDir = getTempDir();
+    // 在 Windows 上，使用正斜杠来避免反斜杠被误解为转义序列
+    // 或者对反斜杠进行双重转义
+    if (isWindows()) {
+        // 使用 path.normalize 确保路径正确，然后转换为正斜杠
+        return path.normalize(tmpDir).replace(/\\/g, '/');
+    }
+    return tmpDir;
+}
+/**
+ * 转义路径中的特殊字符，使其可以安全地在 shell 命令中使用
+ * 主要用于 Windows 上防止 \t, \n 等被误解为转义序列
+ */
+export function escapePathForShell(filePath) {
+    if (isWindows()) {
+        // 在 Windows 上，将反斜杠替换为正斜杠
+        // 这在大多数情况下都能正常工作（包括 Git Bash, PowerShell 等）
+        return filePath.replace(/\\/g, '/');
+    }
+    return filePath;
+}
+/**
+ * 双重转义路径中的反斜杠，用于需要在字符串中保留原始反斜杠的场景
+ * 例如：C:\Users\Test 变成 C:\\Users\\Test
+ */
+export function doubleEscapeBackslashes(filePath) {
+    return filePath.replace(/\\/g, '\\\\');
+}
+/**
+ * 规范化路径（处理斜杠方向）
+ */
+export function normalizePath(filePath) {
+    // 使用 path.normalize 处理路径
+    return path.normalize(filePath);
+}
+/**
+ * 将 Windows 路径转换为 Unix 风格（用于显示）
+ */
+export function toUnixPath(filePath) {
+    return filePath.replace(/\\/g, '/');
+}
+/**
+ * 将 Unix 路径转换为当前平台风格
+ */
+export function toPlatformPath(filePath) {
+    if (isWindows()) {
+        return filePath.replace(/\//g, '\\');
+    }
+    return filePath;
+}
+/**
+ * 解析环境变量路径（支持 %VAR% 和 $VAR 格式）
+ */
+export function expandEnvPath(filePath) {
+    let result = filePath;
+    // 处理 Windows 格式 %VAR%
+    result = result.replace(/%([^%]+)%/g, (_, varName) => {
+        return process.env[varName] || '';
+    });
+    // 处理 Unix 格式 $VAR 和 ${VAR}
+    result = result.replace(/\$\{([^}]+)\}/g, (_, varName) => {
+        return process.env[varName] || '';
+    });
+    result = result.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, varName) => {
+        return process.env[varName] || '';
+    });
+    // 处理 ~ 开头的路径
+    if (result.startsWith('~')) {
+        result = path.join(getHomeDir(), result.slice(1));
+    }
+    return result;
+}
+/**
+ * 确保路径使用正确的分隔符
+ */
+export function ensureCorrectSeparator(filePath) {
+    if (isWindows()) {
+        // Windows: 保留驱动器号，转换斜杠
+        return filePath.replace(/\//g, '\\');
+    }
+    else {
+        // Unix: 转换反斜杠为正斜杠
+        return filePath.replace(/\\/g, '/');
+    }
+}
+/**
+ * 将 MSYS/Git Bash 路径转换为 Windows 路径
+ *
+ * Git Bash 输出的路径格式为 /c/Users/... 或 /f/axon/...
+ * Node.js 的 fs 模块不认识这种格式（会解释为 C:\c\Users\...），需要转换为 C:/Users/...
+ *
+ * 匹配规则：以 / 开头，紧跟单个字母，再跟 /
+ * 例如：/f/axon → F:/axon
+ */
+export function fromMsysPath(filePath) {
+    if (!isWindows())
+        return filePath;
+    // /x/... → X:/...
+    const match = filePath.match(/^\/([a-zA-Z])(\/.*)/);
+    if (match) {
+        return match[1].toUpperCase() + ':' + match[2];
+    }
+    return filePath;
+}
+/**
+ * 安全地拼接路径
+ */
+export function safePath(...paths) {
+    return path.join(...paths);
+}
+/**
+ * 获取相对路径（安全版本）
+ */
+export function safeRelative(from, to) {
+    try {
+        return path.relative(from, to);
+    }
+    catch {
+        return to;
+    }
+}
+/**
+ * 获取默认 Shell
+ */
+export function getDefaultShell() {
+    if (isWindows()) {
+        // 优先使用 PowerShell，回退到 cmd
+        const powershell = process.env.COMSPEC?.toLowerCase().includes('powershell')
+            ? process.env.COMSPEC
+            : 'powershell.exe';
+        // 检查 PowerShell 是否可用
+        try {
+            execSync('powershell -Command "echo test"', { stdio: 'ignore', windowsHide: true });
+            return {
+                shell: powershell,
+                args: ['-NoProfile', '-Command'],
+                isCmd: false,
+                isPowerShell: true,
+            };
+        }
+        catch {
+            // 回退到 cmd
+            const cmd = process.env.COMSPEC || 'cmd.exe';
+            return {
+                shell: cmd,
+                args: ['/c'],
+                isCmd: true,
+                isPowerShell: false,
+            };
+        }
+    }
+    // Unix 系统
+    const shell = process.env.SHELL || '/bin/bash';
+    return {
+        shell,
+        args: ['-c'],
+        isCmd: false,
+        isPowerShell: false,
+    };
+}
+/**
+ * 包装命令以适配不同的 Shell
+ */
+export function wrapCommand(command) {
+    const shellInfo = getDefaultShell();
+    if (shellInfo.isPowerShell) {
+        // PowerShell 需要特殊处理
+        return {
+            shell: shellInfo.shell,
+            args: [...shellInfo.args, command],
+        };
+    }
+    if (shellInfo.isCmd) {
+        // CMD 需要转义特殊字符
+        const escapedCommand = command.replace(/[&|<>^]/g, '^$&');
+        return {
+            shell: shellInfo.shell,
+            args: [...shellInfo.args, escapedCommand],
+        };
+    }
+    // Unix shells
+    return {
+        shell: shellInfo.shell,
+        args: [...shellInfo.args, command],
+    };
+}
+/**
+ * 执行跨平台命令
+ */
+export function executeCommand(command, options = {}) {
+    const wrapped = wrapCommand(command);
+    const defaultOptions = {
+        cwd: process.cwd(),
+        env: { ...process.env },
+        stdio: ['pipe', 'pipe', 'pipe'],
+    };
+    return spawn(wrapped.shell, wrapped.args, { ...defaultOptions, ...options });
+}
+/**
+ * 同步执行跨平台命令
+ */
+export function executeCommandSync(command, options = {}) {
+    const wrapped = wrapCommand(command);
+    try {
+        const result = spawnSync(wrapped.shell, wrapped.args, {
+            cwd: options.cwd || process.cwd(),
+            timeout: options.timeout || 30000,
+            encoding: options.encoding || 'utf-8',
+            env: process.env,
+        });
+        return {
+            stdout: result.stdout?.toString() || '',
+            stderr: result.stderr?.toString() || '',
+            status: result.status,
+        };
+    }
+    catch (err) {
+        return {
+            stdout: '',
+            stderr: err.message || 'Command execution failed',
+            status: 1,
+        };
+    }
+}
+/**
+ * 获取平台支持的信号
+ */
+export function getSupportedSignals() {
+    if (isWindows()) {
+        // Windows 只支持有限的信号
+        return ['SIGTERM', 'SIGKILL', 'SIGINT'];
+    }
+    return ['SIGTERM', 'SIGKILL', 'SIGINT', 'SIGHUP', 'SIGQUIT'];
+}
+/**
+ * 安全地发送信号到进程
+ */
+export function killProcess(pid, signal = 'SIGTERM') {
+    try {
+        if (typeof pid === 'number') {
+            process.kill(pid, signal);
+        }
+        else if (pid && typeof pid.kill === 'function') {
+            pid.kill(signal);
+        }
+        else {
+            return false;
+        }
+        return true;
+    }
+    catch (err) {
+        // 进程可能已经退出
+        if (err.code === 'ESRCH') {
+            return true; // 进程不存在，视为成功
+        }
+        console.error(`Failed to kill process: ${err.message}`);
+        return false;
+    }
+}
+/**
+ * 强制终止进程（跨平台）
+ */
+export async function forceKillProcess(pid, graceTimeout = 1000) {
+    // 首先尝试优雅终止
+    if (!killProcess(pid, 'SIGTERM')) {
+        return false;
+    }
+    // 等待一段时间后强制终止
+    await new Promise(resolve => setTimeout(resolve, graceTimeout));
+    // 发送 SIGKILL
+    return killProcess(pid, 'SIGKILL');
+}
+/**
+ * 在 Windows 上使用 taskkill 终止进程树
+ */
+export function killProcessTree(pid) {
+    try {
+        if (isWindows()) {
+            // Windows: 使用 taskkill 终止整个进程树
+            execSync(`taskkill /PID ${pid} /T /F`, { stdio: 'ignore', windowsHide: true });
+        }
+        else {
+            // Unix: 使用 SIGTERM 发送到进程组
+            process.kill(-pid, 'SIGTERM');
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// 文件权限处理
+// ============================================================================
+/**
+ * 设置文件权限（跨平台兼容）
+ */
+export function setFilePermissions(filePath, mode) {
+    try {
+        if (isWindows()) {
+            // Windows 不支持 Unix 风格的权限，使用 ACL
+            // 简单实现：确保文件可读写
+            fs.accessSync(filePath, fs.constants.W_OK);
+            return true;
+        }
+        else {
+            fs.chmodSync(filePath, mode);
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查文件是否可执行
+ */
+export function isExecutable(filePath) {
+    try {
+        if (isWindows()) {
+            // Windows: 检查扩展名
+            const ext = path.extname(filePath).toLowerCase();
+            return ['.exe', '.cmd', '.bat', '.com', '.ps1'].includes(ext);
+        }
+        else {
+            // Unix: 检查执行权限
+            fs.accessSync(filePath, fs.constants.X_OK);
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 设置文件为可执行
+ */
+export function makeExecutable(filePath) {
+    try {
+        if (isWindows()) {
+            // Windows 不需要设置执行位
+            return true;
+        }
+        else {
+            // Unix: 添加执行权限
+            const stat = fs.statSync(filePath);
+            fs.chmodSync(filePath, stat.mode | 0o111);
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// 环境变量处理
+// ============================================================================
+/**
+ * 获取 PATH 分隔符
+ */
+export function getPathSeparator() {
+    return path.delimiter; // Windows: ';', Unix: ':'
+}
+/**
+ * 拆分 PATH 环境变量
+ */
+export function splitPath(pathEnv) {
+    const p = pathEnv || process.env.PATH || '';
+    return p.split(getPathSeparator()).filter(Boolean);
+}
+/**
+ * 合并 PATH 环境变量
+ */
+export function joinPath(paths) {
+    return paths.filter(Boolean).join(getPathSeparator());
+}
+/**
+ * 查找可执行文件
+ */
+export function findExecutable(name, additionalPaths = []) {
+    const paths = [...additionalPaths, ...splitPath()];
+    // Windows 需要添加扩展名
+    const extensions = isWindows() ? ['.exe', '.cmd', '.bat', '.com', ''] : [''];
+    for (const dir of paths) {
+        for (const ext of extensions) {
+            const fullPath = path.join(dir, name + ext);
+            try {
+                fs.accessSync(fullPath, fs.constants.X_OK);
+                return fullPath;
+            }
+            catch {
+                // 继续检查
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 获取平台特定的环境变量
+ */
+export function getPlatformEnv() {
+    const baseEnv = { ...process.env };
+    if (isWindows()) {
+        // 确保 Windows 常用变量存在
+        baseEnv.USERPROFILE = process.env.USERPROFILE || getHomeDir();
+        baseEnv.APPDATA = process.env.APPDATA || path.join(getHomeDir(), 'AppData', 'Roaming');
+        baseEnv.LOCALAPPDATA = process.env.LOCALAPPDATA || path.join(getHomeDir(), 'AppData', 'Local');
+    }
+    else {
+        // 确保 Unix 常用变量存在
+        baseEnv.HOME = process.env.HOME || getHomeDir();
+        baseEnv.USER = process.env.USER || os.userInfo().username;
+    }
+    return baseEnv;
+}
+// ============================================================================
+// 终端标题设置 (v2.1.6+)
+// v2.1.7: 添加终端标题 spinner 动画，使用等宽 braille 字符避免抖动
+// ============================================================================
+// 当前终端标题后缀（如项目名）
+let currentTerminalTitleSuffix = '';
+// 静态图标
+const TERMINAL_TITLE_STATIC_ICON = '✳';
+// v2.1.7: 等宽 braille 字符用于终端标题 spinner
+// 这些字符宽度相同，避免终端标题宽度变化导致的抖动
+const TERMINAL_TITLE_SPINNER_FRAMES = ['⠂', '⠐'];
+// 动画间隔 (毫秒)
+const TERMINAL_TITLE_ANIMATION_INTERVAL = 960;
+// 动画状态
+let titleSpinnerTimer = null;
+let titleSpinnerFrameIndex = 0;
+/**
+ * 内部函数：设置终端标题
+ * @param icon 图标字符
+ * @param suffix 后缀
+ */
+function setTerminalTitleInternal(icon, suffix) {
+    // 检查是否禁用终端标题
+    if (process.env.AXON_DISABLE_TERMINAL_TITLE) {
+        return;
+    }
+    const fullTitle = suffix ? `${icon} ${suffix}` : icon;
+    if (isWindows()) {
+        process.title = fullTitle;
+    }
+    else {
+        // 使用 ANSI 转义序列设置终端标题
+        // \x1B]0;...\x07 - 设置图标名称和窗口标题
+        process.stdout.write(`\x1B]0;${fullTitle}\x07`);
+    }
+}
+/**
+ * 设置终端标题后缀
+ *
+ * @param suffix 标题后缀（如项目名）
+ */
+export function setTerminalTitle(title, suffix) {
+    // 检查是否禁用终端标题
+    if (process.env.AXON_DISABLE_TERMINAL_TITLE) {
+        return;
+    }
+    // 存储后缀
+    currentTerminalTitleSuffix = suffix ? `${title} ${suffix}` : title;
+    // 如果没有在播放动画，立即更新标题
+    if (!titleSpinnerTimer) {
+        setTerminalTitleInternal(TERMINAL_TITLE_STATIC_ICON, currentTerminalTitleSuffix);
+    }
+}
+/**
+ * 设置终端标题后缀（不包含图标）
+ *
+ * @param suffix 标题后缀
+ */
+export function setTerminalTitleSuffix(suffix) {
+    currentTerminalTitleSuffix = suffix;
+    // 如果没有在播放动画，立即更新标题
+    if (!titleSpinnerTimer) {
+        setTerminalTitleInternal(TERMINAL_TITLE_STATIC_ICON, currentTerminalTitleSuffix);
+    }
+}
+/**
+ * 重置终端标题为 "Axon"
+ */
+export function resetTerminalTitle() {
+    setTerminalTitleSuffix('Axon');
+}
+/**
+ * 获取当前终端标题后缀
+ */
+export function getTerminalTitle() {
+    return currentTerminalTitleSuffix;
+}
+/**
+ * v2.1.7: 开始终端标题 spinner 动画
+ *
+ * 使用等宽 braille 字符避免终端标题宽度变化导致的抖动
+ */
+export function startTerminalTitleSpinner() {
+    // 检查是否禁用终端标题
+    if (process.env.AXON_DISABLE_TERMINAL_TITLE) {
+        return;
+    }
+    // 如果已经在播放动画，不重复启动
+    if (titleSpinnerTimer) {
+        return;
+    }
+    titleSpinnerFrameIndex = 0;
+    titleSpinnerTimer = setInterval(() => {
+        titleSpinnerFrameIndex = (titleSpinnerFrameIndex + 1) % TERMINAL_TITLE_SPINNER_FRAMES.length;
+        const frame = TERMINAL_TITLE_SPINNER_FRAMES[titleSpinnerFrameIndex] ?? TERMINAL_TITLE_STATIC_ICON;
+        setTerminalTitleInternal(frame, currentTerminalTitleSuffix);
+    }, TERMINAL_TITLE_ANIMATION_INTERVAL);
+}
+/**
+ * v2.1.7: 停止终端标题 spinner 动画
+ *
+ * 恢复静态图标
+ */
+export function stopTerminalTitleSpinner() {
+    if (titleSpinnerTimer) {
+        clearInterval(titleSpinnerTimer);
+        titleSpinnerTimer = null;
+    }
+    // 恢复静态图标
+    setTerminalTitleInternal(TERMINAL_TITLE_STATIC_ICON, currentTerminalTitleSuffix);
+}
+/**
+ * v2.1.7: 检查终端标题 spinner 是否正在运行
+ */
+export function isTerminalTitleSpinnerRunning() {
+    return titleSpinnerTimer !== null;
+}
+/**
+ * 获取平台沙箱能力
+ */
+export function getSandboxCapabilities() {
+    const caps = {
+        bubblewrap: false,
+        windowsSandbox: false,
+        docker: false,
+        none: true,
+    };
+    if (isLinux()) {
+        // 检查 bubblewrap
+        try {
+            execSync('which bwrap', { stdio: 'ignore' });
+            caps.bubblewrap = true;
+        }
+        catch {
+            // Not available
+        }
+    }
+    if (isWindows()) {
+        // 检查 Windows Sandbox
+        try {
+            execSync('powershell -Command "Get-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM"', { stdio: 'ignore', windowsHide: true });
+            caps.windowsSandbox = true;
+        }
+        catch {
+            // Not available
+        }
+    }
+    // 检查 Docker
+    try {
+        execSync(isWindows() ? 'docker --version' : 'which docker', { stdio: 'ignore' });
+        caps.docker = true;
+    }
+    catch {
+        // Not available
+    }
+    return caps;
+}
+/**
+ * 获取推荐的沙箱类型
+ */
+export function getRecommendedSandbox() {
+    const caps = getSandboxCapabilities();
+    if (caps.bubblewrap)
+        return 'bubblewrap';
+    if (caps.docker)
+        return 'docker';
+    return 'none';
+}
+// ============================================================================
+// 导出
+// ============================================================================
+export default {
+    // 平台检测
+    getPlatform,
+    isWindows,
+    isMacOS,
+    isLinux,
+    isWSL,
+    isWindowsNpmInWSL,
+    // 路径处理
+    getHomeDir,
+    getConfigDir,
+    getSessionsDir,
+    getTempDir,
+    getSafeTempDir,
+    escapePathForShell,
+    doubleEscapeBackslashes,
+    normalizePath,
+    toUnixPath,
+    toPlatformPath,
+    expandEnvPath,
+    ensureCorrectSeparator,
+    safePath,
+    safeRelative,
+    // Shell 命令
+    getDefaultShell,
+    wrapCommand,
+    executeCommand,
+    executeCommandSync,
+    // 进程信号
+    getSupportedSignals,
+    killProcess,
+    forceKillProcess,
+    killProcessTree,
+    // 文件权限
+    setFilePermissions,
+    isExecutable,
+    makeExecutable,
+    // 环境变量
+    getPathSeparator,
+    splitPath,
+    joinPath,
+    findExecutable,
+    getPlatformEnv,
+    // 沙箱
+    getSandboxCapabilities,
+    getRecommendedSandbox,
+    // 终端标题
+    setTerminalTitle,
+    setTerminalTitleSuffix,
+    resetTerminalTitle,
+    getTerminalTitle,
+    // v2.1.7: 终端标题 spinner 动画
+    startTerminalTitleSpinner,
+    stopTerminalTitleSpinner,
+    isTerminalTitleSpinnerRunning,
+};
+//# sourceMappingURL=platform.js.map