# DEV-FISH

**Repository Path**: luoshupeng/dev-fish

## Basic Information

- **Project Name**: DEV-FISH
- **Description**: 一个充满趣味的 VSCode 扩展，帮助开发者在工作中进行有意义的休息。灵感来自中文"摸鱼"的概念，将休息时间转变为有趣的微体验。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dev Fish 🐠 - 摸鱼助手

一个充满趣味的 VSCode 扩展，帮助开发者在工作中进行有意义的休息。灵感来自中文"摸鱼"的概念，将休息时间转变为有趣的微体验。

## 功能特性

### 🐠 虚拟鱼缸
- 在 VSCode 侧边栏中拥有自己的虚拟水族馆
- 可以喂食、命名和与数字鱼互动
- 鱼会根据你的照顾程度做出反应
- 实时显示鱼的幸福度、饥饿度和年龄

### ⏱️ 休息计时器
- 番茄工作法风格的休息计时器
- 完成休息可解锁成就和奖励
- 追踪连续休息日数
- 状态栏实时显示剩余时间

### 📚 开发者智慧
- 精选的编程引言和开发者笑话
- 可自定义的分类（励志、编程智慧、哲学等）
- 保存你喜欢的智慧语录
- 随时获取灵感和放松

### 🎮 游戏化系统
- 解锁成就（第一次休息、连续 7 天等）
- 收集鱼的皮肤和水缸装饰
- 追踪休息统计和进度

### 🌊 水缸管理
- 添加多条鱼到你的水族馆
- 为鱼命名和重命名
- 清洁水缸以维持水质
- 实时显示水缸健康状态

## 快速开始

### 安装

1. 在 VSCode 中打开扩展市场
2. 搜索 "Dev Fish"
3. 点击安装

### 使用

1. 点击左侧活动栏的鱼图标打开水族馆
2. 使用命令面板（Ctrl+Shift+P）访问所有功能：
   - `Dev Fish: 开始休息` - 开始一个休息会话
   - `Dev Fish: 喂鱼` - 喂食你的鱼
   - `Dev Fish: 打开智慧信息流` - 获取灵感
   - `Dev Fish: 添加鱼` - 添加新的鱼到水族馆
   - `Dev Fish: 显示统计` - 查看你的统计信息

## 配置

在 VSCode 设置中配置 Dev Fish：

```json
{
  "devFish.breakDuration": 5,           // 默认休息时长（分钟）
  "devFish.soundEnabled": true,         // 启用音效
  "devFish.notificationsEnabled": true  // 启用通知
}
```

## 功能详解

### 虚拟鱼缸
- **喂食**：点击"喂食所有鱼"按钮或与鱼互动
- **清洁**：点击"清洁水缸"按钮维持水质
- **监控**：实时查看鱼的状态和水缸健康度

### 休息计时器
- **开始**：使用命令 `Dev Fish: 开始休息`
- **暂停/恢复**：点击状态栏中的计时器
- **取消**：使用命令 `Dev Fish: 取消休息`

### 智慧信息流
- **随机获取**：使用命令 `Dev Fish: 打开智慧信息流`
- **保存**：点击"保存"按钮收藏喜欢的语录
- **浏览**：使用"下一条"按钮浏览更多内容

## 统计信息

使用 `Dev Fish: 显示统计` 命令查看：
- 总休息次数和时长
- 连续休息日数
- 水族馆统计
- 智慧收藏数

## 设计理念

Dev Fish 基于以下理念设计：

1. **休息是必要的** - 健康的休息是维持高效工作的关键
2. **摸鱼无罪** - 将休息框架化为有意义的活动
3. **趣味性** - 通过游戏化和虚拟宠物增加参与度
4. **开发者文化** - 融合编程幽默和开发者智慧

## 技术栈

- **TypeScript** - 类型安全的开发
- **VSCode Extension API** - 深度集成
- **Canvas** - 流畅的动画效果
- **UUID** - 唯一标识符生成

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT License

## 致谢

感谢所有使用和支持 Dev Fish 的开发者！

---

**记住：摸鱼不是浪费时间，是在思考人生。🐠**