Skylight日历管理

技能简介

Skylight Calendar 是一款通过非官方 API 控制 Skylight 智能日历框架的工具，支持查看和创建日程事件、管理家庭家务、处理购物或待办清单、查询奖励积分等功能。

业务背景

Skylight日历管理工具帮助企业家庭或小型团队实现智能日程的自动化管控。通过统一入口查看多成员日程、分配家务任务、同步购物清单，减少日常协调的沟通成本，让家庭事务管理与工作节奏无缝衔接。

落地案例：某远程创业团队成员共用Skylight框架管理共享日程。行政人员每日自动抓取框架上的会议安排同步至团队群，周末通过API批量生成下周家务轮值表并推送到各成员手机。采购前调用购物清单接口核对库存，避免重复购买。所有操作均通过环境变量一键配置完成，无需人工逐条录入。

能做什么

• 查看和创建日历事件，按日期范围筛选
• 管理家庭家务分配与完成状态
• 维护购物清单和待办事项列表
• 查询家庭成员的奖励积分
• 与 Skylight 智能显示屏交互

使用说明

环境变量配置：

1. 设置 SKYLIGHT_URL：基础地址（默认 https://app.ourskylight.com）
2. 设置 SKYLIGHT_FRAME_ID：登录 ours skylight.com，点击日历后从 URL 复制数字 ID

认证方式（二选一）：

方式 A – 邮箱密码（推荐）：

# 安装依赖
# 需要 curl 和 jq

# 登录获取凭证
LOGIN_RESPONSE=$(curl -s -X POST "$SKYLIGHT_URL/api/sessions" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "'"$SKYLIGHT_EMAIL"'",
    "password": "'"$SKYLIGHT_PASSWORD"'"
  }')

USER_ID=$(echo "$LOGIN_RESPONSE" | jq -r '.data.id')
USER_TOKEN=$(echo "$LOGIN_RESPONSE" | jq -r '.data.attributes.token')
SKYLIGHT_TOKEN="Basic $(echo -n "${USER_ID}:${USER_TOKEN}" | base64)"

方式 B – 预捕获令牌：设置 SKYLIGHT_TOKEN 为完整的 Authorization 头值

常用操作示例：

# 列出日程事件
curl -s "$SKYLIGHT_URL/api/frames/$SKYLIGHT_FRAME_ID/calendar_events?date_min=2025-01-27&date_max=2025-01-31" \
  -H "Authorization: $SKYLIGHT_TOKEN"

# 创建家务
curl -s -X POST "$SKYLIGHT_URL/api/frames/$SKYLIGHT_FRAME_ID/chores" \
  -H "Authorization: $SKYLIGHT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"data":{"type":"chore","attributes":{"summary":"倒垃圾","status":"pending","start":"2025-01-28"}}}'

# 查看清单
curl -s "$SKYLIGHT_URL/api/frames/$SKYLIGHT_FRAME_ID/lists" \
  -H "Authorization: $SKYLIGHT_TOKEN"

输入与输出

见下方输入与输出表格。

风险提示

• 使用非官方 API，存在接口变更或服务中断风险
• 令牌在登出后会轮换，需重新获取
• 需妥善保管账号密码和令牌，避免泄露
• 依赖外部网络连接至 Skylight 服务器

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/riyadchowdhury/skylight-skill/SKILL.md
来源类型：开源社区技能