xdrop

Xdrop

このスキルディレクトリに含まれるスクリプトを使用します。

利用可能なスクリプト

• scripts/upload.mjs — ローカルのファイルまたはディレクトリを Xdrop サーバーにアップロードし、共有リンクを出力します
• scripts/download.mjs — Xdrop の共有リンクからダウンロードし、ローカルで復号してファイルを保存します

環境要件：

• Bun
• ローカルファイルシステムへのアクセス
• 対象の Xdrop サーバーへのネットワークアクセス

アップロード

bun scripts/upload.mjs --server <xdrop-site-url> <file-or-directory> [...]

必要に応じて、次のフラグを優先して使用してください。

• --quiet：進行状況の出力を抑制し、stdout をクリーンに保ちます
• --json：transferId、shareUrl、expiresAt を返します
• --expires-in <seconds>：対応している有効期限を指定します
• --api-url <url>：デフォルトの <server>/api/v1 を上書きします
• --name <value>：転送の表示名を設定します
• --concurrency <n>：ファイルごとの並列アップロード数を制限します

便利な使用例：

bun scripts/upload.mjs --server http://localhost:8080 ./dist/report.pdf
bun scripts/upload.mjs --server http://localhost:8080 --quiet ./archive.zip
bun scripts/upload.mjs --server http://localhost:8080 --expires-in 600 --json ./notes.txt

ユーザーが検証を希望する場合は、小さな一時ファイルをアップロードしてから、公開転送 API またはブラウザーで返されたリンクを開けることを確認してください。

ダウンロード

#k=... を含む完全な共有リンクが必要です。フラグメントキーがないと、転送データを復号できません。

bun scripts/download.mjs "<share-url>"

必要に応じて、次のフラグを優先して使用してください。

• --output <dir>：保存先ディレクトリを指定します
• --quiet：進行状況の出力を抑制し、stdout をクリーンに保ちます
• --json：transferId、outputRoot、保存したファイルのパスを返します
• --api-url <url>：デフォルトの <share-origin>/api/v1 を上書きします

便利な使用例：

bun scripts/download.mjs "http://localhost:8080/t/abc123#k=..."
bun scripts/download.mjs --output ./downloads "http://localhost:8080/t/abc123#k=..."
bun scripts/download.mjs --quiet --json --output ./downloads "http://localhost:8080/t/abc123#k=..."

デフォルトでは、ダウンローダーは ./xdrop-<transferId> に書き込み、マニフェストの相対パスを保持します。

注意事項

• #k=... フラグメントのないダウンロードリンクは復号できません。元の完全な共有 URL を求めてください。
• 別のコマンドや呼び出し元が stdout を取得する必要がある場合は、--quiet を使用してください。進行状況のログはそれ以外の場合 stderr に出力されますが、最終結果も重要です。

安全上の注意

• 別のコマンドやスクリプトが stdout を取得する必要がある場合は、--quiet を優先して使用してください。
• ダウンロード時は、共有リンクのフラグメントを完全な状態で保持してください。
• ユーザーから明示的に求められない限り、手動の場当たり的なコマンドを使って、スクリプトに組み込まれているパスのサニタイズや転送データのクリーンアップ処理を回避しないでください。