sophhub 0.2.3 → 0.2.4

package/skills/sophnet-schedule/src/apps/sync_roc_to_gcal.py

@@ -0,0 +1,174 @@
+#!/usr/bin/env python3
+"""
+将 ROC 事件按年份批量同步到 Google Calendar。
+
+设计原则：
+  - 每个年份独立管理，同一年只同步一次（除非 --force）。
+  - 同步记录保存在 data/roc_gcal_sync.json：
+      { "2026": {"roc-001": "gcal_event_id_xxx", ...}, "2027": {...} }
+  - 事件以"全天事件"写入 Google Calendar，标题带 📅 前缀，备注含提醒日期。
+  - 跨年自动处理：每年 1 月 1 日触发当年同步；check_roc.py 首次运行也会触发。
+
+用法：
+  python3 apps/sync_roc_to_gcal.py             # 同步当年
+  python3 apps/sync_roc_to_gcal.py --year 2027 # 同步指定年份
+  python3 apps/sync_roc_to_gcal.py --dry-run   # 只打印，不写入 GCal
+  python3 apps/sync_roc_to_gcal.py --force     # 强制重新同步（已有记录也重建）
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from datetime import datetime
+from pathlib import Path
+
+import yaml
+
+_SKILL_BASE = Path(__file__).resolve().parent.parent
+sys.path.insert(0, str(_SKILL_BASE))
+
+from config.settings import (
+    GCAL_TOKEN_PATH, PROXIES, GCAL_TIMEOUT, GCAL_MAX_RETRIES, GCAL_CALENDAR_ID,
+    GCAL_SSL_VERIFY, TIMEZONE,
+)
+from gcal.client import CalendarClient, CalendarAuthError, CalendarAPIError
+from services.datetime_utils import current_year
+
+_SYNC_STATE_FILE = _SKILL_BASE / "data" / "roc_gcal_sync.json"
+_CONFIG_FILE     = _SKILL_BASE / "config" / "roc_events.yaml"
+
+
+# ── 状态文件 ──────────────────────────────────────────────────────────
+
+def _load_sync_state() -> dict:
+    try:
+        return json.loads(_SYNC_STATE_FILE.read_text(encoding="utf-8"))
+    except Exception:
+        return {}
+
+
+def _save_sync_state(state: dict) -> None:
+    _SYNC_STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
+    _SYNC_STATE_FILE.write_text(
+        json.dumps(state, ensure_ascii=False, indent=2), encoding="utf-8"
+    )
+
+
+# ── 核心同步逻辑 ─────────────────────────────────────────────────────
+
+def sync_year(
+    year: int,
+    dry_run: bool = False,
+    force: bool = False,
+    verbose: bool = True,
+) -> dict:
+    """
+    同步指定年份的全部 ROC 事件到 Google Calendar。
+
+    Returns:
+        {"added": [...], "skipped": [...], "errors": [...]}
+    """
+    # 复用 check_roc 的日期解析逻辑，避免重复代码
+    from apps.check_roc import build_year_events
+
+    with open(_CONFIG_FILE, encoding="utf-8") as f:
+        cfg = yaml.safe_load(f)
+
+    year_events = build_year_events(year, cfg)
+    sync_state  = _load_sync_state()
+    year_key    = str(year)
+    year_state  = dict(sync_state.get(year_key, {}))
+
+    client = None
+    if not dry_run:
+        client = CalendarClient(
+            GCAL_TOKEN_PATH, PROXIES, GCAL_CALENDAR_ID, GCAL_TIMEOUT, GCAL_MAX_RETRIES,
+            verify=GCAL_SSL_VERIFY,
+        )
+
+    added, skipped, errors = [], [], []
+
+    for ev in year_events:
+        ev_id = ev["id"]
+
+        # 已同步且不强制重建 → 跳过
+        if ev_id in year_state and not force:
+            skipped.append(ev["name"])
+            if verbose:
+                print(f"  ⏭  跳过（已同步）: {ev['name']}  {ev['event_date']}")
+            continue
+
+        summary     = f"📅 {ev['name']}"
+        date_str    = ev["event_date"]
+        desc_lines  = []
+        if ev.get("description"):
+            desc_lines.append(ev["description"])
+        desc_lines.append(f"ROC 周期事件 | 提前提醒日期: {ev['reminder_date']}")
+        description = "\n".join(desc_lines)
+
+        if dry_run:
+            print(f"  [dry-run] 将创建: {summary}  {date_str}")
+            added.append(ev["name"])
+            continue
+
+        try:
+            assert client is not None
+            gcal_id = client.create_allday_event(
+                summary, date_str, description=description
+            )
+            year_state[ev_id] = gcal_id
+            added.append(ev["name"])
+            if verbose:
+                print(f"  ✅ 已创建: {summary}  {date_str}  (gcal_id={gcal_id})")
+        except (CalendarAuthError, CalendarAPIError, Exception) as e:
+            errors.append(f"{ev['name']}: {e}")
+            if verbose:
+                print(f"  ❌ 失败: {ev['name']}: {e}")
+
+    # 写回状态（干跑时不写）
+    if not dry_run:
+        sync_state[year_key] = year_state
+        _save_sync_state(sync_state)
+
+    return {"added": added, "skipped": skipped, "errors": errors}
+
+
+def is_year_synced(year: int) -> bool:
+    """检查指定年份的 ROC 事件是否已同步（有任意记录即视为已同步）。"""
+    state = _load_sync_state()
+    return bool(state.get(str(year)))
+
+
+# ── CLI ──────────────────────────────────────────────────────────────
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="ROC 事件 → Google Calendar 按年同步")
+    parser.add_argument("--year", type=int, default=current_year(TIMEZONE),
+                        help="目标年份（默认当年）")
+    parser.add_argument("--dry-run", action="store_true",
+                        help="只打印计划，不写入 GCal")
+    parser.add_argument("--force", action="store_true",
+                        help="强制重新同步（已有记录也重建）")
+    args = parser.parse_args()
+
+    label = f"{args.year} 年 ROC 事件"
+    suffix = "（dry-run，不写入）" if args.dry_run else ""
+    print(f"📅 同步 {label} 到 Google Calendar{suffix} …")
+
+    result = sync_year(args.year, dry_run=args.dry_run, force=args.force)
+
+    print(
+        f"\n完成：新增 {len(result['added'])} 个，"
+        f"跳过 {len(result['skipped'])} 个，"
+        f"失败 {len(result['errors'])} 个"
+    )
+    if result["errors"]:
+        for err in result["errors"]:
+            print(f"  ✗ {err}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/sophnet-schedule/src/compat.py

@@ -0,0 +1,66 @@
+"""
+Python 3.8 / 3.9+ 时区兼容层。
+
+Python 3.9+ 内置 zoneinfo；Python 3.8 回退到 pytz。
+统一暴露 ZoneInfo 和 make_aware() 两个接口，
+其余模块只从此处导入，不直接写 from zoneinfo import ZoneInfo。
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+try:
+    from zoneinfo import ZoneInfo                               # Python 3.9+
+
+    def make_aware(dt: datetime, key: str) -> datetime:
+        """将朴素 datetime 本地化为指定时区的 aware datetime。"""
+        if dt.tzinfo is not None:
+            return dt.astimezone(ZoneInfo(key))
+        return dt.replace(tzinfo=ZoneInfo(key))
+
+except ImportError:
+    import pytz                                                 # Python 3.8 fallback
+    from datetime import tzinfo as _tzinfo
+
+    class ZoneInfo(_tzinfo):                                    # type: ignore[no-redef]
+        """pytz 驱动的 ZoneInfo 最小兼容实现，继承 tzinfo 供 datetime.now(tz) 使用。"""
+
+        _cache: dict = {}
+
+        def __new__(cls, key: str):
+            if key not in cls._cache:
+                obj = _tzinfo.__new__(cls)
+                obj._tz  = pytz.timezone(key)
+                obj._key = key
+                cls._cache[key] = obj
+            return cls._cache[key]
+
+        def __init__(self, key: str) -> None:
+            pass
+
+        @property
+        def key(self) -> str:
+            return self._key
+
+        def utcoffset(self, dt):
+            naive = dt.replace(tzinfo=None) if dt is not None else datetime.utcnow()
+            return self._tz.utcoffset(naive)
+
+        def tzname(self, dt):
+            return self._tz.zone
+
+        def dst(self, dt):
+            naive = dt.replace(tzinfo=None) if dt is not None else datetime.utcnow()
+            return self._tz.dst(naive)
+
+        def fromutc(self, dt: datetime) -> datetime:
+            # pytz.fromutc 要求 dt.tzinfo 是其自身，先替换回 pytz tz
+            return self._tz.fromutc(dt.replace(tzinfo=self._tz))
+
+    def make_aware(dt: datetime, key: str) -> datetime:         # type: ignore[misc]
+        """使用 pytz.localize() 正确处理 DST，避免朴素 datetime 赋值偏移问题。"""
+        tz = pytz.timezone(key)
+        if dt.tzinfo is not None:
+            return dt.astimezone(tz)
+        return tz.localize(dt)

