Nas Setup

Use when 用户说"连不上 NAS"、"检查 NAS 连接状态"、"NAS 环境有问题"、任何 MCP tool 返回 N001208/N001414 等鉴权错误、skill 跑之前先确认环境。所有其他 NAS skill 的第一步都应该先调此 skill。 触发词:检查 NAS、NAS 环境、连不上 NAS、NAS 连接状态、setup nas、NAS 配置检查、check nas。 不适用:不是解决具体业务问题的 skill — 只做环境校验;具体功能用对应的 skill。

43 stars 13 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add coracoo/zspace_skill --skill nas-setup
Manual install
git clone --depth 1 https://github.com/coracoo/zspace_skill.git /tmp/zspace_skill
mkdir -p ~/.claude/skills
cp -r /tmp/zspace_skill/skills/nas-setup ~/.claude/skills/nas-setup

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# NAS Setup — 环境检查 & 登录验证

## 概述

在任何 NAS 操作之前,**必须先跑这个前置检查**。它验证:
1. `.env` 是否配置完整
2. NAS 能否登录(鉴权链是否通)
3. device_id 是否有效(N001414 短信验证绕过了吗)
4. RAG daemon 是否在线(需要 RAG 的 skill 才检查)

## 工作流

### 前置检查(每次被触发时执行)

**方式 1(推荐)**: exec 自动化脚本,一次性输出全部结果
```
python skills/nas-setup/scripts/check.py
```

**方式 2**: Agent 手动逐项检查(脚本无法运行时备用)
1. **检查 `.env` 配置** — Agent 读 .env,检查 NAS_HOST/NAS_USER/NAS_PASSWORD 非空
2. **验证 NAS 登录** — 调 list_files MCP tool
3. **验证 RAG daemon** — 调 index_status() MCP tool

### 如果 .env 缺变量(Agent 交互修复)

check.py 返回 `❌ .env 配置: 不完整` 时,Agent **主动逐条问用户**,不要等用户去编辑:

```
Agent: "NAS 连接信息缺 2 项:
  1. NAS_HOST — 极空间的 IP 地址是什么?
  2. NAS_PASSWORD — 登录密码是什么?
  请依次告诉我。"
用户: "192.168.1.100"
Agent: "收到 NAS_HOST=192.168.1.100。密码呢?"
用户: "mypassword"
Agent: [编辑 .env 文件,写入 NAS_HOST 和 NAS_PASSWORD]
Agent: [重跑 check.py]
"✅ .env 配置: 完整。剩下 NAS 登录... [继续验证]"
```

**关键规则**:
- 不要只打印"请编辑 .env"就完事 — **必须逐条交互问用户**
- 密码类变量(NAS_PASSWORD/KEY_SSH)不回显
- 写入 .env 后立即重跑 check.py 验证

### 检查结果解读
   ```
   ✅ NAS 登录:通(用户 xxx)
   ✅ device_id:有效
   ✅ RAG daemon:在线(391 chunks, last_reindex xxx)
   
   或:
   ❌ NAS 登录: N001414 短信验证 — 把真实 device_id 填入 .env
   ⚠️ RAG daemon:未运行 — label-manager scan 按文件名匹配
   ```

## 跟其他 skill 的关系

所有其他 skill(SKILL.md)的第一步应引用:

```
**前置**:先调 nas-setup 检查环境。REQUIRED: 调 whoami() 验证登录,调 index_status() 验证 RAG。
```

## 故障排查

| 现象 | 处理 |
|---|---|
| `.env` 找不到 | `cp .env.example .env` |
| `NAS_USER/NAS_PASSWORD` 为空 | 编辑 `.env` 填入 |
Read the full skill on GitHub

Details

Skill name
nas-setup
Path
skills/nas-setup/SKILL.md
License
MIT
Repo updated
6 August 2026

FAQ

What does the Nas Setup skill do?

Use when 用户说"连不上 NAS"、"检查 NAS 连接状态"、"NAS 环境有问题"、任何 MCP tool 返回 N001208/N001414 等鉴权错误、skill 跑之前先确认环境。所有其他 NAS skill 的第一步都应该先调此 skill。 触发词:检查 NAS、NAS 环境、连不上 NAS、NAS 连接状态、setup nas、NAS 配置检查、check nas。 不适用:不是解决具体业务问题的 skill — 只做环境校验;具体功能用对应的 skill。

How do I install the Nas Setup skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add coracoo/zspace_skill --skill nas-setup. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Nas Setup popular?

It lives in coracoo/zspace_skill, which has 43 GitHub stars and 13 forks.

Related skills

File Organizer

43

coracoo/zspace_skill

Use when 用户想诊断 ZSpace NAS 文件库,找出重复文件 + 孤儿文件(只读,不动 NAS)。 触发词:重复文件、孤儿文件、文件整理诊断、哪些文件重复了、哪些文件没归类、找重复电影、找重复照片。 不适用:写操作(删除重复 / 移动孤儿)— 这些走 MCP tool(remove/move/save_file_label)+ LLM 二次确认,不在这 skill 范围。

Productivity & Notes13

IOS Memo Bak

43

coracoo/zspace_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 + 给配置步骤)。

Mobile Development13

Label Manager

43

coracoo/zspace_skill

管理和查询 ZSpace NAS 标签——按文件名打标(label-manager scan)、按文件内容语义搜打标(RAG)、按标签找文件、新建/删除标签。 触发词:打标签、给 XX 打 XX 标签、按标签找、找所有带 XX 标签的文件、新建标签、删除标签、给 XX 内容的文件打标签、智能打标、语义打标、给一年级的文件打《一年级》标签、给课本打标签、按内容找文件打标、给所有 XX 内容的文件批量打标。 不适用:文件重命名(用 MCP file_rename)、笔记搜索(用 MCP notebook_search)。

AI, LLMs & Agents13

RAG Manager

43

coracoo/zspace_skill

Use when 需要管理 RAG 语义搜索的索引生命周期 — 检查索引状态、重建索引、增量索引、移除索引、配置扫描范围。label-manager(RAG 场景) 的前置门控。 触发词:RAG 索引、语义搜索索引、重建索引、索引状态、重新索引、更新索引、reindex、NAS 文件索引、搜索索引管理、索引文件更新。 不适用:语义搜索本身(用 MCP semantic_search tool)、文件打标签(用 label-manager)、文件审计(用 file-organizer)。

AI, LLMs & Agents13

MCP Builder

49

vitoworleone/claude-code-handbook

Build MCP (Model Context Protocol) servers that give Claude new capabilities. Use when user wants to create an MCP server, add tools to Claude, or integrate external services.

AI, LLMs & Agents

Chat History

45

tyrchen/claude-skills

Extract and organize Claude Code session history into project .chats directory. Use when users want to document their Claude sessions, export conversation inputs, or maintain a log of instructions given to Claude.

AI, LLMs & Agents11

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.