Help Center

ヘルプセンターHelp Center

よくある質問とトラブルシューティング。解決しない場合は下部の連絡先へ。Frequently asked questions and troubleshooting. Contact links are at the bottom.

はじめにGetting started

どんなプロジェクトで使えますかWhich projects can I use it with?

dvyu preview は Storybook / Astro / Vite プロジェクトのビルドからプレビュー作成までを 1 コマンドで実行します。それ以外でも、HTML ファイルを含む静的ビルドディレクトリや単一の HTML ファイルがあれば dvyu create でプレビューを作成できます。

dvyu preview builds Storybook, Astro, and Vite projects and creates the preview in one command. For anything else, dvyu create works with any static build directory or single HTML file, as long as it contains an HTML file.

CLI の表示言語を変えたいHow do I change the CLI language?

dvyu lang ja または dvyu lang en を実行します。引数なしの dvyu lang で現在の設定を確認できます。設定は ~/.dvyu/settings.json に保存されます。

Run dvyu lang ja or dvyu lang en. Running dvyu lang without an argument shows the current setting. It is stored in ~/.dvyu/settings.json.

URLを変えずに中身だけ更新したいHow do I update the content without changing the URL?

dvyu update を使います。最新のローカルプレビューを URL 変更なしで更新するので、送ったリンクはそのまま使えます。dvyu update ./dist のようにパスを、dvyu update <id> ./dist のように ID も指定できます。recreate は URL が変わる点に注意してください。

Use dvyu update. It updates the latest local preview without changing its URL, so links you already shared keep working. You can pass a path like dvyu update ./dist, or an id like dvyu update <id> ./dist. Note that recreate changes the URL.

プレビューの問題Preview issues

プレビューURLを開くと期限切れと表示されるThe preview URL says it has expired

通常のプレビューは作成から 48 時間で失効し、期限切れのプレビューは閲覧できません。dvyu list で有効なプレビューと期限を確認できます(期限切れの履歴は dvyu list all)。同じ内容を再共有するには dvyu recreate で新しい URL を作成してください。サポーターは --ttl で最長 30 日、-p で永続プレビューを作成できます。

Standard previews expire 48 hours after creation, and expired previews are no longer viewable. Run dvyu list to check active previews and expiry (dvyu list all includes expired history). To share the same content again, run dvyu recreate to create a new URL. Supporters can set up to 30 days with --ttl or create permanent previews with -p.

画像やCSSが読み込まれないImages or CSS do not load

静的サイトは相対アセットパスでビルドするのが理想です。手動でビルドする場合は vite build --base=./ を使ってください。Astro は通常どおり astro build でビルドすれば、/_astro/... のような root path は viewer 側で補完されます。外部 origin への完全な絶対 URL はそのまま扱われるため、プロジェクト側の調整が必要になる場合があります。

Build static sites with relative asset paths when possible. For manual builds, use vite build --base=./. Astro can be built normally with astro build; the viewer rewrites root paths such as /_astro/.... Fully absolute URLs to external origins are left as-is and may need project-side adjustment.

送ったURLを無効化したいHow do I revoke a URL I already shared?

dvyu delete <id> でプレビューを削除します。ID は dvyu list で確認できます。この端末で作成したプレビューをすべて削除するには dvyu delete all を使います。削除したプレビューは閲覧できなくなります。

Run dvyu delete <id>. You can find the id with dvyu list. To remove every preview created from this device, run dvyu delete all. Deleted previews are no longer viewable.

アップロードの問題Upload issues

「Unsupported files were found」で止まるUpload stops with "Unsupported files were found"

対応していない拡張子のファイルが含まれると、アップロードは開始前に中止されます。.DS_Store.gitkeepThumbs.db などのよくあるメタファイルは自動で無視されます。それ以外の非対応ファイルは、CLI の確認に応じて除外して続行できます。対応拡張子の一覧はドキュメントを参照してください。

Uploads stop before starting if files with unsupported extensions are found. Common metadata files such as .DS_Store, .gitkeep, and Thumbs.db are ignored automatically. For other unsupported files, the CLI can exclude them after confirmation. See the docs for the full extension list.

アップロードが遅い、または失敗するUploads are slow or fail

暗号化完了後のファイル送信は既定で 6 並列です。回線や proxy の制約がある場合は、環境変数 DVYU_UPLOAD_CONCURRENCY1 から 16 を指定して調整できます。例: DVYU_UPLOAD_CONCURRENCY=3 dvyu create ./dist

Ciphertext files upload with a default concurrency of six. If a connection or proxy needs a different limit, set the DVYU_UPLOAD_CONCURRENCY environment variable from 1 to 16. Example: DVYU_UPLOAD_CONCURRENCY=3 dvyu create ./dist

HTMLファイルがないと言われるThe CLI says there is no HTML file

create に渡すファイルまたはディレクトリには HTML ファイルが必要です。エントリーポイントは index.html を優先し、なければ最初の .html ファイルを使います。ビルド出力のパスが正しいか、index.html が生成されているかを確認してください。

The file or directory passed to create must contain an HTML file. index.html is preferred as the entrypoint; otherwise the first .html file is used. Check that the build output path is correct and that it produced an index.html.

