file-manager git:20260209.143da4dA

Immutable. This exact content is served forever at /api/v1/blob/44a1963ab0524a23.

---
name: file-manager
description: NAS 共用檔案搜尋、PDF 轉圖片
allowed-tools: search_nas_files get_nas_file_info prepare_file_message convert_pdf_to_images
metadata:
  ctos:
    requires_app: file-manager
    mcp_servers: ching-tech-os
---

【NAS 共用檔案】
- search_nas_files: 搜尋 NAS 共享檔案（搜尋範圍包含：專案資料、線路圖）
  · keywords: 多個關鍵字用逗號分隔（AND 匹配，大小寫不敏感）
  · file_types: 檔案類型過濾，如 pdf,xlsx,dwg
  · 範例：search_nas_files(keywords="亦達,layout", file_types="pdf")
  · 結果路徑格式：shared://projects/... 或 shared://circuits/...
  · ⚠️ 注意：查找「最近的圖片」或「剛才的圖」請用 get_message_attachments，不要用此工具
- get_nas_file_info: 取得 NAS 檔案詳細資訊（大小、修改時間）
- prepare_file_message: 準備檔案訊息（推薦使用）
  · file_path: 檔案完整路徑（從 search_nas_files 取得）
  · 圖片（jpg/png/gif 等）< 10MB 會直接顯示在回覆中
  · 其他檔案會以連結形式顯示
  · 重要：工具返回的 [FILE_MESSAGE:...] 標記必須原封不動包含在回應中，系統會自動處理
  · 注意：圖片/檔案會顯示在文字下方，請用 👇 而非 👆

【PDF 轉圖片】
- convert_pdf_to_images: 將 PDF 轉換為圖片（方便在 Line 中預覽）
  · pdf_path: PDF 檔案路徑（用戶上傳的 /tmp/bot-files/... 或 NAS 路徑）
  · pages: 要轉換的頁面
    - "0"：只查詢頁數，不轉換
    - "1"：只轉換第 1 頁
    - "1-3"：轉換第 1 到 3 頁
    - "all"：轉換全部（預設）
  · output_format: png（預設）或 jpg
  · dpi: 解析度，預設 150
  · 回傳 JSON 包含 total_pages、converted_pages、images（圖片路徑陣列）

【PDF 轉圖片使用流程】
1. 用戶上傳 PDF 並要求轉圖片時：
   - 先用 convert_pdf_to_images(pdf_path="...", pages="0") 查詢頁數
   - 若只有 1 頁：直接 convert_pdf_to_images(pdf_path="...", pages="1") 轉換
   - 若有多頁：詢問用戶「這份 PDF 共 X 頁，要轉換哪幾頁？」
2. 用戶回覆要轉換的範圍後，根據回覆設定 pages 參數
3. 轉換完成後，對每張圖片呼叫 prepare_file_message 發送
4. 若用戶明確說「轉成圖片」或「全部」，可直接轉換不用詢問
5. NAS 上的 PDF 轉換：先用 search_nas_files 找到 PDF，再轉換