Skip to content

refactor(src,ci): 拆分 UI 路由与 Profile 写编排,压缩注释,deploy.yml 大 shell 移到 tools/ - #16

Merged
leeefun merged 5 commits into
masterfrom
chore/source-slimming
Oct 7, 2026
Merged

leeefun merged 5 commits into
masterfrom
chore/source-slimming

Conversation

@leeefun

@leeefun leeefun commented Oct 6, 2026 •

Copy link
Copy Markdown
Owner

改动(结构 + 注释精简,不改行为)

1. 源码历史注释

src/**、src/durable/**:删日期、审计编号(F-x / P1 / R-x / §)、ADR 当历史标记、"修前/实测"故事、指向已删除文档的引用、已关闭 issue 编号;保留当前不变式与非显然理由(含 Cloudflare compatibility_date——那是当前平台 API 边界,不是项目历史)。

2. wrangler.toml

删资源创建史、事故史、日期、长篇费用推导;保留绑定、默认值、变量含义与容易踩坑的 Cloudflare 特性(账户实测事实另见 docs/free-plan-account-facts.md,不复制回 TOML)。

3. .github/workflows/deploy.yml(486 → ~210 行)

把三个大 shell 移到 tools/ci/*.sh,workflow 只留步骤名与 env:

quality / resolve resources / migrate / deploy / sync secrets / smoke check

未引入 composite action、未自造 Actions 框架。vars: 名单、schema 迁移步骤与顺序、test/docs.test.ts 守卫的目标串全部不变。

配套:

  • paths 增加 tools/ci/**(否则只改 CI 脚本不会触发 Deploy);
  • quality.yml 增加 bash -n tools/ci/*.sh(这三个脚本不在 tsc/eslint 射程内);
  • 新增 .gitattributes 锁定 *.sh 为 LF(core.autocrlf=true 会把它们落成 CRLF,在 Linux bash 上是语法错误)。

4. 克制的代码拆分

  • src/ui/routes.ts(964)→ 装配点(145)+ src/ui/routes/{shared,history-data,history-mutations,info}.ts;shared.ts 只留 2+ 消费端 的 parsePathIds(20 行),其余单消费端 helper 各归其领域文件。
  • src/profile.ts(759)→ 共享原语(185)+ src/profileWrite.ts(PUT 编排)+ src/profileHistory.ts(POST 编排);删掉拆分遗留的重复 saveAndNotifyCurrentProfile 与兼容用 re-export。
  • cleanup.ts、SyncClipboardHub.ts、db.ts 不拆(复杂度属同一资源/状态模型)。

调用方(routes/*、test/*)随迁,无 re-export 垫片。

验证

合并方式

Squash and merge:本 PR 的中间过程(初版拆分 → 修 shared/CI/重复函数 → 清注释 → rebase 解决冲突)不进 master,只留一个最终结构性提交。

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-06T15:02:54.703978Z 01679e5 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

leeefun added a commit that referenced this pull request Oct 6, 2026
…ell 检查

评审反馈(#16):
- deploy.yml 的 paths 漏了 tools/ci/** ⇒ 只改 CI 脚本不会触发部署。补上。
- quality.yml 新增 'bash -n tools/ci/*.sh':这三个脚本是部署实质逻辑,不在
  tsc/eslint 射程内,改坏了 PR 仍可能全绿。
- profile.ts 的 saveAndNotifyCurrentProfile 是拆分后的遗留重复(零调用者),
  删掉;唯一实现在 profileWrite.ts。随之清掉不再使用的 import。
- profile.ts 的 'export { BadRequestError, basename }' 是兼容 re-export,与本次
  干净切换目标相悖;删掉,test/limits.test.ts 改为直接从 ../src/db 取 BadRequestError。
- shared.ts 从 279 行收窄到 19 行:单消费端 helper 各回其领域文件
  (deployment*/readDeletedFlagOr400/readIntParam → info.ts;readCredentials → routes.ts;
  Range 三件套 → history-data.ts;UI_TEXT_CREATE_MAX_BYTES/mapLimit/并发常量 →
  history-mutations.ts);只留 2+ 消费端的 parsePathIds。

