zudo-stl-fix
GitHub リポジトリ

検索したい単語を入力

いつでも検索バーを開ける

保存

修正済みファイルの保存方法、命名規則、書き込み途中の失敗からの保護。

個別保存と一括保存

  • Repair ready の行にある Save… は、そのファイル1つを保存します。

  • Save Fixed Files… は、準備ができたすべての結果を保存します。準備ができた結果がないときは無効になります。

どちらも保存先フォルダの選択を求めます。保存先の選択は意図的な操作として設計されており、ファイルのチェック中にフォルダへのアクセス許可は必要ありません。

命名

既定の名前は <original-stem>-fixed.stl です。その名前がすでに使われている場合は、-fixed-2.stl、-fixed-3.stl のように順に試します。大文字と小文字の違いしかない名前も使用済みとして扱うため、大文字小文字を区別しないボリュームでの名前の衝突にも対応しています。既存のファイルが上書きされることはありません。

とても長い名前

保存先のファイルシステムが名前全体を保持できない場合(APFS では 1 つの名前につき 255 文字まで)、<stem>-fixed[-N].stl と <stem>-report[-N].json の両方が収まるまで、元のステムの末尾から文字単位で削り、末尾に残ったスペース、ドット、ハイフン、アンダースコアも取り除きます。修復した STL とそのレポートは同じ短縮後のステムを使い、-fixed や -report のラベル、番号、拡張子はそのまま残ります。

保存を安全に行うしくみ

  1. 検証済みの修復結果を、保存先フォルダ内のプライベートなステージング用フォルダに書き込みます。これにより、ステージング中のファイルと最終的なファイルが同じファイルシステム上に置かれます。

  2. 既存のエントリを置き換えることを拒否する方法で、新しい名前で公開します。

  3. 保存したファイルを、検証済みの修復結果のハッシュと照合して再チェックします。

いずれかの手順が失敗した場合、そのファイルは Saved にならず、ステージング用フォルダは片付けられ、誤解を招くような最終的な .stl は残りません。フォルダ内の既存ファイルが削除されることもありません。

そのため、読み取り専用などで書き込めない保存先を選んでもきれいに失敗します。行は「Save failed」というメッセージとともに Repair ready に戻るので、別のフォルダを選ぶか、もう一度試すことができます。

一括保存の場合

1つの保存が失敗しても、ほかの保存は妨げられません。一括保存の各ファイルはそれぞれ独立して成功または失敗し、各行にそれぞれの結果が表示されます。

保存後

保存済みの行にある Reveal ボタンで、Finder にファイルを表示できます。No repair needed のファイルについては、コピーが作られることはありません。

パッケージ化したアプリで確認済み

自動テストに加えて、保存パネル(ファイルごと・一括)、大文字小文字の違いを含む名前の衝突、読み取り専用の保存先、レポートの書き出し、Reveal in Finder を、macOS 27 の arm64 上でパッケージ化したアプリを実際に操作して確認しました。検証状況を参照してください。

Revision History

Takeshi Takatsudo作成: 2026-10-16T13:26:34+09:00更新: 2026-11-08T20:14:03+09:00