package/skills/sophnet-schedule/src/config/reminder_rules.yaml

@@ -0,0 +1,96 @@
+# 提醒规则配置
+# 修改此文件即可调整所有提醒规则，无需改代码。
+
+# 各类型提醒提前量（分钟）
+lead_minutes:
+  sport:       15   # 运动/健身：需要换装热身
+  meal:        15   # 聚餐/饭局：需要出行时间
+  family:      15   # 家庭/亲子：需要准备、集合
+  medical:     30   # 就医/体检：需要带证件、提前到场
+  appointment: 10   # 通用预约/约定（默认）
+
+# 无法匹配任何类型时的默认行为
+default_type: appointment
+default_lead_minutes: 10
+
+# 事件分类关键词（summary 中包含以下词即归入对应类型）
+keywords:
+  sport:
+    - 跑步
+    - 晨跑
+    - 夜跑
+    - 健身
+    - 游泳
+    - 打球
+    - 羽毛球
+    - 乒乓球
+    - 网球
+    - 篮球
+    - 足球
+    - 瑜伽
+    - 骑行
+    - 爬山
+    - 徒步
+
+  meal:
+    - 聚餐
+    - 家庭聚餐
+    - 生日聚餐
+    - 朋友聚餐
+    - 同学聚餐
+    - 团建
+    - 饭局
+    - 下午茶
+    - 火锅
+    - 烧烤
+    - 晚餐
+    - 午餐
+    - 早午餐
+
+  family:
+    - 亲子
+    - 接送
+    - 接孩子
+    - 送孩子
+    - 陪孩子
+    - 家长会
+    - 辅导
+    - 老人
+    - 探望
+    - 探亲
+    - 回家
+
+  medical:
+    - 体检
+    - 看病
+    - 就医
+    - 门诊
+    - 复诊
+    - 取药
+    - 打疫苗
+    - 牙医
+    - 口腔
+    - 眼科
+    - 体检
+
+  appointment:
+    - 预约
+    - 约定
+    - 美发
+    - 理发
+    - 美甲
+    - 保养
+    - 维修
+    - 快递
+    - 等待
+    - 面谈
+    - 会谈
+    - 活动
+    - 讲座
+    - 展览
+    - 观影
+    - 演出
+    - 旅行
+    - 出行
+    - 培训
+    - 课程

