AIモデル deepseek-flash による翻訳。
原文言語:Simplified Chinese、翻訳先言語:japanese、翻訳時間:2026-10-27 10:25
。AI翻訳は参考に限り、内容の完全な正確性を保証できません。原文をご参照ください。
本記事は AI の支援を受けて執筆されました本記事は完全に AI の手によるもので、人間の関与は 0% です
はじめに
静的ブログは良いものの、記事の更新は本当に面倒です。
何か少し直したいと思うたびの流れは、おおよそ次のとおりです。PC を開く → エディタを開く → 該当の記事を探す → 修正する → commit → push → CI ビルドが終わってようやく公開。誤字を直すだけなのに、ちょうど外出中だったりすると、とりあえずメモに書いて帰宅後に、という具合でした。
2024 年には Decap CMS をいじっていて、初心者向け完全ガイドも書きました。これで「外出中でも記事を編集できる」問題はひとまず解決したわけです。
しかし長く使ううちに、いくつか気になる点が出てきました:
- インターフェースがあまり格好よくない(私の要求が高すぎるのかもしれません)
- スマートフォンではほぼ使えない
- frontmatter フィールドを 1 つ追加するには
config.ymlに戻って変更し、再デプロイする必要がある - その後ブログを Hexo から Astro に移し、Netlify の Identity 一式もとっくに使わなくなった
そこで生まれたのがこのプロジェクト、Astro Blog Studio です。
現在は sakura.ksable.top にデプロイ済みで、開けばすぐ使えます。
この記事では、それが何か、どんな見た目か、何ができるか、そして Decap CMS との違いを紹介します。最後に既知の制限も明記しますので、自分に合っているかの判断に役立ててください。
これは何か
一言で言うと、純フロントエンドで、バックエンドを持たないブラウザ上のワークベンチです。GitHub API を使って、ブログリポジトリ内の Markdown を直接読み書きします。
サーバーもデータベースもサードパーティ製の統計もありません。アプリ全体は 1 つの静的ウェブページで、任意の静的ホスティングに置けます。ブラウザが api.github.com と直接やり取りします。
保存 1 回のおおまかな流れは次のとおりです:
- ウェブページを開き、ロックを解除する(デバイスフィンガープリントまたはパスワード)
- 左側の索引カードからファイルを探す
- 本文を編集する、または frontmatter を編集する
- 「スタンプで保存」をクリックし、GitHub にコミットする
- コミットレシート(sha、パス、時刻、GitHub リンク)を受け取る
ローカルエディタもターミナルも開く必要はありません。
ソースコードは GitHub 上で AGPL-3.0 のもと公開しています。自分用にも 1 つデプロイしてあり、開けばすぐ使えます:
- オンライン URL:sakura.ksable.top
- ソースコード:God-2077/astro-blog-studio
技術スタックはおおよそ次のとおりです:
| 部分 | 使用技術 |
|---|---|
| フレームワーク | React 19 + TypeScript + Vite 7 |
| エディタ | CodeMirror 6 + marked + DOMPurify |
| GitHub | Octokit(REST + GraphQL) |
| スタイル | Tailwind CSS 4 |
| 状態管理 | TanStack Query + Zustand |
| オフライン | vite-plugin-pwa |
さらに 108 個のユニットテスト、7 個の実リポジトリに対する統合テスト、19 個の Playwright テストも用意しています。何しろ自分のブログリポジトリを書き換えるのですから、手抜きはできません。
どんな見た目か
コードを書く前に、AI に 4 つのビジュアル方向性を出してもらい、最終的に 01 番の「桜糖手帳」を選びました。
コンセプトは、ブログ編集を机の上に広げた手帳の紙のようにすることです。ファイルは索引カード、編集は紙、コミットはスタンプ。

開くと「今日は何を書こう?」が表示されます:
- 左側は索引カードの束:ディレクトリツリーとパス検索
- 中央は 3 枚の手書き付箋:すべての記事、下書き、暗号化
- 下は「最近触ったもの」:frontmatter の
updated/date順に並ぶ - 右側はコミットレシート、今日の小さな目標、GitHub API のクォータ
画面全体で塗りつぶしの桜ピンクのボタンは 1 つだけで、それが「新規記事」です。唯一の赤はスタンプです。
エディタは「3 枚の紙」で構成されています:

