koishi-plugin-docker-control 0.0.5 → 0.0.7

package/lib/commands/control.js

@@ -3,6 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerControlCommands = registerControlCommands;
 const logger_1 = require("../utils/logger");
 const render_1 = require("../utils/render");
+/**
+ * 格式化网络流量显示
+ */
+function formatNet(bytes) {
+    const num = parseFloat(bytes);
+    if (isNaN(num))
+        return '-';
+    if (num < 1024)
+        return bytes + 'B';
+    if (num < 1024 * 1024)
+        return (num / 1024).toFixed(1) + 'KB';
+    return (num / 1024 / 1024).toFixed(2) + 'MB';
+}
 /**
  * 格式化容器搜索结果
  */
@@ -35,7 +48,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.start <selector> <container>', '启动容器')
-        .alias('docker启动', '容器启动', 'docker开启', '容器开启')
+        .alias('容器启动', '启动', '容器开启')
         .option('async', '-a 异步执行，不等待结果', { fallback: false })
         .action(async ({ options }, selector, container) => {
         logger_1.commandLogger.debug(`docker.start 被调用: selector=${selector}, container=${container}`);
@@ -84,7 +97,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.stop <selector> <container>', '停止容器')
-        .alias('docker停止', '容器停止', 'docker关闭', '容器关闭')
+        .alias('容器停止', '停止', '容器关闭')
         .option('async', '-a 异步执行，不等待结果', { fallback: false })
         .action(async ({ options }, selector, container) => {
         logger_1.commandLogger.debug(`docker.stop 被调用: selector=${selector}, container=${container}`);
@@ -127,7 +140,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.restart <selector> <container>', '重启容器')
-        .alias('docker重启', '容器重启')
+        .alias('容器重启', '重启')
         .option('async', '-a 异步执行，不等待结果', { fallback: false })
         .action(async ({ options }, selector, container) => {
         logger_1.commandLogger.debug(`docker.restart 被调用: selector=${selector}, container=${container}`);
@@ -170,7 +183,7 @@ function registerControlCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.inspect <selector> <container>', '查看容器详情')
-        .alias('docker详情', '容器详情', 'docker检查', '容器检查')
+        .alias('容器详情', '容器检查', '检查')
         .action(async (_, selector, container) => {
         const service = getService();
         if (!service) {
@@ -179,8 +192,13 @@ function registerControlCommands(ctx, getService, config) {
         try {
             const { node, container: found } = await service.findContainer(selector, container);
             const info = await node.getContainer(found.Id);
+            // 获取性能数据和端口映射
+            const [stats, ports] = await Promise.all([
+                node.getContainerStats(found.Id),
+                node.getContainerPorts(found.Id),
+            ]);
             if (useImageOutput && ctx.puppeteer) {
-                const html = (0, render_1.generateInspectHtml)(node.name, info);
+                const html = (0, render_1.generateInspectHtml)(node.name, info, stats, ports);
                 return await (0, render_1.renderToImage)(ctx, html);
             }
             const lines = [
@@ -192,6 +210,23 @@ function registerControlCommands(ctx, getService, config) {
                 `启动时间: ${info.State.StartedAt}`,
                 `重启次数: ${info.RestartCount || 0}`,
             ];
+            // 添加性能数据
+            if (stats) {
+                lines.push('');
+                lines.push('性能监控:');
+                lines.push(`  CPU: ${stats.cpuPercent}`);
+                lines.push(`  内存: ${stats.memoryPercent} (${stats.memoryUsage} / ${stats.memoryLimit})`);
+                lines.push(`  网络: ${formatNet(stats.networkIn)} / ${formatNet(stats.networkOut)}`);
+                lines.push(`  进程: ${stats.pids}`);
+            }
+            // 添加端口映射
+            if (ports && ports.length > 0) {
+                lines.push('');
+                lines.push('端口映射:');
+                for (const port of ports) {
+                    lines.push(`  ${port}`);
+                }
+            }
             if (info.State.Health) {
                 lines.push(`健康状态: ${info.State.Health.Status}`);
             }

package/lib/commands/index.js

@@ -5,6 +5,8 @@ const list_1 = require("./list");
 const control_1 = require("./control");
 const logs_1 = require("./logs");
 const compose_1 = require("./compose");
+const resources_1 = require("./resources");
+const update_1 = require("./update");
 const render_1 = require("../utils/render");
 /**
  * 注册所有指令
@@ -15,6 +17,8 @@ function registerCommands(ctx, getService, config) {
     (0, control_1.registerControlCommands)(ctx, getService, config);
     (0, logs_1.registerLogsCommand)(ctx, getService, config);
     (0, compose_1.registerComposeCommand)(ctx, getService, config);
+    (0, resources_1.registerResourceCommands)(ctx, getService, config);
+    (0, update_1.registerUpdateCommands)(ctx, getService);
     // 注册辅助指令
     registerHelperCommands(ctx, getService, config);
 }
@@ -26,7 +30,7 @@ function registerHelperCommands(ctx, getService, config) {
     /**
      * 查看节点列表
      */
-    ctx.command('docker.nodes', '查看节点').alias('docker节点', '容器节点').action(async () => {
+    ctx.command('docker.nodes', '查看节点').alias('节点列表', '节点').action(async () => {
         const service = getService();
         if (!service) {
             return 'Docker 服务未初始化';
@@ -58,7 +62,7 @@ function registerHelperCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.node <selector>', '查看节点详情')
-        .alias('docker节点详情', '容器节点详情')
+        .alias('节点详情', '查看节点')
         .action(async (_, selector) => {
         const service = getService();
         if (!service) {
@@ -116,7 +120,7 @@ function registerHelperCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.find <container>', '搜索容器')
-        .alias('docker查找', '容器查找', 'docker搜索', '容器搜索')
+        .alias('查找容器', '搜索', '查找')
         .option('all', '-a 包含已停止的容器', { fallback: false })
         .action(async ({ options }, container) => {
         const service = getService();
@@ -145,7 +149,7 @@ function registerHelperCommands(ctx, getService, config) {
      */
     ctx
         .command('docker.exec <container> <cmd>', '在容器中执行命令')
-        .alias('docker执行', '容器执行', 'dockerexec', 'dockercmd', 'docker命令', '容器命令')
+        .alias('容器执行', '执行')
         .option('node', '-n <node> 指定节点', { fallback: '' })
         .action(async ({ options }, container, cmd) => {
         const service = getService();
@@ -183,7 +187,7 @@ function registerHelperCommands(ctx, getService, config) {
     /**
      * 查看帮助
      */
-    ctx.command('docker.help', '查看帮助').alias('docker帮助', 'docker帮助', '容器帮助').action(async () => {
+    ctx.command('docker.help', '查看帮助').alias('帮助').action(async () => {
         return [
             '=== Docker Control 帮助 ===',
             '',
@@ -191,8 +195,8 @@ function registerHelperCommands(ctx, getService, config) {
             '  docker.nodes               - 查看节点列表',
             '  docker.node <节点>         - 查看节点详情',
             '',
-            '【容器操作】(参数顺序: 节点 容器)',
-            '  docker.ls <节点>           - 列出容器',
+            '【容器操作】',
+            '  docker.ls <节点>           - 列出容器 [-f image]',
             '  docker.start <节点> <容器> - 启动容器',
             '  docker.stop <节点> <容器>  - 停止容器',
             '  docker.restart <节点> <容器> - 重启容器',
@@ -200,11 +204,26 @@ function registerHelperCommands(ctx, getService, config) {
             '  docker.inspect <节点> <容器> - 查看容器详情',
             '  docker.exec <节点> <容器> <命令> - 在容器内执行命令',
             '',
+            '【更新操作】',
+            '  docker.check <节点> <容器> - 检查镜像更新',
+            '  docker.update <节点> <容器> [-b] - 更新容器 (-b 备份)',
+            '  docker.backup <节点> <容器> [tag] - 备份容器为镜像',
+            '  docker.set <节点> <容器> -e KEY=VALUE - 修改环境变量',
+            '',
+            '【资源操作】',
+            '  docker.images <节点>       - 查看镜像列表 [-f image]',
+            '  docker.networks <节点>     - 查看网络列表 [-f image]',
+            '  docker.volumes <节点>      - 查看存储卷列表 [-f image]',
+            '',
             '【节点选择器】',
             '  all        - 所有节点',
             '  @标签      - 指定标签的节点',
             '  节点ID/名称 - 指定单个节点',
             '',
+            '【输出格式】',
+            '  -f simple   - 文本格式（默认）',
+            '  -f image    - 图片格式（需要 puppeteer 插件）',
+            '',
             '【通知事件类型】',
             '  container.start/stop/restart/die',
             '  container.health_status',

package/lib/commands/list.js

@@ -8,7 +8,7 @@ function registerListCommand(ctx, getService, config) {
     const useImageOutput = config?.imageOutput === true;
     ctx
         .command('docker.ls [selector]', '列出容器')
-        .alias('docker列表', '容器列表', 'dockercs', '容器查看', 'docker查看')
+        .alias('容器列表', '查看容器', '列表')
         .option('all', '-a 列出所有容器，包括已停止', { fallback: false })
         .option('format', '-f <format> 输出格式: simple|detail|json|image', {
         fallback: null, // 由 config.imageOutput 决定

package/lib/commands/logs.js

@@ -16,7 +16,7 @@ function registerLogsCommand(ctx, getService, config) {
     const useImageOutput = config?.imageOutput === true;
     ctx
         .command('docker.logs <node> <container>', '查看容器日志')
-        .alias('docker日志', '容器日志', 'docker查看日志', '容器查看日志', 'dockerlogs')
+        .alias('容器日志', '查看日志', '日志')
         .option('lines', '-n <lines:number> 显示最后 N 行')
         .option('timestamp', '-t 显示时间戳')
         .option('all', '-a 显示全部（不截断）')

package/lib/commands/resources.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 资源列表指令（镜像、网络、存储卷）
+ */
+import { Context } from 'koishi';
+export declare function registerResourceCommands(ctx: Context, getService: () => any, config?: any): void;

package/lib/commands/resources.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerResourceCommands = registerResourceCommands;
+const logger_1 = require("../utils/logger");
+const render_1 = require("../utils/render");
+function registerResourceCommands(ctx, getService, config) {
+    // 检查是否启用了图片输出
+    const useImageOutput = config?.imageOutput === true;
+    /**
+     * 查看镜像列表
+     */
+    ctx
+        .command('docker.images [selector]', '查看镜像列表')
+        .alias('镜像列表', '查看镜像', '容器镜像')
+        .option('format', '-f <format> 输出格式: simple|image', {
+        fallback: null, // 由 config.imageOutput 决定
+    })
+        .action(async ({ options }, selector) => {
+        logger_1.commandLogger.debug(`docker.images 被调用: selector=${selector}, format=${options.format}`);
+        const service = getService();
+        if (!service) {
+            logger_1.commandLogger.debug('服务未初始化');
+            return 'Docker 服务未初始化';
+        }
+        if (!selector) {
+            return '请指定节点名称、ID 或标签，或使用 "all" 列出全部镜像\n例如: docker.images @web 或 docker.images all';
+        }
+        const format = options.format || (useImageOutput ? 'image' : 'simple');
+        // 图片渲染模式
+        if (format === 'image') {
+            logger_1.commandLogger.debug('使用图片渲染模式');
+            if (!ctx.puppeteer) {
+                return '错误: 未安装 koishi-plugin-puppeteer 插件，无法使用图片渲染';
+            }
+            try {
+                const nodes = service.getNodesBySelector(selector);
+                if (nodes.length === 0) {
+                    return `未找到节点: ${selector}`;
+                }
+                const results = [];
+                for (const node of nodes) {
+                    if (node.status !== 'connected')
+                        continue;
+                    const images = await node.listImages();
+                    results.push({ node, images });
+                }
+                if (results.length === 0) {
+                    return '所有指定节点均未连接';
+                }
+                const html = (0, render_1.generateImagesHtml)(results, `镜像列表 (${selector})`);
+                return await (0, render_1.renderToImage)(ctx, html);
+            }
+            catch (e) {
+                logger_1.commandLogger.error(`图片渲染失败: ${e.message}`);
+                return `错误: ${e.message}`;
+            }
+        }
+        // 文字模式
+        try {
+            const nodes = service.getNodesBySelector(selector);
+            if (nodes.length === 0) {
+                return `未找到节点: ${selector}`;
+            }
+            const lines = [];
+            for (const node of nodes) {
+                if (node.status !== 'connected') {
+                    lines.push(`=== ${node.name} ===`);
+                    lines.push('  (未连接)');
+                    lines.push('');
+                    continue;
+                }
+                const images = await node.listImages();
+                lines.push(`=== ${node.name} (${images.length} 个镜像) ===`);
+                if (images.length === 0) {
+                    lines.push('  (无镜像)');
+                }
+                else {
+                    for (const img of images) {
+                        const shortId = img.Id.slice(0, 12);
+                        const tag = img.Tag === '<none>' ? '<none>' : img.Tag;
+                        lines.push(`  ${img.Repository}:${tag}`);
+                        lines.push(`    ID: ${shortId} | 大小: ${img.Size} | 创建: ${img.Created}`);
+                    }
+                }
+                lines.push('');
+            }
+            return lines.join('\n').trim();
+        }
+        catch (e) {
+            logger_1.commandLogger.error(`列出镜像失败: ${e.message}`);
+            return `错误: ${e.message}`;
+        }
+    });
+    /**
+     * 查看网络列表
+     */
+    ctx
+        .command('docker.networks [selector]', '查看网络列表')
+        .alias('网络列表', '查看网络', '容器网络')
+        .option('format', '-f <format> 输出格式: simple|image', {
+        fallback: null, // 由 config.imageOutput 决定
+    })
+        .action(async ({ options }, selector) => {
+        logger_1.commandLogger.debug(`docker.networks 被调用: selector=${selector}, format=${options.format}`);
+        const service = getService();
+        if (!service) {
+            logger_1.commandLogger.debug('服务未初始化');
+            return 'Docker 服务未初始化';
+        }
+        if (!selector) {
+            return '请指定节点名称、ID 或标签，或使用 "all" 列出全部网络\n例如: docker.networks @web 或 docker.networks all';
+        }
+        const format = options.format || (useImageOutput ? 'image' : 'simple');
+        // 图片渲染模式
+        if (format === 'image') {
+            logger_1.commandLogger.debug('使用图片渲染模式');
+            if (!ctx.puppeteer) {
+                return '错误: 未安装 koishi-plugin-puppeteer 插件，无法使用图片渲染';
+            }
+            try {
+                const nodes = service.getNodesBySelector(selector);
+                if (nodes.length === 0) {
+                    return `未找到节点: ${selector}`;
+                }
+                const results = [];
+                for (const node of nodes) {
+                    if (node.status !== 'connected')
+                        continue;
+                    const networks = await node.listNetworks();
+                    results.push({ node, networks });
+                }
+                if (results.length === 0) {
+                    return '所有指定节点均未连接';
+                }
+                const html = (0, render_1.generateNetworksHtml)(results, `网络列表 (${selector})`);
+                return await (0, render_1.renderToImage)(ctx, html);
+            }
+            catch (e) {
+                logger_1.commandLogger.error(`图片渲染失败: ${e.message}`);
+                return `错误: ${e.message}`;
+            }
+        }
+        // 文字模式
+        try {
+            const nodes = service.getNodesBySelector(selector);
+            if (nodes.length === 0) {
+                return `未找到节点: ${selector}`;
+            }
+            const lines = [];
+            for (const node of nodes) {
+                if (node.status !== 'connected') {
+                    lines.push(`=== ${node.name} ===`);
+                    lines.push('  (未连接)');
+                    lines.push('');
+                    continue;
+                }
+                const networks = await node.listNetworks();
+                lines.push(`=== ${node.name} (${networks.length} 个网络) ===`);
+                if (networks.length === 0) {
+                    lines.push('  (无网络)');
+                }
+                else {
+                    for (const net of networks) {
+                        const shortId = net.Id.slice(0, 12);
+                        lines.push(`  ${net.Name}`);
+                        lines.push(`    ID: ${shortId} | 驱动: ${net.Driver} | 范围: ${net.Scope}`);
+                        if (net.Subnet !== '-') {
+                            lines.push(`    子网: ${net.Subnet} | 网关: ${net.Gateway}`);
+                        }
+                    }
+                }
+                lines.push('');
+            }
+            return lines.join('\n').trim();
+        }
+        catch (e) {
+            logger_1.commandLogger.error(`列出网络失败: ${e.message}`);
+            return `错误: ${e.message}`;
+        }
+    });
+    /**
+     * 查看存储卷列表
+     */
+    ctx
+        .command('docker.volumes [selector]', '查看存储卷列表')
+        .alias('存储卷列表', '查看存储卷', '容器存储卷', '容器卷')
+        .option('format', '-f <format> 输出格式: simple|image', {
+        fallback: null, // 由 config.imageOutput 决定
+    })
+        .action(async ({ options }, selector) => {
+        logger_1.commandLogger.debug(`docker.volumes 被调用: selector=${selector}, format=${options.format}`);
+        const service = getService();
+        if (!service) {
+            logger_1.commandLogger.debug('服务未初始化');
+            return 'Docker 服务未初始化';
+        }
+        if (!selector) {
+            return '请指定节点名称、ID 或标签，或使用 "all" 列出全部存储卷\n例如: docker.volumes @web 或 docker.volumes all';
+        }
+        const format = options.format || (useImageOutput ? 'image' : 'simple');
+        // 图片渲染模式
+        if (format === 'image') {
+            logger_1.commandLogger.debug('使用图片渲染模式');
+            if (!ctx.puppeteer) {
+                return '错误: 未安装 koishi-plugin-puppeteer 插件，无法使用图片渲染';
+            }
+            try {
+                const nodes = service.getNodesBySelector(selector);
+                if (nodes.length === 0) {
+                    return `未找到节点: ${selector}`;
+                }
+                const results = [];
+                for (const node of nodes) {
+                    if (node.status !== 'connected')
+                        continue;
+                    const volumes = await node.listVolumes();
+                    results.push({ node, volumes });
+                }
+                if (results.length === 0) {
+                    return '所有指定节点均未连接';
+                }
+                const html = (0, render_1.generateVolumesHtml)(results, `存储卷列表 (${selector})`);
+                return await (0, render_1.renderToImage)(ctx, html);
+            }
+            catch (e) {
+                logger_1.commandLogger.error(`图片渲染失败: ${e.message}`);
+                return `错误: ${e.message}`;
+            }
+        }
+        // 文字模式
+        try {
+            const nodes = service.getNodesBySelector(selector);
+            if (nodes.length === 0) {
+                return `未找到节点: ${selector}`;
+            }
+            const lines = [];
+            for (const node of nodes) {
+                if (node.status !== 'connected') {
+                    lines.push(`=== ${node.name} ===`);
+                    lines.push('  (未连接)');
+                    lines.push('');
+                    continue;
+                }
+                const volumes = await node.listVolumes();
+                lines.push(`=== ${node.name} (${volumes.length} 个存储卷) ===`);
+                if (volumes.length === 0) {
+                    lines.push('  (无存储卷)');
+                }
+                else {
+                    for (const vol of volumes) {
+                        lines.push(`  ${vol.Name}`);
+                        lines.push(`    驱动: ${vol.Driver} | 范围: ${vol.Scope}`);
+                        if (vol.Mountpoint !== '-') {
+                            lines.push(`    挂载点: ${vol.Mountpoint}`);
+                        }
+                        if (vol.Size !== '-') {
+                            lines.push(`    大小: ${vol.Size}`);
+                        }
+                    }
+                }
+                lines.push('');
+            }
+            return lines.join('\n').trim();
+        }
+        catch (e) {
+            logger_1.commandLogger.error(`列出存储卷失败: ${e.message}`);
+            return `错误: ${e.message}`;
+        }
+    });
+}

package/lib/commands/update.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 容器更新相关指令（检查更新、备份、修改环境变量）
+ */
+import { Context } from 'koishi';
+export declare function registerUpdateCommands(ctx: Context, getService: () => any): void;