@zhin.js/process-monitor 1.0.0 → 2.0.0

package/lib/index.d.ts

@@ -0,0 +1,13 @@
+declare const plugin: import("zhin.js").Plugin;
+interface ProcessState {
+    lastPid?: number;
+    lastStartTime?: number;
+    restartCount: number;
+    crashCount: number;
+    totalUptime: number;
+}
+export declare let processState: ProcessState;
+export declare const startTime: number;
+export declare function formatUptime(ms: number): string;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,MAAM,0BAAc,CAAC;AAsC3B,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,IAAI,YAAY,EAAE,YAIxB,CAAC;AAEF,eAAO,MAAM,SAAS,QAAa,CAAC;AA2GpC,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAU/C;AAwCD,eAAe,MAAM,CAAC"}

package/lib/index.js

@@ -0,0 +1,169 @@
+/**
+ * @zhin.js/process-monitor
+ *
+ * 进程监控与重启通知插件
+ */
+import { formatCompact, usePlugin } from 'zhin.js';
+import os from 'os';
+import fs from 'fs';
+import path from 'path';
+const plugin = usePlugin();
+const { logger, root } = plugin;
+const configService = root.inject('config');
+const appConfig = configService?.getPrimary() || {};
+const config = {
+    enabled: true,
+    notifyChannels: [],
+    notifyOnStart: true,
+    notifyOnRestart: true,
+    notifyOnCrash: true,
+    ...appConfig['process-monitor'],
+};
+if (!config.enabled) {
+    logger.info(formatCompact({ op: 'load', enabled: false }));
+}
+// ─── 状态管理 ────────────────────────────────────────────────────────────────
+const STATE_FILE = path.join(process.cwd(), 'data', 'process-state.json');
+export let processState = {
+    restartCount: 0,
+    crashCount: 0,
+    totalUptime: 0,
+};
+export const startTime = Date.now();
+function loadProcessState() {
+    try {
+        if (fs.existsSync(STATE_FILE)) {
+            const data = fs.readFileSync(STATE_FILE, 'utf-8');
+            processState = JSON.parse(data);
+        }
+    }
+    catch (error) {
+        logger.warn(formatCompact({ op: 'load_state', ok: false, error: String(error) }));
+    }
+}
+function saveProcessState() {
+    try {
+        fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
+        fs.writeFileSync(STATE_FILE, JSON.stringify(processState, null, 2));
+    }
+    catch (error) {
+        logger.warn(formatCompact({ op: 'save_state', ok: false, error: String(error) }));
+    }
+}
+// ─── 启动检测 ────────────────────────────────────────────────────────────────
+async function detectStartupReason() {
+    const currentPid = process.pid;
+    const currentTime = Date.now();
+    let reason = 'start';
+    let uptime;
+    if (processState.lastPid && processState.lastStartTime) {
+        const timeSinceLastStart = currentTime - processState.lastStartTime;
+        if (timeSinceLastStart < 5 * 60 * 1000) {
+            reason = 'crash';
+            processState.crashCount++;
+            logger.warn(formatCompact({ op: 'restart', abnormal: true, since_last_s: Math.floor(timeSinceLastStart / 1000) }));
+        }
+        else {
+            reason = 'restart';
+            processState.restartCount++;
+            logger.info(formatCompact({ op: 'restart', abnormal: false }));
+        }
+        uptime = timeSinceLastStart;
+        processState.totalUptime += uptime;
+    }
+    else {
+        logger.info(formatCompact({ first: true }));
+    }
+    processState.lastPid = currentPid;
+    processState.lastStartTime = currentTime;
+    saveProcessState();
+    const record = {
+        timestamp: new Date(),
+        reason,
+        uptime,
+        pid: currentPid,
+        hostname: os.hostname(),
+        platform: `${os.platform()}-${os.arch()}`,
+        nodeVersion: process.version,
+        memory: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
+    };
+    const shouldNotify = (reason === 'start' && config.notifyOnStart) ||
+        (reason === 'restart' && config.notifyOnRestart) ||
+        (reason === 'crash' && config.notifyOnCrash);
+    if (shouldNotify && config.notifyChannels && config.notifyChannels.length > 0) {
+        await sendNotification(record);
+    }
+}
+// ─── 通知 ────────────────────────────────────────────────────────────────────
+function formatNotificationMessage(record) {
+    const emoji = { start: '🚀', restart: '🔄', crash: '💥' }[record.reason] || '📊';
+    const reasonText = { start: '首次启动', restart: '正常重启', crash: '异常崩溃' }[record.reason] || '未知';
+    const lines = [
+        `${emoji} 【进程监控通知】`,
+        '',
+        `📊 事件: ${reasonText}`,
+        `⏰ 时间: ${record.timestamp.toLocaleString('zh-CN')}`,
+        `🖥️  主机: ${record.hostname}`,
+        `🔢 PID: ${record.pid}`,
+        `💻 平台: ${record.platform}`,
+        `📦 Node: ${record.nodeVersion}`,
+    ];
+    if (record.uptime) {
+        lines.push(`⏱️  运行时长: ${formatUptime(record.uptime)}`);
+    }
+    if (record.memory) {
+        lines.push(`💾 内存: ${record.memory} MB`);
+    }
+    lines.push('', `📈 统计:`);
+    lines.push(`  • 总重启: ${processState.restartCount} 次`);
+    lines.push(`  • 崩溃: ${processState.crashCount} 次`);
+    lines.push(`  • 累计运行: ${formatUptime(processState.totalUptime)}`);
+    return lines.join('\n');
+}
+export function formatUptime(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}天${hours % 24}小时`;
+    if (hours > 0)
+        return `${hours}小时${minutes % 60}分钟`;
+    if (minutes > 0)
+        return `${minutes}分钟`;
+    return `${seconds}秒`;
+}
+async function sendNotification(record) {
+    const message = formatNotificationMessage(record);
+    for (const channel of config.notifyChannels || []) {
+        try {
+            if (channel.type === 'webhook') {
+                await fetch(channel.target, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ event: 'process_restart', data: record, stats: processState }),
+                });
+                logger.debug(`Webhook 通知已发送: ${channel.target}`);
+            }
+        }
+        catch (error) {
+            logger.error(`发送通知失败 (${channel.type}):`, error);
+        }
+    }
+}
+// ─── 初始化 ──────────────────────────────────────────────────────────────────
+if (config.enabled) {
+    loadProcessState();
+    detectStartupReason();
+    process.on('SIGTERM', () => {
+        logger.info(formatCompact({ op: 'shutdown', signal: 'SIGTERM' }));
+        saveProcessState();
+    });
+    process.on('SIGINT', () => {
+        logger.info(formatCompact({ op: 'shutdown', signal: 'SIGINT' }));
+        saveProcessState();
+    });
+}
+// AI 工具已迁移到 tools/*.tool.md，框架自动发现注册
+export default plugin;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/process-monitor",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "进程监控与重启通知插件",
   "type": "module",
   "main": "./lib/index.js",
@@ -39,14 +39,15 @@
     "directory": "plugins/features/process-monitor"
   },
   "dependencies": {
-    "zhin.js": "2.0.0"
+    "zhin.js": "3.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
-    "typescript": "^6.0.3"
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3",
+    "zhin.js": "3.0.0"
   },
   "peerDependencies": {
-    "zhin.js": "2.0.0"
+    "zhin.js": "3.0.0"
   },
   "scripts": {
     "build": "tsc",