package/skills/sophnet-schedule/src/config/roc_events.yaml

@@ -0,0 +1,44 @@
+spring_festival:
+  2026:
+    last_workday: '2026-02-13'
+    first_workday: '2026-02-23'
+  2027:
+    last_workday: '2027-02-09'
+    first_workday: '2027-02-19'
+events:
+- id: spring_family_reunion
+  name: 春节家庭聚会准备
+  rule: 春节前最后工作日
+  reminder_time: 09:00
+  lead_days: 5
+  description: 提前安排聚餐地点和礼品
+- id: mom_birthday
+  name: 妈妈生日
+  rule: 每年9月8日
+  reminder_time: 09:00
+  lead_days: 14
+  description: 提前订蛋糕和安排家庭聚餐
+- id: after_cny_gathering
+  name: 春节后家庭聚餐
+  rule: 春节后第一个工作日
+  reminder_time: 09:00
+  lead_days: 7
+  description: ''
+- id: summer_family_trip
+  name: 暑期家庭出行计划
+  rule: 每年7月1日
+  reminder_time: 09:00
+  lead_days: 30
+  description: 提前预订酒店和机票
+- id: car_annual_check
+  name: 汽车年检
+  rule: 每年11月第1个周三
+  reminder_time: 09:00
+  lead_days: 21
+  description: 提前准备行驶证和保险凭证
+- id: health_checkup
+  name: 年度家庭体检
+  rule: 每年4月第2个周五
+  reminder_time: 09:00
+  lead_days: 14
+  description: 提前预约体检套餐，注意检查前一天饮食

package/skills/sophnet-schedule/src/config/settings.py

