Shipped · v2 package Open character asset

沿着证据，
找到下一步。

循迹獭是一只可直接安装进 Codex 的动画宠物。它把“追踪证据、检查门禁、归档结论、清晰交接”变成一套可观察、可验证、可继续扩展的角色语言。

An installable Codex v2 animated pet with a protocol-safe core atlas and a separate open animation layer for evidence-first work.

安装循迹獭查看源码 ↗

Codex v2 · 8 columns × 11 rows

Core atlas8 × 111536 × 2288 WebPvalidated
Look directions16每步 22.5°v2 contract
Extra motions6独立 manifest 与 GIFopen assets
Install files2pet.json + spritesheetscoped package

Runtime contract

核心包稳定，扩展动作独立演进。

Codex v2 只读取固定 11 行。仓库不会为了增加动作而修改核心图集协议；额外动作由独立 manifest、透明帧和 GIF 提供给展示页与未来适配器。

01 / Installable core

只交付 Codex 真正读取的文件

pet.json 声明 v2 协议与图集路径，spritesheet.webp 保持固定尺寸、透明通道和有效帧分布。

02 / Open extension

动作语义不挤进运行时协议

extras/animations.json 描述动作名称、意义、帧数、节奏与相对路径，保持可移植和可复用。

Six extra motions

把工作习惯做成动作语言。

六组扩展动画不声称是 Codex 当前状态；它们是独立开放资产，用于 README、静态展示、社交预览与未来适配器。

正在读取动作清单…

动画清单读取失败，请直接查看仓库中的 extras/animations.json。

循迹獭六组扩展动作的逐帧总览 — 循证追踪 · 检查门禁 · 归档笔记 · 清晰交接 · 验证通过 · 收工休息

Install safely

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

需要 Python 3.10 或更高版本。安装器默认拒绝覆盖同名宠物，目标目录由 CODEX_HOME 决定。

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

Evidence, not decoration

页面上的规格都能回到仓库验证。

展示页不把角色设定当作运行时能力，也不把额外 GIF 混进可安装包；发布前由脚本、测试和公开扫描分别检查这些边界。

Atlas
验证 WebP 格式、1536 × 2288 尺寸、RGBA 透明通道和每行有效帧。
validate_pet.py
Manifest
检查六组动作的帧数、相对路径、GIF 帧数和资源范围。
pytest
Installer
验证 dry-run、不覆盖默认值、强制覆盖开关与隔离的 CODEX_HOME。
package tests
Public boundary
扫描本机绝对路径、凭证形态、私钥和内部标记，避免进入公开仓库与站点。
public scan

Release evidence is reproducible from the public repository with make check.

Public boundary

刻意不混淆的三件事。

扩展动作不是 Codex 当前原生状态；角色设定不是 Agent 能力声明；页面预览不能替代本地安装与包校验。代码采用 MIT，角色图像与动画资产采用 CC BY 4.0。