Skip to content

README.md

Latest commit

 

History

History
146 lines (104 loc) · 4.67 KB

README.md

File metadata and controls

146 lines (104 loc) · 4.67 KB
Raw

ScriptHub

ScriptHub 是一个 Windows 托盘小工具，用来集中管理轻量级桌面自动化脚本。

当前内置两个模块：

  • QQ 音乐桌面歌词自动显示 / 隐藏
  • Codex 额度小窗

项目目标是把零散的小脚本做成一个安静、可开机自启、可托盘管理的本地程序，避免多个脚本窗口常驻桌面。

功能

QQ 音乐桌面歌词

  • 播放时自动显示 QQ 音乐桌面歌词。
  • 暂停或停止时自动隐藏 QQ 音乐桌面歌词。
  • 退出 ScriptHub 时恢复桌面歌词显示，避免状态残留。
  • 使用 QQ 音乐自己的 Ctrl + Alt + W 桌面歌词快捷键切换，不通过遮挡窗口模拟隐藏。
  • 切歌时先等待播放状态稳定；用户正在输入或操作时延后发送 QQ 音乐快捷键，避免打断当前输入。

使用前需要确认 QQ 音乐里“显示/隐藏桌面歌词”的快捷键是 Ctrl + Alt + W。“自动打开歌词”不是硬性依赖；如果希望完全由 ScriptHub 控制播放时显示、暂停时隐藏，可以关闭 QQ 音乐自己的自动打开歌词。

Codex 额度小窗

  • 通过本机 codex.exe app-server 读取 Codex 当前账号的结构化额度数据。
  • 显示 5 小时额度和每周额度，渲染成简洁的小窗。
  • 显示当前时间、日期和星期。
  • 显示到下次重置的倒计时、精确重置时间和数据读取状态。
  • 支持启动时自动打开。
  • 支持按配置间隔查询额度；更新时只改变数字和进度条，不会重载网页。

需要先在 Codex 桌面端完成登录。ScriptHub 不读取或保存 ChatGPT Cookie、浏览器登录态或访问令牌。

环境要求

  • Windows
  • PowerShell
  • .NET Framework C# 编译器 csc.exe
  • 已安装并登录 Codex 桌面端

ScriptHub 会优先使用 Codex 桌面端安装的 CLI；如安装在自定义位置，可以设置环境变量 SCRIPTHUB_CODEX_EXE 指向 codex.exe。

快速开始

克隆仓库后，在项目根目录运行：

Copy-Item .\config\settings.example.ini .\config\settings.ini
.\scripts\build.ps1
.\ScriptHub.exe

构建完成后，ScriptHub 会出现在系统托盘中。

使用方式

  • 右键托盘图标打开菜单。
  • 在菜单中启用或暂停 QQ 音乐歌词模块。
  • 在菜单中打开 Codex 额度小窗。
  • 可以从菜单暂停全部脚本、重新加载配置、打开日志目录或退出程序。
  • 双击托盘图标会打开项目目录。

配置说明

本地配置文件是 config/settings.ini。仓库只提交 config/settings.example.ini 作为模板。

常用配置项：

qqMusicLyrics.enabled=true
qqMusicLyrics.pollIntervalMs=800
qqMusicLyrics.minActionGapMs=1200
qqMusicLyrics.userIdleGuardMs=1500
qqMusicLyrics.playbackSettleMs=1200

codexQuota.width=1094
codexQuota.height=496
codexQuota.x=-1
codexQuota.y=-1
codexQuota.openOnStartup=true
codexQuota.refreshIntervalMinutes=5

说明：

  • qqMusicLyrics.enabled：是否启用 QQ 音乐桌面歌词自动隐藏。
  • qqMusicLyrics.pollIntervalMs：检测播放状态的间隔。
  • qqMusicLyrics.minActionGapMs：两次切换歌词状态之间的最小间隔。
  • qqMusicLyrics.userIdleGuardMs：最近有键盘或鼠标操作时不发送 QQ 音乐快捷键，默认 1500 毫秒。
  • qqMusicLyrics.playbackSettleMs：播放状态切换后等待桌面歌词状态稳定的时间，默认 1200 毫秒。
  • codexQuota.width / codexQuota.height：额度小窗大小。
  • codexQuota.x / codexQuota.y：额度小窗位置，设为 -1 时使用系统默认位置。
  • codexQuota.openOnStartup：ScriptHub 启动时是否自动打开额度小窗。
  • codexQuota.refreshIntervalMinutes：查询额度的间隔，设为 0 可关闭定时查询；右键小窗或按 F5 可立即刷新。

构建

在项目根目录运行：

.\scripts\build.ps1

构建脚本会：

  • 使用系统自带的 .NET Framework C# 编译器生成 ScriptHub.exe。
  • 如果 ScriptHub 已经在运行，构建后会自动重启它。

开机自启

安装或移除开机启动脚本：

.\scripts\install-startup.ps1
.\scripts\uninstall-startup.ps1

安装脚本会在当前用户的 Windows 启动目录中创建一个 VBS 启动器，用于静默启动 ScriptHub.exe。

目录结构

ScriptHub/
  config/
    settings.example.ini
  scripts/
    build.ps1
    install-startup.ps1
    uninstall-startup.ps1
  src/
    Program.cs
  README.md

Git 管理

仓库只提交源码、脚本、README 和配置模板。以下内容会被忽略：

  • ScriptHub.exe
  • config/settings.ini
  • data/
  • logs/
  • modules/

这样可以避免把本地登录状态、日志、下载缓存和生成文件提交到仓库。