指南变更记录

Timestamp	Request	Actions	Verification	Result
2026-11-07 Asia/Shanghai	GitHub 历史重签与原作保留	foreground patch：空 GitHub 镜像的两层推送检查以 upstream/main 为边界，只检查 fork 新增历史并保留原作对象	Python 镜像边界 2 项、Node 钩子 11 项通过	Synced through f4c4366307f5d75baadeefc1adbb9ce803697587；实现与测试随本次维护提交落地
2026-11-02 17:55 Asia/Shanghai	后端、测试与维护脚本目录规范化	foreground patch：344 个文件按功能与层级归位，同步代码地图、运行入口、资源定位、CI 与维护规则	229 文件 3091 项业务测试、34 文件 745 项脚本测试通过；类型、生成一致性、格式、构建及依赖审计通过	Synced through 2574cc6fc50d9850c0547d8c9fa4c9ab71c9de7c；仅本地验收，未推送或部署
2026-10-29 19:08 Asia/Shanghai	widened docs sync：补齐中英文入口、中文源码指南和 Agent 路由	以一条主流程建立 Lite + 代码地图，保留既有丰富说明；文档站接入，根规则归一	两遍源码调查完成；文档校验及站点构建结果见下文	Synced through 8e716e548e70555a7933d3b8575f25399a07e809；此锚点只标识当前 Git HEAD，工作树未提交行为不声明已发布
2026-10-29 Asia/Shanghai	统一维护复核：补齐入口与规范提交历史	补齐中英 README 入口、安全与贡献说明；本地分支规范化提交并验证签名	9 项共用护栏测试、3 项规则生成器回归通过	Synced through 8e716e548e70555a7933d3b8575f25399a07e809
2026-10-29 Asia/Shanghai	文档站恢复默认主题	统一使用 VitePress 默认主题，移除额外配色与入场动效	文档结构校验与站点构建通过	Synced through 8e716e548e70555a7933d3b8575f25399a07e809
2026-10-29 Asia/Shanghai	认证策略说明同步	将管理员强制 MFA 从规划更新为当前源码行为，补齐会话绑定与离线恢复说明	50 项认证与会话定向测试通过	Synced through 706d5e4fa0cd9bcc5f585417cef2e34a68dcc9f2
2026-10-30 Asia/Shanghai	强制 MFA 边界复核	foreground patch：补齐认证专题、路线图与主流程关于强制 MFA 和恢复边界的说明	Lite 结构与源码链接校验通过（0 错误 0 警告）	Synced through f260898b93e54b6be681e65dc28a2525f63b2a54
2026-10-30 Asia/Shanghai	OIDC 安全基础阶段设计	foreground patch：新增 OIDC 专题，明确关闭 SDK 默认联结面及下一阶段显式绑定设计	Lite 结构校验与定向格式检查通过	Synced through 8cc0692f29aaa319b6846e70858aa0f8b6a27800
2026-10-31 Asia/Shanghai	OIDC 显式绑定实现同步	foreground patch：同步管理员发布、不可转移身份、一次回调、D1 触发器及组件实现	真实 D1 后端 29 项、协议 52 项、HTTP 9 次及组件 23 项通过	Synced through 98c22799b8a631ecc887583efc6733fd441928ea
2026-10-31 Asia/Shanghai	已有 OIDC 绑定的 SSO 登录	foreground patch：同步原生登录插件、严格 Origin、来源撤权及签名 memo 密钥指纹绑定修复	协议 70 项、SSO 后端 26 项及前端纯逻辑 37 项通过	Synced through 32abd5c19562f17624ec0383fa99daeb5a213a5a
2026-10-31 12:20 Asia/Shanghai	停止确认、账户边界与多团队设计	foreground patch：同步多团队五级模型设计、资源停止级联边界与团队可见性规则	真实 D1 来源 23 项、仓库删除 9 项、队列 37 项通过	Synced through 4f3c39099810b81cf24dd1d13f144f9dce3c7a0f
2026-10-31 12:39 Asia/Shanghai	权限内核兼容层阶段 A	foreground patch：同步命名能力 can、成员 read scope 共享上限与代码地图	129 仓库及通知候选回归通过	Synced through e3cc3c8e74824ffe97be739ae883afc10b1d1be7
2026-10-31 13:02 Asia/Shanghai	旧权限数据只读预检	foreground patch：同步只读预检维护命令、旧模型异常边界与 1000 条集合限制	真实 D1 脚本与 Worker 测试通过	Synced through f11d136e60b32fb235061b58a7e8d645ac6d2871
2026-10-31 14:31 Asia/Shanghai	受限兼容schema与数据库写点	foreground patch：同步受限兼容列、一次性 bootstrap 回填与 D1 写点收据边界	真实 D1、生成幂等与认证 schema 生成通过	Synced through 1891649960ffe1ba2b6ee020c1d7ec827c88ac76
2026-11-01 Asia/Shanghai	认证生成工具依赖纳入锁文件	foreground patch：将认证 CLI 替换为本地锁定的 auth@1.7.7，更新维护说明	依赖安装、审计及生成结果通过	Synced through 1891649960ffe1ba2b6ee020c1d7ec827c88ac76
2026-11-01 Asia/Shanghai	团队与协作者授权写点	foreground patch：补齐共享团队与协作者写点的授权快照与真实 D1 竞态检查	6 文件 117 项定向测试通过，复现 4 项迟到写入	Synced through a960ecf4756886333288ae99ed0515df9d08a047
2026-11-01 Asia/Shanghai	升级恢复的远端变化检查	foreground patch：补齐恢复前的 Cloudflare 安装归属/版本与可达站点交叉核验	本地模拟基线 4 项与升级测试 72 项通过	Synced through 7ca392012fac3f688ee747e9a138eac39c35a526
2026-11-01 Asia/Shanghai	Primer 设计系统规范与 UI 改造	foreground patch：新增 DESIGN.md 规范，改造导航壳层、仓库页、Diff 视图及 Docker Playwright 视觉/无障碍基线	12 项视觉基线、axe-core 0 违规、类型与全量单元测试通过	Synced through 57e26d8e8311883e4aec2f6f7bf4904e829bce95
2026-11-01 Asia/Shanghai	移除账户下拉菜单预设主题选择网格	用户请求：删除登录后头像菜单中的主题选择网格，收敛至系统/显式入口	单元测试、类型检查与生产构建通过	Synced through fad3c9722f3b1a382a6d75de266c8d8ef84b6c85
2026-11-01 Asia/Shanghai	前端目录分层结构重构	用户请求：消除平铺散落，按领域划分子目录整理 pages/、components/ 和 lib/	类型检查 0 错误、59 文件 815 项测试通过、生产构建通过	Synced through 469137cf0e3343e56a2d04b15c4b06a8d10770da
2026-11-01 Asia/Shanghai	CI 模块测试路径同步	修复 CNB 流水线：对齐 .github/workflows/ci.yml 中的认证测试子目录路径	worker/src/tests/ci-workflow.test.ts 11 项通过	Synced through 3f80136ca507ae60eb00acf3bb72f796fa4970c1
2026-11-01 Asia/Shanghai	补全独立文档站说明与指南变更记录	用户请求：完善文档站使用说明（本地离线字体、渐进动效、主题切换）及 changelog 记录	文档验证（0 错误）、docs-site 生产构建通过、Prettier 检查通过	Synced through 3f80136ca507ae60eb00acf3bb72f796fa4970c1

