日本語 | English

StackNest

Swift ネイティブ、Apple Silicon 対応の画像ライブラリ（カタログ）マネージャです。オリジナルの Stackroom のライブラリ XML を**取り込む（インポートする）**ことができます。

⚠️ 互換性についての注記: StackNest が対応するのは Stackroom ライブラリ XML のインポート（一方向の読み込み）だけです。StackNest 自身のライブラリ形式（.stacknest）は独自で、Stackroom と相互互換ではありません（Stackroom で開いたり書き戻したりはできません）。また StackNest はカタログソフトで、.stacknest はメタデータと表紙サムネの目録です。画像や本の実体ファイルはライブラリの外（元の場所）に置かれ、StackNest はそのパスを参照します。

Status: アクティブ開発中。ローカルでのブラウズから、別 Mac や iPhone のブラウザへ向けたリモート共有までが動作します（各機能の詳細は下記「主な機能」を参照）。主な柱は次のとおりです。

• ローカル管理（Phase 2.9 まで完了）: ブラウズ / 編集 / 検索、内蔵ビューア、マルチライブラリ、ロック、重複検出、ラベルカスタマイズ、DB 予防保全 / 修復。
• リモート共有 / 閲覧 / 編集（Phase 4）: 共有サーバと Web ブラウザ / Web リーダー、別 Mac からのネイティブクライアント、オフラインダウンロード、リモート閲覧のディスク永続キャッシュ。
• 権限分離: 共有トークンで相手ごとに閲覧 / 編集 / 管理者の権限と見せるライブラリを分けられます。編集トークンならリモートからメタデータ / スタンプ / 表紙を編集でき、管理者トークンならリモート追加 / 削除も可能です。
• 自動化: 監視フォルダの自動取込と、ローカルアクセス（CLI stacknest-cli / MCP mcp-stacknest / OpenAPI + Redoc）による操作に対応します。

これは何か

StackNest は、aroma / aromatics soft が開発した Stackroom 2.1b の書き出す Apple Property List XML ライブラリファイルを読み込み、大規模な画像コレクション （10,000 件以上で動作確認済み）をブラウズし、管理するモダンな macOS ネイティブ体験を提供します。

本プロジェクトは aroma / aromatics soft とは無関係です。Swift でゼロから書かれた 独立実装で、Stackroom のライブラリ XML を取り込めます（互換性の詳細は冒頭の注記を参照）。

なぜこのプロジェクトがあるか

オリジナル Stackroom（最終リリース: 2.1b Build 198、2019年）は x86_64 専用バイナリで、 arm64 ネイティブサポートがありません。Rosetta 2 での動作は継続していますが、長期的には ネイティブ書き直しが必要になります。

aroma 氏（原作者）は 2019 年頃、5ch 新・Mac 板のスレッド（egg.5ch.net/test/read.cgi/mac/1391446507）にて次のように述べています：

ライブラリファイルはただの XML だし、その気があるなら たぶん Swift で 一から作ったほうが早いくらい だと思います。

本プロジェクトはこの明示的な推奨に従っています。オリジナル Stackroom のバイナリ、 ソースコード、アイコン、UI スクリーンショット、Sparkle スタイルのブランディングアセットは 再配布していません。ディスク上のライブラリフォーマットのみを観察から再実装しています。

• aroma 氏のオリジナル Stackroom: https://aromaticsapp.blogspot.com/p/stackroom.html
• aroma 氏のリリースブログ: https://aromaticsapp.blogspot.com/

主な機能

