菜单
Use when 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
管理和查询 ZSpace NAS 标签——按文件名打标(label-manager scan)、按文件内容语义搜打标(RAG)、按标签找文件、新建/删除标签。 触发词:打标签、给 XX 打 XX 标签、按标签找、找所有带 XX 标签的文件、新建标签、删除标签、给 XX 内容的文件打标签、智能打标、语义打标、给一年级的文件打《一年级》标签、给课本打标签、按内容找文件打标、给所有 XX 内容的文件批量打标。 不适用:文件重命名(用 MCP file_rename)、笔记搜索(用 MCP notebook_search)。
Use when 用户说"连不上 NAS"、"检查 NAS 连接状态"、"NAS 环境有问题"、任何 MCP tool 返回 N001208/N001414 等鉴权错误、skill 跑之前先确认环境。所有其他 NAS skill 的第一步都应该先调此 skill。 触发词:检查 NAS、NAS 环境、连不上 NAS、NAS 连接状态、setup nas、NAS 配置检查、check nas。 不适用:不是解决具体业务问题的 skill — 只做环境校验;具体功能用对应的 skill。
Use when 需要管理 RAG 语义搜索的索引生命周期 — 检查索引状态、重建索引、增量索引、移除索引、配置扫描范围。label-manager（RAG 场景） 的前置门控。 触发词:RAG 索引、语义搜索索引、重建索引、索引状态、重新索引、更新索引、reindex、NAS 文件索引、搜索索引管理、索引文件更新。 不适用:语义搜索本身(用 MCP semantic_search tool)、文件打标签(用 label-manager)、文件审计(用 file-organizer)。
Use when 用户想诊断极影视分类问题 — "我的影视库分类有没有问题"、"frds 这个分类是不是太杂了"、"哪些影片分错类了"、"帮我出个影视库整理报告"。6 个命令:5 个只读审计(分类/源目录/影片抽样/挪动建议/一键全跑)+ 1 个跨库文件物理迁移(migrate,默认 dry-run)。 触发词:极影视整理、影片库分类诊断、影视分类不规范、frds 拆分、整理影视库、影视分类合并建议、影片是否在对的分类、collection 错放、哪些影片分错类了、影视库审计、极影视诊断、影视文件挪库、文件放错库、跨库迁移、A 仓库的挪到 B 仓库、move file to right library、影视库文件挪动。 不适用:写操作(合并分类/移动影片/重命名)— 这些走 MCP tool + LLM 二次确认,不在这 skill 范围。**例外 1**:挪文件物理位置让极影视自动重扫是可行路径(不走 MCP 写 tool,直接 move/rename MCP tool + 等 NAS 自己重扫)— 走 `migrate` 子命令(场景 5,基于 `migration-rules.yaml` 配置,默认 dry-run,逐条确认)。**例外 2**:整分类的 metadata 修改(collection 挪分类)无 NAS API 端点,只能 pcweb UI 改。
Use when 用户想把 iPhone 备忘录自动备份到 NAS 记事本 — "帮我设置 iPhone 备忘录同步"、"重新告诉我一下怎么配"、"换一个新的备份密钥"、"我同事也要用这个功能"。 触发词:iPhone 备忘录同步、ios 备忘录 bak、备忘录备份到 NAS、备忘 → NAS、iPhone notepad sync、ios 备忘录、备忘录同步、iphone shortcut 备份、iPhone 推笔记、给我配 iPhone 备份、帮我把备忘录同步到 NAS。 不适用:不是直接写 NAS 的 skill — 实际写由 iPhone Shortcut 发起;此 skill 只设置基础设施(生成密钥 + 重启 dashboard + 给配置步骤)。
| name | file-organizer |
| description | Use when 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。 |
通过组合 NAS MCP tool + file_organizer.py 脚本,只读诊断文件库的"重复"和"孤儿"问题。
所有写操作都不在 skill 里 — 报告生成后,用户手动决定怎么处理。
| 命令 | 用途 | 走哪个端点 |
|---|---|---|
audit-duplicates | 扫全盘找重复文件(按 size+ext 弱指纹) | /v2/file/list + /zspool/info |
audit-orphans | 找无标签 + 非影视目录的孤儿文件 | /v2/file/list + /zvideo/classification/dirs |
audit-all | 一键全跑(重复 + 孤儿) | 上面两个一起 |
步骤:
python skills/file-organizer/file_organizer.py audit-duplicates --output /tmp/dups.json步骤:
python skills/file-organizer/file_organizer.py audit-orphans --output /tmp/orphans.json步骤:
python skills/file-organizer/file_organizer.py audit-all --output /tmp/full-report.jsonremove / move / save_file_label,LLM 弹 UI 让用户批remove 不进回收站,不可逆 — 处理重复文件时优先 move 到 _to_review/,人工确认后再删/v2/file/list 返回的 file_hash 对真实文件也返回空字符串(size, ext) 弱指纹分组/<pool>/my/data/ 下(注意是 /my/data/,不是 /my/)| 选项 | 默认值 | 说明 |
|---|---|---|
--pool <NAME> | (所有池) | 限定扫描某个池 |
--output <PATH> | (不写文件) | 将 JSON 详细结果写入文件 |
--sample <N> | 0(不限) | 限制扫描文件数(测试用) |
--min-size <MB> | 1 | 忽略小于 N MB 的文件 |
# 扫所有池找重复,只看 >= 10MB 的文件
python skills/file-organizer/file_organizer.py audit-duplicates --min-size 10
# 只扫 sata14 池,限制 1000 个文件(测试)
python skills/file-organizer/file_organizer.py audit-orphans --pool sata14 --sample 1000
# 综合诊断,写 JSON
python skills/file-organizer/file_organizer.py audit-all --output /tmp/audit.json
======================================================================
file_organizer — 重复文件诊断报告
======================================================================
指纹策略: size+ext(weak)
NAS list_files 的 file_hash 对真实文件也返回空字符串(Step 7.1 验证),
无法用于精确去重。本策略用 (size, ext) 弱指纹分组,组内 >1 即候选重复。
误报率较高(同 size 同 ext 但内容不同),需人工核对。
扫描池: sata14
已扫描文件: 15234
因 < min_size 跳过: 8912
访问目录数: 342
重复组数: 187
浪费总空间: 45.23 GB (48564160032 bytes)
Top 20 候选重复组(按浪费空间降序):
[1] size=1.23 GB count=3 wasted=2.46 GB
fp=size:1318584546|ext:zip
- /sata14/my/data/downloads/backup.zip
- /sata14/my/data/backup.zip
- /sata14/my/data/archives/backup.zip
...
{
"cmd": "audit-duplicates",
"strategy": "size+ext(weak)",
"strategy_note": "NAS list_files 的 file_hash 对真实文件也返回空字符串...",
"pools_scanned": ["sata14"],
"pools_skipped": [],
"total_scanned": 15234,
"total_skipped_small": 8912,
"dirs_visited": 342,
"duplicate_groups": 187,
"total_wasted_bytes": 48564160032,
"total_wasted_human": "45.23 GB",
"duplicates": [
{
"fingerprint": "size:1318584546|ext:zip",
"size": 1318584546,
"count": 3,
"wasted_bytes": 2637169092,
"paths": ["/sata14/my/data/downloads/backup.zip", ...]
}
],
"errors": [],
"truncated": false
}
/<pool>/share/ 不在扫描范围(默认只扫 /<pool>/my/data/)| 现象 | 原因 | 处理 |
|---|---|---|
| 扫描卡住 | NAS list_files 限流或网络慢 | 加 --sample 1000 限制条数,或等待 |
audit-duplicates 误报多 | NAS 不返回 hash,用弱指纹 | 报告里说明,人工核对;勿批量自动删除 |
audit-orphans 报错"找不到 label 端点" | NAS 端点未破或网络问题 | 查 JSON errors 字段详情 |
| 某个池显示"perm"跳过 | /my/ 无权限,应扫 /my/data/ | 脚本已自动修正,但若仍报错检查池权限 |
| N150 性能问题 | 扫描太密集 | 脚本已内置 sleep 0.1s(~10 req/s),若仍卡顿加 --sample |
recent_files 找长期未访问的,建议从 SSD 移到 HDD