Copilot 有桌宠了，真的假的？！#

1. 一个”什么都没有”的窗口#

XAML 里窗口的关键就四个属性：

1
<Window WindowStyle="None" AllowsTransparency="True" Background="Transparent"
2
        Topmost="True" ShowInTaskbar="False" ...>

WindowStyle="None" 去掉标题栏和边框，AllowsTransparency + Background="Transparent" 让窗口背景透明，Topmost 置顶，ShowInTaskbar="False" 不在任务栏留痕。这样剩下的就只有你画上去的东西，看起来就是”一张贴图浮在桌面上”。

窗口尺寸不写死，而是根据配置算出来的：

1
窗口宽 = 帧宽 × scale + 24
2
窗口高 = 帧高 × scale + 64（气泡区）+ 16

初始位置贴着工作区右下角（WorkArea.Right - 窗口宽 - 60），所以第一次召唤它就从屏幕右下角冒出来。

窗口里的元素就四个，全在一个 Canvas 上：

• Sprite：Image，贴图本体，RenderOptions.BitmapScalingMode="NearestNeighbor"——像素风放大不会被糊成一片；
• Bubble：白底圆角 Border + TextBlock，默认 Collapsed，说话时才显示；
• Shadow：一个 18% 透明度的黑色 Ellipse，加了 BlurEffect，就是脚下那团影子；
• Badge：一个 🛠 的 TextBlock，agent 干活时显示在头顶。

2. 贴图怎么切帧#

贴图是一张等宽帧网格：一行一个动画，帧从左到右排。

1
"idle": { "row": 0, "frames": 4 },
2
"walk": { "row": 1, "frames": 4, "leftRow": 2 }

切帧就是算一个矩形再 CroppedBitmap：

1
$rect = New-Object System.Windows.Int32Rect(($frame * $fw), ($row * $fh), $fw, $fh)
2
$sprite.Source = New-Object System.Windows.Media.Imaging.CroppedBitmap($script:bitmap, $rect)

$frame 每 tick 自增再对 frames 取模，动画就跑起来了。

左右方向有两种处理：默认向左走时用 ScaleTransform(-1, 1) 镜像翻转；如果配置里给了 leftRow，说明作者把向左的帧单独画了一行（方向烘焙进贴图里了），这时直接用 leftRow 那一行、不翻转。

3. 动画状态机#

播哪个动画由 Resolve-AnimName 按优先级决定：

1. overrideAnim（agent 通过工具 / 画布指定的）——最高优先级；
2. 睡觉中且有 sleep 动画 → sleep；
3. activity = working 且有 work 动画 → work（坐下敲电脑）；
4. 走动中且有 walk 动画 → walk；
5. defaultAnimation；
6. 兜底 idle。

注意每一级都带”有该动画才用”的判断，所以一个只有 idle / walk / sleep 三行的最小贴图也能跑。

4. 行为决策 Decide#

每过一段随机时间（wanderIntervalSec，默认 3~8 秒）跑一次 Decide：

• autoWander 关了 → 老实待机；
• agent 正在干活且有 work 动画 → 待机（不乱跑，坐着敲电脑）；
• 距上次交互超过 sleepAfterIdleSec（默认 45 秒）→ 睡觉；
• 否则 55% 概率走动（随机方向），45% 概率待机。

走动时每 tick 更新 Left += dir × speed × dt，碰到工作区左右边界就反向。这样它在屏幕上是有”巡逻”感的，而不是在原地抽搐。

5. 两个定时器#

• 动画定时器：间隔 max(30, 1000 / fps) 毫秒。每 tick 推进一帧、更新 sprite；同时算 dt 做走动位移和跳跃物理（hopV / hopY，重力 900），dt 上限 0.1 秒防止卡顿后瞬移。
• 轮询定时器：固定 900ms。每 4 次（约 3.6 秒）检查一次 pet.json 的 LastWriteTime，变了就重读配置；每次都会 GET {StateUrl}api/state 拉桌宠状态。

6. 交互#

• 左键按下：DragMove() 拖动窗口，同时把状态从 sleep 唤醒；
• 左键抬起：如果按下和抬起的距离小于 6px，算”戳一戳”→ 从 speech.phrases 里随机抽一句冒泡 1.8 秒；顺便把窗口夹回工作区内，防止拖出屏幕；
• 右键：一个 ContextMenu，三件事——自动走动开 / 关、睡觉 / 醒来、退出。

7. 配置热重载#

不用重启，pet.json 改完几秒内自动生效。重载时会比对帧宽高 / scale / fps 有没有变，变了就调 Update-Geometry 把窗口、贴图、气泡、影子、徽章的尺寸和位置全部重算一遍；sprite 换了就重新加载位图。

8. 保活#

轮询失败会累加 failCount，连续 10 次（约 9 秒）失败就 $window.Close()。

这是故意的：扩展进程死了，桌宠自己退场。否则你关掉 Copilot，桌面上会留一只没人管的幽灵。

1. 注册工具和画布#

通过 @github/copilot-sdk/extension 的 joinSession 注册了 5 个 agent 工具：

以及一个画布 desktop-pet（显示名”桌宠”），动作和上面基本一一对应，open 时直接把本地服务的 URL 交给面板。

所以你可以直接跟 Copilot 说”召唤桌宠”、“让桌宠说：写完了”。

2. 本地 HTTP 服务#

createServer 监听 127.0.0.1:0（端口随机，避免撞车），所有响应带 Cache-Control: no-store：

桌面窗和画布面板都是靠轮询 /api/state 和 /pet.json 工作的，服务端本身几乎是无状态的。

3. 会话事件 → 桌宠动作#

1
for (const ev of ["user.message", "assistant.turn_start", "assistant.message",
2
                  "assistant.reasoning", "tool.execution_start", "tool.execution_complete"]) {
3
    session.on(ev, markWorking);
4
}

这些事件任意一个发生，activity 就变 working：桌面窗显示 🛠、切 work 动画、停止乱跑；面板状态栏也会显示”agent 工作中”。

1
session.on("session.idle", (event) => { ... });

会话空闲时切回 idle，并且如果刚才确实在干活、桌宠在跑、而且不是被中断的，就随机挑一句完成台词（“做完了。”、“任务完成，去看看吧。”…）冒泡 4 秒，同时播 6 秒 review 动画，之后恢复自动行为。

这就是 README 里说的”你干完活，它复盘并冒泡汇报”。

4. 单实例 / 多会话联动#

startDesktopPet() 里有两道闸：

• 自己进程已经起过桌宠 → 直接返回；
• 读心跳注册表，发现别的会话已经有一只活着的桌宠（petPid 还活着）→ 不再重复召唤，而是联动那一只。

否则你开三个 Copilot 窗口，就会有三只桌宠叠在一起打架。