# moyu

**Repository Path**: duzhili/moyu

## Basic Information

- **Project Name**: moyu
- **Description**: 你值得信赖的摸鱼神器
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 摸鱼浏览器 🚀

一款支持全局快捷键快速显示/隐藏的浏览器，专为需要快速切换工作状态的用户设计。基于 Electron 开发，支持 Windows 和麒麟系统。

## 项目简介

摸鱼浏览器是一款轻量级的桌面浏览器应用，核心特性是通过全局快捷键实现浏览器窗口的快速显示和隐藏。当你需要快速浏览网页又不想被发现时，只需按住快捷键即可显示浏览器，松开快捷键自动隐藏，非常适合办公场景使用。

## 已实现功能 ✅

### 核心功能
- **全局快捷键控制**
  - 默认快捷键：`Alt+Q`
  - 按住快捷键显示浏览器，松开自动隐藏
  - 窗口失去焦点自动隐藏
  - 窗口始终置顶显示

- **多标签页支持**
  - 支持同时打开多个标签页
  - 标签页标题自动更新
  - 点击标签切换页面
  - 关闭标签按钮
  - 新建标签页按钮
  - `target="_blank"` 链接自动在新标签页打开（不弹出新窗口）

- **浏览器基础功能**
  - 前进/后退导航
  - 刷新页面
  - 主页按钮
  - 地址栏输入
  - 自动识别 URL 格式
  - 搜索关键词自动跳转百度搜索

- **历史记录管理**
  - 自动记录访问历史
  - 显示页面标题、URL 和访问时间
  - 点击历史记录快速访问
  - 清空历史记录功能
  - 本地持久化存储（最多保存 100 条）

- **媒体控制**
  - 窗口隐藏时自动暂停视频/音频播放
  - 窗口显示时恢复音频
  - 防止后台继续播放

- **设置功能**
  - 自定义全局快捷键
  - 可视化快捷键录制
  - 实时快捷键预览
  - 配置持久化保存
  - 检查更新功能（支持 GitHub Releases 和自定义 API）
  - 显示当前版本号

- **导航页**
  - 默认打开自定义导航页：`http://47.109.23.107/navigation.html`
  - 分类管理（常用搜索、社交媒体、开发工具、视频娱乐等）
  - 快速搜索功能
  - 编辑模式（添加/删除分类和链接）
  - 数据本地存储

### 界面特性
- 无菜单栏设计
- 简洁的工具栏
- 标签页横向滚动
- 响应式布局
- 友好的视觉反馈

### 技术特性
- 基于 Electron 40.2.1
- 使用 webview 标签实现多标签页
- IPC 进程间通信
- localStorage 数据持久化
- 支持打包为 Windows exe 和 Linux deb/rpm/AppImage

## 待实现功能 📋

### 高优先级

1. **书签管理**
   - 添加/删除书签
   - 书签文件夹分类
   - 书签导入/导出
   - 书签搜索

2. **下载管理**
   - 下载进度显示
   - 下载历史记录
   - 下载文件管理
   - 下载路径设置

3. **隐私模式**
   - 无痕浏览模式
   - 不保存历史记录
   - 不保存 Cookie
   - 退出时清除数据

4. **快捷键优化**
   - 支持更多快捷键组合
   - 快捷键冲突检测
   - 系统级快捷键注册优化
   - 麒麟系统快捷键适配

### 中优先级

5. **标签页增强**
   - 标签页拖拽排序
   - 标签页固定功能
   - 标签页静音
   - 关闭其他标签页
   - 恢复关闭的标签页

6. **浏览器设置扩展**
   - 默认搜索引擎选择
   - 主页地址自定义
   - 缓存管理
   - Cookie 管理
   - 用户代理设置

7. **性能优化**
   - 标签页懒加载
   - 内存占用优化
   - 启动速度优化
   - 标签页数量限制

8. **安全功能**
   - HTTPS 强制跳转
   - 不安全网站警告
   - 广告拦截
   - 恶意网站拦截

### 低优先级

9. **主题定制**
   - 深色模式
   - 自定义主题颜色
   - 工具栏自定义

