Shipped · v2 packageOpen character asset

先读水势，
再向前游。

巡潮鳐是一只沿洋流巡游的深海伙伴。宽阔的鳍翼、珊瑚色识别纹与稳定的悬游姿态，把观察环境、等待确认、专注处理和完成复核变成清晰的动作语言。

An installable Codex v2 manta companion that reads the current before moving.

安装巡潮鳐查看源码 ↗

Codex v2 · 8 columns × 11 rows

Core atlas8 × 111536 × 2288 WebPvalidated
Look directions16每步 22.5°blind QA
Core motions9状态语义分离visual QA
Install files2pet.json + spritesheetscoped

Runtime contract

角色鲜明，协议不变。

核心包只交付 Codex 真正读取的两个文件。图集保持 v2 的尺寸、透明通道、行序和有效帧分布，不用展示素材冒充运行时能力。

01 / Water motion

用鳍翼和身体位置表达游动

不依赖水花、速度线、场景或阴影，缩小到单格后仍能读出方向和节奏。

02 / Direction family

完整十六向环视

从向上开始顺时针跨越 16 个方向，四个基准方向作为硬门禁，过渡角度保持连续。

Nine core motions

每个运行状态都有自己的游姿。

下面的 GIF 直接来自最终图集的九组标准动作，用于检查动作是否可读、循环是否连贯、身份是否稳定。

Install safely

先验证和预览，再写入 Codex。

安装器默认拒绝覆盖同名宠物，目标目录由 CODEX_HOME 决定。

git clone https://github.com/estelledc/xunchao-ray.git
cd xunchao-ray
python -m pip install -r requirements-dev.txt
make check
python scripts/install.py --dry-run
python scripts/install.py

Evidence, not decoration

页面规格能回到仓库复验。

包校验检查尺寸、格式、透明通道和有效帧；测试覆盖安装范围与拒绝覆盖；公开扫描阻止本机路径、凭证形态和内部标记进入仓库。

Release evidence is reproducible with make check.