@zhin.js/process-monitor 1.0.1 → 1.1.0

package/commands/process-status.js

@@ -0,0 +1,9 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { formatProcessStatus } from "../lib/monitor.js";
+export default defineCommand({
+    description: '查看进程监控状态（PID、运行时长、重启统计）',
+    execute() {
+        return formatProcessStatus();
+    },
+});

package/commands/process-status.ts

@@ -0,0 +1,9 @@
+import { defineCommand } from 'zhin.js/command';
+import { formatProcessStatus, type ProcessMonitorConfig } from '../src/monitor.js';
+
+export default defineCommand<ProcessMonitorConfig>({
+  description: '查看进程监控状态（PID、运行时长、重启统计）',
+  execute() {
+    return formatProcessStatus();
+  },
+});

package/lib/index.d.ts

@@ -1,13 +1,3 @@
-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;
+export { classifyStartup, formatProcessStatus, formatUptime, processState, resetProcessMonitorForTests, resolveProcessMonitorConfig, startProcessMonitor, startTime, } from './monitor.js';
+export type { NotifyChannel, ProcessMonitorConfig, ProcessState, StartupReason } from './monitor.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,EACnB,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/lib/index.js

@@ -1,169 +1,2 @@
-/**
- * @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;
+export { classifyStartup, formatProcessStatus, formatUptime, processState, resetProcessMonitorForTests, resolveProcessMonitorConfig, startProcessMonitor, startTime, } from './monitor.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAC3B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;AAkBhC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5C,MAAM,SAAS,GAAG,aAAa,EAAE,UAAU,EAAkC,IAAI,EAAE,CAAC;AACpF,MAAM,MAAM,GAAW;IACrB,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,IAAI;IACnB,GAAG,SAAS,CAAC,iBAAiB,CAAC;CAChC,CAAC;AAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAU1E,MAAM,CAAC,IAAI,YAAY,GAAiB;IACtC,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAEpC,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAClD,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,aAAa,CAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,aAAa,CAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,4EAA4E;AAE5E,KAAK,UAAU,mBAAmB;IAChC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAkC,OAAO,CAAC;IACpD,IAAI,MAA0B,CAAC;IAE/B,IAAI,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;QACvD,MAAM,kBAAkB,GAAG,WAAW,GAAG,YAAY,CAAC,aAAa,CAAC;QAEpE,IAAI,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACvC,MAAM,GAAG,OAAO,CAAC;YACjB,YAAY,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAE,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACtH,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,SAAS,CAAC;YACnB,YAAY,CAAC,YAAY,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAE,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,GAAG,kBAAkB,CAAC;QAC5B,YAAY,CAAC,WAAW,IAAI,MAAM,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,YAAY,CAAC,OAAO,GAAG,UAAU,CAAC;IAClC,YAAY,CAAC,aAAa,GAAG,WAAW,CAAC;IACzC,gBAAgB,EAAE,CAAC;IAEnB,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,MAAM;QACN,MAAM;QACN,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE;QACvB,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACzC,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;KACjE,CAAC;IAEF,MAAM,YAAY,GAChB,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC;QAC5C,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,CAAC;QAChD,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAE/C,IAAI,YAAY,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9E,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E,SAAS,yBAAyB,CAAC,MAAW;IAC5C,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IACjF,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAE5F,MAAM,KAAK,GAAG;QACZ,GAAG,KAAK,WAAW;QACnB,EAAE;QACF,UAAU,UAAU,EAAE;QACtB,SAAS,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE;QACnD,YAAY,MAAM,CAAC,QAAQ,EAAE;QAC7B,WAAW,MAAM,CAAC,GAAG,EAAE;QACvB,UAAU,MAAM,CAAC,QAAQ,EAAE;QAC3B,YAAY,MAAM,CAAC,WAAW,EAAE;KACjC,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,aAAa,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,YAAY,YAAY,CAAC,YAAY,IAAI,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,WAAW,YAAY,CAAC,UAAU,IAAI,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,aAAa,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAElE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC;IAC/C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,EAAE,IAAI,CAAC;IACpD,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,IAAI,CAAC;IACvC,OAAO,GAAG,OAAO,GAAG,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,MAAW;IACzC,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;oBAC1B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;iBACtF,CAAC,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC;AAED,6EAA6E;AAE7E,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,gBAAgB,EAAE,CAAC;IACnB,mBAAmB,EAAE,CAAC;IAEtB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAE,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACnE,gBAAgB,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAE,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClE,gBAAgB,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qCAAqC;AAErC,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,EACnB,SAAS,GACV,MAAM,cAAc,CAAC"}

package/lib/monitor.d.ts

@@ -0,0 +1,43 @@
+export interface NotifyChannel {
+    type: 'user' | 'group' | 'webhook';
+    target: string;
+    platform?: string;
+}
+export interface ProcessMonitorConfig {
+    enabled?: boolean;
+    notifyChannels?: NotifyChannel[];
+    notifyOnStart?: boolean;
+    notifyOnRestart?: boolean;
+    notifyOnCrash?: boolean;
+}
+export interface ProcessState {
+    lastPid?: number;
+    lastStartTime?: number;
+    /** SIGTERM/SIGINT 正常退出时置 true，下次启动据此归为 restart 而非 crash。 */
+    cleanExit?: boolean;
+    restartCount: number;
+    crashCount: number;
+    totalUptime: number;
+}
+export declare let processState: ProcessState;
+export declare const startTime: number;
+export declare function resolveProcessMonitorConfig(raw: ProcessMonitorConfig | undefined): Required<Pick<ProcessMonitorConfig, 'enabled' | 'notifyOnStart' | 'notifyOnRestart' | 'notifyOnCrash'>> & {
+    notifyChannels: NotifyChannel[];
+};
+export declare function formatUptime(ms: number): string;
+export declare function formatProcessStatus(): string;
+export type StartupReason = 'start' | 'restart' | 'crash';
+/**
+ * Classify this startup from persisted state.
+ * - 同 PID（热重载，进程未退出）跳过判定，不算 restart/crash。
+ * - 上次为 SIGTERM/SIGINT 正常退出（cleanExit）时归为 restart，即使间隔 <5min。
+ */
+export declare function classifyStartup(state: ProcessState, currentPid: number, now?: number): {
+    reason: StartupReason;
+    uptime?: number;
+};
+/** Start monitoring once; returns disposer for lifecycle cleanup. */
+export declare function startProcessMonitor(rawConfig?: ProcessMonitorConfig): () => void;
+/** Test helper: reset module state without touching disk. */
+export declare function resetProcessMonitorForTests(): void;
+//# sourceMappingURL=monitor.d.ts.map

