0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

改稿は終わっていた。確認用コピーは旧稿のままだった

0
Posted at

技術記事を改稿し、ローカルの完了記録には更新後のhashも残っていました。しかし、確認用に渡していたクラウドのコピーは、以前の原稿のままでした。

URLが同じでも、そこにある本文まで同じとは限りません。今回の不一致は、原本の改稿と、確認用コピーへの反映を別々に照合したことで見つかりました。

ファイル名とURLでは、どの版か分からない

2026年10月20日の保存記録では、ローカルの改稿は5,387 bytes、確認用コピーは3,171 bytesでした。改稿では検証範囲を追記していましたが、確認用コピーにはその前の説明が残っていました。

確認用コピーの全文を、保存していた旧稿と比較すると一致しました。一方、現行のローカル稿は、改稿完了時のSHA-256と一致しました。

この照合から確認できたのは、「ローカルでの改稿は存在する」「渡したコピーは旧稿と同じ」という2つの状態です。URLが開くことや、同じファイル名であることでは、両者を区別できませんでした。

原本・渡す版・読み戻した本文を分ける

今回のようなUTF-8のMarkdownでは、少なくとも次の3つを区別します。

対象 役割
現行の原本 編集を続ける資料
照合する原稿スナップショット 今回どの本文を渡すかの基準
確認用コピーから読み戻した本文 受渡し先に何があるかの観測

当時の照合では、確認用コピーを更新した後、読み戻した文字列をUTF-8へ戻し、原稿スナップショットの全バイトと比較しました。報告された保存サイズも5,387 bytesで一致し、SHA-256も同じでした。

考え方を簡略化すると、次の確認です。取得APIやエラー処理を省いた説明用の擬似コードであり、配布用ツールを新しく検証したものではありません。

expected = 今回渡す原稿スナップショットのバイト列
observed = 確認用コピーから読み戻した全文をUTF-8へ変換

observed と expected の全バイトが一致することを確認
報告された保存サイズと expected の長さも比較
照合した本文のSHA-256と確認時刻を記録

この記録を、クラウドの生ファイルをバイナリとして再取得した試験と混同しません。今回の根拠は、読み戻したUTF-8本文と保存サイズの照合です。

本文を更新しても、履歴と共有範囲は別に確認する

更新前のコピーが保存済み旧稿と一致することを確認してから、同じファイルIDの内容を更新しました。新しい公開リンクや共有先は作っていません。

保存記録では、更新前後でファイル名・ID・保存先・非共有の権限状態を保持しています。旧版が履歴に残っていることだけでなく、その旧版を読み戻して、保存した旧稿と全文一致することも確認しました。

これは、この操作時点で旧版を読めたという確認です。履歴が無期限に残る保証にはしません。また、更新前の比較は原子的な排他制御ではありません。照合から書込みまでの間に別の編集が入る場合を、安全に処理できると実証したものでもありません。

他の編集と食い違う本文が見つかった場合には、古いコピーだと決めつけて置き換える根拠が足りません。双方の内容を保持し、どちらを使うか確かめる必要があります。成否不明時に自動で再送しないことも運用上の方針であり、今回ネットワーク障害を注入して試験した結果ではありません。

本文の一致を、内容確認や公開承認にしない

SHA-256や全文比較は、どの本文を渡したかを確かめる道具です。書かれた事実が正しいこと、文章が読みやすいこと、著者が公開を承認したことは、別の確認です。

今回の記事は、10月20日の保存済み操作記録・読み戻し本文と、現在保管している原稿を再照合してまとめました。現在のクラウド状態を新しく取得したものではなく、記事内で扱う開発試験も再実行していません。

原本を改稿したら、確認用のコピーも更新されたはず。その推測を完了条件にせず、渡す版と読み戻した本文を結び付けて記録する。今回は、その小さな照合で受渡しの不一致を解消できました。

操作時の照合処理、保存記録の整理、および本稿の整理・執筆にはAIを使用しています。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?