file-managerlisted
Install: claude install-skill zhuobichen/zhaowen-mcp
# 文件管理 Skill v2.5
Claude Code 原生文件管理 skill,覆盖**本地 + 远程**两类场景。
## 能力速览
| 类别 | 功能 |
|------|------|
| **本地** | 搜索、重命名、整理、统计(基于原生 bash/PowerShell) |
| **远程 CRUD** | 创建/读取/更新/删除/上传/下载,基于 SSH + SFTP |
| **远程批量** | 按名称/大小/内容查找、批量改权限、批量删除 |
| **远程共享** | **v2.5 三层独立授权**(容器/子项/未来项),容器 4 档(none/list/traverse/full),子项可按文件/通配符/子目录精细授权,`--level` 快捷等级 |
| **凭证** | 永久密钥(按 server-id 命名),IP 变化不影响复用 |
| **沙箱** | 默认锁死在 home,`--allow-escape`/`--allow-sudo` 显式开关;`--sandbox` 为 exec 启用路径检查 |
| **审计** | JSONL 格式,自动记录所有敏感/危险操作 |
| **即插即用** | 向导模式 + 配置文件批量 + `doctor` 自检 + 友好错误 |
## 触发场景
- "上传 ./local.tar.gz 到 prod 服务器"
- "从 staging 服务器下载 ~/logs 目录"
- "把 ~/reports/q2.pdf 共享给 alice"
- "删除服务器上 ~/old-data/ 整个目录"
- "在 ~/projects 下找所有 TODO 标记"
- "服务器 ~/scripts 下所有 .sh 改 755 权限"
- "绑定新服务器 1.2.3.4"
- "查看最近的共享操作记录"
- "把 test 目录分享给 lisi,他能看文件列表但不能改"
- "让 lisi 读 test 下的 .log 文件"
## 环境要求
- Node.js ≥ 18(Claude Code 内置)
- ssh2(由 `node scripts/install.js` 自动持久化)
- Windows / Linux 双平台(macOS 不在测试矩阵)
## 凭证目录
`~/.file-manager/`
```
~/.file-manager/
├── lib/node_modules/ssh2/ # 持久化依赖
├── keys/ # 各 server 密钥对
├── servers.json # 服务器配置
├── shares/ # 共享元数据(v2.5)
└── audit.log # 审计日志
```
## 快速开始
### 1. 首次安装
```bash
node scripts/install.js
```
### 2. 绑定服务器(向导)
```bash
node scripts/ssh-ops.js init
```
### 3. 或批量绑定(配置文件)
```bash
node scripts/ssh-ops.js init --config ./import.json
```
### 4. 自检
```bash
node scripts/ssh-ops.js doctor
```