Personal Space

公開網站 / Public site: space.k-y.cc

目前程式版本 / Current code version: v0.6.0

截至 2026-07-28，正式網站已運行經驗證的 v0.6.0。遠端資料庫 migrations 已套用至 v0.6.0，私人 Studio 與寫入 API 亦已由 Cloudflare Access 保護。 公開 repository 不保存帳戶、資料庫、儲存空間或部署識別資料。

中文

Personal Space 是一個簡潔、由自己管理的個人發佈空間，公開內容分為：

• 筆記 / Notes — 短小、即時的內容。
• 文章 / Articles — 有完整結構的長篇內容。
• 每日整理 / Editions — 由公開 feed 收集、去重並經站主審閱的來源摘要。
• 動態、搜尋與封存 / Stream, Search, Archive — 以時間、關鍵字、分類及標籤尋回公開內容。

v0.4.0 加入只供站主使用的 Studio 發佈流程，以及公開的 Note 與 Article 列表／詳情頁。內容及修訂記錄存放於 Cloudflare D1，圖片存放於 R2；私人內容、 未發佈草稿及 Studio API 不會成為 repository 內容。

v0.5.0 加入 D1 FTS5 公開搜尋、時間動態、香港時間月份封存、分類／標籤頁、 RSS feeds 及 sitemap。首頁只會讀取真實公開內容；私人、未列出、草稿及未到期 排程內容不會出現在搜尋、封存、feeds 或 sitemap。

v0.6.0 加入私人來源管理、RSS／Atom 安全擷取、相近標題去重及每日 Edition 審閱流程。Cloudflare Cron Triggers 每日兩次同步已啟用來源，並在香港時間晚上 建立草稿；只有站主明確發佈的 Edition 才會出現在公開頁、獨立 RSS 及 sitemap。 repository 不預設加入第三方來源，來源條款及使用權需由站主在加入前確認。

目前介面採用原創 Clear Sky Feed 視覺系統，以淡天藍、晴空青、 薄荷青與少量日光黃構成清新、青春而俐落的信息流。所有圖標、SVG 與 CSS 裝飾均為原創抽象圖形，不使用第三方角色或受版權保護資產。

技術基礎：

• Astro full-stack；
• TypeScript strict mode；
• Cloudflare Workers 與 Static Assets；
• Cloudflare D1 內容資料庫與 R2 圖片儲存；
• Cloudflare Access 驗證及應用程式層站主核對；
• Note／Article 草稿、預覽、發佈、排程、封存及修訂還原；
• 公開全文搜尋、分類／標籤篩選、香港時間封存及時間動態；
• 來源同步、相近標題去重、Edition 草稿／審閱／發佈及 Cron automation；
• RSS、獨立 Note／Article／Edition feeds 及公開 sitemap；
• 響應式桌面／手機導覽；
• ESLint、Prettier、Vitest、Astro typecheck；
• GitHub Actions 與 Cloudflare Workers Builds。

本地開發

需要 Node.js 22.22.3 或更新版本，以及 npm 10 或更新版本。

npm install
npm run db:migrate:local
npm run dev
npm run check
npm run preview

本機 Studio 測試可由 .dev.vars.example 複製出未追蹤的 .dev.vars。正式環境 需要以 secret 提供 ACCESS_TEAM_DOMAIN、ACCESS_AUD 及 OWNER_EMAIL，並先 套用 D1 migration。不要把實際電郵、Access audience 或任何憑證提交到 Git。

公開 Wrangler 設定只宣告程式使用的 binding。最新版 Wrangler 可在部署時自動 配置所需資源；實際名稱及 identifiers 應只保留在 Cloudflare 的私人環境，不應 回寫到公開 repository。自動配置可能在部署工作目錄內寫入 identifiers，因此每次 提交前都必須重新檢查 git diff，不可提交這類變更。

正式發布次序固定為：先建立不會接管流量的 Worker version 並確認 bindings， 再套用遠端 D1 migration 及設定 Access secrets，最後才提升為正式部署。未完成 這些條件時，正式站繼續使用上一個已驗證版本。

公開 repository 只應包含應用程式碼、通用測試及公開安全文件。私人內容、 草稿、憑證、存取 token、部署識別資料和本地規劃文件不得提交到 Git。

English

Personal Space is a focused, self-managed publishing space for Notes and Articles, with chronological, searchable, and archived public discovery.

The current code version is v0.6.0. As verified on 2026-07-28, production serves the validated v0.6.0 release, remote database migrations are applied through v0.6.0, and Cloudflare Access protects the private Studio and write APIs.

The current interface uses the original Clear Sky Feed visual system: a fresh, crisp information feed built from pale sky blue, cyan, teal, and restrained sunlight-yellow accents. All icons, SVGs, and CSS decorations are original abstract graphics.

The application uses Astro, strict TypeScript, Cloudflare Workers with Static Assets, D1 content storage, R2 image storage, responsive navigation, GitHub Actions, and Cloudflare Workers Builds. v0.4.0 adds an owner-only Studio with draft, preview, publish, scheduling, archive, and revision restore workflows. v0.5.0 adds public full-text search, taxonomy filters, a chronological stream, Hong Kong month archives, RSS feeds, and a public-only sitemap. v0.6.0 adds owner-managed RSS/Atom sources, guarded ingestion, title-based deduplication, reviewed daily Editions, scheduled draft generation, an Edition feed, and Edition sitemap entries. No third-party source is seeded by the repository; the owner must review source terms before adding a feed.

For local Studio testing, copy .dev.vars.example to the ignored .dev.vars file and apply the local D1 migration first. Production requires ACCESS_TEAM_DOMAIN, ACCESS_AUD, and OWNER_EMAIL as secrets, plus the remote D1 migration. Never commit real account identifiers or credentials.

The public Wrangler configuration declares binding names only. Current Wrangler can provision the backing resources during deployment, while their real names and identifiers remain in the private Cloudflare environment. Automatic provisioning can write identifiers into the deployment workspace, so every commit must be checked with git diff to prevent those values from entering the repository.

Production releases follow a fixed order: upload a non-active Worker version and confirm its bindings, apply the remote D1 migration and Access secrets, and only then promote the verified version. Production stays on the previous verified release until every gate is ready.

Only application code, general tests, and public-safe documentation belong in this repository. Private content, drafts, credentials, access tokens, deployment identifiers, and local planning material must remain outside Git.