rust-jav-guide

name	rust-jav-guide
description	讲解如何使用 rust-jav 通过 `tui`、`ops` 和 `actor-links` 整理 JAV 媒体目录。适用于用户询问 rust-jav 怎么运行、某个命令做什么、该用哪些参数、preview / `--apply` / `--json` 的区别、如何生成示例 fixtures，或想要一套安全的 rust-jav 常见使用流程时。

Rust Jav 使用指南

概览

用这个 skill 来回答“rust-jav 怎么用”的问题：给出准确命令、安全默认值，以及基于真实 CLI 的实用工作流说明。

需要具体命令时，优先查看 references/usage.md。

回答流程

1. 先确认用户目标属于哪一类：
   • 想交互式查看 / 选择操作 → tui
   • 想整理、清理、重命名文件 → ops
   • 想根据 NFO 演员信息生成演员视图 → actor-links
2. 先强调安全规则：文件类操作默认都是 preview，只有加 --apply 才会真正改动文件系统。
3. 优先给出可以直接复制的命令，不要只讲抽象概念。
4. 如果示例里用到 ./examples/test，提醒用户先重新生成 fixtures：
   • bash examples/create_test_files.sh ./examples/test 因为之前执行过 --apply 后，示例目录可能已经不是初始状态。

回答要点

• 用户想看详细计划时，推荐加 --json。
• 讲到 delete-ad-files 时，必须明确提醒：--apply 下可能删除匹配到的视频文件。
• 用户说“全量整理”时，要说明不加 --op 的 ops 会跑完整流程，且 delete-ad-files 会最先执行。
• 用户问“它能做什么”时，先简要概括能力，再给最相关的命令例子。
• 用户问精确参数、命令格式或推荐流程时，优先用 references/usage.md 里的 repo 实际命令。

推荐输出结构

默认用这个简洁结构回答，除非用户要求更详细：

• 该用哪个命令
• 最安全的 preview 命令
• 如果需要，再给 apply 命令
• 最后补一个注意事项或小建议

边界

• 不要编造 tui、ops、actor-links 之外的 rust-jav 命令。
• 不要暗示“不加 --apply 也会修改文件”。
• 不要假设 ./examples/test 一定是干净的，除非刚运行过 fixture 脚本。