Skip to content

GEMINI.md

Latest commit

 

History

History
95 lines (72 loc) · 5.71 KB

GEMINI.md

File metadata and controls

95 lines (72 loc) · 5.71 KB
Raw

專案：AI 驅動的內容引擎 (AI-Driven Content Engine)

1. 核心理念

本專案旨在打造一個以 Hugo 為核心、高度自動化、SEO 友善且具備使用者互動功能的豪華部落格。它不僅是一個內容發布平台，更是一個能透過 AI 輔助與自動化流程，持續擴展內容、提升網站權重與流量的「內容引擎」。

指導原則：

  • 簡潔至上： 選擇最直接、最穩健的技術方案，避免不必要的複雜性。
  • 自動化優先： 將所有重複性工作（分類、部署、更新）交給自動化流程，讓創作者專注於內容本身。
  • 使用者為本： 提供優質的閱讀體驗與輕量級的互動功能，並確保網站效能卓越。
  • 品質重於數量： 在規劃 AI 自動生成內容時，首重內容的品質、結構與獨特性，而非僅追求數量。

2. 技術選型 (Technology Stack)

類別 技術 理由
靜態網站生成器 Hugo 極致的速度、強大的內容管理功能 (分類、標籤)、活躍的社群與豐富的主題。
前端主題 [待定] 一個現代、簡潔且 SEO 友善的 Hugo 主題 這是專案成功的關鍵之一。我們需要一個在行動裝置上表現良好、讀取速度快、並已內建結構化資料 (Schema) 的主題。
CI/CD 自動化 GitHub Actions 與我們的程式碼倉庫無縫整合，是實現 push-to-deploy 自動化流程的最佳選擇。
使用者互動 第三方服務 (e.g., LikeBtn, Cusdis) 為了維持靜態網站的輕量與安全，我們不自建後端，而是嵌入成熟的第三方服務來處理點讚、評論等互動功能。
AI 內容輔助 Gemini API (或其他 LLM) 在未來階段，用於輔助生成結構化、高品質的 MD 檔案草稿，加速內容創作。

3. 功能規格 (Functional Specifications)

3.1. 內容管理

  • 自動分類與標籤： 利用 Hugo 的原生 Front Matter 功能。創作者只需在每個 MD 檔案的開頭填寫 categories 和 tags 欄位，Hugo 將自動生成對應的分類頁面與標籤頁面。 
    ---
title: "我的第一篇文章"
date: 2025-10-07T10:00:00+08:00
draft: false
categories: ["技術分享"]
tags: ["Hugo", "自動化", "AI"]
---
  • 優化搜尋： 選擇一個內建或可輕鬆整合 Lunr.js 或 Algolia 的 Hugo 主題，以實現快速的站內搜尋。

3.2. SEO 優化

  • 自動生成 SEO 標籤： Hugo 會根據 Front Matter 自動產生 <title>, <meta description> 等標籤。我們選擇的主題需要支援 Open Graph 和 Twitter Cards 標籤，以優化社群分享效果。
  • Sitemap.xml： Hugo 會自動產生並更新 sitemap.xml，幫助搜尋引擎索引網站內容。
  • 語義化 URL： 設定 Hugo 產生清晰、對 SEO 友善的 URL 結構 (e.g., /:section/:title/)。

3.3. 使用者互動

  • 拍手/按讚： 嵌入一個如 LikeBtn.com 的第三方服務。它提供簡單的 JS 代碼片段，可以輕鬆加入到文章模板中。
  • 分享/複製連結： 使用簡單的 JavaScript 實現。提供一個按鈕，點擊後會將當前頁面的 URL 複製到使用者剪貼簿，並顯示提示訊息。

3.4. 自動化部署

  • 工作流程： 本地修改 MD -> git commit -> git push origin main。
  • GitHub Actions 觸發： 一個 .github/workflows/deploy.yml 檔案將會被設定。
  • 執行步驟：
    1. 當 main 分支有新的 push 時觸發。
    2. 設定 Hugo 環境。
    3. 使用 Hugo build 指令將 MD 檔案編譯成 public 目錄下的靜態 HTML 檔案。
    4. 將 public 目錄的內容自動部署到 gh-pages 分支或指定的靜態網站託管服務 (如 Netlify, Vercel, Cloudflare Pages)。

4. 專案任務清單 (To-Do List)

這份清單將由我 (Gemini) 在我們每次完成任務提交 commit 後進行更新。

階段一：基礎建設 (Foundation)

  • 任務 1.1: 初始化 Hugo 專案。
  • 任務 1.2: 初始化 Git 倉庫並完成首次提交。
  • 任務 1.3: 研究並選擇一個符合我們需求的 Hugo 主題。
  • 任務 1.4: 安裝並配置所選主題。

階段二：核心功能開發 (Core Features)

  • 任務 2.1: 建立第一篇範例文章，並定義好 categories 和 tags 的使用慣例。
  • 任務 2.2: 配置 Hugo 的 config.toml (或 hugo.yaml)，設定網站標題、語系、URL 結構等。
  • 任務 2.3: 實現「複製連結」的分享功能。
  • 任務 2.4: 整合第三方「按讚」服務。
  • 任務 2.5: UI/UX 優化 (第一階段)，改善字體、顏色與導覽列體驗。

階段三：自動化與部署 (Automation & Deployment)

  • 任務 3.1: 建立 GitHub Actions 的 CI/CD 工作流程 (deploy.yml)。
  • 任務 3.2: 進行第一次自動化部署測試，確保 push 後網站能成功更新。

階段四：內容策略與擴展 (Content Strategy & Scaling)

  • 任務 4.1: 規劃 AI 輔助內容生成的策略與 Prompt 範本。
  • 任務 4.2: 開發「中控處理器」Python 腳本，實現 AI 輔助的自動化標籤管理。

階段五：進度追蹤與維護

  • 任務 5.1: 建立 GEMINI.md 專案規格與任務清單。
  • 任務 5.2: (持續進行) 在每次 commit 後，由 Gemini 更新此份文件。

5. 進度追蹤 (Progress Tracking)

在每次我們完成一個階段性任務並準備 commit 時，我會更新這份文件中的「專案任務清單」，標記已完成的項目，並在 commit 訊息中簡要記錄當前的狀態。這將確保我們的合作過程清晰、透明且有跡可循。