Skip to content

feat: login readiness guard and Chinese-first README redesign - #2

Merged
caigee-cmd merged 2 commits into
mainfrom
feature/login-readiness-and-readme
Aug 26, 2026
Merged

caigee-cmd merged 2 commits into
mainfrom
feature/login-readiness-and-readme

Conversation

@caigee-cmd

Copy link
Copy Markdown
Owner

变更内容 / What's inside

1. 登录就绪守卫 (fix: wait for worker login readiness)

  • 浏览器 / PAT 登录先等待账号 worker 的 AuthManager 就绪(90s 轮询)再转发,修复首次点击的 CN 竞态
  • loginWith* unavailable 的 worker 错误归类为 not_ready(503 + 故障切换),不再误判为鉴权错误
  • 向导和 Accounts 页在会话启动期间显示「正在启动账号会话…」提示
  • 删除 PROVIDERS_TASKS.md,计划状态归入 docs/PLAN.md

2. README 重做 (docs: Chinese-first with project-native SVG visuals)

  • 首页换成中文 README,英文版移至 README_EN.md,互链同步
  • 新增项目原生 SVG(docs/assets/readme/):hero、控制台窗口、架构图 × 中英,全部取自控制台设计 token 与 favicon 闪电 / 数据点母题
  • 章节按「价值 → 证据 → 机制 → 上手」重排;部署流程、接入说明、更新器、维护者发布各节逐字保留
  • 同步更新 Makefile(favicon-sync 去掉 og-card 拷贝)、CONTRIBUTING.md、docs/DESIGN.md、AGENTS.md、docs/assets/README.md 与双语 CHANGELOG

验证 / Validation

  • python3 scripts/release-notes.py validate ✅
  • beautify-github-readme 自带 audit_readme.py 对两个 README ✅(本地图片引用与 SVG 基础检查通过)
  • worker 测试新增 not_ready 分类用例

- Proxy device-flow and PAT logins only after the account worker's
  AuthManager is warm (90s poll), fixing the first-click CN race
- Classify 'loginWith* unavailable' worker errors as not_ready (503,
  failover) instead of auth
- Show a 'starting account session' note in the wizard and Accounts page
  while the session starts
- Remove PROVIDERS_TASKS.md; plan state lives in docs/PLAN.md
- Swap the repository front page to the Chinese README; move the English
  README to README_EN.md and keep cross-links in sync
- Add project-native SVG assets under docs/assets/readme/: hero, console
  window, and architecture diagram in zh/en, built from the console design
  tokens and the favicon bolt/data-dot motif
- Reorder both READMEs as value -> proof -> mechanism -> first use, keeping
  the deployment, client setup, updater, and maintainer-release sections
  verbatim; replace the social card and console screenshot with a single
  overview card
- Drop the og-card copy step from make favicon-sync and CONTRIBUTING.md,
  and refresh AGENTS.md, docs/DESIGN.md, docs/assets/README.md, and the
  bilingual CHANGELOG entries
@caigee-cmd
caigee-cmd merged commit c1b9ed5 into main Aug 26, 2026
6 checks passed
@caigee-cmd
caigee-cmd deleted the feature/login-readiness-and-readme branch August 26, 2026 18:31
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