編集方針

この開発記録は、zxell.ai プロジェクトで実際にやり取りしている作業報告(review)を、公開用に編集したものです。各回は「報告 → 確認事項 → アーキテクトの回答(⇒)」の往復になっていて、何を、なぜそう決めたかが残るようにしています。

原文の扱い

• 原文を尊重し、削るだけにしています。 言い回しの書き換えや要約のし直しはしていません
• 削った箇所には「省略: (理由)」の印を残しています
• ただし、サーバ上のパスや接続先などは、文が通じるように「サーバのストレージ」のような役割名に置き換えている箇所があります
• アーキテクトの回答(⇒)は原文のままです

省略している内容

• サーバの構築・運用の詳細: HTTPS・DNS・リバースプロキシ・サービス設定・ネットワーク構成など
• セキュリティに関わる情報: アドレス、パス、ホスト名、ユーザー名、認証情報の置き場所と扱い方
• 障害対応の記録: 2026 年 8 月にサーバのハードウェア故障があり、その期間の記録の大半を省略しています(下記)
• コーパスの詳細: コーパスの詳細・引用は載せていません
• 個人的な事情: 機材の購入予定や生活上のできごと

2026 年 8 月: サーバのハードウェア故障と作り直し

前処理の途中で、旧サーバのメモリ(RAM)が故障し、その期間に作った中間ファイルが静かに壊れていたことが分かりました。コーパスの原本は無事だったため、新しいサーバに移ったうえで、スナップショットとトークナイザから全工程をやり直しています。この経験から、前処理のすべての工程で「書き込んだ直後に読み直して検証する」ことを必須にしました。

公開しているもの・していないもの

• 公開: コード(GitHub・GPL-3.0)と、この開発記録
• 非公開: モデルの重み、学習データとその統計の詳細、運用ダッシュボード
• 本プロジェクトは closed 運用です。学習データは、プロジェクト自身が管理するマシンにだけ、トークン化・シャッフル済みのシャードとして配布しています