v0.2.2

修補版。已經在跑 0.2.x 的話：
A patch release. If you're on 0.2.x:

git pull && docker compose pull && docker compose up -d

修了什麼 / Fixes

• 後台朋友頁的「檢查」按鈕不再顯示成一串錯誤訊息
  The "Check" button on the admin Friends page no longer shows an i18n error instead of its label
• 404 頁的插圖下載中斷時不再每幀丟錯
  The 404 page no longer throws every frame when its illustration fails to download
• iPhone 上按影片的全螢幕改用系統播放器，不再沒反應
  On iPhone, the video fullscreen button now opens the system player instead of doing nothing

量測 / Telemetry

• 換頁轉場的量測多記一格：那一幀是 worker 還是主執行緒畫的
  Page transition metrics now record whether frames were drawn by the worker or the main thread

---

What's Changed

• feat(vitals): TX 細節帶上點是 worker 還是主執行緒畫的 by @Koimsurai in #347
• docs(vitals): TX 細節的格式說明補上誰畫的那一格 by @Koimsurai in #348
• fix(admin): 朋友頁「檢查」按鈕顯示成 i18next 錯誤 by @Koimsurai in #349
• chore: 版本號 0.2.2 by @Koimsurai in #350

Full Changelog: v0.2.1...v0.2.2

v0.2.1

修補版。已經在跑 0.2.0 的話：
A patch release. If you're on 0.2.0:

git pull && docker compose pull && docker compose up -d

修了什麼 / Fixes

• 英文後台與設定精靈的頁名不再重複（「Pages Pages」→「Pages」）
  English admin and setup wizard no longer repeat the page title ("Pages Pages" → "Pages")
• 收藏頁的插圖下載中斷時不再每幀丟錯
  The collection page no longer throws every frame when a cover image fails to download
• 碎念頁彗星左邊那排靠右的文字，每段的行長度對齊
  Right-aligned moments next to the comet now have even line lengths

更順 / Smoother

• 換頁轉場的點與鏡頭移到 worker 和合成器，主執行緒忙的時候比較不會卡
  Page transitions run their particles and camera in a worker and on the compositor, so a busy main thread stutters them less
• 收藏頁的天空背景改用 GPU 畫，天空資料在預載時先建好，換頁不再卡
  The collection sky is drawn on the GPU and built during preload, so switching to it no longer stutters
• 首頁的字卡與標註在支援的瀏覽器直接畫進 3D 畫布
  Home page labels are drawn straight into the 3D canvas where the browser supports it

自架 / Self-hosting

• docker-compose.yml、.env 範本、Caddyfile 與 nginx 範例的註解改成英文
  Comments in docker-compose.yml, the .env templates, the Caddyfile and the nginx example are now in English
• deploy/nginx/ 加上 Traefik 等其他反向代理的接法；英文 README 的架構圖修好了
  deploy/nginx/ now covers Traefik and other reverse proxies; the architecture diagram in the English README renders again

---

What's Changed

• docs: README 改成先講怎麼架，附 nginx 的設定範例 by @Koimsurai in #335
• docs(readme): 首圖換成黑洞，客製化放上四顆天體與標語 by @Koimsurai in #336
• fix(admin): 英文介面的頁名不再重複英文小標 by @Koimsurai in #337
• fix(thinking): 彗星左邊靠右的碎念，每段的行拉成一樣長 by @Koimsurai in #338
• fix(collection): 插圖解碼成功才畫，下載中斷的圖不再每幀丟錯 by @Koimsurai in #339
• perf(collection): 收藏頁天空的背景改用 GPU 畫 by @Koimsurai in #340
• perf(home): 字卡與標註在支援的瀏覽器畫進 3D 那張 canvas by @Koimsurai in #341
• feat(vitals): 換頁的 TX 帶上收、飛、長三段與長幀歸因 by @Koimsurai in #342
• perf(collection): 天空資料與 WebGL 在預載時先建好，換頁不再卡 by @Koimsurai in #343
• docs: 自架設定檔的註解改成英文，中文 README 補 nginx 步驟 by @Koimsurai in #344
• perf(transition): 換頁轉場的點與鏡頭交給 worker 和合成器 by @Koimsurai in #345
• chore: 版本號 0.2.1 by @Koimsurai in #346

Full Changelog: v0.2.0...v0.2.1

v0.2.0

