Documentation

complete_guide

🚀 Excellent Blog 系統概述

Excellent Blog 是一個結合 AI、自動化與跨平台推廣的現代化部落格系統。

AI 驅動

自動生成文章、智能聊天助手、內容優化

國際化

6 種語言支援、國際平台自動發布

主要功能

  • 內部與外部部落格 - 支援內部知識分享與外部行銷推廣
  • AI 自動寫作 - 使用 GPT API 自動生成文章內容
  • 多語系支援 - 支援繁中、簡中、英文、日文、越南文、馬來文
  • 即時聊天 - 前台後台都有 AI 聊天助手
  • 自動爬蟲 - 定時抓取相關文章並發布
  • 國際平台推送 - 自動推送到歐美及東南亞平台

技術架構

後端
PHP 8.2 + Apache

資料庫
MySQL 8.0

部署
Docker Compose

⚙️ 安裝設定指南

系統需求:Docker、Docker Compose、2GB RAM、5GB 硬碟空間

快速安裝

安裝指令
cd /root/docker/blog
./start.sh

訪問地址

服務 地址 說明
前台 http://192.168.168.241:8480 部落格主頁
後台 http://192.168.168.241:8480/admin 管理面板
PhpMyAdmin http://192.168.168.241:8481 資料庫管理
預設帳號:
使用者名稱:jeff
密碼:ulik9910

👤 管理後台使用指南

登入系統

  1. 前往管理員登入頁面
  2. 輸入帳號 jeff 和密碼 ulik9910
  3. 成功登入後進入儀表板

主要功能

儀表板

統計資訊、最新文章、快速操作、系統狀態

文章管理

新增、編輯、刪除文章,管理分類和標籤

AI 寫作

使用 AI 自動生成文章內容

系統設定

爬蟲設定、外部平台、語言設定

📝 文章管理指南

文章類型說明

內部文章

供內部同仁閱讀的知識分享文章,包含策略、流程、內部資訊等

外部文章

面向大眾的行銷推廣文章,注重 SEO 和品牌推廣

發布流程

1. 建立文章

點擊「新增文章」,填寫標題和內容

2. 設定屬性

選擇文章類型、分類、標籤

3. SEO 優化

設定 Meta 標題、描述、關鍵字

4. 發布文章

選擇立即發布或設定排程

🤖 AI 功能使用指南

提示:越具體的提示詞,AI 生成的內容品質越好

AI 文章生成步驟

1
選擇設定
選擇文章類型、語言、長度
2
輸入提示
描述文章主題和要求
3
生成發布
AI 生成後編輯並發布

提示詞範例

寫一篇關於「Docker 容器化部署的最佳實踐」的技術文章,目標讀者是有基礎的開發者,文章需要包含實際範例和常見問題解決方案。

寫一篇關於「AI 如何改變企業營運效率」的行銷文章,目標讀者是中小企業老闆,重點強調 AI 帶來的商業價值和投資回報。

💬 聊天功能使用指南

AI 聊天助手功能

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

聊天助手位於每個頁面的右下角,點擊聊天圖示即可開始對話。

聊天

🌐 多語系功能指南

支援語言

🇹🇼

繁體中文
Traditional Chinese

🇨🇳

簡體中文
Simplified Chinese

🇺🇸

English
英文

🇯🇵

日本語
Japanese

🇻🇳

Tiếng Việt
Vietnamese

🇲🇾

Bahasa Melayu
Malay

語言切換方法

  1. 在頁面導航欄找到語言選擇器
  2. 點擊下拉選單選擇目標語言
  3. 系統會自動切換介面語言
  4. 語言設定會保存在會話中

🔌 API 文件

認證說明:API 使用 Session 認證,需要先登入管理後台

文章 API

方法 端點 說明 需要認證
GET /api/articles 取得文章列表
POST /api/articles 新增文章

AI API

方法 端點 說明 需要認證
POST /api/ai-generate AI 生成文章

聊天 API

方法 端點 說明 需要認證
POST /api/chat 發送聊天訊息
GET /api/chat 取得聊天記錄

🔧 故障排除

常見問題

可能原因:

  • Docker 容器未啟動
  • 端口被佔用
  • 防火牆阻擋

解決方法:

docker-compose ps
docker-compose up -d
docker-compose logs

解決步驟:

  1. 重啟資料庫容器:docker-compose restart db
  2. 檢查資料庫日誌:docker-compose logs db
  3. 等待資料庫完全啟動(約 30 秒)

檢查項目:

  • 確認 .env 檔案中的 GPT_API_KEY 已設定
  • 檢查 API 配額和計費狀態
  • 確認網路連接正常
  • 查看錯誤日誌:docker-compose logs web

解決方法:

chmod 755 src/assets/uploads
chown -R www-data:www-data src/assets/uploads

聯絡支援

如果問題仍未解決,您可以:

  • 使用頁面右下角的 AI 聊天助手
  • 查看 Docker 容器日誌:docker-compose logs
  • 重新啟動整個系統:./start.sh
Chat
chat_welcome