package/lib/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../src/monitor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,eAAO,IAAI,YAAY,EAAE,YAIxB,CAAC;AAEF,eAAO,MAAM,SAAS,QAAa,CAAC;AAKpC,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,oBAAoB,GAAG,SAAS,GACpC,QAAQ,CACT,IAAI,CACF,oBAAoB,EACpB,SAAS,GAAG,eAAe,GAAG,iBAAiB,GAAG,eAAe,CAClE,CACF,GAAG;IAAE,cAAc,EAAE,aAAa,EAAE,CAAA;CAAE,CAQtC;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAgB5C;AAkGD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,EAClB,GAAG,SAAa,GACf;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAQ5C;AAuCD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,MAAM,IAAI,CA6BhF;AAED,6DAA6D;AAC7D,wBAAgB,2BAA2B,IAAI,IAAI,CAQlD"}

package/lib/monitor.js

@@ -0,0 +1,209 @@
+/**
+ * Process monitor — module-level state + file-backed restart detection.
+ * No usePlugin; Plugin Runtime setup() calls startProcessMonitor().
+ */
+import os from 'node:os';
+import fs from 'node:fs';
+import path from 'node:path';
+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();
+let started = false;
+let signalHandlers = null;
+export function resolveProcessMonitorConfig(raw) {
+    return {
+        enabled: raw?.enabled ?? true,
+        notifyChannels: raw?.notifyChannels ?? [],
+        notifyOnStart: raw?.notifyOnStart ?? true,
+        notifyOnRestart: raw?.notifyOnRestart ?? true,
+        notifyOnCrash: raw?.notifyOnCrash ?? true,
+    };
+}
+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}秒`;
+}
+export function formatProcessStatus() {
+    const uptime = Date.now() - startTime;
+    const memUsage = process.memoryUsage();
+    return [
+        '📊 进程监控状态',
+        '',
+        `🚀 当前 PID: ${process.pid}`,
+        `⏱️  运行时长: ${formatUptime(uptime)}`,
+        `💾 内存使用: ${Math.round(memUsage.heapUsed / 1024 / 1024)} MB`,
+        `🔄 总重启: ${processState.restartCount} 次`,
+        `💥 崩溃: ${processState.crashCount} 次`,
+        `📈 累计运行: ${formatUptime(processState.totalUptime)}`,
+        `🖥️  主机: ${os.hostname()}`,
+        `💻 平台: ${os.platform()}-${os.arch()}`,
+        `📦 Node: ${process.version}`,
+    ].join('\n');
+}
+function loadProcessState() {
+    try {
+        if (fs.existsSync(STATE_FILE)) {
+            const data = fs.readFileSync(STATE_FILE, 'utf-8');
+            processState = JSON.parse(data);
+        }
+    }
+    catch {
+        // keep defaults
+    }
+}
+function saveProcessState() {
+    try {
+        fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
+        fs.writeFileSync(STATE_FILE, JSON.stringify(processState, null, 2));
+    }
+    catch {
+        // ignore
+    }
+}
+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');
+}
+async function sendNotification(config, record) {
+    // user/group 渠道尚未实现（需要接入 OutboundHost 出站链路），
+    // 目前仅支持 webhook；实现时用 formatNotificationMessage(record) 生成文本。
+    for (const channel of config.notifyChannels) {
+        if (channel.type !== 'webhook')
+            continue;
+        try {
+            await fetch(channel.target, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    event: 'process_restart',
+                    data: record,
+                    stats: processState,
+                }),
+            });
+        }
+        catch {
+            // ignore webhook errors
+        }
+    }
+}
+/**
+ * Classify this startup from persisted state.
+ * - 同 PID（热重载，进程未退出）跳过判定，不算 restart/crash。
+ * - 上次为 SIGTERM/SIGINT 正常退出（cleanExit）时归为 restart，即使间隔 <5min。
+ */
+export function classifyStartup(state, currentPid, now = Date.now()) {
+    if (!state.lastPid || !state.lastStartTime)
+        return { reason: 'start' };
+    if (state.lastPid === currentPid)
+        return { reason: 'start' };
+    const uptime = now - state.lastStartTime;
+    if (state.cleanExit === true || uptime >= 5 * 60 * 1000) {
+        return { reason: 'restart', uptime };
+    }
+    return { reason: 'crash', uptime };
+}
+async function detectStartupReason(config) {
+    const currentPid = process.pid;
+    const currentTime = Date.now();
+    const { reason, uptime } = classifyStartup(processState, currentPid, currentTime);
+    if (reason === 'crash')
+        processState.crashCount++;
+    else if (reason === 'restart')
+        processState.restartCount++;
+    if (uptime)
+        processState.totalUptime += uptime;
+    processState.cleanExit = false;
+    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.length > 0) {
+        await sendNotification(config, record);
+    }
+}
+/** Start monitoring once; returns disposer for lifecycle cleanup. */
+export function startProcessMonitor(rawConfig) {
+    const config = resolveProcessMonitorConfig(rawConfig);
+    if (!config.enabled || started) {
+        return () => undefined;
+    }
+    started = true;
+    loadProcessState();
+    void detectStartupReason(config);
+    const onSigterm = () => {
+        processState.cleanExit = true;
+        saveProcessState();
+    };
+    const onSigint = () => {
+        processState.cleanExit = true;
+        saveProcessState();
+    };
+    process.on('SIGTERM', onSigterm);
+    process.on('SIGINT', onSigint);
+    signalHandlers = { sigterm: onSigterm, sigint: onSigint };
+    return () => {
+        if (signalHandlers) {
+            process.removeListener('SIGTERM', signalHandlers.sigterm);
+            process.removeListener('SIGINT', signalHandlers.sigint);
+            signalHandlers = null;
+        }
+        started = false;
+    };
+}
+/** Test helper: reset module state without touching disk. */
+export function resetProcessMonitorForTests() {
+    if (signalHandlers) {
+        process.removeListener('SIGTERM', signalHandlers.sigterm);
+        process.removeListener('SIGINT', signalHandlers.sigint);
+        signalHandlers = null;
+    }
+    processState = { restartCount: 0, crashCount: 0, totalUptime: 0 };
+    started = false;
+}
+//# sourceMappingURL=monitor.js.map

package/lib/monitor.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/process-monitor",
-  "version": "1.0.1",
-  "description": "进程监控与重启通知插件",
+  "version": "1.1.0",
+  "description": "进程监控与重启通知插件 (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,13 +14,12 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.js",
+    "schema.json",
+    "commands",
+    "tools",
     "src",
     "lib",
-    "client",
-    "dist",
-    "skills",
-    "tools",
-    "plugin.yml",
     "README.md"
   ],
   "keywords": [
@@ -39,18 +38,51 @@
     "directory": "plugins/features/process-monitor"
   },
   "dependencies": {
-    "zhin.js": "2.0.1"
+    "@zhin.js/tool": "1.1.0"
   },
   "devDependencies": {
-    "@types/node": "^25.9.2",
+    "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
-    "zhin.js": "2.0.1"
+    "vitest": "^4.1.10",
+    "zhin.js": "1.1.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
   },
   "peerDependencies": {
-    "zhin.js": "2.0.1"
+    "@zhin.js/command": "^1.1.0",
+    "zhin.js": "^1.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/command": {
+      "optional": true
+    }
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch"
+    "clean": "rimraf lib",
+    "test": "vitest run --root ../../.. plugins/features/process-monitor/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin } from 'zhin.js';
+import { resolveProcessMonitorConfig, startProcessMonitor, } from "./lib/monitor.js";
+/**
+ * Process monitor Plugin Runtime cutover:
+ * - setup() owns file-backed restart detection + signal cleanup
+ * - commands/process-status for chat status
+ * - tools/process-status kept as agent tool surface
+ */
+export default definePlugin({
+    name: 'process-monitor',
+    metadata: {
+        displayName: 'Process Monitor',
+    },
+    setup(context) {
+        const config = resolveProcessMonitorConfig(context.config.get());
+        const dispose = startProcessMonitor(config);
+        context.lifecycle.add(dispose);
+    },
+});

package/schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "是否启用进程监控"
+    },
+    "notifyOnStart": {
+      "type": "boolean",
+      "default": true,
+      "description": "首次启动时通知"
+    },
+    "notifyOnRestart": {
+      "type": "boolean",
+      "default": true,
+      "description": "正常重启时通知"
+    },
+    "notifyOnCrash": {
+      "type": "boolean",
+      "default": true,
+      "description": "异常崩溃重启时通知"
+    },
+    "notifyChannels": {
+      "type": "array",
+      "default": [],
+      "description": "通知渠道（slice-1 仅 webhook 生效）",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "target"],
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["user", "group", "webhook"]
+          },
+          "target": { "type": "string" },
+          "platform": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/src/index.ts

@@ -1,220 +1,11 @@
-/**
- * @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;
-
-// ─── 配置 ────────────────────────────────────────────────────────────────────
-
-interface NotifyChannel {
-  type: 'user' | 'group' | 'webhook';
-  target: string;
-  platform?: string;
-}
-
-interface Config {
-  enabled?: boolean;
-  notifyChannels?: NotifyChannel[];
-  notifyOnStart?: boolean;
-  notifyOnRestart?: boolean;
-  notifyOnCrash?: boolean;
-}
-
-const configService = root.inject('config');
-const appConfig = configService?.getPrimary<{ 'process-monitor'?: Config }>() || {};
-const config: 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');
-
-interface ProcessState {
-  lastPid?: number;
-  lastStartTime?: number;
-  restartCount: number;
-  crashCount: number;
-  totalUptime: number;
-}
-
-export let processState: 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' | 'restart' | 'crash' = 'start';
-  let uptime: number | undefined;
-
-  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: any): string {
-  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: number): string {
-  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: any) {
-  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;
+export {
+  classifyStartup,
+  formatProcessStatus,
+  formatUptime,
+  processState,
+  resetProcessMonitorForTests,
+  resolveProcessMonitorConfig,
+  startProcessMonitor,
+  startTime,
+} from './monitor.js';
+export type { NotifyChannel, ProcessMonitorConfig, ProcessState, StartupReason } from './monitor.js';

package/src/monitor.ts

@@ -0,0 +1,288 @@
+/**
+ * Process monitor — module-level state + file-backed restart detection.
+ * No usePlugin; Plugin Runtime setup() calls startProcessMonitor().
+ */
+import os from 'node:os';
+import fs from 'node:fs';
+import path from 'node:path';
+
+export interface NotifyChannel {
+  type: 'user' | 'group' | 'webhook';
+  target: string;
+  platform?: string;
+}
+
+export interface ProcessMonitorConfig {
+  enabled?: boolean;
+  notifyChannels?: NotifyChannel[];
+  notifyOnStart?: boolean;
+  notifyOnRestart?: boolean;
+  notifyOnCrash?: boolean;
+}
+
+export interface ProcessState {
+  lastPid?: number;
+  lastStartTime?: number;
+  /** SIGTERM/SIGINT 正常退出时置 true，下次启动据此归为 restart 而非 crash。 */
+  cleanExit?: boolean;
+  restartCount: number;
+  crashCount: number;
+  totalUptime: number;
+}
+
+const STATE_FILE = path.join(process.cwd(), 'data', 'process-state.json');
+
+export let processState: ProcessState = {
+  restartCount: 0,
+  crashCount: 0,
+  totalUptime: 0,
+};
+
+export const startTime = Date.now();
+
+let started = false;
+let signalHandlers: { sigterm: () => void; sigint: () => void } | null = null;
+
+export function resolveProcessMonitorConfig(
+  raw: ProcessMonitorConfig | undefined,
+): Required<
+  Pick<
+    ProcessMonitorConfig,
+    'enabled' | 'notifyOnStart' | 'notifyOnRestart' | 'notifyOnCrash'
+  >
+> & { notifyChannels: NotifyChannel[] } {
+  return {
+    enabled: raw?.enabled ?? true,
+    notifyChannels: raw?.notifyChannels ?? [],
+    notifyOnStart: raw?.notifyOnStart ?? true,
+    notifyOnRestart: raw?.notifyOnRestart ?? true,
+    notifyOnCrash: raw?.notifyOnCrash ?? true,
+  };
+}
+
+export function formatUptime(ms: number): string {
+  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}秒`;
+}
+
+export function formatProcessStatus(): string {
+  const uptime = Date.now() - startTime;
+  const memUsage = process.memoryUsage();
+  return [
+    '📊 进程监控状态',
+    '',
+    `🚀 当前 PID: ${process.pid}`,
+    `⏱️  运行时长: ${formatUptime(uptime)}`,
+    `💾 内存使用: ${Math.round(memUsage.heapUsed / 1024 / 1024)} MB`,
+    `🔄 总重启: ${processState.restartCount} 次`,
+    `💥 崩溃: ${processState.crashCount} 次`,
+    `📈 累计运行: ${formatUptime(processState.totalUptime)}`,
+    `🖥️  主机: ${os.hostname()}`,
+    `💻 平台: ${os.platform()}-${os.arch()}`,
+    `📦 Node: ${process.version}`,
+  ].join('\n');
+}
+
+function loadProcessState(): void {
+  try {
+    if (fs.existsSync(STATE_FILE)) {
+      const data = fs.readFileSync(STATE_FILE, 'utf-8');
+      processState = JSON.parse(data);
+    }
+  } catch {
+    // keep defaults
+  }
+}
+
+function saveProcessState(): void {
+  try {
+    fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
+    fs.writeFileSync(STATE_FILE, JSON.stringify(processState, null, 2));
+  } catch {
+    // ignore
+  }
+}
+
+function formatNotificationMessage(record: {
+  reason: string;
+  timestamp: Date;
+  hostname: string;
+  pid: number;
+  platform: string;
+  nodeVersion: string;
+  uptime?: number;
+  memory?: number;
+}): string {
+  const emoji = ({ start: '🚀', restart: '🔄', crash: '💥' } as Record<string, string>)[
+    record.reason
+  ] || '📊';
+  const reasonText = (
+    { start: '首次启动', restart: '正常重启', crash: '异常崩溃' } as Record<string, string>
+  )[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');
+}
+
+async function sendNotification(
+  config: ReturnType<typeof resolveProcessMonitorConfig>,
+  record: {
+    reason: string;
+    timestamp: Date;
+    hostname: string;
+    pid: number;
+    platform: string;
+    nodeVersion: string;
+    uptime?: number;
+    memory?: number;
+  },
+): Promise<void> {
+  // user/group 渠道尚未实现（需要接入 OutboundHost 出站链路），
+  // 目前仅支持 webhook；实现时用 formatNotificationMessage(record) 生成文本。
+  for (const channel of config.notifyChannels) {
+    if (channel.type !== 'webhook') continue;
+    try {
+      await fetch(channel.target, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          event: 'process_restart',
+          data: record,
+          stats: processState,
+        }),
+      });
+    } catch {
+      // ignore webhook errors
+    }
+  }
+}
+
+export type StartupReason = 'start' | 'restart' | 'crash';
+
+/**
+ * Classify this startup from persisted state.
+ * - 同 PID（热重载，进程未退出）跳过判定，不算 restart/crash。
+ * - 上次为 SIGTERM/SIGINT 正常退出（cleanExit）时归为 restart，即使间隔 <5min。
+ */
+export function classifyStartup(
+  state: ProcessState,
+  currentPid: number,
+  now = Date.now(),
+): { reason: StartupReason; uptime?: number } {
+  if (!state.lastPid || !state.lastStartTime) return { reason: 'start' };
+  if (state.lastPid === currentPid) return { reason: 'start' };
+  const uptime = now - state.lastStartTime;
+  if (state.cleanExit === true || uptime >= 5 * 60 * 1000) {
+    return { reason: 'restart', uptime };
+  }
+  return { reason: 'crash', uptime };
+}
+
+async function detectStartupReason(
+  config: ReturnType<typeof resolveProcessMonitorConfig>,
+): Promise<void> {
+  const currentPid = process.pid;
+  const currentTime = Date.now();
+
+  const { reason, uptime } = classifyStartup(processState, currentPid, currentTime);
+  if (reason === 'crash') processState.crashCount++;
+  else if (reason === 'restart') processState.restartCount++;
+  if (uptime) processState.totalUptime += uptime;
+
+  processState.cleanExit = false;
+  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.length > 0) {
+    await sendNotification(config, record);
+  }
+}
+
+/** Start monitoring once; returns disposer for lifecycle cleanup. */
+export function startProcessMonitor(rawConfig?: ProcessMonitorConfig): () => void {
+  const config = resolveProcessMonitorConfig(rawConfig);
+  if (!config.enabled || started) {
+    return () => undefined;
+  }
+  started = true;
+  loadProcessState();
+  void detectStartupReason(config);
+
+  const onSigterm = () => {
+    processState.cleanExit = true;
+    saveProcessState();
+  };
+  const onSigint = () => {
+    processState.cleanExit = true;
+    saveProcessState();
+  };
+  process.on('SIGTERM', onSigterm);
+  process.on('SIGINT', onSigint);
+  signalHandlers = { sigterm: onSigterm, sigint: onSigint };
+
+  return () => {
+    if (signalHandlers) {
+      process.removeListener('SIGTERM', signalHandlers.sigterm);
+      process.removeListener('SIGINT', signalHandlers.sigint);
+      signalHandlers = null;
+    }
+    started = false;
+  };
+}
+
+/** Test helper: reset module state without touching disk. */
+export function resetProcessMonitorForTests(): void {
+  if (signalHandlers) {
+    process.removeListener('SIGTERM', signalHandlers.sigterm);
+    process.removeListener('SIGINT', signalHandlers.sigint);
+    signalHandlers = null;
+  }
+  processState = { restartCount: 0, crashCount: 0, totalUptime: 0 };
+  started = false;
+}

