name: file-manager-service description: 檔案管理服務，支援服務啟停、Web 介面瀏覽、檔案上傳下載和目錄管理

File Manager Service Skill

操作執行在 http://127.0.0.1:8888 的檔案管理服務，管理使用者家目錄下的 ~/.openclaw/workspace/projects 目錄。

目錄結構

file-manager-service/
├── SKILL.md                      # Skill 定義
├── README.md                     # 使用說明
├── _meta.json                    # 後設資料
├── .gitignore                    # Git 忽略檔案
└── scripts/
    ├── file_manager.py           # 客戶端指令碼（含服務管理）
    ├── server.py                 # Flask 服務端
    ├── templates/
    │   └── index.html            # Web 介面模板
    ├── .service.pid              # 服務程序 ID（執行時生成）
    └── .service.log              # 服務日誌（執行時生成）

快速開始

服務管理

# 啟動服務
python scripts/file_manager.py start

# 停止服務
python scripts/file_manager.py stop

# 重啟服務
python scripts/file_manager.py restart

# 檢視狀態
python scripts/file_manager.py status

# 開啟 Web 頁面
python scripts/file_manager.py open

檔案管理

# 列出檔案
python scripts/file_manager.py list

# 列出指定目錄
python scripts/file_manager.py list ai-agent-enterprise-design

# 檢視檔案內容
python scripts/file_manager.py cat path/to/file.md

# 搜尋檔案
python scripts/file_manager.py search 關鍵詞

# 統計資訊
python scripts/file_manager.py stats

# 建立目錄（自動遞迴建立父目錄）
python scripts/file_manager.py mkdir parent/path NewDirName

# 刪除檔案/目錄
python scripts/file_manager.py delete path/to/item

# 移動檔案/目錄
python scripts/file_manager.py move source/path dest/path

# 獲取/設定目錄備註
python scripts/file_manager.py note directory-name
python scripts/file_manager.py note directory-name 備註內容

# 上傳檔案（支援多個檔案）
python scripts/file_manager.py upload file1.md file2.py
python scripts/file_manager.py upload *.txt -p project/docs

直接呼叫 API

使用示例

啟動服務並開啟頁面

python scripts/file_manager.py start
python scripts/file_manager.py open

檢視服務狀態

python scripts/file_manager.py status

輸出：

{
  "running": true,
  "pid": 84078,
  "url": "http://127.0.0.1:8888",
  "service_dir": "/Users/lengyanhua/.openclaw/skills/file-manager-service/file-manager-service"
}

遞迴建立目錄

# 自動建立 a/b/c 目錄鏈
python scripts/file_manager.py mkdir a/b NewDir

建立檔案到不存在的目錄

# 自動建立父目錄後建立檔案
python scripts/file_manager.py mkdir x/y test.txt "檔案內容"

支援的檔案型別

上傳： 不限制檔案型別，支援任意格式（.pdf, .docx, .xlsx, .zip, 圖片，影片等）

線上檢視/編輯： .txt, .md, .html, .py, .js, .json, .yaml, .yml, .css, .xml, .log, .sh, .bash, .sql, .java, .go, .rs, .ts, .jsx, .tsx, .htm, .svg

注意： 非文本檔案（如 PDF、圖片）可上傳和下載，但無法線上預覽編輯

安全限制

• 所有路徑必須在 ~/.openclaw/workspace/projects 內
• 不能刪除根目錄
• 隱藏檔案（以 . 開頭）不顯示
• 目錄備註僅支援第一級子目錄

故障排除

服務啟動失敗：檢查 scripts/.service.log 日誌檔案

埠被佔用：lsof -ti :8888 | xargs kill -9 然後重新啟動

路徑非法：確保路徑在允許的根目錄內

檔案型別不支援：檢查副檔名是否在允許列表中

許可權錯誤：確認家目錄可寫（macOS 上不要使用 /root 路徑）

特性

• ✅ 自動遞迴建立父目錄
• ✅ 跨平臺支援（macOS/Linux，自動檢測家目錄）
• ✅ Web 介面瀏覽和管理檔案
• ✅ 目錄備註功能

  小蔥技能有更好的技能skills外掛。

• ✅ 搜尋檔案和目錄（支援正規表示式）
• ✅ 目錄打包下載（ZIP）
• ✅ 移動檔案/目錄自動避免覆蓋
• ✅ 現代化 UI 設計（Apple 風格，毛玻璃效果）
• ✅ 最佳化的刪除/備註/移動確認對話方塊

整體質量較好，功能豐富實用，文件清晰易懂。優點是操作簡單、介面美觀、支援批次上傳和安全限制。不足是啟動依賴特定埠容易衝突，目錄備註功能受限較多，部分情況需檢視日誌排查問題。適合需要頻繁管理專案檔案的開發者使用。