ci: deploy documentation with reusable workflow

[zombieJ]

Summary

• deploy documentation on published releases and manual dispatches
• reuse the shared react-component Pages workflow

Verification

• validated by the shared Pages build after merge

Summary by CodeRabbit

• 新功能

  • 新增文档页面自动部署流程，支持在发布新版本或手动触发时部署。

• 配置

  • 为文档部署设置必要的访问权限，提升部署流程的安全性。

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
upload	Ready	Preview, Comment	Jul 27, 2026 10:33am

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[coderabbitai]

Walkthrough

新增文档页面部署工作流，支持发布完成或手动触发，并配置 Pages 写入及 OIDC 权限，通过外部工作流模板执行部署。

Changes

文档页面部署

Layer / File(s)	Summary
部署工作流配置 .github/workflows/deploy-pages.yml	新增“Deploy documentation”工作流，配置发布和手动触发条件、所需权限，并调用外部部署模板。

Estimated code review effort: 1 (Trivial) | ~3 minutes

Poem

我是小兔蹦蹦跳，
文档页面要起跑。
发布一到自动 deploy，
手动触发也可靠。
Pages 门前挥挥手，
月光下把成果抱。

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	标题准确概括了新增的文档部署 CI 工作流，并点出了可复用工作流这一主要变化。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch agent/deploy-pages

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

React Doctor could not complete this scan.

react-doctor exited with status 0 before producing a JSON report.

Report this bug

_{Reviewed by React Doctor for commit 617d73b.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/workflows/deploy-pages.yml:
- Line 15: 将 deploy-pages.yml 中对外部可复用工作流的 `@main` 引用替换为经过审查的完整 commit
SHA，并保留现有工作流路径与权限配置不变。

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 5c5c7b7f-67ff-4614-8d62-c5f4014bb8ff

📥 Commits

Reviewing files that changed from the base of the PR and between c2f2fef and 617d73b.

📒 Files selected for processing (1)

• .github/workflows/deploy-pages.yml

[coderabbitai]

🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== workflow file =="
if [ -f .github/workflows/deploy-pages.yml ]; then
  cat -n .github/workflows/deploy-pages.yml
else
  echo "missing .github/workflows/deploy-pages.yml"
fi

echo
echo "== changed files/status =="
git status --short
echo
git diff --stat || true

echo
echo "== all reusable workflow references under deploy-pages.yml context =="
rg -n "uses:\s*[^#]*(deploy-pages|\.github/workflows)" .github/workflows/deploy-pages.yml || true

echo
echo "== all git references to rc-test deploy-pages workfows =="
rg -n "react-component/rc-test/.github/workflows/deploy-pages\.yml|rc-test/.github/workflows/deploy-pages" .github . 2>/dev/null | head -100 || true

Repository: react-component/upload

Length of output: 875

---

将外部可复用工作流固定到完整 commit SHA。

当前 react-component/rc-test/.github/workflows/deploy-pages.yml@main 会随上游分支变更自动拉取新代码，该工作流拥有 pages: write 和 id-token: write 权限；改用完整 SHA 可避免发布重跑使用未经审查的工作流版本。

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/workflows/deploy-pages.yml at line 15, 将 deploy-pages.yml
中对外部可复用工作流的 `@main` 引用替换为经过审查的完整 commit SHA，并保留现有工作流路径与权限配置不变。

[github-actions]

❌ Deploy failed

	❌ Failed
	🔗 Preview https://react-component-upload-preview-pr-724.surge.sh (may be unavailable)
	📝 Commit	617d73b
	🪵 Logs	View logs

📋 Build log (last lines)

npm error
npm error Could not resolve dependency:
npm error peer eslint@"^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9.7" from eslint-plugin-react@7.37.5
npm error node_modules/eslint-plugin-react
npm error   dev eslint-plugin-react@"^7.37.5" from the root project
npm error   eslint-plugin-react@"^7.32.2" from @umijs/fabric@4.0.1
npm error   node_modules/@umijs/fabric
npm error     @umijs/fabric@"^4.0.0" from rc-test@7.1.3
npm error     node_modules/rc-test
npm error       dev rc-test@"^7.1.3" from the root project
npm error
npm error Conflicting peer dependency: eslint@9.39.5
npm error node_modules/eslint
npm error   peer eslint@"^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9.7" from eslint-plugin-react@7.37.5
npm error   node_modules/eslint-plugin-react
npm error     dev eslint-plugin-react@"^7.37.5" from the root project
npm error     eslint-plugin-react@"^7.32.2" from @umijs/fabric@4.0.1
npm error     node_modules/@umijs/fabric
npm error       @umijs/fabric@"^4.0.0" from rc-test@7.1.3
npm error       node_modules/rc-test
npm error         dev rc-test@"^7.1.3" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error /home/runner/.npm/_logs/2026-07-27T10_33_59_914Z-eresolve-report.txt
npm error A complete log of this run can be found in: /home/runner/.npm/_logs/2026-07-27T10_33_59_914Z-debug-0.log

_{🤖 Powered by surge-preview}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.58%. Comparing base (c2f2fef) to head (617d73b).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #724   +/-   ##
=======================================
  Coverage   89.58%   89.58%           
=======================================
  Files           6        6           
  Lines         317      317           
  Branches       94       90    -4     
=======================================
  Hits          284      284           
  Misses         33       33           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.