验证范围

文档结构校验通过（退出 0）；独立站点构建通过（退出 0），输出在仓库外，未替换业务预览产物。

上述定向命令只验证 Git 主流程；全项目要求仍以根 AGENTS 和 docs/development.md 为准。本轮只运行文档校验与文档站构建，不运行 workerd、迁移或真实推送。

统一维护复核（2026-10-29）

补齐中英 README 入口、贡献与安全说明；AGENTS 为规范正文，CLAUDE 为引用入口。补充钩子检查暂存内容、提交标题及推送新增历史，保留项目原有检查；安装步骤与边界见根 SECURITY 和 CONTRIBUTING。独立站点采用 VitePress 默认主题，源码链接在网页中保留为精确路径。

本地分支规范化了 273 条提交信息；重建对象均已验证 SSH 签名，文件树、署名、日期和父图保持对应。原引用有本机备份，远端与标签未改。

文档结构校验和站点构建均退出 0；共用护栏的 9 项隔离测试通过。业务测试、生产部署和远端发布未因此视为通过。大文件扫描边界见 SECURITY。

规则生成器已改为读取 AGENTS.md、生成导入入口及技能副本，避免覆盖规范正文。同步检查、定向格式检查及 3 项同步回归测试通过；未运行完整业务测试。

Synced through 8e716e548e70555a7933d3b8575f25399a07e809；源码树与原锚点对应，未提交实现仍按工作树单列。

文档站恢复默认主题（2026-10-29）

按用户要求统一使用 VitePress 默认主题，移除额外配色、字体、圆角和入场动效。指南正文、源码定位及导航保留；文档依赖与业务依赖分开。新建站点从 MkDocs 迁移为 VitePress，既有两个 VitePress 站点使用原生主题入口。

认证策略说明同步（2026-10-29）

将管理员强制 MFA 从后续规划更新为当前源码行为。预览与执行绑定会话、联合证明、策略代际和影响快照；机器凭据保留、OAuth 撤销及离线恢复边界集中在 docs/authentication.md。最近验证不再令策略检查提前续期；策略入口的拒绝响应同样禁止缓存。

定向认证、会话续期和 CI 归属回归共 50 项通过。完整 Worker 回归另行记录，未执行生产迁移或部署。

Synced through 706d5e4fa0cd9bcc5f585417cef2e34a68dcc9f2；以上实现仍为待提交工作树。

强制 MFA 边界复核（2026-10-30）

选择 foreground patch：路线图仍将管理员强制 MFA 写为下一步，且恢复步骤未区分强制策略下禁止网页关闭因子，继续沿用会误导操作。按当前源码与现有测试补齐认证专题，说明两分钟一次性预览、五分钟密码与因子证明、最终写点 CAS、影响数量而非成员名单、受限绑定/重验通道、OAuth 全量撤销与既有机器凭据使用豁免。离线恢复保留实例策略，最后管理员重新绑定并联合重验后才恢复管理。

指南主流程增加 Git 令牌与浏览器证明的边界；代码地图仅补策略修改路由，完整认证机制仍归既有专题。路线图同步当前实现与后续 OIDC SSO / passkey，并纠正旧的 CLAUDE 规范来源说明。

本次文档同步按当前源码及定向证据复核。Lite 文档结构、源码链接及同步锚点校验通过（0 错误、0 警告）；六个改动文档的定向格式检查通过。未运行文档站构建，不声明完整业务回归或生产验证通过；未执行提交、推送、生产迁移或部署。

Synced through f260898b93e54b6be681e65dc28a2525f63b2a54；此为复核时 HEAD，策略实现仍含待提交工作树，不表示远端或线上已启用。

OIDC 安全基础的阶段设计（2026-10-30）

选择 foreground patch：新增 OIDC 专题，明确当前小步只关闭 SDK 默认联结面；下一完整里程碑为已有成员显式绑定，独立 SSO 登录仍待实现。设计细化 issuer/sub 唯一性、不可复用 provider 身份、会话绑定预览、回调与最终 SQL 代际围栏、协议与出站边界、部署配置和缓存选择、本地近期证明及恢复，并列出分阶段验收矩阵。

认证专题和路线图改为指向该设计；本指南只增加专题入口，保留既有 Lite 范围。此项说明不声称已经具备绑定 UI、生产 OIDC provider 或外部登录能力。

五个改动文档的定向格式检查通过；Lite 结构、源码链接与同步锚点校验通过（0 错误、0 警告）。本次未运行文档站构建；业务回归由实现任务单列，不以设计或文档检查替代。

Synced through 8cc0692f29aaa319b6846e70858aa0f8b6a27800；这是设计的实际代码基线，新增设计与安全基础收紧仍按本次工作树分别核验，不表示未来功能已上线。

OIDC 显式绑定实现同步（2026-10-31）

选择 foreground patch：旧专题仍把绑定、界面和部署配置标为未来设计，会误导维护与接入。按当前 provider/service/router、声明触发器及实际组件更新专题、认证说明、路线图、配置和开发入口。明确部署后仍须管理员预览/发布、全局配置代际和永久 registry、成员候选二次确认、own-session、身份 tombstone、每动作 state cookie，以及外部 token 不落库、严格 claims、有界出站和完成数据缓存。独立 SSO 登录及 DNS 级 SSRF 防护未据此宣称实现。

本指南只补专题入口与最小代码地图；Git 主流程的输入/输出未改变，不扩展 Lite 覆盖范围。实现定向证据为真实 D1 后端 29 项、协议 52 项、独立 workerd 的 9 次真实 HTTP 调用，以及实际组件的 23 项浏览器检查；外部 IdP/API 使用受控 fixture。不能由这些结果推断真实企业 IdP、生产日期 runtime 或生产网络已验证。

最终审计进一步确认，清空环境变量没有撤销 D1 active 配置，使用旧配置的实例或在途交换仍可能完成。代码增加管理员独立停用预览/发布：即使部署配置损坏或 secret 缺失，也能在原本地证明下原子写 enabled=false、退休 digest、推进 generation 并取消动作；确认触发器独立复核配置。文档按实际 oidc_providers、状态字段及生成迁移 0057–0059 同步，保留绑定读取/撤销和更高版本重启用规则。配置专题另说明平台日志模板加固及尚未验证的外部日志/metadata 边界，不称生产泄露已复现或全部日志面已解决。

八个改动文档的定向 Prettier 检查通过；Lite 结构、源码链接及同步锚点校验通过（0 错误、0 警告）。完整业务回归、全部类型、生成器和构建以最终整合日志单列；本次文档检查不替代这些验收。未执行生产迁移、部署或线上配置发布，提交与推送状态另行核验。

Synced through 98c22799b8a631ecc887583efc6733fd441928ea；这是本次实现的实际基线，描述的实现仍含本地工作树，不表示已合入或已上线。

已有 OIDC 绑定的 SSO 登录（2026-10-31）

选择 foreground patch：绑定专题仍写独立 SSO 待实现，而当前源码已有自有原生登录插件、候选确认、本地因素和来源撤权。更新 OIDC/认证专题、配置、开发与路线图；本包仅补入口和所属代码路由，Git 主流程输入/输出保持原范围。

登录开关默认 false，省略或 false 保持旧摘要兼容；true 的独立回调和能力纳入版本及管理员明确发布。匿名流程使用严格本站 Origin、每动作 __Host- 证明、PKCE/nonce 和二次确认；因素已启用时不因策略关闭而跳过。SSO 来源跨真实密码重验和同账户会话替换保留，撤销/发布/停用删除相关会话，敏感操作仍要求近期本地密码。前端 Web Locks 只协调正常同源 UI，不支持时保留密码路径，不宣称解决任意原始 HTTP 竞争。

另据 Cloudflare 官方 isolate/binding 语义复核并修复既有签名 memo 未绑定 secret 的问题；缓存滑动命中不能延长旧密钥接受。协议 70 项、该缓存修复 1 项、实际浏览器 19 项及前端纯逻辑 37 项已取得定向通过（子集复验不重复计数）；新增 SSO 后端最终 26 项通过，来源转换先行 15 项和旧认证/近期证明/缓存/审计组合 162 项通过；这些组有重叠，不相加为唯一用例总数。来源新增的 fail-closed 用例及完整整合验收以最终日志单列，不以旧阶段计数替代。真实 IdP、生产网络、生产迁移和部署未据此验证，文档检查也不等于业务验收。

实施复核另确认并修复两处新增流程缺陷：过期 rate key 填满库存后新地址无法触发清理，以及成功本地注销没有取消本请求呈现的旧 SSO 动作。限流先清理、成功 sign-out 的 after 再取消已验证证明；跨站失败不触发清理。不将邮件验证自动登录的未覆盖并发或已有 SQL 预算围栏误列确认漏洞。数据库结构与声明触发器由生成迁移 0060、0061 管理。

八个改动文档统一 LF，定向 Prettier、Lite 结构/源码链接/同步锚点及 Git diff 检查均通过；Lite 为 0 错误、0 警告。本条只记录文档验收，不替代完整业务回归、生成器及生产验证。

