EpoCanvas 創作者自述與建站說明:在秩序中生長,把寫作當作軟體工程

shijianus 關於 EpoCanvas 的創作者自述:建站初衷、極客介面哲學、Astro + SSR 架構取捨,以及為何將個人寫作當成一項長期維護的軟體工程。

版本v1.0.0发表于10/28/26更新于10/28/26

EpoCanvas 創作者自述與建站說明

ABOUT-001 創作者自述 長期維護承諾

本文件由專案作者 shijianus 撰寫,闡述 EpoCanvas 獨立博客的建站初衷、工程哲學、架構演進歷程與長期維護準則。它不是一份隨手寫就的介紹,而是一份公開的創作合約與系統宣言。

[!IMPORTANT] 「把研究、開發和生活折疊成可讀的記錄。」 這裡既是作者的工作台與實踐檔案,也是一套以「軟體工程標準」持續打磨的開放系統。我們不依賴演算法的投餵,只專注於在高資訊密度中建立長久的閱讀秩序。


1. 序言:為什麼在 2026 年依然堅持寫獨立博客?

在演算法推薦、短影音與封閉社群平台徹底主導資訊流動的今天,搭建並維護一個獨立的個人博客,常被視為一種「過時」或「低效」的極客執念。

然而,現實卻反覆印證著另一種危機:

  1. 數據所有權的剝離:你的文章、筆記與思考被封裝在不同商業公司的封閉花園中,隨時面臨演算法降權、內容被刪除或帳號停用的風險;
  2. 閱讀深度的消解:為了迎合推薦系統的點擊率,資訊被切割成零碎的情緒碎片,缺乏上下文、缺乏版本修訂歷史,更缺乏體系化的推演;
  3. 介面表達的同質化:所有創作者都在使用相同的幾套模板與版式,作者個人的審美品味、技術判斷與工程執念被無情抹平。

EpoCanvas(以及 shijianus.us)正是在這樣的背景下誕生的。

我需要一個屬於自己的數位花園(Digital Garden):它擁有獨立的域名、自主掌控的原始碼、乾淨開放的資料格式(Markdown / MDX),以及由自己一磚一瓦搭建的介面與交互系統。在這裡,寫作不是一次性的情緒宣洩,而是知識與程式碼的持續重構。


2. 核心哲學:把博客當成長期維護的軟體工程

很多博客系統在建站完成的瞬間,就迎來了它生命周期的巔峰——隨後便陷入漫長的年久失修。而在 EpoCanvas 的設計哲學中:

博客不是一份靜態的 HTML 網頁,而是一套具備完整生命週期、持續演進的「軟體系統」。

┌─────────────────────────────────────────────────────────────┐
│                   EpoCanvas 核心設計哲學                    │
├──────────────────────────────┬──────────────────────────────┤
│      1. 拒絕視覺噪聲         │      2. 堅持真實鏈路         │
│   技術感不等於滿屏霓虹光暈   │   全站指標真實掃描,零 Mock  │
│   在高資訊密度中保留閱讀秩序 │   每一篇字數與天數均有據可查 │
├──────────────────────────────┼──────────────────────────────┤
│      3. 規格化工程治理       │      4. 本地優先與邊緣計算   │
│   SemVer 版本、Git 追溯與 CI │   SSG 極速首屏 + 邊緣按需水合│
│   嚴格的單步 Commit 與 E2E   │   延遲壓制在 50ms 內的邊緣   │
└──────────────────────────────┴──────────────────────────────┘

2.1 技術感不等於噪聲:在高資訊密度中保留閱讀秩序

很多所謂的「極客風」主題,往往陷入炫技的誤區:到處是發光的賽博朋克邊框、粗糙的玻璃擬態、眼花繚亂的打字機動效。結果就是:標題像按鈕、按鈕像裝飾、裝飾比正文內容更搶眼。

我選擇了克制。我們保留了明確的網格、精準的狀態標籤與清晰的模塊邊界,但在排版上嚴格依循現代字體排印規範(Typography & Visual Hierarchy):

  • 主導航與水平展開子菜單:向頂級博客體驗看齊,采用規整方圓角與居中吸附,杜絕跳躍與抖動;
  • 文章閱讀節奏:寬度舒適的文字閱讀欄、清晰的段落邊界、精細調校的程式碼高亮(Shiki)、平滑聚焦的粘性目錄(TOC);
  • 微交互反饋:每一次按鈕懸浮、模態框呼出、暗色模式切換,均有細膩但絕不拖泥帶水的物理過渡。

2.2 堅持真實鏈路,杜絕任何虛假 Mock 數據

在 EpoCanvas 中,有一條寫入代碼守則的鋼鐵紅線:嚴禁虛假數據。

  • 站點頂部的「全站字數」、「文章篇數」、「建站天數」,均由建置腳本實時遍歷全量 Markdown 檔案計算生成,並同步至生產節點;
  • 評論系統完全基於 Cloudflare D1 雲原生數據庫,杜絕預先填寫的 Demo 虛擬發言;
  • 贊賞記錄、支付狀態與 Telegram 機器人通知,均運行在端到端真實鏈路之上。

3. 架構演進:從 Hexo 到 Astro + Cloudflare 邊緣矩陣

EpoCanvas 的前身經歷了多次重構。每一次技術選型的遷移,都伴隨著對效能與開發體驗的深刻反思:

