# Connector 工作台首版实现

2026-11-19

## 在线入口

- 产品站点：https://progressive.xiaopingfeng.com
- 工作台：https://progressive.xiaopingfeng.com/app
- 工作台授权主机：https://progressive-agent-connectors.fxp007.workers.dev/app

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

## Connectors

- 会议来源：飞书妙记，沿用已授权的 BigModel Vault；每五分钟发现本人创建且可读的新妙记。
- 项目管理：GitHub Projects 和 Linear，OAuth 授权后自动分页同步项目、名称、来源链接与团队。
- 执行 Agent：BigModel Managed Agent。项目绑定可写 Repo、Agent、允许修改的路径、验收命令、别名和自动执行策略。

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 摘要保留三十天，不包含逐字稿或密钥。

## 验收进度

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

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

- GitHub 项目：代码演示看板 · GitHub，测试完成状态筛选。
- Linear 项目：需求演示看板 · Linear，测试标题关键词搜索。

2026-11-19 15:41（Asia/Shanghai）上传约 114 秒合成会议“Progressive Agent · Connector 双平台开发验收 · 2026-11-19”，飞书转写完成，两个项目名与功能要求正确。15:50 BigModel 定时任务自动导出这场会议，15:51 Cloudflare Cron 持久接收并只生成两个匹配任务，自动创建 GitHub Issue #1 和 Linear CAR-23，并派发两条 GitHub Actions 开发工作流。两个 BigModel 云端编码会话已启动。15:55 前两条工作流均完成独立测试和草稿 PR 创建，GitHub Issue #1 与 Linear CAR-23 均回填正确。筛选功能 7 项测试通过，搜索功能 9 项测试通过，浏览器核对计数、切换、大小写、前后空格、清空和空结果均正确。

## 当前范围

- 飞书来源为单用户内测；搜索最近七天且不早于桥接开通时间的本人可读妙记，沿用有界搜索适配器，搜索收录可能延迟。
- 每个 Repo 暂绑定一个本地 Project，避免多个项目覆盖同名工作流凭据。跨来源项目合并待后续实现。
- 支持 GitHub 托管、普通文本文件与 BigModel 编码，其他 Agent 后续通过 Adapter 扩展。
- 项目同步采用定时对账；Webhook 和 PR 合并后的业务状态同步尚未接入。
- 安装保留已有非本产品管理的同名文件，遵守 Repo 的保护分支和组织策略。
- 旧 Focus Board 云端接力保持独立；同一 Repo 有旧执行器运行时拒绝安装竞争执行器。

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

首次后续轮次暴露确认标记重复创建返回 409，以及来源读取挂载目录错误的问题。任务、会话、PR 未重复；已修复为正确读取挂载子目录，并在标记冲突时验证已有确认内容。16:00 BigModel 来源正常返回 no_new_meeting；16:01 Cloudflare 成功接收并清理遗留的重复产物，复用既有任务，未新派发开发。16:05 BigModel 来源再次正常返回 no_new_meeting，16:06 Cloudflare 正常空转（ingested=0、processed=0）。两轮最终去重验收通过：始终 2 个任务、2 个编码会话、2 个草稿 PR，原需求各 1 条回填评论，没有重复开发、归档或发送结果。

交付链接：GitHub 筛选 PR https://github.com/fxp/progressive-connectors-github-e2e/pull/2 ；Linear 搜索 PR https://github.com/fxp/progressive-connectors-linear-e2e/pull/1 。验收记录已补充到飞书原草稿 https://tj92wlw3nt.feishu.cn/docx/ZNxldHaE5orss0xw2hgcQ4cvnzf ，其 Project 为 Progressive Agent，Agent Tasks 索引保持原归档关联。

最终状态：GitHub 任务与 Linear 任务均为 review_ready，两条 GitHub Actions 的 prepare、verify、publish 均 success，开发运行各只有 1 次 attempt。页面自动刷新已验证；飞书浏览器身份已恢复为原 Z.ai 账号。Mac 上只启动了用于验收界面的临时预览服务，不参与云端任务执行，收尾时关闭。
