---
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）
  · markdown_content: 已格式化的 MD2PPT markdown（必填，必須以 --- 開頭）
  · ⚠️ 你必須先根據下方格式規範產生完整 markdown，再傳入此工具
  · 回傳：分享連結 url 和 4 位數密碼 password
- generate_md2doc: 儲存 MD2DOC 文件並建立分享連結（可線上編輯並匯出 Word）
  · markdown_content: 已格式化的 MD2DOC markdown（必填，必須以 --- 開頭）
  · ⚠️ 你必須先根據下方格式規範產生完整 markdown，再傳入此工具
  · 回傳：分享連結 url 和 4 位數密碼 password

【MD2PPT 格式規範】
直接產生 Markdown 內容，不要包含 ``` 標記。

格式結構：
1. 全域 Frontmatter（檔案開頭必須有）：
   ---
   title: "簡報標題"
   author: "作者"
   bg: "#FFFFFF"
   transition: fade
   ---
   theme 可選：amber, midnight, academic, material
   transition 可選：slide, fade, zoom, none
2. 分頁：用 === 分隔頁面，前後必須有空行
3. 每頁 Frontmatter（在 === 後，可設定 layout、bg、mesh 等）
4. Layout：default | impact | center | grid | two-column | quote | alert
   · grid 搭配 columns: 2
   · two-column 用 :: right :: 分隔左右欄（前後必須有空行）
5. 圖表（JSON 必須用雙引號，前後必須有空行）：
   ::: chart-bar { "title": "標題", "showValues": true }
   | 類別 | 數值 |
   | :--- | :--- |
   | A | 100 |
   :::
   類型：chart-bar, chart-line, chart-pie, chart-area
6. Mesh 漸層背景：bg: mesh + mesh: { colors: [...], seed: 數字 }
7. 背景圖片：bgImage: "https://..."
8. 備忘錄：<!-- note: 演講者筆記 -->

配色建議：
| 風格 | theme | mesh 配色 | 適用 |
|------|-------|----------|------|
| 科技藍 | midnight | ["#0F172A","#1E40AF","#3B82F6"] | 科技、AI |
| 溫暖橙 | amber | ["#FFF7ED","#FB923C","#EA580C"] | 行銷、活動 |
| 清新綠 | material | ["#ECFDF5","#10B981","#047857"] | 環保、健康 |
| 極簡灰 | academic | ["#F8FAFC","#94A3B8","#475569"] | 學術、報告 |

設計原則：
1. 標題/重點頁（impact/center/quote）→ bg: mesh 或鮮明純色
2. 資訊頁（grid/two-column/default）→ 淺色（#F8FAFC）或深色（#1E293B）
3. 不要每頁都用 mesh，會視覺疲勞
4. 圖表數據要合理，數值要有意義

緊湊範例：
---
title: "產品發表會"
author: "團隊"
bg: "#FFFFFF"
transition: fade
---

# 產品發表會
## 創新解決方案

===

---
layout: impact
bg: mesh
mesh:
  colors: ["#0F172A", "#1E40AF", "#3B82F6"]
---

# 歡迎各位

===

---
layout: grid
columns: 2
bg: "#F8FAFC"
---

# 市場分析

### 現況
- 市場持續成長
- 需求多元化

### 機會
- 數位轉型趨勢
- AI 技術成熟

===

---
layout: center
bg: mesh
mesh:
  colors: ["#0F172A", "#1E40AF", "#3B82F6"]
---

# 感謝聆聽

【MD2DOC 格式規範】
直接產生 Markdown 內容，不要包含 ``` 標記。

格式結構：
1. Frontmatter（必須）：
   ---
   title: "文件標題"
   author: "作者"
   header: true
   footer: true
   ---
2. 標題層級：只用 H1(#)、H2(##)、H3(###)，H4 以下改用 **粗體**
3. 目錄（可選）：[TOC] 後接章節列表
4. 提示區塊（只支援三種）：> [!TIP] / > [!NOTE] / > [!WARNING]
5. 程式碼區塊：標註語言，:no-ln 隱藏行號，:ln 強制顯示
6. 行內樣式：**粗體**、*斜體*、<u>底線</u>、`行內碼`
   UI 按鈕：【確定】、快捷鍵：[Ctrl]+[S]、書名：『書名』
   智慧連結：[文字](URL) 匯出 Word 時自動生成 QR Code
7. 表格：標準 Markdown 表格語法
8. 分隔線：---
9. Mermaid 圖表（可選）：```mermaid ... ```

設計原則：
1. H1 大章節、H2 小節、H3 細項，結構清晰
2. 重要提示用 TIP，補充用 NOTE，警告用 WARNING
3. 程式碼區塊都要標註語言
4. 表格內容簡潔，複雜內容用列表

【文件/簡報使用流程】
1. 用戶要求做簡報/文件時，根據用戶需求和上方格式規範產生完整 markdown 內容
2. 將產生的 markdown 傳入 generate_md2ppt 或 generate_md2doc 的 markdown_content 參數
3. 回覆用戶分享連結和密碼

使用情境：
1. 用戶說「幫我做一份簡報介紹公司產品」
   → 根據 MD2PPT 格式規範產生包含 frontmatter、多頁內容的 markdown
   → generate_md2ppt(markdown_content="---\ntitle: \"公司產品介紹\"\n...")
2. 用戶說「幫我寫一份設備操作 SOP」
   → 根據 MD2DOC 格式規範產生包含 frontmatter、章節結構的 markdown
   → generate_md2doc(markdown_content="---\ntitle: \"設備操作 SOP\"\n...")

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

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

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