# AI-pet

**Repository Path**: CheckBug/ai-pet

## Basic Information

- **Project Name**: AI-pet
- **Description**: 一个简单的桌面宠物
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-11
- **Last Updated**: 2026-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 桌面宠物

Electron + React + TypeScript 实现的第一版纯文字交互原型。

## 当前能力

- 透明、无边框、置顶的桌面宠物窗口
- 可通过窗口任意空白区域拖动
- 点击宠物展开文字输入框
- 待机、输入、思考、回复、错误状态
- 主进程 IPC 模拟回复
- 所有对话统一通过 DeepSeek API 完成
- 自动携带最近 10 条上下文消息
- 最近 8 条聊天记录、Enter 发送和 Esc 收起
- 网络超时、未知城市和断网错误提示
- DeepSeek 管理的周期喝水提醒计划
- 支持周期性计划和单次喝水提醒
- 多显示器红色边框呼吸闪烁和轻微抖动
- 多表情动漫宠物：待机、思考、开心、喝水提醒、委屈报错和打瞌睡
- 屏幕中央独立大对话窗口，支持缩放、尺寸记忆和多显示器居中
- DeepSeek 流式回答、停止生成、Markdown/GFM、代码复制和长问题多行输入
- 已喝水、10分钟后提醒、今天暂停快捷操作
- 系统睡眠恢复后自动重新调度，计划持久化保存
- 系统托盘的显示、隐藏与退出
- `contextIsolation`、禁用 `nodeIntegration` 和受控 preload API

## 本地运行

复制 `.env.example` 为 `.env.local`，填入 DeepSeek API Key：

```env
DEEPSEEK_API_KEY=sk-你的Key
DEEPSEEK_MODEL=deepseek-chat
QWEATHER_API_KEY=你的和风天气APIKey
QWEATHER_API_HOST=你的专属域名.qweatherapi.com
```

```bash
pnpm install
pnpm dev
```

## 构建验证

```bash
pnpm build
```

## 下一步

天气由 DeepSeek Tool Calls 自主决定是否调用，实时数据来自和风天气。API Host 可在和风天气控制台的“设置”中查看。

1. 继续通过 DeepSeek Tool Calls 扩展本地工具能力。
2. 增加设置页和 API 配置界面。
3. 在文字链路稳定后增加语音方案 A。
# 电脑操作与浏览器扩展

## UAT客户端升级程序

桌宠已内置固定路径 `D:\仓储UAT升级\UAT版升级客户端\FTP升级管理系统.exe` 的专用连接能力。可以输入“连接UAT金帝版”或“打开客户端升级程序并连接UAT标准版”。如果没有说明版本，助手会先追问；连接成功必须同时检测到连接状态、目标版本和服务器文件列表。

### 发布准备

可以输入“准备发布UAT标准版”或“把今天编译的DLL放到UAT金帝版发布程序里”。助手会检查连接版本，合并 `Debug` 顶层今日 DLL、`Debug\rdlc` 顶层今日 RDLC 和 `Debug\DLL\WMS` 顶层今日构建产物；同名文件以 `DLL\WMS` 为准。文件校验后重建 `bin\client` 暂存目录，再拖入右侧待上传列表。流程只停留在“上传 N 个文件”的待上传状态，绝不会自动点击“上传文件”。如果 `client` 原本非空，会先显示删除确认卡。

桌宠现已支持通过 DeepSeek Tool Calls 操作 Windows。可直接测试：

- “打开记事本”
- “把系统音量调到 30%”
- “列出 E 盘根目录的文件”
- “在桌面创建一个 test.txt，内容是你好”
- “读取当前网页并总结”

删除、覆盖文件、关闭窗口，以及疑似付款、转账或下单操作会显示确认卡，确认后才执行。聊天窗口左下角可以查看操作记录，托盘菜单可以暂停电脑控制。

## 安装 Chrome / Edge 扩展

1. 启动桌宠并打开聊天窗口，在左下角查看“扩展端口”和“配对码”。
2. Chrome 打开 `chrome://extensions`，Edge 打开 `edge://extensions`。
3. 开启“开发者模式”，点击“加载已解压的扩展程序”。
4. 选择项目中的 `browser-extension` 文件夹。
5. 点击浏览器工具栏中的“AI 桌面宠物浏览器桥接”，填入端口和配对码。
6. 显示“配对成功”后，即可让桌宠读取和操作当前普通网页。

浏览器内部页面、扩展商店、密码字段、验证码和支付口令不会交给模型读取或填写。