第一個可以拿去架自己站的版本。koimsurai.com 就是用這一版跑的。
The first release you can run as your own site. koimsurai.com runs on it.

git clone https://github.com/Koimsurai/sora-to-ki.git && cd sora-to-ki
cp .env.example .env && cp .env.backend.example .env.backend
docker compose up -d
docker compose logs backend-rs | grep setup   # 初次設定的網址 / the setup link

這一版有什麼 / What's in it

• 初次設定精靈：用 GitHub 或 Google 登入認領站長，選語系、填站名、決定開哪些頁面；右邊的軌道跟著你填的長出來
  First-time setup wizard: claim the site with GitHub or Google, pick languages, name it, choose pages, and watch the orbit grow as you go
• 預設語系自己選（繁中、简中、English、日本語、한국어），後台也是五種語言
  Choose your own default language (five supported); the admin speaks all five too
• 四顆天體主題：土星、海王星、黑洞、參宿四
  Four celestial themes: Saturn, Neptune, a black hole, Betelgeuse
• 關於、作品、航行日誌、問答、設備都在後台「頁面」填；原文改過時，標出還沒跟上的譯文
  About, works, log, Q&A and setup pages are filled in from the admin, which flags translations that fell behind the original
• 航行日誌的火箭從你設的發射台升空，地面畫那附近的海岸線
  The log's rocket lifts off from your launch pad, over that part of the coastline
• 錯誤訊息跟著讀者與站長的語言；發文、改設定後快取自動清掉
  Error messages follow the reader's or owner's language; caches clear themselves after you post or change settings
• 交給 AI 架站的說法寫在 README
  The README has a paste-ready prompt for setting it up with an AI agent

AGPL-3.0。

---

What's Changed

• feat(pages): 關於頁做成範本，內容改由後台與 MCP 填 by @Koimsurai in #310
• feat(pages): 航行日誌做成範本，起點與里程碑改由後台與 MCP 填 by @Koimsurai in #311
• feat(pages): 作品頁做成範本，清單改由後台與 MCP 填 by @Koimsurai in #312
• feat(pages): 此站點的問答做成範本，改由後台與 MCP 填 by @Koimsurai in #313
• feat(pages): 設備頁做成範本，圖紙包放進 custom/setup/ by @Koimsurai in #314
• feat(i18n): 預設語系與有開的語系改由站台設定決定 by @Koimsurai in #315
• feat(i18n): RSS、分享圖、後台跟著站台的預設語系 by @Koimsurai in #316
• feat(i18n): 繁中也有自己的譯文欄 by @Koimsurai in #317
• feat(admin): 後台介面語言可以切換 by @Koimsurai in #318
• feat(admin): 後台每一頁都換成五種語言 by @Koimsurai in #319
• fix(admin): 後台字串不再進到前台的主 bundle by @Koimsurai in #320
• feat: 初次設定精靈：認領站長、語系、站名與頁面 by @Koimsurai in #321
• feat(admin): 站台設定頁、預設語系前綴轉址、頁面編輯器排版 by @Koimsurai in #322
• feat: 前台不再寫死原作者名字，各頁描述可在後台自己寫 by @Koimsurai in #323
• feat(admin): 頁面編輯器標出原文改過、還沒跟上的譯文 by @Koimsurai in #324
• feat(theme): 天體主題：海王星、黑洞、參宿四與站長的預設 by @Koimsurai in #325
• fix: 全新安裝實測抓到的問題，README 加上交給 AI 架站 by @Koimsurai in #326
• fix(admin): 頁面切分頁留住草稿、離開前先問，天體與語系格子 by @Koimsurai in #327
• feat: 後端錯誤訊息改英文加代號，前後台照語言顯示 by @Koimsurai in #328
• feat(admin): 設備頁用前台的名字、部件旁放圖紙、文章用挑的 by @Koimsurai in #329
• perf(home): 字卡的淡入淡出改由 JS 照 CSS 轉場算 by @Koimsurai in #330
• perf(theme): 首頁以外換主題時頁面裡與收著的選單不跑顏色轉場 by @Koimsurai in #331
• feat: 發射台可以設定，航行日誌的地面照站長在哪裡畫 by @Koimsurai in #332
• chore(deps): three 升到 0.187.0 by @Koimsurai in #333
• docs(readme): 開頭說明可以拿去架自己的站 by @Koimsurai in #334

Full Changelog: v0.1.0...v0.2.0

v0.1.0

