Files
df-scope-hold/README.md
T
zhengchen.tao 407b63e45b
release / build (push) Cleared cancelled status from deprecated Gitea Actions runs
feat: GitHub Actions 构建后同步发布到 Gitea Releases
构建只在 GitHub windows-latest 上跑一次,产物通过 Gitea REST API 上传到
Gitea Releases,让国内无法访问 GitHub 的用户也能下载到 exe。

- .github/workflows/release.yml: 新增 Mirror release to Gitea 步骤,
  调用 /api/v1/repos/.../releases 创建发布并上传 zip 资产;
  GITEA_TOKEN 未配置时仅警告跳过,不阻断 GitHub release
- .gitea/workflows/release.yml: 删除。Gitea NAS 上的 Linux runner 无法
  交叉编译 Windows exe,本仓库不再使用 Gitea Actions
- README: 在下载步骤列出 Gitea / GitHub 双下载渠道
- CHANGELOG: v0.1.0 条目同步更新
2026-05-07 14:54:43 +08:00

4.0 KiB
Raw Permalink Blame History

df-scope-hold

三角洲行动(Delta Force)开镜自动屏息小工具——按住鼠标右键时自动按下指定按键(默认 F12),松开时释放。让你只用右键瞄准就能稳枪,不必再额外按一个键。

工作原理

监听鼠标右键事件,在右键按下时模拟键盘按下「屏息」键、右键松开时释放。脚本通过进程名识别游戏,只有游戏在运行时才激活监听,游戏关闭自动停止,重新进入会自动恢复。

仅支持「按住开镜」模式:脚本依赖鼠标右键的按下/松开事件触发屏息键的按下/释放,游戏内的开镜方式必须设为「按住」而不是「切换/按键开镜」。否则松开右键时屏息会被释放,但游戏仍处于开镜状态,行为不一致。

纯本地按键映射,等价于支持宏的游戏鼠标硬件功能;不读写游戏内存、不修改任何游戏文件、不与游戏服务器通信。

使用方法

1. 游戏内绑定屏息键

打开三角洲行动设置,把「屏息」绑定到一个不会和其他操作冲突的按键,例如 F12。记住这个按键。

2. 下载并解压

下载最新的 df-scope-hold-vX.X.X.zip,解压到任意目录。两个下载渠道任选其一:

zip 内含:

  • df-scope-hold.exe:主程序(已内嵌管理员权限 manifest,双击即弹 UAC
  • config.ini:默认配置
  • README.md:本说明

3. 修改配置文件

打开同目录下的 config.ini,按需调整:

[config]
key = f12                                              ; 与游戏内屏息绑定保持一致
delay_press = 5                                        ; 右键按下到模拟按键的延迟(毫秒)
program_running = DeltaForceClient-Win64-Shipping.exe  ; 游戏进程名(区分大小写)

4. 运行

双击 df-scope-hold.exeWindows 会弹出 UAC 提示申请管理员权限,必须允许。游戏客户端带反作弊保护通常以管理员权限运行,普通权限的进程无法检测到游戏进程。

启动后会在命令行窗口提示当前配置并等待游戏启动,游戏运行起来后开始监听,按 Ctrl+C 退出。

配置说明

字段 含义 取值示例
key 模拟的按键。普通字符直接写(a1),系统功能键用 pynput 的名称(shiftctrlf12 等) f12
delay_press 右键按下后等待多少毫秒再模拟按键。游戏场景建议 5–20ms,过低可能被游戏判定为指令冲突 5
program_running 游戏进程名(任务管理器里看到的 .exe 全名,区分大小写) DeltaForceClient-Win64-Shipping.exe

运行环境

Windows 单 exe 分发(约 10MB),由 PyInstaller 把 Python 解释器与依赖(pynputpsutil)一起打包进可执行文件,用户无需安装任何 Python 环境

仅在 Windows 上验证过(三角洲行动客户端为 Windows 独占)。

从源码运行(开发者)

pip install -r requirements.txt
python script.py

需要 Python 3.10+。日常使用直接下载 release 即可,无需自行构建。

自行构建

pip install -r requirements.txt
pyinstaller --onefile --uac-admin --console --name df-scope-hold script.py

产物在 dist/df-scope-hold.exe。仓库已配置 GitHub / Gitea Actions,推 v* tag 后自动构建并发布到 Releases,无需本地操作。

免责声明

  • 本脚本是纯本地的鼠标→键盘映射工具,原理与游戏鼠标厂商提供的宏功能完全一致
  • 但游戏厂商对第三方输入工具的政策可能变化,使用本脚本所产生的任何后果(包括但不限于封号)由使用者自行承担
  • 仅供个人自用与学习交流,请勿用于排位、赛事等竞技场景

License

MIT