npm - @sstar/boardlinker_agent - Versions diffs - 0.2.0 - Mend

@sstar/boardlinker_agent 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (51) hide show

package/README.md +107 -0
package/dist/.platform +1 -0
package/dist/board/docs.js +59 -0
package/dist/board/notes.js +11 -0
package/dist/board_uart/history.js +81 -0
package/dist/board_uart/index.js +66 -0
package/dist/board_uart/manager.js +313 -0
package/dist/board_uart/resource.js +578 -0
package/dist/board_uart/sessions.js +559 -0
package/dist/config/index.js +341 -0
package/dist/core/activity.js +7 -0
package/dist/core/errors.js +45 -0
package/dist/core/log_stream.js +26 -0
package/dist/files/file_operation_logger.js +271 -0
package/dist/files/files_manager.js +511 -0
package/dist/files/index.js +87 -0
package/dist/files/types.js +5 -0
package/dist/firmware/burn_recover.js +733 -0
package/dist/firmware/prepare_images.js +184 -0
package/dist/firmware/user_guide.js +43 -0
package/dist/index.js +449 -0
package/dist/logger.js +245 -0
package/dist/macro/index.js +241 -0
package/dist/macro/runner.js +168 -0
package/dist/nfs/index.js +105 -0
package/dist/plugins/loader.js +30 -0
package/dist/proto/agent.proto +473 -0
package/dist/resources/docs/board-interaction.md +115 -0
package/dist/resources/docs/firmware-upgrade.md +404 -0
package/dist/resources/docs/nfs-mount-guide.md +78 -0
package/dist/resources/docs/tftp-transfer-guide.md +81 -0
package/dist/secrets/index.js +9 -0
package/dist/server/grpc.js +1083 -0
package/dist/server/web.js +2306 -0
package/dist/ssh/adapter.js +126 -0
package/dist/ssh/candidates.js +85 -0
package/dist/ssh/index.js +3 -0
package/dist/ssh/paircheck.js +35 -0
package/dist/ssh/tunnel.js +111 -0
package/dist/tftp/client.js +345 -0
package/dist/tftp/index.js +284 -0
package/dist/tftp/server.js +731 -0
package/dist/uboot/index.js +45 -0
package/dist/ui/assets/index-CCZ6chFx.css +32 -0
package/dist/ui/assets/index-Cuhnt9D5.js +375 -0
package/dist/ui/index.html +21 -0
package/dist/utils/network.js +150 -0
package/dist/utils/platform.js +83 -0
package/dist/utils/port-check.js +153 -0
package/dist/utils/user-prompt.js +139 -0
package/package.json +59 -0

package/dist/ui/index.html ADDED Viewed

@@ -0,0 +1,21 @@
+<!doctype html>
+<html lang="en" class="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>BoardLinker Agent</title>
+    <!-- Preload Fonts if possible, or load via CSS -->
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap"
+      rel="stylesheet"
+    />
+    <script type="module" crossorigin src="/assets/index-Cuhnt9D5.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CCZ6chFx.css">
+  </head>
+  <body class="bg-[#1A1C1E] text-[#E2E8F0]">
+    <div id="root"></div>
+  </body>
+</html>

package/dist/utils/network.js ADDED Viewed

