@flun/windows 3.0.10 → 4.0.0

package/lib/binaries.js

@@ -1,133 +1,134 @@
-import { path, fs, exec, getDirname } from './shared.js';
-/**
- * 从 Node.js `os` 模块导入的 `platform` 函数,用于获取操作系统平台字符串;
- * >查看定义:@see {@link platform}
- * @type {() => string}
- */
-import { platform, tmpdir } from 'os';
-
-const __dirname = getDirname(import.meta.url), vbsPath = path.resolve(__dirname, '../bin/elevate.vbs'),
-    /** 参数处理函数,用于标准化 options 和 callback 参数 */
-    _params = (options = {}, callback) => {
-        callback = callback || function () { };
-        if (typeof options === 'function') callback = options, options = {};
-        if (typeof options !== 'object') throw '参数 options 无效;';
-        return { options, callback };
-    },
-
-    // 文件读取
-    readFileSafe = (Path, value = '') => {
-        try {
-            return fs.readFileSync(Path, 'utf8');
-        } catch (e) { return value; }
-    };
-
-/**
- * 提升当前进程权限（Windows UAC）
- * >查看定义:@see {@link elevate}
- * @param {string} cmd - 要使用提升权限执行的命令
- * @param {Object} [options] - 传递给 child_process.exec 的选项
- * @param {string} [options.cwd] - 工作目录
- * @param {number} [options.timeout] - 超时时间（毫秒）
- * @param {(error: Error|null, stdout: string, stderr: string) => void} [callback] - 执行完成后的回调函数
- * @returns {void}
- * @example
- * import { elevate  } from '@flun/windows';
- *
- * // 基本用法
- * elevate('echo "Hello World" && whoami',{}, (error, stdout, stderr) => {
- *     if (error) {
- *         console.error('执行失败:', error);
- *     } else {
- *         console.log('执行成功,输出:', stdout);
- *         console.log('错误输出:', stderr);
- *     }
- * });
- *
- * // 带选项参数
- * elevate('echo "Hello World" && whoami', { cwd:'C:\\' }, callback);
- *
- * // 多种参数组合
- * elevate('echo "Hello World" && whoami', (err, stdout)=> { }); // options视为回调
- * elevate('echo "Hello World" && whoami'); // 无回调
- */
-const elevate = (cmd, options, callback) => {
-    const p = _params(options, callback), tmpDir = tmpdir(),
-        [vbsFile, outFile, batFile, cmdFile] = ['flun_el.vbs', 'flun_el_output.txt', 'flun_el.bat', 'flun_el.cmd']
-            .map(name => path.join(tmpDir, name)),
-        escapedCmd = cmd.replace(/"/g, '""').replace(/%/g, "%%"), vbs = readFileSafe(vbsPath).replace(/{command}/g, escapedCmd);
-
-    // 写入VBS文件
-    try {
-        fs.writeFileSync(vbsFile, vbs, 'utf8');
-    } catch (writeError) {
-        return p.callback(writeError, '', '');
-    }
-
-    exec(`wscript.exe "${vbsFile}"`, { timeout: 20000 }, error => {
-        setTimeout(() => {
-            const output = readFileSafe(outFile).replace(/\r\n$|\n$/, '').trim();
-
-            // 清理临时文件
-            [batFile, cmdFile, outFile, vbsFile].forEach(f => {
-                try { fs.unlinkSync(f) } catch (e) { }
-            });
-
-            if (error) return p.callback(error, '', '');
-            p.callback(null, output, '');
-        }, 1600);
-    });
-};
-
-/**
- * 使用 sudo 方式提升权限（与 elevate 相似但体验更好）
- * >查看定义:@see {@link sudo}
- * @param {string} cmd - 要使用提升权限执行的命令
- * @param {Object} [options] - 传递给 child_process.exec 的选项
- * @param {string} [options.cwd] - 工作目录
- * @param {number} [options.timeout] - 超时时间（毫秒）
- * @param {(error: Error|null, stdout: string, stderr: string) => void} [callback] - 执行完成后的回调函数
- * @returns {void}
- * @example
- * import { sudo } from '@flun/windows';
- *
- * // 基本用法 - 命令、选项和回调
- * sudo('echo "Hello World" && whoami', {}, (error, stdout, stderr) => {
- *     if (error) {
- *         console.error('执行失败:', error);
- *     } else {
- *         console.log('执行成功,输出:', stdout);
- *         console.log('错误输出:', stderr);
- *     }
- * });
- *
- * // 带选项参数
- * sudo('echo "Hello World" && whoami', {cwd:'C:\\'}, callback);
- *
- * sudo('echo "Hello World" && whoami' ); // 无回调
- */
-const sudo = (cmd, options, callback) => {
-    const p = _params(options, callback);
-    exec(`sudo ${cmd}`, p.options, p.callback);
-};
-
-/**
- * 检查当前用户是否拥有管理员权限
- * >查看定义:@see {@link isAdminUser}
- * @param {(isAdmin: boolean) => void} callback - 回调函数,接收布尔值表示是否为管理员
- * @returns {void}
- * @example
- * import { isAdminUser  } from '@flun/windows';
- * isAdminUser(isAdmin => {
- *   if (isAdmin) console.log('当前用户是管理员');
- *   else console.log('当前用户不是管理员');
- * });
- */
-const isAdminUser = callback => {
-    exec('NET SESSION', (err, so, se) => {
-        if (se.length !== 0) elevate('NET SESSION', (_err, _so, _se) => callback(_se.length === 0));
-        else callback(true);
-    });
-};
-
+import { path, fs, exec, getDirname } from './shared.js';
+/**
+ * 从 Node.js `os` 模块导入的 `platform` 函数,用于获取操作系统平台字符串;
+ * >查看定义:@see {@link platform}
+ * @type {() => string}
+ */
+import { platform, tmpdir } from 'os';
+
+const __dirname = getDirname(import.meta.url), vbsPath = path.resolve(__dirname, '../bin/elevate.vbs'),
+    /** 参数处理函数,用于标准化 options 和 callback 参数 */
+    _params = (options = {}, callback) => {
+        callback = callback || function () { };
+        if (typeof options === 'function') callback = options, options = {};
+        if (typeof options !== 'object') throw '参数 options 无效;';
+        return { options, callback };
+    },
+
+    // 文件读取
+    readFileSafe = (Path, value = '') => {
+        try {
+            return fs.readFileSync(Path, 'utf8');
+        } catch (e) { return value; }
+    };
+
+/**
+ * 提升当前进程权限(Windows UAC)
+ * >查看定义:@see {@link elevate}
+ * @param {string} cmd - 要使用提升权限执行的命令
+ * @param {Object} [options] - 传递给 child_process.exec 的选项
+ * @param {string} [options.cwd] - 工作目录
+ * @param {number} [options.timeout] - 超时时间(毫秒)
+ * @param {(error: Error|null, stdout: string, stderr: string) => void} [callback] - 执行完成后的回调函数
+ * @returns {void}
+ * @example
+ * import { elevate  } from '@flun/windows';
+ *
+ * // 基本用法
+ * elevate('echo "Hello World" && whoami',{}, (error, stdout, stderr) => {
+ *     if (error) {
+ *         console.error('执行失败:', error);
+ *     } else {
+ *         console.log('执行成功,输出:', stdout);
+ *         console.log('错误输出:', stderr);
+ *     }
+ * });
+ *
+ * // 带选项参数
+ * elevate('echo "Hello World" && whoami', { cwd:'C:\\' }, callback);
+ *
+ * // 多种参数组合
+ * elevate('echo "Hello World" && whoami', (err, stdout)=> { }); // options视为回调
+ * elevate('echo "Hello World" && whoami'); // 无回调
+ */
+const elevate = (cmd, options, callback) => {
+    const p = _params(options, callback), tmpDir = tmpdir(),
+        [vbsFile, outFile, batFile, cmdFile] = ['flun_el.vbs', 'flun_el_output.txt', 'flun_el.bat', 'flun_el.cmd']
+            .map(name => path.join(tmpDir, name)),
+        escapedCmd = cmd.replace(/"/g, '""').replace(/%/g, "%%"),
+            vbs = readFileSafe(vbsPath).replace(/{command}/g, escapedCmd);
+
+    // 写入VBS文件
+    try {
+        fs.writeFileSync(vbsFile, vbs, 'utf8');
+    } catch (writeError) {
+        return p.callback(writeError, '', '');
+    }
+
+    exec(`wscript.exe "${vbsFile}"`, { timeout: 20000 }, error => {
+        setTimeout(() => {
+            const output = readFileSafe(outFile).replace(/\r\n$|\n$/, '').trim();
+
+            // 清理临时文件
+            [batFile, cmdFile, outFile, vbsFile].forEach(f => {
+                try { fs.unlinkSync(f) } catch (e) { }
+            });
+
+            if (error) return p.callback(error, '', '');
+            p.callback(null, output, '');
+        }, 1600);
+    });
+};
+
+/**
+ * 使用 sudo 方式提升权限(与 elevate 相似但体验更好)
+ * >查看定义:@see {@link sudo}
+ * @param {string} cmd - 要使用提升权限执行的命令
+ * @param {Object} [options] - 传递给 child_process.exec 的选项
+ * @param {string} [options.cwd] - 工作目录
+ * @param {number} [options.timeout] - 超时时间(毫秒)
+ * @param {(error: Error|null, stdout: string, stderr: string) => void} [callback] - 执行完成后的回调函数
+ * @returns {void}
+ * @example
+ * import { sudo } from '@flun/windows';
+ *
+ * // 基本用法 - 命令、选项和回调
+ * sudo('echo "Hello World" && whoami', {}, (error, stdout, stderr) => {
+ *     if (error) {
+ *         console.error('执行失败:', error);
+ *     } else {
+ *         console.log('执行成功,输出:', stdout);
+ *         console.log('错误输出:', stderr);
+ *     }
+ * });
+ *
+ * // 带选项参数
+ * sudo('echo "Hello World" && whoami', {cwd:'C:\\'}, callback);
+ *
+ * sudo('echo "Hello World" && whoami' ); // 无回调
+ */
+const sudo = (cmd, options, callback) => {
+    const p = _params(options, callback);
+    exec(`sudo ${cmd}`, p.options, p.callback);
+};
+
+/**
+ * 检查当前用户是否拥有管理员权限
+ * >查看定义:@see {@link isAdminUser}
+ * @param {(isAdmin: boolean) => void} callback - 回调函数,接收布尔值表示是否为管理员
+ * @returns {void}
+ * @example
+ * import { isAdminUser  } from '@flun/windows';
+ * isAdminUser(isAdmin => {
+ *   if (isAdmin) console.log('当前用户是管理员');
+ *   else console.log('当前用户不是管理员');
+ * });
+ */
+const isAdminUser = callback => {
+    exec('NET SESSION', (err, so, se) => {
+        if (se.length !== 0) elevate('NET SESSION', (_err, _so, _se) => callback(_se.length === 0));
+        else callback(true);
+    });
+};
+
 export { elevate, sudo, isAdminUser, platform };

package/lib/cmd.js

@@ -5,7 +5,7 @@ import { exec } from './shared.js';
  * >查看定义:@see {@link kill}
  * @param {number} pid - 进程PID
  * @param {(error: Error|null, stdout: string, stderr: string) => void} [callback] - 执行完成后的回调函数
- * @param {boolean} [force=false] - 是否强制结束进程（默认: false）
+ * @param {boolean} [force=false] - 是否强制结束进程(默认: false)
  * @returns {void}
  * @example
  * import { kill } from '@flun/windows';
@@ -14,8 +14,8 @@ import { exec } from './shared.js';
  *  });
  */
 const kill = (pid, callback, force = false) => {
-  if (!pid) throw new Error('PID是kill操作必需的参数。');
-  if (isNaN(pid)) throw new Error('PID必须为数字。');
+  if (!pid) throw new Error('PID是kill操作必需的参数;');
+  if (isNaN(pid)) throw new Error('PID必须为数字;');
   if (typeof callback !== 'function') callback = function () { };
   exec(`taskkill /PID ${pid}${force == true ? ' /f' : ''}`, callback);
 };