ファイルヘッダー(パス、状態、GitHub / 移動 / 削除)、frontmatter フォーム、Markdown 本文があり、右側にリアルタイムプレビューが表示されます。下部バーの右下には「スタンプで保存」の印があります。
テーマはデフォルトでシステムに従います。夜間モードに切り替えると、温かみのある墨色の紙になり、反転ではなく、目にも刺さりません:

いくつか、私が使いやすいと感じている機能
ファイルツリー、検索、「最近触ったもの」
左側はリポジトリのディレクトリツリーで、Markdown だけを表示します。検索ボックスではパスを検索できます(Ctrl/Cmd + K でフォーカス)。
ワークベンチの「最近触ったもの」は先頭の数記事を取るのではなく、GraphQL でリポジトリ全体の frontmatter を一括取得し、updated / date で並べ替えます。同時に読み込むバッチ数は設定で調整でき(1〜10、デフォルト 3)、高くすると少し速くなりますが、高すぎると GitHub のレート制限に引っかかる可能性があります。
1000 件を超える場合は先頭 1000 件だけをインデックスし、その旨が画面に表示されます。GraphQL が使えない場合は Contents API にフォールバックします。
フォーム / ソースファイルの 2 モード
これは私が最も気に入っている設計の 1 つです。
普段は「フォーム」を使います。frontmatter のフィールドは動的に生成され、名前、型、必須かどうかを設定で構成できます。date には書式ヒントがあり、list はカンマ区切り、password はマスク表示されます。
しかし時には、キーの順序を変える、引用符を変える、コメントを追加するなど、ファイル全体を直接編集したくなります。そんなときは「ソースファイル」に切り替えます。CodeMirror の領域で --- のフェンス + 本文を直接編集し、保存時は入力どおりに書き戻します。元ファイルの CRLF/LF と BOM だけを復元し、frontmatter を解析したり、「ついでに修正」したりはしません。
どちらのモードから切り替えても、未保存の内容は先に取り込まれるため失われません。
スタンプで保存:コミットメッセージ、コミットレシート、競合
保存は「保存」ボタンではなく、「スタンプ」です。
コミットメッセージはテンプレートに対応しており、たとえば update: {path} のように書けます。使用できるプレースホルダーは {path}、{title}、{newPath}、{dir}、{name}、{date} などで、設定で変更できます。
保存に成功すると、コミット sha、パス、時刻、GitHub リンクを記載したレシートが表示されます。
更新と削除には sha による楽観的ロックを付けています。リモートがすでに変更されていれば 409 が返り、「再読み込み / リモートを上書き / キャンセル」を選ぶダイアログが表示され、変更が黙って上書きされることはありません。
移動と名前変更は Git Data API を使った 1 回のコミットで完了し、「追加してから削除」という中間状態は発生しません。
保存せずに再読み込みした?この端末にバックアップがあります
記事を書くときに一番怖いのは、うっかりミスです。
エディタは約 600ms のデバウンス後、ファイル全体のスナップショットをブラウザの IndexedDB に書き込み、下部バーに「この端末にバックアップ済み HH
」と表示します。次に同じファイルを開くと(再読み込み後でまだコミットしていない新しい下書きも含む)、復元するかどうかをダイアログで尋ねられます。「後で / バックアップを破棄 / バックアップを復元」から選べます。古い下書きを復元した後の保存も引き続き 409 競合処理を通るため、リモートの新しい変更を上書きすることはありません。
保存、移動、削除に成功すると、対応するバックアップは自動的に削除されます。設定で無効化したり消去したりもできます。バックアップはこの端末にのみ存在し、アップロードされず、Service Worker のキャッシュにも入りません。
スマートフォンと PWA
スマートフォンでは、索引は左側のドロワーに収納され、プレビューは本文の下に配置され、スタンプボタンは紙の末尾に固定されます。
さらにインストール可能な PWA です。ビルド成果物には manifest と Service Worker が含まれ、アプリシェル(HTML/JS/CSS/フォント/アイコン)がプリキャッシュされるため、2 回目に開くときや、不安定なネットワーク、さらにはオフラインでもまず画面を開けます。ただしファイルの読み込みと保存にはネットワークが必要で、api.github.com は常に NetworkOnly です。
新しいバージョンがあるとダイアログで通知され、「今すぐ再読み込み」をクリックしたときだけ再読み込みされます。勝手に自動更新されることはありません。
PAT はブラウザ内にだけ存在する
GitHub トークンをブラウザに置いて大丈夫なのか、と心配する人もいるかもしれません。
- トークンは AES-GCM-256 で暗号化してから localStorage に書き込み、鍵は PBKDF2-SHA256(60 万回)で派生します
- ロック解除後のトークンはメモリ内にのみ存在します。ロックするとメモリ、クエリキャッシュ、編集セッションが消去されます
- 外部リクエストは
api.github.comの 1 つだけです - サードパーティ製のスクリプト、統計、フォント CDN はありません。プレビューは DOMPurify でサニタイズし、外部リンクには自動的に
rel="noreferrer noopener"を付けます - アプリ自体にも
noindex, nofollowを設定しており、検索エンジンにインデックスされません
補足しておくと、デバイスフィンガープリントはセキュリティ境界ではありません。より安全にしたい場合はパスワードを設定し、「パスワード + デバイス」の 2 要素を有効にしてください。公共の PC では使用後に必ずロックしてください。
Decap CMS との比較
以前 Decap CMS のチュートリアルを書いたので、ここでついでに比較してみます。
| Decap CMS | Astro Blog Studio | |
|---|---|---|
| デプロイ | Netlify Identity + Git Gateway が必要 | 任意の静的ホスティング + PAT |
| ログイン | メール招待 | デバイスフィンガープリント / パスワード |
| インターフェース | 汎用 CMS | 手帳風、中国語インターフェース |
| モバイル | あまり使いやすくない | ドロワー索引 + 固定スタンプ |
| frontmatter | config.yml を変更して再デプロイ | 設定ページで追加・削除でき、即時反映 |
| 編集 | リッチテキスト | フォーム + CodeMirror ソースファイル |
| オフライン | なし | PWA アプリシェル |
Decap CMS の機能は実はもっと充実しています(メディアライブラリ、編集ワークフローなど)。ただ、あらゆる静的サイト向けで設定が重く、インターフェースも私の習慣に合ったものではありません。Astro Blog Studio は自分のブログだけに使うものなので、細部のすべてを自分が使いやすい形にできます。たとえばコミットメッセージのテンプレート、frontmatter フィールド、この端末でのバックアップは、いずれも私の使い方に合わせて作ったものです。
あなたも静的ブログを運営していて、次の条件に当てはまるなら:
- 記事とソースコードが GitHub 上にある
- 自分 1 人だけが使う想定である
- PAT を 1 つ作成・管理してもよい
このツールも合っているかもしれません。
使い方
sakura.ksable.top に 1 つデプロイしてあり、開けばすぐ使えます。自分で実行したり、自分のドメインにデプロイしたりもできます。
1. GitHub Token を作成する
GitHub で fine-grained personal access token を作成し、自分のコンテンツリポジトリだけに権限を付与します。
Repository permissions → Contents: Read and writeMetadata: Read-only(自動で付与されます)
PR、Actions、Pages の権限は不要です。具体的な手順は GitHub 公式ドキュメント を参照してください。
2. ウェブサイトを開く
sakura.ksable.top を直接開きます。初回は Setup ページになります。
先に説明しておくと、このページはフロントエンドだけであり、リポジトリ、トークン、設定はすべてあなた自身のブラウザにのみ存在します(トークンは暗号化してから保存されます)。私の側から誰かの内容を見ることはできません。他人のドメインでトークンを入力するのが気になる場合は、手順 4 に従って自分でデプロイしてください。コードは同じものです。
まずインターフェースだけ見たい、でもトークンは入力したくないという場合は、デモモードを開けます。メモリ内のダミーデータを使い、ネットワークにも接続せず、リポジトリにも書き込みません:
https://sakura.ksable.top/?demo=1
ローカルで実行したい場合も可能です:
git clone git@github.com:God-2077/astro-blog-studio.git
cd astro-blog-studio
pnpm install
pnpm dev
http://localhost:5173 を開けば大丈夫です。
3. リポジトリを接続する
Setup ページで次を入力します:
- リポジトリ:
owner/nameまたは GitHub URL - ブランチ:空欄ならデフォルトブランチを使用
- 記事のルートディレクトリ:このブログでは
src - 除外ルール:たとえば
src/content/blog/en、src/content/blog/ja
次にロック解除方法を選びます。デバイスフィンガープリントにチェックを入れると、再読み込み後に自動でロック解除されます。あるいはパスワードも設定できます。
4. デプロイ(任意)
オンライン URL をそのまま使う場合、この手順は省略できます。
pnpm build の後、dist/ を任意の静的ホスティングに置くだけです(Cloudflare Pages、Vercel、GitHub Pages、Netlify のいずれでも可)。HashRouter を使っているため、SPA のリライトルールは不要です。
サブパスにデプロイする場合は、ビルド時に STUDIO_BASE=/studio/ を追加します。
サイトには CSP を追加し、少なくとも
script-src 'self'、connect-src 'self' https://api.github.com、img-src 'self' data: https:を制限することをおすすめします。
既知の制限
万能ではありません。これらの制限は事前に明確にしておく必要があります:
- 単一ファイル編集のみ。画像アップロード、ファイル横断検索(検索できるのはパスのみ)、バージョン履歴 UI はありません
- 競合処理は「再読み込み / 上書き / キャンセル」のみで、行単位のマージはありません
- UTF-8 の Markdown / MDX のみ対応。バイナリファイルと超大容量ファイルは非対応である旨が表示されます
- GitHub Contents API には 1 ファイルあたり約 1MB の制限があります。ブランチ保護や読み取り専用トークンの場合、書き込み時に 403 が返ります
- デバイスフィンガープリントはセキュリティ境界ではありません。公共の PC ではパスワード + 2 要素認証を設定してください
- オフラインでキャッシュされるのはフロントエンドのみです。ネットワークが切れていても画面は開けますが、ファイルツリー、本文、コミットにはネットワークが必要で、オフライン保存キューはありません
- プレビューは本番サイトと 100% 一致するわけではありません(差異はページ上に記載され、最終的な基準は常にソースファイルです)
今後やりたいこと
- 画像の貼り付けアップロード
- ファイル横断の全文検索
- コマンドパレット
- カバー / カレンダービュー
- オフライン編集と保存キュー
まずはこれらを書き留めておき、できるところまで進めます。
よくある質問
サーバーやデータベースは必要ですか?
不要です。純粋な静的ウェブページであり、すべての読み書きはブラウザから api.github.com に直接リクエストします。pnpm build の後、dist/ を静的ホスティングに置けば使え、サーバーサイドのランタイムはありません。
Astro ブログでしか使えませんか?
いいえ。アプリは GitHub リポジトリ内の Markdown ファイルだけを対象とし、記事のルートディレクトリ、拡張子、除外ルール、frontmatter フィールドは設定で変更できるため、Hexo、Hugo、Astro など Markdown で記事を書く静的ブログならどれでも利用できます。
PAT をブラウザに置いて安全ですか?
トークンは暗号化してから保存され、ロック解除後はメモリ内にのみ存在します。アプリはサードパーティ製スクリプトを一切読み込まず、外部リクエストは api.github.com のみです。デバイスフィンガープリントはセキュリティ境界ではないため、公共の PC ではパスワードを設定し、2 要素認証を有効にすることをおすすめします。
スマートフォンで記事を書けますか?
はい。ファイルツリーはドロワーに収納され、プレビューは本文の下、保存ボタンは下部に固定され、スマートフォンのホーム画面にインストールすることもできます。
リポジトリを壊してしまいませんか?
保存と削除には sha 検証が付いており、リモートに変更があれば先にダイアログで選択を促すため、黙って上書きすることはありません。frontmatter は変更されたフィールドだけを書き戻し、CRLF/LF、BOM、末尾の改行は保持されます。
関連リンク
- オンライン URL:sakura.ksable.top
- プロジェクトリポジトリ:God-2077/astro-blog-studio
- 過去の記事:Decap CMS を Hexo のバックエンドとして使ってオンライン編集を実現する(初心者向け完全ガイド)
おわりに
この記事を書いている時点で、このプロジェクトはまだ生まれて 1 日です。
あなたも静的ブログを使っていて、「記事の更新が面倒」という悩みを経験したことがあるなら、この記事が少しでも参考になれば幸いです。
質問があれば下のコメント欄に書き込むか、GitHub で issue を立ててください。
気に入ったならばコメントを残してくださいね~