Menu
Use when 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
管理和查询 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