Files
tauclock/README.md
T

89 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# TauClock
TauClockは、ローカル/UTC時計、アラーム、カウントダウンタイマー、ストップウォッチを1つのネイティブウィンドウにまとめたTauriアプリケーションです。キーボード操作を前提に設計しており、記録したアラームやラップはローカルストレージに保存されます。
## 主な特徴
- リアルタイムなローカル・UTC時計の並列表示
- 任意ラベル付きの繰り返しアラーム
- 柔軟な入力形式に対応したカウントダウンタイマー(`5m30s`, `1:15`, `90` など)
- ラップ記録つきストップウォッチと履歴リスト
- キーボードショートカットと画面内に表示できるチートシート
- アプリ説明・バージョン・ライセンス本文を確認できるAboutダイアログ
- Tauri + Rust製の軽量クロスプラットフォームバイナリ
## キーボードショートカット
| キー | 動作 |
| ----- | ------------------------------------------ |
| `H` | ショートカット一覧を開閉 |
| `I` | Aboutダイアログを開閉 |
| `A` | アラームの時刻入力欄にフォーカス |
| `N` | アラームを追加 |
| `T` | タイマーの時間入力欄にフォーカス |
| `G` | タイマー開始/一時停止 |
| `R` | タイマーをリセット |
| `W` | ストップウォッチ開始/停止 |
| `L` | ラップを追加 |
| `P` | ストップウォッチをリセット |
| `Esc` | 入力フォーカス解除 or オーバーレイを閉じる |
## ディレクトリ構成
- `src/` – フロントエンド(HTML/CSS/JavaScript)。`main.js` には各ウィジェットのロジックと詳しいコメントがあります。
- `src-tauri/` – Rust製バックエンドおよびTauri設定。`lib.rs` にプラグインやコマンドの初期化がまとまっています。
- `src-tauri/tauri.conf.json` – アプリの識別子やアイコン設定。
## 開発環境
### 事前準備
- [Rust](https://www.rust-lang.org/tools/install) と `cargo`
- Tauriの推奨コンパイラ/プラットフォーム依存ツール([公式ドキュメント](https://tauri.app/start/prerequisites/)を参照)
### ローカルで起動
```bash
cargo tauri dev
```
ホットリロード付きでウィンドウが立ち上がり、UIから各機能を試せます。
### ログレベルの切り替え
- フロントエンド: 既定で `info` レベルのみ表示します。`localStorage.setItem('tauclock:log-level', 'debug')` か
`?logLevel=debug` をクエリに付けると詳細ログが有効になります。
- バックエンド: `TAUCLOCK_LOG_LEVEL`(または互換の `TAUCLOCK_LOG`)環境変数で制御できます。
例: `TAUCLOCK_LOG_LEVEL=trace npm run tauri dev`。
未設定の場合はデバッグビルドが `debug`、リリースビルドが `info` になります。
### ビルド
```bash
cargo tauri build
```
`src-tauri/target/release/` 以下に配布用バイナリが生成されます。
### 日付時刻ライブラリと依存監査
日時処理は、RUSTSEC-2026-0543で保守停止が告知されたChronoではなくJiff 1.xを使用します。
日常のローカル時刻、UTC表示、アラームの暦日計算はJiffが担当します。互換性維持のため、
夏時間の重複時刻は早い方を選び、存在しない時刻は従来どおりcivil timeをUTCとして解釈する
fallbackを使います。保存済みアラームJSONの形式は変更しません。
```bash
cd src-tauri
cargo tree --locked -i chrono # active dependencyは表示されないこと
cargo audit --deny warnings
```
Tauriが利用するcrateの非有効なoptional dependencyとして、`Cargo.lock`にChronoが残る場合があります。
`cargo tree`でactive dependencyではないことを確認してください。`cargo audit`はlockfile単位で検査するため、
この非有効なentryもRUSTSEC-2026-0543として報告します。Tauri/Linux GUI由来のその他の
warning-class advisoryは [Issue #9](https://git.rumginger.org/kamat/tauclock/issues/9) で追跡します。
## ライセンス
MIT License. 詳細は `LICENSE` を参照してください。