• ライブラリブラウズ: グリッド / リストの 2 ビュー、Browser pane（属性別カラムフィルタ）、Detail pane（メタデータ編集）
• 検索: ツールバーの検索バー + SQLite FTS5 による全文検索（大きくスクロールした状態で絞り込むと、一覧は自動で先頭へ戻る）
• マルチ値フィールド: ジャンル / 作者 / キーワード A / B / C はカンマ区切りで複数値を保持し、Browser pane で個別値ごとに絞り込める
• スマートシェルフ: 条件式（N 条件 × AND/OR × 4 マッチタイプ）で動的にコレクションを構成。Apple Mail 風の条件エディタで、インポートした Stackroom スマートプレイリストも動的評価
• スタンプペイン: ユーザ定義の chip（5 列、消去 / 値 / 新規追加）で複数本に一括属性付与
• 重複検出: 別ディレクトリにある同一内容の本を SHA-256 のバイト一致（およびシリーズ + 巻数の一致）で検出。解決シートで「登録のみ削除」「ファイルもゴミ箱へ」、グループ単位の無視に対応
• ラベルカスタマイズ: 内容系フィールド（ジャンル / ネタ / キーワード A / B / C）と bookType 6 種をライブラリごとに任意名へ変更でき、全表示箇所（列ヘッダ / ソート / Detail / スタンプ / フィルタ / スマートシェルフ）へ一貫反映
• ビューアキー再割当: 設定 ▸ キー で内蔵ビューアの全操作を任意キーへ再割当（競合は拒否、行ごと / 全体の既定に戻せる、ヘルプ表は現在の割当を反映）
• 大規模ライブラリ性能: 数千〜数万件規模でソートを最適化（ICU 照合キーの前計算により、リスト更新ごとの再ソートを高速化）
• 内蔵ビューア: 専用ウィンドウ / 全画面で、zip / cbz / cbr / 7z / フォルダ / 単一画像 / PDF を統一パイプライン表示。フィット、ピンチ / ± ズーム、ドラッグでパン、ゾーンクリック / 矢印 / Space でページ送り、数字キーで位置ジャンプ。見開き表示（本ごとに上書き）、本ごとのページ方向（右→左 / 左→右）、スライドショー、続きから読む、巻末挙動（停止 / 次の巻 / ループ）、前後巻ナビ、全画面で開く、操作キーのフル再割当（設定 ▸ キー）ほか。インスタンス管理で同じ本の重複起動を防止し、設定で本ごとに別ウィンドウも選べる。内蔵 / 外部ビューアは設定で切替
• 表紙編集: 各本の表紙を、アーカイブ内の任意ページ選択、表示範囲のクロップ、外部画像の D&D（または「外部画像を表紙に設定…」メニュー）で差し替え。見た目（サムネイル）だけの変更で、アーカイブ本体や元ファイルは変更しません。ローカルでもリモート（編集トークン）でも利用でき、サーバ側で表紙が変わればリモートのクライアントも一覧リロード / 再接続で追従
• ファイル操作: ライブラリへの追加 / 削除、⌫ 削除 / ⌘⌫ ゴミ箱 / ⇧⌘R リネーム / ⌘D ファイル移動、各種確認ダイアログ
• キーボードナビ: グリッド / リストの矢印、Shift+矢印（範囲選択）、⌘↑↓、Home / End、PageUp / Down、Enter で開く
• グリッドサイズ: ライブラリごとに永続化されるサムネイルサイズのスライダー
• パスワードロック: ライブラリごとに SHA-256（salt 付き）でロック設定可能。Touch ID / Apple Watch による生体認証解錠にも対応
• 対応形式: アーカイブは ZIP / CBZ / RAR / CBR / 7z（libarchive 経由）と PDF（PDFKit）、画像は JPEG / PNG / GIF / WebP / HEIC / HEIF / TIFF / AVIF（NSImage 経由）
• 初回起動ウィザード: 初回起動時にページ送り式ウィザードで「画像の開き方（内蔵 / 外部ビューア）→（内蔵選択時）ビューア初期設定 → 最初のライブラリ（新規 / 開く / 取り込み）」を設定。設定 ▸ 一般 からいつでも再表示可能
• インポート: 既存 Stackroom ライブラリ XML から SQLite DB へ移行
• 監視フォルダ（自動取込）: 指定フォルダを監視し、置かれたアーカイブ / 画像フォルダを自動でライブラリへ取り込み（フォルダごとの命名プリセット、初回プレビュー、取込要約バナー）。自動分類（bookType）や厚さ閾値はライブラリごとに上書き可能（「StackNest 設定の値に従う」/ 個別指定）
• リモート共有（サーバ）: ライブラリを HTTP で配信。共有トークンで相手ごとに閲覧 / 編集 / 管理者の権限と見せるライブラリ（scope）を分けたトークンを発行でき、トークン別の QR / URL、NIC 選択 / IPv6、縮小配信、ロック庫の unlock に対応。トークンの発行 / 名称変更 / 再生成 / 無効化はサーバ再起動なしで即時反映。Web ブラウザから閲覧（list / grid、FTS 検索、ソート、ページ送り）でき、Web リーダー（先読み、見開き / 1 頁送り、続きから、読み方向の双方向即時同期、巻末ナビ、PWA アイコン）で読める
• ネイティブリモートクライアント: 別 Mac の StackNest から共有サーバへ接続して閲覧と編集ができる。サイドバー / ファセット / フィルタ / グリッド / リスト / 詳細ペインのフルブラウズ、内蔵ビューア、進捗のサーバ同期に対応。RW（編集可）トークンなら詳細ペインで編集でき、メタデータの一括編集、スタンプ、表紙編集、読み方向変更、ラベルカスタマイズをリモートから行える（管理者トークンなら本の削除も可能。R トークンでもレート / 未読は共有評価 / 閲覧状態として編集可）。取り消し / やり直し（⌘Z / ⌘⇧Z）にも対応し、メタデータ編集の取り消しはサーバの編集前値から復元して同時編集を上書きせず、ゴミ箱削除の取り消しはファイルも元の場所へ復元する
• リモート閲覧のディスク永続キャッシュ: リモートのページ / 表紙を端末にディスク永続キャッシュ（LRU + 可視保護 + TTL）し、再接続 / 再起動後もキャッシュが効く（設定「リモートキャッシュ」で上限 / 保持期間 / 使用量 / クリアを管理）。内蔵ビューアの先読み（前方優先 + スキップストライド、本 1 冊分の全冊先読みトグル）、プログレスバーへのキャッシュ済み範囲の帯表示、サーバ側の表紙変更への追従にも対応
• オフラインダウンロード: リモートの本を選んでローカル保存し、接続なしで一覧と閲覧（続きから）。タイトル画面 / File メニューの「オフライン」から起動。複数選択で一括ダウンロード / 一括削除
• リモート / オフライン巻送り: 内蔵ビューアの前 / 次の巻がリモート（隣接巻をストリーム、未 DL 可）でもオフライン（DL 済の連続巻）でも動作。読みかけの巻は「続き / 最初」を選択
• ローカルアクセス（CLI / MCP 自動化）: 同梱の stacknest-cli でライブラリをコマンドライン操作（一覧 / 追加 / 削除 / メタ編集 / 棚 CRUD / 監視 / ロック / 取り込み / 再リンク / 重複 / 共有トークン / スタンプ / ラベル）。**MCP サーバ（mcp-stacknest）**経由で AI エージェントからも操作でき、ローカルエンドポイントは OpenAPI 3.1 + Redoc の API ドキュメント付き

