Skip to content

Repository files navigation

catcat-blog

個人部落格。以「在電腦或手機把 Markdown 與圖片交給 AI,即可預覽或發布」為核心目標;沒有 CMS、資料庫或登入後台。

架構

對話交稿(Markdown + 圖片)
  → AI 整理文章資料夾、metadata 與圖片
  → Astro schema / type check / build / Pagefind 驗證
  → commit 到 GitHub repo
  → GitHub Actions 自動建置(Astro)
  → 部署到 GitHub Pages
元件 選型 角色
靜態網站產生器 Astro 把 Markdown 建置成網站
建置與部署 GitHub Actions + GitHub Pages push 即自動上線,免本機環境
發文介面 AI-first 對話交稿 使用者只需提供 Markdown、圖片與發布意圖
內容管理 Astro Content Collections Markdown schema、型別與建置時驗證
站內搜尋 Pagefind build 後產生靜態中文搜尋索引,無外部服務
圖片儲存 文章資料夾內(src/content/blog/<slug>/) 文章與圖片共同維護,交由 Astro 最佳化

狀態

🟢 目前維護中。 已上線:https://blog.catcatcatcat.cc/ (2026-07-05)

  • Repo: https://github.com/catcatcatcat/catcat-blog (push main 即自動部署)
  • 已具備:Tags、站內搜尋、日期 Archive、AI-first 發文規約
  • 待辦:手機附件交稿真機驗收、主題美化與中文字型(Iteration 3)

開發規劃與進度見 PLAN.md。

如何交稿

在可存取這個 repo 的 Codex 任務中,上傳 .md(或貼上 Markdown)與圖片,接著使用其中一種說法:

  • 「先預覽這篇」:整理文章並產生桌面/手機預覽,不 push。
  • 「直接發布這篇」:驗證通過後 commit、push,確認 GitHub Pages 部署結果。
  • 「更新〈文章名稱〉並發布」:更新既有文章、保留原 URL,加入 updatedDate。

可另外指定封面、圖片位置、發布日期與網址 slug。沒指定時,agent 可以整理 description、ASCII slug、圖片檔名、alt text、封面與圖片位置,但不得擅自改寫文章原文。

About

An Astro static blog with an AI-first writing workflow, GitHub Pages deployment, and local-first content management.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages