koishi-plugin-docker-control 0.0.3 → 0.0.5

package/lib/commands/compose.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Docker Compose 命令 - 展示和发送 docker compose 配置
+ */
+import { Context } from 'koishi';
+import type { DockerControlConfig } from '../types';
+type GetService = () => any;
+/**
+ * 注册 docker.compose 命令
+ */
+export declare function registerComposeCommand(ctx: Context, getService: GetService, config?: DockerControlConfig): void;
+export {};

package/lib/commands/compose.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerComposeCommand = registerComposeCommand;
+/**
+ * Docker Compose 命令 - 展示和发送 docker compose 配置
+ */
+const koishi_1 = require("koishi");
+const render_1 = require("../utils/render");
+const logger_1 = require("../utils/logger");
+/**
+ * 注册 docker.compose 命令
+ */
+function registerComposeCommand(ctx, getService, config) {
+    const useImageOutput = config?.imageOutput === true;
+    ctx
+        .command('docker.compose <node> <container>', '展示 Docker Compose 配置')
+        .alias('dockercompose', 'compose', 'docker-compose')
+        .option('download', '-d 直接发送 compose 文件(base64编码)')
+        .option('image', '-i 强制使用图片展示')
+        .option('text', '-t 强制使用文字展示')
+        .action(async ({ options, session }, nodeSelector, container) => {
+        const service = getService();
+        if (!service) {
+            return 'Docker 服务未初始化';
+        }
+        if (!nodeSelector || !container) {
+            return '请指定节点和容器: docker.compose <节点> <容器>';
+        }
+        // 获取节点
+        const nodes = service.getNodesBySelector(nodeSelector);
+        if (nodes.length === 0) {
+            return `未找到节点: ${nodeSelector}`;
+        }
+        const node = nodes[0];
+        if (node.status !== 'connected') {
+            return `节点 ${node.name} 未连接`;
+        }
+        // 查找容器
+        let containers;
+        try {
+            containers = await node.listContainers(true);
+        }
+        catch (e) {
+            return `获取容器列表失败: ${e.message}`;
+        }
+        // 支持容器名称或 ID 前缀匹配
+        const targetContainer = containers.find(c => c.Names[0]?.replace('/', '') === container ||
+            c.Id.startsWith(container));
+        if (!targetContainer) {
+            return `未找到容器: ${container}`;
+        }
+        try {
+            // 获取 compose 文件信息
+            const composeInfo = await node.getComposeFileInfo(targetContainer.Id);
+            if (!composeInfo) {
+                return `容器 ${container} 不是由 Docker Compose 启动，或无法找到 compose 文件`;
+            }
+            // 如果指定了 -d 参数，作为文件发送
+            if (options.download) {
+                try {
+                    const filename = `${composeInfo.projectName}-docker-compose.yaml`;
+                    const buffer = Buffer.from(composeInfo.content, 'utf-8');
+                    // 1. 构建 Data URI 字符串
+                    // 使用 application/octet-stream 以避免适配器自作聪明改文件名
+                    const dataUri = 'data:application/octet-stream;base64,' + buffer.toString('base64');
+                    // === 方案 A: 优先尝试使用 assets 服务上传 ===
+                    if (ctx.assets) {
+                        try {
+                            logger_1.connectorLogger.debug(`[compose] 正在通过 assets 上传文件: ${filename}`);
+                            // 传入 Data URI 字符串
+                            const url = await ctx.assets.upload(dataUri, filename);
+                            logger_1.connectorLogger.info(`[compose] Assets 上传成功: ${url}`);
+                            // 直接发送 URL，文件名由 assets 插件的 URL 决定
+                            return koishi_1.h.file(url);
+                        }
+                        catch (e) {
+                            logger_1.connectorLogger.warn(`[compose] Assets 上传失败，尝试降级: ${e.message}`);
+                        }
+                    }
+                    // === 方案 B: 降级方案 ===
+                    // 失败后直接发送 Data URI
+                    logger_1.connectorLogger.debug(`[compose] 发送 DataURI (降级): filename=${filename}`);
+                    return koishi_1.h.file(dataUri, {
+                        filename: filename,
+                        name: filename,
+                    });
+                }
+                catch (e) {
+                    logger_1.connectorLogger.error(`[compose] 生成文件失败: ${e.message}`);
+                    return `生成文件失败: ${e.message}`;
+                }
+            }
+            // 判断使用图片还是文字展示
+            // -i 强制图片，-t 强制文字，都没指定则根据配置
+            const forceImage = options.image;
+            const forceText = options.text;
+            const shouldUseImage = forceImage || (!forceText && useImageOutput && ctx.puppeteer);
+            if (shouldUseImage) {
+                try {
+                    const html = (0, render_1.generateComposeHtml)(node.name, container, composeInfo.projectName, composeInfo.originalPath, composeInfo.serviceCount, composeInfo.content);
+                    return await (0, render_1.renderToImage)(ctx, html);
+                }
+                catch (e) {
+                    // 如果图片渲染失败，回退到文字
+                    if (e.message?.includes('puppeteer')) {
+                        return [
+                            `=== Docker Compose: ${composeInfo.projectName} ===`,
+                            `节点: ${node.name}`,
+                            `容器: ${container}`,
+                            `文件路径: ${composeInfo.originalPath}`,
+                            `服务数量: ${composeInfo.serviceCount}`,
+                            '',
+                            '--- compose.yaml ---',
+                            '',
+                            composeInfo.content,
+                        ].join('\n');
+                    }
+                    throw e;
+                }
+            }
+            // 文字展示
+            return [
+                `=== Docker Compose: ${composeInfo.projectName} ===`,
+                `节点: ${node.name}`,
+                `容器: ${container}`,
+                `文件路径: ${composeInfo.originalPath}`,
+                `服务数量: ${composeInfo.serviceCount}`,
+                '',
+                '--- compose.yaml ---',
+                '',
+                composeInfo.content,
+            ].join('\n');
+        }
+        catch (e) {
+            return `获取 compose 配置失败: ${e.message}`;
+        }
+    });
+}

