# cy

**Repository Path**: cyyyds78/cy

## Basic Information

- **Project Name**: cy
- **Description**: ovo
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 德克萨斯桌宠 · 使用指南

把《明日方舟》的德克萨斯（官方骨骼动画版）放到你的 Windows 桌面上：她会待机、散步、坐下、睡觉，可以拖着走、戳她、喂她 Pocky。还有一个 ZCode 插件，让你在 ZCode 里直接指挥她、和她聊天养好感度。

> 这个仓库一共有三块内容：
> - `网页/` —— 干员小人网页（最早做的那个）
> - `桌宠/` —— 桌面桌宠本体（本指南的主角）
> - `plugins/` —— ZCode 插件（遥控桌宠 + 对话互动）

---

## 一、快速开始（3 步上桌）

### 第 0 步：装环境（每台电脑只需要一次）

1. 安装 Python（python.org 下载，安装时**勾选 "Add Python to PATH"**）
2. 打开命令行（Win+R 输入 `cmd` 回车），执行：

```
pip install pywebview PySide6 qtpy
```

> 你现在这台电脑已经装好了，这一步是给新电脑准备的。

### 第 1 步：启动她

双击 `桌宠/启动桌宠.bat`。

德克萨斯会出现在屏幕右下角、任务栏上方，跟你打招呼。

### 第 2 步：跟她玩

| 你做什么 | 她的反应 |
|---|---|
| **单击**她 | 戳一戳：冒台词气泡，信赖 +1 |
| **按住拖动** | 抓起她任意拖，松手即可 |
| **等一会儿** | 她自己开始散步（贴着屏幕底边走），偶尔坐下休息、靠着睡觉 |
| **右键点她** | 弹出菜单：顶部随时显示**心情/信赖**，下面是 ✋ 戳一戳 / 🐾 散步开关 / 🏠 回角落 / ❌ 退出 |

### 退出

右键她 → ❌ 退出。或者在 ZCode 里发 `/pet 退出`。

---

## 二、ZCode 插件：在 ZCode 里指挥她

装好插件后，你可以在 ZCode 对话框里用 `/pet` 指令遥控桌宠、投喂、聊天。聊天时 AI 会扮演德克萨斯本人（冷面寡言风），每次互动都会累积心情和信赖度。

### 安装（只在 ZCode 里点几下）

1. 打开 ZCode，进入 **插件市场**
2. 点 **添加 → 添加插件市场**
3. 粘贴这个目录（就是本仓库的 `plugins` 文件夹）：
   ```
   E:\无是霉山\Documents\cy\plugins
   ```
   （如果是 clone 到了别的电脑，就填那台电脑上仓库里 `plugins` 文件夹的完整路径）
4. 添加成功后，到 **个人** 页签找到市场 `dev-cy-71b1960a` 里的 **德克萨斯桌宠**，点 **安装**
5. **新建一个任务**，插件就生效了

> 以后改了插件源码：先改 `plugins/texas-pet/` 里的文件并把 `plugin.json` 里的版本号 +0.0.1，再到 插件市场 → 齿轮 → 市场源 → 刷新，回"个人"页签点更新。

### `/pet` 指令怎么用

在输入框打 `/pet` 后面跟你想做的事：

| 你输入 | 会发生什么 |
|---|---|
| `/pet` | 查看她的状态，她跟你打招呼 |
| `/pet 启动` | 帮你把桌宠启动到桌面上 |
| `/pet 退出` | 关掉桌面上的桌宠 |
| `/pet 开始散步` / `/pet 停下` | 让她走起来 / 站住 |
| `/pet 回角落` | 她回到屏幕右下角 |
| `/pet 投喂` | 桌面上的她吃 Pocky，冒台词 |
| `/pet 摸摸头` | 心情 +1 信赖 +1，她会别扭一下 |
| `/pet 聊聊天` | 她用德克萨斯的口吻回你几句 |

也可以自然一点：`/pet 今天心情怎么样？`、`/pet 给她一块 Pocky`，AI 都能听懂。

每次互动后，AI 会回你一个这样的状态块：