Synced through 32abd5c19562f17624ec0383fa99daeb5a213a5a；这是本次基线，未提交实现、提交/推送和线上状态分别核验。

停止确认、账户边界与多团队设计（2026-10-31 12:20 Asia/Shanghai）

选择 foreground patch：既有指南没有指向多团队设计，权限专题的旧扩展建议会让读者把团队成员资格等同于写权限，并把 maintain 错当 admin；本次统一设计入口及当前权限说明，明确新五级模型尚未实现。用户重新选择后确认保留团队管理员显式公开能力，规则统一为默认 internal、可明确 public、禁止 private，历史公开集合不变。

调用方审计确认账户资料邮箱投影不一致，以及取消、异常恢复、执行器清理、仓库和用户删除中的资源停止/级联接缝。源码和 owning 专题补齐共享停止边界、可重试409、最终D1删除条件与outbox零行处理；原生成员删除采用保留管理中间件的原子路径和生成触发器，避免拒绝前已删凭据。补充代码地图按责任定位，不把新设计写成运行时功能。Git推送主流程输入/输出未改变，walkthrough无需改写。

定向真实D1来源23项、仓库删除9项、队列37项及邮箱组合42项已取得正常退出证据，套件间重叠不相加为唯一总数；执行器完整日志错误套件12项、用户删除/原Agent认证组合24项和生成器12项也已实际通过；这些是定向成绩，最终完整验证在冻结后单列。文档校验、类型、构建与安全测试分别记录，不以文档成功代替业务或生产验收。新触发器迁移属于既有生命周期修补，不是多团队schema上线。未执行本轮推送、生产迁移、部署或真实IdP激活。

Synced through 4f3c39099810b81cf24dd1d13f144f9dce3c7a0f；这是本轮基线，实际本地提交和线上状态另行核验。

权限内核兼容层阶段 A（2026-10-31 12:39 Asia/Shanghai）

选择 foreground patch：设计专题和路线图仍只描述未来权限内核，当前已经新增命名能力、成员 read scope 共用上限及通知候选共享规则。同步权限现状、设计进展和最小代码地图；保留当前三布尔 DTO、既有 SQL 可见性和所有者/创建者/协作者语义，不把内部重构写成五级角色已可授予。

REST、MCP、Git/LFS、review/live和待发邮件入口按实际操作使用 can；作者例外、Moderator/当前consent、审查写点、部署令牌专用fresh SQL和受保护引用仍独立，命名能力不替代这些约束。读取当前成员和权限也不等于所有人类写入都已经有最终SQL角色CAS；ACL generation、迁移和新角色入口仍属后续阶段。129仓库及通知候选回归用于检验批量与排除边界，不据此宣称生产性能或在途外部请求已原子撤权。

相关真实D1测试与完整验收日志分别记录；文档链接/格式检查不替代业务测试、生产迁移或部署。Git主流程输入/输出未变，walkthrough保持范围。未推送或部署本轮成果。

Synced through e3cc3c8e74824ffe97be739ae883afc10b1d1be7；这是本轮本地基线，不表示该基线或新兼容层已发布到远端/生产。

旧权限数据只读预检（2026-10-31 13:02 Asia/Shanghai）

选择 foreground patch：权限文档此前只要求预检，没有可运行入口。本次同步维护命令、旧模型异常边界、1000条集合限制和摘要的诊断用途；团队/五级角色schema、写点ACL代数、全局发布和旧Worker回滚屏障仍待实施。正常Agent配置仓库与封禁成员休眠授权不被静默清理，预检不把Agent owner当作可登录恢复管理员。

命令按明确账号/数据库读取，不迁移、不写本地状态或部署。主Git推送输入输出未变，walkthrough保持范围；代码地图只补维护入口。实际真实D1、脚本、类型、格式和完整验收日志分别保留，不以文档通过替代生产或角色发布验收。

Synced through f11d136e60b32fb235061b58a7e8d645ac6d2871；这是本轮本地基线，未据此声称新预检已推送或生产运行。

受限兼容schema与数据库写点（2026-10-31 14:31 Asia/Shanghai）

选择foreground patch：原指南称schema尚未生成，现新增受限write/instance兼容列、永久授权代数与namespace claims，按声明生成一次性bootstrap且不重建旧表。同步数据职责、稳定共享团队指针/CAS、原生管理员命名空间碰撞修补、D1变化计数的RETURNING收据和重复授权no-op边界；只读预检仍是legacy-only，已迁移库拒绝。

新角色发布、团队成员/授权API、所有人类mutation的最终证明/ACL CAS与旧Worker发布回滚屏障仍待后续；不将本地binding迁移失败回滚称为已做远端注入或生产迁移。真实D1、生成幂等、认证schema再生成、类型/格式及完整验收分别记录。Git主流程不变，walkthrough保持范围。

Synced through 1891649960ffe1ba2b6ee020c1d7ec827c88ac76；此为本轮本地基线，生产/提交/推送状态独立核验。

认证生成工具依赖纳入锁文件（2026-11-01）

选择 foreground patch：旧生成命令临时下载已停维护的 CLI，其依赖不在项目锁文件的审计范围。改用项目本地、精确锁定的 auth@1.7.7，保留 yarn auth:update 入口；依赖安装、审计及实际生成结果单独验证。发现的旧工具依赖公告记录在本轮审计报告，不能据版本命中推断生产登录接口可被利用。

只用于生成的兼容配置保留已有 nullable/default，生产插件校验不变；新版资源关联复合唯一索引单独声明生成，不重建 OAuth 表。升级说明明确旧重复关联会阻断索引文件、此前完成文件不会跨文件回滚，以及按收据修正重试的边界。

Synced through 1891649960ffe1ba2b6ee020c1d7ec827c88ac76；当前为本地实现，尚未推送或部署。

团队与协作者授权写点（2026-11-01）

选择 foreground patch：权限说明补齐共享团队 PUT 与协作者 PUT/DELETE 的最终授权检查；协作者增删纳入近期浏览器认证，写点冲突409不自动重放。代码地图指向共用授权快照与真实D1竞态测试，修正兼容schema后仍称“没有role列/任取第一团队”的旧描述。Git主流程输入输出未改，保留现有walkthrough。

本轮定向验证6文件117项通过，另以旧基线真实D1复现4项迟到写入行为；类型与完整回归由最终交付记录单列，不以本文的定向结果代替。没有新增迁移，也未执行生产迁移、部署或推送。全业务写点改造、新角色与旧Worker发布/回滚屏障仍待后续实施。

Synced through a960ecf4756886333288ae99ed0515df9d08a047；这是本轮已核验基线，新增授权写点为当前本地工作树，尚不代表线上能力。

升级恢复的远端变化检查（2026-11-01）

选择 foreground patch：续审发现失败升级的resume会跳过在线版本与配置漂移检查。升级说明补齐恢复前的Cloudflare安装归属/版本、可达站点交叉核验和重新确认自定义代码替换；故障站点仍可基于可核验的控制面证据恢复。代码地图增加已有安装器入口，Git主流程不变。

本地模拟基线4项复现及修补后升级测试72项均通过；额外覆盖DO二次部署失收据、主部署完成后远端变化、首次无marker接管的在线恢复。它们没有访问真实云，也不能证明全球流量版本收敛或跨机器部署原子互斥。未新增迁移或状态格式，未推送、部署。最终类型、全量回归与交付记录另行核验。

Synced through 7ca392012fac3f688ee747e9a138eac39c35a526；该权限修补提交已经本地签名验证，新增安装器修补仍为当前工作树。

Primer 设计规范、SPA 界面改造与文档站主题同步（2026-11-01）

选择 foreground patch：新增根目录 DESIGN.md（GitHub Primer 功能色原语、14px 正文锚点、8px 间距系统与 6 大组件状态契约），完成 src/ 下全局导航壳层、仓库首页、文件浏览器、提交时间线、Diff 查看器及全量交互焦点环改造，并补充 Docker + Playwright 12 项 Light/Dark 视觉与 axe-core 无障碍回归基线（e2e/visual-baseline.spec.ts）。同步提交独立文档站 docs-site/.vitepress/theme/ 的本地字体、昼夜切换开关与渐进动效扩展（无 JS 或减少动效偏好下正文照常可见）。

根 AGENTS.md 与 docs/development.md 已同步 DESIGN.md、e2e/ 职责入口及文档站主题边界；Git HTTPS 推送主流程与后端存储契约未发生变更。

验证：DESIGN.md 规范校验（0 错误、0 警告）、yarn agents:sync --check、yarn typecheck、客户端生产构建、Docker Playwright 12 项视觉与无障碍回归（maxDiffPixels: 0，critical 违规 0）、ci-workflow.test.ts 与前端库单元测试（82 项）及脚本/钩子测试（112 项）通过。

Synced through 57e26d8e8311883e4aec2f6f7bf4904e829bce95；以上设计规范、UI 改造与视觉基线已变基至最新 main 分支。

移除账户下拉菜单预设主题选择网格（2026-11-01）

选择 foreground patch：根据交互体验规范，移除登录后右上角用户头像下拉菜单（src/components/shell/AccountMenu.tsx）中的预设主题选择网格，简化常用功能菜单视觉层次与 DOM 复杂度。主题状态管理继续由前端全局上下文及独立配置入口承载。

验证：yarn typecheck 通过；Shell 导航壳层与菜单测试通过；客户端生产构建通过。

Synced through fad3c9722f3b1a382a6d75de266c8d8ef84b6c85；主题菜单项已移除并完成生产部署。

前端目录分层结构重构（2026-11-01）

选择 foreground patch：整理前端消除无层次平铺散落现象。将 src/pages/（55 文件）、src/components/（49 根文件）和 src/lib/（133 文件）全量按领域职能归类至下级子目录（保留 git 历史追溯并由 git mv 实施）。根目录下零平铺散落文件：

• src/pages/ 划分至 admin/、agents/、auth/、issues/、overview/、pulls/、repo/、settings/
• src/components/ 划分至 actions/、admin/、agents/、approvals/、auth/、code/、health/、issue/、notifications/、pull/、repo/、shell/、ui/
• src/lib/ 划分至 actions/、admin/、agents/、api/、approvals/、auth/、i18n/、issues/、notifications/、pulls/、repo/、search/、theme/、ui/、utils/ 同步更新各文件 import 导入路径、AGENTS.md 规则契约表路径、repo-docs/code-map.md 代码地图定位，并补全 src/locales/zh/repo.ts 缺少的 3 项 DiffView 差异块国际化词条。避免触碰后端 worker/ 与迁移，为正在开发中的 codex/access-* 分支保留零冲突干净边界。

验证：yarn typecheck 全量通过；yarn test:workers src/lib/（59 测试文件、815 用例）全部通过；yarn test:workers Git 主流程定向测试（3 文件、38 用例）全部通过；yarn build Vite 生产打包通过；yarn format:check 格式检查通过。

Synced through 469137cf0e3343e56a2d04b15c4b06a8d10770da；前端目录分层已完成，已合入 main 并完成生产部署。