@@ -24,7 +24,7 @@ const kill = (pid, callback, force = false) => {
  * 列出服务器上正在运行的进程
  * >查看定义:@see {@link list}
  * @param {(processes: Array<Record<string, string>>) => void} callback - 回调函数,接收进程对象数组
- * @param {boolean} [verbose=false] - 是否显示详细信息（默认: false）
+ * @param {boolean} [verbose=false] - 是否显示详细信息(默认: false)
  * @returns {void}
  * @example
  * import { list } from '@flun/windows';

package/lib/daemon.js

@@ -9,24 +9,21 @@ const __dirname = getDirname(import.meta.url), writeFileAsync = promisify(fs.wri
 /**
  * Windows服务管理类,提供创建、安装、卸载、启动、停止、重启和查询服务状态等功能
  * - 用于将Node.js脚本作为Windows服务运行,支持自动重启、日志记录和权限提升等功能
- * >查看定义:@see {@link Service}、{@link install}、{@link uninstall}、{@link start}、{@link stop}、{@link restart}、{@link exists}
+ * >查看定义:@see {@link Service}、{@link install}、{@link uninstall}、{@link start}、{@link stop}、
+ * {@link restart}、{@link exists}
  * @example
- *  // 配置示例
  *  import { Service } from '@flun/windows';
+ *  import config from './win-service.config.js';
  *
- *  // 创建服务对象
- *  const svc = new Service({
- *       name: 'Hello World',                  // 服务名称
- *       description: 'nodejs.org 示例服务器',  // 服务描述
- *       script: 'C:\\path\\to\\helloworld.js',// 启动服务的入口脚本路径
+ *  const svc = new Service(config);
+ *  // 安装并自动启动服务(默认)
+ *  svc.install();
  *
- *       // 传递给node进程的选项
- *       nodeOptions: [ '--harmony', '--max-old-space-size=4096' ]
- *   });
- * svc.install();   // 安装服务
- * // svc.start();     // 启动服务
- * // svc.stop();      // 停止服务
- * // svc.uninstall(); // 卸载服务
+ *  // 只安装,不自动启动
+ *  // svc.install(undefined, false);
+ *
+ *  // 其余方法
+ *  // svc.start(); svc.stop(); svc.uninstall();
  */
 class Service extends EventEmitter {
   /**
@@ -87,7 +84,7 @@ class Service extends EventEmitter {
       scriptOptions = '', stopparentfirst = false, abortOnError = false, grow = 0.25, logpath = null, logmode = 'rotate',
       description = '', execPath = process.execPath, workingDirectory = process.cwd(),
       logOnAs = {},// 嵌套配置对象
-      env, logging, allowServiceLogon,    // 其它配置
+      env, logging, allowServiceLogon, quiet = false,    // 其它配置
     } = config, domain = process.env.COMPUTERNAME;
 
     // 私有字段
@@ -102,7 +99,8 @@ class Service extends EventEmitter {
     this.scriptOptions = scriptOptions;                      // 传递给脚本的选项;
 
     this.stopparentfirst = stopparentfirst;                  // 是否先停止父进程(默认:false);
-    this.abortOnError = Boolean(abortOnError);               // 当遇到导致node.js脚本无法运行错误时是否退出进程(默认:false);
+    this.abortOnError = Boolean(abortOnError);
+    // 当遇到导致node.js脚本无法运行错误时是否退出进程(默认:false);
     this.grow = Number(grow);                                // 重启等待时间的增长百分比(默认:0.25);
     this.logpath = logpath;                                  // 日志文件路径(默认:与可执行文件相同的目录);
     this.logmode = logmode;                                  // 日志模式(默认:rotate);可选值: rotate, truncate, append;
@@ -118,6 +116,7 @@ class Service extends EventEmitter {
 
     /** 环境变量配置 */
     this.env = env, this.logging = logging, this.allowServiceLogon = allowServiceLogon;
+    this.quiet = Boolean(quiet); // 为 true 时不打印执行结果,只发事件;嵌入生产环境时建议开启
   }
 
   // 进程名称
@@ -139,28 +138,30 @@ class Service extends EventEmitter {
     return `${this.id}.exe`;
   }
 
-  // 服务名称（用于Windows服务管理）
+  // 服务名称(用于Windows服务管理)
   get #serviceName() {
     return this.id;
   }
 
   // 生成服务的XML配置
   get #xml() {
-    const { script, scriptOptions, name, grow, wait, maxRestarts, abortOnError, stopparentfirst, maxRetries, id, nodeOptions,
-      description, logpath, execPath, logOnAs, workingdirectory, stoptimeout, logmode, env, logging, allowServiceLogon } = this;
+    const { script, scriptOptions, name, grow, wait, maxRestarts, abortOnError, stopparentfirst,
+      maxRetries, id, nodeOptions, description, logpath, execPath, logOnAs, workingdirectory,
+      stoptimeout, logmode, env, logging, allowServiceLogon } = this;
 
-    // 构建环境变量数组,自动添加 USERPROFILE（如果未显式设置）
+    // 构建环境变量数组,自动添加 USERPROFILE(如果未显式设置)
     let envList = [];
     if (env) envList.push(...(Array.isArray(env) ? env : [env]));
     if (process.env.USERPROFILE && !envList.some(e => e.name === 'USERPROFILE'))
       envList.push({ name: 'USERPROFILE', value: process.env.USERPROFILE });
 
-    const wrapperArgs = ['--file', script, `--scriptoptions=${scriptOptions}`, '--log', `${name} 包装器`, '--grow', grow, '--wait', wait,
-      '--maxrestarts', maxRestarts, '--abortonerror', abortOnError ? 'y' : 'n', '--stopparentfirst', stopparentfirst,
-      ...(maxRetries !== null ? ['--maxretries', maxRetries] : [])];
+    const wrapperArgs = ['--file', script, `--scriptoptions=${scriptOptions}`, '--log', `${name} 包装器`,
+      '--grow', grow, '--wait', wait, '--maxrestarts', maxRestarts, '--abortonerror', abortOnError ? 'y' : 'n',
+      '--stopparentfirst', stopparentfirst, ...(maxRetries !== null ? ['--maxretries', maxRetries] : [])];
 
     return generateXml({
-      name, id, nodeOptions, script: wrapper, scriptOptions, wrapperArgs, description, logpath, execPath, logOnAs, workingdirectory,
+      name, id, nodeOptions, script: wrapper, scriptOptions, wrapperArgs, description, logpath, execPath,
+      logOnAs, workingdirectory,
       stopparentfirst, stoptimeout, logmode, env: envList, logging, allowServiceLogon
     });
   }
