Skip to content

feat: add macOS source release installer - #2

Merged
Alex-ghost599 merged 4 commits into
developfrom
feat--macos-source-installer
Jul 19, 2026
Merged

feat: add macOS source release installer#2
Alex-ghost599 merged 4 commits into
developfrom
feat--macos-source-installer

Conversation

@Alex-ghost599

@Alex-ghost599 Alex-ghost599 commented Jul 19, 2026

Copy link
Copy Markdown
Owner

解决的问题

macOS 适配目前只有手动源码步骤,其他 Apple Silicon 设备缺少固定版本、可校验、可重复执行的安装入口。

变更

  • 新增 Apple Silicon 源码安装脚本,固定默认 tag 为 v2.6.0-macos.1
  • 通过 Homebrew 准备 uvffmpeg,以 uv sync --all-groups --frozen 安装依赖
  • 默认调用仓库现有下载器校验并安装 Paraformer/标点模型,可用 --skip-models 跳过
  • 本地构建并校验 dist/CapsWriter.app,不自动启动;目标目录已存在时在 Homebrew 前停止
  • README 和 macOS 文档增加 Release 下载、SHA-256 校验、逐机权限说明
  • 增加帮助、非破坏 dry-run、参数错位、目标冲突、clone 失败及真实带空格路径测试
  • 增加独立 macOS installer CI,持续执行 ShellCheck、Bash 3.2 语法和隔离行为测试

验证

  • uv lock --check
  • uv run pytest -q47 passed, 1 skipped
  • bash scripts/lint_macos_port.sh
  • shellcheck --shell=bash scripts/install_macos.sh
  • 从 GitHub 任务分支全新 clone 实际安装:77 个冻结依赖、两套模型 SHA-256 校验、533 MB 模型、77 MB 原生 arm64 App、codesign --verify --deep --strict 均通过

风险与后续

  • 仅支持 Apple Silicon;每台 Mac 仍需分别授予麦克风、辅助功能和输入监控权限
  • Release 是源码安装实验版,不包含 Developer ID 签名/公证的预编译 App,也不捆绑模型
  • 合并后再创建 v2.6.0-macos.1 tag、预发布版、install-macos.shSHA256SUMS

@Alex-ghost599
Alex-ghost599 merged commit 284362e into develop Jul 19, 2026
4 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