Refining-colors / pet-with-you

# pet-with-you
**让一只小伙伴，陪你工作，也陪你发呆。**
一个运行在 Windows 桌面上的动画桌宠：可以随机玩耍、手动点播、聊天与碎碎念，也可以连接 Codex 桌面客户端，展示任务进度和账户额度。
> `1.0.2` Windows 版：下载安装程序。纯桌宠无需另装 Node.js、Git 或 Codex CLI。由 Refining-colors 维护。项目代码采用 MIT，角色动画按原作条款说明。
基于 PC2005-cloud/dsh-pet 改造与扩展，保留原作角色和 106 段动画。原作代码、素材与本项目适配工作的关系见 来源与致谢。
快速开始 · 功能介绍 · 动画图鉴 · 模式与连接 · 常见问题 · 全流程配置 · 使用手册 · 排错
> 旧版用户退出桌宠后可直接覆盖安装，无需先卸载；升级保留个人设置、已保存密钥及自定义角色。
## 看看它能做什么
| 聊天与碎碎念 | 密钥 / 代理统计 | 登录账户额度 |
| --- | --- | --- |
| | | |
多任务进度、聊天回复和不同来源的额度，都能在桌宠旁边查看。配图中的任务、回复和额度均为演示数据。
## 功能介绍
### 全部动作，先看一眼
| 吃什么 | 玩耍 | 季节 | 互动 |
| --- | --- | --- | --- |
| | | | |
向下查看完整动画图鉴 →，也可打开独立图鉴查看逐项名称与表情图说明。
### 陪伴与互动
- **106 段动画**：待机、点击回应、吃东西、玩耍等；日常动作按分类权重随机轮换，也可右键手动点播。
- **桌面互动**：拖动、抛掷、尺寸调整、多宠物同屏，支持禁止自主跑动。
- **窗口与位置**：四种互斥窗口模式：普通显示、始终置顶、全屏隐藏、在GPT置顶，其余全屏隐藏；支持靠近屏幕底部、任务栏上方及客户端窗口下沿时吸附。
- **位置记忆**：切换模式、重新打开时尽量恢复原位置；显示器变化时将宠物调整到可见区域。
- **托盘管理**：单击托盘图标立即显示并临时置顶 8 秒；隐藏托盘图标后，可以从桌宠右键菜单恢复。
### 聊天与碎碎念
- 使用自己的 OpenAI 兼容 API，填写地址、模型和密钥即可配置聊天服务。
- 支持手动碎碎念、自动碎碎念，以及间隔和触发概率设置。
- 碎碎念支持流式显示，本次运行内记录历史并拦截完全重复的句子。
- 回复可选中文字复制，右上角关闭；停留方式支持定时、下一次信息前保留、永久保留。
- 支持系统字体和导入字体；查询字体与基础反馈／聊天字体分别设置。
- 当前 API 配置与命名配置列表分开管理，支持保存、载入、删除和清除。
### Codex 任务联动
- 展示思考、执行工具、整理结果、等待确认、出错和回合完成等已观测到的状态。
- 基础动画反馈与原生风格任务卡可分别开关；同时启用时任务卡显示在上方。
- 多任务按优先级展示，最多列出三个任务，更多任务显示数量；已识别的对话标题可点击打开。
- 提供“关闭事件响应”开关，演示或录屏时暂停任务动画、任务气泡和回合结束自动额度查询。
- 首次连接询问是否创建 **Codex withu** 联动启动器，可自选目录，双击同时打开客户端与桌宠；无需常驻启动检测。随客户端关闭和开机自启动仍分别设置。
### 额度与设置
- Codex 登录额度展示 **5 小时和 1 周的已用／剩余比例、各自重置时间、可用重置次数和更新时间**。
- 支持 CRS 统计查询和部分服务商的通用 JSON 余额接口。
- 支持回合结束后自动查询，默认关闭；有其他任务时暂缓显示最新查询结果。启动、闲置和设置重建不会自行查询弹出额度。
- 设置分为“基础设置”和“GPT连接设置”，同一选项卡内的模块可以拖动排序。
- 普通设置修改后，关闭设置窗口自动保存；失败时保留窗口和未保存的内容。
- 所有普通设置集中于 `settings.json`，设置底部可定位并分享；实际密钥单独在本机加密保存。
- 基础设置底部可选择目录创建名为 `pet-with-u`、带角色图标的启动快捷方式，同名文件自动另加编号。
- 首次正常启动时会询问是否创建快捷方式，可选择保存目录或跳过；选择会被记住，后台联动启动不弹出此提示。
- 提供错误日志、导出反馈、打开日志目录及清除日志功能。
## 快速开始
### 推荐：下载安装版
1. 打开 Releases 下载页，下载 **pet-with-you-1.0.2-x64-setup.exe**。
2. 双击安装，选择目录和是否创建桌面快捷方式。
3. 从桌面或开始菜单中的 **pet-with-u** 启动，默认纯桌宠；右键打开设置。
安装版自带运行环境，不需要下载源码。`Source code (zip)` 是开发者使用的源码压缩包。当前安装包未签名，可能出现未知发布者提示；下载页附 SHA-256 校验值。升级前退出桌宠，安装新版后保留原设置。详见 完整安装手册。
### 运行环境
- Windows 10 / 11。
- 安装程序自带运行环境，纯桌宠无需额外安装 Node.js。
- 源码启动需要 Node.js 22.12 或更高版本，首次安装需要下载 Electron 依赖。
安装程序会询问安装目录和是否创建桌面快捷方式。构建与验证见 打包说明。纯桌宠可以独立运行，不需要 Codex、Git 或密钥。初次接触 GitHub 请从 零基础配置手册 开始。
### 从源码安装和启动
1. 安装 Node.js LTS（至少 22.12，保留 npm 和 PATH 选项）。
2. 在本仓库点击 **Code → Download ZIP**，完整解压到准备长期保留的目录。
3. 双击 `Install-Pet.cmd` 安装依赖，等待提示完成。可双击 `Check-Setup.cmd` 检查环境。
4. 双击 `Start-Pet.cmd` 启动桌宠；右键打开设置。
5. 首次默认使用纯桌宠模式；右键宠物可查看动作和打开设置。
安装脚本负责下载项目依赖与 Electron，不会自动安装 Node.js、Git 或 Codex。首次下载可能需要几分钟；失败可按 下载排错 重试。
也可在项目目录使用终端：
 [code] 
### 三个启动入口
| 文件 | 作用 |
| --- | --- |
| `Start-Pet.cmd` | 只启动桌宠，使用上次保存的模式；右键打开设置 |
| `Connect-Pet.cmd` | 打开连接设置，适合先配置客户端联动 |
| `Start-And-Connect.cmd` | 启动桌宠并准备客户端联动配置 |
`Install-Pet.cmd` 会询问是否创建桌面快捷方式，也可单独运行 `Create-Shortcut.cmd`；快捷方式使用与托盘相同的角色图标。移动源码目录后请重新创建。更详细的说明见 安装与启动。
## 模式与连接
| 能力 | 纯桌宠 | 连接 Codex 桌面客户端 |
| --- | --- | --- |
| 日常动画、随机播放、手动点播 | 支持 | 支持 |
| 自有