動作環境

• macOS 14 Sonoma 以降（主要ターゲットは macOS 26 Tahoe）
• Apple Silicon ネイティブ（x86_64 向け Universal Binary も生成）
• ソースからビルドするには Xcode 26+

インストール（リリース版）

リリース版は CI で自己署名（固定 identity）された Universal ビルドを配布します（匿名の自己署名証明書、Apple Developer 公証なし）。GitHub の Releases から StackNest.app（zip）をダウンロードし、/Applications などへ展開してください。identity が固定のため、Full Disk Access などアプリに付与した権限はアップデートをまたいで持続します。

自己署名アプリは Gatekeeper にブロックされるため、初回のみ許可操作が必要です（2 回目以降は通常どおりダブルクリックで起動）。

重要（macOS 15 Sequoia 以降）: macOS 15 以降は「右クリック →『開く』」での Gatekeeper 回避が廃止されました。未署名 / 自己署名アプリは、いったんブロックされたあとにシステム設定から明示的に許可する必要があります。

方法 A（推奨、GUI / macOS 15、26 で確認）

1. StackNest.app を /Applications に置き、ダブルクリックする（「開けません」ダイアログが出るので「完了」）。
2. システム設定 → プライバシーとセキュリティ を開き、下部の「セキュリティ」セクションに表示される 「"StackNest" は…ブロックされました」の右の 「このまま開く」 をクリック。
3. 認証（Touch ID またはログインパスワード）を求められたら入力し、確認ダイアログで再度 「このまま開く」。

