Connector 工作台首版实现

2026-11-19

在线入口

站点与后端部署在用户自己的 Cloudflare 账号,D1 保存结构化状态。自定义域名提供 Landing page,工作台访问转到已注册 OAuth 回调的主机,保持登录 Cookie 与回调同源。无需 OpenAI 登录。原 Sites 部署保留兼容,不参与独立入口的访问认证。

Connectors

GitHub 与 Linear OAuth 应用均已创建并真实授权。GitHub 授权同时建立工作台登录会话,Linear 关联到相同用户。初始内测通过账号允许名单限制访问。浏览器会话使用有过期时间的 HMAC 签名、HttpOnly、Secure、SameSite Cookie;独立模式拒绝伪造 Sites 身份头。OAuth state 一次性、过期、绑定用户和 provider,启用 PKCE;凭据 AES-GCM 加密保存,Secret 与令牌不回显。到期令牌通过刷新令牌续期。

回调主机为 https://progressive-agent-connectors.fxp007.workers.dev ,路径分别为 /api/oauth/github/callback 与 /api/oauth/linear/callback。应用凭据可通过工作台配置入口或云端 Secret 管理。

云端执行流程

1. BigModel 定时来源任务按 `*/5 * * * *`(Asia/Shanghai)导出新妙记的受保护产物。

2. Cloudflare 原生 Cron 按 `1-59/5 * * * *` 检查导出产物,读取完整逐字稿,提取有原话依据的开发待办。两个时刻错开一分钟;新建 Cron 的传播可能延迟,实际首次触发需核对日志。

3. 按唯一项目名或别名匹配项目;歧义、缺少验收条件时等待确认。相同功能的实现、测试、PR 和回填归为一条任务。

4. 为明确且开启自动执行的任务创建或找到原始 GitHub/Linear Issue,保存来源,再派发目标 Repo 的工作流。

5. BigModel 在隔离云端沙箱接收 Git bundle 和结构化任务,修改允许的文件并输出补丁。编码沙箱没有发布凭据。

6. GitHub-hosted runner 独立应用补丁并运行登记的验收命令,测试进程不继承模型或平台凭据。

7. 后端核对任务、运行、工作流版本、补丁校验标记与 verify job 成功后,创建任务分支和草稿 PR。PR、提交、测试命令与运行链接回填原需求评论。

8. 任务停在 review_ready,等待人工审阅;不自动合并或发布。

Cloudflare Cron 在 D1 保存每轮处理摘要,工作台显示最近检查时间和结果。Repo 的定时 runner 对独立入口仅推进任务队列,会议导入由 Cloudflare 统一协调;原 Sites 模式保留 GitHub 转接兼容。上述执行不依赖 Mac 进程。

防重与恢复

连接与外部项目 ID 稳定,改名不覆盖本地 Repo/Agent 绑定。会议处理凭据与任务保存在 D1;同一妙记重放复用原任务。只有持久接收成功后才确认来源并删除导出产物,失败保留以便重试。

调度、会议、任务与安装操作使用租约。派发先记意图,再按运行名称对账;会话先记创建意图,必要时按远端 metadata 恢复。PR 分支、Issue 标记和回填评论标记稳定。回填失败从已有 PR 继续,不重复开发。Cron 摘要保留三十天,不包含逐字稿或密钥。

验收进度

自动化测试 47 项通过,覆盖双平台编排和两次重放、登录与回调、Cookie 防伪/过期、租户隔离、加密、刷新、分页、项目歧义、任务租约、越界补丁、失败测试不发布、回填重试,以及 Cloudflare 协调器只在接收成功后确认来源。Git 子进程测试真实生成和应用补丁、执行成功与失败的验收命令。模拟测试和真实外部验收分别记录。

真实授权及项目同步已通过。已创建两个私有验收 Repo 和对应项目,绑定 BigModel、npm test、允许路径与项目别名,云端执行器已安装:

2026-11-19 15:41(Asia/Shanghai)上传约 114 秒合成会议“Progressive Agent · Connector 双平台开发验收 · 2026-11-19”,飞书转写完成,两个项目名与功能要求正确。正在等待云端自动发现、双任务开发、PR 和原需求回填;还不能把这条真实链路或后续两轮去重记为通过。

当前范围

源码与部署说明:apps/landing/README.md;BigModel 来源桥接:deploy/connectors/。