```
＿＿＿＿＿＿＿＿＿＿
ﾍ(˘•ω•˘)ﾉ🎧  德克萨斯
心情 98/100 · 信赖 26/100
正在：贴着屏幕散步
```

### 好感度规则

心情和信赖存在 `桌宠/state.json`，桌宠本体和 ZCode 插件**共用同一份数据**：在桌面上戳她、在 ZCode 里摸她，涨的是同一个信赖。摸头/戳一戳 +1，投喂 Pocky 心情 +5，聊天心情 +1，冷落她 -1，封顶 100。

---

## 三、常见问题（小白必读）

**Q1：双击 bat 后没反应 / 提示端口占用？**
桌宠已经在跑了——看看右下角。想重启就先右键她退出，再双击 bat。
程序启动需要几秒（首次更慢），等 5~10 秒再看看桌面。

**Q2：双击后一闪就没 / 完全起不来？**
九成是缺 Python 库。打开 cmd 执行 `pip install pywebview PySide6 qtpy` 再试。
还不行就把报错截图发给 AI 帮你看。

**Q3：她怎么是半透明的灰块 / 看不见她？**
程序用的是 Qt 透明窗口方案，个别老显卡可能渲染异常。更新显卡驱动，或把报错发给 AI。

**Q4：能让她开机自动出现吗？**
可以：`Win + R` 输入 `shell:startup` 回车，把 `桌宠/启动桌宠.bat` 的**快捷方式**（右键 → 发送到 → 桌面快捷方式，再剪切过来）放进打开的文件夹。

**Q5：怎么换别人（阿米娅/能天使/拉普兰德）当桌宠？**
素材已经打包在 `桌宠/assets/characters/` 里了，但目前程序只写死了德克萨斯。想要的话在 ZCode 里跟 AI 说一声，改动不大。

**Q6：桌面上的她挡住我点别的东西怎么办？**
她窗口的空白部分是"穿透"不了的，把她拖到角落，或者暂时 `/pet 退出`。

---

## 四、给进阶玩家的：遥控接口

桌宠本地开了一个 HTTP 接口（`127.0.0.1:27123`），脚本/AI 可以直接调用：

| 操作 | 命令 |
|---|---|
| 查状态 | `curl http://127.0.0.1:27123/status` |
| 投喂 | `curl -X POST http://127.0.0.1:27123/action -d "{\"action\":\"feed\",\"food\":\"pocky\"}"` |
| 戳一戳 | 同上，`action` 换成 `poke` |
| 开始散步 / 停下 | `walk_start` / `walk_stop` |
| 回右下角 | `home` |
| 退出 | `curl -X POST http://127.0.0.1:27123/stop` |

动作说明：`feed`（投喂，可带 `food`：`pocky` 或其他）、`poke`（戳）、`chat`（聊天，只加心情）、`neglect`（冷落，心情 -1）、`walk_start`、`walk_stop`、`home`。养成数值统一由桌宠进程原子写入 `桌宠/state.json`。

## 五、文件结构

```
cy/
├── README.md            ← 本指南
├── 网页/                 ← 干员小人网页（双击 index.html 或本地起服务看）
├── 桌宠/
│   ├── 启动桌宠.bat      ← 双击启动
│   ├── 德克萨斯桌宠.py    ← 窗口壳 + 遥控接口
│   ├── pet.html / pet.js ← 渲染与行为（官方 Spine 动画）
│   ├── state.json        ← 心情/信赖/投喂次数（自动生成）
│   └── assets/           ← 官方骨骼动画素材（4 位干员都在）
└── plugins/
    ├── marketplace.json  ← 本地插件市场清单
    └── texas-pet/        ← ZCode 插件（/pet 指令）
```

## 六、致谢

- 德克萨斯等骨骼动画素材版权归 **鹰角网络 / Hypergryph** 所有，本项目仅为个人学习娱乐使用。
- 语音素材为阿米娅官方配音（`网页/assets/mascot/voice/`），桌宠未使用。
- 渲染基于 pixi.js 与 pixi-spine，窗口基于 pywebview + PySide6。