Files
TanXinandTanXin 6374080281 release: 发布 v1.10.2 工作流和文档更新版本 (#97)
## 版本内容

v1.10.2 为文档与 CI 工作流更新版本(无代码变更),包含以下提交:

| 提交 | 说明 |
| --- | --- |
| `11149d7` | docs: 全面更新项目文档并精简 README 结构 |
| `2b36ff4` | ci: 修复文档变更误触发部署的 paths-ignore 作用域 |
| `ee8f048` | ci: 按 SHA 锁定 GitHub Actions 引用以加固供应链 |
| `1f2a6b7` | docs: 完善发布流程规范(release 提交与 PR 标题主题化) |
| `cbdae18` | release: 发布 v1.10.2 工作流和文档更新版本 |

## 更新要点

**文档(README 中英双语)**
- 核心优势要点化:重点、全面、不啰嗦
- 架构说明仅保留系统架构图,移除核心组件 / SSH 协议实现 / 数据流三个小节
- 快速部署移除本地命令行部署方式,新增「可配置环境变量」汇总表
- 更新演示视频时长 8:27 → 19:48

**维护文档**
- AGENTS.md:补齐目录树、环境变量、tests/ 结构与新坑位(DNS 防重绑定、Biome、i18n、CI 作用域、发布流程主题化)
- tests/README.md:补充 7 个新测试文件与覆盖范围

**CI 修复与加固**
- `paths-ignore` 作用域:`*` 不匹配 `/`,原 `*.md` 仅忽略根目录文档,导致 `tests/README.md`
等子目录文档变更误触发完整部署;改为 `**/*.md` 等跨目录模式
- GitHub Actions 引用按 40 位 commit SHA 锁定(checkout / setup-node / pnpm /
configure-pages / upload-pages-artifact / deploy-pages),消除 tag 可变引用风险
- 新增 `.yamllint`:放宽行宽限制(SHA 引用天然超 80 字符)并统一 YAML 双引号规范,消除 pi-lens 格式化漂移

## 验证结果

- `pnpm run typecheck` 通过
- `pnpm test` 通过(47 个测试文件 / 603 个用例)
- `pnpm run build:frontend` 构建成功
- 两份 workflow 经 yamllint 校验无错误
- CI 完整门禁(typecheck + test + 可复现构建 + Playwright E2E + axe)在 `2b36ff4`
已绿色通过,`cbdae18` 运行中

---------

Co-authored-by: TanXin <tanxin@example.com>
2026-08-20 17:06:37 +08:00

35 lines
893 B
YAML

name: Deploy to GitHub Pages
on:
push:
branches: [test, main]
paths:
- "docs/**"
jobs:
deploy:
if: github.repository_owner == 'newbietan'
runs-on: ubuntu-latest
permissions:
contents: read
pages: write
id-token: write
steps:
# actions/checkout@v4.4.0
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
- name: Setup Pages
# actions/configure-pages@v4
uses: actions/configure-pages@1f0c5cde4bc74cd7e1254d0cb4de8d49e9068c7d
- name: Upload artifact
# actions/upload-pages-artifact@v3
uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa
with:
path: "docs"
- name: Deploy to GitHub Pages
id: deployment
# actions/deploy-pages@v4
uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e