@flun/windows 3.0.4 → 3.0.6

package/CHANGELOG.md

@@ -1,16 +1,8 @@
 # 变更日志
-## [3.0.4] - 2026-06-13 15:44
-### 优化
-- 内部细节优化
-## [3.0.0] - 2026-5-28 21:40
-### 破坏性变更
-- 移除 `sudo: { enabled: false }` 配置项，现在内部自动检查 sudo 可用性并默认使用提权方式，不再支持显式关闭。
+## [3.0.6] - 2026-07-06 15:31
 
-### 修复
-- 修复 Windows 服务环境下 `os.homedir()` 返回系统目录（如 `C:\Windows\System32\config\systemprofile`）而非当前用户目录的问题
-  现在在生成服务 XML 配置时，会自动将安装服务时的当前用户 `USERPROFILE` 注入到服务进程的环境变量中，使得 `os.homedir()` 正确返回用户目录，从而解决依赖用户目录的证书续期等业务路径错误的问题;
-
-### 优化
-- 简化 `#xml` getter 中的环境变量处理逻辑，自动合并用户自定义的 `env` 配置，仅在未显式设置 `USERPROFILE` 时追加正确的用户目录;
-- 简化内部提权判断逻辑,统一使用 `sudo`作为默认（若可用）, `elevate` 次之作为提权方式。
-- 删除了一些没有使用的导出等一些细节优化;
+### 新增
+- 在 README 中新增“配置”章节，指导用户通过 `allowScripts` 显式放行本包的安装脚本，避免因 `ignore-scripts` 全局配置导致钩子被跳过。
+## [3.0.5] - 2026-06-16 20:09
+### 变更
+- 联系邮箱更改为:open@flun.top;

package/LICENSE

@@ -1,6 +1,6 @@
 ISC 开源许可声明
 版权信息
-衍生开发 Copyright (c) 2026, flun <cn@flun.top>
+衍生开发 Copyright (c) 2026, flun <open@flun.top>
 
 本项目（软件包）基于 Schley Andrew Kutz 等作者的原代码进行开发、修改和扩展。
 

package/README.md

@@ -1,6 +1,6 @@
 # @flun/windows
 
-本工具库能将您的 Node.js 应用程序作为 Windows 后台服务来运行和管理,支持服务的安装、启动、停止及卸载全流程;还提供事件日志等功能,它主要用于面向生产环境应用程序的部署与运维;如需联系,邮箱: [cn@flun.top](mailto:cn@flun.top)
+本工具库能将您的 Node.js 应用程序作为 Windows 后台服务来运行和管理,支持服务的安装、启动、停止及卸载全流程;还提供事件日志等功能,它主要用于面向生产环境应用程序的部署与运维;如需联系,邮箱: [open@flun.top](mailto:open@flun.top)
 
 ### 本包基于 ESM 模块系统编写->拥抱未来趋势
 
@@ -33,6 +33,27 @@
 
 Windows 上的原生 Node 模块安装复杂,通常需要 Visual Studio 和 node-gyp 进行编译;@flun/windows **不依赖任何原生模块**,所有二进制工具均已预打包,无需安装 Visual Studio 等编译环境;
 
+## 配置
+
+### 允许安装脚本执行
+
+本包在安装时可能触发某些依赖包的自动脚本（如 `postinstall` 等）;如果你的 npm 全局配置或项目配置禁止了脚本执行（例如设置了 `ignore-scripts=true`）,可能会导致安装不完整或运行时异常;
+
+推荐在项目根目录的 `package.json` 中添加 `allowScripts` 字段,显式放行本包及其依赖的脚本:
+
+```json
+{
+  "allowScripts": {
+    "@flun/windows": true
+    // 如果依赖的其他包（如 bcrypt、electron-winstaller 等）也有脚本,请按需添加,格式相同
+  }
+}
+```
+
+> 如果你信任所有安装包,也可以直接在项目 `.npmrc` 中设置 `allow-scripts = false`（表示关闭脚本拦截,所有脚本均允许执行）,或删除/设为 `ignore-scripts = false`;
+
+配置后,再次运行 `npm install` 即可正常执行所有安装钩子;
+
 ---
 
 # Windows 服务管理
@@ -356,5 +377,4 @@ kill(进程PID, () => {
 
 # 许可证
 
-winsw 和 sudowin 遵循各自所有者的许可证;@flun/windows 核心代码采用 ISC 许可证（具体内容请见许可证文档）
-```
+winsw 和 sudowin 遵循各自所有者的许可证;@flun/windows 核心代码采用 ISC 许可证（具体内容请见许可证文档）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flun/windows",
-  "version": "3.0.4",
+  "version": "3.0.6",
   "description": "支持 Windows 服务、事件日志、UAC 以及多种与操作系统交互的辅助方法",
   "keywords": [
     "windows",
@@ -13,7 +13,7 @@
     "sudo",
     "task"
   ],
-  "author": "flun <cn@flun.top>",
+  "author": "flun <open@flun.top>",
   "publishConfig": {
     "access": "public"
   },