10. **扩展功能**
    - 截图功能
    - 网页翻译
    - 阅读模式
    - 网页打印

11. **同步功能**
    - 书签云同步
    - 历史记录同步
    - 设置同步
    - 多设备支持

12. **开发者工具**
    - 内置开发者工具
    - 控制台快捷键
    - 网络请求查看

## 技术栈

- **框架**: Electron 40.2.1
- **语言**: JavaScript (Node.js)
- **UI**: HTML5 + CSS3
- **打包**: electron-builder
- **支持平台**: Windows 10/11, 麒麟系统（未测试）, Linux（未测试）

## 快速开始

### 安装依赖
```bash
npm install
```

### 开发运行
```bash
npm start
```

### 打包应用

**Windows 版本：**
```bash
npm run build:win
```

**麒麟系统/Linux 版本：**
```bash
npm run build:linux
```

**同时打包所有平台：**
```bash
npm run build:all
```

详细打包说明请查看 [BUILD.md](BUILD.md)

## 项目结构

```
moyu/
├── main.js                 # 主进程入口
├── package.json           # 项目配置
├── src/
│   ├── index.html        # 浏览器主界面
│   ├── renderer.js       # 渲染进程逻辑
│   ├── settings.html     # 设置页面
│   ├── settings.js       # 设置页面逻辑
│   ├── navigation.html   # 导航页
│   └── navigation.js     # 导航页逻辑
├── build/                # 图标资源（可选）
│   ├── icon.ico         # Windows 图标
│   └── icon.png         # Linux 图标
└── dist/                 # 打包输出目录
```

## 使用说明

1. **首次启动**
   - 应用启动后窗口默认隐藏
   - 按 `Alt+Q` 显示浏览器

2. **快捷键使用**
   - 按住 `Alt+Q`：显示浏览器
   - 松开 `Alt+Q`：隐藏浏览器
   - 点击其他窗口：自动隐藏

3. **修改快捷键**
   - 点击工具栏的 ⚙️ 设置按钮
   - 点击快捷键输入框
   - 按下新的快捷键组合
   - 点击保存

4. **多标签页**
   - 点击 `+` 按钮新建标签页
   - 点击标签切换页面
   - 点击标签上的 `×` 关闭标签
   - 网页中的新窗口链接自动在新标签页打开

5. **历史记录**
   - 点击工具栏的 📜 按钮查看历史
   - 点击历史记录项快速访问
   - 点击清空按钮删除所有历史

## 配置文件

应用配置保存在用户数据目录：
- **Windows**: `%APPDATA%/moyu/config.json`
- **Linux**: `~/.config/moyu/config.json`

历史记录和导航数据保存在 localStorage 中。

## 更新检查

应用支持自动检查更新，需要配置更新 API：

在 `src/settings.js` 中修改 `UPDATE_CHECK_URL`：
- GitHub Releases: `https://api.github.com/repos/YOUR_USERNAME/YOUR_REPO/releases/latest`
- 自定义服务器: `https://yourdomain.com/api/version.json`

## 已知问题

1. **麒麟系统快捷键**
   - 全局快捷键在某些麒麟系统版本上可能需要手动配置系统权限
   - 建议在系统设置中手动绑定快捷键

2. **窗口隐藏**
   - 在某些 Linux 桌面环境下，窗口隐藏可能不够快速
   - 建议使用 KDE 或 GNOME 桌面环境

3. **视频播放**
   - 某些网站的视频可能无法自动暂停
   - 这取决于网站的视频播放器实现

## 贡献指南

欢迎提交 Issue 和 Pull Request！

### 开发建议
1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

ISC License

## 作者

dzl

## 更新日志

### v1.0.0 (2024-02-10)
- ✨ 初始版本发布
- ✅ 全局快捷键控制
- ✅ 多标签页支持
- ✅ 历史记录管理
- ✅ 媒体自动暂停
- ✅ 设置页面
- ✅ 导航页
- ✅ 支持 Windows 和麒麟系统

## 联系方式

如有问题或建议，请提交 Issue 或联系作者。

---

**注意**: 本项目仅供学习交流使用，请遵守相关法律法规，合理使用。