方法 B（ターミナル） — quarantine 属性を除去してから起動（システム設定の操作が不要）：

xattr -dr com.apple.quarantine /Applications/StackNest.app

macOS 14 以前では「右クリック →『開く』」でも開けますが、macOS 15 以降では上記の方法 A（システム設定からの許可）または方法 B を使ってください。

⚠️ 自己署名は「正規の開発元」を保証しません（証明書は匿名です）。信頼できる入手元（本リポジトリの Releases）からのみ導入してください。本プロジェクトは Apple Developer 公証を行いません（自己署名配布で確定）。自分でビルドする場合は下記「ビルド」を参照してください。

リポジトリ構成

App/                  -- macOS App ターゲット（xcodegen 経由で生成、xcodeproj は gitignored）
Sources/
  StackroomFormat/    -- Stackroom ライブラリ XML/plist の読み取り（インポート用）
  LibraryStore/       -- SQLite（GRDB）リポジトリ、Migration、FTS5、マルチ値正規化
  ImageCache/         -- サムネイル描画 / キャッシュ
  ArchiveAdapter/     -- libarchive 経由の ZIP / CBZ / RAR / CBR / 7z 読み込み
  AppCore/            -- アプリレベルのロジック（LibrarySettings, AppPreferences, LibraryLock, エラー型、外部ビューア起動）— テスト容易性のため SwiftUI 非依存
  LibraryServer/      -- 共有サーバ（Hummingbird）、Web UI / リーダー、OpenAPI/Redoc、アクセスティア / グラント
  LibraryServerAPI/   -- サーバ / クライアント共有の DTO
  RemoteClient/       -- ネイティブリモートクライアント（HTTP クライアント、L1/L2 キャッシュ、先読み）
  StackroomImportCLI/ -- インポータ実行ファイル（swift run stackroom-import）
  StackNestCLI/       -- ヘッドレス CLI（stacknest-cli、ローカル / リモート操作）
mcp-stacknest/        -- MCP サーバ（Python、stacknest-cli を包む、AI エージェント連携）
Tests/                -- Swift Testing モジュール（swift-testing）
docs/                 -- アーキテクチャ、設計メモ、smoke checklist

ビルド

SPM ライブラリと CLI

swift build
swift test
swift run stackroom-import --xml "$HOME/Library/Application Support/stackroom/Stackroom Library.xml" --out /tmp/stackroom.sqlite --force

macOS App

xcodeproj は gitignore されているため、まず xcodegen で生成します。

cd App && xcodegen && cd ..
xcodebuild \
  -project App/StackNest.xcodeproj \
  -scheme StackNest \
  -configuration Debug \
  -destination 'platform=macOS' \
  build

Universal Binary（arm64 + x86_64）でのリリースビルド：

xcodebuild \
  -project App/StackNest.xcodeproj \
  -scheme StackNest \
  -configuration Release \
  -derivedDataPath build \
  CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO \
  ARCHS="arm64 x86_64" ONLY_ACTIVE_ARCH=NO \
  build

xcodegen 実行後は App/StackNest.xcodeproj を Xcode で開くこともできます。

CLI インポータのリファレンスは docs/importer.md を参照してください。

使い方

アプリのビルドまたは xcodebuild の実行後、macOS アプリを起動します：

open ~/Library/Developer/Xcode/DerivedData/StackNest-*/Build/Products/Debug/StackNest.app

