Cal.diy 集成 Lyra 视频会议应用从 OAuth 授权到自动创建会议的完整实现解析【免费下载链接】cal.diyScheduling infrastructure for absolutely everyone.项目地址: https://gitcode.com/GitHub_Trending/ca/cal.diy本指南以 Cal.diy开源日程调度平台内置的 Lyra 应用packages/app-store/lyra为线索讲解如何在 Cal.diy 中安装并配置第三方视频会议应用剖析其 OAuth 授权、凭证管理、会议创建与刷新令牌等完整链路。读完本文你将掌握 Cal.diy App Store 中 conferencing会议类应用的接入原理并能基于源码理解 Lyra 的一键入会、自动生成会议链接是如何落地的。Lyra 是什么面向专业用户的会议平台Lyra 是一款面向专业销售与商务人群的视频会议平台主打专业、高效、零负担的会议体验。根据官方应用描述DESCRIPTION.md其核心价值体现在三方面一键入会无需下载参会者点击链接即可加入没有可见的机器人旁观者体验干净无干扰实时 AI 协作者Live AI Teammate会议进行中即可提问挂断前就能生成方案Proposals无需再把转录文本复制到其他 AI 平台、也不必等待录音处理完成零运维管理Zero-Touch Admin后续跟进Follow-ups自动生成、下一步行动即时捕获每次会议都可被检索帮团队摆脱每周手工录入数据的低效工作。在 Cal.diy 的定位中Lyra 属于conferencing会议类应用见 config.json 中的variant: conferencing与categories: [conferencing]它作为事件类型Event Type的视频会议选项存在当访客完成预约后Cal.diy 会自动调用 Lyra API 生成会议链接并写入预约信息。应用注册信息config.json 与应用键每个 Cal.diy App Store 应用都由一个 config.json 描述元数据。Lyra 的关键配置如下配置项值说明sluglyra应用唯一标识官方注释强调不要修改 slugtypelyra_video凭证类型Credential Type用于区分存储的 OAuth 令牌variantconferencing应用变体决定其在 App Store 中的分类入口categories[conferencing]所属类别isOAuthtrue走 OAuth 授权码流程appData.locationintegrations:lyra注册为动态会议地点类型标签为 Lyra Meetinglogoicon.svg图标文件见 static/icon.svg值得注意的是appData.location中的linkType: dynamic它表示 Lyra 会议链接不是管理员预先填写的固定地址而是在每次预约发生时动态生成这正是VideoApiAdapter中createMeeting的职责所在。应用的实际运行需要一对 OAuth 凭证client_id/client_secret其校验规则定义在 zod.tsexport const appKeysSchema z.object({ client_id: z.string().min(1), client_secret: z.string().min(1), });这两个键通过 getLyraAppKeys.ts 从应用密钥存储中读取并做 Schema 校验供授权跳转和令牌刷新使用。在自托管部署时你需要通过 Cal.diy 管理后台为lyra应用配置这两个密钥。安装三步走从 App Store 到事件类型根据 DESCRIPTION.md 的 How It Works 章节在 Cal.diy 中使用 Lyra 只需四个步骤从 Cal.diy App Store 安装 Lyra使用 Lyra 账户登录授权 Cal.diy 访问OAuth 授权在事件类型Event Type设置中将会议选项Conferencing选择为 Lyra此后每产生一笔预约Lyra 会议链接都会被自动生成并包含在预约确认中。其中步骤 2 的授权动作对应代码里的add与callback两个 API 处理器见下文步骤 4 则由VideoApiAdapter.createMeeting完成。OAuth 授权流程源码剖析Lyra 的 OAuth 授权采用标准的授权码Authorization Code模式涉及两个 Next.js API 路由由 api/index.ts 统一导出。第一步发起授权addapi/add.ts 处理GET /api/integrations/lyra/add请求核心逻辑是拼接授权 URL 并重定向const params { response_type: code, client_id, redirect_uri: ${WEBAPP_URL_FOR_OAUTH}/api/integrations/lyra/callback, scope: meeting.create, state, }; const query stringify(params); const url ${LYRA_API_URL}/oauth/authorize?${query};几个值得注意的实现细节scope: meeting.create只申请创建会议的权限最小化授权范围state由encodeOAuthState生成携带跳转回执信息如安装成功后的返回地址、出错地址防止 CSRF 并保证授权完成后能回到正确页面WEBAPP_URL_FOR_OAUTHOAuth 专用的站点地址常量避免站点启用了代理/重写后回调地址不匹配处理器开头会先校验当前登录用户存在prisma.user.findFirstOrThrow确保是已登录用户在安装应用。第二步回调换令牌callbackapi/callback.ts 处理授权回调执行用授权码换取访问令牌的完整流程错误兜底若 Lyra 返回error参数用户拒绝授权等则通过getSafeRedirectUrl安全重定向回onErrorReturnTo默认回到/apps/installed/conferencing不会让用户卡在错误页换取令牌携带grant_type: authorization_code、code、client_id、client_secret、redirect_uri向${LYRA_API_URL}/api/oauth/token发起POST请求令牌标准化将 Lyra 返回的expires_in秒转换为 Cal.diy 统一的expiry_date绝对毫秒时间戳并删除原始字段responseBody.expiry_date Math.round(Date.now() responseBody.expires_in * 1000); delete responseBody.expires_in;注释明确指出这是为了遵循 Cal.diys universal OAuth token schema保证所有 OAuth 应用使用同一套令牌结构去重存储先deleteMany删除该用户已有的lyra_video凭证再通过createOAuthAppCredential写入新凭证避免重复安装产生多条冗余凭证安全跳转使用getSafeRedirectUrl处理returnTo默认跳回安装成功页getInstalledAppPath({ variant: conferencing, slug: lyra })。这里多次出现getSafeRedirectUrl体现了 Cal.diy 对开放重定向Open Redirect漏洞的防御策略是接入第三方 OAuth 时必须遵循的安全模式。视频会议适配器自动创建 Lyra 会议Lyra 的核心实现位于 lib/VideoApiAdapter.ts它实现 Cal.diy 的VideoApiAdapter接口类型定义见 packages/types/VideoApiAdapter.d.ts将 Cal.diy 的通用会议调度逻辑翻译成 Lyra 的 API 调用。统一的 OAuth 请求层适配器内部通过OAuthManagerpackages/app-store/_utils/oauth/OAuthManager.ts封装所有对外请求自动处理令牌生命周期刷新令牌fetchNewTokenObject在访问令牌过期时用refresh_token重新请求/api/oauth/tokengrant_type: refresh_token失效判定isTokenObjectUnusable检测invalid_grant错误、isAccessTokenUnusable检测 401 状态判定令牌不可用失效处理invalidateTokenObject调用invalidateCredential使凭证作废expireAccessToken调用markTokenAsExpired标记过期updateTokenObject将新令牌写回数据库。所有请求都经由fetchLyraApi(endpoint, options)发起OAuthManager会在必要时自动完成检测过期 → 刷新 → 重试对上层调用方透明。createMeeting预约即开会当访客成功预约一个将 Lyra 设为会议方式的事件类型时Cal.diy 会调用createMeetingconst data (await fetchLyraApi(/api/v1/meeting, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ title: event.title, start: event.startTime, attendees: event.attendees.map((attendee) attendee.email), }), })) as { id: string; url: string; password?: string }; return { type: lyra_video, id: data.id, password: data.password || , url: data.url, };请求体只包含三个字段会议标题取自事件标题、开始时间事件开始时间、参会者邮箱列表由事件的attendees映射而来。返回的url、password、id会被写入会议引用Booking Reference最终出现在预约确认邮件和会议地点信息中——这就是预约后 Lyra 会议链接自动生成的底层实现。其他接口的实现策略getAvailability返回空数组即不参与某时间段是否有会的忙碌判定deleteMeeting / updateMeeting当前实现为 no-op仅记录调试日志更新会议时直接返回原会议信息。从源码结构看这是为了让VideoApiAdapter接口保持完整而采用的占位实现真正依赖预约变更重建或由 Lyra 侧管理会议。适配器的所有调用都经过带[lyra]前缀的子日志器logger.getSubLogger并在失败时用safeStringify记录错误上下文便于排查 OAuth 或 API 层故障。API 端点速查端点相对LYRA_API_URL方法用途/oauth/authorizeGET跳转至 Lyra 授权页参数含scopemeeting.create/api/oauth/tokenPOST授权码换令牌 / 刷新令牌/api/v1/meetingPOST创建会议title、start、attendees其中LYRA_API_URL定义在 lib/constants.ts当前值为https://app.lyra.so。从 Lyra 到通用Cal.diy 会议应用接入范式Lyra 应用是观察 Cal.diy conferencing 类应用标准架构的绝佳样本其目录结构packages/app-store/lyra可以归纳为通用模板config.json元数据slug、type、variant、OAuth 标记、地点注册api/add.tsapi/callback.tsOAuth 授权入口与令牌回调lib/VideoApiAdapter.ts实现VideoApiAdapter接口翻译会议生命周期操作lib/getLyraAppKeys.tszod.ts应用密钥的读取与校验lib/constants.ts第三方 API 基址常量static/icon.svg商店展示图标。以此对照其他会议类应用如zoomvideo、dailyvideo、jitsivideo等见 packages/app-store遵循同一套骨架OAuth 凭证由_utils/oauth统一管理会议能力由各自的VideoApiAdapter提供事件类型的动态会议地点由appData.location.linkType: dynamic声明。理解了 Lyra就等于理解了 Cal.diy 全部视频会议集成的核心模式。小结Lyra 在 Cal.diy 中的集成可以概括为一条清晰链路安装App Store→ 授权OAuth 授权码→ 选择事件类型会议选项→ 自动生成createMeeting 创建会议。源码层面add.ts负责发起授权、callback.ts负责换令牌并标准化存储、VideoApiAdapter依托OAuthManager自动管理令牌生命周期并调用 Lyra 创建会议。若要在自托管环境中启用 Lyra只需配置client_id/client_secret两个应用键即可让团队在预约流程中无缝获得零运维、AI 辅助、自动跟进的专业会议体验。【免费下载链接】cal.diyScheduling infrastructure for absolutely everyone.项目地址: https://gitcode.com/GitHub_Trending/ca/cal.diy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Cal.diy 集成 Lyra 视频会议应用：从 OAuth 授权到自动创建会议的完整实现解析
Cal.diy 集成 Lyra 视频会议应用从 OAuth 授权到自动创建会议的完整实现解析【免费下载链接】cal.diyScheduling infrastructure for absolutely everyone.项目地址: https://gitcode.com/GitHub_Trending/ca/cal.diy本指南以 Cal.diy开源日程调度平台内置的 Lyra 应用packages/app-store/lyra为线索讲解如何在 Cal.diy 中安装并配置第三方视频会议应用剖析其 OAuth 授权、凭证管理、会议创建与刷新令牌等完整链路。读完本文你将掌握 Cal.diy App Store 中 conferencing会议类应用的接入原理并能基于源码理解 Lyra 的一键入会、自动生成会议链接是如何落地的。Lyra 是什么面向专业用户的会议平台Lyra 是一款面向专业销售与商务人群的视频会议平台主打专业、高效、零负担的会议体验。根据官方应用描述DESCRIPTION.md其核心价值体现在三方面一键入会无需下载参会者点击链接即可加入没有可见的机器人旁观者体验干净无干扰实时 AI 协作者Live AI Teammate会议进行中即可提问挂断前就能生成方案Proposals无需再把转录文本复制到其他 AI 平台、也不必等待录音处理完成零运维管理Zero-Touch Admin后续跟进Follow-ups自动生成、下一步行动即时捕获每次会议都可被检索帮团队摆脱每周手工录入数据的低效工作。在 Cal.diy 的定位中Lyra 属于conferencing会议类应用见 config.json 中的variant: conferencing与categories: [conferencing]它作为事件类型Event Type的视频会议选项存在当访客完成预约后Cal.diy 会自动调用 Lyra API 生成会议链接并写入预约信息。应用注册信息config.json 与应用键每个 Cal.diy App Store 应用都由一个 config.json 描述元数据。Lyra 的关键配置如下配置项值说明sluglyra应用唯一标识官方注释强调不要修改 slugtypelyra_video凭证类型Credential Type用于区分存储的 OAuth 令牌variantconferencing应用变体决定其在 App Store 中的分类入口categories[conferencing]所属类别isOAuthtrue走 OAuth 授权码流程appData.locationintegrations:lyra注册为动态会议地点类型标签为 Lyra Meetinglogoicon.svg图标文件见 static/icon.svg值得注意的是appData.location中的linkType: dynamic它表示 Lyra 会议链接不是管理员预先填写的固定地址而是在每次预约发生时动态生成这正是VideoApiAdapter中createMeeting的职责所在。应用的实际运行需要一对 OAuth 凭证client_id/client_secret其校验规则定义在 zod.tsexport const appKeysSchema z.object({ client_id: z.string().min(1), client_secret: z.string().min(1), });这两个键通过 getLyraAppKeys.ts 从应用密钥存储中读取并做 Schema 校验供授权跳转和令牌刷新使用。在自托管部署时你需要通过 Cal.diy 管理后台为lyra应用配置这两个密钥。安装三步走从 App Store 到事件类型根据 DESCRIPTION.md 的 How It Works 章节在 Cal.diy 中使用 Lyra 只需四个步骤从 Cal.diy App Store 安装 Lyra使用 Lyra 账户登录授权 Cal.diy 访问OAuth 授权在事件类型Event Type设置中将会议选项Conferencing选择为 Lyra此后每产生一笔预约Lyra 会议链接都会被自动生成并包含在预约确认中。其中步骤 2 的授权动作对应代码里的add与callback两个 API 处理器见下文步骤 4 则由VideoApiAdapter.createMeeting完成。OAuth 授权流程源码剖析Lyra 的 OAuth 授权采用标准的授权码Authorization Code模式涉及两个 Next.js API 路由由 api/index.ts 统一导出。第一步发起授权addapi/add.ts 处理GET /api/integrations/lyra/add请求核心逻辑是拼接授权 URL 并重定向const params { response_type: code, client_id, redirect_uri: ${WEBAPP_URL_FOR_OAUTH}/api/integrations/lyra/callback, scope: meeting.create, state, }; const query stringify(params); const url ${LYRA_API_URL}/oauth/authorize?${query};几个值得注意的实现细节scope: meeting.create只申请创建会议的权限最小化授权范围state由encodeOAuthState生成携带跳转回执信息如安装成功后的返回地址、出错地址防止 CSRF 并保证授权完成后能回到正确页面WEBAPP_URL_FOR_OAUTHOAuth 专用的站点地址常量避免站点启用了代理/重写后回调地址不匹配处理器开头会先校验当前登录用户存在prisma.user.findFirstOrThrow确保是已登录用户在安装应用。第二步回调换令牌callbackapi/callback.ts 处理授权回调执行用授权码换取访问令牌的完整流程错误兜底若 Lyra 返回error参数用户拒绝授权等则通过getSafeRedirectUrl安全重定向回onErrorReturnTo默认回到/apps/installed/conferencing不会让用户卡在错误页换取令牌携带grant_type: authorization_code、code、client_id、client_secret、redirect_uri向${LYRA_API_URL}/api/oauth/token发起POST请求令牌标准化将 Lyra 返回的expires_in秒转换为 Cal.diy 统一的expiry_date绝对毫秒时间戳并删除原始字段responseBody.expiry_date Math.round(Date.now() responseBody.expires_in * 1000); delete responseBody.expires_in;注释明确指出这是为了遵循 Cal.diys universal OAuth token schema保证所有 OAuth 应用使用同一套令牌结构去重存储先deleteMany删除该用户已有的lyra_video凭证再通过createOAuthAppCredential写入新凭证避免重复安装产生多条冗余凭证安全跳转使用getSafeRedirectUrl处理returnTo默认跳回安装成功页getInstalledAppPath({ variant: conferencing, slug: lyra })。这里多次出现getSafeRedirectUrl体现了 Cal.diy 对开放重定向Open Redirect漏洞的防御策略是接入第三方 OAuth 时必须遵循的安全模式。视频会议适配器自动创建 Lyra 会议Lyra 的核心实现位于 lib/VideoApiAdapter.ts它实现 Cal.diy 的VideoApiAdapter接口类型定义见 packages/types/VideoApiAdapter.d.ts将 Cal.diy 的通用会议调度逻辑翻译成 Lyra 的 API 调用。统一的 OAuth 请求层适配器内部通过OAuthManagerpackages/app-store/_utils/oauth/OAuthManager.ts封装所有对外请求自动处理令牌生命周期刷新令牌fetchNewTokenObject在访问令牌过期时用refresh_token重新请求/api/oauth/tokengrant_type: refresh_token失效判定isTokenObjectUnusable检测invalid_grant错误、isAccessTokenUnusable检测 401 状态判定令牌不可用失效处理invalidateTokenObject调用invalidateCredential使凭证作废expireAccessToken调用markTokenAsExpired标记过期updateTokenObject将新令牌写回数据库。所有请求都经由fetchLyraApi(endpoint, options)发起OAuthManager会在必要时自动完成检测过期 → 刷新 → 重试对上层调用方透明。createMeeting预约即开会当访客成功预约一个将 Lyra 设为会议方式的事件类型时Cal.diy 会调用createMeetingconst data (await fetchLyraApi(/api/v1/meeting, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ title: event.title, start: event.startTime, attendees: event.attendees.map((attendee) attendee.email), }), })) as { id: string; url: string; password?: string }; return { type: lyra_video, id: data.id, password: data.password || , url: data.url, };请求体只包含三个字段会议标题取自事件标题、开始时间事件开始时间、参会者邮箱列表由事件的attendees映射而来。返回的url、password、id会被写入会议引用Booking Reference最终出现在预约确认邮件和会议地点信息中——这就是预约后 Lyra 会议链接自动生成的底层实现。其他接口的实现策略getAvailability返回空数组即不参与某时间段是否有会的忙碌判定deleteMeeting / updateMeeting当前实现为 no-op仅记录调试日志更新会议时直接返回原会议信息。从源码结构看这是为了让VideoApiAdapter接口保持完整而采用的占位实现真正依赖预约变更重建或由 Lyra 侧管理会议。适配器的所有调用都经过带[lyra]前缀的子日志器logger.getSubLogger并在失败时用safeStringify记录错误上下文便于排查 OAuth 或 API 层故障。API 端点速查端点相对LYRA_API_URL方法用途/oauth/authorizeGET跳转至 Lyra 授权页参数含scopemeeting.create/api/oauth/tokenPOST授权码换令牌 / 刷新令牌/api/v1/meetingPOST创建会议title、start、attendees其中LYRA_API_URL定义在 lib/constants.ts当前值为https://app.lyra.so。从 Lyra 到通用Cal.diy 会议应用接入范式Lyra 应用是观察 Cal.diy conferencing 类应用标准架构的绝佳样本其目录结构packages/app-store/lyra可以归纳为通用模板config.json元数据slug、type、variant、OAuth 标记、地点注册api/add.tsapi/callback.tsOAuth 授权入口与令牌回调lib/VideoApiAdapter.ts实现VideoApiAdapter接口翻译会议生命周期操作lib/getLyraAppKeys.tszod.ts应用密钥的读取与校验lib/constants.ts第三方 API 基址常量static/icon.svg商店展示图标。以此对照其他会议类应用如zoomvideo、dailyvideo、jitsivideo等见 packages/app-store遵循同一套骨架OAuth 凭证由_utils/oauth统一管理会议能力由各自的VideoApiAdapter提供事件类型的动态会议地点由appData.location.linkType: dynamic声明。理解了 Lyra就等于理解了 Cal.diy 全部视频会议集成的核心模式。小结Lyra 在 Cal.diy 中的集成可以概括为一条清晰链路安装App Store→ 授权OAuth 授权码→ 选择事件类型会议选项→ 自动生成createMeeting 创建会议。源码层面add.ts负责发起授权、callback.ts负责换令牌并标准化存储、VideoApiAdapter依托OAuthManager自动管理令牌生命周期并调用 Lyra 创建会议。若要在自托管环境中启用 Lyra只需配置client_id/client_secret两个应用键即可让团队在预约流程中无缝获得零运维、AI 辅助、自动跟进的专业会议体验。【免费下载链接】cal.diyScheduling infrastructure for absolutely everyone.项目地址: https://gitcode.com/GitHub_Trending/ca/cal.diy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
