# tools

**Repository Path**: xieluoyin/tools

## Basic Information

- **Project Name**: tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-18
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xly 浏览器

基于 Electron 的桌面工具集合，把日常零碎的小工具整合到一个应用里，按 Tab 在同一窗口中切换使用，避免在多个网页 / 软件之间来回跳转。

> 支持 Windows / Linux（macOS 未实测）。所有数据本地保存，无需联网即可使用除「云服务」「浏览器」外的功能。

---

## ✨ 功能概览

工具按用途分为 5 组，首页以卡片形式呈现，点击进入独立工具页。应用启动时默认打开 **浏览器** 标签（默认首页可在设置中配置，默认百度），全部工具页可由标签栏右上角 **⋯** 按钮随时打开。

> 🌐 **界面语言**：在「设置 → 界面语言」中可切换 **中文 / English**，切换后所有已打开页面自动刷新生效；语言保存在 `settings.json` 的 `language` 字段。英文词典位于 `app/js/i18n-en/`（以中文原文为 key），帮助页提供中文 / 英文双页。

### 🎵 影音娱乐

| 工具 | 简介 |
| --- | --- |
| **音乐播放器** | 播放本地音乐，支持播放列表、拖拽添加、音量调节、播放模式 |
| **视频播放器** | 播放本地视频，支持键盘快捷键、倍速播放、全屏、播放列表 |

### 🧩 效率工具

| 工具 | 简介 |
| --- | --- |
| **文件管理** | 收藏常用文件夹与文件，一键快速打开；可从百度网盘收藏中直接打开 |
| **网址管理** | 收藏常用网址，按分组管理，点击在「浏览器」工具中打开 |
| **浏览器** | 内置网页浏览器，**应用启动默认打开**（默认首页可在设置中配置）；可在设置中注册为系统默认浏览器候选，经系统设置确认后外部 http/https 链接将在本应用内打开；**自动嗅探页面视频**（MP4 / HLS / DASH）并一键下载；支持缩放记忆、UA/Referer 透传、断点续传、压缩响应解压；**网页主题可配置**（跟随系统 / 浅色 / 深色），修复系统深色模式下未适配深色的网页黑底看不清的问题 |
| **应用管理** | 查看本机已安装应用（注册表 + Microsoft Store），支持按名称 / 发布者搜索、按类型筛选与按名称 / 大小 / 安装日期排序，一键打开安装目录与卸载（支持 MSI 静默卸载）；仅支持 Windows |
| **性能监控** | 实时查看 CPU（总体 + 逐核 + 实时主频）、内存（含已提交 / 缓存 / 交换区细项）、磁盘各分区使用率、读写速度与忙碌率（物理磁盘级）、网络上下行速度、进程 Top 榜（按 CPU / 内存 / 磁盘切换，含进程级磁盘读写速率）、ACPI 温度传感器、进程 / 线程数及系统信息，占用分色提示，刷新间隔可调（1 / 2 / 5 秒），可暂停 |

### 💻 开发工具

| 工具 | 简介 |
| --- | --- |
| **PostgreSQL** | 连接 PostgreSQL 数据库，执行 SQL 查询与脚本；支持选择收藏夹中的 `.sql` 文件一键执行 |
| **JSON 工具** | JSON 格式化、压缩、校验、转义、树形浏览 |
| **XML 工具** | XML 格式化、压缩、校验、转义、树形浏览 |
| **Markdown 编辑器** | Markdown 编写与实时预览，支持表格、任务列表、代码高亮、自动保存（写入前做磁盘版本校验，同文件多入口不会开出重复标签） |
| **SQL 编辑器** | SQL 编辑整理（关键字大写、语句分行），语句目录跳转，支持打开/收藏收藏夹中的 SQL 文件 |
| **接口测试** | REST API 调试：方法 / 参数 / 请求头 / Body 编辑，JSON 响应高亮，请求历史自动保存 |

### ☁️ 云服务

| 工具 | 简介 |
| --- | --- |
| **百度网盘** | OAuth 授权登录后浏览、搜索、上传、转存、下载文件（单文件 / 整个文件夹 / 批量），视频 / 音频支持在线播放（MKV / TS 等经 ffmpeg 转封装）；支持收藏、置顶、删除、重命名、移动（可从网盘收藏选目标目录） |
| **SFTP 工具** | 连接 SFTP 服务器浏览远程文件，上传下载、收藏服务器与远程路径 |
| **SFTP 服务器** | 在本机开启 SFTP 服务，配置账号与根目录，供局域网客户端（WinSCP / FileZilla / sftp 命令）安全传输文件 |

### 📖 帮助

- **使用帮助**：各功能的详细使用说明。**不在工具列表内**，入口在**标签栏右上角 📖 按钮**（任何工具页都可见），点击会在新标签页打开。

