# TranSnow

**Repository Path**: Chato/tran-snow

## Basic Information

- **Project Name**: TranSnow
- **Description**: 简洁翻译软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TranSnow

TranSnow 是一个基于 .NET 8 + WPF 的桌面翻译工具，支持本地 Ollama 与 OpenAI 兼容接口（SiliconFlow、DeepSeek、Qwen），并提供 MySQL 历史记录与操作日志。

## 功能特性

- 多模型翻译：Ollama、本地/云端 OpenAI 兼容服务
- 翻译历史：分页浏览、关键词与日期筛选、单条删除
- 操作历史：记录数据库操作日志
- 数据库优先开关：可选择是否优先命中缓存
- 托盘常驻与快捷键唤起

## 技术栈

- .NET 8 + WPF
- CommunityToolkit.Mvvm
- MySql.Data
- NHotkey.Wpf
- Hardcodet.NotifyIcon.Wpf

## 项目结构

- TranSnow/Models：数据模型
- TranSnow/ViewModels：MVVM 视图模型
- TranSnow/Views：设置窗口
- TranSnow/Services：翻译服务、缓存与配置
- TranSnow/MainWindow.xaml：主界面
- TranSnow/App.xaml：应用入口与托盘/热键

## 配置说明

所有可配置项都存放在 TranSnow/.env 中，不应提交到远程仓库。常用键如下：

- DEFAULT_TARGET_LANGUAGE
- SELECTED_PROVIDER
- PRIORITIZE_DATABASE_QUERY
- OLLAMA_BASE_URL
- OLLAMA_MODEL
- SILICONFLOW_API_KEY
- SILICONFLOW_BASE_URL
- SILICONFLOW_MODEL
- DEEPSEEK_API_KEY
- DEEPSEEK_BASE_URL
- DEEPSEEK_MODEL
- QWEN_API_KEY
- QWEN_BASE_URL
- QWEN_MODEL
- MYSQL_SERVER
- MYSQL_PORT
- MYSQL_DATABASE
- MYSQL_USERNAME
- MYSQL_PASSWORD
- MYSQL_CHARSET
- MYSQL_CONNECTION_STRING
- HOTKEY_ENABLED
- HOTKEY_KEY
- HOTKEY_MODIFIERS

示例（请替换为你自己的值）：

```
DEFAULT_TARGET_LANGUAGE=Chinese
SELECTED_PROVIDER=Ollama
PRIORITIZE_DATABASE_QUERY=true
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=llama3
SILICONFLOW_API_KEY=your_key
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1
SILICONFLOW_MODEL=Qwen/Qwen2.5-7B-Instruct
DEEPSEEK_API_KEY=your_key
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL=deepseek-chat
QWEN_API_KEY=your_key
QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
QWEN_MODEL=qwen-plus
MYSQL_SERVER=localhost
MYSQL_PORT=3306
MYSQL_DATABASE=transnow
MYSQL_USERNAME=root
MYSQL_PASSWORD=your_password
MYSQL_CHARSET=utf8mb4
MYSQL_CONNECTION_STRING=Server=localhost;Port=3306;Database=transnow;Uid=root;Pwd=your_password;SslMode=None;
HOTKEY_ENABLED=true
HOTKEY_KEY=S
HOTKEY_MODIFIERS=Ctrl+Alt
```

## 运行方式

前置要求：

- Windows 10/11
- .NET 8 SDK
- MySQL（用于历史记录）
- Ollama（如使用本地模型）

命令行运行：

```
dotnet restore
dotnet run --project TranSnow/TranSnow.csproj
```

Visual Studio 运行：

- 打开 TranSnow.sln
- 还原 NuGet 包后直接启动

## 使用说明

- 唤起/隐藏：托盘双击或快捷键（默认 Ctrl+Alt+S）
- 翻译：输入文本后按 Alt+Enter 或点击 Translate
- 历史：右上角点击“历史”展开侧栏，可筛选与删除
- 数据库优先开关：主界面“优先查询数据库”开关