@@ -0,0 +1,133 @@
+"""
+全局配置入口。
+
+所有第三方服务连接信息、路径、时区统一在此管理。
+环境变量优先级高于默认值，方便不同环境（本地开发 / 测试 / 生产）切换。
+
+第三方集成一览：
+  - Google Calendar API v3   （token 文件：gcalcli 兼容格式）
+  - HTTP 代理                （内网代理，访问 Google API 用）
+  - Telegram                 （OpenClaw 消息投递通道）
+  - OpenClaw Cron            （任务调度运行时）
+"""
+
+import os
+import sys
+from pathlib import Path
+
+
+def _load_env(env_file: Path) -> None:
+    """加载 .env 文件，已有的环境变量不覆盖（系统/进程注入的优先级更高）。"""
+    if not env_file.is_file():
+        return
+    with open(env_file, encoding="utf-8") as f:
+        for line in f:
+            line = line.strip()
+            if not line or line.startswith("#") or "=" not in line:
+                continue
+            key, _, val = line.partition("=")
+            key = key.strip()
+            val = val.strip()
+            if key and key not in os.environ:
+                os.environ[key] = val
+
+
+# 自动加载 sophnet-schedule（本 skill）根目录下的 .env（config/ 的上级目录）
+_load_env(Path(__file__).resolve().parent.parent / ".env")
+
+# ─────────────────────────────────────────────────────────────────
+# 基础路径
+# ─────────────────────────────────────────────────────────────────
+
+# 本 skill 根目录（从环境变量覆盖，或从本文件推导）
+_default_skill_base = Path(__file__).resolve().parent.parent  # config/ → skill 根（src/）
+SKILL_BASE: Path = Path(
+    os.environ.get("SOPHNET_SCHEDULE_BASE")
+    or os.environ.get("CRON_SKILL_BASE")
+    or _default_skill_base
+)
+
+# OpenClaw 工作空间根（部署时通常是 /home/node/.openclaw）
+OPENCLAW_BASE: Path = Path(
+    os.environ.get("OPENCLAW_BASE", str(Path.home() / ".openclaw"))
+)
+WORKSPACE_BASE: Path   = OPENCLAW_BASE / "workspace"
+SKILLS_CRON_BASE: Path = WORKSPACE_BASE / "skills" / "cron"
+
+# ─────────────────────────────────────────────────────────────────
+# 数据 / 输出目录
+# ─────────────────────────────────────────────────────────────────
+
+DAILY_DIR: Path        = SKILL_BASE / "daily"
+DATA_DIR: Path         = SKILL_BASE / "data"
+LAST_EVENTS_FILE: Path = DATA_DIR / "last_events.json"
+LOCAL_EVENTS_FILE: Path = DATA_DIR / "local_events.json"
+GOOGLE_STATE_FILE: Path = DATA_DIR / "google_state.json"
+
+# ─────────────────────────────────────────────────────────────────
+# 第三方：Google Calendar API
+# ─────────────────────────────────────────────────────────────────
+
+# gcalcli 兼容 token 文件（含 client_id / client_secret / refresh_token）
+GCAL_TOKEN_PATH: Path = Path(
+    os.environ.get(
+        "GCAL_TOKEN_PATH",
+        Path.home() / ".config" / "gcalcli" / "token.json",
+    )
+)
+
+# HTTP 代理（内网访问 Google API 需要）
+_PROXY = os.environ.get("HTTP_PROXY", "")
+PROXIES: "dict[str, str]" = {"http": _PROXY, "https": _PROXY} if _PROXY else {}
+
+GCAL_TIMEOUT: int      = int(os.environ.get("GCAL_TIMEOUT",      "10"))
+GCAL_MAX_RETRIES: int  = int(os.environ.get("GCAL_MAX_RETRIES",  "3"))
+GCAL_CALENDAR_ID: str  = os.environ.get("GCAL_CALENDAR_ID",      "primary")
+
+
+def _parse_ssl_verify(value: str) -> bool | str:
+    raw = value.strip()
+    if not raw:
+        return True
+    lowered = raw.lower()
+    if lowered in {"0", "false", "no", "off"}:
+        return False
+    if lowered in {"1", "true", "yes", "on"}:
+        return True
+    return raw
+
+
+GCAL_SSL_VERIFY: bool | str = _parse_ssl_verify(
+    os.environ.get("GCAL_SSL_VERIFY", "true")
+)
+GOOGLE_OAUTH_SESSION_TTL_MINUTES: int = int(
+    os.environ.get("GOOGLE_OAUTH_SESSION_TTL_MINUTES", "15")
+)
+
+# ─────────────────────────────────────────────────────────────────
+# 时区
+# ─────────────────────────────────────────────────────────────────
+
+TIMEZONE: str = os.environ.get("TIMEZONE", "Asia/Shanghai")
+
+# ─────────────────────────────────────────────────────────────────
+# 第三方：Telegram（通过 OpenClaw 消息通道投递）
+# ─────────────────────────────────────────────────────────────────
+
+TELEGRAM_CHANNEL: str = os.environ.get("TELEGRAM_CHANNEL", "telegram")
+TELEGRAM_TO: str      = os.environ.get("TELEGRAM_TO", "")
+
+# ─────────────────────────────────────────────────────────────────
+# OpenClaw CLI
+# ─────────────────────────────────────────────────────────────────
+
+OPENCLAW_BIN: str = os.environ.get("OPENCLAW_BIN", "openclaw")
+PYTHON_BIN: str   = os.environ.get("PYTHON_BIN", sys.executable)
+
+# ─────────────────────────────────────────────────────────────────
+# 配置文件路径
+# ─────────────────────────────────────────────────────────────────
+
+CONFIG_DIR: Path           = SKILL_BASE / "config"
+REMINDER_RULES_FILE: Path  = CONFIG_DIR / "reminder_rules.yaml"
+TASK_REGISTRY_FILE: Path   = CONFIG_DIR / "task_registry.yaml"

