一个蓝发鲸鱼娘桌宠，Windows 免安装绿色版，另附 ChatGPT / Codex 宠物包。 本文含官方下载链接、SHA-256 校验、以及中文用户名环境下的启动报错修复方案（实测有效）。
一、它是什么
「深深桌宠」是一个非官方、非商业的 Windows 桌面宠物项目：蓝发鲸鱼娘形象，常驻桌面透明悬浮层，支持点击跳跃、拖拽移动、右键菜单、每日白饭与羁绊成长，还能作为 ChatGPT / Codex 的自定义 Pet 使用。
最新版本：v0.5.0
运行要求：Windows 10 及以上（x64），不需要 .NET SDK、不需要管理员权限
网络行为：离线运行，无遥测、无账号、无 API Key
二、下载链接
国内网络提示：GitHub 直连经常超时，可用加速前缀，例如在链接前拼 https://ghfast.top/：
代码块
https://ghfast.top/https://github.com/schrieeeffer/shenshen-codex-pet/releases/download/v0.5.0/ShenshenPet-Windows-x64.zip镜像只负责转发，文件完整性请务必用下面的 SHA-256 自行核对。
三、安装步骤（三种方式任选）
方式 A：绿色版直接运行（最简单）
下载
ShenshenPet-Windows-x64.zip；完整解压到一个固定目录（例如
D:\ShenshenPet）；双击
ShenshenPet.exe。
不需要安装、不写注册表、不需要管理员权限。
方式 B：PowerShell 一键部署（推荐写进博客的版本）
把压缩包放到当前目录后执行：
powershell
$zip = "ShenshenPet-Windows-x64.zip"
$dest = "D:\ShenshenPet"
Expand-Archive -Path $zip -DestinationPath $dest -Force
# 中文用户名环境必须设置 ASCII 解包目录，否则启动即静默退出（详见第四节）
$env:DOTNET_BUNDLE_EXTRACT_BASE_DIR = "D:\ShenshenPetCache"
Start-Process -FilePath "$dest\ShenshenPet.exe" -WorkingDirectory $dest方式 C：保留开机自启（可选）
程序默认不开机自启，也不会自行写入注册表。需要时在右键菜单勾选「开机启动」，它会写入当前用户的 HKCU\...\Run；取消勾选即删除该值。
四、踩坑记录：中文用户名导致启动失败（实测）
如果你双击 ShenshenPet.exe 后什么都没发生，进程一闪就退出，多半是这个问题。
排查方式：在命令行直接运行，捕获标准错误输出：
powershell
& "D:\ShenshenPet\ShenshenPet.exe" 2>&1 | Out-String典型报错：
代码块
Failed to create default extraction directory [C:\Users\??\AppData\Local\Temp\.net]. No error, error code: 5
Failure processing application bundle.
Failed to determine location for extracting embedded files.
DOTNET_BUNDLE_EXTRACT_BASE_DIR is not set, and a read-write cache directory couldn't be created.原因：.NET 单文件打包（single-file bundle）在启动时要把内嵌 DLL（WPF 的 wpfgfx_cor3.dll、D3DCompiler_47_cor3.dll 等）解压到临时目录，而这段逻辑对非 ASCII 路径处理不佳——中文用户名会被压成 ??，于是目录创建失败，程序在创建窗口之前就退出了。
解决：把解包目录指向纯 ASCII 路径，并让程序本体也位于 ASCII 路径下。
powershell
# 1. 程序放在 ASCII 路径
Copy-Item "C:\Users\你的用户名\Downloads\ShenshenPet" "D:\ShenshenPet" -Recurse
# 2. 指定解包缓存目录（当前会话生效即可）
$env:DOTNET_BUNDLE_EXTRACT_BASE_DIR = "D:\ShenshenPetCache"
Start-Process "D:\ShenshenPet\ShenshenPet.exe"一劳永逸：在程序目录放一个启动脚本 启动桌宠.cmd，以后双击它即可：
bat
@echo off
set "DOTNET_BUNDLE_EXTRACT_BASE_DIR=D:\ShenshenPetCache"
start "" "%~dp0ShenshenPet.exe"验证是否真的跑起来了：
powershell
Get-Process ShenshenPet | Select-Object Id, @{n='MB';e={[math]::Round($_.WorkingSet64/1MB,1)}}正常时可见一个约 150 MB、窗口句柄非零的进程。
五、使用说明
关闭透明窗口只会隐藏到系统托盘，进程仍在后台
要彻底结束，请在右键菜单或托盘菜单选择「退出」
成长数据保存在
%LOCALAPPDATA%\ShenshenPet\settings.json，完全离线v0.5.0 默认开启节能模式：10 FPS、隐藏后停止渲染计时器、按需加载帧（最多缓存 12 张）
六、可选：接入 ChatGPT / Codex
桌面端与 CLI
解压 Shenshen-Codex-Pet.zip 后执行：
powershell
powershell -ExecutionPolicy Bypass -File .\install-codex-pet.ps1安装到 %USERPROFILE%\.codex\pets\shenshen\（若设置了 CODEX_HOME 则跟随该变量），随后在 ChatGPT/Codex 桌面端 设置 > Pets > Refresh，选择「深深」，输入 /pet 唤醒。
Codex CLI 中可用：
代码块
/pets
/pets shenshen
/pets offCLI Pet 需要 iTerm2 3.6+ 或支持 Kitty graphics / Sixel 的终端，tmux 与 Zellij 中不可用。
网页版
下载 Shenshen-ChatGPT-Web-Pet.webp，在 ChatGPT Settings > Personalization > Pet > Select pet > Upload pet 上传。该功能是否可用取决于账号与工作区，且只显示在支持的 Work 对话内。
状态桥接（可选）
在 Windows 版右键菜单选择「安装 Codex 状态桥接」，再在 Codex CLI 输入 /hooks 信任新增 Hook。之后桌宠会随任务状态切换动画：提交任务 → running，等待授权 → waiting，本轮完成 → review，会话结束 → idle。安装前会自动备份已有 hooks.json，卸载只删除带深深标记的处理器。
七、卸载
powershell
# 1. 先在托盘菜单选择「退出」
# 2. 删除程序与缓存（注意先取消勾选「开机启动」）
Remove-Item "D:\ShenshenPet" -Recurse -Force
Remove-Item "D:\ShenshenPetCache" -Recurse -Force
Remove-Item "$env:LOCALAPPDATA\ShenshenPet" -Recurse -Force # 想清空设置与羁绊数据时执行
# Codex Pet
Remove-Item "$env:USERPROFILE\.codex\pets\shenshen" -Recurse -Force八、注意事项
SmartScreen 提示：EXE 未使用商业代码签名，首次运行可能提示「Windows 已保护你的电脑」，这是信誉/签名提示而非病毒告警。确认来源后可选「更多信息 > 仍要运行」；若哈希与官方
SHA256SUMS.txt不符，请勿运行。哈希校验：
v0.5.0的ShenshenPet-Windows-x64.zip官方 SHA-256 为fe1bdd55b674d18de8f33ce284cb8313d25cef5100cf91685867d7635597e72f许可：代码为 MIT；视觉素材为 CC BY-NC-SA 4.0，仅限非商业用途。项目与 DeepSeek、OpenAI 均无隶属或背书关系，属同人二创。
资源占用：常驻内存约 150 MB 量级，CPU 占用随动画与系统环境变化；不用时请从菜单退出。