path-portability 是一项路径可移植性技能,适用于代码、安装器、归档文件、配置、子进程或脚本需要跨机器处理文件系统路径的场景。
用途 该技能用于约束和检查文件系统路径的写法,使路径在存在空格、Unicode 字符、不同盘符、不同用户主目录,以及从不同工作目录调用时仍然可用。
主要能力
- 要求在运行时解析已知根目录,避免在代码或配置中嵌入其他机器的主目录或盘符。
- 要求区分绝对路径与相对于所属脚本或配置的路径。
- 只在需要引用的边界处加引号,不把 shell 转义后的字符串作为文件系统路径存储。
- 使用路径 API 处理路径,而不是字符串拼接。
- 对子进程,在平台或 API 支持时传递参数数组。
- 测试路径中包含空格、非 ASCII 字符以及不同当前工作目录的情况。
- 对归档文件,拒绝目录穿越(..)、绝对成员和不安全设备名。
- 在 Windows 上,分别验证 PowerShell 5.1/cmd 与 POSIX shell 的引号处理;技能明确指出,在 C:\work 下可用的路径不构成可移植性证据。
使用方式 资料未提供具体安装命令、调用示例或配置步骤,暂未提供。
适用场景 适合在编写跨平台脚本、安装器、配置文件、归档处理逻辑和启动子进程时,作为路径处理的检查清单使用。
限制 该技能未提供具体工具实现、命令行接口或自动化测试脚本,仅给出规则与契约;其他功能细节暂未提供。