xdrop

このスキルディレクトリ内の同梱スクリプトを使用してください。

利用可能なスクリプト

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

環境要件：

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

アップロード

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

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

• --quiet：進行状況の出力を抑制し、標準出力をクリーンに保ちます
• --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：進行状況の出力を抑制し、標準出力をクリーンに保ちます
• --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 を求めてください。
• 別のコマンドや呼び出し元で標準出力を取得する必要がある場合は、--quiet を使用してください。進行状況のログはそれ以外の場合、標準エラー出力に送られますが、最終結果も重要です。

ガードレール

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