package/tools/process-status.js

@@ -0,0 +1,12 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { formatProcessStatus } from "../lib/monitor.js";
+export default defineAgentTool({
+    description: '查看进程监控状态，包括 PID、运行时长、内存、重启和崩溃统计',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+    approval: 'never',
+    execute: () => formatProcessStatus(),
+});

package/tools/process-status.ts

@@ -0,0 +1,12 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { formatProcessStatus } from '../src/monitor.js';
+
+export default defineAgentTool({
+  description: '查看进程监控状态，包括 PID、运行时长、内存、重启和崩溃统计',
+  inputSchema: {
+    type: 'object',
+    properties: {},
+  },
+  approval: 'never',
+  execute: () => formatProcessStatus(),
+});

package/plugin.yml

@@ -1,2 +0,0 @@
-name: process-monitor
-description: 进程监控与重启通知插件，提供进程状态查看和异常通知

package/tools/process-status/handler.ts

@@ -1,21 +0,0 @@
-import os from 'os';
-import { processState, startTime, formatUptime } from '../../src/index.js';
-
-export default async function processStatus(): Promise<string> {
-  const uptime = Date.now() - startTime;
-  const memUsage = process.memoryUsage();
-
-  return [
-    '📊 进程监控状态',
-    '',
-    `🚀 当前 PID: ${process.pid}`,
-    `⏱️  运行时长: ${formatUptime(uptime)}`,
-    `💾 内存使用: ${Math.round(memUsage.heapUsed / 1024 / 1024)} MB`,
-    `🔄 总重启: ${processState.restartCount} 次`,
-    `💥 崩溃: ${processState.crashCount} 次`,
-    `📈 累计运行: ${formatUptime(processState.totalUptime)}`,
-    `🖥️  主机: ${os.hostname()}`,
-    `💻 平台: ${os.platform()}-${os.arch()}`,
-    `📦 Node: ${process.version}`,
-  ].join('\n');
-}

package/tools/process-status/process-status.tool.md

@@ -1,7 +0,0 @@
----
-name: process_status
-description: 查看进程监控状态，包括 PID、运行时长、内存、重启和崩溃统计
-tags: [监控, 进程]
-keywords: [进程状态, 监控状态, process status]
-handler: ./handler.ts
----