@@ -216,10 +217,30 @@ class Service extends EventEmitter {
     }
   }
 
+  /**
+   * 生成 winsw 配置 XML(不写文件,不安装)
+   * >查看定义:@see {@link toXml}
+   * @returns {string} XML 字符串
+   */
+  toXml() { return this.#xml }
+
+  /**
+   * 生成 winsw 可执行文件(不安装)
+   * >查看定义:@see {@link toExe}
+   * @param {string} [dir] - 目标目录(默认与 install 相同,取脚本所在目录下的 daemon 子目录)
+   * @returns {Promise<void>}
+   */
+  async toExe(dir) {
+    const targetDir = this.directory(dir);
+    if (!fs.existsSync(targetDir)) await mkdirAsync(targetDir, { recursive: true });
+    await new Promise((resolve, reject) => createExe(this.id, targetDir, error => error ? reject(error) : resolve()));
+  }
+
   /**
    * 将脚本安装为Windows服务
    * >查看定义:@see {@link install}
-   * @param {string} [dir] - 服务文件将保存的目录（默认为脚本所在目录）
+   * @param {string} [dir] - 服务文件将保存的目录(默认为脚本所在目录)
+   * @param {boolean} [autoStart=true] - 安装成功后是否立即启动服务
    * @returns {Promise<void>}
    * @event install - 当安装过程完成时触发
    * @event alreadyinstalled - 如果服务已安装时触发
@@ -227,25 +248,19 @@ class Service extends EventEmitter {
    * @event error - 在错误发生时触发
    * @example
    *  import { Service } from '@flun/windows';
-   *  const svc = new Service({
-   *       name: 'Hello World',                  // 服务名称
-   *       description: 'nodejs.org 示例服务器',  // 服务描述
-   *       script: 'C:\\path\\to\\helloworld.js',// 启动服务的入口脚本路径
+   *  import config from './win-service.config.js';
    *
-   *       // 传递给node进程的选项
-   *       nodeOptions: [ '--harmony', '--max-old-space-size=4096' ]
-   * });
+   *  const svc = new Service(config);
    *
-   * // 监听安装完成事件
-   * svc.on('install', ()=>{
-   *   svc.start();
-   * });
+   *  // 安装并在完成后自动启动(默认)
+   *  svc.install();
    *
-   * svc.install();
+   *  // 只安装,不启动
+   *  // svc.install(undefined, false);
    */
-  async install(dir) {
+  async install(dir, autoStart = true) {
     // 检查是否已安装
-    if (this.exists === 3) return console.log('安装跳过,服务已经存在;'), this.emit('alreadyinstalled');
+    if (this.exists === 3) return this.#report('安装跳过,服务已经存在;'), this.emit('alreadyinstalled');
 
     const targetDir = this.directory(dir);
     if (!fs.existsSync(targetDir)) await mkdirAsync(targetDir, { recursive: true });
@@ -257,7 +272,10 @@ class Service extends EventEmitter {
       });
 
       // 执行安装命令
-      await this.#execute(`"${this.#resPath(this.#exe)}" install`), await this.#sleep(2), this.emit('install');
+      await this.#execute(`"${this.#resPath(this.#exe)}" install`), await this.#sleep(2);
+      if (autoStart) await this.start();
+      this.#report('服务安装完成;');
+      this.emit('install');
     } catch (error) {
       this.emit('error', error);
       throw error;
@@ -270,31 +288,21 @@ class Service extends EventEmitter {
    * @param {number} [waitTime=2] - 等待winsw.exe完成卸载命令的秒数
    * @returns {Promise<void>}
    * @event uninstall - 当卸载过程完成时触发
-   * @event alreadyuninstalled - 如果服务已卸载时触发
    * @example
-   *  import { Service } from '@flun/windows';
-   *  const svc = new Service({
-   *       name: 'Hello World',                  // 服务名称
-   *       description: 'nodejs.org 示例服务器',  // 服务描述
-   *       script: 'C:\\path\\to\\helloworld.js',// 启动服务的入口脚本路径
+   * import { Service } from '@flun/windows';
+   * import config from './win-service.config.js';
+   *
+   * const svc = new Service(config);
    *
-   *       // 传递给node进程的选项
-   *       nodeOptions: [ '--harmony', '--max-old-space-size=4096' ]
-   * });
    * svc.on('uninstall', ()=>{
    *   console.log('卸载完成');
-   *   console.log('服务是否存在：', svc.exists);
-   *   // svc.exists 返回值说明：
-   *   // 0: 服务和相关文件没有
-   *   // 1: 服务已注册但相关文件不存在（异常情况）
-   *   // 2: 服务未注册但相关文件存在（文件残留）
-   *   // 3: 服务已注册且相关文件存在（正常状态）
+   *   console.log('服务是否存在:', svc.exists);
    * });
    *
    * svc.uninstall();
    */
   async uninstall(waitTime = 2) {
-    if (!this.exists) return console.log('卸载已跳过,服务已经不在;'), this.emit('alreadyuninstalled');
+    if (!this.exists) return this.#report('卸载已跳过,服务已经不在;'), this.emit('alreadyuninstalled');
 
     const uninstaller = async () => {
       await this.#execute(`"${this.#resPath(this.#exe)}" uninstall`), await this.#sleep(waitTime);
@@ -304,6 +312,7 @@ class Service extends EventEmitter {
         console.error(`删除目录失败: ${error.message}`);
       }
 
+      this.#report('服务卸载完成;');
       this.emit('uninstall');
     };
 
@@ -317,14 +326,10 @@ class Service extends EventEmitter {
    * @event start - 当服务启动时触发
    * @example
    *  import { Service } from '@flun/windows';
-   *  const svc = new Service({
-   *       name: 'Hello World',                  // 服务名称
-   *       description: 'nodejs.org 示例服务器',  // 服务描述
-   *       script: 'C:\\path\\to\\helloworld.js',// 启动服务的入口脚本路径
+   *  import config from './win-service.config.js';
+   *
+   *  const svc = new Service(config);
    *
-   *       // 传递给node进程的选项
-   *       nodeOptions: [ '--harmony', '--max-old-space-size=4096' ]
-   * });
    * svc.on('start', ()=>{
    *   console.log('服务已启动');
    * });
@@ -336,7 +341,7 @@ class Service extends EventEmitter {
 
     try {
       const { stderr } = await this.#execute(`NET START "${this.#serviceName}"`);
-      if (!stderr) return this.emit('start'); // 如果没有错误,触发成功事件
+      if (!stderr) return this.#report('服务已启动;'), this.emit('start');
       throw new Error(stderr);
     } catch (error) {
       if (error.message.includes('already been started')) return this.log.warn('尝试启动服务失败,因为服务已经在运行;');
@@ -352,14 +357,9 @@ class Service extends EventEmitter {
    * @event alreadystopped - 当服务已经停止时触发
    * @example
    *  import { Service } from '@flun/windows';
-   *  const svc = new Service({
-   *       name: 'Hello World',                  // 服务名称
-   *       description: 'nodejs.org 示例服务器',  // 服务描述
-   *       script: 'C:\\path\\to\\helloworld.js',// 启动服务的入口脚本路径
+   *  import config from './win-service.config.js';
    *
-   *       // 传递给node进程的选项
-   *       nodeOptions: [ '--harmony', '--max-old-space-size=4096' ]
-   * });
+   *  const svc = new Service(config);
    * svc.on('stop', ()=>{
    *   console.log('服务已停止');
    * });
@@ -368,7 +368,7 @@ class Service extends EventEmitter {
    */
   async stop() {
     try {
-      await this.#execute(`NET STOP "${this.#serviceName}"`), this.emit('stop');
+      await this.#execute(`NET STOP "${this.#serviceName}"`), this.#report('服务已停止;'), this.emit('stop');
     } catch (error) {
       if (error.code === 2) return this.log.warn('服务未运行或已停止;'), this.emit('alreadystopped');
       this.emit('error', error);
@@ -381,10 +381,9 @@ class Service extends EventEmitter {
    * @returns {Promise<void>}
    * @example
    * import { Service } from '@flun/windows';
-   * const svc = new Service({
-   *   name: 'Hello World',
-   *   script: 'C:\\path\\to\\helloworld.js'
-   * });
+   * import config from './win-service.config.js';
+   *
+   * const svc = new Service(config);
    *
    * svc.restart();
    */
@@ -411,7 +410,7 @@ class Service extends EventEmitter {
       executor(cmd, { ...options, shell: true, windowsHide: true }, (error, stdout, stderr) => {
         if (error) {
           if (isPermissionError(error.message)) reject(new Error('权限被拒绝,请以管理员身份重新运行此脚本;'));
-          else console.error(error.toString()), reject(error);
+          else { if (!this.quiet) console.error(error.toString()); reject(error); }
         }
         else resolve({ stdout, stderr });
       });
@@ -423,6 +422,12 @@ class Service extends EventEmitter {
    * @param {number} seconds - 睡眠秒数
    * @returns {Promise<void>}
    */
+  /**
+   * 按 quiet 配置决定是否打印执行结果;
+   * @param {string} msg 结果消息
+   */
+  #report = msg => { if (!this.quiet) console.log(msg) };
+
   #sleep = seconds => new Promise(r => setTimeout(r, seconds * 1000));
 }