UGOMK 操作手冊
第 04 章 / 共 8 章

文章管理

「文章管理」是您官網的部落格 CMS，支援 Markdown 編輯、分類、標籤、排程發布、AI 內容輔助。

進入路徑：網站經營 → 文章管理，或直接造訪 /dashboard/site/articles。

方案限制：文章管理是內容版（$3000/月）專屬功能。基礎 / 品牌版客戶看不到此 sidebar 入口。

列表畫面

頂部 PageHeader 右側有三個按鈕：

Toolbar 提供：

  • 搜尋框（搜尋標題或摘要，支援中文輸入法 IME 防呆）
  • 狀態篩選：全部 / 草稿 / 已發布 / 排程中
  • 分類篩選
  • 標籤篩選

表格欄位：標題（含封面縮圖）/ 分類 / 狀態 / 發布日 / 瀏覽量。

動作按鈕（每列）

按鈕用途
編輯進編輯器
預覽已發布才顯示，開新分頁看實際呈現
複製完整複製文章，slug 加後綴
發布草稿 → 已發布（已發布的不顯示）
刪除永久刪除（無回收桶）

URL 參數

從 sidebar 點「排程文章」捷徑會帶 ?status=scheduled，列表自動 filter 顯示排程文章。

文章編輯器

點「+ 新文章」或現有列進編輯器，主要欄位：

欄位用途
標題文章 H1 + < title >
SlugURL 後綴（自動產生但可改）
封面圖列表縮圖 + OG image
分類單選
標籤多選
摘要 (excerpt)列表顯示用，留空自動取內文前 N 字
內文 (content_md)Markdown 編輯器，支援 Live Preview
Meta Title< title > 覆寫（留空用 title）
Meta Description< meta description >
狀態草稿 / 已發布 / 排程
排程時間狀態 = scheduled 時必填

排程發布

選「排程中」+ 設定未來時間 → 系統 cron 每 5 分鐘檢查一次，到時間自動翻 published 並寫 sitemap。

排程文章對外仍是 404（未發布），admin 可預覽。

排程時間是必填、而且必須是未來 —— 沒填時間或填了過去的時間，儲存會直接被擋下來 （顯示「scheduled_at 必填 / 必須為未來時間」）。這道檢查是刻意的：cron 找的是 「排程時間已經到了」的文章，一篇沒有時間的排程文章對它而言永遠不成立， 畫面上卻會顯示「排程中」—— 那會變成一篇看起來排好了、但永遠不會發的文章。

已經在排程中的文章，之後只是改標題 / 內文而沒動時間，不會被這道檢查擋。

按「發布」把排程文章直接發出去時，原本的排程時間會一併清掉 （不會留下一個已經過去的排程時間讓狀態顯示自相矛盾）。

AI 內容輔助

編輯器內 4 個按鈕串接 Google Gemini 2.5 Flash AI（過去版本用 Claude Haiku，2026-06-26 切換至 Gemini Free tier 降低成本）：

按鈕位置功能
Meta Title / Description 欄位旁從內文自動產生 SEO meta
封面圖上傳後自動產生 alt 文字（圖片 vision 描述）
「AI 草稿」按鈕從主題 + 關鍵字產生完整文章草稿
選中文字後改寫 / 潤稿

使用限制

  • 每租戶 10 次 / 分鐘
  • 每租戶 100 次 / 天
  • 超過限制顯示「429 Too Many Requests」+ 倒數計時

用量追蹤

按「AI 草稿」按鈕 modal 內可以看到本月已用次數（同步顯示 token / 估算成本給管理員了解）。

若顯示「尚未啟用 AI 內容輔助」：表示系統 GEMINI_API_KEY 未設定，請聯繫客服啟用。

分類 (categories)

進入路徑：文章管理右上「分類」按鈕，或 /dashboard/site/articles/categories。

CRUD 操作：

  • 新增：name + slug + description（選填）+ sort_order
  • 內聯編輯：點任一列直接編輯
  • 刪除：該分類下若有文章，會擋下並提示先把文章改到別的分類

每個分類顯示 article_count（含草稿、已發布）。

標籤 (tags)

進入路徑：文章管理右上「標籤」按鈕，或 /dashboard/site/articles/tags。

比分類更輕量：只有 name + slug + article_count（無 description、無 parent、無 sort）。

主要用途：給文章打多個關鍵字 tag，方便讀者順著 tag 找相關文章。

SEO 對外結構

每篇已發布文章對外有完整 SEO 結構：

  • <title> / <meta description> / <meta og:*>
  • Article 結構化資料（schema.org JSON-LD）：作者 / 發布日 / 修改日 / 分類 / 主圖
  • 自動加入 sitemap.xml
  • 自動加入 RSS feed（/feed.xml）

公開瀏覽 URL

對外網址結構：

內容路徑
文章首頁（list）https://{host}/articles
文章詳情https://{host}/articles/{slug}
分類頁https://{host}/categories/{cat-slug}
標籤頁https://{host}/tags/{tag-slug}
RSS feedhttps://{host}/feed.xml

{host} 是您的自訂域或預設子網域。

常見問題

Q1　Markdown 我不會寫怎辦？

編輯器右側即時預覽，左側打字。基本語法 5 分鐘上手：

  • # 標題 / ## 副標題
  • **粗體** / *斜體*
  • [連結](https://example.com)
  • ![圖片](url) 或上方工具列「插入圖」按鈕
  • - 條列 或 1. 編號

不會的部分可用 AI 草稿先生再修。

Q2　文章可以加影片嗎？

可以。Markdown 直接貼 YouTube / Vimeo URL 自動嵌入，或用工具列「插入嵌入」按鈕貼 iframe code。

Q3　刪掉的文章救得回來嗎？

不行（無回收桶）。刪除前請先「複製」備份，或改狀態為「草稿」隱藏即可（不必真的刪）。

Q4　預覽顯示 404 是為什麼？

「預覽」按鈕只有已發布的文章才能用（用對外網址直接打）。草稿要在編輯器內看 Live Preview，或先發布到一個未公開的 slug 後再改。

Q5　Gemini AI 寫的內容 SEO 會被 Google 降權嗎？

Google 政策是「以使用者為導向、有價值」內容不論作者是 AI 或人類都 OK。建議用 AI 草稿後人工潤稿（加自己觀點 / 案例 / 數據），不要原封不動發布。

Q6　我可以暫停整個部落格不對外嗎？

可以批次把所有文章改回「草稿」（暫無批次按鈕，需逐筆改）。或聯繫客服把 site_status 改為 warned 暫時下架。

內容版 SEO 建議節奏

1. 每月 4 篇文章（每週一篇）— 持續產出讓 Google 認知此站活躍 2. 每篇 1500-2500 字 — 短文 SEO 競爭力弱 3. 每篇 1-2 張圖 — 配 alt 文字（AI 自動生 OK） 4. 內部連結 — 文章內提到別篇時加 [文章 A](/articles/article-a) 連結 5. 發文後到 GSC 手動「申請編入索引」加速收錄

備註

若遇本說明未涵蓋的問題，請透過後台右下角 LINE 客服 @ugomk 聯繫真人專員協助處理。