Octo 的第一个 App

到点,
告诉你的 Octo。

定时、带备注、可以循环的提醒。时间一到,olock 通知你的 Octo——它会提醒你,或者接着替你把事情办了。一句话就能设好:「每天早上 8 点提醒我打卡」。

用 OGS 账号登录。olock 和 OGS 在同一个域名下,不用登记,也没有授权页。

⏰

定时,带备注

具体时间、某个钟点,或者「10 分钟后」。备注会原样带给 Octo。

🔁

循环

每 N 分钟、小时、天、周;可以设次数,也可以一直重复。暂停、恢复、改时间都行。

📮

到点通知 Octo

用 olock 为你生成的密钥推送给你的 Octo;也可以 GET / POST 任意 https 地址。

💬

一句话管理

页面右下角的小球、或者直接对 Octo 说。它们和页面按钮调用的是同一个接口。

三步用起来

  1. 登录用 OGS 账号进入时钟,已经登录过 OGS 的话直接进来。
  2. 安装到 Octo点「安装到 Octo」,Octo 打开安装页,确认即可。olock 为你生成密钥写进安装文件,两边从此用同一把。
  3. 设提醒在页面上点,对小球说,或者对 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)