发布包包含静态链接的 Linux Go 二进制 bin/fastnews 和 React web/dist。业务语料、SQLite、.env 和开发依赖不进入发布包。阅读跳转资源由前端构建复制到 web/dist/reports/,历史报告的资源地址由 Go 提供兼容映射。
make install
make test
pnpm --dir web exec playwright install --with-deps chromium
make test-browser
# 浏览器测试使用根路径;发布前按生产路径重建。
FASTNEWS_PUBLIC_PATH=/news make build-release
./scripts/package-release.sh包位于 dist/release/release.tar.gz,manifest.json 记录 repository、commit SHA 与 archive SHA256。正式发布使用 CI 对确切提交构建的包。
| 工作流 | 触发 | 行为 |
|---|---|---|
ci.yml |
main 的 PR / 推送、v* 标签、手动 |
Go race / vet、格式检查、桌面/手机/子路径/私有报告浏览器测试、原生构建和产物上传;标签检查通过后发布 GitHub Release 并部署 fastrd |
update.yml |
每日 06:00 UTC、手动 | Go 采集 BleepingComputer、arXiv CS.CR / CS.AI |
gen_newspaper.yml |
每日 22:30 UTC、手动 | Go 生成中文摘要、日报,提交检查点 |
conf_release.yml |
手动选择会议与年份 | Go 采集、摘要、HTML/PDF,提交数据并发布该会议报告 |
weekly_release.yml |
每周六 06:00 UTC、手动 | Go 生成周报 HTML/PDF,提交 HTML 并发布附件 |
数据任务仅在 main 运行,共用并发组,避免互相覆盖提交。它们只提交指定数据目录;生成失败时仍尝试保存已有检查点,失败状态保留。报告发布可重跑更新附件,无需删除原 Release 或标签。生成摘要需要仓库 secrets OPENAI_API_KEY,可选 OPENAI_BASE_URL、LLM_MODEL。
CI 产物保留七天,v* 标签的包发布到 GitHub Releases。普通 main 提交和手动验证不部署。推送 v* 标签会调用固定 SHA 的 FastDeploy reusable workflow,通过 production Environment 与组织 SSH Secrets 上传原生包、原子切换并启动服务;健康检查失败时自动恢复前态。旧运行时对应的部署、回滚工作流已移除。
Go profile 与 FastDeploy v2.0.3 的 FastNews 配置同步,定义原生命令、健康检查和共享目录。ci.yml 固定 FastDeploy 完整提交 SHA,服务启动 {release}/bin/fastnews serve,FASTNEWS_WEB_DIR 由平台指向版本内的前端。平台 Python launcher 只注入环境后 exec Go,不运行旧应用。
发布命令:
git tag -a v2026.11.12-deploy.1 -m "FastNews Go and React production deployment"
git push origin v2026.11.12-deploy.1每次部署使用新的版本标签,不移动或复用已发布标签。news 独立域名的根入口由浏览器规范化到 /news/,兼容网关 strip-prefix;API 与 FastCAS 回调同时支持原根路径。
生产 runtime-env 至少设置:
FASTNEWS_HOST=127.0.0.1
FASTNEWS_PORT=8788
FASTNEWS_ROOT=/home/dev/FastNews
FASTNEWS_DATA_DIR=/home/dev/FastNews/.fastnews-data
FASTNEWS_WEB_DIR=<release>/web/dist
FASTNEWS_PUBLIC_PATH=/news
FASTNEWS_PUBLIC_ORIGIN=https://news.fastrd.io
FASTNEWS_COOKIE_SECURE=true<release> 为实际发布目录;profile 使用 {release} 占位。域名根路径部署时,前端构建和后端运行的 FASTNEWS_PUBLIC_PATH 同时设为空。FASTNEWS_ROOT 保留现有语料和报告,FASTNEWS_DATA_DIR 保留独立账号库。
可直接使用 systemd 样例 和 nginx 样例。业务数据由服务用户持有。scripts/deploy-local.sh 用于原生服务的本机构建部署,会检查 unit 启动 Go、安装冻结依赖、测试、构建、重启并检查健康状态;运行前需配置生产环境和前端构建路径。
Go 默认同时提供 SPA。前后端独立部署时,nginx 提供 web/dist,将同源 /news/api/、/news/top-conf/data/、/news/secnews/data/ 转发到 Go,并确保历史报告的 /news/assets/fastread.js、/news/assets/fastread.css 转发到 Go 或映射到新资源。
回滚使用已归档并验证过的原生发布包,切换发布目录后重启同一 Go unit。SQLite、语料和报告保持在独立共享目录,代码发布与回滚均不清理业务数据。