クラウドブックマーク

クラウドブックマークは BookmarkSync の中核機能のひとつで、ブラウザのブックマークバーのスペースを占有することなく、ブックマークをクラウドに保存できる機能です。

機能概要

クラウドブックマークは、ブラウザのブックマークバーから独立したブックマーク保存領域を提供します：

• クラウド保存：ブックマークはクラウドサーバーに保存され、ブラウザのブックマークバーを占有しません
• 複数デバイス同期：同じアカウントでログインしたデバイス間でクラウドブックマークを自動同期
• 分類管理：ツリー状の分類構造に対応し、多階層のフォルダを作成できます
• 高速検索：タイトルと URL によるブックマーク検索に対応
• ドラッグ並べ替え：ブックマークと分類の表示順をカスタマイズできます
• 一括管理：ブックマークの一括移動・削除に対応

利用シーン

クラウドブックマークは以下のようなシーンに適しています：

• 予備 URL の保存：あまり使わないが残しておきたいサイト
• リソースのコレクション：学習資料、チュートリアル、ツールサイトなどの収集
• プロジェクトのリソース：プロジェクトごとに分類して関連サイトのリンクを保存
• ブックマークバーの整理：アクセス頻度の低いブックマークをクラウドに移し、ブックマークバーをすっきり保つ
• デバイスをまたいだアクセス：どのデバイスからでも完全なブックマークライブラリにアクセス

使い方

クラウドブックマークへのアクセス

1. ブラウザのツールバーにある BookmarkSync 拡張機能のアイコンをクリックします
2. ホーム画面で「クラウドブックマーク」カードを選択します
3. クラウドブックマークの管理ページが自動的に開きます

クラウドブックマークの追加

方法1：手動で追加

1. クラウドブックマークの管理ページで、右上の「ブックマークを追加」ボタンをクリックします
2. ブックマークの情報を入力します：
   • タイトル：サイト名または任意のタイトル
   • URL：完全な URL アドレス
3. 所属する分類を選択します（任意）
4. 確認して保存をクリックします

方法2：現在のページをすばやく追加

1. 拡張機能の Popup で「クラウドブックマーク」モジュールを選択します
2. 「現在のページを追加」をクリックします（この機能が提供されている場合）
3. 現在のタブのタイトルと URL が自動的に取得されます
4. 確認して保存します

分類管理

クラウドブックマークはツリー状の分類構造に対応しており、多階層のフォルダを作成してブックマークを整理できます。

分類の作成：

1. 右上の「分類を追加」ボタンをクリックします
2. 分類名を入力します
3. 上位の分類を選択します：
   • 空欄の場合は最上位の分類として作成されます
   • 既存の分類を選択した場合はその子分類として作成されます
4. 確認して作成をクリックします

分類の編集：

1. 「その他」のドロップダウンメニューをクリックし、「分類の編集」を選択します
2. 分類の編集画面では以下が可能です：
   • 分類名の変更
   • 分類の削除（確認が必要で、その分類下のすべてのブックマークも同時に削除されます）
   • 分類の階層関係の調整

分類の切り替え：

• 左側の分類ツリー内の任意の分類をクリックします
• 右側のコンテンツ領域に、その分類下のすべてのブックマークが表示されます
• 多階層の分類の展開/折りたたみに対応しています

ブックマークの操作

ブックマークの表示：

• 左側の分類ツリーで分類を選択します
• 右側にその分類下のブックマークがカード形式で表示されます
• 各ブックマークカードには、サイトアイコン、タイトル、URL が表示されます

ブックマークを開く：

• ブックマークカードのタイトルまたは URL の領域をクリックします
• 新しいタブでその URL が開きます

ブックマークの編集：

1. ブックマークカードの右側にある「操作」ボタンをクリックします
2. 「編集」を選択します
3. タイトルまたは URL を変更できます
4. 確認して保存をクリックします

ブックマークの移動：

1. ブックマークカードの「操作」ボタンをクリックします
2. 「移動」を選択します
3. 表示される分類選択画面で移動先の分類を選択します
4. 移動を確定します

