Skip to content

docs: 更新 LinkUp 首页与中文发布说明流程 - #58

Merged
mel0nyrame merged 3 commits into
masterfrom
docs/readme-visual-story
Sep 29, 2026
Merged

mel0nyrame merged 3 commits into
masterfrom
docs/readme-visual-story

Conversation

@mel0nyrame

@mel0nyrame mel0nyrame commented Sep 29, 2026 •

Copy link
Copy Markdown
Owner

背景

原主页仍按 Android 单平台介绍,Windows 安装入口和当前认证流程不够直观。原 Release 正文直接列出提交标题,难以保证面向用户的发布信息完整、统一且为中文。

变更轮廓

README 现在按“项目用途 → Android 真实界面 → 双平台下载与使用 → 认证与重连 → 适用范围”展开。浅色设备插画用于识别项目,界面展示使用仓库内的真实 Android 截图;Windows 端只介绍已有的主窗口、托盘和安装器,没有虚构截图。README 图片审计已确认 3 处本地图片引用有效。

发布路径调整为:

release-v<版本> tag
- 直接把 tag 间的提交标题写入 Release
+ 校验 tag → 读取该 tag 提交内手写的中文更新说明;缺失或更新内容为空则停止
  测试 → 构建 Android APK 与 Windows 安装器
+ 合并中文更新说明、双平台安装指引和两个文件的 SHA-256 → 创建 Release

本地模拟覆盖了合法与非法 tag、缺失与空更新说明,以及两端文件的正文和校验值组装;工作流通过 actionlint。交付文档和 AGENTS.md 将“先写中文说明并提交,再创建 tag”指向同一流程。

验证汇总

  • go run github.com/rhysd/actionlint/cmd/actionlint@v1.7.12 .github/workflows/release.yml:通过。
  • 使用临时中文说明与模拟安装文件执行发布脚本:合法、非法和缺失输入的分支符合预期;正文包含两个文件的 SHA-256。
  • git diff --check origin/master...HEAD:通过;已确认旧图片路径没有残留引用。

评审注意事项

未来每个正式发布版本都要在打 tag 前提交 docs/releases/release-v<主版本.次版本.修订号>.md。本 PR 不创建新 tag,也不发布安装包;对没有说明文件的旧 tag 手动重跑新版发布工作流,会在说明校验阶段停止。

风险与回滚

影响范围是仓库首页与正式 Release 的正文生成流程;构建命令和安装包命名保持原样。若发布说明流程需要回退,可还原本 PR 的 Release 工作流与发布约定;不涉及用户数据迁移。

@mel0nyrame
mel0nyrame merged commit 0341726 into master Sep 29, 2026
6 checks passed
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