sophhub 0.1.0

package/skills/builtin/schedule-reminder/scripts/append_event.py

@@ -0,0 +1,204 @@
+#!/usr/bin/env python3
+"""
+append_event.py - 将一条新事项追加到 Markdown 日程文件
+
+用法：
+  python3 append_event.py \
+    --file /home/node/.openclaw/workspace/日程.md \
+    --date 2026-03-03 \
+    --start 15:00 \
+    --end 16:00 \
+    --title "客户会议" \
+    [--location "线上"] \
+    [--participants "张三"] \
+    [--priority 中] \
+    [--advance 15] \
+    [--note "带方案"] \
+    [--type task]   # task = 写入待提醒任务表，默认写入主日程表
+"""
+from __future__ import annotations
+
+import sys
+import os
+import re
+import argparse
+from datetime import datetime, date
+from typing import Optional
+
+
+def parse_args():
+    p = argparse.ArgumentParser(description="追加日程事项到 Markdown 文件")
+    p.add_argument("--file", required=True, help="日程 Markdown 文件路径")
+    p.add_argument("--date", required=True, help="日期 YYYY-MM-DD")
+    p.add_argument("--start", default="", help="开始时间 HH:MM")
+    p.add_argument("--end", default="", help="结束时间 HH:MM")
+    p.add_argument("--title", required=True, help="事项名称")
+    p.add_argument("--location", default="", help="地点")
+    p.add_argument("--participants", default="", help="参与者")
+    p.add_argument("--priority", default="中", choices=["高", "中", "低"], help="优先级")
+    p.add_argument("--advance", default="15", help="提前提醒分钟数")
+    p.add_argument("--note", default="", help="备注")
+    p.add_argument("--type", default="schedule", choices=["schedule", "task"],
+                   help="写入主日程表(schedule)还是待提醒任务表(task)")
+    return p.parse_args()
+
+
+def expand_path(path: str) -> str:
+    return os.path.expanduser(path)
+
+
+def read_file(path: str) -> str:
+    if not os.path.exists(path):
+        return ""
+    with open(path, encoding="utf-8") as f:
+        return f.read()
+
+
+def write_file(path: str, content: str):
+    os.makedirs(os.path.dirname(os.path.abspath(path)), exist_ok=True)
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(content)
+
+
+def make_schedule_row(args) -> str:
+    """生成主日程表的一行"""
+    advance = args.advance if args.advance else "15"
+    return (
+        f"| {args.date} | {args.start} | {args.end} | {args.title} "
+        f"| {args.location} | {args.participants} | {args.priority} "
+        f"| {advance} | {args.note} |"
+    )
+
+
+def make_task_row(args) -> str:
+    """生成待提醒任务表的一行"""
+    # 任务表：截止日期 | 事项 | 负责人 | 优先级 | 提前提醒 | 备注
+    advance_days = ""
+    try:
+        adv_min = int(args.advance)
+        if adv_min >= 1440:
+            days = adv_min // 1440
+            advance_days = f"提前{days}天"
+        else:
+            advance_days = str(adv_min)
+    except ValueError:
+        advance_days = args.advance
+
+    return (
+        f"| {args.date} | {args.title} | {args.participants} "
+        f"| {args.priority} | {advance_days} | {args.note} |"
+    )
+
+
+SCHEDULE_HEADER = "| 日期       | 开始时间 | 结束时间 | 事项"
+SCHEDULE_HEADER_ALT = "| 日期 | 开始时间"
+TASK_HEADER = "| 截止日期"
+
+SCHEDULE_TABLE_BLOCK = """\
+## 日程
+
+| 日期       | 开始时间 | 结束时间 | 事项         | 地点 | 参与者 | 优先级 | 提前(分钟) | 备注 |
+|------------|----------|----------|--------------|------|--------|--------|------------|------|
+"""
+
+TASK_TABLE_BLOCK = """\
+## 待提醒任务
+
+| 截止日期   | 事项 | 负责人 | 优先级 | 提前提醒 | 备注 |
+|------------|------|--------|--------|----------|------|
+"""
+
+DEFAULT_FILE_TEMPLATE = """\
+<!-- skill: schedule-reminder -->
+# 我的日程
+
+> 提醒渠道：last
+> 默认提前提醒：15
+
+{schedule_block}
+{task_block}"""
+
+
+def find_table_end(lines: list, start_idx: int) -> int:
+    """从 start_idx 往下找到表格结束位置（返回最后一行表格的 index + 1）"""
+    i = start_idx
+    last_table_line = start_idx
+    while i < len(lines):
+        stripped = lines[i].strip()
+        if stripped.startswith("|"):
+            last_table_line = i
+        elif stripped == "" and i > start_idx:
+            # 空行可能是表格后的分隔，继续看下一行
+            if i + 1 < len(lines) and not lines[i + 1].strip().startswith("|"):
+                break
+        elif not stripped.startswith("|") and stripped != "":
+            break
+        i += 1
+    return last_table_line + 1
+
+
+def insert_row_into_table(content: str, new_row: str, header_pattern: str) -> Optional[str]:
+    """在找到的表格末尾插入新行，返回修改后的内容；找不到返回 None"""
+    lines = content.splitlines(keepends=True)
+    header_idx = None
+    for i, line in enumerate(lines):
+        if line.strip().startswith(header_pattern.strip()):
+            header_idx = i
+            break
+
+    if header_idx is None:
+        return None
+
+    end_idx = find_table_end(lines, header_idx)
+    lines.insert(end_idx, new_row + "\n")
+    return "".join(lines)
+
+
+def append_to_file(file_path: str, args) -> str:
+    """主逻辑：读取文件 → 找表格 → 插入新行 → 写回"""
+    content = read_file(file_path)
+
+    if args.type == "task":
+        new_row = make_task_row(args)
+        updated = insert_row_into_table(content, new_row, "| 截止日期")
+        if updated is None:
+            # 没有任务表，追加一个
+            if content and not content.endswith("\n"):
+                content += "\n"
+            content += "\n" + TASK_TABLE_BLOCK + new_row + "\n"
+            updated = content
+    else:
+        new_row = make_schedule_row(args)
+        updated = insert_row_into_table(content, new_row, "| 日期")
+        if updated is None:
+            # 没有日程表，追加一个
+            if not content:
+                # 文件为空，创建完整模板
+                updated = DEFAULT_FILE_TEMPLATE.format(
+                    schedule_block=SCHEDULE_TABLE_BLOCK + new_row,
+                    task_block=TASK_TABLE_BLOCK,
+                )
+            else:
+                if not content.endswith("\n"):
+                    content += "\n"
+                content += "\n" + SCHEDULE_TABLE_BLOCK + new_row + "\n"
+                updated = content
+
+    return updated
+
+
+def main():
+    args = parse_args()
+    file_path = expand_path(args.file)
+
+    updated_content = append_to_file(file_path, args)
+    write_file(file_path, updated_content)
+
+    # 输出确认信息
+    event_type = "任务" if args.type == "task" else "日程"
+    time_str = f"{args.start}" + (f" – {args.end}" if args.end else "")
+    print(f"✅ 已写入{event_type}：{args.date} {time_str} {args.title} → {file_path}")
+
+
+if __name__ == "__main__":
+    main()

