@flun/windows 3.0.11 → 4.0.0

package/CHANGELOG.md

@@ -1,15 +1,36 @@
-# 变更日志
-
-## [3.0.11] - 2026-10-25 15:57
-### 优化
-- 项目标点已改为以英文标点为主;
-- 行宽改为以 123 为主,部分超宽表格改为了列表;
-
-## [3.0.10] - 2026-09-29 19:29
-### 更改
-- 加固了拷贝文件的一些逻辑;
-- 升级了依赖;
-
-## [3.0.9] - 2026-07-24 19:35
-### 优化
-- 内部一些优化;
+# 变更日志
+
+## [4.0.0] - 2026-11-03 22:34
+### 破坏性变更
+- `Service#install()` 默认在安装成功后启动服务;旧行为只安装不启动,如需保持旧行为传 `autoStart = false`;
+- 移除模板 `sevWin.js`,改为 `win-service.config.js`;详细用法见"README.md";
+- 库内执行结果的输出改由 `quiet` 配置控制;嵌入生产环境时建议设为 `true`,避免输出混入宿主日志;
+
+### 新增
+- 新增命令行入口 `bin/cli.js`,注册命令 `windows`;支持 `install`、`uninstall`、`start`、`stop`、
+  `restart`、`status`、`xml`、`exe`、`list`、`kill`、`log`、`is-admin`、`elevate`、`example`、`help`;
+- 新增配置模板 `win-service.config.js`,列全量字段并标注必填项;由 `postinstall` 复制到用户项目根;
+- `Service` 新增 `toXml()` 与 `toExe(dir)`,可只生成 winsw 配置或可执行文件而不安装;
+- `Service` 新增 `quiet` 配置项,为 `true` 时不打印执行结果,只发事件;
+- `install(dir, autoStart = true)` 新增 `autoStart` 参数;
+
+### 修复
+- 库内执行结果输出不一致:`install`、`uninstall`、`start`、`stop` 的成功路径统一经 `#report` 输出,
+  受 `quiet` 控制;
+- `#execute` 在命令失败时无条件打印错误,不受 `quiet` 约束;现改为仅 `quiet` 为 `false` 时打印;
+- 配置模板中 `script` 字段的反斜杠被过度转义,解析后得到双反斜杠路径;现修正为单反斜杠;
+
+### 文档
+- README 新增「命令行」章节,含快速开始、命令表(按服务类与其它分组)、命令行参数、服务配置;
+- README 新增「参考配置」章节,逐字段说明含义与默认值;
+- README 函数方式示例改为导入 `win-service.config.js`,并补 `quiet` 说明;
+
+## [3.0.11] - 2026-10-25 15:57
+### 优化
+- 项目标点已改为以英文标点为主;
+- 行宽改为以 123 为主,部分超宽表格改为了列表;
+
+## [3.0.10] - 2026-09-29 19:29
+### 更改
+- 加固了拷贝文件的一些逻辑;
+- 升级了依赖;

package/LICENSE

@@ -1,35 +1,35 @@
-ISC 许可证 (ISC License)
-
-Copyright (c) 2026, flun <open@flun.top>
-衍生开发 本项目基于 Schley Andrew Kutz 等作者的原代码进行开发、修改和扩展;
-
-特此免费授予任何获得本软件及相关文档文件("软件")副本的人,不受限制地处理本软件的权利,
-包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,
-并允许向其提供本软件的人这样做,但须满足以下条件:
-
-上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中;
-
-本软件按"原样"提供,不作任何形式的明示或暗示的保证,
-包括但不限于适销性、特定用途的适用性和不侵权的保证;
-在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其它交易而产生的
-任何索赔、损害或其它责任负责,无论是合同之诉、侵权之诉还是其它行为之诉;
-
----
-
-英文原文 (English Version)
-
-ISC License
-
-Copyright (c) 2026, flun <open@flun.top>
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ISC 许可证 (ISC License)
+
+Copyright (c) 2026, flun <open@flun.top>
+衍生开发 本项目基于 Schley Andrew Kutz 等作者的原代码进行开发、修改和扩展;
+
+特此免费授予任何获得本软件及相关文档文件("软件")副本的人,不受限制地处理本软件的权利,
+包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,
+并允许向其提供本软件的人这样做,但须满足以下条件:
+
+上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中;
+
+本软件按"原样"提供,不作任何形式的明示或暗示的保证,
+包括但不限于适销性、特定用途的适用性和不侵权的保证;
+在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其它交易而产生的
+任何索赔、损害或其它责任负责,无论是合同之诉、侵权之诉还是其它行为之诉;
+
+---
+
+英文原文 (English Version)
+
+ISC License
+
+Copyright (c) 2026, flun <open@flun.top>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.