ブックマークの削除：

1. ブックマークカードの「操作」ボタンをクリックします
2. 「削除」を選択します
3. 削除操作を確認します（元に戻せません）

並べ替え機能

ブックマークの並べ替え：

1. 右上の「その他」ドロップダウンメニューをクリックします
2. 「ブックマークの並べ替え」を選択します
3. 並べ替えモードに入り、ブックマークカードがドラッグ可能な状態になります
4. ブックマークカードをドラッグして順序を調整します
5. 「保存」ボタンをクリックして新しい順序を確定します

分類の並べ替え：

1. 「分類の編集」画面で
2. 分類ノードをドラッグして順序や階層を調整します
3. 変更を保存します

検索機能

1. 上部の検索ボックスにキーワードを入力します
2. 以下を検索できます：
   • ブックマークのタイトル
   • URL の内容
3. 「検索」ボタンをクリックするか Enter キーを押します
4. 一致したブックマークの一覧が表示されます
5. 「クリア」ボタンをクリックするかキーワードを削除すると、すべてのブックマークに戻ります

ページ送り

• ブックマークの数が多い場合は、自動的にページ送りで表示されます
• 下部にページ送りのコントロールが表示されます
• 別のページ番号に切り替えて、さらにブックマークを表示できます

ブラウザのブックマークとの違い

項目	ブラウザのブックマーク	クラウドブックマーク
保存場所	ブラウザのローカル + ブラウザの同期サービス	BookmarkSync クラウド
ブックマークバーを占有	する	しない
アクセス方法	ブラウザのブックマークバー/管理画面	拡張機能のページ
同期の要件	Google アカウントが必要（Chrome）	BookmarkSync アカウントのみ
保存上限	ブラウザの制限	1000 件（無料枠）
利用シーン	アクセス頻度の高いサイト	頻度は低いが残したいサイト

プライベートブックマークとの違い

項目	クラウドブックマーク	プライベートブックマーク
アクセス制限	ログインのみでアクセス可	二段階のパスワード認証が必要
セキュリティレベル	標準の暗号化	強化された暗号化 + パスワード保護
利用シーン	一般的なコレクション	機密/プライバシーに関わる内容
アクセスの手軽さ	高い	中程度（パスワード入力が必要）

保存枠について

• 無料枠：1000 件のブックマーク（分類フォルダ自体は含みません）
• 共有枠：クラウドブックマークとプライベートブックマークで 1000 件の枠を共有します
• カウント規則：
  • ブックマークのリンク 1 件ごとに 1 件としてカウントされます
  • 分類フォルダは枠にカウントされません
• 枠の確認：設定ページで現在使用中の枠を確認できます
• 超過時の扱い：1000 件を超えると、新しくブックマークを追加できなくなります

データ同期

自動同期

• アカウントにログインすると、クラウドブックマークのデータはクラウドと自動的に同期されます
• 追加、編集、削除の操作は即座にクラウドへアップロードされます
• 複数デバイス間で自動的に同期・更新されます

同期の状態

拡張機能は同期の状態を表示します：

• 正常：データは同期済みです
• 同期中：データをアップロードまたはダウンロードしています
• 競合：データの競合を検出しました（手動での対応が必要）
• ネットワーク切断：サーバーに接続できません

競合の処理

複数のデバイスが同時に同じブックマークを変更すると、競合が発生する場合があります：

1. 拡張機能がデータの競合を通知します
2. ローカルのバージョンかクラウドのバージョンを選択できます
3. または、2 つのバージョンの内容を手動でマージします

データの安全性

• 通信の暗号化：すべてのデータは HTTPS で暗号化して送信されます
• 暗号化保存：データはクラウドに暗号化して保存されます
• 鍵の分離：暗号化鍵とデータは別々に保存されます
• プライバシー保護：管理者はユーザーのブックマークの内容を閲覧できません

よくある質問

Q: クラウドブックマークとブラウザのブックマークは競合しますか？

A: いいえ。クラウドブックマークは独立した保存領域で、ブラウザ標準のブックマーク機能には影響しません。両方を同時に使用できます。

