Clarify checkpoint publication status and historical lineage

README.ja.md

@@ -4,7 +4,7 @@
 
 `virtual-fly`は、成体オスのショウジョウバエの公開MaleCNSコネクトームを初期状態として、神経活動・神経修飾・局所シナプス可塑性を時間発展させ、FlyBody / MuJoCoの身体と物理環境に閉ループ接続する研究プロジェクトです。
 
-このHugging Faceリポジトリでは、`virtual-fly`の概要と、公開するチェックポイントリポジトリの構成をまとめています。ソースコード、科学的な説明、canonical実験のmanifest、一連の再現スクリプトはGitHubにあります。
+このHugging Faceリポジトリでは、`virtual-fly`の概要と、初回公開に向けて準備しているチェックポイントリポジトリの構成をまとめています。ソースコード、科学的な説明、canonical実験のmanifest、一連の再現スクリプトはGitHubにあります。
 
 - GitHub: https://github.com/shute2004/virtual-fly
 - 英語文書: https://github.com/shute2004/virtual-fly/tree/main/docs/en
@@ -13,7 +13,7 @@
 
 ## チェックポイントの配布構成
 
-公開するチェックポイントには、明確に異なる2つの系統があります。**動画用のBefore / Afterをcanonical v1の初期・学習後チェックポイントとして扱わないでください。**
+公開準備中のチェックポイントには、明確に異なる2つの系統があります。以下の4リポジトリはまだ作成・公開していません。**動画用のBefore / Afterをcanonical v1の初期・学習後チェックポイントとして扱わないでください。**
 
 ### Canonical v1
 
@@ -35,11 +35,11 @@ canonical v1の科学計算部分はGit commit `7fa464aad7269d34f46f1171080b51e0
 | Before | `shute2004/virtual-fly-video-before` | 公開したBefore / After比較動画のBefore側で実際に使用した過去系統のチェックポイント |
 | After | `shute2004/virtual-fly-video-after` | 同じ動画のAfter側で実際に使用した過去系統のチェックポイント |
 
-これらの内部開発版は来歴情報として`v240`と`v966`ですが、公開リポジトリ名には出していません。現在のcanonical v1とは実験系統・来歴・一部の実行時の意味づけが異なるため、**canonical v1の証拠ではありません**。
+これらの内部開発版は来歴情報として`v240`と`v966`ですが、公開リポジトリ名には出しません。Before側のv240は未学習の初期状態ではなく、すでに240エピソードの過去学習を経ています。再生はホールドアウト評価ではなく、可塑性を停止した状態でも課題イベントによるPAM刺激は有効でした。v966も複数の過去条件が混在した系統です。したがって、これらは**canonical v1の証拠ではありません**。
 
 ## Hugging Faceに置くもの
 
-各チェックポイント用リポジトリには、チェックポイント本体に加えて、必要最小限の来歴情報、ハッシュ値、帰属情報、モデルカードを置きます。研究用作業環境全体を複製するものではありません。
+公開時には、各チェックポイント用リポジトリにチェックポイント本体と、必要最小限の来歴情報、ハッシュ値、帰属情報、モデルカードを置きます。研究用作業環境全体を複製するものではありません。
 
 原則として置かないもの:
 

README.md

@@ -20,7 +20,7 @@ tags:
 
 `virtual-fly` is a research project that starts from the released adult male Drosophila MaleCNS connectome and evolves neural activity, neuromodulation, and local synaptic plasticity in closed loop with a FlyBody / MuJoCo body and a physical environment.
 
-This Hugging Face repository provides an overview of `virtual-fly` and describes the checkpoint repositories used to distribute its released checkpoints. Source code, scientific documentation, canonical manifests, and the end-to-end reproducer live on GitHub:
+This Hugging Face repository provides an overview of `virtual-fly` and describes the checkpoint repositories prepared for the first public checkpoint release. Source code, scientific documentation, canonical manifests, and the end-to-end reproducer live on GitHub:
 
 - GitHub: https://github.com/shute2004/virtual-fly
 - English documentation: https://github.com/shute2004/virtual-fly/tree/main/docs/en
@@ -29,7 +29,7 @@ This Hugging Face repository provides an overview of `virtual-fly` and describes
 
 ## Checkpoint repositories
 
-Two distinct lineages are published. **Do not treat the historical video pair as the canonical initial/trained pair.**
+The prepared checkpoint release has two distinct lineages. The four checkpoint repositories listed below are not created or public yet. **Do not treat the historical video pair as the canonical initial/trained pair.**
 
 ### Canonical v1
 
@@ -49,11 +49,11 @@ Canonical v1 is pinned to scientific Git commit `7fa464aad7269d34f46f1171080b51e
 | Before | `shute2004/virtual-fly-video-before` | Exact historical checkpoint used for the Before side of the published comparison video |
 | After | `shute2004/virtual-fly-video-after` | Exact historical checkpoint used for the After side of the published comparison video |
 
