真实快照结果 · 捣蛋猫 → 阿努比斯：最短 3 代，共 170 条载体路线；默认给出最推荐的一条，需要时最多展示 10 条。
Important
Palbreed 暂未发布到 npm registry，请从源码构建使用。下方的 npm link 只创建本机命令链接，不会向 npm 发布或上传任何内容。
需要 Git、Node.js >=22.12.0 和 Corepack。
git clone https://github.com/yearth/palbreed.git
cd palbreed
corepack enable
pnpm install --frozen-lockfile
pnpm build
node dist/palbreed.js path 捣蛋猫 阿努比斯需要反复使用时，可以把当前源码构建结果链接为本机命令：
npm link
palbreed path cattiva anubis --limit 10不想创建全局链接时，后续示例中的 palbreed 均可替换为 node dist/palbreed.js。
- 最短载体路线：从携带目标词条的起点 Pal 出发，只返回满足硬条件的最短代数物种路线。
- 合并辅助方：同一步可用的辅助配种方合并在
partnerOptions，不会被误算成多条载体路线。 - 确定性 Top 10：稳定排序，默认返回最推荐的一条，
--limit最多展示 10 条。 - 输入可确认：支持中文名、英文名和稳定 ID；错字候选来自当前离线快照，CLI 会停下来要求确认，绝不静默纠正。
- 离线快照：仓库自带经过校验的数据；构建后的查询与状态查看不依赖网络，更新必须显式执行。
- 面向人和 AI：提供单文档 JSON v1；配套 Skill 只调用 CLI 并解释真实结果。
Palbreed 规划的是词条载体在物种间转移的路线可能性。实际后代是否继承目标被动词条仍有随机性，路线不保证词条必然遗传。
中文名、英文名和稳定 ID 都可直接输入：
palbreed path 捣蛋猫 阿努比斯
palbreed path cattiva anubis --limit 10
palbreed path PinkCat Anubis --json软偏好只重排同代数路线；硬排除会过滤路线：
# 优先使用已有辅助方
palbreed path 捣蛋猫 阿努比斯 --prefer 枯星龙
# 排除不能提供的辅助方
palbreed path 捣蛋猫 阿努比斯 --exclude 冰棘兽
# 软性避开传奇，或硬性排除传奇辅助方
palbreed path 捣蛋猫 阿努比斯 --avoid-legendary
palbreed path 捣蛋猫 阿努比斯 --exclude-tag legendary| 参数 | 语义 | 是否改变最短代数 |
|---|---|---|
--limit 1..10 |
返回前 N 条已排序路线 | 否 |
--prefer X |
软性优先已有辅助配种方 | 否 |
--exclude X |
硬性排除辅助配种方 | 可能导致无路线 |
--avoid-legendary |
软性降低传奇辅助方优先级 | 否 |
--exclude-tag legendary |
硬性排除传奇辅助方 | 可能导致无路线 |
这些条件只作用于玩家需要提供的辅助配种方，不会把中途生成的载体 Pal 当成库存要求。结果始终只包含满足当前硬条件的最短代数路线，软偏好不会让更长路线排到前面。
特殊配方需要性别时，文本和 JSON 会显示载体与辅助方的性别要求。物种级规划假设玩家能够繁育或取得所需性别；第一步存在要求时，请优先确认起点 Pal 的性别。
加 --json 后，stdout 恰好输出一个 JSON 文档。成功和失败都带 schemaVersion: 1；失败返回非零退出码。完整字段见 Skill JSON 速查。
palbreed path 捣蛋猫 阿努比斯 --limit 10 --json \
| jq '{ok,shortestGenerations,totalRoutes,returnedRoutes,truncated}'当前内置快照的结果摘要：
{"ok":true,"shortestGenerations":3,"totalRoutes":"170","returnedRoutes":10,"truncated":true}totalRoutes 是避免整数溢出的精确十进制字符串。每条 route 包含稳定 ID 的 carrierPath、逐步 steps、recommendedPartner、全部 partnerOptions、适用时的性别字段和排序分数。
构建后即可离线查看当前数据：
palbreed data status
palbreed data status --json只有显式更新会联网，并从项目自己的 GitHub Release manifest 下载数据：
palbreed data update
palbreed data update --json- 下载内容通过哈希和 Schema 校验后才会原子替换本地更新；失败不会覆盖现有数据，也不影响继续使用内置快照。
- 运行时优先使用校验通过的本地更新；本地数据损坏时会回退到内置快照并给出 warning，本地版本旧于内置快照时也会提示。
- 查询输出中的
gameVersion、dataVersion、dataSource和warnings说明实际使用的数据。 - 内置快照是公开配种数据的最小化、版本匹配转换。运行时不会访问或热链来源站点；来源 URL、版本、转换字段和移除渠道见 DATA-NOTICE.md。
仓库包含 skills/palbreed。这个 CLI-backed Skill 把自然语言约束转换为 CLI 参数，只解释 JSON v1，不自行计算、补写或猜测路线。
在仓库根目录可用兼容 Agent Skills 的管理器安装：
npx skills add . --skill palbreed安装前请阅读 skills/palbreed/SKILL.md，并确保 palbreed 命令已可执行。
corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm test
pnpm build
npm pack --dry-run维护者专用的 pnpm data:build 会读取本地 HAR 并请求指定 locale；它不属于运行时、CI 或普通安装流程。
Palbreed 免费、无广告，是非官方开源工具，与 Pocketpair 无隶属关系，也未获其背书。项目代码采用 MIT 许可证；内置游戏衍生数据、Palworld 名称、商标和素材不由 MIT 许可证授权，详见 DATA-NOTICE.md。