外接显示器和虚拟机里，Codex 桌宠还能用吗

桌宠到底装在哪儿

一只 Codex 桌宠就是同一个目录里的两个文件：spritesheet.webp 和 pet.json，放在运行 Codex 那台机器的 home 目录下。它们跟显示器没有任何关系，渲染器只是把图按固定尺寸画在 Codex 窗口的某个角上。所以 codex pet vm 这件事，本质上是「你在看哪台机器的 home 目录」。

一旦你不止在一台机器上干活，这个区别就开始咬人。桌宠跟着 home 目录走，不跟着显示器走，也不跟着人走。把同一份目录复制到第二台机器，你得到同一只；登录一台全新的虚拟机，你得到一片空角落。

• 目录在宿主机：桌宠出现在你平时那个 Codex 窗口里
• 目录在虚拟机：只有 Codex 在那台虚拟机里运行时才出现
• 共享或同步目录：两边都能出现，前提是路径一致
• 远程桌面连宿主机：能看到，因为你看到的就是宿主机的窗口

外接显示器：变的是什么

插上第二块屏并不会挪走桌宠，挪走的是你的视线。多数「副屏上桌宠不见了」的报告都属于这一种：它还在同一个窗口的同一个角上，只是那个窗口已经不在你盯着的地方了。

真正会变的只有两样：缩放决定了画出来有多大，窗口位置决定了它占的那个角落在不在你读的屏幕上。

• 把 Codex 窗口拖到你常看的显示器，桌宠跟着走
• 100% 和 150% 的缩放会改变显示大小，精灵图文件本身不变
• 刷新率不同不会影响动画快慢，帧循环走自己的计时器
• 双屏摆放的细节写在 /blog/dual-monitor-pet-placement

虚拟机与远程桌面这两种情况

虚拟机是最容易踩的坑，因为有两个 home 目录，而通常只有其中一个有你的宠物目录。如果你在 Windows 宿主机上跑 Linux 虚拟机并在里面开 Codex，那台虚拟机得先有自己的一份目录，否则什么都不显示。

远程桌面这一半简单些：你看的是远程机器自己的 Codex 窗口，那台机器装了什么你就看到什么。唯一的变量是带宽，压缩和延迟会跟窗口其它部分一样作用在桌宠身上。

• 把宠物目录复制进虚拟机的 home 目录，然后重启里面的 Codex
• 远程桌面下桌宠由远程机器渲染，所以网络卡它也会卡
• 全屏远程没问题，窗口模式可能把桌宠所在的角落裁掉
• 两边目录保持一致的做法在 /blog/sync-codex-pet-across-machines

先查这几项，再怪桌宠

大部分「桌宠不见了」其实是路径问题，不是生成问题。重新生成之前先把这张清单过一遍。

• Codex 是不是跑在你正在看的这台机器上？
• 那台机器的 home 目录下有没有宠物目录？
• pet.json 指向的精灵图是不是真的在？
• Codex 窗口宽度够不够放下桌宠占的那个角落？
• 需要重装的话，步骤在 /blog/install-codex-pet-terminal

每台机器装一次就够了

到 codexpetgenerator.com 生成一只，下载 ZIP，照着 /blog/install-codex-pet-terminal 的终端步骤装上。每台机器做一次，虚拟机也算一台，之后就不用再管它了。

想让同一只跟着你到处跑，靠的是 /blog/sync-codex-pet-across-machines 里的目录同步办法。生成次数看 /pricing，生成器入口在 /。录屏是唯一需要让桌宠出画的情况，/blog/hide-codex-pet-screen-share 里大约九十秒能处理完。