HuajisheTools/HuajisheHealthDaemon/v1.0

🏥 健康守护助手 · Health Guardian v0.4

跨平台健康提醒工具，支持 Windows / macOS / Linux。

项目结构

health-guardian/
├── Cargo.toml            # Workspace 根
├── config.toml           # 用户配置文件
│
├── health-core/          # 纯逻辑引擎（lib）
│   └── src/
│       ├── lib.rs
│       ├── config/       # 配置加载 & 结构体
│       ├── task/         # Task / Interval / TaskStats
│       ├── state/        # 线程安全运行状态 AppState
│       ├── notifier/     # 系统通知 / 声音 / 日志
│       └── scheduler/    # 异步调度引擎
│
├── health-cli/           # 命令行入口  →  hguard
│   └── src/
│       ├── main.rs       # CLI 子命令 & 主流程
│       └── display.rs    # 终端美化渲染（与逻辑解耦）
│
├── health-daemon/        # 后台守护进程  →  hguard-daemon
│   └── src/main.rs       # Unix double-fork / Windows Service
│
└── health-tray/          # 系统托盘 UI  →  hguard-tray
    └── src/main.rs       # tray-item 跨平台托盘

---

编译

依赖安装

# 安装 Rust（所有平台）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Linux 额外依赖
sudo apt install -y libdbus-1-dev pkg-config libasound2-dev
# AppIndicator 托盘支持（Linux）
sudo apt install -y libayatana-appindicator3-dev

编译所有 crate

cd health-guardian
cargo build --release

仅编译特定组件

cargo build --release -p health-cli      # hguard
cargo build --release -p health-daemon   # hguard-daemon
cargo build --release -p health-tray     # hguard-tray

产物位置

target/release/hguard
target/release/hguard-daemon
target/release/hguard-tray

---

使用

CLI（hguard）

# 正常启动（自动搜索 config.toml）
hguard

# 指定配置文件
hguard --config /path/to/config.toml

# 子命令
hguard list                    # 列出所有任务
hguard test                    # 立即触发所有通知（测试）
hguard log-path                # 显示日志文件路径
hguard status                  # 显示任务状态快照
hguard --default run           # 使用内置默认配置启动
hguard --verbose run           # 开启详细日志

后台守护（hguard-daemon）

# 前台运行（调试）
hguard-daemon

# Unix 后台运行（double-fork）
hguard-daemon --daemonize

# 停止守护进程
kill $(cat ~/.local/share/health-guardian/hguard.pid)

systemd 用户服务（Linux）

mkdir -p ~/.config/systemd/user/
cat > ~/.config/systemd/user/hguard.service << 'EOF'
[Unit]
Description=Health Guardian Daemon

[Service]
ExecStart=/usr/local/bin/hguard-daemon
Restart=on-failure

[Install]
WantedBy=default.target
EOF

systemctl --user enable --now hguard
journalctl --user -u hguard -f

launchd（macOS）

cat > ~/Library/LaunchAgents/com.hguard.daemon.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>             <string>com.hguard.daemon</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/hguard-daemon</string>
  </array>
  <key>RunAtLoad</key>         <true/>
  <key>KeepAlive</key>         <true/>
</dict>
</plist>
EOF

launchctl load ~/Library/LaunchAgents/com.hguard.daemon.plist

Windows 服务

# 以管理员身份运行
sc.exe create hguard binPath="C:\path\to\hguard-daemon.exe" start=auto
sc.exe start hguard

托盘 UI（hguard-tray）

hguard-tray    # 启动后出现托盘图标，右键显示菜单

---

配置文件

配置文件搜索顺序：

1. --config <path> 命令行指定
2. ./config.toml（当前目录）
3. ~/.config/health-guardian/config.toml

[settings]
log_dir    = ""          # 空 = 系统默认；可指定绝对路径
sound_file = ""          # 空 = 内置蜂鸣；可指定 .wav/.mp3 路径

[[tasks]]
name                  = "补水提醒"
title                 = "💧 喝水时间到！"
body                  = "请喝一杯温水（约 200ml）。"
initial_delay_minutes = 30    # 启动后首次触发延迟（分钟）
sound                 = true   # 是否播放声音

  [tasks.interval]
  unit  = "minutes"    # "hours" 或 "minutes"
  value = 30

---

日志格式

════════════════════════════════════════════════════════════════════════
  🚀 会话开始  2026-02-18 09:00:00
════════════════════════════════════════════════════════════════════════
[2026-02-18 09:20:00]  #   1  眼部放松      👁️ 远眺放松眼睛！
[2026-02-18 09:30:00]  #   1  补水提醒      💧 喝水时间到！
[2026-02-18 09:40:00]  #   2  眼部放松      👁️ 远眺放松眼睛！

声音说明

场景	行为
sound_file = ""	内置合成蜂鸣：三声 × 0.5s，间隔 0.15s，频率 660 Hz
sound_file = "/path/to/x.wav"	播放指定文件，失败自动降级为蜂鸣
任务 sound = false	完全静音