会议准备

为开发团队提供自动化的会议准备和每日提交摘要。

功能

1. 1. 会议准备 — 检查Google日历中即将召开的会议（含视频链接），通知用户，生成基于提交的更新
2. 每日摘要 — 所有开发者的当日提交汇总

配置要求

Google日历OAuth

在Google Cloud Console中创建OAuth凭据：

1. 1. 启用Google Calendar API
2. 创建OAuth 2.0桌面凭据
3. 将clientsecret.json存储在credentials/目录下
4. 使用作用域进行授权：https://www.googleapis.com/auth/calendar
5. 将令牌存储在credentials/calendartokens.json中

对于多个账户，请为每个账户分别存储令牌文件。

GitHub令牌

创建一个包含repo作用域的经典个人访问令牌。存储在credentials/github_token中。

工作流程

会议准备检查

触发方式：每15分钟的Cron任务或心跳检测。

1. 1. 查询已配置日历中未来45分钟内的事件
2. 筛选包含Google Meet链接的事件（hangoutLink或conferenceData）
3. 如果会议在30-45分钟内且尚未通知：

1. 4. 如果会议在10-20分钟内：

每日提交摘要

触发方式：每日结束时的Cron任务。

1. 1. 从已配置的仓库中获取当天的所有提交
2. 包含所有开发者
3. 按仓库和子目录分组
4. 使用作者姓名进行格式化
5. 发送摘要

API参考

检查日历

bash
NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
LATER=$(date -u -d +45 minutes +%Y-%m-%dT%H:%M:%SZ)
TOKEN=$(jq -r .accesstoken credentials/calendartokens.json)

curl -s https://www.googleapis.com/calendar/v3/calendars/primary/events?timeMin=$NOW&timeMax=$LATER&singleEvents=true \
-H Authorization: Bearer $TOKEN | \
jq [.items[] | select(.hangoutLink != null or .conferenceData != null)]

刷新令牌

bash
CLIENTID=$(jq -r .installed.clientid credentials/client_secret.json)
CLIENTSECRET=$(jq -r .installed.clientsecret credentials/client_secret.json)
REFRESHTOKEN=$(jq -r .refreshtoken credentials/calendar_tokens.json)

curl -s -X POST https://oauth2.googleapis.com/token \
-d clientid=$CLIENTID \
-d clientsecret=$CLIENTSECRET \
-d refreshtoken=$REFRESHTOKEN \
-d granttype=refreshtoken

获取提交

bash
TOKEN=$(cat credentials/github_token)
SINCE=$(date -u -d -7 days +%Y-%m-%dT%H:%M:%SZ)

列出组织仓库

获取提交

输出格式

纯文本，无Markdown，无表情符号：

更新 - [日期]

[仓库名称]

[子目录]
• 变更的详细描述（作者）
• 另一项变更（作者）

今日
• [用户输入]

阻塞项
• 无

讨论
• 无

格式化规则

• 按仓库分组，再按子目录分组
• 将提交总结为有意义的描述
• 包含作者姓名
• 仅使用纯文本，便于复制粘贴

状态管理

在data/meeting-prep-state.json中跟踪状态：

json
{
notified: {},
config: {
repoFilter: org-name/*
}
}