初回起動時（新規インストールで設定なし）は初回起動ウィザードが表示され、画像の開き方と最初のライブラリを順に設定します。2 回目以降やライブラリ未選択時はタイトル画面が表示され、次の 3 つの選択肢を提示します：

• 新しいライブラリを作成: 任意の場所に空の .stacknest bundle を作成して開く
• 既存のライブラリを開く: 既存の .stacknest bundle を選択して開く
• Stackroom Library から取り込む: aroma 氏のオリジナル Stackroom が出力する Stackroom Library.xml を読み込み、新規 .stacknest bundle として保存

マルチライブラリ対応

各 .stacknest bundle は独立したライブラリ（SQLite DB + assets を含む macOS bundle）で、それぞれ独立した window で同時に開けます。同じライブラリを 2 回開こうとすると既存 window が前面に来ます（OpenLibraryRegistry による二重 open 防止）。

起動モードはアプリ設定（⌘,）の「起動時」で切替可能です：

• タイトル画面を表示（default）
• 前回開いていたライブラリを開く: 終了時に open していた全 library が再度開く
• 指定ライブラリを毎回開く: 設定で指定した特定 library のみ毎回開く

外部ビューアの設定

既定では本は内蔵ビューアで開きます。内蔵 / 外部の切替は 設定 ▸ 表示 ▸ 画像ビューア ▸ ビューア で行います。外部ビューアを使う場合は 設定 ▸ 表示 ▸ 画像ビューア（⌘,）で外部ビューアを設定してください。 「選択…」をクリックして画像ビューアアプリ（cooViewer、Avian、プレビュー 等）を選んでください。 設定しない場合、システムの Archive Utility が .zip を展開するだけになります。 選択した外部ビューアは UserDefaults を通じて起動間で保持されます。

設定済みであれば、グリッドで本をダブルクリックするとファイル（またはカバー画像）が 直接選択した外部ビューアで開きます。

CLI からのインポート

タイトル画面の「Stackroom Library から取り込む」と同じ DB は、コマンドラインから swift run stackroom-import で生成することもできます（docs/importer.md 参照）。生成された SQLite DB を .stacknest bundle 内に配置して、「既存のライブラリを開く」から開けます。

リモート閲覧（共有、クライアント、オフライン）

StackNest は同じアプリがサーバ（共有）にもクライアントにもなります。別の Mac、iPhone、タブレットのブラウザから、自分のライブラリを閲覧できます。

サーバ側（共有する）

1. 共有したいライブラリを開き、ツールバーのアンテナ（配信インジケータ）または共有設定で共有を ON にします。
2. サーバ設定の共有トークンで、相手ごとに権限（閲覧 / 編集 / 管理者）と見せるライブラリ（scope）を分けたトークンを作り、その URL / QR コード / トークンを接続側へ渡します（NIC 選択、IPv6 対応）。トークンの発行 / 名称変更 / 再生成 / 無効化はサーバ再起動なしで即時反映されます。ロック庫は接続側でパスワード unlock が必要です。
3. セキュリティ: ポートを直接インターネットに公開せず、Tailscale 等の VPN 経由での利用を推奨します（LAN 内利用が前提）。

Web ブラウザから見る

• 接続側のブラウザで共有 URL を開くと、list / grid、全文検索、ソート、ページ送りでブラウズでき、本を開くと Web リーダー（先読み、見開き / 1 頁送り、続きから、読み方向同期）で読めます。

ネイティブクライアント（別 Mac の StackNest から）

• タイトル画面（または File メニュー）の 「サーバに接続…」 から URL とトークンを入力して接続します。サイドバー / ファセット / フィルタ / 詳細ペインのフルブラウズと内蔵ビューアで閲覧でき、読書進捗はサーバへ同期されます。RW（編集可）トークンで接続した場合は、リモートのままメタデータ編集（単一 / 複数一括）、スタンプ、表紙編集（アーカイブ内ページ選択 / クロップ / 外部画像を D&D、「外部画像を表紙に設定…」メニューで表紙に）、読み方向変更ができます（R トークンは読み取り専用）。表紙は見た目のみの変更でアーカイブ本体は不変です。共有元やほかのクライアントで表紙が変わった場合も、一覧リロード / 再接続で追従します。