package/lib/commands/control.js

@@ -219,12 +219,13 @@ function registerControlCommands(ctx, getService, config) {
         logger_1.commandLogger.info(`[${selector}] 执行命令: "${cmd}"`);
         try {
             const { node, container: found } = await service.findContainer(selector, container);
-            const result = await node.execContainer(found.Id, [
-                '/bin/sh',
-                '-c',
-                cmd,
-            ]);
+            const result = await node.execContainer(found.Id, cmd);
             const name = found.Names[0]?.replace('/', '') || found.Id.slice(0, 8);
+            // 图片渲染模式
+            if (useImageOutput && ctx.puppeteer) {
+                const html = (0, render_1.generateExecHtml)(node.name, name, cmd, result.output, result.exitCode);
+                return await (0, render_1.renderToImage)(ctx, html);
+            }
             if (result.output.trim()) {
                 return `=== ${node.name}: ${name} ===\n${result.output}`;
             }

package/lib/commands/index.js

@@ -4,6 +4,7 @@ exports.registerCommands = registerCommands;
 const list_1 = require("./list");
 const control_1 = require("./control");
 const logs_1 = require("./logs");
+const compose_1 = require("./compose");
 const render_1 = require("../utils/render");
 /**
  * 注册所有指令
@@ -13,6 +14,7 @@ function registerCommands(ctx, getService, config) {
     (0, list_1.registerListCommand)(ctx, getService, config);
     (0, control_1.registerControlCommands)(ctx, getService, config);
     (0, logs_1.registerLogsCommand)(ctx, getService, config);
+    (0, compose_1.registerComposeCommand)(ctx, getService, config);
     // 注册辅助指令
     registerHelperCommands(ctx, getService, config);
 }
@@ -68,16 +70,36 @@ function registerHelperCommands(ctx, getService, config) {
         }
         const node = nodes[0];
         try {
-            const version = await node.getVersion();
+            const [version, systemInfo, containerCount, imageCount] = await Promise.all([
+                node.getVersion(),
+                node.getSystemInfo(),
+                node.getContainerCount(),
+                node.getImageCount(),
+            ]);
+            // 将容器和镜像数量添加到节点对象
+            const nodeData = {
+                ...node,
+                containerCount: containerCount.total,
+                imageCount: imageCount,
+            };
             if (useImageOutput && ctx.puppeteer) {
-                const html = (0, render_1.generateNodeDetailHtml)(node, version);
+                const html = (0, render_1.generateNodeDetailHtml)(nodeData, version, systemInfo);
                 return await (0, render_1.renderToImage)(ctx, html);
             }
+            const memoryUsed = systemInfo?.MemTotal && systemInfo?.MemAvailable !== undefined
+                ? `${Math.round((1 - systemInfo.MemAvailable / systemInfo.MemTotal) * 100)}%`
+                : '-';
+            const nodeName = node.config?.name || node.name || node.Name || 'Unknown';
+            const nodeId = node.id || node.ID || node.Id || node.config?.id || '-';
             const lines = [
-                `=== ${node.name} ===`,
-                `ID: ${node.id}`,
-                `状态: ${node.status}`,
-                `标签: ${node.tags.join(', ') || '无'}`,
+                `=== ${nodeName} ===`,
+                `ID: ${nodeId}`,
+                `状态: ${node.status || node.Status || 'unknown'}`,
+                `标签: ${node.tags?.join(', ') || node.config?.tags?.join(', ') || '无'}`,
+                `CPU: ${systemInfo?.NCPU || '-'} 核心`,
+                `内存: ${memoryUsed} (可用: ${systemInfo?.MemAvailable ? Math.round(systemInfo.MemAvailable / 1024 / 1024) + ' MB' : '-'})`,
+                `容器: ${containerCount.running}/${containerCount.total} 运行中`,
+                `镜像: ${imageCount} 个`,
                 `Docker 版本: ${version.Version}`,
                 `API 版本: ${version.ApiVersion}`,
                 `操作系统: ${version.Os} (${version.Arch})`,
@@ -146,7 +168,7 @@ function registerHelperCommands(ctx, getService, config) {
             if (c.State !== 'running') {
                 return `容器 ${container} 未运行`;
             }
-            const result = await node.execContainer(c.Id, cmd.split(' '));
+            const result = await node.execContainer(c.Id, cmd);
             return [
                 `=== 执行结果 ===`,
                 `退出码: ${result.exitCode}`,
@@ -158,47 +180,6 @@ function registerHelperCommands(ctx, getService, config) {
             return `执行失败: ${e.message}`;
         }
     });
-    /**
-     * 交互式执行 (返回结果，不支持实时交互)
-     */
-    ctx
-        .command('docker.shell <container> <cmd>', '在容器中执行命令(交互式)')
-        .alias('dockershell', '容器shell')
-        .option('node', '-n <node> 指定节点', { fallback: '' })
-        .option('timeout', '-t <seconds> 超时时间', { fallback: 30 })
-        .action(async ({ options }, container, cmd) => {
-        const service = getService();
-        if (!service) {
-            return 'Docker 服务未初始化';
-        }
-        const nodeSelector = options.node || 'all';
-        try {
-            const nodes = service.getNodesBySelector(nodeSelector);
-            if (nodes.length === 0) {
-                return `未找到节点: ${nodeSelector}`;
-            }
-            const results = await service.findContainerGlobal(container);
-            if (results.length === 0) {
-                return `未找到容器: ${container}`;
-            }
-            const { node, container: c } = results[0];
-            if (c.State !== 'running') {
-                return `容器 ${container} 未运行`;
-            }
-            const result = await node.execContainer(c.Id, cmd.split(' '));
-            return [
-                `=== ${node.name}/${c.Names[0]?.replace('/', '') || c.Id.slice(0, 8)} ===`,
-                `> ${cmd}`,
-                ``,
-                result.output || '(无输出)',
-                ``,
-                `[退出码: ${result.exitCode}]`,
-            ].join('\n');
-        }
-        catch (e) {
-            return `执行失败: ${e.message}`;
-        }
-    });
     /**
      * 查看帮助
      */
@@ -210,15 +191,14 @@ function registerHelperCommands(ctx, getService, config) {
             '  docker.nodes               - 查看节点列表',
             '  docker.node <节点>         - 查看节点详情',
             '',
-            '【容器操作】',
-            '  docker.ls [节点]           - 列出容器',
-            '  docker.start <容器>        - 启动容器',
-            '  docker.stop <容器>         - 停止容器',
-            '  docker.restart <容器>      - 重启容器',
-            '  docker.logs <容器> [-t 行数] - 查看日志',
-            '  docker.find <容器>         - 搜索容器',
-            '  docker.exec <容器> <命令>  - 执行命令',
-            '  docker.shell <容器> <命令> - 交互式执行',
+            '【容器操作】(参数顺序: 节点 容器)',
+            '  docker.ls <节点>           - 列出容器',
+            '  docker.start <节点> <容器> - 启动容器',
+            '  docker.stop <节点> <容器>  - 停止容器',
+            '  docker.restart <节点> <容器> - 重启容器',
+            '  docker.logs <节点> <容器> [-n 行数] - 查看日志',
+            '  docker.inspect <节点> <容器> - 查看容器详情',
+            '  docker.exec <节点> <容器> <命令> - 在容器内执行命令',
             '',
             '【节点选择器】',
             '  all        - 所有节点',

package/lib/commands/list.js

@@ -30,6 +30,10 @@ function registerListCommand(ctx, getService, config) {
             if (!ctx.puppeteer) {
                 return '错误: 未安装 koishi-plugin-puppeteer 插件，无法使用图片渲染';
             }
+            // 如果未指定节点，提示用户
+            if (!selector) {
+                return '请指定节点名称、ID 或标签，或使用 "all" 列出全部容器\n例如: docker.ls @web -f image 或 docker.ls all -f image';
+            }
             try {
                 // 获取容器数据
                 logger_1.commandLogger.debug('获取容器数据...');
@@ -39,7 +43,7 @@ function registerListCommand(ctx, getService, config) {
                     return '未发现任何容器';
                 }
                 // 生成并渲染
-                const html = (0, render_1.generateListHtml)(results, selector ? `容器列表 (${selector})` : '容器列表');
+                const html = (0, render_1.generateListHtml)(results, `容器列表 (${selector})`);
                 return await (0, render_1.renderToImage)(ctx, html);
             }
             catch (e) {
@@ -49,9 +53,13 @@ function registerListCommand(ctx, getService, config) {
         }
         // 文字模式
         try {
+            // 如果未指定节点，提示用户
+            if (!selector) {
+                return '请指定节点名称、ID 或标签，或使用 "all" 列出全部容器\n例如: docker.ls @web 或 docker.ls all';
+            }
             const results = await getContainerResults(service, selector, all);
             if (results.length === 0) {
-                return selector ? '所有指定节点均未连接' : '未发现任何容器';
+                return '所有指定节点均未连接';
             }
             const lines = [];
             for (const { node, containers } of results) {

package/lib/commands/logs.d.ts

@@ -1,6 +1,6 @@
 /**
  * 日志指令
- * docker.logs <container> [node]
+ * docker.logs <node> <container>
  */
 import { Context } from 'koishi';
 import type { DockerControlConfig } from '../types';

package/lib/commands/logs.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerLogsCommand = registerLogsCommand;
 const logger_1 = require("../utils/logger");
+const render_1 = require("../utils/render");
 /**
  * 获取容器名称
  */
@@ -12,74 +13,63 @@ function getContainerName(c) {
  * 注册日志指令
  */
 function registerLogsCommand(ctx, getService, config) {
+    const useImageOutput = config?.imageOutput === true;
     ctx
-        .command('docker.logs <container> [node]', '查看容器日志')
+        .command('docker.logs <node> <container>', '查看容器日志')
         .alias('docker日志', '容器日志', 'docker查看日志', '容器查看日志', 'dockerlogs')
         .option('lines', '-n <lines:number> 显示最后 N 行')
         .option('timestamp', '-t 显示时间戳')
-        .action(async ({ options }, container, node) => {
-        logger_1.commandLogger.debug(`docker.logs 被调用: container=${container}, node=${node}, lines=${options.lines}, timestamp=${options.timestamp}`);
+        .option('all', '-a 显示全部（不截断）')
+        .action(async ({ options }, node, container) => {
+        logger_1.commandLogger.debug(`docker.logs 被调用: node=${node}, container=${container}, lines=${options.lines}, timestamp=${options.timestamp}`);
         const service = getService();
         if (!service) {
             logger_1.commandLogger.debug('服务未初始化');
             return 'Docker 服务未初始化';
         }
         // 参数校验
-        if (!container) {
-            return '请指定容器名或ID\n用法示例:\n  docker.logs my-app\n  docker.logs my-app node-1 -n 50';
+        if (!node || !container) {
+            return '请指定节点和容器\n用法示例:\n  docker.logs @web my-app -n 50\n  docker.logs all my-app';
         }
         // 确定日志行数 (优先级: 命令行参数 > 全局配置 > 默认值)
         const tail = options.lines || config?.defaultLogLines || 100;
         const showTimestamp = options.timestamp || false;
-        logger_1.commandLogger.debug(`日志参数: tail=${tail}, showTimestamp=${showTimestamp}`);
+        const showAll = options.all || false;
+        logger_1.commandLogger.debug(`日志参数: tail=${tail}, showTimestamp=${showTimestamp}, showAll=${showAll}`);
         try {
-            let targetNode = null;
-            let containerInfo = null;
-            // 查找容器逻辑
-            if (node) {
-                // 指定节点查找
-                const nodes = service.getNodesBySelector(node);
-                if (nodes.length === 0) {
-                    logger_1.commandLogger.debug(`找不到节点: ${node}`);
-                    return `❌ 找不到节点: ${node}`;
-                }
-                targetNode = nodes[0];
-                logger_1.commandLogger.debug(`在节点 ${targetNode.name} 中查找容器...`);
-                const result = await service.findContainer(targetNode.id, container);
-                containerInfo = result.container;
-            }
-            else {
-                // 全局模糊查找
-                logger_1.commandLogger.debug(`全局搜索容器: ${container}`);
-                const results = await service.findContainerGlobal(container);
-                if (results.length === 0) {
-                    logger_1.commandLogger.debug(`找不到容器: ${container}`);
-                    return `❌ 找不到容器: ${container}`;
-                }
-                // 优先返回 Running 的，如果没有则返回第一个
-                const running = results.find(r => r.container.State === 'running');
-                const target = running || results[0];
-                targetNode = target.node;
-                containerInfo = target.container;
+            // 查找节点
+            const nodes = service.getNodesBySelector(node);
+            if (nodes.length === 0) {
+                logger_1.commandLogger.debug(`找不到节点: ${node}`);
+                return `找不到节点: ${node}`;
             }
+            // 在节点上查找容器
+            const { node: targetNode, container: containerInfo } = await service.findContainer(nodes[0].id, container);
             if (!targetNode || !containerInfo) {
-                return '❌ 未能获取容器信息';
+                return '未能获取容器信息';
             }
             // 获取日志
-            const logs = await targetNode.getContainerLogs(containerInfo.Id, tail);
+            const logs = await targetNode.getContainerLogs(containerInfo.Id, showAll ? 10000 : tail);
             if (!logs || !logs.trim()) {
                 return `${targetNode.name}: ${getContainerName(containerInfo)} - 无日志`;
             }
             // 格式化输出
             const lines = logs.split('\n').filter(l => l.length > 0);
-            const displayLines = lines.length > tail ? lines.slice(-tail) : lines;
+            const displayLines = !showAll && lines.length > tail ? lines.slice(-tail) : lines;
             // 移除 ANSI 颜色代码
             const cleanLogs = displayLines.map(line => line.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, '')).join('\n');
-            return `=== ${targetNode.name}: ${getContainerName(containerInfo)} (最后 ${displayLines.length} 行) ===\n${cleanLogs}`;
+            // 图片渲染模式
+            if (useImageOutput && ctx.puppeteer && !showAll) {
+                const html = (0, render_1.generateLogsHtml)(targetNode.name, getContainerName(containerInfo), cleanLogs, displayLines.length);
+                // 根据行数动态计算高度：header 80px + header 80px + 每行 25px + padding
+                const estimatedHeight = 200 + displayLines.length * 25;
+                return await (0, render_1.renderToImage)(ctx, html, { height: Math.max(estimatedHeight, 800) });
+            }
+            return `=== ${targetNode.name}: ${getContainerName(containerInfo)} (${showAll ? '全部' : `最后 ${displayLines.length} 行`}) ===\n${cleanLogs}`;
         }
         catch (e) {
             logger_1.commandLogger.error(e);
-            return `❌ 获取日志失败: ${e.message}`;
+            return `获取日志失败: ${e.message}`;
         }
     });
 }

package/lib/index.d.ts

@@ -23,6 +23,9 @@ declare module 'koishi' {
         puppeteer?: {
             render: (html: string, callback?: (page: any, next: (handle?: any) => Promise<string>) => Promise<string>) => Promise<string>;
         };
+        assets?: {
+            upload: (data: string | Buffer, filename: string) => Promise<string>;
+        };
     }
     interface Tables {
         'docker_control_subscriptions': DockerControlSubscription;

package/lib/index.js

@@ -13,7 +13,7 @@ const commands_1 = require("./commands");
 exports.name = 'docker-control';
 exports.inject = {
     required: ['database'],
-    optional: ['puppeteer'],
+    optional: ['puppeteer', 'assets'],
 };
 // 导出配置 Schema
 exports.Config = koishi_1.Schema.object({

package/lib/service/connector.d.ts

@@ -9,6 +9,13 @@ export declare class DockerConnector {
      */
     exec(command: string): Promise<string>;
     private execInternal;
+    /**
+     * 执行命令并返回输出和退出码
+     */
+    execWithExitCode(command: string): Promise<{
+        output: string;
+        exitCode: number;
+    }>;
     /**
      * 执行 docker ps 获取容器列表
      */
@@ -32,7 +39,10 @@ export declare class DockerConnector {
     /**
      * 执行容器内命令
      */
-    execContainer(containerId: string, cmd: string): Promise<string>;
+    execContainer(containerId: string, cmd: string): Promise<{
+        output: string;
+        exitCode: number;
+    }>;
     /**
      * 监听 Docker 事件流
      * @param callback 每行事件数据的回调
@@ -64,4 +74,23 @@ export declare class DockerConnector {
      * 获取凭证配置
      */
     private getCredential;
+    /**
+     * 读取文件内容 (支持 Windows 路径和 WSL 路径自动转换)
+     * @param filePath 文件路径 (可能是 Windows 路径如 C:\xxx 或 WSL 路径如 /mnt/c/xxx)
+     * @returns 文件内容
+     */
+    readFile(filePath: string): Promise<string>;
+    /**
+     * 内部文件读取方法
+     */
+    private readFileInternal;
+    /**
+     * 将 Windows 路径转换为 WSL 路径
+     * 例如: C:\Users\anyul\anyulapp\RSSHub\docker-compose.yml -> /mnt/c/Users/anyul/anyulapp/RSSHub/docker-compose.yml
+     */
+    convertWindowsToWslPath(windowsPath: string): string;
+    /**
+     * 检查文件是否存在
+     */
+    fileExists(filePath: string): Promise<boolean>;
 }

package/lib/service/connector.js

@@ -61,8 +61,10 @@ class DockerConnector {
                     catch (e) {
                         // 可能已经关闭，忽略错误
                     }
-                    if (stderr.includes('Error') || stderr.includes('error')) {
-                        reject(new Error(stderr.trim()));
+                    // 非零退出码或包含错误信息时抛出异常
+                    if (code !== 0 || stderr.includes('Error') || stderr.includes('error') || stderr.includes('No such file')) {
+                        const errorMsg = stderr.trim() || `命令执行失败，退出码: ${code}`;
+                        reject(new Error(errorMsg));
                     }
                     else {
                         resolve(stdout.trim());
@@ -77,6 +79,43 @@ class DockerConnector {
             });
         });
     }
+    /**
+     * 执行命令并返回输出和退出码
+     */
+    async execWithExitCode(command) {
+        const client = await this.getConnection();
+        logger_1.connectorLogger.debug(`[${this.config.name}] 执行命令: ${command}`);
+        return new Promise((resolve, reject) => {
+            client.exec(command, (err, stream) => {
+                if (err) {
+                    logger_1.connectorLogger.debug(`[${this.config.name}] 命令执行错误: ${err.message}`);
+                    reject(err);
+                    return;
+                }
+                let stdout = '';
+                let stderr = '';
+                let exitCode = null;
+                stream.on('close', (code, signal) => {
+                    logger_1.connectorLogger.debug(`[${this.config.name}] 命令完成: code=${code}, signal=${signal}`);
+                    exitCode = code ?? 0;
+                    // 显式结束 stream 防止 channel 泄露
+                    try {
+                        stream.end();
+                    }
+                    catch (e) {
+                        // 可能已经关闭，忽略错误
+                    }
+                    resolve({ output: stdout.trim(), exitCode });
+                });
+                stream.on('data', (data) => {
+                    stdout += data.toString();
+                });
+                stream.on('err', (data) => {
+                    stderr += data.toString();
+                });
+            });
+        });
+    }
     /**
      * 执行 docker ps 获取容器列表
      */
@@ -115,7 +154,7 @@ class DockerConnector {
     async execContainer(containerId, cmd) {
         // 使用 docker exec 需要处理引号
         const escapedCmd = cmd.replace(/'/g, "'\\''");
-        return this.exec(`docker exec ${containerId} sh -c '${escapedCmd}'`);
+        return this.execWithExitCode(`docker exec ${containerId} sh -c '${escapedCmd}'`);
     }
     /**
      * 监听 Docker 事件流
@@ -263,5 +302,60 @@ class DockerConnector {
     getCredential() {
         return (0, config_1.getCredentialById)(this.fullConfig, this.config.credentialId);
     }
+    /**
+     * 读取文件内容 (支持 Windows 路径和 WSL 路径自动转换)
+     * @param filePath 文件路径 (可能是 Windows 路径如 C:\xxx 或 WSL 路径如 /mnt/c/xxx)
+     * @returns 文件内容
+     */
+    async readFile(filePath) {
+        // 检测是否是 Windows 路径 (包含盘符如 C:\)
+        const isWindowsPath = /^[A-Za-z]:/.test(filePath);
+        if (isWindowsPath) {
+            // 第一次尝试使用原始路径
+            try {
+                return await this.readFileInternal(filePath);
+            }
+            catch (originalError) {
+                // 如果失败，尝试转换为 WSL 路径
+                const wslPath = this.convertWindowsToWslPath(filePath);
+                logger_1.connectorLogger.debug(`[${this.config.name}] 原始路径失败 (${filePath})，尝试 WSL 路径: ${wslPath}`);
+                return await this.readFileInternal(wslPath);
+            }
+        }
+        // 非 Windows 路径直接读取
+        return await this.readFileInternal(filePath);
+    }
+    /**
+     * 内部文件读取方法
+     */
+    async readFileInternal(filePath) {
+        // 使用 cat 命令读取文件
+        // 对路径进行引号处理以支持包含空格的路径
+        const escapedPath = filePath.replace(/"/g, '\\"');
+        return this.exec(`cat "${escapedPath}"`);
+    }
+    /**
+     * 将 Windows 路径转换为 WSL 路径
+     * 例如: C:\Users\anyul\anyulapp\RSSHub\docker-compose.yml -> /mnt/c/Users/anyul/anyulapp/RSSHub/docker-compose.yml
+     */
+    convertWindowsToWslPath(windowsPath) {
+        // 匹配 Windows 盘符路径 (如 C:\xxx 或 C:/xxx)
+        const match = windowsPath.match(/^([A-Za-z]):[\\/](.*)$/);
+        if (!match) {
+            // 如果不是有效的 Windows 路径，返回原路径
+            return windowsPath;
+        }
+        const driveLetter = match[1].toLowerCase();
+        const restPath = match[2].replace(/\\/g, '/');
+        return `/mnt/${driveLetter}/${restPath}`;
+    }
+    /**
+     * 检查文件是否存在
+     */
+    async fileExists(filePath) {
+        const escapedPath = filePath.replace(/"/g, '\\"');
+        const result = await this.execWithExitCode(`test -f "${escapedPath}" && echo "exists" || echo "not exists"`);
+        return result.output.trim() === 'exists';
+    }
 }
 exports.DockerConnector = DockerConnector;