sophhub 0.2.2 → 0.2.4

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

@@ -0,0 +1,246 @@
+#!/usr/bin/env python3
+"""
+ROC（Regular Operation Calendar）定期事件提醒检查。
+
+每天自动运行，检查今日是否有需要提醒的 ROC 事件，输出 JSON 供 Agent 处理。
+
+用法：
+  python3 apps/check_roc.py                # 检查今天，输出 JSON
+  python3 apps/check_roc.py --upcoming 30  # 列出未来 30 天内的提醒
+  python3 apps/check_roc.py --list         # 列出今年全部事件及提醒日期
+  python3 apps/check_roc.py --dry-run      # 只计算，不写状态文件
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import sys
+from datetime import datetime, timedelta
+from pathlib import Path
+
+import yaml
+
+# ── 路径配置 ──────────────────────────────────────────────────────────
+_SKILL_BASE = Path(__file__).resolve().parent.parent
+_CONFIG_FILE = _SKILL_BASE / "config" / "roc_events.yaml"
+_STATE_FILE  = _SKILL_BASE / "data" / "roc_state.json"
+
+sys.path.insert(0, str(_SKILL_BASE))
+
+from config.settings import TIMEZONE
+from services.calendar_backend import active_provider
+from services.datetime_utils import current_date_str, current_year, now_local
+
+
+# ── 日期计算 ──────────────────────────────────────────────────────────
+
+def _nth_weekday(year: int, month: int, weekday: int, n: int) -> datetime:
+    """返回 year/month 中第 n 个 weekday（0=周一…6=周日）。"""
+    first = datetime(year, month, 1)
+    offset = (weekday - first.weekday()) % 7
+    first_match = first + timedelta(days=offset)
+    return first_match + timedelta(weeks=n - 1)
+
+
+_WEEKDAY_MAP = {"周一": 0, "周二": 1, "周三": 2, "周四": 3, "周五": 4, "周六": 5, "周日": 6}
+
+
+def resolve_event_date(rule: str, year: int, spring: dict) -> datetime | None:
+    """将 rule 字符串解析为具体日期。"""
+
+    # 每年M月D日
+    m = re.fullmatch(r"每年(\d+)月(\d+)日", rule.strip())
+    if m:
+        try:
+            return datetime(year, int(m.group(1)), int(m.group(2)))
+        except ValueError:
+            return None
+
+    # 每年M月第N个周X
+    m = re.search(r"每年(\d+)月第(\d+)个(周[一二三四五六日])", rule)
+    if m:
+        month   = int(m.group(1))
+        n       = int(m.group(2))
+        weekday = _WEEKDAY_MAP.get(m.group(3))
+        if weekday is not None:
+            return _nth_weekday(year, month, weekday, n)
+
+    # 春节相关（从 spring_festival 表查）
+    sf = spring.get(year, {})
+    if "春节前最后工作日" in rule:
+        d = sf.get("last_workday")
+        return datetime.strptime(d, "%Y-%m-%d") if d else None
+    if "春节后第一个工作日" in rule:
+        d = sf.get("first_workday")
+        return datetime.strptime(d, "%Y-%m-%d") if d else None
+
+    # 5.1 假期后第一个工作日（固定 5-06，如变动手工在 YAML 配置）
+    if "5.1假期后第一个工作日" in rule:
+        return datetime(year, 5, 6)
+
+    return None
+
+
+# ── 数据加载 ──────────────────────────────────────────────────────────
+
+def _load_config() -> dict:
+    with open(_CONFIG_FILE, encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def _load_state() -> dict:
+    try:
+        return json.loads(_STATE_FILE.read_text(encoding="utf-8"))
+    except Exception:
+        return {}
+
+
+def _save_state(state: dict) -> None:
+    _STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
+    _STATE_FILE.write_text(json.dumps(state, ensure_ascii=False, indent=2), encoding="utf-8")
+
+
+# ── 核心逻辑 ──────────────────────────────────────────────────────────
+
+def build_year_events(year: int, cfg: dict) -> list[dict]:
+    """计算指定年份所有 ROC 事件的发生日期和提醒日期。"""
+    spring = cfg.get("spring_festival", {})
+    result = []
+    for ev in cfg.get("events", []):
+        event_dt = resolve_event_date(ev["rule"], year, spring)
+        if event_dt is None:
+            continue
+        lead = int(ev.get("lead_days", 0))
+        reminder_dt = event_dt - timedelta(days=lead)
+        result.append({
+            "id":            ev["id"],
+            "name":          ev["name"],
+            "rule":          ev["rule"],
+            "event_date":    event_dt.strftime("%Y-%m-%d"),
+            "reminder_date": reminder_dt.strftime("%Y-%m-%d"),
+            "reminder_time": ev.get("reminder_time", "08:00"),
+            "lead_days":     lead,
+            "description":   ev.get("description", ""),
+        })
+    return result
+
+
+def check_today(year_events: list[dict], today: str, state: dict) -> list[dict]:
+    """返回今天需要提醒且尚未发送过提醒的事件。"""
+    hits = []
+    for ev in year_events:
+        if ev["reminder_date"] != today:
+            continue
+        # 若同一事件今天已提醒过，跳过
+        if state.get(ev["id"]) == today:
+            continue
+        hits.append(ev)
+    return hits
+
+
+def upcoming_events(year_events: list[dict], today: str, days: int) -> list[dict]:
+    """返回未来 days 天内（含今天）提醒日期内的事件，按提醒日期升序。"""
+    today_dt  = datetime.strptime(today, "%Y-%m-%d")
+    cutoff_dt = today_dt + timedelta(days=days)
+    result = []
+    for ev in year_events:
+        rd = datetime.strptime(ev["reminder_date"], "%Y-%m-%d")
+        if today_dt <= rd <= cutoff_dt:
+            ev = dict(ev)
+            ev["days_until_reminder"] = (rd - today_dt).days
+            ed = datetime.strptime(ev["event_date"], "%Y-%m-%d")
+            ev["days_until_event"] = (ed - today_dt).days
+            result.append(ev)
+    result.sort(key=lambda x: x["reminder_date"])
+    return result
+
+
+def format_reminder_message(ev: dict) -> str:
+    ed = datetime.strptime(ev["event_date"], "%Y-%m-%d")
+    today = now_local(TIMEZONE).replace(hour=0, minute=0, second=0, microsecond=0, tzinfo=None)
+    days = (ed - today).days
+    lines = [
+        f"📅 **ROC 提醒：{ev['name']}**",
+        f"📆 事件日期：{ev['event_date']}（{days} 天后）",
+    ]
+    if ev.get("description"):
+        lines.append(f"📝 {ev['description']}")
+    return "\n".join(lines)
+
+
+# ── CLI 入口 ──────────────────────────────────────────────────────────
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="ROC 定期事件提醒检查")
+    parser.add_argument("--upcoming", type=int, metavar="DAYS",
+                        help="列出未来 N 天内即将提醒的事件")
+    parser.add_argument("--list", action="store_true",
+                        help="列出今年全部 ROC 事件（事件日期 + 提醒日期）")
+    parser.add_argument("--dry-run", action="store_true",
+                        help="只计算，不写状态文件")
+    parser.add_argument("--date", default=None,
+                        help="模拟日期 YYYY-MM-DD（默认今天，测试用）")
+    args = parser.parse_args()
+
+    today = args.date or current_date_str(TIMEZONE)
+    year  = int(today[:4])
+
+    cfg         = _load_config()
+    year_events = build_year_events(year, cfg)
+    state       = _load_state()
+
+    # 当年 ROC 事件若尚未同步到 Google Calendar，自动触发一次
+    if active_provider() == "google":
+        try:
+            from apps.sync_roc_to_gcal import is_year_synced, sync_year
+            if not is_year_synced(year):
+                print(f"[check_roc] {year} 年 ROC 事件未同步到 GCal，自动同步中…", flush=True)
+                result = sync_year(year, verbose=False)
+                added = len(result.get("added", []))
+                print(f"[check_roc] GCal 同步完成：新增 {added} 个全天事件", flush=True)
+        except Exception as e:
+            # 同步失败不影响提醒功能
+            print(f"[check_roc] GCal 同步跳过（{e}）", flush=True)
+
+    # ── --list ────────────────────────────────────────────────────────
+    if args.list:
+        out = {"year": year, "events": year_events}
+        print(json.dumps(out, ensure_ascii=False, indent=2))
+        return
+
+    # ── --upcoming ────────────────────────────────────────────────────
+    if args.upcoming is not None:
+        evs = upcoming_events(year_events, today, args.upcoming)
+        print(json.dumps({"today": today, "upcoming": evs}, ensure_ascii=False, indent=2))
+        return
+
+    # ── 默认：检查今天 ────────────────────────────────────────────────
+    hits = check_today(year_events, today, state)
+
+    output = {
+        "ok":        True,
+        "today":     today,
+        "reminders": [],
+    }
+
+    for ev in hits:
+        output["reminders"].append({
+            "id":          ev["id"],
+            "name":        ev["name"],
+            "event_date":  ev["event_date"],
+            "description": ev["description"],
+            "message":     format_reminder_message(ev),
+        })
+
+    if not args.dry_run and hits:
+        for ev in hits:
+            state[ev["id"]] = today
+        _save_state(state)
+
+    print(json.dumps(output, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,342 @@
+#!/usr/bin/env python3
+"""
+每日计划生成器。
+
+执行时机：每天 07:50（由 OpenClaw Cron 触发）
+
+流程：
+  1. 从 config/task_registry.yaml 读取固定任务，注册到 OpenClaw Cron
+  2. 从 Google Calendar 读取今天（或今天+明天）日程
+  3. 为每个日程生成一次性提醒任务，注册到 OpenClaw Cron
+  4. 生成 daily/cron-YYYYMMDD.md 可读记录
+
+用法：
+  python3 apps/generate_daily_plan.py
+  python3 apps/generate_daily_plan.py --days 2        # 今天+明天
+  python3 apps/generate_daily_plan.py --dry-run       # 只生成 md，不注册 cron
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import logging
+import sys
+from datetime import datetime
+from pathlib import Path
+try:
+    from zoneinfo import ZoneInfo
+except ImportError:
+    from backports.zoneinfo import ZoneInfo
+
+import yaml
+
+# ── sys.path 保障（以脚本方式直接运行时）────────────────────────
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from config.settings import (
+    TIMEZONE,
+    DAILY_DIR, TASK_REGISTRY_FILE, REMINDER_RULES_FILE,
+    SKILL_BASE,
+)
+from gcal.models import CalendarEvent
+from services.calendar_backend import active_provider, list_event_views
+from services.time_window import get_today_window, get_today_and_tomorrow_window, now_tz
+from services.reminder_planner import plan_reminders, ReminderPlan
+from services.task_builder import (
+    build_periodic_silent_task,
+    build_reminder_task,
+    build_reminder_task_name,
+    build_report_task,
+)
+from services.conflict_detector import detect_conflicts, ConflictPair
+from services.job_store import append_job_if_absent, list_job_names
+from services.runtime_utils import expand_command_vars
+
+logging.basicConfig(level=logging.INFO, format="%(levelname)s %(message)s")
+logger = logging.getLogger(__name__)
+
+WEEKDAY_CN = ["周一", "周二", "周三", "周四", "周五", "周六", "周日"]
+
+
+# ─────────────────────────── task registry ────────────────────────
+
+def load_task_registry() -> list[dict]:
+    try:
+        with open(TASK_REGISTRY_FILE, encoding="utf-8") as f:
+            data = yaml.safe_load(f) or {}
+        provider = active_provider()
+        return [
+            task for task in data.get("tasks", [])
+            if task.get("requires_provider", "any") in {"", "any", provider}
+        ]
+    except Exception as e:
+        logger.error(f"加载 task_registry.yaml 失败: {e}")
+        return []
+
+def parse_fixed_task(task: dict, today: datetime) -> dict | None:
+    """
+    将 task_registry 中的一条任务转换为 OpenClaw job payload。
+    返回 None 表示跳过（周期任务不在每日 at 中创建）。
+    """
+    name    = task.get("name", "")
+    kind    = task.get("type", "report")
+    message = expand_command_vars(task.get("message", task.get("command", "")))
+    sched   = task.get("schedule", {})
+    delete  = task.get("delete_after_run", True)
+
+    if sched.get("kind") == "cron":
+        # 周期任务：用 build_periodic_silent_task 或 build_report_task
+        expr = sched.get("expr", "")
+        tz   = sched.get("tz", TIMEZONE)
+        if kind == "silent":
+            return build_periodic_silent_task(name, expr, message, tz)
+        else:
+            return build_report_task(
+                name, message,
+                cron_expr=expr, tz=tz,
+            )
+
+    elif sched.get("kind") == "at":
+        # 一次性任务：解析 HH:MM，换算 UTC
+        time_str = sched.get("time", "")
+        try:
+            h, m = map(int, time_str.split(":"))
+        except ValueError:
+            logger.warning(f"无法解析时间 '{time_str}'，跳过任务 {name}")
+            return None
+
+        zone    = ZoneInfo(TIMEZONE)
+        bj_time = today.astimezone(zone).replace(hour=h, minute=m, second=0, microsecond=0)
+
+        if kind == "silent":
+            # 静默一次性：用 agentTurn + delivery:none
+            return {
+                "name": name,
+                "schedule": {"kind": "at", "at": _utc_str(bj_time)},
+                "sessionTarget": "isolated",
+                "payload": {"kind": "agentTurn", "message": message},
+                "delivery": {"mode": "none"},
+                "deleteAfterRun": delete,
+            }
+        else:
+            return build_report_task(
+                name, message,
+                at_utc=bj_time, delete_after_run=delete,
+            )
+
+    return None
+
+
+# ─────────────────────────── cron 注册 ────────────────────────────
+
+def _utc_str(dt: datetime) -> str:
+    from datetime import timezone
+    return dt.astimezone(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def _get_existing_task_names() -> set[str]:
+    """从 jobs.json 读取已存在的任务名称"""
+    try:
+        return list_job_names()
+    except Exception as e:
+        logger.warning(f"读取现有 cron 任务失败: {e}")
+    return set()
+
+
+def register_cron_task(payload: dict, dry_run: bool, existing: set[str]) -> bool:
+    """注册单个任务到 OpenClaw Cron（直接操作 jobs.json）。"""
+    name = payload.get("name", "")
+    if name in existing:
+        logger.info(f"⏭️  任务已存在，跳过: {name}")
+        return False
+
+    if dry_run:
+        logger.info(f"[dry-run] 将注册: {name}")
+        existing.add(name)
+        return True
+
+    try:
+        added = append_job_if_absent(payload)
+        if added:
+            existing.add(name)
+            logger.info(f"✅ 已注册: {name}")
+            return True
+        logger.info(f"⏭️  任务已存在，跳过: {name}")
+        return False
+    except Exception as e:
+        logger.error(f"❌ 注册异常 ({name}): {e}")
+        return False
+
+
+# ─────────────────────────── markdown 生成 ────────────────────────
+
+def _load_reminder_rules_text() -> str:
+    """从 reminder_rules.yaml 动态生成提醒规则说明文字。"""
+    try:
+        with open(REMINDER_RULES_FILE, encoding="utf-8") as f:
+            data = yaml.safe_load(f) or {}
+        lead = data.get("lead_minutes", {})
+        type_cn = {"meeting": "会议", "sport": "运动", "meal": "饭局/宴会"}
+        lines = []
+        for key, cn in type_cn.items():
+            mins = lead.get(key)
+            if mins is not None:
+                lines.append(f"- {cn}：提前 **{mins} 分钟** 提醒")
+        default = data.get("default_lead_minutes")
+        if default:
+            lines.append(f"- 其他：提前 **{default} 分钟** 提醒（默认）")
+        return "\n".join(lines) if lines else "- 默认：提前 5 分钟提醒"
+    except Exception:
+        return "- 会议：提前 **2 分钟** 提醒\n- 运动：提前 **15 分钟** 提醒\n- 饭局/宴会：提前 **15 分钟** 提醒"
+
+
+def generate_markdown(
+    today: datetime,
+    fixed_tasks: list[dict],
+    events: list[CalendarEvent],
+    reminder_plans: list[ReminderPlan],
+    conflicts: list[ConflictPair] | None = None,
+) -> str:
+    date_str = today.strftime("%Y-%m-%d")
+    weekday  = WEEKDAY_CN[today.weekday()]
+    lines    = [f"# Cron 任务记录 - {date_str} {weekday}", ""]
+
+    # 提醒规则说明（动态读取）
+    lines += ["## 提醒规则", "", _load_reminder_rules_text(), ""]
+
+    # 冲突告警（有冲突时显示）
+    if conflicts:
+        lines += ["## ⚠️ 日程冲突", ""]
+        for p in conflicts:
+            lines.append(f"- {p.format_text()}")
+        lines.append("")
+
+    # 重复性任务
+    lines += [
+        "## 重复性任务汇总",
+        "",
+        "| 序号 | 任务 | 执行时间 | 类型 | 任务说明 |",
+        "|------|------|----------|------|----------|",
+    ]
+    for i, t in enumerate(fixed_tasks, 1):
+        sched = t.get("schedule", {})
+        if sched.get("kind") == "cron":
+            time_display = f"cron: {sched.get('expr', '-')}"
+        else:
+            time_display = sched.get("time", "-")
+        lines.append(
+            f"| {i} | {t.get('name','-')} | {time_display} | {t.get('type','-')} | {t.get('description','-')} |"
+        )
+    lines.append("")
+
+    # 当日一次性提醒
+    lines += ["## 当日一次性提醒", ""]
+    if reminder_plans:
+        lines += [
+            "| 序号 | 日程 | 地点 | 开始时间 | 提醒时间 | 类型 | 状态 |",
+            "|------|------|------|----------|----------|------|------|",
+        ]
+        for i, p in enumerate(reminder_plans, 1):
+            start_str  = p.event.start.strftime("%H:%M")
+            remind_str = p.remind_at.strftime("%H:%M")
+            status     = "✅ 将创建" if p.should_schedule else "⏩ 已过期"
+            location   = p.event.location or "-"
+            lines.append(
+                f"| {i} | {p.event.summary} | {location} | {start_str} | {remind_str} | {p.event_type} | {status} |"
+            )
+    else:
+        lines.append("> 今日无日程提醒任务")
+    lines.append("")
+
+    # 今日日程概览
+    lines += ["## 今日日程概览", ""]
+    if events:
+        for e in events:
+            t    = e.start.strftime("%H:%M") if not e.is_all_day else "全天"
+            loc  = f"  📍 {e.location}" if e.location else ""
+            lines.append(f"- {t} {e.summary}{loc}")
+    else:
+        lines.append("- 暂无日程")
+    lines.append("")
+
+    lines += [
+        "## 变更记录",
+        "",
+        f"- {today.strftime('%H:%M')} 自动生成今日 Cron 任务文件",
+    ]
+
+    return "\n".join(lines)
+
+
+# ─────────────────────────── main ─────────────────────────────────
+
+def main():
+    parser = argparse.ArgumentParser(description="每日计划生成器")
+    parser.add_argument("--days",    type=int, default=1,
+                        help="拉取日程天数（1=今天，2=今天+明天）")
+    parser.add_argument("--dry-run", action="store_true",
+                        help="只生成 md 文件，不注册 cron 任务")
+    args = parser.parse_args()
+
+    now   = now_tz(TIMEZONE)
+    today = now.replace(hour=0, minute=0, second=0, microsecond=0)
+
+    # ── 1. 拉取日程 ────────────────────────────────────────────────
+    if args.days >= 2:
+        t_min, t_max = get_today_and_tomorrow_window(TIMEZONE)
+    else:
+        t_min, t_max = get_today_window(TIMEZONE)
+
+    try:
+        views = list_event_views(t_min, t_max)
+        events = [item.event for item in views]
+        logger.info(f"拉取到 {len(events)} 个事件")
+    except Exception as e:
+        logger.error(f"拉取日程失败: {e}")
+        events = []
+
+    # ── 2. 生成提醒计划 ─────────────────────────────────────────────
+    plans = plan_reminders(events, now=now, tz=TIMEZONE)
+
+    # ── 3. 冲突检测 ─────────────────────────────────────────────────
+    conflicts = detect_conflicts(events)
+    if conflicts:
+        logger.warning(f"⚠️ 检测到 {len(conflicts)} 处日程冲突")
+        for c in conflicts:
+            logger.warning(f"   {c.format_text()}")
+
+    # ── 4. 加载固定任务 ─────────────────────────────────────────────
+    task_defs = load_task_registry()
+
+    # ── 5. 注册 cron 任务 ──────────────────────────────────────────
+    existing = set() if args.dry_run else _get_existing_task_names()
+
+    # 固定任务
+    for t in task_defs:
+        payload = parse_fixed_task(t, today)
+        if payload:
+            register_cron_task(payload, args.dry_run, existing)
+
+    # 日程提醒
+    for p in plans:
+        if not p.should_schedule:
+            logger.info(f"⏩ 提醒时间已过，跳过: {p.event.summary}")
+            continue
+        payload = build_reminder_task(
+            name         = build_reminder_task_name(p.event.summary, p.event.start, p.event.id),
+            remind_at_utc= p.remind_at_utc,
+            message      = p.reminder_message(),
+        )
+        register_cron_task(payload, args.dry_run, existing)
+
+    # ── 6. 生成 md 文件 ─────────────────────────────────────────────
+    DAILY_DIR.mkdir(parents=True, exist_ok=True)
+    md_path = DAILY_DIR / f"cron-{today.strftime('%Y%m%d')}.md"
+    md_content = generate_markdown(today, task_defs, events, plans, conflicts)
+    md_path.write_text(md_content, encoding="utf-8")
+    logger.info(f"📄 已生成: {md_path}")
+
+
+if __name__ == "__main__":
+    main()