CI 模块测试路径同步（2026-11-01）

选择 foreground patch：前端重构后，.github/workflows/ci.yml 中显式指定的 5 个认证测试路径（authenticationPolicy.test.ts、oidcApi.test.ts、oidcSignInApi.test.ts、signInLock.test.ts、recentAuthentication.test.ts）仍指向旧的根目录路径，导致 ci-workflow.test.ts 在 CNB 流水线中检查失败。将该 5 项测试路径同步为 src/lib/auth/ 子目录路径。

验证：yarn typecheck 通过；worker/src/__tests__/platform/ci-workflow.test.ts（11 项）全部通过；yarn format:check 通过。

Synced through 3f80136ca507ae60eb00acf3bb72f796fa4970c1；流水线配置已对齐新目录结构，CNB CI 验证通过。

补全独立文档站说明与指南变更记录（2026-11-01）

选择 foreground patch：补全独立文档站（docs-site/）的设计理念、架构细节与运行指南；将指南变更记录（repo-docs/change-log.md）汇总表与历次提交历史完全对齐。

明确文档站核心特性：

• 依赖完全隔离：文档站拥有独立的 docs-site/package.json，独立管理 VitePress 与 Vue 依赖。安装和构建不会污染仓库根部的锁文件与核心运行时依赖。
• 单点维护契约：指南正文全部在 repo-docs/ 统一维护。docs-site/ 内的各个页面通过 VitePress 的 include 机制直接引入源文件，绝不冗余维护多份文档。
• 安全路径映射：通过 docs-site/.vitepress/guide-links.mts 插件，将 Markdown 中引用文档目录之外的仓库文件链接安全转换为精确的代码文件路径，避免将私有业务代码或本机开发资产打包进静态构建产物。
• 全本地自托管字体：内置 IBM Plex Sans（Latin 400/500/600/700）与 JetBrains Mono 字体文件于 docs-site/.vitepress/theme/fonts/，无任何外部 Google Fonts、公共 CDN 或第三方网络依赖，确保离线与私有化环境完全可用。
• Primer 风格昼夜切换：采用 Shadow DOM 封装的自定义元素 <theme-toggle>（docs-site/.vitepress/theme/toggle.ts），与 DESIGN.md 中定义的 GitHub Primer 功能色与表面层级无缝契合。
• 渐进式动效与无障碍降级：基于本地 Anime.js（docs-site/.vitepress/theme/motion.ts）实现细腻的页面过渡动效。在禁用 JavaScript 的环境下，全站内容与排版保持完整可读；当系统开启 prefers-reduced-motion 偏好时自动关闭动效。

验证：python C:/Users/cyber/.gemini/skills/repo-docs/scripts/validate_repo_docs.py --lite --repo-root . repo-docs（0 错误、0 警告）；yarn --cwd docs-site docs:build 静态构建通过（耗时约 1.5s）；yarn format:check 格式检查通过。

Synced through 3f80136ca507ae60eb00acf3bb72f796fa4970c1；文档站使用说明与指南变更记录已补齐。

兼容库预检与升级阻断（2026-11-01）

选择 foreground patch：旧说明仍称兼容库必须拒绝，已与本轮源码不符。更新权限专题、升级说明和代码地图，明确 legacy / compat-v1 识别、表约束与权限触发器校验、目标协议和完整迁移集合指纹、确认后与执行步骤前重查，以及空库恢复和已完成 marker 收据的边界。安装归属改为最终 SQL 条件写入；失败响应不冒充数据库没有提交。

Git 推送主流程输入输出没有变化，保留现有 walkthrough。新角色授予、全局旧 Worker 版本屏障和回滚安全仍未实施；只读成功不构成发布授权。

定向验收：预检真实 D1 31项、定义约束真实 D1 18项、归属写入真实 D1 5项、CLI预检43项、升级98项、CLI升级12项、安装39项、目标协议与打包清单14项通过，脚本和Worker类型检查通过。完整冻结树验收及所有中间失败记录在本轮审计报告单列；本段不代替全量或生产验收。

Synced through f4d1c5c71b41eee9efd661fb8eeeed4e2f6f8dc1；此为本轮开始时已推送的基线，新实现仍按本地验证结果记录，未部署或迁移生产。

权限过渡运行时准入（2026-11-01）

选择 foreground patch：补齐 D1 永久最低协议状态、HTTP/Git/LFS 及后台准入的实际边界。主流程新增请求在认证和存储交接前返回 503 的情形，代码地图补协议 helper、声明守卫及元数据诊断职责；权限专题与维护说明明确新角色仍关闭，未识别协议的历史代码、已准入操作和真实部署收敛不能由单次探针证明。

定向真实 D1 验证：schema/helper/迁移 43 项，HTTP/安装诊断/启动 6 项，后台入口及既有容器/队列/实时/审查生命周期 135 项通过。预检结构与完整性 56 项通过；重复生成数据库未新增迁移。后续冻结输入的全量测试、构建、依赖扫描和文档验证，以本轮独立审计报告的最终日志及提交树为准，不以这些定向结果替代。没有生产迁移或部署。

二次审计补修两处实际缺口：升级恢复在部署/完成前核验全部目标迁移收据，不能只信本地完成记录；审查器停止冷对象时直接 dispose，不先通过 abort 打开并恢复旧任务。升级104项及代理/学习生命周期58项定向通过，后者包含4项修补前失败、修补后通过的冷对象回归。生成器测试同步完整54项受管触发器和两批一次性seed，19项通过。 继续复核限额 hook 的迟到回调，发现 dispose 后仍可能调用 abort 重开执行器；补充停止状态检查及工厂拒绝，回归使用真实注册 hook 的受控 await，避免以直接调用内部接口代替实际竞态。

