# deepseek大肥鱼

**Repository Path**: illusoryNone/deepfish

## Basic Information

- **Project Name**: deepseek大肥鱼
- **Description**: deepseek大肥鱼
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-29
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 蓝色大肥鱼桌宠（DeepFish Desktop Pet）

一只可爱的蓝色大肥鱼（DeepSeek 二创形象「鲸鱼娘」）桌宠。她会散步、洗碗、摸鱼、陪你加班，还会记住你的喜好，越聊越懂你。

> 底层为透明无边框 Electron 窗口，可置顶悬浮于所有窗口之上，自由拖动。

---

## 项目来源与致谢

本项目基于 GitHub 开源项目 **[Dolphin2026-stl/deepfish-desktop-pet](https://github.com/Dolphin2026-stl/deepfish-desktop-pet)**（MIT License）二次开发、深度优化而来。

灵感来源：DeepSeek V4 Pro 二创形象「鲸鱼娘·大肥鱼」。

> ⚠️ **侵权声明（侵删）**：本仓库所含角色形象、帧动画素材均源自原作者提供的开源素材，版权归其各自权利人所有。如原作者或权利人认为存在侵权，请联系仓库所有者，我们将立即删除相关素材与内容。

---

## 相比原版做了哪些优化与更新

### 🧠 用户画像与自我学习
- 从对话中自动识别你的名字、喜好、厌恶、作息习惯与语气风格
- 聊天后用 AI 总结提取结构化记忆（失败自动降级，不影响聊天）
- 对话时把画像注入 system prompt，大肥鱼会自然融入回应（称呼、避雷、记得偏好）
- 学到新内容时，她会气泡反馈「记住啦：…」

### 💬 AI 对话升级
- 聊天支持 MD 渲染：标题 / 加粗 / 代码块 / 列表 / 引用 / 安全链接（自研轻量渲染器，防 XSS）
- 修复长回复被截断的问题（`max_tokens` 80 → 2048，放宽字数限制，超时升至 60s）
- DeepSeek 余额查询：右键「查查余额」，大肥鱼气泡播报你的余额与赠送/充值明细
- AI 互动回应开关：点击 / 摸头 / 投喂时让大肥鱼用 DeepSeek 现编台词（带节流、失败自动降级）

### 🎭 去「机械感」
- 每个行为配 4~6 句台词变体，结合时段/好感度选句，避免相邻重复
- 空闲行为改为突发式节奏（长沉默 + 偶尔连发），更像活物
- 行为链：动作后按概率续接连贯小动作（全部可打断）
- AI 互动带画像与最近台词，避免复读

### 🕹 程序化动作库（不依赖新素材）
- 纯 CSS transform 画出新动作：果冻弹跳 / 摇头晃脑 / 转圈起舞 / 开心跳跃 / 打招呼 / 左右观察 / 果冻晃动
- 配套程序化特效层：爱心 / 泡泡 / 音符 / 闪星（纯 CSS 几何，零图片依赖）
- 「程序化表演」开关：作为大肥鱼自身的自发行为，表演过的动作会被记住（次数统计、持久化），后续更常表演「学会过」的动作

### 💾 持久化升级：SQLite
- 从 JSON 文件升级为 **better-sqlite3** 单库 `deepfish.db`（WAL 模式）
- 设置、记忆、对话历史、程序化动作记录全部落库，事务安全、多实例一致
- 自动迁移旧 JSON 数据，历史访问可用 SQL 查询

### 📋 对话记录（聊天面板抽屉）
- 聊天面板右上角 ☰ 打开对话记录抽屉
- 支持搜索、导出 Markdown、清空；实时刷新

### 🗂 办公文档助手（DeepSeek 模型 × 办公引擎）
- 在设置里开启「办公文档助手」后，让大肥鱼处理 Excel / Word / PPT：
  - 大肥鱼用 DeepSeek 规划调用，本机办公引擎（`@neuraforge/office-mcp`，纯 Node）真实读写文件
  - 支持建表、读表、写数据、改单元格、创建文档/PPT 等 30+ 文档工具
  - 完成后气泡汇报结果（文件路径 / 行数 / 错误信息）
- 隔离运行：办公引擎以 stdio 子进程方式调起，空闲超时自动回收

### ✨ 交互与稳定性
- 点击 / 摸头 / 投喂 / 拖拽等交互升级（冒爱心、转圈晕眩、好感度反馈）
- 气泡优先级调度 + 安静窗口，解决连发多条消息
- 好感度养成：初识 → 熟络 → 贴身 → 灵魂共鸣，逐级解锁专属台词与彩蛋
- 修复多处运行时问题（角色破图消失、设置切换丢记录、未知行为回退等）

### 📦 一键打包
- 新增 `build.ps1` 一键打包脚本：自动设置镜像、依赖检查、测试校验、产出 NSIS 安装版 + 便携版

---

## 快速开始

环境要求：Windows 10/11，Node.js 20+。

```powershell
npm install
npm start
```

或双击 `启动大肥鱼.cmd`（自动检测依赖并启动）。

### 一键打包

```powershell
.\build.ps1
```

产物输出到 `dist/`：
- `DeepFish-Pet-<版本>-x64-setup.exe` — NSIS 安装版
- `DeepFish-Pet-<版本>-x64-portable.exe` — 便携版（免安装）

---

## 交互方式

| 操作 | 效果 |
| --- | --- |
| 单击 | 摸摸头 / 好感度解锁彩蛋 |
| 双击 | 打开聊天面板 |
| 拖拽 | 移动位置（快速绕圈会转晕她） |
| 右键 | 聊天 / 报时 / 查余额 / 投喂 / 摸摸头 / 陪她玩 / 程序化表演 / 置顶 / 退出 |
| 悬停 | 打招呼（评论区体验身体区域感应） |
| `Enter` / 空格（聚焦时） | 打开聊天 |

---

## 聊天模型

- **免费模型**：Pollinations（免 Key）
- **DeepSeek**：填自己的 API Key（支持余额查询）
- **自定义**：任意 OpenAI 兼容 HTTPS Chat Completions 地址

API Key 使用系统加密存储（Electron `safeStorage`），不会明文落盘。

---

## 项目结构

```text
deepfish-desktop-pet/
├── assets/            # 帧动画素材（原项目素材）
├── scripts/           # 帧素材处理脚本（原项目）
├── src/
│   ├── main/          # 主进程：窗口、托盘、SQLite 存储、聊天客户端、记忆与学习
│   ├── renderer/      # 渲染层：桌宠行为、Markdown 渲染、对话记录抽屉、设置页
│   └── shared/        # 昼夜节律、行为库、手势、规则式信息提取（UMD 共享模块）
├── test/              # Node.js 单元测试
├── build.ps1          # 一键打包脚本
└── package.json
```

---

## 隐私与安全

- Electron 渲染进程开启 `contextIsolation` 沙箱，关闭 Node.js 集成
- 自定义 API 地址强制 HTTPS
- API Key 只存在于主进程（解密后发送给模型，不暴露给页面脚本）
- 记忆保存在本机 `%APPDATA%\deepfish-desktop-pet\deepfish.db`

## 许可证

本项目沿用原项目的 **[MIT License](./LICENSE)**。

> 角色素材版权归原作者所有，若侵权请联系删除。