⏰
定时,带备注
具体时间、某个钟点,或者「10 分钟后」。备注会原样带给 Octo。
🔁
循环
每 N 分钟、小时、天、周;可以设次数,也可以一直重复。暂停、恢复、改时间都行。
📮
到点通知 Octo
用 olock 为你生成的密钥推送给你的 Octo;也可以 GET / POST 任意 https 地址。
💬
一句话管理
页面右下角的小球、或者直接对 Octo 说。它们和页面按钮调用的是同一个接口。
三步用起来
- 登录用 OGS 账号进入时钟,已经登录过 OGS 的话直接进来。
- 安装到 Octo点「安装到 Octo」,Octo 打开安装页,确认即可。olock 为你生成密钥写进安装文件,两边从此用同一把。
- 设提醒在页面上点,对小球说,或者对 Octo 说「明天 9 点提醒我交周报」。到点 Octo 就会收到。
给开发者
olock 是一个没有自带模型的 Octo App:安装文件里 url 是 http://127.0.0.1,也就是借用 Octo 为 App 准备的模型;它只提供工具。
- 安装文件(不含密钥):
https://olock.earth.icu/install.json - 工具接口:
POST https://olock.earth.icu/octo/tools,{name, arguments}。Octo 带Authorization: Bearer <密钥>,网页带登录会话——同一个接口。 - 到点推送:
POST https://octo.earth.icu/v1/notify,带同一把密钥。 - 直接用 /install.json 安装也行,但那样密钥是 Octo 生成的,olock 不认识,工具调用会被拒绝——所以请从时钟页面安装。
工具
get_time返回当前时间、用户的时区和今天是星期几list_reminders列出用户的提醒事项(默认只列进行中和已暂停的),包括下次提醒时间、重复方式、已提醒次数create_reminder新建一个提醒update_reminder修改一个提醒:只改给出的字段delete_reminder删除一个提醒trigger_reminder立即发出一次这个提醒(用来测试),不影响原来的安排list_runs最近的提醒发送记录:什么时候发的、发给哪里、成功没有set_timezone设置用户的时区(IANA 名称,例如 Asia/Shanghai、America/New_York)