Q: ブラウザのブックマークをクラウドブックマークにインポートできますか？

A: 現在のバージョンでは、一括インポート機能には対応していません。よく使うブックマークを手動でクラウドブックマークに追加するか、今後のバージョンでインポート機能が提供されるまでお待ちください。

Q: クラウドブックマークはエクスポートできますか？

A: 現在のバージョンでは、エクスポート機能には対応していません。バックアップが必要な場合は、定期的にブックマーク一覧のスクリーンショットを保存することをおすすめします。

Q: 削除したクラウドブックマークは復元できますか？

A: 現在、ごみ箱機能には対応しておらず、削除したブックマークは復元できません。削除前に慎重に確認してください。

Q: クラウドブックマークのアイコンはどのように取得されますか？

A: 拡張機能がサイトの favicon から自動的に取得します。サイトにアイコンが設定されていない場合は、既定のリンクアイコンが表示されます。

Q: クラウドブックマークの読み込みが遅いのはなぜですか？

A: 考えられる原因：

• ネットワーク接続が不安定
• ブックマークの数が多すぎる（1000 件に近い）
• サーバーの応答が遅い

ネットワーク接続を確認するか、ページを再読み込みしてみてください。

Q: クラウドブックマークはブラウザの性能を消費しますか？

A: いいえ。クラウドブックマークのデータはクラウドに保存され、管理ページを開いたときのみ読み込まれるため、ブラウザの日常的な使用の性能には影響しません。

技術的な実装

クラウドブックマークは以下の技術構成で実装されています：

• モジュール名：cloudBookmark
• ルートパス：/cloudBookmark
• 主要コンポーネント：
  • E:\bookmark_chrome\src\modules\cloudBookmark\index.ts - モジュール定義
  • E:\bookmark_chrome\src\modules\cloudBookmark\popup.vue - Popup 画面
  • E:\bookmark_chrome\src\tab-app\views\user\Cloud.vue - 完全な管理ページ
  • E:\bookmark_chrome\src\utils\bookmark.ts - ブックマーク同期の中核ロジック
• データ保存：クラウドに保存し、RESTful API を介してサーバーとやり取りします
• 通信機構：Channel 通信システムによるコンポーネント間のメッセージ伝達
• API エンドポイント：
  • bookmarks/overideData - ブックマークデータの上書きアップロード
  • bookmarks/downloadData - クラウドのブックマークデータのダウンロード

開発者は以下のドキュメントで詳細な構成を確認できます：

• E:\bookmark_chrome\CLAUDE.md - プロジェクトの開発規約
• E:\bookmark_chrome\docs\ARCHITECTURE.md - アーキテクチャの説明
• E:\bookmark_chrome\docs\CORE_API.md - コア API リファレンス

ベストプラクティス

分類の整理のすすめ

• テーマ別に分類：「仕事」「学習」「娯楽」など
• プロジェクト別に分類：プロジェクトごとに独立した分類を作成
• 用途別に分類：「開発ツール」「デザインリソース」「参考資料」など
• 多階層の分類：サブ分類を適切に使い、1 階層の分類が多くなりすぎないようにする

命名のすすめ

• タイトルは簡潔明瞭に：検索しやすいよう説明的なタイトルを付ける
• 分類名の統一：中国語または英語など、命名スタイルを統一する
• 重複を避ける：定期的に確認し、重複したブックマークを統合する

メンテナンスのすすめ

• 定期的な整理：リンク切れのブックマークを削除する
• こまめな更新：サイトのアドレスが変わったらブックマークを更新する
• 適切な分類：ブックマークの増加に合わせて分類構造を調整する
• 重要なブックマークのバックアップ：特に重要なブックマークは、ブラウザのブックマークバーにも保存しておくことをおすすめします

次のステップ

• プライベートブックマークの機能については、プライベートブックマークのドキュメントをご覧ください
• 拡張機能のインストール方法については、インストールガイドをご覧ください
• 拡張機能の基本的な機能については、はじめにをご覧ください