# rtcn的小脚本

**Repository Path**: rtccn_mc/rtcns-small-scripts

## Basic Information

- **Project Name**: rtcn的小脚本
- **Description**: 用于存放一些脚本之类的小东西
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Termux + GLM 翻译代理系统

## 简介

在 Android 手机的 **Termux** 环境中运行 Python 翻译代理服务，配合 **Kiwi 浏览器** + **Violentmonkey** 用户脚本，实现网页实时翻译。

### 系统架构

```
Kiwi 浏览器 (Violentmonkey 脚本)
       │  fetch 请求文本
       ▼
Termux (Python Flask 代理)
       │  调用 GLM API 翻译
       ▼
智谱 GLM 大模型
```

## 文件说明

| 文件 | 说明 |
|------|------|
| `proxy_smart.py` | Python 服务端，单文件包含所有功能 |
| `Termux代理翻译.js` | Violentmonkey 用户脚本，直接复制使用 |

## 快速开始

### 1. 服务端（Termux 中运行）

```bash
# 安装依赖
pip install flask flask-cors requests

# 运行代理（首次自动进入配置向导，输入 API Key）
python proxy_smart.py
```

### 2. 用户脚本（Kiwi 浏览器中安装）

- 打开 Violentmonkey 管理面板
- 新建脚本，将 `Termux代理翻译.js` 内容粘贴进去保存
- 打开任意网页，右下角出现 🚀 代理翻译 按钮即成功

### 3. 配置自定义

- 代理地址默认为 `127.0.0.1:8082`，可在 Violentmonkey 脚本设置中修改 `proxyIp` 和 `proxyPort` 值
- 目标语言通过页面右下角的下拉选择器切换

## 核心功能

- **多 API Key 并发**：自动轮询多个 Key，提高翻译速度
- **SQLite 缓存**：重复内容直接返回，节省 API 额度
- **智能语言检测**：采样检测页面语言，中文页面自动跳过
- **长文本分割**：按段落和句子智能分割，保持语义完整
- **代码过滤**：自动识别并跳过 JS 代码、UserScript 源码等
- **URL 跳过持久化**：已翻译页面刷新后自动跳过
- **SPA 动态内容**：MutationObserver 自动翻译新加载的内容
- **页面可见性检测**：切换到后台自动停止翻译
- **可拖动 UI**：按钮和状态栏均可拖动

## 技术细节

- 服务端监听 `127.0.0.1:8082`（仅本地访问）
- 中文检测算法：移除非中英文字符 → 长度<5返回False → 中文占比>25%判定为中文
- 页面语言判定：采样前30个文本节点，>30%样本含中文则判定为中文页面
- 默认并发：每 Key 3 线程，兼顾速度和手机发热