@@ -0,0 +1,150 @@
+import os from 'node:os';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+/**
+ * 验证IPv4地址是否有效
+ */
+function isValidIPv4(address) {
+    if (!address)
+        return false;
+    const parts = address.split('.');
+    if (parts.length !== 4)
+        return false;
+    return parts.every((part) => {
+        const num = parseInt(part, 10);
+        return !isNaN(num) && num >= 0 && num <= 255;
+    });
+}
+/**
+ * 获取网关地址（跨平台）
+ */
+async function getDefaultGateway() {
+    try {
+        let command = '';
+        if (process.platform === 'linux') {
+            command = "ip route | grep default | awk '{print $3}' | head -n1";
+        }
+        else if (process.platform === 'darwin') {
+            command = "route -n get default | grep gateway | awk '{print $2}'";
+        }
+        else if (process.platform === 'win32') {
+            command =
+                'powershell "Get-NetRoute | Where-Object { $_.DestinationPrefix -eq \'0.0.0.0/0\' } | Select-Object -ExpandProperty NextHop | Select-Object -First 1"';
+        }
+        else {
+            // 不支持的平台
+            return null;
+        }
+        const { stdout } = await execAsync(command);
+        const gateway = stdout.trim();
+        return isValidIPv4(gateway) ? gateway : null;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * 计算广播地址
+ */
+function calculateBroadcastAddress(ip, netmask) {
+    if (!isValidIPv4(ip) || !isValidIPv4(netmask)) {
+        return null;
+    }
+    try {
+        const ipParts = ip.split('.').map(Number);
+        const maskParts = netmask.split('.').map(Number);
+        const broadcastParts = [];
+        for (let i = 0; i < 4; i++) {
+            broadcastParts.push(ipParts[i] | (~maskParts[i] & 255));
+        }
+        return broadcastParts.join('.');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取网络信息（IPv4 only，包含网关和广播地址，排除回环接口）
+ */
+export async function getNetworkInfo() {
+    const nets = os.networkInterfaces();
+    const networkInfos = [];
+    const seenAddresses = new Set(); // 用于去重
+    // 获取默认网关
+    const defaultGateway = await getDefaultGateway();
+    for (const [name, infos] of Object.entries(nets)) {
+        if (!infos)
+            continue;
+        for (const info of infos) {
+            // 只要IPv4地址，排除内部接口（包括回环）
+            if (info.family !== 'IPv4' || info.internal) {
+                continue;
+            }
+            // 验证地址有效性
+            if (!isValidIPv4(info.address)) {
+                continue;
+            }
+            // 去重检查
+            if (seenAddresses.has(info.address)) {
+                continue;
+            }
+            seenAddresses.add(info.address);
+            // 计算广播地址
+            const broadcast = info.netmask
+                ? calculateBroadcastAddress(info.address, info.netmask)
+                : undefined;
+            networkInfos.push({
+                ip: info.address,
+                netmask: info.netmask || '255.255.255.255',
+                broadcast: broadcast || undefined,
+                gateway: defaultGateway || undefined,
+                interface: name,
+                internal: !!info.internal,
+            });
+        }
+    }
+    return networkInfos;
+}
+/**
+ * 获取候选IP地址（只返回外部IPv4）
+ */
+export function getAgentIpCandidates() {
+    const nets = os.networkInterfaces();
+    const candidates = [];
+    for (const [name, infos] of Object.entries(nets)) {
+        if (!infos)
+            continue;
+        for (const info of infos) {
+            // 只要外部IPv4地址
+            if (info.family === 'IPv4' && !info.internal && isValidIPv4(info.address)) {
+                if (!candidates.includes(info.address)) {
+                    candidates.push(info.address);
+                }
+            }
+        }
+    }
+    // 如果没有外部地址，添加本地回环
+    if (candidates.length === 0) {
+        candidates.push('127.0.0.1');
+    }
+    return candidates;
+}
+/**
+ * 获取主要IP地址
+ */
+export function getPrimaryAgentIp() {
+    const candidates = getAgentIpCandidates();
+    return candidates[0] || '127.0.0.1';
+}
+/**
+ * 获取网络调试信息
+ */
+export function getNetworkDebugInfo() {
+    return {
+        platform: os.platform(),
+        arch: os.arch(),
+        nodeVersion: process.version,
+        primaryIp: getPrimaryAgentIp(),
+    };
+}

package/dist/utils/platform.js ADDED Viewed

@@ -0,0 +1,83 @@
+import { platform as nodePlatform, arch as nodeArch } from 'node:os';
+/**
+ * 获取当前 agent 运行的平台信息
+ * @returns 平台信息对象，包含操作系统和架构
+ */
+export function getPlatformInfo() {
+    const platform = normalizePlatform(nodePlatform());
+    const arch = normalizeArch(nodeArch());
+    return {
+        platform,
+        arch,
+    };
+}
+/**
+ * 标准化平台名称
+ * @param platform Node.js os.platform() 返回的原始平台名
+ * @returns 标准化的平台名称
+ */
+function normalizePlatform(platform) {
+    switch (platform) {
+        case 'win32':
+            return 'Windows';
+        case 'darwin':
+            return 'macOS';
+        case 'linux':
+            return 'Linux';
+        case 'freebsd':
+            return 'FreeBSD';
+        case 'openbsd':
+            return 'OpenBSD';
+        case 'sunos':
+            return 'SunOS';
+        case 'aix':
+            return 'AIX';
+        default:
+            return platform;
+    }
+}
+/**
+ * 标准化架构名称
+ * @param arch Node.js os.arch() 返回的原始架构名
+ * @returns 标准化的架构名称
+ */
+function normalizeArch(arch) {
+    switch (arch) {
+        case 'x64':
+            return 'x86_64';
+        case 'x32':
+            return 'x86';
+        case 'arm':
+            return 'ARM';
+        case 'arm64':
+            return 'ARM64';
+        case 'ia32':
+            return 'x86';
+        case 'mips':
+            return 'MIPS';
+        case 'mipsel':
+            return 'MIPS-LE';
+        case 'ppc':
+            return 'PowerPC';
+        case 'ppc64':
+            return 'PowerPC64';
+        case 's390':
+            return 'S/390';
+        case 's390x':
+            return 'S/390x';
+        case 'riscv32':
+            return 'RISC-V 32-bit';
+        case 'riscv64':
+            return 'RISC-V 64-bit';
+        default:
+            return arch;
+    }
+}
+/**
+ * 获取完整的平台描述字符串
+ * @returns 完整的平台描述，如 "Linux x86_64"
+ */
+export function getPlatformDescription() {
+    const { platform, arch } = getPlatformInfo();
+    return `${platform} ${arch}`;
+}

package/dist/utils/port-check.js ADDED Viewed

@@ -0,0 +1,153 @@
+import dgram from 'node:dgram';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+/**
+ * 检查UDP端口是否可用
+ */
+export async function checkPortAvailability(port, host = '0.0.0.0') {
+    if (port < 1 || port > 65535) {
+        throw new Error(`Invalid port number: ${port}`);
+    }
+    try {
+        const socket = dgram.createSocket('udp4');
+        await new Promise((resolve, reject) => {
+            socket.bind(port, host, () => {
+                socket.close(() => resolve());
+            });
+            socket.on('error', reject);
+        });
+        return { available: true };
+    }
+    catch (error) {
+        if (error.code === 'EADDRINUSE' || error.code === 'EACCES') {
+            const processInfo = await getPortProcessInfo(port);
+            return {
+                available: false,
+                occupiedBy: 'process',
+                process: processInfo,
+            };
+        }
+        throw error;
+    }
+}
+/**
+ * 获取占用端口的进程信息
+ */
+async function getPortProcessInfo(port) {
+    const platform = process.platform;
+    try {
+        if (platform === 'linux') {
+            const { stdout } = await execAsync(`lsof -i :${port} -n -P | grep LISTEN || lsof -i :${port} -n -P | grep UDP`);
+            return parseLinuxLsof(stdout);
+        }
+        else if (platform === 'darwin') {
+            const { stdout } = await execAsync(`lsof -i :${port} -n -P | grep LISTEN || lsof -i :${port} -n -P | grep UDP`);
+            return parseLinuxLsof(stdout);
+        }
+        else if (platform === 'win32') {
+            const { stdout } = await execAsync(`netstat -aon | findstr :${port}`);
+            return await parseWindowsNetstat(stdout, port);
+        }
+    }
+    catch (error) {
+        // 忽略进程信息获取失败，返回空对象
+    }
+    return {};
+}
+/**
+ * 解析Linux/macOS的lsof输出
+ */
+function parseLinuxLsof(output) {
+    try {
+        const lines = output.trim().split('\n');
+        if (lines.length === 0 || lines[0] === '')
+            return {};
+        const line = lines[0];
+        const parts = line.trim().split(/\s+/);
+        if (parts.length >= 2) {
+            const command = parts[0];
+            const pid = parseInt(parts[1]);
+            if (!isNaN(pid)) {
+                return {
+                    pid,
+                    name: command,
+                    command: `${command} (PID: ${pid})`,
+                };
+            }
+        }
+    }
+    catch (error) {
+        // 忽略解析错误
+    }
+    return {};
+}
+/**
+ * 解析Windows的netstat输出
+ */
+async function parseWindowsNetstat(output, port) {
+    try {
+        const lines = output.trim().split('\n');
+        for (const line of lines) {
+            if (line.includes(`:${port}`)) {
+                const parts = line.trim().split(/\s+/);
+                const pidStr = parts[parts.length - 1];
+                const pid = parseInt(pidStr);
+                if (!isNaN(pid)) {
+                    try {
+                        const { stdout: processName } = await execAsync(`tasklist /FI "PID eq ${pid}" /FO CSV | findstr /V "INFO"`);
+                        const nameMatch = processName.match(/"([^"]+)"/);
+                        const name = nameMatch ? nameMatch[1] : `Unknown (PID: ${pid})`;
+                        return {
+                            pid,
+                            name,
+                            command: `${name} (PID: ${pid})`,
+                        };
+                    }
+                    catch {
+                        // 如果无法获取进程名，至少返回PID
+                        return {
+                            pid,
+                            name: `Unknown (PID: ${pid})`,
+                            command: `Unknown (PID: ${pid})`,
+                        };
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        // 忽略解析错误
+    }
+    return {};
+}
+/**
+ * 查找一个可用的端口（从指定端口开始）
+ */
+export async function findAvailablePort(startPort, maxAttempts = 10) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = startPort + i;
+        const result = await checkPortAvailability(port);
+        if (result.available) {
+            return port;
+        }
+    }
+    throw new Error(`No available port found from ${startPort} to ${startPort + maxAttempts - 1}`);
+}
+/**
+ * 检查TCP端口是否可用（用于验证）
+ */
+export async function checkTcpPortAvailability(port, host = '127.0.0.1') {
+    const net = await import('node:net');
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.on('error', () => {
+            resolve(false);
+        });
+        server.listen(port, host, () => {
+            server.close(() => {
+                resolve(true);
+            });
+        });
+    });
+}

package/dist/utils/user-prompt.js ADDED Viewed

@@ -0,0 +1,139 @@
+import readline from 'node:readline';
+/**
+ * 提示用户处理端口冲突
+ */
+export async function promptUserForPortConflict(port, conflictInfo) {
+    // 检查是否在TTY环境中
+    if (!process.stdin.isTTY) {
+        // 非交互模式，自动选择备用端口
+        return {
+            action: 'change_port',
+            newPort: port + 1,
+        };
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        console.log(`\n❌ 端口 ${port} 被占用:`);
+        if (conflictInfo?.process?.command) {
+            console.log(`   占用进程: ${conflictInfo.process.command}`);
+        }
+        console.log(`   端口69是TFTP协议的标准端口`);
+        console.log(`   如果这是其他TFTP服务器，建议使用外部服务器模式`);
+        console.log('\n请选择处理方式:');
+        console.log('1. 使用备用端口启动内置TFTP服务器 (如70)');
+        console.log('2. 配置外部TFTP服务器 (指定其他TFTP服务器地址)');
+        console.log('3. 停止占用端口的进程后重试 (需要手动操作)');
+        console.log('4. 禁用TFTP服务器 (仅保留文件管理功能)');
+        const answer = await new Promise((resolve) => {
+            rl.question('\n请输入选择 (1-4): ', resolve);
+        });
+        switch (answer.trim()) {
+            case '1':
+                const newPort = await askForPort(rl, port + 1, '备用端口');
+                return { action: 'change_port', newPort };
+            case '2':
+                const externalHost = await askForString(rl, '外部TFTP服务器地址', '127.0.0.1');
+                const externalPort = await askForPort(rl, 69, '外部TFTP服务器端口');
+                return { action: 'use_external', externalHost, externalPort };
+            case '3':
+                console.log('\n请手动停止占用端口的进程后重新启动Agent:');
+                if (conflictInfo?.process?.pid) {
+                    console.log(`   停止进程: kill -9 ${conflictInfo.process.pid}`);
+                }
+                else {
+                    console.log('   查找进程: lsof -i :' + port + ' (Linux/macOS)');
+                    console.log('   查找进程: netstat -aon | findstr :' + port + ' (Windows)');
+                }
+                console.log('\nAgent即将退出...');
+                await new Promise((resolve) => setTimeout(resolve, 2000));
+                process.exit(1);
+            case '4':
+                return { action: 'disable' };
+            default:
+                console.log('\n❌ 无效选择，将使用备用端口启动');
+                const fallbackPort = port + 1;
+                return { action: 'change_port', newPort: fallbackPort };
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * 询问端口号
+ */
+async function askForPort(rl, defaultPort, label) {
+    while (true) {
+        const answer = await new Promise((resolve) => {
+            rl.question(`${label} (默认 ${defaultPort}): `, resolve);
+        });
+        const input = answer.trim();
+        if (input === '') {
+            return defaultPort;
+        }
+        const port = parseInt(input);
+        if (isNaN(port) || port < 1 || port > 65535) {
+            console.log('❌ 无效的端口号，请输入1-65535之间的数字');
+            continue;
+        }
+        return port;
+    }
+}
+/**
+ * 询问字符串
+ */
+async function askForString(rl, prompt, defaultValue) {
+    const answer = await new Promise((resolve) => {
+        rl.question(`${prompt} (默认 ${defaultValue}): `, resolve);
+    });
+    return answer.trim() || defaultValue;
+}
+/**
+ * 询问用户确认 (y/n)
+ */
+export async function askForConfirmation(message, defaultValue = true) {
+    if (!process.stdin.isTTY) {
+        return defaultValue;
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const defaultStr = defaultValue ? 'Y/n' : 'y/N';
+        const answer = await new Promise((resolve) => {
+            rl.question(`${message} (${defaultStr}): `, resolve);
+        });
+        const input = answer.trim().toLowerCase();
+        if (input === '') {
+            return defaultValue;
+        }
+        return input === 'y' || input === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * 显示提示信息并等待用户按回车继续
+ */
+export async function waitForEnter(message = '\n按回车键继续...') {
+    if (!process.stdin.isTTY) {
+        return;
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        await new Promise((resolve) => {
+            rl.question(message, () => resolve());
+        });
+    }
+    finally {
+        rl.close();
+    }
+}

package/package.json ADDED Viewed

@@ -0,0 +1,59 @@
+{
+  "name": "@sstar/boardlinker_agent",
+  "version": "0.2.0",
+  "description": "BoardLinker Agent - Board hardware access service for embedded development",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "boardlinker": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "postbuild": "node scripts/inject-proto.mjs",
+    "prepack": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "embedded",
+    "hardware",
+    "uart",
+    "serial",
+    "grpc",
+    "mcp",
+    "firmware",
+    "board"
+  ],
+  "author": "SStar",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sstar/board_linker.git",
+    "directory": "packages/agent"
+  },
+  "dependencies": {
+    "@grpc/grpc-js": "^1.10.7",
+    "@grpc/proto-loader": "^0.7.13",
+    "@homebridge/node-pty-prebuilt-multiarch": "0.13.1",
+    "@toon-format/toon": "^2.1.0",
+    "express": "^4.19.2",
+    "serialport": "^12.0.0",
+    "ssh2": "^1.15.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.5.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.5",
+    "@types/ssh2": "^1.15.5",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.6.3"
+  }
+}