上限とサポーターLimits and supporter

100MB / 20件の上限に達したI hit the 100MB or 20 preview limit

dvyu usage で使用中の容量とプレビュー数を確認し、不要なプレビューを dvyu delete <id> で削除してください。上限を広げたい場合は、Ko-fi での支援で 30 日間、容量 300MB・アクティブ数無制限のサポーター特典が有効になります。

Check current usage with dvyu usage and delete previews you no longer need with dvyu delete <id>. To raise the limits, supporting on Ko-fi enables 30 days of supporter benefits: 300MB storage and unlimited active previews.

サポーター特典が反映されないSupporter benefits are not applied

初回の端末登録には、支援前に dvyu supporter start で発行したコードが必要です。表示された DVYU-... コードを Ko-fi 支払い時の非公開メッセージへ含めてください。コードの有効期限は 24 時間です。状態は dvyu supporter status で確認できます。

The initial device registration requires a claim code created with dvyu supporter start before supporting. Include the displayed DVYU-... code in the private message for the Ko-fi payment. The code expires after 24 hours. Check the status with dvyu supporter status.

支援時にコードを入力しそびれたI forgot to include the code when I supported

dvyu supporter recover を実行し、Ko-fi で使用したメールアドレスを入力してください。未紐付けの支払いと一致すると、15 分有効の認証リンクが届きます。リンク先で「この端末を登録」を押すと完了し、再支援は不要です。特典期限は認証日ではなく元の支援日から 30 日間です。入力したメールアドレスは送信のため Resend へ渡され、サーバーには平文ではなく HMAC hash を保存します。

Run dvyu supporter recover and enter the email address used for Ko-fi. If it matches an unclaimed payment, you will receive a verification link valid for 15 minutes. Open it and select “Register this device” to finish; you do not need to support again. Benefits expire 30 days after the original payment, not 30 days after verification. The email address is sent to Resend for delivery, while the server stores only an HMAC hash rather than the plaintext address.

2台目のデバイスで特典を使いたいHow do I use the benefits on a second device?

1 台目で dvyu supporter recovery を実行して recovery token を表示し、2 台目で dvyu supporter link <recovery-token> を実行します。登録できる端末は同時に 2 台までです。recovery token は端末を特典へ登録できる秘密情報なので、パスワードと同様に扱ってください。

Run dvyu supporter recovery on the first device to show the recovery token, then run dvyu supporter link <recovery-token> on the second. At most two devices can be linked at once. Treat the recovery token like a password because it can link a device to the benefits.

支援期間が終わるとどうなるWhat happens when the supporter period ends?

新しい -p / --ttl 付きプレビューは作成できなくなります。既存の永続プレビューは直ちに削除されませんが、アクセスによる期限延長を停止し、その時点の削除予定日までは閲覧できます。再支援で既存の特典期限が短くなることはありません。

New previews cannot use -p or --ttl. Existing permanent previews are not deleted immediately, but access no longer extends their expiry and they remain available only until the currently scheduled deletion time. A later payment never shortens an existing entitlement.

データとセキュリティData and security

プレビューは誰が見られますかWho can view a preview?

URL を知っている人だけが閲覧できます。復号キーは URL の #k= fragment に含まれ、HTTP リクエストでは送信されません。プレビューリンクは信頼できる相手への一時共有を想定しているため、リンクは公開せず、必要な相手にだけ共有してください。

Only people who have the URL. The decryption key lives in the #k= fragment and is never sent in an HTTP request. Preview links are intended for temporary sharing with trusted recipients, so keep them private and share them only with the people who need them.

サーバーには何が保存されますかWhat is stored on the server?

ファイル内容と manifest は、CLI が AES-256-GCM でローカル暗号化してからアップロードします。サーバーは元のファイル内容・ファイル名・MIME type・entrypoint・AES 鍵を受け取りません。一方、運用に必要な preview ID、device ID、合計サイズ、ファイル数、作成・アクセス日時、有効期限、保持モードは暗号化されずに保存します。暗号化設計と検証手順は docs/ENCRYPTION.ja.md を参照してください。

The CLI encrypts file contents and the manifest locally with AES-256-GCM before upload. The server does not receive original file contents, filenames, MIME types, the entrypoint, or the AES key. Operational metadata remains unencrypted, including the preview and device ids, aggregate sizes, file count, creation and access times, expiry, and retention mode. See docs/ENCRYPTION.md for the encryption design and executable verification.

アンインストールしたいHow do I uninstall?

dvyu uninstall で、ローカルに保存された Drovyu Preview のデータ(~/.dvyu 以下)を削除します。CLI 本体はインストールに使ったパッケージマネージャで削除してください(例: pnpm remove -g dvyu)。

Run dvyu uninstall to remove local Drovyu Preview data under ~/.dvyu. Remove the CLI itself with the package manager you installed it with, such as pnpm remove -g dvyu.

解決しない場合Still stuck?

不具合報告・要望・質問は以下からどうぞ。Bug reports, requests, and questions are welcome through any of these.

コピーしましたCopied