オフライン（接続なしで読む）

• 接続中に本を右クリック →「ダウンロード」でローカル保存します。「選択」モードで複数選択 → 一括ダウンロードも可能です（シリーズをファセット / 検索で絞って「すべて選択」が便利）。
• タイトル画面 / File メニューの 「オフライン（ダウンロード済み）」 から、サーバに接続していなくてもダウンロード済みの本を一覧と閲覧ができます（続きから、巻送り対応）。不要になった本は「選択」モードで一括削除できます。

ローカルアクセス（CLI / MCP による自動化）

StackNest は、GUI を介さずにコマンドラインや AI エージェントからライブラリを操作できます。

• 有効化: アプリ設定（⌘,）の 「一般 ▸ ローカルアクセス」 で有効にします（127.0.0.1 限定のローカル制御エンドポイント）。
• CLI: アプリに同梱の stacknest-cli で、一覧、追加、削除、メタデータ編集、棚 CRUD、監視設定、ロック、取り込み、再リンク、重複スキャン、共有トークン管理、スタンプ / ラベルを操作できます（stacknest-cli --help）。パスワードは stdin 入力で argv に露出しません。
• MCP: mcp-stacknest（Model Context Protocol サーバ）を登録すると、対応する AI エージェントから同等の操作ができます。詳細は mcp-stacknest/README.md を参照。
• API ドキュメント: ローカルエンドポイントは API 専用で、ブラウザでルート（/）を開くと Redoc（OpenAPI 3.1） の API リファレンスが表示されます。

ライブラリのロック (Phase 2.5b 以降)

各 .stacknest ライブラリにはパスワードロックを設定できます。Touch ID / Apple Watch 連携にも対応しています。

パスワードを忘れたとき

リカバリー手段は提供していません。ロックは「簡易的に他者からの偶発的アクセスを防ぐ」目的の機能で、暗号化はされていません。パスワードを忘れて開けなくなったライブラリは、以下の手順で DB を直接編集することで解除 できます。

sqlite3 /path/to/MyLibrary.stacknest/library.sqlite \
  "DELETE FROM library_settings WHERE key IN ('lock_password_hash', 'lock_password_salt', 'lock_use_biometric');"

実行後はロックなし状態になり、StackNest から再度開けるようになります。必要に応じて File menu「このライブラリの設定…」(⇧⌘,) から再設定してください。

注意点:

• ロックは平文 hash + salt の SHA-256 で保護されているのみで、ライブラリ DB / 画像ファイル本体は暗号化されていません
• 強い秘匿性が必要な情報は別の手段 (Disk encryption, FileVault 等) で保護してください

ライブラリの自動バックアップ (Phase 2.8 以降)

クラウド同期下での DB 破損に備え、各 .stacknest ライブラリは編集のあったセッションを閉じるたびに、バンドル内 Backups/ へ世代バックアップ（軽量なメタデータ DB のスナップショット）を自動保存します。閲覧のみで変更がなければ世代は増えません。

• 有効/無効と保持世代数（1〜20、既定 5）はライブラリ設定の「バックアップ」タブで変更できます。
• ライブラリを開くときに整合性チェック (PRAGMA quick_check) を行い、破損を検知すると「最新の正常なバックアップから復元しますか？」と案内します。
• バックアップからの復元ができない場合は、続けて**「.recover で修復を試す」**（アプリ内）を選べます。システムの sqlite3 .recover で可能な範囲のデータを救出し、復元できた本の件数を提示してから開きます（壊れた本体は library.prerecover-* / library.corrupt-* として残します）。
• それでも直らない場合や手動で古い世代へ戻したい場合は、DB 復旧ガイド を参照してください（手動 sqlite3 .recover 手順を含む）。

ロードマップ

