sophhub 0.2.3 → 0.2.4

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

@@ -0,0 +1,216 @@
+#!/usr/bin/env python3
+"""
+批量日程导入工具。
+
+接收 JSON 格式的事件列表，批量写入 Google Calendar，并可选注册 OpenClaw 提醒任务。
+配合 table_parser.py 使用：先解析文件/OCR 内容得到 JSON，再由本脚本批量写入 GCal。
+
+输入格式（每条事件）：
+    {
+        "summary":     "产品评审",         # 必填
+        "date":        "2026-04-02",       # 必填 YYYY-MM-DD
+        "start":       "14:00",            # 必填 HH:MM
+        "end":         "15:30",            # 可选（省略则 start + 60 分钟）
+        "location":    "线上",             # 可选
+        "description": "Q2 规划",          # 可选
+        "remind":      15                  # 可选，提前提醒分钟数（0=不提醒）
+    }
+
+用法：
+    # 从 JSON 字符串
+    python3 apps/import_events.py --json '[{"summary":"...","date":"...","start":"..."}]'
+
+    # 从 JSON 文件
+    python3 apps/import_events.py --file /tmp/events.json
+
+    # 通过 stdin（配合 table_parser 管道）
+    python3 apps/import_events.py --stdin
+
+    # 干运行（不写 GCal）
+    python3 apps/import_events.py --file /tmp/events.json --dry-run
+
+    # 覆盖所有事件的提醒时间
+    python3 apps/import_events.py --file /tmp/events.json --remind-default 15
+
+输出（JSON）：
+    {"ok": true, "added": 3, "failed": 0, "skipped": 0, "results": [...]}
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from datetime import timedelta
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from config.settings import TIMEZONE
+from gcal.client import CalendarAPIError, CalendarAuthError
+from services.calendar_backend import active_provider, create_event as backend_create_event
+from services.datetime_utils import DateTimeValidationError, build_event_range
+from services.job_store import append_job_if_absent
+from services.task_builder import build_reminder_task, build_reminder_task_name
+
+
+# ─────────────────────────── 事件写入 ────────────────────────────
+
+def _import_one(
+    event: dict,
+    dry_run: bool,
+    remind_override: int | None,
+) -> dict:
+    """
+    导入单个事件，返回结果 dict。
+    result: {"summary": ..., "ok": bool, "event_id": ..., "error": ...}
+    """
+    summary = event.get("summary", "").strip()
+    date_str = event.get("date", "").strip()
+    start_str = event.get("start", "").strip()
+
+    if not summary or not date_str or not start_str:
+        return {"summary": summary or "(无标题)", "ok": False,
+                "error": "缺少必填字段 summary/date/start"}
+
+    end_str = event.get("end", "")
+    try:
+        start, end = build_event_range(
+            date_str,
+            start_str,
+            end_str or None,
+            60,
+            TIMEZONE,
+        )
+    except DateTimeValidationError as e:
+        return {"summary": summary, "ok": False, "error": str(e)}
+
+    location    = event.get("location",    "")
+    description = event.get("description", "")
+    remind = remind_override if remind_override is not None else int(event.get("remind", 0))
+
+    if dry_run:
+        return {
+            "summary":  summary,
+            "ok":       True,
+            "dry_run":  True,
+            "provider": active_provider(),
+            "date":     date_str,
+            "start":    start.strftime("%H:%M"),
+            "end":      end.strftime("%H:%M"),
+            "location": location,
+            "remind":   remind,
+        }
+
+    try:
+        created = backend_create_event(
+            summary=summary, start=start, end=end,
+            location=location, description=description,
+            remind_minutes=remind,
+        )
+    except (CalendarAuthError, CalendarAPIError) as e:
+        return {"summary": summary, "ok": False, "error": str(e)}
+
+    # 可选：注册 OpenClaw 提醒
+    reminder_status = {"registered": False, "existed": False, "error": None}
+    if remind > 0:
+        try:
+            from datetime import timezone as _tz
+            remind_at_utc = (start - timedelta(minutes=remind)).astimezone(_tz.utc)
+            payload = build_reminder_task(
+                name=build_reminder_task_name(summary, start, created.event_id),
+                remind_at_utc=remind_at_utc,
+                message=(
+                    f"⏰ **{summary}** 将在 {remind} 分钟后开始\n"
+                    f"🕐 {start.strftime('%H:%M')}"
+                    + (f"\n📍 {location}" if location else "")
+                ),
+            )
+            if append_job_if_absent(payload):
+                reminder_status["registered"] = True
+                reminder_status["existed"] = False
+            else:
+                reminder_status["registered"] = True
+                reminder_status["existed"] = True
+        except Exception as e:
+            reminder_status["error"] = str(e)
+
+    return {
+        "summary":              summary,
+        "ok":                   True,
+        "provider":             created.provider,
+        "sync_state":           created.sync_state,
+        "event_id":             created.event_id,
+        "date":                 date_str,
+        "start":                start.strftime("%H:%M"),
+        "end":                  end.strftime("%H:%M"),
+        "location":             location,
+        "remind":               remind,
+        "reminder_registered":  reminder_status["registered"],
+        "reminder_existed":     reminder_status["existed"],
+        "reminder_error":       reminder_status["error"],
+    }
+
+
+# ─────────────────────────── main ────────────────────────────────
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="批量导入日程事件到 Google Calendar",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    src = parser.add_mutually_exclusive_group(required=True)
+    src.add_argument("--json",  help="事件 JSON 字符串（数组）")
+    src.add_argument("--file",  help="事件 JSON 文件路径")
+    src.add_argument("--stdin", action="store_true", help="从 stdin 读取 JSON")
+    parser.add_argument("--remind-default", type=int, default=None,
+                        help="覆盖所有事件的提前提醒分钟数（0=不提醒）")
+    parser.add_argument("--dry-run", action="store_true",
+                        help="只打印 payload，不写入 Google Calendar")
+    args = parser.parse_args()
+
+    # ── 读取事件列表 ──────────────────────────────────────────────
+    try:
+        if args.json:
+            events = json.loads(args.json)
+        elif args.file:
+            with open(args.file, encoding="utf-8") as f:
+                events = json.load(f)
+        else:
+            events = json.load(sys.stdin)
+    except Exception as e:
+        print(json.dumps({"ok": False, "error": f"读取事件失败: {e}"}, ensure_ascii=False))
+        sys.exit(1)
+
+    if not isinstance(events, list):
+        events = [events]
+
+    if not events:
+        print(json.dumps({"ok": True, "added": 0, "failed": 0, "skipped": 0, "results": []},
+                         ensure_ascii=False))
+        return
+
+    # ── 逐条写入 ─────────────────────────────────────────────────
+    results = []
+    added = failed = skipped = 0
+
+    for ev in events:
+        r = _import_one(ev, args.dry_run, args.remind_default)
+        results.append(r)
+        if r["ok"]:
+            added += 1
+        else:
+            failed += 1
+
+    summary = {
+        "ok":      failed == 0,
+        "added":   added,
+        "failed":  failed,
+        "skipped": skipped,
+        "results": results,
+    }
+    print(json.dumps(summary, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,140 @@
+#!/usr/bin/env python3
+"""
+日程变化监控器。
+
+执行时机：每小时整点（北京时间 8:00–20:00），由 OpenClaw Cron 触发。
+
+流程：
+  1. 加载上次快照（data/last_events.json）
+  2. 拉取 Google Calendar 今天+明天的事件
+  3. 对比变化：新增、修改、取消
+  4. 保存新快照
+  5. 有变化时打印通知（OpenClaw 捕获 stdout 并投递）
+     无变化时只打印日志，不输出通知
+
+核心规则：
+  - 无变化 → 不通知
+  - 已结束事件消失 → 不通知
+  - 被取消事件消失 → 通知
+
+用法：
+  python3 apps/monitor_calendar_changes.py
+  python3 apps/monitor_calendar_changes.py --dry-run   # 不写快照，只打印结果
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import logging
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+# ── sys.path ─────────────────────────────────────────────────────
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from config.settings import (
+    GCAL_TOKEN_PATH, PROXIES, GCAL_TIMEOUT, GCAL_MAX_RETRIES,
+    GCAL_CALENDAR_ID, GCAL_SSL_VERIFY, TIMEZONE, DATA_DIR, LAST_EVENTS_FILE,
+)
+from gcal.client import CalendarClient
+from gcal.models import CalendarEvent
+from services.calendar_backend import active_provider
+from services.time_window import get_today_and_tomorrow_window
+from services.event_diff import diff_events
+
+logging.basicConfig(level=logging.INFO, format="%(levelname)s %(message)s")
+logger = logging.getLogger(__name__)
+
+
+# ─────────────────────────── 快照读写 ────────────────────────────
+
+def load_snapshot() -> list[CalendarEvent]:
+    if not LAST_EVENTS_FILE.exists():
+        logger.info("📝 无历史快照，首次运行")
+        return []
+    try:
+        with open(LAST_EVENTS_FILE, encoding="utf-8") as f:
+            data = json.load(f)
+        events = [CalendarEvent.from_dict(e) for e in data.get("events", [])]
+        logger.info(f"加载上次快照：{len(events)} 个事件，时间 {data.get('last_updated', '未知')}")
+        return events
+    except Exception as e:
+        logger.error(f"读取快照失败: {e}")
+        return []
+
+
+def save_snapshot(events: list[CalendarEvent]) -> None:
+    DATA_DIR.mkdir(parents=True, exist_ok=True)
+    now_utc = datetime.now(timezone.utc).isoformat()
+    # 只保存未来的事件（已结束的不再追踪）
+    future = [e for e in events if not e.is_past()]
+    data = {
+        "events":       [e.to_dict() for e in future],
+        "last_updated": now_utc,
+        "total":        len(future),
+    }
+    with open(LAST_EVENTS_FILE, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2, ensure_ascii=False)
+    logger.info(f"✅ 快照已更新：{len(future)} 个未来事件")
+
+
+# ─────────────────────────── main ────────────────────────────────
+
+def main():
+    parser = argparse.ArgumentParser(description="日程变化监控")
+    parser.add_argument("--dry-run", action="store_true",
+                        help="不写快照，仅打印变化结果")
+    args = parser.parse_args()
+
+    logger.info(f"=== 日程变化监控 {datetime.now().strftime('%Y-%m-%d %H:%M:%S')} ===")
+
+    if active_provider() != "google":
+        logger.info("当前为本地模式，跳过 Google 日程变化轮询")
+        sys.exit(0)
+
+    # ── 1. 拉取当前日程 ───────────────────────────────────────────
+    client = CalendarClient(
+        GCAL_TOKEN_PATH, PROXIES,
+        calendar_id=GCAL_CALENDAR_ID,
+        timeout=GCAL_TIMEOUT,
+        max_retries=GCAL_MAX_RETRIES,
+        verify=GCAL_SSL_VERIFY,
+    )
+    t_min, t_max = get_today_and_tomorrow_window(TIMEZONE)
+
+    try:
+        current_events = client.list_events(t_min, t_max)
+        logger.info(f"当前事件数：{len(current_events)}")
+    except Exception as e:
+        logger.error(f"❌ 拉取日程失败: {e}")
+        sys.exit(1)
+
+    # ── 2. 加载上次快照 ──────────────────────────────────────────
+    last_events = load_snapshot()
+
+    # ── 3. diff ──────────────────────────────────────────────────
+    result = diff_events(
+        current=current_events,
+        last=last_events,
+        get_remote_status=client.get_event_status,
+    )
+
+    # ── 4. 保存快照 ──────────────────────────────────────────────
+    if not args.dry_run:
+        save_snapshot(current_events)
+
+    # ── 5. 输出结果 ──────────────────────────────────────────────
+    if not result.has_changes:
+        logger.info("✅ 无变化，不发送通知")
+        sys.exit(0)
+
+    logger.info(f"检测到变化：{result.summary_text}")
+    # OpenClaw cron 会捕获 stdout 并投递给 用户
+    # 监控任务配置为 delivery:none，由此脚本自行控制是否通知
+    print(result.format_notification())
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,169 @@
+#!/usr/bin/env python3
+"""
+使用 OpenClaw API 注册 Cron 任务（不依赖 openclaw 命令）
+"""
+
+import json
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import List, Optional, Dict, Any
+
+# Handle zoneinfo import for Python 3.8 compatibility
+try:
+    from zoneinfo import ZoneInfo
+except ImportError:
+    from backports.zoneinfo import ZoneInfo
+
+# 添加父目录到路径
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from config.settings import (
+    TIMEZONE,
+    TASK_REGISTRY_FILE,
+)
+from services.task_builder import (
+    build_reminder_task,
+    build_periodic_silent_task,
+    build_report_task,
+)
+from services.job_store import append_job_if_absent, list_job_names
+from services.runtime_utils import expand_command_vars
+from services.datetime_utils import now_local
+from services.calendar_backend import active_provider
+
+
+def _utc_str(dt: datetime) -> str:
+    """转换为 UTC 时间字符串"""
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=timezone.utc)
+    return dt.astimezone(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+
+def is_task_enabled(task: Dict[str, Any], provider: str | None = None) -> bool:
+    required = task.get("requires_provider", "any")
+    current = provider or active_provider()
+    return required in {"", "any", current}
+
+
+def load_fixed_tasks(provider: str | None = None) -> List[Dict[str, Any]]:
+    """加载固定任务配置"""
+    import yaml
+    with open(TASK_REGISTRY_FILE) as f:
+        data = yaml.safe_load(f)
+    tasks = data.get("tasks", [])
+    return [task for task in tasks if is_task_enabled(task, provider=provider)]
+
+
+def build_cron_job_from_task(task: Dict[str, Any], today: datetime) -> Optional[Dict[str, Any]]:
+    """根据任务配置构建 Cron Job"""
+    name = task.get("name", "")
+    task_type = task.get("type", "")
+    message = expand_command_vars(task.get("message", task.get("command", "")))
+    schedule = task.get("schedule", {})
+    delete = task.get("delete_after_run", True)
+
+    if not name or not schedule:
+        return None
+
+    kind = schedule.get("kind")
+    zone = ZoneInfo(TIMEZONE)
+
+    if kind == "at":
+        time_str = schedule.get("time", "")
+        try:
+            h, m = map(int, time_str.split(":"))
+            bj_time = today.astimezone(zone).replace(hour=h, minute=m, second=0, microsecond=0)
+        except (ValueError, IndexError):
+            print("⚠️  无法解析时间 '{}', 跳过任务 {}".format(time_str, name))
+            return None
+
+        if task_type == "silent":
+            # 静默一次性任务
+            return {
+                "name": name,
+                "schedule": {"kind": "at", "at": _utc_str(bj_time)},
+                "sessionTarget": "isolated",
+                "payload": {"kind": "agentTurn", "message": message},
+                "delivery": {"mode": "none"},
+                "deleteAfterRun": delete,
+                "enabled": True,
+            }
+        else:
+            # 报告任务
+            return build_report_task(
+                name, message,
+                at_utc=bj_time, delete_after_run=delete,
+            )
+
+    elif kind == "cron":
+        cron_expr = schedule.get("expr", "")
+        tz = schedule.get("tz", TIMEZONE)
+        if task_type == "silent":
+            return build_periodic_silent_task(name, cron_expr, message, tz)
+        else:
+            return build_report_task(
+                name, message,
+                cron_expr=cron_expr, tz=tz, delete_after_run=delete,
+            )
+
+    return None
+
+
+def main():
+    import argparse
+    parser = argparse.ArgumentParser(description="使用 OpenClaw API 注册 Cron 任务")
+    parser.add_argument("--dry-run", action="store_true", help="只生成，不注册")
+    parser.add_argument("--days", type=int, default=1, help="生成 N 天的任务")
+    args = parser.parse_args()
+
+    # 加载任务配置
+    tasks = load_fixed_tasks()
+    print("📋 加载了 {} 个固定任务配置\n".format(len(tasks)))
+
+    # 生成任务
+    today = now_local(TIMEZONE)
+    jobs = []
+
+    for task in tasks:
+        job = build_cron_job_from_task(task, today)
+        if job:
+            jobs.append(job)
+            if args.dry_run:
+                print("[dry-run] 将注册: {}".format(job['name']))
+            else:
+                print("✅ 准备注册: {}".format(job['name']))
+
+    if args.dry_run:
+        print("\n📊 共 {} 个任务（dry-run 模式，未注册）".format(len(jobs)))
+        return
+
+    try:
+        existing_names = list_job_names()
+        print("\n📄 已有 {} 个任务".format(len(existing_names)))
+
+        new_jobs = []
+        for job in jobs:
+            name = job.get("name", "")
+            if name not in existing_names:
+                if append_job_if_absent(job):
+                    new_jobs.append(job)
+                    existing_names.add(name)
+                    print("✅ 已注册: {}".format(name))
+                else:
+                    print("⏭️  任务已存在，跳过: {}".format(name))
+            else:
+                print("⏭️  任务已存在，跳过: {}".format(name))
+
+        print("\n🎉 成功注册 {} 个新任务！".format(len(new_jobs)))
+        print("📁 任务已保存到: {}".format(Path.home() / ".openclaw" / "cron" / "jobs.json"))
+
+    except Exception as e:
+        print("\n❌ 注册失败: {}".format(e))
+        import traceback
+        traceback.print_exc()
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()