---

## 🔥 特色功能详解

### 1. 浏览器页面视频嗅探与下载

打开任意含视频的网页，「页面视频」面板会自动列出探测到的资源（`<video>` 元素 / `m3u8` / `mpd` / 直链 `mp4`），点「下载」即可保存到本地：

- **自动跟随 302 重定向**，解决百度网盘 / CDN 多次跳转
- **解压 gzip / deflate / br 响应体**，避免抓到乱码
- **HLS (`m3u8`) 分片下载与合并**：先合并为临时 TS，再用内置 `ffmpeg` 转封装为真正的 MP4（转封装失败时自动回退保留 TS，保证文件不丢）
- **直链 `mp4` 走 Range 断点续传**，大文件不怕中断
- **续签 token**：每次下载前从 `webview` 内 `performance` / `currentSrc` 与主进程 `webRequest` 捕获到的最新 URL 中刷新签名链接，解决 m3u8 token 过期问题
- **防重复下载**：同一资源（按 base URL 去 query/hash）已在下载或已加入下载列表时，再次点击会提示且不重复发起
- **记忆最近保存目录**：保存对话框默认打开上次使用的目录
- **网页下载链接**：网页里点击下载（安装包 / 压缩包 / 文档等）仍弹系统「另存为」对话框，选定位置后自动进入「全局下载列表」，实时显示进度与速度，支持暂停 / 继续 / 取消；浏览器工具栏会显示下载进度条（点击可打开下载列表），开始与完成时页面给出轻提示，关闭标签页后任务仍在后台继续

### 2. 百度网盘

- 官方 OAuth2 授权登录，accessToken / refreshToken 本地保存
- 浏览网盘目录、搜索、新建文件夹、上传、转存到自己的网盘；支持从资源管理器拖拽文件到文件列表区域上传
- **排序**：点击表头按名称 / 类型 / 大小 / 修改时间排序，同一列连续点击循环切换「升序 → 降序 → 取消排序」，取消后恢复网盘原始顺序
- **在线播放**：视频（`mp4` / `webm` 等）与音频（`mp3` / `flac` 等）文件可直接点击「播放」在弹窗中边下边播，无需先下载；主进程在本地起代理转发网盘直链并透传 Range 请求，支持拖动进度条，直链过期自动刷新
- **在线播放（MKV/TS 等）**：`mkv` / `ts` / `flv` / `avi` / `mov` / `wmv` 等非原生格式经内置 ffmpeg **在线转封装**为 fMP4 流式播放（`-c copy` 无损，音轨不兼容时仅重编码音频）；顺序流不支持拖动进度条，需要快进请下载后播放；个别编码（如 RMVB）无法转封装时会提示下载
- **下载**：单文件、整个文件夹（保留目录结构）；勾选多个文件 / 文件夹后可 **批量下载** 到指定目录（同名自动加 `(1)/(2)` 序号），所有任务进入全局下载面板统一管理
- **收藏**：把网盘文件 / 文件夹加入「文件管理」收藏夹，跨工具联动
- **删除 / 重命名**：常规文件管理操作
- **移动**：把文件 / 文件夹移动到网盘其他目录；目标目录支持手动输入，或直接从「文件管理 → 网盘收藏」下拉选择
- **下载任务**：加入全局下载列表（标题栏下载按钮），实时进度、断点续传、暂停 / 继续 / 取消

### 3. 视频播放器

- 本地视频播放，支持 `mp4` / `mkv` / `webm` / `flv` / `ts` 等
- `flv` / `ts` 通过 `mpegts.js` 解封装
- 快捷键：空格 播放/暂停、← / → 快退/快进、↑ / ↓ 音量、N / P 上一首/下一首、F 全屏
- 左侧播放列表可收起 / 展开、导入 / 保存 / 重命名
- 拖拽文件或文件夹到窗口即可加入列表

### 4. 全局下载列表

- 任何工具的下载（百度网盘、浏览器嗅探、网页下载链接）都汇入统一下载面板
- 显示进度、速度、剩余时间、状态
- 暂停 / 继续 / 取消 / 打开文件 / 打开所在文件夹
- 标题栏下载按钮带角标，实时显示进行中的任务数

### 5. SQL 编辑器

- 打开 / 新建 / 保存 / 另存为 `.sql` 文件，支持从系统拖拽、文件管理打开
- **🧹 整理**：去除行尾空格、压缩空行、分号后换行、关键字自动大写
- **语句目录**：自动解析 `CREATE TABLE / INDEX / FUNCTION`、`SELECT`、`UPDATE`、`DELETE` 等语句，标注起始行号，点击跳转；随光标位置自动高亮当前语句，支持过滤、面板收起 / 展开
- **收藏与联动**：顶栏 ⭐ 收藏当前文件；左侧「收藏夹」页列出收藏的本地文件（分组折叠），点击 `.sql` 在当前编辑器打开、其他文件路由到对应工具；与文件管理 / 浏览器 / 百度网盘共用同一份 `favorites.json`，跨工具实时联动

### 6. SFTP 服务器

- 基于 `ssh2` 在本机开启 SFTP 服务，局域网内其他电脑即可用 WinSCP / FileZilla / `sftp` 命令连接上传下载
- **配置**：监听地址（默认 `0.0.0.0`）、端口（默认 `2222`）、根目录（本地文件夹）、用户账号（可增删多个）
- **沙箱隔离**：远程路径全部限定在根目录内，防目录穿越 / 盘符绕过，无法读写根目录之外的文件
- **仅开放文件传输**：拒绝 shell / exec / 其它子系统，安全收敛
- **兼容 WinSCP / PuTTY**：服务端主动禁用未实现的 `diffie-hellman-group-exchange` KEX，客户端会自动回退到 `curve25519-sha256` 或 `diffie-hellman-group14-sha256` 等标准算法
- **主机密钥**：首次启动自动生成 RSA 主机密钥并保存在应用配置目录，客户端首次连接需校验指纹
- 实时状态：运行状态、监听地址、在线连接数、上传 / 下载字节；运行日志实时滚动

### 7. 设为系统默认浏览器

- 在**设置 → 浏览器 → 默认浏览器**中可查看当前系统默认的 http/https 处理程序；点击按钮会向系统注册完整的浏览器候选信息（RegisteredApplications / Capabilities / StartMenuInternet，与 Chrome / Edge 同款机制），使本应用出现在系统「Web 浏览器」候选列表中
- 由于 Windows 8 起对 http/https 存在 UserChoice 保护机制，应用无法静默把自己设为系统默认浏览器，必须跳转到系统默认应用设置后由用户手动选择
- 设置完成后，外部应用点击的 http/https 链接会自动传入本应用，在浏览器工具的新标签页中打开
- 开发态（`npm start`）路径为 Electron 运行时，不建议设为默认浏览器，建议在打包安装版本上进行设置

---

## 🚀 快速开始

### 环境要求

- Node.js 14+
- npm 或 yarn

### 开发运行

```bash
# 克隆
git clone https://gitee.com/xieluoyin/tools.git
cd tools

# 安装依赖（首次）
npm install

# 启动应用
npm start
```

### Word 导出依赖

「Markdown 编辑器 → 导出 Word」**打包版完全无需用户安装任何依赖**：

- **Python** 运行时已嵌入：打包产物随带一份可重定位的 Python（基于官方 embeddable 包 + `python-docx` / `mammoth` / `beautifulsoup4` / `pygments` / `pillow`），无需 winget / 管理员权限 / 配置 PATH
- **Mermaid 图表**由 Electron 自带的 Chromium 渲染：渲染进程把 SVG 转成 PNG 交给 Python 直接插入 Word，整个流程不依赖 Node / Chrome / 系统命令

只有源码开发或自行构建时才需要 `md2docx/setup.cmd`（双击即跑，会自动装 Python 和 pip 依赖；加 `-WithMermaid` 可额外安装 `mermaid-cli` 作为命令行兜底，约 380MB，默认跳过）。

### 打包

```bash
# Windows (NSIS 安装包，会自动构建内置 Python 运行时)
npm run electron:buildWin

# Linux (x64，运行时走系统 Python)
npm run electron:buildLinux
```

Windows 打包前会自动执行 `md2docx/prepare-runtime.ps1`：下载官方 embeddable Python 并把依赖装到 `md2docx/runtime/python/`（gitignored，再次执行会复用）。如需在 Electron 里同步调试渲染，可单独跑 `npm run prepare:runtime`。

打包产物在 `dist/` 目录。Windows 使用 NSIS 安装器，安装目录可自定义。

---

## 🛠 技术栈