開発は段階的フェーズで進めています。要約：

フェーズ	内容	状況
2.1	Stackroom XML インポータ（CLI + SQLite/GRDB）	✅ 完了
2.2	グリッド / アイコン表示、サムネイル、アーカイブ読み込み	✅ 完了
2.3	サイドバー（ライブラリ / お気に入り / 最近）、シェルフ、詳細ペイン	✅ 完了
2.4	リスト表示、ツールバー / ファセットフィルタ、FTS5 検索、編集	✅ 完了
2.5	マルチライブラリ、ファイル CRUD、表紙編集、Undo、ロック、命名、自動分類、PDF 取込	✅ 完了
2.5k	グリッド / リストのキーボードナビゲーション	✅ 完了
2.6a	スマートシェルフ MVP（条件式コレクション）	✅ 完了
2.6b	内蔵ビューア コアMVP（フルスクリーン、フィット / ズーム / パン、ページ送り、PDF / アーカイブ / フォルダ / 単一画像）	✅ 完了
2.6b-2	内蔵ビューア拡張（見開き表示、本ごとページ方向、スライドショー自動進行、続きから読む、巻末挙動 次の巻 / ループ、全画面で開く、HEIC / HEIF / TIFF / AVIF 対応）	✅ 完了
2.6c	初回起動ウィザード（内蔵 / 外部ビューア選択、内蔵ビューア初期設定、最初のライブラリ作成、設定から再表示）	✅ 完了
2.7	ブラッシュアップ＆性能（重複検出、フィールド / bookType ラベル カスタマイズ、ソート最適化、ビューアキー再割当 UI、複数命名フォーマットプリセット）	✅ 完了
2.8	ライブラリ保全（リンク切れ再指定、DB 自動バックアップ + 整合性チェック、NFC 正規化修正）	✅ 完了
2.9	DB 修復（アプリ内 .recover による破損データ救出、救出件数提示）	✅ 完了
4.0+	サーバ / クライアント（共有サーバ、Web ブラウザ / リーダー、ネイティブクライアント、オフライン DL、共有トークン［閲覧 / 編集 / 管理者 × scope］、リモート編集［メタ / スタンプ / 表紙: ページ選択、クロップ、外部画像を表紙に / リモート追加、削除 / 取り消し、やり直し（⌘Z / ⌘⇧Z）］、リモート閲覧のディスク永続キャッシュ + 先読み + 表紙キャッシュのサーバ追従、画面サイズに応じた画像配信、監視フォルダ自動取込（設定「取り込み」タブに統合）、内蔵ビューア インスタンス管理（重複起動防止、「複数ビューアの起動を許可」設定）、undo 忠実度（同時編集を上書きしない、ゴミ箱削除の取り消しはファイルも復元）、絞り込み時に一覧が自動で先頭へ、セキュリティ強化（リモート復元経由の任意ファイル移動を防止）、ローカルアクセス（CLI stacknest-cli / MCP mcp-stacknest / OpenAPI + Redoc） — v0.12.0 RC でリモート parity 実装完結）	✅ 完了
5.0+	ヘッドレス / Docker 対応（共有サーバを StackNest.app に依存せず常時稼働、コンテナ配布、デプロイ / 設定の整備）	⏳ 予定

凡例: ✅ 完了 / 🔄 進行中 / ⏳ 予定 / 🔭 将来構想

Phase 3（安定版リリース儀式）は本プロジェクトの方針に合わないため解体し、アイコン / ブランディング等の達成項目を各 Phase へ吸収しました。

リリースごとの変更点は CHANGELOG.md（English）を参照してください。

フィードバックとコミュニティ

質問、要望、不具合報告、活用例の共有は GitHub Discussions へどうぞ（質問は Q&A、要望は Ideas カテゴリ）。再現手順のあるバグは Issues でも受け付けます。

ライセンス

MIT — LICENSE を参照。

謝辞

• aroma 氏 / aromatics soft — オリジナル Stackroom の開発と、Swift での書き直しへの 明示的な後押しに感謝します。