本地开发

仓库采用 src/ 布局。库代码位于 src/vfp_reader/，单元测试位于 tests/，用户文档位于 docs/。先创建隔离环境，再使用 editable install：

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .

开发时优先阅读 src/vfp_reader/core.py，它是公开读取语义的唯一实现来源。CLI 在 src/vfp_reader/cli.py，只应作为公开 API 的薄封装；不要在 CLI 中复制解析算法。

修改 core.py 前先判断能力是否仍属于只读范围。若需求是生成 VFP、修改 VOX0 或构建缓存，应转到 Compiler 项目，而不是扩大 Reader 的职责。