netisok 1.0.0

package/README.md

@@ -0,0 +1,62 @@
+# netisok
+
+网络测速命令行工具，参考 ZTools 插件 [speed-test-ztools](https://github.com/) 实现。通过 HTTP GET 并发请求各站点，测量响应时间。
+
+## 功能
+
+- 默认测速：百度、Google、GitHub
+- 并发请求，超时 4 秒（与 ZTools 插件一致）
+- 支持自定义 URL、超时、顺序/并发模式
+- 支持 JSON 输出，便于脚本集成
+
+## 安装
+
+```bash
+pnpm install
+pnpm build
+```
+
+全局链接（可选）：
+
+```bash
+pnpm link --global
+```
+
+## 使用
+
+```bash
+# 默认测速
+pnpm dev
+# 或
+netisok
+
+# 指定 URL
+netisok -u https://www.baidu.com/ -u https://github.com/
+
+# 调整超时（秒）
+netisok -t 10
+
+# 顺序测速
+netisok -s
+
+# JSON 输出
+netisok --json
+```
+
+## 项目结构
+
+```
+netisok/
+├── src/
+│   ├── cli.ts         # Commander 入口
+│   ├── speed-test.ts  # 测速核心逻辑
+│   ├── output.ts      # 终端 / JSON 输出
+│   └── types.ts
+├── package.json
+└── tsconfig.json
+```
+
+## 退出码
+
+- `0`：全部站点测速成功
+- `1`：存在失败站点或运行错误

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { DEFAULT_SITES, DEFAULT_TIMEOUT_MS, summarizeResults, testWebsites, } from './speed-test.js';
+import { printJson, printResults } from './output.js';
+const program = new Command();
+program
+    .name('netisok')
+    .description('网络测速命令行工具 - 测试各站点 HTTP 响应时间')
+    .version('1.0.0')
+    .option('-u, --url <urls...>', '指定测速 URL（可多次使用）')
+    .option('-t, --timeout <seconds>', '请求超时时间（秒）', String(DEFAULT_TIMEOUT_MS / 1000))
+    .option('-s, --sequential', '顺序测速（默认并发）')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (options) => {
+    const timeoutSec = Number.parseFloat(options.timeout);
+    if (!Number.isFinite(timeoutSec) || timeoutSec <= 0) {
+        console.error('错误: --timeout 必须是大于 0 的数字');
+        process.exitCode = 1;
+        return;
+    }
+    const urls = options.url?.length ? options.url : DEFAULT_SITES;
+    const timeout = Math.round(timeoutSec * 1000);
+    try {
+        const results = await testWebsites({
+            urls,
+            timeout,
+            concurrent: !options.sequential,
+        });
+        const summary = summarizeResults(results);
+        if (options.json) {
+            printJson(results, summary);
+        }
+        else {
+            printResults(results);
+        }
+        if (summary.failCount > 0) {
+            process.exitCode = 1;
+        }
+    }
+    catch (err) {
+        console.error('测速失败:', err instanceof Error ? err.message : err);
+        process.exitCode = 1;
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,6BAA6B,CAAC;KAC1C,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,CAAC;KAChD,MAAM,CAAC,yBAAyB,EAAE,WAAW,EAAE,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;KACjF,MAAM,CAAC,kBAAkB,EAAE,YAAY,CAAC;KACxC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC;KACjC,MAAM,CAAC,KAAK,EAAE,OAKd,EAAE,EAAE;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC;YACjC,IAAI;YACJ,OAAO;YACP,UAAU,EAAE,CAAC,OAAO,CAAC,UAAU;SAChC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE1C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,3 @@
+import type { TestResult, TestSummary } from './types.js';
+export declare function printResults(results: TestResult[]): void;
+export declare function printJson(results: TestResult[], summary: TestSummary): void;

package/dist/output.js

@@ -0,0 +1,17 @@
+export function printResults(results) {
+    results.forEach((result, index) => {
+        console.log(`${index + 1}. ${result.url}`);
+        if (result.success) {
+            console.log(`   ✅ 成功 - 响应时间: ${result.responseTime}ms`);
+        }
+        else {
+            console.log(`   ❌ 失败 - ${result.error}`);
+            console.log(`   已用时间: ${result.responseTime}ms`);
+        }
+        console.log('');
+    });
+}
+export function printJson(results, summary) {
+    console.log(JSON.stringify({ results, summary }, null, 2));
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,OAAqB;IAChD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAqB,EAAE,OAAoB;IACnE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/speed-test.d.ts

@@ -0,0 +1,6 @@
+import type { SpeedTestOptions, TestResult, TestSummary } from './types.js';
+export declare const DEFAULT_SITES: string[];
+export declare const DEFAULT_TIMEOUT_MS = 4000;
+export declare function testWebsite(url: string, timeout?: number): Promise<TestResult>;
+export declare function testWebsites(options: SpeedTestOptions): Promise<TestResult[]>;
+export declare function summarizeResults(results: TestResult[]): TestSummary;

package/dist/speed-test.js

@@ -0,0 +1,87 @@
+import http from 'node:http';
+import https from 'node:https';
+export const DEFAULT_SITES = [
+    'https://www.baidu.com/',
+    'https://www.google.com/',
+    'https://github.com/',
+];
+export const DEFAULT_TIMEOUT_MS = 4_000;
+function requestOnce(targetUrl, timeout) {
+    return new Promise((resolve) => {
+        const start = Date.now();
+        const parsed = new URL(targetUrl);
+        const mod = parsed.protocol === 'https:' ? https : http;
+        const req = mod.get(targetUrl, { timeout }, (res) => {
+            const responseTime = Date.now() - start;
+            resolve({
+                url: targetUrl,
+                success: (res.statusCode ?? 500) < 500,
+                responseTime,
+                statusCode: res.statusCode,
+            });
+            res.destroy();
+        });
+        req.on('error', (err) => {
+            const responseTime = Date.now() - start;
+            resolve({
+                url: targetUrl,
+                success: false,
+                responseTime,
+                error: formatRequestError(err),
+            });
+        });
+        req.on('timeout', () => {
+            req.destroy();
+            resolve({
+                url: targetUrl,
+                success: false,
+                responseTime: Date.now() - start,
+                error: '请求超时',
+            });
+        });
+    });
+}
+function formatRequestError(err) {
+    if (err.code === 'ECONNABORTED')
+        return '请求超时';
+    if (err.code === 'ENOTFOUND' || err.code === 'ECONNREFUSED')
+        return '无法连接';
+    return err.message || '请求失败';
+}
+export async function testWebsite(url, timeout = DEFAULT_TIMEOUT_MS) {
+    return requestOnce(url, timeout);
+}
+export async function testWebsites(options) {
+    const { urls, timeout, concurrent } = options;
+    if (concurrent) {
+        return Promise.all(urls.map((url) => testWebsite(url, timeout)));
+    }
+    const results = [];
+    for (const url of urls) {
+        results.push(await testWebsite(url, timeout));
+    }
+    return results;
+}
+export function summarizeResults(results) {
+    const successResults = results.filter((r) => r.success);
+    const successCount = successResults.length;
+    const failCount = results.length - successCount;
+    const avgResponseTime = successCount > 0
+        ? successResults.reduce((sum, r) => sum + r.responseTime, 0) / successCount
+        : 0;
+    const fastest = successCount > 0
+        ? successResults.reduce((min, r) => (r.responseTime < min.responseTime ? r : min))
+        : undefined;
+    const slowest = successCount > 0
+        ? successResults.reduce((max, r) => (r.responseTime > max.responseTime ? r : max))
+        : undefined;
+    return {
+        total: results.length,
+        successCount,
+        failCount,
+        avgResponseTime,
+        fastest,
+        slowest,
+    };
+}
+//# sourceMappingURL=speed-test.js.map

package/dist/speed-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speed-test.js","sourceRoot":"","sources":["../src/speed-test.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+export interface TestResult {
+    url: string;
+    success: boolean;
+    responseTime: number;
+    statusCode?: number;
+    error?: string;
+}
+export interface TestSummary {
+    total: number;
+    successCount: number;
+    failCount: number;
+    avgResponseTime: number;
+    fastest?: TestResult;
+    slowest?: TestResult;
+}
+export interface SpeedTestOptions {
+    urls: string[];
+    timeout: number;
+    concurrent: boolean;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "netisok",
+  "version": "1.0.0",
+  "description": "网络测速命令行工具",
+  "type": "module",
+  "bin": {
+    "netisok": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build",
+    "prepack": "pnpm run build",
+    "publish": "pnpm run build && npm publish --ignore-scripts",
+    "publish:dry": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "network",
+    "speed-test",
+    "cli",
+    "netisok",
+    "ping"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  }
+}