synology-calendar_办公效率 skill-PHP中文网

synology-calendar

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过API管理Synology日历事件与待办事项。支持日历、事件、待办及联系人。基于官方日历API指南(v5)。

共性日历 API 技能概览管理共性日历使用正式的日历 API. 文件: 日历 API Guide enu.pdf. 连接环境变量 QQQ快速启动.

功能概述

共性日历 API 技能概览管理共性日历使用正式的日历 API. 文件: 日历 API Guide enu.pdf. 连接环境变量 QQQ快速启动.是一项面向实际任务的技能，主要用于API 参考.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Synology Calendar API 技能

概述

使用官方 Calendar API 管理 Synology Calendar。

文档：Calendar_API_Guide_enu.pdf

连接

环境变量

export SYNOLOGY_URL="http://{nas_ip}:5000"  # 内网地址
export SYNOLOGY_USER="{username}"
export SYNOLOGY_PASSWORD="your-password"

快速开始

from client import SynologyCalendar

cal = SynologyCalendar()
cal.login()

# 列出日历
calendars = cal.get_calendars()
for c in calendars:
    print(f"{c['cal_id']}: {c['cal_displayname']}")

cal.logout()

API 参考

日历操作（SYNO.Cal.Cal）

方法	说明	状态
`get_calendars()`	列出所有日历	✅ 正常工作
`get_calendar(cal_id)`	获取日历详情	✅ 正常工作
`create_calendar(...)`	创建日历	✅ 正常工作
`delete_calendar(cal_id)`	删除日历	✅ 正常工作

事件操作（SYNO.Cal.Event）

方法	说明	状态
`list_events(cal_id_list)`	列出事件	✅ 正常工作
`get_event(evt_id)`	获取事件详情	✅ 正常工作
`create_event(...)`	创建事件	✅ 正常工作
`delete_event(evt_id)`	删除事件	✅ 正常工作

事件创建注意事项：

✅ 正常工作：

所有事件类型现均通过 v1 API 正确支持

⚠️ 重要：SID 必须作为 URL 查询参数传递，不可置于 JSON 请求体中

Synology Calendar v1 API 要求将 _sid 参数置于 URL 查询字符串中，而非 JSON 请求体中。

create_event 参数说明：

参数	类型	是否必需	示例
cal_id	string	✅	`/admin/home/`
summary	string	✅	事件标题
dtstart	int	✅	1770440000
dtend	int	✅	1770443600
is_all_day	bool	✅	`false`
is_repeat_evt	bool	✅	`false`
color	string	✅	`#D9AE00`
description	string	✅	描述内容
notify_setting	array	✅	`[]`
participant	array	✅	`[]`
timezone	string	（非全天事件时必需）	`Asia/Shanghai`

示例：

# 非全天事件（已验证可用）
cal.create_event(
    cal_id='/{username}/home/',
    summary='Meeting',
    dtstart=now,
    dtend=now + 3600,
    is_all_day=False,
    is_repeat_evt=False,
    description='Team meeting',
    color='#D9AE00',
    timezone='Asia/Shanghai'
)

待办事项操作（SYNO.Cal.Todo）

方法	说明	状态
`create_todo(...)`	创建任务	✅ 正常工作
`list_todos(...)`	列出任务	✅ 正常工作
`get_todo(evt_id)`	获取任务详情	✅ 正常工作
`delete_todo(evt_id)`	删除任务	✅ 正常工作
`complete_todo(evt_id)`	标记为完成	✅ 正常工作

联系人操作（SYNO.Cal.Contact）

方法	说明	状态
`list_contacts()`	列出参与者	✅ 正常工作

CLI 使用方式

# 登录
python client.py login

# 列出日历
python client.py list-calendars

# 列出待办事项
python client.py list-todos --cal-id "/{username}/home_todo/"

# 创建待办事项
python client.py create-todo 
  --cal-id "/{username}/home_todo/" 
  --title "Task name"

# 标记待办事项为完成
python client.py complete-todo --evt-id "1012"