package/skills/builtin/schedule-reminder/scripts/create_reminders.sh

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# create_reminders.sh - 从解析结果 JSON 批量创建 cron 提醒任务
+#
+# 用法：
+#   bash create_reminders.sh \
+#     --events-json /tmp/schedule_upcoming.json \
+#     --channel dingtalk \
+#     --to "user_id_or_sender"
+#
+# 环境变量（可覆盖）：
+#   SCHEDULE_CHANNEL  - 推送渠道（dingtalk / feishu / wecom / telegram）
+#   SCHEDULE_TO       - 接收者 ID
+#   SCHEDULE_TZ       - 时区（默认 Asia/Shanghai）
+
+set -euo pipefail
+
+# ── 参数解析 ──────────────────────────────────────────────
+EVENTS_JSON=""
+CHANNEL="${SCHEDULE_CHANNEL:-}"
+TO="${SCHEDULE_TO:-}"
+TZ="${SCHEDULE_TZ:-Asia/Shanghai}"
+DRY_RUN=0
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --events-json)  EVENTS_JSON="$2"; shift 2 ;;
+    --channel)      CHANNEL="$2"; shift 2 ;;
+    --to)           TO="$2"; shift 2 ;;
+    --tz)           TZ="$2"; shift 2 ;;
+    --dry-run)      DRY_RUN=1; shift ;;
+    *) echo "未知参数: $1" >&2; exit 1 ;;
+  esac
+done
+
+# ── 前置检查 ──────────────────────────────────────────────
+if [[ -z "$EVENTS_JSON" ]]; then
+  echo "错误：请指定 --events-json <file>" >&2
+  exit 1
+fi
+
+if [[ ! -f "$EVENTS_JSON" ]]; then
+  echo "错误：文件不存在: $EVENTS_JSON" >&2
+  exit 1
+fi
+
+if ! command -v jq &>/dev/null; then
+  echo "错误：需要安装 jq" >&2
+  exit 1
+fi
+
+if ! command -v openclaw &>/dev/null; then
+  echo "错误：openclaw 命令未找到" >&2
+  exit 1
+fi
+
+# ── 读取事项列表 ──────────────────────────────────────────
+COUNT=$(jq '.upcoming | length' "$EVENTS_JSON")
+
+if [[ "$COUNT" -eq 0 ]]; then
+  echo "✅ 没有需要创建提醒的事项。"
+  exit 0
+fi
+
+echo "📅 共 $COUNT 个事项需要创建提醒（渠道：$CHANNEL）"
+echo ""
+
+# ── 构建提醒消息 ──────────────────────────────────────────
+build_message() {
+  local title="$1"
+  local start_str="$2"
+  local end_str="$3"
+  local location="$4"
+  local participants="$5"
+  local note="$6"
+  local advance="$7"
+
+  local msg="⏰ 日程提醒\n\n📌 【${title}】即将在 ${advance} 分钟后开始\n🕐 ${start_str}"
+  [[ -n "$end_str" ]] && msg="${msg} – ${end_str}"
+  [[ -n "$location" ]] && msg="${msg}\n📍 ${location}"
+  [[ -n "$participants" ]] && msg="${msg}\n👥 ${participants}"
+  [[ -n "$note" ]] && msg="${msg}\n📝 ${note}"
+  echo "$msg"
+}
+
+# ── 遍历事项并创建 cron 任务 ─────────────────────────────
+CREATED=0
+SKIPPED=0
+FAILED=0
+
+for i in $(seq 0 $((COUNT - 1))); do
+  ev=$(jq ".upcoming[$i]" "$EVENTS_JSON")
+
+  title=$(echo "$ev" | jq -r '.title')
+  date_str=$(echo "$ev" | jq -r '.date')
+  start_str=$(echo "$ev" | jq -r '.start_str')
+  end_str=$(echo "$ev" | jq -r '.end_str')
+  location=$(echo "$ev" | jq -r '.location // ""')
+  participants=$(echo "$ev" | jq -r '.participants // ""')
+  note=$(echo "$ev" | jq -r '.note // ""')
+  advance=$(echo "$ev" | jq -r '.advance_min')
+  remind_cron=$(echo "$ev" | jq -r '.remind_cron // ""')
+  remind_time=$(echo "$ev" | jq -r '.remind_time_str // ""')
+  priority=$(echo "$ev" | jq -r '.priority')
+
+  # 没有 cron 表达式则跳过
+  if [[ -z "$remind_cron" || "$remind_cron" == "null" ]]; then
+    echo "  ⏭️  跳过（无时间信息）：${title}"
+    ((SKIPPED++)) || true
+    continue
+  fi
+
+  # 构建任务名（避免特殊字符）
+  safe_title=$(echo "$title" | tr ' 【】《》""''()（）' '_' | tr -cd '[:alnum:]_-' | cut -c1-40)
+  task_name="schedule-${date_str}-${safe_title}"
+
+  # 构建提醒消息
+  msg=$(build_message "$title" "$start_str" "$end_str" "$location" "$participants" "$note" "$advance")
+
+  echo "  ➕ [${priority}] ${title}"
+  echo "     提醒时刻：${remind_time}（提前 ${advance} 分钟）"
+  echo "     Cron：${remind_cron}"
+
+  if [[ "$DRY_RUN" -eq 1 ]]; then
+    echo "     [DRY-RUN] 跳过实际创建"
+    ((CREATED++)) || true
+    continue
+  fi
+
+  # 构建 openclaw cron 命令
+  # 使用 --system-event + --session main，触发 main session 直接显示提醒消息，
+  # 不走 announce 推送流程，兼容 webchat/控制台等所有渠道，无需渠道配置。
+  CRON_CMD=(
+    openclaw cron add
+    --name "$task_name"
+    --cron "$remind_cron"
+    --tz "$TZ"
+    --session main
+    --system-event "$msg"
+    --delete-after-run
+  )
+
+  if "${CRON_CMD[@]}" 2>/dev/null; then
+    echo "     ✅ 已创建"
+    ((CREATED++)) || true
+  else
+    echo "     ❌ 创建失败" >&2
+    ((FAILED++)) || true
+  fi
+
+  echo ""
+done
+
+# ── 汇总 ─────────────────────────────────────────────────
+echo "────────────────────────────────"
+echo "✅ 成功创建：${CREATED} 个提醒任务"
+[[ "$SKIPPED" -gt 0 ]] && echo "⏭️  跳过：${SKIPPED} 个"
+[[ "$FAILED" -gt 0 ]] && echo "❌ 失败：${FAILED} 个"
+echo ""
+echo "查看所有提醒任务："
+echo "  openclaw cron list"
+echo ""
+echo "删除指定任务："
+echo "  openclaw cron remove <task-id>"