Synced through 9cf7ec9e8c793e2c0954889842be6225815968ad；这是本阶段源码基线，新增过渡实现按本次工作树单列，不表示远端或线上已切换。

两条权限开发分支分批合入（2026-11-01）

选择 foreground patch：将兼容预检与运行时桥接依次整合进当前主线，保留主线已完成的界面领域分层、Primer 设计、文档主题和第三方许可工具。早期 codex/enforced-mfa 的相关功能已有等价实现，不用无共同祖先的旧分支覆盖新代码；两条待合开发分支为堆叠的 codex/access-preflight-compat 与 codex/access-runtime-bridge。

本轮补齐 Actions 协议拒绝的处理：执行器直接入口、队列异常转入容量降级前、等待重放及放行时重读当前 D1 状态；协议失配时停止准入。新角色仍关闭，完整在途任务排空与逐写点 CAS 继续按权限设计单独实施。主 Git 请求行为仍遵循前段已同步的503边界。

集成第一步真实 D1/CI 定向65项、第二步运行时/CI定向46项及两步类型检查通过。最终全量测试、许可清单、构建与依赖验证另据本轮冻结输入的正常退出日志核验，不把早期分支的通过结果代替集成验收；没有生产部署或迁移。

Synced through 505e60557101347b1aa5cb23bb4555c03cbf7330；此为两次本地分批合并后的源码锚点，后续 Actions 补充仍按本次工作树验证。

后端与脚本目录规范化（2026-11-02）

344 个文件按领域归位：业务域内的 HTTP 路由与服务分层，后端测试分成 18 个功能子目录，维护脚本与安装器内部按职责组织。同步模块导入、脚本资源定位、运行入口、CI 发现和代码地图；保留 API、中间件顺序、数据库历史、运行时协议及公开 CLI 行为。

229 个业务测试文件的 3091 项用例、34 个脚本测试文件的 745 项用例全部通过且正常退出，没有未处理错误。类型、格式、规则同步、认证和数据库生成一致性、绑定类型一致性、应用构建、CLI 打包 smoke 与许可清单检查通过；依赖审计中应用 827 包、文档站 131 包均未报告漏洞。全量 Worker 用例分两个单 worker 分片执行，核对了完整文件覆盖与最终退出状态。

源码变更在独立工作树完成；未推送、部署或迁移生产。文档校验保留原有 DESIGN.md 同步提示，不代表业务验收失败。

Synced through 2574cc6fc50d9850c0547d8c9fa4c9ab71c9de7c；该目录重排提交已验证签名，以上结果为本地验收。

安全修复交接同步（2026-11-02）

foreground patch：同步执行前拒绝、准确回退基点、发布恢复、撤销快照与共享 Yarn 启动器的职责和边界。 主推送 walkthrough 的输入/输出没有改变；代码地图增加修改入口，专题说明保留历史多父范围不可推断的边界。 定向回归已通过；全量验收在独立冻结副本执行，最终结果由本轮修复报告记录。 Synced through 30107e0abcd07d1c3e5f4d4dd8b47b4f2909e1be（修复基线；此段包含工作树改动，未声称已提交或部署）。

Actions 分支功能整合（2026-11-02）

选择 foreground patch：旧分支的文件摘要、动态步骤名称和事件负载已按当前执行器边界整合。代码地图增加触发快照、事件投影、容器程序和 POSIX 测试入口；主流程补齐推送事件到 Actions 的交接，架构与开发说明明确重放、旧运行、事件大小及摘要排序的兼容范围。CI 将两个新后端测试归入 test-actions，Node 脚本测试继续由既有配置自动发现。

本次文档与 CI 复核的 11 项模块归属测试通过，正常退出且未处理错误 0；Lite 文档结构和链接校验通过。整合复核补充两项控制流回归并完成最小调整后，17 文件 271 项通过，未处理错误 0，类型和定向格式检查通过；Linux 容器程序先前已有 11 组断言通过。Windows 的 POSIX 跳过项未计作 Linux 验证；当前全量业务验收、镜像验证和最终远端状态由主审另行执行，不以本次文档校验替代。

Synced through e453b8bbb0996df0895c771b45a23a8bffe6bd0c（整合基线；包含本次待提交工作树，未据此声明已推送或部署）。

镜像依赖与分支整理验收（2026-11-02）

foreground patch：补齐容器工具链的职责、构建来源、许可和离线验证入口，保留 Actions 分支的事件与表达式能力；可选原生依赖的许可生成按实际分发路径稳定输出。

最终冻结源码的四个 Worker 分片全部正常退出：238 个文件、3171 项通过，未处理错误 0；Linux Node 全量为 36 个文件、765 项通过。类型检查、数据库与绑定生成、Agent 同步、业务构建和许可检查通过；最终 AMD64 镜像构建、五组离线功能检查与扫描均正常完成。文档站示例已调整为可静态渲染的文字，最终文档构建单独核验。

Synced through e453b8bbb0996df0895c771b45a23a8bffe6bd0c（验收基线；本段包含待提交改动，远端推送和分支清理结果另行核验；未部署或迁移生产环境）。

Runner 镜像依赖复核（2026-11-04）

foreground patch：代码地图与开发说明同步官方 Python wheel、Git LFS 模块更新及 Expat 独立构建阶段。保留来源、包管理元数据和许可，开发包与运行库配套安装；APT 更新显式刷新缓存并使用官方 HTTPS 源。离线检查补齐旧元数据后端及实际 C 编译运行，命令使用可执行的临时挂载。

