{"skill":{"slug":"file-manager-service","displayName":"File Manager Service","summary":"文件管理服务，支持服务启停、Web 界面浏览、文件上传下载和目录管理","description":"---\nname: file-manager-service\ndescription: 文件管理服务，支持服务启停、Web 界面浏览、文件上传下载和目录管理\n---\n\n# File Manager Service Skill\n\n操作运行在 `http://127.0.0.1:8888` 的文件管理服务，管理用户家目录下的 `~/.openclaw/workspace/projects` 目录。\n\n## 目录结构\n\n```\nfile-manager-service/\n├── SKILL.md                      # Skill 定义\n├── README.md                     # 使用说明\n├── _meta.json                    # 元数据\n├── .gitignore                    # Git 忽略文件\n└── scripts/\n    ├── file_manager.py           # 客户端脚本（含服务管理）\n    ├── server.py                 # Flask 服务端\n    ├── templates/\n    │   └── index.html            # Web 界面模板\n    ├── .service.pid              # 服务进程 ID（运行时生成）\n    └── .service.log              # 服务日志（运行时生成）\n```\n\n## 快速开始\n\n### 服务管理\n\n```bash\n# 启动服务\npython scripts/file_manager.py start\n\n# 停止服务\npython scripts/file_manager.py stop\n\n# 重启服务\npython scripts/file_manager.py restart\n\n# 查看状态\npython scripts/file_manager.py status\n\n# 打开 Web 页面\npython scripts/file_manager.py open\n```\n\n### 文件管理\n\n```bash\n# 列出文件\npython scripts/file_manager.py list\n\n# 列出指定目录\npython scripts/file_manager.py list ai-agent-enterprise-design\n\n# 查看文件内容\npython scripts/file_manager.py cat path/to/file.md\n\n# 搜索文件\npython scripts/file_manager.py search 关键词\n\n# 统计信息\npython scripts/file_manager.py stats\n\n# 创建目录（自动递归创建父目录）\npython scripts/file_manager.py mkdir parent/path NewDirName\n\n# 删除文件/目录\npython scripts/file_manager.py delete path/to/item\n\n# 移动文件/目录\npython scripts/file_manager.py move source/path dest/path\n\n# 获取/设置目录备注\npython scripts/file_manager.py note directory-name\npython scripts/file_manager.py note directory-name 备注内容\n\n# 上传文件（支持多个文件）\npython scripts/file_manager.py upload file1.md file2.py\npython scripts/file_manager.py upload *.txt -p project/docs\n```\n\n### 直接调用 API\n\n| 操作 | 端点 | 方法 |\n|------|------|------|\n| 列出文件 | `/api/files?path=xxx` | GET |\n| 获取文件内容 | `/api/file/content?path=xxx` | GET |\n| 保存文件 | `/api/file/save` | POST |\n| 下载文件 | `/api/file/download?path=xxx` | GET |\n| 删除 | `/api/delete` | POST |\n| 移动 | `/api/move` | POST |\n| 创建目录 | `/api/create/dir` | POST |\n| 创建文件 | `/api/create/file` | POST |\n| 搜索 | `/api/search?q=xxx&regex=true` | GET |\n| 统计 | `/api/stats` | GET |\n| 获取备注 | `/api/notes/get?path=xxx` | GET |\n| 保存备注 | `/api/notes/save` | POST |\n| 目录树 | `/api/tree?path=xxx` | GET |\n| 下载目录 | `/api/download?path=xxx` | GET |\n| **上传文件** | `/api/upload` | POST |\n| **批量上传** | `/api/upload-folder` | POST |\n\n## 使用示例\n\n### 启动服务并打开页面\n\n```bash\npython scripts/file_manager.py start\npython scripts/file_manager.py open\n```\n\n### 查看服务状态\n\n```bash\npython scripts/file_manager.py status\n```\n\n输出：\n```json\n{\n  \"running\": true,\n  \"pid\": 84078,\n  \"url\": \"http://127.0.0.1:8888\",\n  \"service_dir\": \"/Users/lengyanhua/.openclaw/skills/file-manager-service/file-manager-service\"\n}\n```\n\n### 递归创建目录\n\n```bash\n# 自动创建 a/b/c 目录链\npython scripts/file_manager.py mkdir a/b NewDir\n```\n\n### 创建文件到不存在的目录\n\n```bash\n# 自动创建父目录后创建文件\npython scripts/file_manager.py mkdir x/y test.txt \"文件内容\"\n```\n\n## 支持的文件类型\n\n**上传：** 不限制文件类型，支持任意格式（.pdf, .docx, .xlsx, .zip, 图片，视频等）\n\n**在线查看/编辑：** `.txt`, `.md`, `.html`, `.py`, `.js`, `.json`, `.yaml`, `.yml`, `.css`, `.xml`, `.log`, `.sh`, `.bash`, `.sql`, `.java`, `.go`, `.rs`, `.ts`, `.jsx`, `.tsx`, `.htm`, `.svg`\n\n**注意：** 非文本文件（如 PDF、图片）可上传和下载，但无法在线预览编辑\n\n## 安全限制\n\n- 所有路径必须在 `~/.openclaw/workspace/projects` 内\n- 不能删除根目录\n- 隐藏文件（以 `.` 开头）不显示\n- 目录备注仅支持第一级子目录\n\n## 故障排除\n\n**服务启动失败**：检查 `scripts/.service.log` 日志文件\n\n**端口被占用**：`lsof -ti :8888 | xargs kill -9` 然后重新启动\n\n**路径非法**：确保路径在允许的根目录内\n\n**文件类型不支持**：检查文件扩展名是否在允许列表中\n\n**权限错误**：确认家目录可写（macOS 上不要使用 `/root` 路径）\n\n## 特性\n\n- ✅ 自动递归创建父目录\n- ✅ 跨平台支持（macOS/Linux，自动检测家目录）\n- ✅ Web 界面浏览和管理文件\n- ✅ 目录备注功能\n- ✅ 搜索文件和目录（支持正则表达式）\n- ✅ 目录打包下载（ZIP）\n- ✅ 移动文件/目录自动避免覆盖\n- ✅ 现代化 UI 设计（Apple 风格，毛玻璃效果）\n- ✅ 优化的删除/备注/移动确认对话框\n","tags":{"latest":"1.1.3"},"stats":{"comments":0,"downloads":806,"installsAllTime":0,"installsCurrent":0,"stars":1,"versions":5},"createdAt":1773418312372,"updatedAt":1779078143073},"latestVersion":{"version":"1.1.3","createdAt":1773590047119,"changelog":"file-manager-service 1.1.3\n\n- 改进 Web UI，采用现代化 Apple 风格设计并加入毛玻璃效果\n- 优化删除、备注、移动操作的确认对话框体验\n- 文档（SKILL.md, README.md）更新：反映新版界面和特性\n- package.json 更新，维护依赖和元数据","license":"MIT-0"},"metadata":null,"owner":{"handle":"lengyhua","userId":"s173z8c1chctdedrgt7dve44p5885yyw","displayName":"lengyhua","image":"https://avatars.githubusercontent.com/u/25021079?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089899840}}