⚙️ 安裝設定指南

系統需求

• Docker 和 Docker Compose
• 至少 2GB RAM
• 5GB 硬碟空間

安裝步驟

1. 下載專案

   git clone <repository-url>
   cd excellent-blog

2. 設定環境變數

   編輯 .env 檔案，設定資料庫密碼和 API 金鑰

3. 啟動服務

   docker-compose up -d

4. 訪問系統
   • 前台：http://localhost:8480
   • 後台：http://localhost:8480/admin
   • PhpMyAdmin：http://localhost:8481

預設帳號

👤 管理後台使用指南

登入系統

1. 前往 /admin 路徑
2. 輸入管理員帳號密碼
3. 成功登入後進入儀表板

儀表板功能

• 統計資訊 - 文章數量、分類數量、瀏覽數等
• 最新文章 - 顯示最近發布的文章
• 快速操作 - 新增文章、AI 寫作、管理分類等
• 系統資訊 - 版本、語言、AI 狀態等

權限管理

• Admin - 完整系統權限
• Editor - 文章編輯權限
• Viewer - 唯讀權限

📝 文章管理指南

新增文章

1. 點擊「新增文章」按鈕
2. 填寫文章標題與內容
3. 選擇文章類型（內部/外部）
4. 設定分類與標籤
5. 編輯 SEO 資訊
6. 發布或儲存為草稿

文章類型

• 內部文章 - 供內部同仁閱讀的知識分享文章
• 外部文章 - 面向大眾的行銷推廣文章

文章狀態

• 草稿 - 尚未發布的文章
• 已發布 - 公開可見的文章
• 排程 - 預定時間發布的文章

SEO 最佳化

• 設定適當的 Meta Title 和 Description
• 使用相關的關鍵字和標籤
• 上傳吸引人的特色圖片
• 撰寫引人入勝的摘要

🤖 AI 功能使用指南

AI 文章生成

1. 進入「AI 寫作」頁面
2. 輸入文章主題或提示
3. 選擇文章類型（內部/外部）
4. 選擇目標語言
5. 點擊「生成文章」
6. AI 將自動生成完整文章內容

AI 功能特色

• 智能內容生成 - 根據提示自動寫作
• 多語言支援 - 支援多種語言的文章生成
• SEO 優化 - 自動生成 Meta 資訊
• 內容摘要 - 自動產生文章摘要

提示詞技巧

• 提供清晰明確的主題
• 指定目標受眾
• 說明文章目的和風格
• 包含關鍵字要求

💬 聊天功能使用指南

聊天助手功能

• 即時問答 - 回答關於系統使用的問題
• 內容建議 - 提供文章寫作建議
• 技術支援 - 協助解決技術問題
• 功能說明 - 解釋系統功能與操作

使用方法

1. 點擊右下角的聊天圖示
2. 輸入您的問題或需求
3. AI 助手將即時回應
4. 可進行多輪對話交流

聊天技巧

• 用清楚的語言描述問題
• 提供具體的情境資訊
• 可以要求步驟化的指導
• 善用追問來獲得詳細資訊

🌐 多語系功能指南

支援語言

• 🇹🇼 繁體中文（Traditional Chinese）
• 🇨🇳 簡體中文（Simplified Chinese）
• 🇺🇸 英文（English）
• 🇯🇵 日文（Japanese）
• 🇻🇳 越南文（Vietnamese）
• 🇲🇾 馬來文（Malay）

語言切換

1. 在頁面上方找到語言選擇器
2. 點擊選擇目標語言
3. 系統會自動切換介面語言
4. 語言設定會被記憶在會話中

文章翻譯

• 每篇文章可以有多語言版本
• 支援手動翻譯和 AI 翻譯
• 保持原文結構和格式
• SEO 資訊也可分語言設定

🔌 API 文件

認證

API 使用 Session 認證，需要先登入管理後台。

文章 API

聊天 API

AI API