3.1 早期溯源:對 Hexo 與 Anzhiyu(安知鱼)經典設計的致敬

在專案初期,我們深度研究了 Hexo 生態中優秀的設計語言(特別是 Hexo-Theme-Anzhiyu 安知鱼主題)。其標誌性的頂部 Parallax 視差動態水波紋、水平排布的二級導航框、毛玻璃卡片以及充滿活力的作者卡片,給予了我豐富的介面美學靈感。

但隨著博客內容與交互複雜度的增長,傳統 Hexo 架構在現代前端工程面前暴露了局限:全量 JS 打包體積膨脹、缺乏元件化狀態管理、SSR/邊緣端擴展能力不足。

3.2 現代化重構:Astro 6 + React 19 + Tailwind 4 獨立島體系

為了兼顧「靜態內容的極致秒開」與「複雜應用的靈動交互」,我們在當前版本完成了全量重構:

  1. Astro Islands(獨立島架構):
    • 文章頁面、官方文件與歸檔總覽採用 100% 零 JS 的純靜態 HTML 直出(SSG),首次加載零腳本負擔,Lighthouse 性能表現逼近滿分;
    • 僅在需要動態狀態的模塊(如 Stripe 國際收銀台、Telegram 翻轉卡片、中控台通知面板、動態星軌天文模擬引擎)中引入 React 19 進行按需注水(Partial Hydration);
  2. 現代化工程基礎設施:
    • 採用 Tailwind CSS 4 進行底層設計 Token 約束,全域嚴格統一圓角(8px / 6px 方圓角)與主題色(#425aef 主題藍);
    • 引入 TypeScript 實現端到端型別安全,所有導航、文章元數據與多語言配置均有強型別約束;
    • 內建 Playwright / Puppeteer 現代自動化測試矩陣,每次改動必須經受無頭瀏覽器的實機像素級與交互級驗收。

3.3 全球邊緣矩陣:Cloudflare Pages + Workers + D1

全站編譯產物直接託管於 Cloudflare 全球 Anycast 邊緣節點:

  • 靜態資產全球 CDN 秒級命中,首字節時間(TTFB)普遍壓制在 50ms 以內;
  • 動態 API(評論、按讚、支付會話、Telegram 廣播)運行在邊緣 Workers 執行時,與 Cloudflare D1 分散式資料庫無縫聯動。

4. 創作者畫像:我是誰,與我的工作台

shijianus

工程師 / 架構實踐者 / 介面設計愛好者

主要關注現代 Web 前端架構、邊緣運算、TypeScript 系統設計、UI/UX 微交互工程與工程交付規範。深信軟體開發的核心在於「降低系統的認知負擔」,寫作亦然。

4.1 軟體與工具鏈

  • 編輯器與終端:VS Code(自訂極簡 Dark 語法主題)、Kitty / Warp、Zsh;
  • 核心技術棧:Astro、TypeScript、React、Tailwind CSS、Node.js、Cloudflare 雲原生工具鏈;
  • 專案管理:Git(嚴格 Conventional Commits 規範)、Wrangler、Puppeteer E2E 驗證腳本。

4.2 硬體與桌面生態

如果你對我的實體工作台感興趣,可以前往 「關於作者」頁面中的我的裝備面板,那裡詳細記錄了我日常用於生產力與開發的各類硬體好物(從顯示器、客製化機械鍵盤、人體工學椅到隨身音訊設備)。


5. 版權規範、社群交流與贊助機制

5.1 知識共享許可協議(CC BY-NC-SA 4.0)

除特別聲明外,本博客的所有原創文章、技術架構筆記與專題內容,均默認採用 創用 CC 姓名標示-非商業性-相同方式分享 4.0 國際版 (CC BY-NC-SA 4.0) 許可協議。

  • 你可以:自由分享、摘錄或演繹本站內容;
  • 限制條件:必須明確標註作者(shijianus)及原文出處鏈接,不得用於商業目的,且衍生作品必須採用相同的協議發布;
  • 詳情請參閱頁腳的 《社群內容許可與版權規範》。

5.2 交流反饋與真實留言板

本站設有自建的評論互動系統:

  • 每一篇文章底部均有原生開放的評論區,支持 Markdown 輕量排版、代碼高亮與層級嵌套回覆;
  • 所有留言均會第一時間通過專屬 Telegram 機器人推送到我的隨身設備,我會認真閱讀每一條真誠的交流並及時回覆。

5.3 請作者喝杯咖啡 ☕️

如果你覺得本站的文章、開源主題或架構實踐對你的工作有所啟發或幫助,歡迎前往 「請喝咖啡」贊賞頁面:

  • 我們支持 Stripe Elements 國際信用卡、Apple Pay、Google Pay 等全球主流快捷結賬通道,同時亦提供地區性的贊賞渠道;
  • 所有支持者的名錄均會經過加密與格式化後,永久收錄於公開的致謝牆中,感謝你賦予我持續打磨系統的動力。

6. 結語:保持生長,持續構建

「在不確定性的浪潮中,寫下確定性的邏輯。」

軟體會過期,框架會更迭,但經過深思熟慮的技術標準、優雅清晰的介面秩序,以及字裡行間對創作的真誠,能夠抵禦時間的沖刷。

EpoCanvas 將始終保持開放與生長。歡迎你在這裡漫步,也期待在程式碼與文字的交匯處,與你產生思想的共鳴。


相關站內索引