Shortlink Deliverable Portal — 純ASCII短縮リンク成果物ポータルCLI【無料MIT】
- Digital0 JPY

Shortlink Deliverable Portal — 純ASCII短縮リンク成果物ポータルCLI【無料MIT】 日本語のファイル名がついた成果物(HTML レポート、Markdown、PDF、テキスト)のフォルダを、チャットに貼りやすく、スマホでも開きやすい「純 ASCII の短縮リンク」つき静的サイトに変換する、無料のコマンドラインツールです(v1.0.0 / MIT ライセンス)。 Node.js 20 以上の標準ライブラリのみで動作します。npm の追加パッケージ・外部通信はなく、同じ入力からは常に同じ出力が得られます。 ■ 何をするか <入力>/report.html → <出力>/m/id/bcb3d7751f.html <入力>/notes/メモ.md → <出力>/m/id/61de69c60d.html(リダイレクト)+ m/f/61de69c60d.md <出力>/index.html(検索つき一覧)/ manifest.json(id → 元のパス) ・ID は、正規化した相対パス(スラッシュ統一・Unicode NFC)の SHA-256 の先頭 10 桁(16 進)です。 ・index.html は、インライン CSS/JS・絞り込み検索つきの自己完結ページです(CDN・外部フォントなし)。href と index.html の全バイトは ASCII です。 ・manifest.json は ID と元のパス・タイトル・SHA-256 を対応づけます。 ・ID が衝突した場合は、決定論的なルールで 12 桁・14 桁…へ伸ばして解決します。 ■ 安全面 ・「..」を含むパス、絶対パス、NUL バイト、空のパスを拒否します。 ・入力フォルダの外へ出るシンボリックリンクを拒否し、リンク先ディレクトリはたどりません。 ・出力フォルダの外へは書き込みません。 ■ 使い方(30 秒) node bin/shortlink-portal.mjs build deliverables site --title "Deliverables" node bin/shortlink-portal.mjs verify site node bin/shortlink-portal.mjs resolve site/manifest.json "/m/id/<10hex>.html" ・build / resolve / verify の 3 コマンド。--json で機械可読の出力ができます。 ・verify は manifest・ID の導出・ファイルの存在・SHA-256・ASCII のみの URL・manifest にないファイルなどを再検証します。 ・終了コード: 0 = 成功/1 = 安全でないパスの拒否・ID 未発見・検証の指摘/2 = 引数や入力の誤り ・JavaScript API(buildPortal / resolveId / verifyPortal / idFor)も使えます。 ■ 同梱内容(ZIP: free-04-shortlink-deliverable-portal-v1.0.0.zip) LICENSE(MIT)、README.md / README.ja.md、bin/shortlink-portal.mjs、src/portal.mjs、test/portal.test.mjs、package.json ■ 検証状況(Windows 11 / Node.js 24.14.0) ・同梱テスト 24 件中 23 件合格・失敗 0・1 件スキップ(シンボリックリンクの作成が許可されない環境ではスキップされる項目) ■ 制限事項(事前明記) ・静的サイトを作るツールです。ホスティング、ドメインをまたぐ短縮、リンクの期限切れ、アクセス保護は行いません。リンクを知っている人は誰でも開けます。ID はパスから決まるため、パスを知っている人には推測できます。機密ファイルの公開には使わないでください。 ・Markdown は描画されません。Markdown のリンクは生の .md ファイルへ転送され、スマホによっては表示ではなくダウンロードになります。 ・HTML のコピーは元のバイトのまま保持されるため、HTML 自身の外部参照はそのままです。「外部リソースなし」はツールが生成する index と転送ページに限った保証です。 ・ID は SHA-256 の 40 ビット分で、場所の目印であり、セキュリティ用のトークンではありません。 ■ ライセンス MIT ライセンス(同梱 LICENSE)。商用利用・改変・再配布が可能です。 ■ 関連ツール・上位版 有料の CLI ツールを含む他の作品はこちら: https://pikuto.booth.pm/
