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 を推奨します。
• ダウンロードのため完全なシェアリンクフラグメントを保持してください。
• ユーザーが明示的に要求しない限り、手動アドホックコマンドでスクリプトの組み込みパスサニタイズまたはトランスファークリーンアップ動作をバイパスしてください。