文档类型:使用手册 关联软件:FoxTimer 更新于 2026-09-30

使用手册

紧凑与展开双模式、计时器管理、提醒体系、显示定制与 Web 控制台的逐项操作说明。

日常怎么用、常见操作怎么做

1. 界面总览

FoxTimer 有三个界面形态,共用同一套数据:

形态 入口 用途
紧凑模式 启动默认 透明小窗只留数字与标题栏,叠加投屏
展开模式 双击标题栏 计时器列表 + 完整设置面板
Web 控制台 浏览器 http://<本机IP>:9527 局域网远程管理(计时器 / 设置 / 手册)

常用操作速查:

操作 方式
开始 / 暂停 单击计时器数字
停止并重置 双击计时器数字
切换计时器 紧凑模式点击标题栏下拉三角
展开 / 紧凑 双击标题栏
移动窗口 拖拽标题栏任意位置
打开设置 展开模式点击齿轮图标
退出应用 展开模式点击 X 按钮 → 确认

2. 计时器管理

  • 添加:展开模式「添加」按钮,选择正计时 / 倒计时并设置时长(分钟 0–120,秒步进 5),标签自动生成(如「15分0秒」「正计时 15分0秒」),可后续改名;
  • 切换:下拉菜单点选,或 Ctrl+F4 / Ctrl+F5(上一个 / 下一个);
  • 结束自动切换:任一计时器走完后自动切到队列下一项(待机不自动开始);
  • 正计时设目标:正计时可设目标时长,到达目标同样触发结束提醒与切换;
  • 进度恢复:计时进度(elapsedMs)实时保存(300ms 防抖),关窗重开后从原进度继续。

3. 快捷键

3.1 专属快捷键(每个计时器独立)

在设置面板为某个计时器绑定 Ctrl/Alt/Shift/Win + 任意键:按下后激活该计时器——停止其他计时器、将其重置并立即开始。适合多议程场景给每项议程配一键直达。均为系统级注册,焦点在 PPT / 浏览器时同样生效。

3.2 全局快捷键(默认值,全部可改)

默认键 合并模式(默认) 分开模式
Ctrl+F1 开始 / 暂停 全部(切换) 开始全部
Ctrl+F2 —(合并进 F1) 暂停全部
Ctrl+F3 停止全部 停止全部
Ctrl+F4 / Ctrl+F5 上一个 / 下一个计时器 同左

「合并模式」在设置面板切换,适合想少占快捷键的用户;分开模式适合需要独立暂停键的场景。

4. 提醒体系

4.1 计时结束提醒

设置项 取值 默认 说明
提醒方式 无 / 弹窗 / 声音 / 弹窗+声音 — 弹窗 = 窗口自动显示、聚焦并弹 Toast
提示音 MP3-1 / MP3-2 / MP3-3 / 语音播报 MP3-1 语音播报即 TTS,读出「播报文本」
播报文本 任意文字 计时结束 仅 TTS 生效
提示音音量 0–100% 100% 独立音量,不影响系统音量

4.2 倒计时语音提醒(结束前)

设置项 取值 默认 说明
提醒方式 无 / 弹窗 / 声音 / 弹窗+声音 无 倒计时进入预设分钟点时触发
提醒时间点 分钟列表 5, 3, 1 逗号分隔,如「10, 5, 3, 1」
提示音 MP3-4 / MP3-5 / MP3-6 / 语音播报 MP3-4 独立于结束提示音的一组资源
播报文本 含 {time} 占位符 请注意,还剩下{time}分钟 {time} 替换为实际剩余分钟数
TTS 播报人 系统语音名称 系统默认 填 Windows TTS 语音名称;部分语音不支持中文

5. 窗口与显示

设置项 取值 默认 说明
窗口置顶 开 / 关 开 数字始终浮在其他窗口之上
窗体透明度 0.3–1.0 0.95 整窗透明度
鼠标移出时透明 开 / 关 关 开启后鼠标移出窗口自动淡化
文字透明度 0.3–1.0 1.0 仅影响紧凑窗口的计时数字
文字颜色 自动 + 10 预设 自动 自动 = 跟随主题(浅色黑 / 深色白)
字体 4 种 系统等宽 系统等宽 / 科技数字(Orbitron)/ 终端复古(Share Tech Mono)/ 代码极简(JetBrains Mono)
主题 深 / 浅 / 跟随系统 跟随系统 影响设置面板与展开视图

6. Web 控制台

浏览器打开 http://<本机IP>:9527(局域网任意设备),输入控制密码登录(24 小时内免登录),共三页:

页面 功能
计时器 列表卡片:启动 / 暂停 / 重置 / 删除、添加计时器(模式、分钟、秒)、显示快捷键绑定
设置 与桌面端设置面板同结构:音量、透明度、窗口行为、字体、文字颜色、提醒、倒计时语音提醒、主题
手册 局域网访问说明与常见问题

所有操作经 WebSocket 实时双向同步:网页改设置桌面端立即生效,桌面计时网页实时跳动。控制密码、端口与开关在桌面端「设置 → Web 控制台」修改,保存后服务自动重启生效。

7. 日常维护动作

  • 会前:按议程建好计时器、绑好专属快捷键、试一次结束提醒音量;
  • 会中:全局快捷键控节奏,不需要碰窗口;
  • 会后:无需清理(下次覆盖使用);设置面板「恢复默认设置」可一键回出厂(同时清空计时器);
  • 每周 / 长期:无需专门维护;升级用新版安装包覆盖安装。

8. 数据与文件位置

内容 位置
计时器配置 / 应用设置 双模式自动检测:exe 目录可写 → 便携模式,存 exe 同目录 config\settings.json 与 config\timers.json(拷贝整个程序目录即携带全部配置);exe 目录不可写(如 Program Files)→ 安装模式,存系统应用数据目录(SharedPreferences)
提示音资源 随安装包分发(assets/mp3/1-6.mp3),只读
TTS 引擎 Windows 系统 SAPI(经 PowerShell 调用),不额外安装
运行日志 程序内日志(开发诊断用),常规使用无需关心

文档解决不了的,直接问我们

把现场条件和使用场景说清楚,我们的工程师会给出明确结论,而不是只发一份资料链接。