-The historical cards record their internal development versions (`v240` and `v966`) as provenance, but those numbers are intentionally not used in the public repository names. These checkpoints come from older experiment lineages and are **not canonical v1 evidence**.
+The historical cards record their internal development versions (`v240` and `v966`) as provenance, but those numbers are intentionally not used in the public repository names. The Before checkpoint is already a historically trained v240 state, not an untrained initial state; the playback was not held out and retained task-triggered PAM stimulation while plasticity was off. The v966 checkpoint belongs to a mixed older lineage. These checkpoints are **not canonical v1 evidence**.
 
 ## What is hosted here
 
-The checkpoint repositories contain checkpoint files plus lightweight provenance, hashes, attribution, and a model card. They do not mirror the full research workspace.
+When published, the checkpoint repositories will contain checkpoint files plus lightweight provenance, hashes, attribution, and a model card. They do not mirror the full research workspace.
 
 Not hosted here by default:
 

README.zh-CN.md

@@ -4,7 +4,7 @@
 
 `virtual-fly` 是一个研究项目：以成年雄性果蝇公开的 MaleCNS 连接组作为初始状态，让神经活动、神经调制和局部突触可塑性随时间演化，并与 FlyBody / MuJoCo 身体及物理环境形成闭环。
 
-这个 Hugging Face 仓库用于介绍 `virtual-fly`，并说明各个检查点仓库的发布结构。源代码、科学说明、canonical 实验清单以及完整复现脚本位于 GitHub：
+这个 Hugging Face 仓库用于介绍 `virtual-fly`，并说明首次发布前已经准备好的检查点仓库结构。源代码、科学说明、canonical 实验清单以及完整复现脚本位于 GitHub：
 
 - GitHub: https://github.com/shute2004/virtual-fly
 - 英文文档: https://github.com/shute2004/virtual-fly/tree/main/docs/en
@@ -13,7 +13,7 @@
 
 ## 检查点仓库结构
 
-公开的检查点分为两个明确不同的系谱。**不要把视频用 Before / After 检查点当作 canonical v1 的初始 / 学习后检查点。**
+准备发布的检查点分为两个明确不同的系谱。下面四个检查点仓库目前尚未创建或公开。**不要把视频用 Before / After 检查点当作 canonical v1 的初始 / 学习后检查点。**
 
 ### Canonical v1
 
@@ -35,11 +35,11 @@ canonical v1 的科学计算部分固定在 Git commit `7fa464aad7269d34f46f1171
 | Before | `shute2004/virtual-fly-video-before` | 公开 Before / After 对比视频中 Before 一侧实际使用的历史检查点 |
 | After | `shute2004/virtual-fly-video-after` | 同一视频中 After 一侧实际使用的历史检查点 |
 
-这些检查点的内部开发版本分别是 `v240` 和 `v966`，但这些编号不会出现在公开仓库名中，只保留在来源记录里。它们来自更早的实验系谱，与当前 canonical v1 的来源链和部分运行定义不同，因此**不是 canonical v1 的实验依据**。
+这些检查点的内部开发版本分别是 `v240` 和 `v966`，但这些编号不会出现在公开仓库名中，只保留在来源记录里。Before 一侧的 v240 不是未经学习的初始状态，而是已经经历 240 个历史训练回合的检查点；回放不是留出评估，而且在关闭可塑性时仍保留了任务事件触发的 PAM 刺激。v966 也来自混合了多个早期条件的开发系。因此，它们**不是 canonical v1 的实验依据**。
 
 ## Hugging Face 中保存什么
 
-每个检查点仓库只保存检查点本体，以及直接需要的来源记录、哈希值、归属信息和模型卡。它们不会复制整个研究工作区。
+正式发布后，每个检查点仓库只保存检查点本体，以及直接需要的来源记录、哈希值、归属信息和模型卡。它们不会复制整个研究工作区。
 
 默认不保存：