验证:tsc 0、eslint 0、bash -n 全过;全量 22/22·497 通过;V1/V2 探针 findings=0。
leeefun added a commit that referenced this pull request Oct 6, 2026
评审反馈(#16 收尾):
- cleanup.ts:删 'GitHub issue #3'(已关闭、对理解当前实现无价值);
  合并键表注释去掉 '审计 P1-3' 与 '两批都要读' 的旧对比,改为当前理由。
- index.ts:negotiate 的 405 注释收敛成当前不变量,不再讲旧代码当年怎么错。
- Cloudflare compatibility_date 保留(那是当前平台 API 边界,不是项目历史)。
leeefun added a commit that referenced this pull request Oct 6, 2026
评审指出:#16 基于旧 master,其 historyOps.ts / routes(移动后) 仍是裸的
deleteHistoryWorkingDir,没有 #13 的 best-effort 语义 ⇒ 若 #16 先合会退掉 #13。

本提交把 #13 的改动原样前向移植(使 #16 rebase 时无实质冲突):
- src/historyOps.ts:deleteRecordsWorkingDirs 改 best-effort(catch + '[cleanup] deferred R2 cleanup')。
- src/ui/routes/history-mutations.ts:batch-purge 单条 R2 删失败不再把整批变 500。
- test/fixes.test.ts:FakeBucket.failDelete 注入 + 三条用例(purgeTrash/clearAllHistory/阳性对照)。
- docs/design.md §6:登记删除成功语义。
…ools/

结构与注释精简,不改行为:

- src/ui/routes.ts(964)拆成装配点(117)+ src/ui/routes/{shared,history-data,
  history-mutations,info}.ts;20 条路由与 test/ui-guard 的 EXPECTED_API_ROUTES 逐字一致。
- src/profile.ts(759)拆成共享原语(201)+ src/profileWrite.ts(PUT 编排)+
  src/profileHistory.ts(POST 编排);调用方(routes/*、test/*)随迁,无 re-export 垫片。
- src/**、src/durable/** 注释压缩:删日期/审计编号/已删除文档引用/修前故事,保留当前不变式。
- wrangler.toml:删资源创建史/事故史/日期/费用推导,保留绑定、默认值与易踩的 CF 特性。
- deploy.yml(486→206):把 Resolve resources / Resolve switches / Smoke check 三个大 shell
  移到 tools/ci/*.sh,workflow 只留步骤名与 env;vars 名单、schema 迁移步骤与顺序、守卫目标串不变。
- README/design.md/ui.md:目录树与模块表随拆分更新。

验证:tsc 0 错、eslint 0 告警、bash/sh -n 全过、三个 CI 脚本按输入实测(非法值当场失败、
缺地址报错)、smoke-check 对本地实例跑通(全部资产 200 + 鉴权/统计/profile 断言)。
完整套件 22/22、497 用例通过(dev server 8787)。
…ell 检查

评审反馈(#16):
- deploy.yml 的 paths 漏了 tools/ci/** ⇒ 只改 CI 脚本不会触发部署。补上。
- quality.yml 新增 'bash -n tools/ci/*.sh':这三个脚本是部署实质逻辑,不在
  tsc/eslint 射程内,改坏了 PR 仍可能全绿。
- profile.ts 的 saveAndNotifyCurrentProfile 是拆分后的遗留重复(零调用者),
  删掉;唯一实现在 profileWrite.ts。随之清掉不再使用的 import。
- profile.ts 的 'export { BadRequestError, basename }' 是兼容 re-export,与本次
  干净切换目标相悖;删掉,test/limits.test.ts 改为直接从 ../src/db 取 BadRequestError。
- shared.ts 从 279 行收窄到 19 行:单消费端 helper 各回其领域文件
  (deployment*/readDeletedFlagOr400/readIntParam → info.ts;readCredentials → routes.ts;
  Range 三件套 → history-data.ts;UI_TEXT_CREATE_MAX_BYTES/mapLimit/并发常量 →
  history-mutations.ts);只留 2+ 消费端的 parsePathIds。

验证:tsc 0、eslint 0、bash -n 全过;全量 22/22·497 通过;V1/V2 探针 findings=0。
评审反馈(#16 收尾):
- cleanup.ts:删 'GitHub issue #3'(已关闭、对理解当前实现无价值);
  合并键表注释去掉 '审计 P1-3' 与 '两批都要读' 的旧对比,改为当前理由。
- index.ts:negotiate 的 405 注释收敛成当前不变量,不再讲旧代码当年怎么错。
- Cloudflare compatibility_date 保留(那是当前平台 API 边界,不是项目历史)。
评审指出:#16 基于旧 master,其 historyOps.ts / routes(移动后) 仍是裸的
deleteHistoryWorkingDir,没有 #13 的 best-effort 语义 ⇒ 若 #16 先合会退掉 #13。

本提交把 #13 的改动原样前向移植(使 #16 rebase 时无实质冲突):
- src/historyOps.ts:deleteRecordsWorkingDirs 改 best-effort(catch + '[cleanup] deferred R2 cleanup')。
- src/ui/routes/history-mutations.ts:batch-purge 单条 R2 删失败不再把整批变 500。
- test/fixes.test.ts:FakeBucket.failDelete 注入 + 三条用例(purgeTrash/clearAllHistory/阳性对照)。
- docs/design.md §6:登记删除成功语义。
rebase 到新 master 时,core.autocrlf=true 把三个 CI 脚本重新落成 CRLF,会让
Linux 上的 GitHub Actions bash 直接语法错误(自动换行把 set -euo pipefail 与
函数定义的解析打乱)。加 .gitattributes 显式锁定 *.sh 为 LF,并 renormalize 三个脚本。
已核对:全新 checkout 后三者均为 LF,WSL 真 bash 下 bash -n 与 resolve-switches 实跑通过。
@leeefun
leeefun force-pushed the chore/source-slimming branch from 676d177 to b2aed81 Compare October 7, 2026 00:33
@leeefun
leeefun merged commit b1592c2 into master Oct 7, 2026
1 check passed
@leeefun
leeefun deleted the chore/source-slimming branch October 7, 2026 00:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant