ブラウザー内でのローカル救出

ブラウザーがすでに受信したものを、ローカルに保存します。

Triluna Document Rescue は、ブラウザーに届いた、または表示された文書データやページを保存するために開発中です。通常のビューアーが提供するアクセス範囲を守り、プレビューしかない場合に元ファイルだとは主張しません。

ローカル開発環境

現在のソースは開発用であり、ブラウザーへインストールするものではありません。

ローカルの開発マシンで Triluna リポジトリを開きます。
triluna-document-rescue/ を開き、そのサブプロジェクトの README に従ってソースの準備とチェックを行います。
コアパッケージをブラウザー拡張として読み込まないでください。このローカル作業には Chrome または Safari 用のブラウザーパッケージはありません。

Chrome と macOS 上の Safari は引き続き対象です。Safari は一部のキャプチャ方法で拡張機能の能力が限られます。インストール手順やリリースを公開する前に、各ブラウザービルドで実際の対応範囲を検証し明記する必要があります。

キャプチャモード

Standard と Chrome Advanced では権限の境界が異なります。

Standard: 予定されている Standard ビルドは、Chrome の debugger 権限を必要としないブラウザー機能を使います。選択したビルドが適法に確認できる内容だけを保存でき、実際の対応範囲はそのビルドで確認する必要があります。
Chrome Advanced: Chrome Advanced ビルドでは、マニフェストに debugger 権限が必須です。この権限でタブにデバッグ機能を接続し、ネットワーク動作を調べられるため、Chrome は強い権限として警告します。ユーザーが Advanced を選び、Chrome の権限確認を承認する必要があります。そのビルド内で任意の権限として表示することはできません。実装は選択されたタブに有効なキャプチャ中だけ接続し、終了時に切断する必要があります。

ここでは Advanced ブラウザービルドを提供していません。この説明は設計上の境界であり、ネットワークキャプチャが利用可能という意味ではありません。

書き出し前に来歴を確認

保存したプレビューを元ファイルとして扱うことはありません。

ORIGINAL: 完全な元データを受信し、バイト単位でそのまま保存したものです。
RECONSTRUCTED: ビューアーがすでに公開したページ素材、画像、HTML、SVG から新しいファイルを組み立てたものです。
CAPTURED: ページまたは canvas に表示されたピクセルを保存したものです。テキスト、メタデータ、ベクター、添付ファイル、注釈が含まれない場合があります。

来歴区分は書き出し前に表示し、任意のサイドカーマニフェストに記録します。救出された成果物は、利用できる範囲で元文書の寸法と外観を保つユーザー由来のファイルです。TDS のページ出力要件の対象外であり、Triluna の出版物に見えるよう再スタイルしません。

プライバシーと一時データ

文書本文は Triluna に送信されません。

ブラウザー中立のコアには Triluna へのアップロード経路がありません。文書本文が Triluna に送信されることはありません。今後のブラウザービルドでは作業データをブラウザー内に保存し、「一時救出データを消去」する操作を用意し、放置された不完全なキャプチャを削除する必要があります。現在のコアのみのソースにはブラウザー保存や消去機能は実装されていません。

ブラウザーの保存容量には上限があり、大きなキャプチャは容量不足で停止することがあります。Safari の拡張機能能力が限られることで、ビルドが確認できる素材も制限される場合があります。救出を頼りにする前に、使用するブラウザービルドの制限を確認してください。

Dropbox は、キャプチャやローカル保存とは別の任意の書き出し先です。アップロードには別途ユーザーの認可と明示的な書き出し操作が必要です。ブラウザー互換性と提供状況はプラットフォーム検証待ちであり、ここでは Dropbox の提供を約束しません。

適法なアクセス

保持する権利がある資料だけを保存してください。

Document Rescue は、自分が所有する資料、アクセスを許可された資料、または適法に保存できる資料に限って使用してください。サインイン、CAPTCHA、支払い、会員資格、ダウンロード上限、地域制限、DRM、その他のアクセス制御を回避してはなりません。非公開ページ、非公開オブジェクト ID、推測したエンドポイントを探ってはなりません。

Baidu Pan または Quark Pan では通常のビューアーと画面上の操作を使用してください。許可されたビューアーが利用可能にしたページや素材のみを保存し、非公開エンドポイントを使ったり、アカウントの権利を変更したりしません。