---
name: ai-assistant
description: AI 圖片生成、文件/簡報生成
allowed-tools: mcp__nanobanana__generate_image mcp__nanobanana__edit_image mcp__nanobanana__restore_image
  generate_md2ppt generate_md2doc download_web_image
metadata:
  ctos:
    requires_app: ai-assistant
    mcp_servers: nanobanana ching-tech-os
---

【AI 圖片生成】
- mcp__nanobanana__generate_image: 根據文字描述生成圖片
  · prompt: 圖片描述（必填，使用英文描述效果較好）
    - 圖片風格、內容描述用英文
    - 圖片中若有文字，指定 "text in Traditional Chinese (zh-TW)" 並附上中文內容
    - 範例：「A beautiful sunrise with lotus flowers, with text in Traditional Chinese (zh-TW) saying '早安，祝你順利'」
  · files: 參考圖片路徑陣列（可選，用於以圖生圖）
  · resolution: 固定使用 "1K"
  · 生成後回傳 generatedFiles 陣列
  · ⚠️ 路徑轉換：回傳的 /tmp/.../nanobanana-output/xxx.jpg 要轉成 ai-images/xxx.jpg
  · ⚠️ 禁止自己寫 [FILE_MESSAGE:...] 標記！必須呼叫 prepare_file_message 工具
- mcp__nanobanana__edit_image: 編輯/修改現有圖片
  · file: 要編輯的圖片路徑（必填）
  · prompt: 編輯指示（英文描述）
  · resolution: 固定使用 "1K"

【圖片生成使用情境】
1. 純文字生圖：用戶說「畫一隻貓」
   → generate_image(prompt="a cute cat", resolution="1K")
2. 以圖生圖（用戶上傳的圖）：用戶回覆一張圖說「畫類似風格的狗」
   → 從 [回覆圖片: /tmp/...] 取得路徑
   → generate_image(prompt="a dog in similar style", files=["/tmp/..."], resolution="1K")
3. 編輯用戶上傳的圖：用戶回覆一張圖說「把背景改成藍色」
   → 從 [回覆圖片: /tmp/...] 取得路徑
   → edit_image(file="/tmp/...", prompt="change background to blue", resolution="1K")
4. 編輯剛才生成的圖：用戶說「把剛才那張圖的字改掉」
   → 用 get_message_attachments(days=1, file_type="image") 查找最近的圖片
   → 從結果中找到 ai-images/ 開頭的 NAS 路徑
   → edit_image(file="ai-images/xxx.jpg", prompt="...", resolution="1K")
   → ⚠️ 注意：edit_image 可能會大幅改變圖片，不只是改文字

【圖片發送流程】
1. 生成/編輯完成後，從 generatedFiles 取得路徑
2. 路徑轉換：/tmp/.../nanobanana-output/xxx.jpg → ai-images/xxx.jpg
3. 呼叫 prepare_file_message("ai-images/xxx.jpg")
4. 將回傳內容原封不動包含在回覆中
· ❌ 錯誤：自己寫 [FILE_MESSAGE:/tmp/...] ← 格式錯誤！
· ❌ 錯誤：用 Read 看圖後回覆「已完成」← 用戶看不到圖！

【AI 文件/簡報生成】
- generate_md2ppt: 產生專業簡報（MD2PPT 格式，可線上編輯並匯出 PPTX）
  · content: 簡報主題或內容說明（必填，盡量詳細描述）
  · style: 風格需求（可選，如：科技藍、溫暖橙、清新綠、極簡灰、電競紫）
  · 回傳：分享連結 url 和 4 位數密碼 password
- generate_md2doc: 產生專業文件（MD2DOC 格式，可線上編輯並匯出 Word）
  · content: 文件內容說明或大綱（必填）
  · 回傳：分享連結 url 和 4 位數密碼 password

【文件/簡報使用情境】
1. 用戶說「幫我做一份簡報介紹公司產品」
   → generate_md2ppt(content="公司產品介紹簡報，需要包含產品特色、優勢、應用案例")
2. 用戶說「做一份科技風的 AI 應用簡報」
   → generate_md2ppt(content="AI 應用介紹", style="科技藍")
3. 用戶說「幫我寫一份設備操作 SOP」
   → generate_md2doc(content="設備操作 SOP，包含開機、操作流程、關機步驟、注意事項")
4. 用戶說「做一份教學文件說明如何使用系統」
   → generate_md2doc(content="系統使用教學文件")

【回覆格式】
生成完成後，回覆用戶：
「已為您生成簡報/文件 👇
🔗 連結：{url}
🔑 密碼：{password}

連結有效期限 24 小時，開啟後可直接編輯並匯出。」

【意圖判斷】
- 「做簡報」「投影片」「PPT」「presentation」→ generate_md2ppt
- 「寫文件」「做報告」「說明書」「教學」「SOP」「document」→ generate_md2doc
- 如果不確定，詢問用戶是需要「簡報（投影片）」還是「文件（Word）」