AIで作る請求書テンプレートのZIP、macOSの隠しファイルを止める合成見本

AIで作る請求書テンプレートのZIP、macOSの隠しファイルを止める合成見本

請求書テンプレートをZIPへまとめた直後、購入者が開く場所に商品と関係のない名前が並んでいたら困ります。中身が正しくても、最初に見える一覧が散らかると、使い始める前に不安を作ります。

ここではAIで作る請求書テンプレートを想定し、README.txtとinvoice-template.xlsxだけを渡す合成見本を試します。最初のZIPには.DS_Storeと__MACOSX/._invoice-template.xlsxも入れました。完成したZIPを読み直すと、4件中2件を不要な項目として止められました。

実在する購入者データ、実在の請求書、販売実績は使っていません。ファイル名も中身も、合成した見本。それでも、生成速度が上がるほど梱包の最後で確認したい境界は見えます。

圧縮の成功と、納品の成功を分ける

ZIPを作る処理が終了コード0で終わっても、販売物が整ったとは限りません。圧縮処理の役割は、入れた名前の保存だけ。購入者に不要な項目かどうかまでは判断しません。

商品として必要な名前は、2件だけに固定します。納品物の一覧。

[AIで下書きを作る]
          │
          ▼
[販売する2ファイルを選ぶ]
  ├── README.txt
  └── invoice-template.xlsx
          │
          ▼
[完成したZIPを開き直す]
          │
          ├── .DS_StoreがあればFAIL
          ├── __MACOSX/以下があればFAIL
          └── それ以外は次の人手確認へ

この見本では、ここを「圧縮に成功したか」ではなく、「購入者の画面に不要な名前が出ないか」を分ける場所にします。AIが増やすのは作業中の候補。納品物の一覧は、人が狭く決めます。

4件のZIPを作り、2件を検出する

次のコードは、余計な項目を含むbefore.zipと、商品だけを含むafter.zipを一時ディレクトリに作ります。hidden_members()は完成したZIPをnamelist()で開き、.DS_Store、__MACOSX/、._で始まる名前を検出します。

from pathlib import PurePosixPath, Path
from zipfile import ZIP_DEFLATED, ZipFile

root = Path(__file__).parent
before = root / "before.zip"
after = root / "after.zip"

with ZipFile(before, "w", ZIP_DEFLATED) as archive:
    archive.writestr("README.txt", "請求書テンプレートの使い方\n")
    archive.writestr("invoice-template.xlsx", "synthetic workbook\n")
    archive.writestr(".DS_Store", "synthetic metadata\n")
    archive.writestr("__MACOSX/._invoice-template.xlsx", "synthetic resource fork\n")

with ZipFile(after, "w", ZIP_DEFLATED) as archive:
    archive.writestr("README.txt", "請求書テンプレートの使い方\n")
    archive.writestr("invoice-template.xlsx", "synthetic workbook\n")

def hidden_members(path: Path) -> list[str]:
    with ZipFile(path) as archive:
        names = archive.namelist()
    return [
        name for name in names
        if name.startswith("__MACOSX/")
        or PurePosixPath(name).name == ".DS_Store"
        or PurePosixPath(name).name.startswith("._")
    ]

for path in (before, after):
    with ZipFile(path) as archive:
        entries = archive.namelist()
    hidden = hidden_members(path)
    gate = "FAIL" if hidden else "PASS"
    print(f"{path.name}: GATE={gate} entries={len(entries)} hidden={len(hidden)}")
    for name in hidden:
        print(f"  {name}")

空の一時ディレクトリへrun.pyとして保存して実行しました。

python3 "$TMPDIR/zip-hidden-file-gate/run.py"

実行結果です。

before.zip: GATE=FAIL entries=4 hidden=2
  .DS_Store
  __MACOSX/._invoice-template.xlsx
after.zip: GATE=PASS entries=2 hidden=0

最初のZIPは壊れていません。だからこそ見落としやすい失敗です。4件すべてを圧縮できたことと、2件だけを渡すべきことは別の条件でした。圧縮の成否とは別の、納品の条件です。

検出した名前を削除すれば終わり、という検査にもなりません。このコードは、.DS_Store、__MACOSX/、._という限定した形だけを見ています。別の不要なファイルや、商品の中身が正しいかどうかは、人が確認する範囲です。検査対象を短く書き、見ない範囲も混ぜないこと。その方が、PASSの意味を広げすぎません。

after.zipは2件だけです。ここでPASSになっても、請求書テンプレートの計算式や説明文の正確さまでは保証しません。梱包の検査は、内容確認の代わりではありません。

除外リストより、完成物をもう一度見る

.DS_Storeだけを取り除けばよい、と決めると次の不要な名前を見落とします。反対に、販売ファイルの名前を先に決めれば、作業中に新しいファイルが増えても確認する対象がぶれません。

この見本で大切なのは、作業フォルダを見ないことです。完成したZIPを開き直します。作成処理と検査処理を同じ成功にまとめないためです。

Python標準ライブラリのzipfileは、ZIPの作成、読み書き、一覧取得を扱えます。追加パッケージを入れずに、作成したアーカイブのnamelist()を読み戻せます。

販売前に残す確認は3つでよい

  1. 購入者へ渡すファイル名を先に書き出します。
  2. ZIPを作った後に、ZIPの中の名前を全件読みます。
  3. 不要な項目が1件でもあれば、販売候補へ進めません。

この3つは、AIが作った本文、表計算、説明書のどれにも使えます。対象の種類は3つ。生成物が増えるほど、最後に渡すファイル名は短く保つ方が確認しやすくなります。

今回のFAILは、隠しファイルが入ったことそのものより、圧縮に成功した表示だけを見て判断しそうだった点を示します。この見本では、AIに作業を広げてもらい、納品する一覧だけは狭く固定します。その小さな切り分けが、デジタル商品の初回利用を静かにします。

一次情報

この記事をシェア