- **运行时**：[Electron 43](https://www.electronjs.org/)
- **视频播放**：[mpegts.js 1.8](https://github.com/xjchanson/mpegts.js)
- **视频转封装**：[ffmpeg-static](https://github.com/eugeneware/ffmpeg-static)（打包时 `asarUnpack`，运行时通过 `ffmpeg-static` 的 CLI 调用）
- **数据库**：[node-postgres (`pg`)](https://node-postgres.com/)
- **SFTP**：[ssh2](https://github.com/mscdex/ssh2)（客户端工具 + 服务器端协议实现）
- **模板引擎**：[art-template](https://aui.github.io/art-template/)
- **打包**：[electron-builder 26](https://www.electron.build/)

---

## 📁 目录结构

```
.
├── index.js                # Electron 主进程入口（IPC、协议、菜单、下载等）
├── index.html              # 主窗口加载入口（动态渲染 Tab）
├── package.json
├── app/                    # 渲染进程页面
│   ├── home.html           # 首页（工具卡片）
│   ├── tabs.html           # Tab 容器
│   ├── downloads.html      # 全局下载列表
│   ├── music/              # 音乐播放器
│   ├── video/              # 视频播放器
│   ├── browser/            # 内置浏览器 + 页面视频嗅探
│   ├── baidu/              # 百度网盘
│   ├── files/              # 文件管理（收藏夹）
│   ├── urls/               # 网址管理
│   ├── app-manager/        # 应用管理（已安装应用查看与卸载，仅 Windows）
│   ├── system-monitor/     # 性能监控（CPU / 内存 / 磁盘使用情况）
│   ├── pgsql/              # PostgreSQL 客户端
│   ├── json/  xml/         # JSON / XML 工具
│   ├── markdown/           # Markdown 编辑器
│   ├── sql/                # SQL 编辑器
│   ├── sftp-server/        # SFTP 服务器
│   ├── help/               # 使用帮助
│   ├── css/                # 全局样式
│   └── js/                 # 工具注册表 / 通用脚本
├── md2docx/                # Markdown ↔ Word 转换（打包版 runtime 由 prepare-runtime.ps1 生成；开发版 venv 由 setup.cmd 生成）
├── icons/                  # 应用图标
├── public/                 # 静态资源
└── android/                # Android 示例工程（各自独立的 Gradle 工程，不参与 Electron 打包）
    ├── lyric-music/        # 本地音乐播放器（Jetpack Compose）
    ├── time-note/          # 记事本（记录几点几分干了什么，分类 / 导入导出合并，Jetpack Compose）
    ├── video-player/       # 本地视频播放器（Jetpack Compose）
    ├── markdown-reader/    # Markdown 阅读器（View 体系）
    └── health-manager/     # 健康管理（血压·体重记录 / 趋势曲线 / BMI 计算，CSV·JSON 导入导出，SQLite 本地存储）
```

---

## ⚙️ 配置与数据

应用的配置统一存储在 `%APPDATA%\xly浏览器`（开发态 `npm start` 与打包安装后一致，卸载/重装不会丢失）。首次启动时会自动将旧位置（项目根目录 / 安装目录 / 旧 userData 目录，以及上一版本的 `%APPDATA%\工具箱`）的配置迁移过去。包含：

- `favorites.json` — 文件管理收藏（文件管理 / 浏览器 / 百度网盘 / SQL 编辑器 / PostgreSQL 等工具共用）
- `urls.json` — 网址管理收藏
- `pg-connections.json` — PostgreSQL 连接
- `sftp-connections.json` — SFTP 连接
- `api-history.json` — 接口测试请求历史
- `settings.json` — 应用设置（截图快捷键、浏览器默认首页、网页主题、界面语言等）
- `tool-groups.json` — 首页工具分组
- `passwords.json` — 浏览器密码保险箱（密码默认系统加密）
- `baidu-config.json` — 百度网盘凭据（含 accessToken / refreshToken，**已加入 `.gitignore`**，请勿提交）
- `video-save-dir.json` — 浏览器视频下载最近保存目录
- `browser-zoom.json` — 浏览器缩放记忆（按域名）
- `sftp-server-hostkey/` — SFTP 服务器主机密钥（RSA 私钥，首次启动自动生成；**敏感数据，不参与配置备份**）

以上配置均可通过「帮助 → 配置备份」的导出 / 导入一键打包迁移（主机密钥除外）。重装 / 卸载操作系统以外的场景不会丢失这些数据。

---

## 🧩 扩展

新增工具非常简单：在 `app/js/tools.js` 末尾的 `window.TOOLS` 数组中追加一项即可：

```js
{
  id: 'example',
  name: '示例工具',
  desc: '简要描述',
  icon: '🧩',
  page: 'example/index.html',
  accent: '#22c55e',
  group: 'dev'  // 对应 TOOL_GROUPS 的 id
}
```

然后在 `app/example/index.html` 实现页面即可。

新增 / 修改工具时同步维护中英文界面：页面第一个 `<script>` 引入 `app/js/i18n.js`；静态中文文案写入 `app/js/i18n-en/<工具>.js` 词典（key 为中文原文），JS 动态文案用 `t('中文')` / `t('{0} 个', n)` 包裹，并在 `app/js/i18n-manifest.js` 登记词典片段。

---

## 📏 贡献指南

**功能改了，文档必须同步改**。本项目要求任何功能改动都必须同步更新「使用帮助」与本文档，否则视为未完成。详细的变更检查清单、提交信息格式与开发流程见 [CONTRIBUTING.md](./CONTRIBUTING.md)。

---

## 📜 许可

[MIT](./LICENSE)