# FiendKey

**Repository Path**: Silvary/fiend-key

## Basic Information

- **Project Name**: FiendKey
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FriendKey - 按键小助手

## 简介

FriendKey 是一款轻量级的按键自动化工具，专为需要重复按键的游戏场景设计，如《暗黑破坏神3》等ARPG游戏。通过预设按键序列，实现技能的自动循环释放，解放双手，提升游戏体验。

## 功能特性

- **按键序列配置** - 自定义多个按键的执行顺序、按下时长和间隔时间
- **全局热键控制** - 一键启停服务，默认 F6，支持自定义热键组合
- **无限循环** - 支持设置循环次数，0 表示无限循环
- **系统托盘运行** - 最小化后在后台运行，不占用任务栏
- **配置自动保存** - 按键设置自动保存，下次启动自动加载

## 使用方法

### 1. 添加按键

点击 **"+ 添加"** 按钮，在弹出的窗口中：

| 参数 | 说明 |
|------|------|
| 按键 | 点击输入框后按下想要设置的按键 |
| 按下时长(ms) | 按键按住的时间，一般 50-100ms 即可 |
| 间隔(ms) | 当前按键与下一个按键之间的时间间隔 |
| 循环次数 | 0 = 无限循环，其他数值为指定次数 |
| 启用 | 是否执行该按键 |

### 2. 编辑/删除按键

- **编辑** - 双击列表中的某一行
- **删除** - 选中行后点击 **"- 删除"** 按钮

### 3. 设置全局热键

在顶部热键区域，点击 **"修改热键"**，然后按下想要的按键组合（如 Ctrl+F6）。

### 4. 调整轮次间隔

在热键设置旁边可以调整"轮次间隔"，即一轮按键序列执行完毕后，等待多久开始下一轮。

### 5. 启动服务

- 点击 **"启动"** 按钮
- 或按下全局热键（默认 F6）
- 启动后状态显示为"运行中..."

### 6. 最小化到托盘

点击窗口关闭按钮或最小化按钮，程序会自动缩到系统托盘继续运行。双击托盘图标可恢复窗口。

## 典型配置示例

以《暗黑破坏神3》为例，假设技能键位为 1、2、3、4：

| 按键 | 按下时长 | 间隔 | 说明 |
|------|----------|------|------|
| 1 | 50 | 500 | 主要技能 |
| 2 | 50 | 500 | 辅助技能 |
| 3 | 50 | 500 | 防御技能 |
| 4 | 50 | 2000 | 大招（冷却较长） |

轮次间隔设置为 500ms。

## 配置文件

配置保存在程序同目录下的 `config.json` 文件中，包含：
- 按键序列列表
- 全局热键设置
- 轮次间隔

删除该文件可恢复默认设置。

## 系统要求

- Windows 10 / 11
- .NET 10.0 Runtime

## 注意事项

- 部分游戏可能有反作弊机制，请在合规范围内使用
- 以管理员身份运行可获得更好的兼容性
- 按下时长和间隔不宜设置过短，建议不低于 50ms