package/skills/builtin/schedule-reminder/scripts/daily_activate.sh

@@ -0,0 +1,175 @@
+#!/usr/bin/env bash
+# daily_activate.sh - 每天自动激活：读取日程文件 → 解析今日事项 → 创建提醒 → 发日报
+#
+# 由 setup.sh 注册为每日定时任务，无需用户手动触发。
+#
+# 依赖：
+#   ~/.config/schedule-reminder/config.env  （由 setup.sh 写入）
+#   python3, jq, openclaw
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CONFIG_FILE="${HOME}/.config/schedule-reminder/config.env"
+
+# ── 读取配置 ──────────────────────────────────────────────
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "[schedule-reminder] 错误：配置文件不存在，请先运行 setup.sh" >&2
+  exit 1
+fi
+
+# shellcheck source=/dev/null
+source "$CONFIG_FILE"
+
+# 必填变量检查
+: "${SCHEDULE_FILE:?'请在 config.env 中设置 SCHEDULE_FILE'}"
+: "${SCHEDULE_TZ:=Asia/Shanghai}"
+: "${SCHEDULE_ADVANCE_MIN:=15}"
+: "${SCHEDULE_DAILY_HOUR:=7}"
+: "${SCHEDULE_DAILY_MIN:=0}"
+: "${SCHEDULE_SEND_SUMMARY:=true}"
+# SCHEDULE_CHANNEL / SCHEDULE_RECIPIENT 为可选，留空则 cron 默认回到上次对话渠道（channel=last）
+SCHEDULE_CHANNEL="${SCHEDULE_CHANNEL:-}"
+SCHEDULE_RECIPIENT="${SCHEDULE_RECIPIENT:-}"
+
+TODAY=$(TZ="$SCHEDULE_TZ" date +%Y-%m-%d)
+NOW=$(TZ="$SCHEDULE_TZ" date +"%Y-%m-%d %H:%M")
+LOG_DIR="${HOME}/.config/schedule-reminder/logs"
+mkdir -p "$LOG_DIR"
+LOG_FILE="${LOG_DIR}/activate-${TODAY}.log"
+
+log() { echo "[$(date '+%H:%M:%S')] $*" | tee -a "$LOG_FILE"; }
+
+log "===== 日程提醒 每日激活 ====="
+log "日期：$TODAY  渠道：${SCHEDULE_CHANNEL:-last}  接收者：${SCHEDULE_RECIPIENT:-(上次对话用户)}"
+
+# ── 展开文件路径 ──────────────────────────────────────────
+SCHEDULE_FILE_EXPANDED="${SCHEDULE_FILE/#\~/$HOME}"
+
+if [[ ! -f "$SCHEDULE_FILE_EXPANDED" ]]; then
+  MSG="⚠️ 日程文件未找到：${SCHEDULE_FILE}\n请检查文件路径是否正确。"
+  SEND_CMD=(openclaw message send --message "$MSG")
+  [[ -n "$SCHEDULE_CHANNEL" ]] && SEND_CMD+=(--channel "$SCHEDULE_CHANNEL")
+  [[ -n "$SCHEDULE_RECIPIENT" ]] && SEND_CMD+=(--to "$SCHEDULE_RECIPIENT")
+  "${SEND_CMD[@]}" 2>>"$LOG_FILE" || true
+  log "错误：日程文件不存在：$SCHEDULE_FILE_EXPANDED"
+  exit 1
+fi
+
+# ── 解析日程 ──────────────────────────────────────────────
+PARSE_OUT="/tmp/schedule_parsed_${TODAY}.json"
+
+python3 "${SCRIPT_DIR}/parse_schedule.py" \
+  --file "$SCHEDULE_FILE_EXPANDED" \
+  --mode today \
+  --now "$NOW" \
+  > "$PARSE_OUT" 2>>"$LOG_FILE"
+
+UPCOMING_COUNT=$(jq '.summary.upcoming_count' "$PARSE_OUT")
+CONFLICT_COUNT=$(jq '.summary.conflict_count' "$PARSE_OUT")
+
+log "解析完成：today=$UPCOMING_COUNT 个事项，冲突=$CONFLICT_COUNT"
+
+# ── 过滤掉「提醒时刻已过」的事项 ─────────────────────────
+NOW_MIN=$(TZ="$SCHEDULE_TZ" date +%H:%M | awk -F: '{print $1*60+$2}')
+FUTURE_EVENTS=$(jq --argjson now_min "$NOW_MIN" '
+  .upcoming | map(select(
+    (.remind_cron != null) and (.start_min != null) and (.start_min > $now_min)
+  ))
+' "$PARSE_OUT")
+
+FUTURE_COUNT=$(echo "$FUTURE_EVENTS" | jq 'length')
+log "有效（未过期）提醒事项：$FUTURE_COUNT 个"
+
+# ── 构建今日日报消息 ──────────────────────────────────────
+build_summary() {
+  local date_cn
+  date_cn=$(TZ="$SCHEDULE_TZ" date +"%m月%d日")
+
+  local lines="📅 今日日程 · ${date_cn}\n\n"
+
+  if [[ "$FUTURE_COUNT" -eq 0 && "$UPCOMING_COUNT" -eq 0 ]]; then
+    lines+="今日没有日程安排，好好休息！\n"
+  else
+    # 有效提醒列表
+    if [[ "$FUTURE_COUNT" -gt 0 ]]; then
+      lines+="待提醒事项（共 ${FUTURE_COUNT} 个）：\n"
+      while IFS= read -r ev; do
+        local title start_str end_str location advance remind_str priority_icon
+        title=$(echo "$ev" | jq -r '.title')
+        start_str=$(echo "$ev" | jq -r '.start_str')
+        end_str=$(echo "$ev" | jq -r '.end_str')
+        location=$(echo "$ev" | jq -r '.location // ""')
+        advance=$(echo "$ev" | jq -r '.advance_min')
+        remind_str=$(echo "$ev" | jq -r '.remind_time_str // ""')
+        local priority
+        priority=$(echo "$ev" | jq -r '.priority')
+        case "$priority" in
+          高) priority_icon="🔴" ;;
+          中) priority_icon="🟡" ;;
+          低) priority_icon="⚪" ;;
+          *) priority_icon="🔵" ;;
+        esac
+
+        lines+="  ${priority_icon} ${start_str}–${end_str} 【${title}】"
+        [[ -n "$location" ]] && lines+=" @ ${location}"
+        [[ -n "$remind_str" ]] && lines+="（⏰ ${remind_str} 提醒，提前${advance}分钟）"
+        lines+="\n"
+      done < <(echo "$FUTURE_EVENTS" | jq -c '.[]')
+    fi
+
+    # 已过期事项说明
+    local expired_count
+    expired_count=$(( UPCOMING_COUNT - FUTURE_COUNT ))
+    if [[ "$expired_count" -gt 0 ]]; then
+      lines+="\n（另有 ${expired_count} 个事项已开始或已结束，不再提醒）\n"
+    fi
+  fi
+
+  # 冲突提示
+  if [[ "$CONFLICT_COUNT" -gt 0 ]]; then
+    lines+="\n⚠️ 检测到 ${CONFLICT_COUNT} 个时间冲突：\n"
+    while IFS= read -r conflict; do
+      local msg
+      msg=$(echo "$conflict" | jq -r '.message')
+      lines+="  ${msg}\n"
+    done < <(jq -c '.conflicts[]' "$PARSE_OUT")
+  fi
+
+  lines+="\n祝今天顺利！"
+  echo -e "$lines"
+}
+
+# ── 发送日报 ──────────────────────────────────────────────
+if [[ "$SCHEDULE_SEND_SUMMARY" == "true" && "$UPCOMING_COUNT" -gt 0 ]]; then
+  SUMMARY=$(build_summary)
+  SEND_CMD=(openclaw message send --message "$SUMMARY")
+  [[ -n "$SCHEDULE_CHANNEL" ]] && SEND_CMD+=(--channel "$SCHEDULE_CHANNEL")
+  [[ -n "$SCHEDULE_RECIPIENT" ]] && SEND_CMD+=(--to "$SCHEDULE_RECIPIENT")
+  "${SEND_CMD[@]}" 2>>"$LOG_FILE" && log "日报已发送" || log "日报发送失败"
+elif [[ "$UPCOMING_COUNT" -eq 0 ]]; then
+  log "今日无日程，跳过日报"
+fi
+
+# ── 创建今日提醒 cron 任务 ───────────────────────────────
+if [[ "$FUTURE_COUNT" -gt 0 ]]; then
+  # 将有效事项写入临时文件（按 create_reminders.sh 期望的结构）
+  echo "$FUTURE_EVENTS" | jq '{
+    meta: {},
+    summary: { upcoming_count: length },
+    upcoming: .
+  }' > "/tmp/schedule_upcoming_${TODAY}.json"
+
+  bash "${SCRIPT_DIR}/create_reminders.sh" \
+    --events-json "/tmp/schedule_upcoming_${TODAY}.json" \
+    --channel "$SCHEDULE_CHANNEL" \
+    --to "$SCHEDULE_RECIPIENT" \
+    --tz "$SCHEDULE_TZ" \
+    2>>"$LOG_FILE" | tee -a "$LOG_FILE"
+
+  log "提醒任务创建完成"
+else
+  log "无有效提醒事项，跳过创建"
+fi
+
+log "===== 激活完成 ====="