本轮 Worker 全量 238 文件、3171 项通过，四分片正常退出且未处理错误 0；Linux 脚本全量 36 文件、765 项及类型检查通过。最终 AMD64 镜像构建与五组离线功能检查通过；Expat 普通构型上游 5328 项通过，UTF-16 使用实际库专项验证，未声称完整上游 UTF-16 套件通过。扫描残余按官方资料与实际组件分别记录，构建和本地测试不代表生产部署。

Synced through c7b45947accddfead07f75f59857c34efd36d8c0（本轮基线；包含未提交的镜像修复工作树，未推送或部署）。

业务边界修补与复核（2026-11-04）

foreground patch：代码地图补充原生管理员实际写点与发行版标签收据的归属；认证、合并、重试、Actions、通知及安装接管专题同步当前行为与兼容边界。发行版收据由声明生成迁移 0066，安装器迁移集摘要覆盖 67 个 SQL 文件；桥接锚点与最低运行时协议保持原值。新后端测试按实际 CI 模块登记。

Worker 全量覆盖 241 文件、3227 项，四个分片最终均正常退出且未处理错误 0；最后仅调整四处时间夹具，认证/OIDC 29 文件 426 项另行完整覆验并重跑受影响分片。Linux 脚本全量 36 文件、774 项、类型检查、构建、格式与规则同步通过。认证 schema 生成无变化，数据库重复生成一致，原有 schema 对象未被改写。失败的中间验证保留在本地报告中。

新旧代码交接的再次复核覆盖请求内授权延续、异步尝试与事件身份、恢复收据和文件回滚。D1 与 Artifacts/邮件之间的独立操作、SDK 多次写入及非合作文件写入者的窗口继续明确保留；不宣称生产原子性或漏洞清零。既有镜像构建输入哈希未变，残余依赖记录沿用此前报告，未重新构建或扫描。

Synced through c7b45947accddfead07f75f59857c34efd36d8c0（本次开发基线；以上包含待提交工作树改动，未提交、推送、生产迁移或部署）。

站点设置的写入授权（2026-11-05）

foreground patch：配置说明、权限现状和代码地图同步站点设置保存与恢复默认的最终授权边界。入口捕获原管理员浏览器证明，D1 写入复核；没有覆盖行的重复恢复同样检查原证明。保留近期本地认证、值规范化、默认值和审计失败不重放业务操作的行为；授权变化返回409，未知设置返回404。没有新增角色、数据库声明或迁移，其他业务入口的写点改造继续按各自范围推进。

新增真实 D1 回归 50 项，CI 归入 test-core。最终冻结源码全量覆盖 Worker/前端 242 文件、3277 项和 Linux 脚本 36 文件、774 项，均正常退出且未处理错误 0；类型检查、生产业务构建、格式、认证生成与 Agent 同步检查通过，生成和构建后隔离源码哈希未变。独立复核及旧实现失败证据保留在本地报告中，文档检查不替代业务验收。

此前镜像与业务修复已分别整理为本地签名提交 928bf22 和 cf9bc69；既有镜像验证沿用已核对的最终输入证据，没有重新构建或扫描。当前没有推送、生产迁移或部署。

Synced through cf9bc699be4fc3510c243879d6bcbef5f635cca1（本次站点设置开发基线；本段包含随后单独提交的本地改动，不表示远端或线上状态）。

仓库设置与推送后台交接（2026-11-05）

foreground patch：仓库设置 PATCH 接入既有近期本地验证，输入规范化、原授权与设置快照的条件写入、成功回执及审计归入仓库领域服务。认证专题和权限现状明确仅精确 PATCH 匹配、团队 public 能力、空仓库同值表单与409交互；代码地图补充新的服务归属。快照比较覆盖服务端本次读取到写入，不引入浏览器版本或非授权字段的单调版本。

主流程说明同步后台默认分支采用条件：保留远端读取期间管理员保存的新值，活动时间照常记录，同次后续使用返回的仓库行，目标已删除则停止。保留 Artifacts 与 D1 的独立操作边界，命名空间前缀仍可能来自较早读取，未据此声称完整名称或跨服务状态实时一致。

新增仓库设置60项、推送交接7项回归，按实际目录纳入 CI。最终冻结源码完整验证为 Worker/前端244文件3344项、Linux脚本36文件774项，全部退出0且未处理错误0；全部类型、业务构建、格式、认证生成与 Agent 同步通过。隔离验证后1190个文件哈希未变，数据库声明和迁移保持基线，无新迁移。旧实现失败、已修正的测试夹具及独立复核边界保留在本地报告，不以静态检查代替运行验证。

Synced through 07d69eeabd154959161d2eb7f8d7f1180684b24e（本轮开发基线；包含随后单独提交的本地改动，未推送、生产迁移或部署）。

GitHub Actions 全分支触发对齐（2026-11-07）

将现有 GitHub CI 与 Format 的推送触发从仅 main 扩展到所有分支，与 CNB 的分支覆盖保持一致；GitHub 仍运行全部模块，不增加部署入口。开发说明同步触发范围。本补丁不包含工作区中的权限排空功能及其测试登记。

验证：全部工作流 actionlint、类型检查、Prettier 格式检查及 CI 归属测试 11/11 通过。此前完整测试在 Windows 环境存在文件权限断言等失败，未记为全绿；未执行云端 CI 或部署。

Synced through c82f2eb2ed737c5cea1cc9b3a85c91c65c0a3076；本节记录该提交之后的双平台触发对齐。