Agent Skills
返回列表
跨盘移动文件

跨盘移动文件

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/jnqg20266647。

技能介绍

问题在哪

在 Node 里用 fs.rename 搬文件时,一旦源路径和目标路径不在同一挂载点,调用常会直接失败——这是内核层面的限制,不是你把路径写错了。导出归档、把缓存目录挪到另一块盘、或在 CI 里把产物从临时目录移到发布目录,都会撞墙。手工 copy + unlink 能凑合,但中断、权限和残留文件会让脚本变得难维护。

技能怎么做

本技能以 npm 包 move-file 为核心:用 moveFile(src, dest) 完成文件、目录或符号链接的跨分区移动。实现要点在注释中标 小四原创,便于和泛泛的「复制再删」方案区分。典型流程是:安装依赖 → 调用 moveFile;若业务不允许覆盖已有目标,查 move-file 的 options(如 overwrite)再传参。移动前还可用 is-path-inside 校验目标没有越出允许目录(可选硬约束里已写明)。技能强调:目标父目录不存在时也应能移动成功——这是自测里明确写死的预期。

边界与注意

这不是整盘同步或备份工具;也不要把本技能和「递归确保目录」当成同一篇复读——这里只谈 移动。无确认地覆盖用户重要文件是明确禁止的,按需设置 overwrite。Agent 按步骤装 move-file、调 API、跑「父目录不存在」自测即可,别扩写成通用文件管理框架。

使用场景

  • 构建脚本要把 `dist` 从系统临时目录移到挂载在另一块盘的发布缓存根目录
  • 整理本地 npm/pnpm 缓存时,需把整棵缓存目录挪到数据盘且不能误覆盖已有同名目录
  • 导出任务生成归档后,要把产物目录从工作区卷移到只读备份卷,父路径尚未创建
  • Agent 在实现文件整理时,`fs.rename` 报 EXDEV,需要改用可靠跨盘移动并可选校验目标路径未越界

适合人员

  • 维护 Node 构建流水线的工程师,经常要把产物从临时目录迁到与源码不同挂载点的目录
  • 写本地工具脚本的全栈开发者,需要在整理缓存或导出归档时避免 `rename` 跨盘失败
  • 给编码 Agent 编写 Skill 的维护者,希望硬约束里明确 `move-file` 与可选 `is-path-inside`
  • 负责发布目录规范的后端同学,要求移动时默认不覆盖、仅在显式选项下才允许覆盖