SuperAPI AI 工具集

windowsfy

通用与其它

查看项目

更新于 10-15 23:25

技能介绍

用途:扫描 Node.js 项目的 package.json 脚本,找出在 Windows 原生 shell(CMD、PowerShell 5.1)下会失败的 Unix 专有写法,并在用户确认后应用可移植修复。

主要能力:检测六类问题——native-dep(需 MS BuildTools 的 C++ 插件包)、inline-env(KEY=val 前缀)、single-quote(单引号被 CMD 原样传递)、unix-cmd(rm -rf、chmod、cp -r 等)、glob-expand(CMD/PS 不展开 glob)、ps5-ampamp(PS 5.1 交互模式拒绝 &&)。每类给出严重级别,并支持跨平台修复(cross-env、shx、glob)或 CMD/PS 专用回退。

使用方式:以 /windowsfy [path] 调用,path 可为目录、单个 package.json 或省略(默认当前目录递归扫描)。先运行环境守卫 node <skill-dir>/scripts/scan.mjs --check-env --json,仅允许 Windows 原生 shell(cmd.exe、powershell.exe、pwsh.exe),Linux、macOS、WSL、Git Bash 等被阻止且无覆盖开关。随后询问用户所用交互 shell,再扫描、汇总、确认要修复的类别与修复风格,最后逐条编辑并重新扫描验证。也可直接运行 node scan.mjs --root <dir> | --file <path> [--shell cmd|ps5|ps7] [--json]。

适用场景:需要在 Windows 上运行或维护 Node.js 项目脚本、希望 package.json 跨平台可移植时。

限制:仅限 Windows 原生 shell;shell 专用回退会锁定脚本到该 shell;shx chmod 在 Windows 上是静默空操作;@tensorflow/tfjs-node 在 Windows 需 Node 24;PS 5.1 的 && 无法自动修复;存在 sed、含单引号 URL 等误报;npm 默认 script-shell 为 cmd.exe,选择 ps5/ps7 不影响 single-quote 与 unix-cmd 的运行时错误。其余细节暂未提供。