메뉴
管理和查询 ZSpace NAS 标签——按文件名打标(label-manager scan)、按文件内容语义搜打标(RAG)、按标签找文件、新建/删除标签。 触发词:打标签、给 XX 打 XX 标签、按标签找、找所有带 XX 标签的文件、新建标签、删除标签、给 XX 内容的文件打标签、智能打标、语义打标、给一年级的文件打《一年级》标签、给课本打标签、按内容找文件打标、给所有 XX 内容的文件批量打标。 不适用:文件重命名(用 MCP file_rename)、笔记搜索(用 MCP notebook_search)。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。
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 | label-manager |
| description | 管理和查询 ZSpace NAS 标签——按文件名打标(label-manager scan)、按文件内容语义搜打标(RAG)、按标签找文件、新建/删除标签。 触发词:打标签、给 XX 打 XX 标签、按标签找、找所有带 XX 标签的文件、新建标签、删除标签、给 XX 内容的文件打标签、智能打标、语义打标、给一年级的文件打《一年级》标签、给课本打标签、按内容找文件打标、给所有 XX 内容的文件批量打标。 不适用:文件重命名(用 MCP file_rename)、笔记搜索(用 MCP notebook_search)。 |
NAS 标签的全生命周期管理——两种发现方式,同一入口:
| 发现方式 | 用哪个命令 | 适合 |
|---|---|---|
| 按文件名/扩展名 | label_manager.py scan + find-by-label | 目录递归、批量、精确匹配 |
| 按文件内容(RAG 语义) | 纯 LLM 编排,semantic_search → save_file_label | 自然语言描述、不靠文件名 |
最终都走 save_file_label MCP tool 落盘。
前置:nas-setup skill(验证 NAS 登录)。RAG 场景额外需要 rag-manager(门控)。
| list_file_labels | 列出所有标签 |
| save_file_label(label_names, paths) | 打标签(覆盖式,会自动创建新标签名) |
| delete_label(label_names) | 删除标签(从所有文件上彻底移除) |
| notebook_updatelabel(id, label) | 笔记标签 |
| label_manager.py 命令(机械活) | 用途 |
|---|---|
list-labels | 同 MCP,但走脚本(批量友好) |
scan --root X --ext Y | BFS 扫目录找文件(LLM 决策前先用) |
find-by-label --label X | 反向查询带某标签的文件 |
用户说:"给 /sata14/my/data/docker-compose.yml 打 docker 标签"
步骤:
save_file_label(label_names="docker", paths="/sata14/my/data/docker-compose.yml")注意:
paths 多个用英文逗号分隔,最多 50 个/次(NAS 限速)label_names 里有不存在的标签名,NAS 会自动创建用户说:"把 /sata14/my/data/ 下所有 .yml 文件打 docker 标签"
步骤:
python skills/label-manager/label_manager.py scan --root /sata14/my/data/ --ext yml --max-depth 5 --output /tmp/scan.json/tmp/scan.json,得到 items 数组(含 path/name/labels)save_file_label(label_names="docker", paths="path1,path2,...") 分批执行为什么 LLM 决策:不是所有 .yml 都是 docker 配置。LLM 看 path/name 决定。
用户说:"找所有带 docker 标签的文件"
步骤:
python skills/label-manager/label_manager.py find-by-label --label docker --root /sata14/my/data/ --max-depth 5 --output /tmp/docker.json/tmp/docker.json,得到 matches 数组(含 path/name/is_dir/labels)已知 gap:
--max-depth 限制,深度外文件找不到/<pool>/my/<子目录>/,跨池越权 N001411用户说:"新建一个 备份 标签"
步骤:
save_file_label(label_names="备份", paths="/sata14/my/data/")(自动建)list_file_labels() 验证已存在注意:
save_file_label 传不存在标签名会自动建paths="/sata14/my/data/"(任意已有路径)用户说:"删除 docker 标签"
步骤:
list_file_labels() 确认标签名拼写正确(避免删错)delete_label(label_names="docker")/<pool>/my/<子目录>/,目录必须以 / 结尾file_info(path) 看当前标签list_files("/sata14/my/data/") → 找到路径 /sata14/my/data/docker-compose.ymlsave_file_label("docker", "/sata14/my/data/docker-compose.yml")exec label_manager.py scan --root /sata14/my/data/ --ext yml --max-depth 5save_file_label(每批 50 个)exec label_manager.py find-by-label --label dockersave_file_label("备份", "/sata14/my/data/")(自动建)list_file_labels() 验证list_file_labels() 确认存在delete_label("docker")| 现象 | 原因 | 处理 |
|---|---|---|
RuntimeError: NAS_USER / NAS_PASSWORD env not set | .env 没加载或没填 | cp .env.example .env + 填密码 |
找不到 /sata14/my/data/ | 路径错(忘了 /) | 目录路径必须 / 结尾 |
code=N001411 无权限 | 路径不在 /<pool>/my/<子目录>/ | 用户只能扫自己 /池名/my/ 下 |
code=N001212 参数有误 | 字段名错或 JSON 而非 form | 走 MCP tool,不用脚本 |
| 扫目录很慢 | max-depth 太深或目录太多 | 改小 --max-depth 或换更窄的 --root |
| 找不到带标签的文件 | max-depth 不够 | 加大 --max-depth(但会更慢) |
| 标签删除后没生效 | NAS 缓存 | 几秒后刷新 |
| 标签名拼错 | delete 是按名字匹配 | 先 list_file_labels() 看准确名字 |
/v2/file/list 返回的 item 字段:
is_dir 是字符串 "0" 或 "1",不是 boolsize / modify_time 是字符串(不是 int),脚本里要 int()labels 是逗号分隔字符串(如 "docker" 或 "docker,重要"),要 splitdata.list(不是 data.items)/v2/labels/alllabels 返回的 list 元素:
id / created_at / updated_at / weight 是 intlabel_name 是 strtop_flag 是 int(0/1)步骤:
rag-manager skill → index_status → chunks>0 通过,不通拒绝semantic_search(query=关键词,scope="files",top_k=30) → 命中清单list_file_labels() 确认标签名save_file_label(label_names="标签", paths="...") — MCP 弹 UI,≤50 个/批文件 > RAG_MAX_FILE_SIZE_KB(默认 100KB)不进索引。降级:文件名匹配(场景 2 scan)。
list_files(范围) + semantic_search(关键词) → Agent 取交集 → save_file_label
file_info 看现有标签| 场景 | 走哪 |
|---|---|
| 按文件名/扩展名打标 | label-manager scan(本 skill) |
| 按内容语义搜打标 | label-manager 场景 6-8(本 skill) |
| RAG 索引管理 | rag-manager |
| 按标签反向查文件 | label-manager find-by-label |
| 新建/删除标签 | label-manager |
| 找重复/孤儿文件 | file-organizer |