What's Changed

• 手機首頁沒有土星、舊 iPhone 文章頁打不開、部署後舊分頁載一半；LCP 上報帶上元素 by @Koimsurai in #265
• MCP 文章工具不再整篇來回傳、寫入前先驗、可上傳影片 by @Koimsurai in #267
• 文章頁：上一篇標題露出半截第三行、點頁首標籤時內文跳兩下 by @Koimsurai in #268
• 行內的 flowchart LR 不再被當成 mermaid 圖 by @Koimsurai in #269
• 設備頁改成太空梭貨艙，手機版面與轉場整批修正 by @Koimsurai in #270
• 舊分頁預載失敗不再回報，手記星空擋掉非有限數字 by @Koimsurai in #271
• 摺疊機版面：攤平時避開摺痕，摺起來照摺痕切成兩半 by @Koimsurai in #272
• 程式碼高亮從 shiki 換成 @pierre/highlights by @Koimsurai in #273
• 土星環開場、轉場順暢度、Web Vitals 補強、流量頁改版 by @Koimsurai in #275
• fix(boot): 手機開場交棒時環跟著點走，不再分開 by @Koimsurai in #276
• fix(boot): 開場的點放在土星的位置，手機交棒時環原地長大 by @Koimsurai in #277
• ci(docker): 字型原檔改在主機下載，快取位址轉小寫 by @Koimsurai in #278
• fix(boot): 桌機開場交棒時環不再往右偏半條捲軸寬 by @Koimsurai in #279
• perf: 開場環、文章筆尖、收藏頁避讓不再卡主執行緒 by @Koimsurai in #280
• perf: 入口檔拿掉沒在用的套件，語系字串用到才載 by @Koimsurai in #281
• build(deps): pele 從 1.3.0 升到 1.12.0 by @Koimsurai in #283
• build(deps): mermaid-to-excalidraw 升到 3.1，Sketch 改由 pele 排版 by @Koimsurai in #285
• feat(sketch): Sketch 改在伺服器畫成手繪 SVG，拿掉 Excalidraw by @Koimsurai in #287
• perf(blog): 文章內文全在伺服器編譯與上色 by @Koimsurai in #289
• feat(admin): 流量頁加上「今天」與「3 天」 by @Koimsurai in #290
• fix(admin): 留言頁與碎念的留言按讚不再顯示成「已刪除」 by @Koimsurai in #291
• perf(boot): BOOT 上報帶上開場等待的分段 by @Koimsurai in #292
• chore(css): check:css-tokens 擋下引用未定義的變數 by @Koimsurai in #293
• chore(css): 刪掉翻新後沒人用的配色變數，配色守則照翻新重寫 by @Koimsurai in #294
• style(css): 配色改成語意層，元件只用角色 by @Koimsurai in #295
• fix(github): 帳號改名成 Koimsurai，GitHub 相關的使用者名稱跟著改 by @Koimsurai in #296
• style(css): 圓角、模糊、陰影、z-index 照翻新後的用途收斂 by @Koimsurai in #297
• style(css): 程式碼註解提亮、錯誤框改用 --danger by @Koimsurai in #298
• perf(boot): 開場程式在主程式一載入就開始下載 by @Koimsurai in #299
• refactor(palette): canvas 與 3D 的顏色改從 lib/palette 讀 by @Koimsurai in #300
• feat: 站台身分改讀設定，compose 拆成通用版與 override by @Koimsurai in #301
• feat(settings): 站台設定存進資料庫，後台與 MCP 都能改 by @Koimsurai in #302
• chore(docker): Node 升到 26.12.1，修 brotli 解壓縮的 RCE by @Koimsurai in #303
• perf(blog): 文章頁 HTML 瘦身，不送用不到的資料 by @Koimsurai in #304
• perf(build): 靜態資產建置時預先壓好 brotli by @Koimsurai in #306
• feat(pages): 頁面登記表，碎念、作品、收藏可關且土星軌道跟著增減 by @Koimsurai in #305
• feat(deploy): 通用版 compose 內建 Caddy 反向代理 by @Koimsurai in #307
• feat(identity): 前端的站名、網址、聯絡方式改讀站台設定 by @Koimsurai in #308
• feat(install): 全新安裝乾淨化、GHCR 發版與自架說明 by @Koimsurai in #309

Full Changelog: https://github.com/Koimsurai/sora-to-ki/commits/v0.1.0