FocusClock - Master Edition

24h 动态环境色沉浸式专注时钟，支持本地日志管理与 SMTC 系统级音乐联动控制。
24h dynamic ambient color immersive focus clock, supporting local log management and SMTC system-level music linkage control.

“别谈禅意，我只想专注。”
"Forget zen, I just want to focus."

---

核心特性 | Core Features

24h 物理动态背景

24h Physical Dynamic Background

基于大气散射算法，背景色彩随 24 小时真实时间平滑演变。
Based on atmospheric scattering algorithms, background colors evolve smoothly with 24-hour real-time.

本地化日志管理

Localized Log Management

所有专注记录持久化存储于浏览器本地（LocalStorage），隐私安全，支持单条管理与数据抹除。
All focus records are persistently stored in the browser's LocalStorage. Privacy-secured, supporting individual entry management and data erasure.

沉浸式交互设计

Immersive Interaction Design

计时开始后自动锁定干扰元素，侧边栏与控制项随心而动。
Interference elements are automatically locked after the timer starts, with sidebars and controls moving dynamically.

动态成就系统

Dynamic Achievement System

根据你的专注时长，系统会给出独一无二的评价，等待你亲自解锁。
The system provides unique evaluations based on your focus duration, waiting for you to unlock them.

SMTC 深度联动

SMTC Deep Integration

支持通过 WebSocket 连接本地脚本，在网页内直接获取并控制系统媒体播放。
Supports connecting to local scripts via WebSocket to directly retrieve and control system media playback within the webpage.

---

使用指南 | User Guide

1. 专注模式交互 | Focus Mode Interaction

为了确保极致的沉浸体验，本项目采用了特定的交互逻辑：
To ensure the ultimate immersive experience, this project adopts specific interaction logic:

• 开始 (Start)
  点击开始计时，页面会自动请求进入 全屏模式，并隐藏所有无关控制项。
  Click to start the timer; the page will automatically request to enter Full-screen Mode and hide all irrelevant controls.

• 暂停 (Pause)
  点击暂停将暂时解除干扰锁定。
  Clicking pause will temporarily lift the interference lock.

• 结算与退出 | Settlement and Exit
  若选择 重置 (Reset)：记录将存入本地日志，结算完成后自动 退出全屏。
  If Reset is selected: The record will be stored in the local log, and the system will automatically exit full-screen after settlement.
  若选择 舍弃 (Discard)：将直接放弃本次计时或重新开始。
  If Discard is selected: The current timing session will be abandoned or restarted directly.

2. 音乐联动 (SMTC) | Music Linkage (SMTC)

如果你希望在时钟上显示系统正在播放的音乐信息：
If you wish to display the system's current music playback information on the clock:

• 请运行仓库内的 .py 后端转发脚本。
  Please run the .py backend forwarding script included in the repository.
• 注意：建议使用 Chrome 或 Edge 浏览器以获得最佳的 WebSocket 通信与全屏交互体验，当然 Firefox 也是可以用的（开发者实测）。
  Note: Chrome or Edge is recommended for the best WebSocket communication and full-screen interaction experience, though Firefox is also compatible (tested by the developer).
• 若不运行脚本，时钟仅作为纯净计时器使用，不会产生多余进程。
  Without running the script, the clock functions as a pure timer without generating redundant processes.

---

技术声明 | Technical Statement

• 零依赖
  Zero Dependencies
  单 HTML 文件架构，双击即用，无需配置复杂的开发环境。
  Single HTML file architecture, ready to use with a double-click, no complex development environment required.

• 能用就行
  "It Just Works" Philosophy
  代码逻辑优先服务于功能实现与交互流畅度，追求极致的实用主义。
  Code logic prioritizes functional implementation and interaction fluidity, pursuing ultimate pragmatism.

• 版权声明
  Copyright Notice
  本项目未设置开源许可证 (None)。保留所有权利，仅供个人学习交流与自用，禁止任何形式的商业分发或二次打包。
  This project does not have an open-source license (None). All rights reserved. For personal study, exchange, and private use only. Any form of commercial distribution or repacking is prohibited.

---

FocusClock - 记录你每一个不可思议的专注时刻。 FocusClock - Capturing every incredible moment of your concentration.