package/skills/sophnet-schedule/src/config/task_registry.yaml

@@ -0,0 +1,92 @@
+# 固定任务注册表
+#
+# 此文件是所有重复性任务的唯一注册入口。
+# 修改此文件即可增减任务，无需改代码。
+# 按需增删任务条目
+#
+# 字段说明：
+#   name          任务唯一名称
+#   schedule      调度时间
+#     kind: at    一次性（当天执行），time 格式 HH:MM（北京时间）
+#     kind: cron  周期性，expr 为 cron 表达式，tz 为时区
+#   type          任务投递类型
+#     silent      静默监控：不发送通知（delivery: none）
+#     report      报告推送：执行后 announce 到 Telegram
+#     reminder    提醒注入：由 apps/generate_daily_plan.py 动态生成，不在此注册
+#   message       发给 agent 的指令或脚本命令
+#   description   任务说明（仅供文档展示）
+#   delete_after_run  一次性任务执行后自动删除（默认 true）
+#   requires_provider  需要的日历后端：any | google（默认 any）
+#
+# 占位变量（运行时由 settings.py 替换）：
+#   {OPENCLAW_BASE}   OpenClaw 工作空间根路径
+#   {SKILL_BASE}      本 skill 根路径
+
+tasks:
+
+  # ── 早晨 ──────────────────────────────────────────────────────
+  - name: 每日计划生成
+    description: "生成今日 Cron 任务文件，注册日程提醒"
+    schedule:
+      kind: at
+      time: "07:50"
+    type: report
+    message: "{PYTHON_BIN} {SKILL_BASE}/apps/generate_daily_plan.py"
+    delete_after_run: true
+
+  - name: 每日日程推送
+    description: "查询今日日程，推送早报"
+    schedule:
+      kind: at
+      time: "08:00"
+    type: report
+    message: "查询今天日程，格式：📅 今日日程\n• 时间 事项"
+    delete_after_run: true
+
+  - name: 喝水提醒
+    description: "提醒补水，保持健康"
+    schedule:
+      kind: at
+      time: "10:00"
+    type: report
+    message: "该喝水了 💧"
+    delete_after_run: true
+
+  # ── 白天（周期） ───────────────────────────────────────────────
+  - name: 日程变化监控
+    description: "对比今天+明天日程快照，有变化时通知，无变化不打扰"
+    schedule:
+      kind: cron
+      expr: "0 8-20 * * *"   # 每小时整点（北京时间 8:00–20:00）
+      tz: "Asia/Shanghai"
+    type: silent
+    message: "{PYTHON_BIN} {SKILL_BASE}/apps/monitor_calendar_changes.py"
+
+  # ── 晚间 ──────────────────────────────────────────────────────
+  - name: ROC年度GCal同步
+    description: "每年1月1日将本年度全部ROC事件批量写入Google Calendar全天事件"
+    requires_provider: google
+    schedule:
+      kind: cron
+      expr: "0 8 1 1 *"   # 每年 1 月 1 日 08:00（北京时间）
+      tz: "Asia/Shanghai"
+    type: report
+    message: "{PYTHON_BIN} {SKILL_BASE}/apps/sync_roc_to_gcal.py"
+
+  - name: ROC事件检查
+    description: "检查今天是否有 ROC 周期性事件需要提醒（生日、体检、家庭聚会等）"
+    schedule:
+      kind: at
+      time: "08:05"
+    type: report
+    message: "{PYTHON_BIN} {SKILL_BASE}/apps/check_roc.py"
+    delete_after_run: true
+
+  - name: 每日总结
+    description: "生成今日工作总结，列出完成事项"
+    schedule:
+      kind: at
+      time: "21:00"
+    type: report
+    message: "整理今天的工作记录，生成简短日总结"
+    delete_after_run: true