Skip to content

feat(sprint-7): 跨平台决策 + macOS 改造清单 + 打包 workflow#25

Merged
JohnC-stack merged 2 commits into
mainfrom
feat/sprint-7-cross-platform-decision
Apr 20, 2026
Merged

feat(sprint-7): 跨平台决策 + macOS 改造清单 + 打包 workflow#25
JohnC-stack merged 2 commits into
mainfrom
feat/sprint-7-cross-platform-decision

Conversation

@JohnC-stack
Copy link
Copy Markdown
Collaborator

Sprint 7 范围'规划+框架'完成:

  • ADR-0001 接入模式(回溯)
  • ADR-0002 跨平台栈 · 混合方案(macOS Swift 保留 + Linux/Win Tauri)
  • ADR-0003 自动更新(GitHub Release 为源)
  • Swift 改造清单 19 项,分 S7.1-7.4 推进
  • macOS build workflow 双路径(有/无 Apple Developer 证书)

不改 Swift 代码(留 S7.1-7.4 多轮)。

zhangkunshi added 2 commits April 20, 2026 21:09
按用户选择范围"规划+框架",Sprint 7 此轮不改 Swift 代码,只把决策
和实施框架定下来,为 S7.1-7.4 多轮 PR 铺路。

## 新增 · 3 个 ADR

- **ADR-0001** 采用 4 种接入模式作为框架一等公民(回溯 Sprint 1)· Accepted
  - 对比按规模/按业务/按阶段/不区分 4 方案,选按阶段(A/B/C/D)
- **ADR-0002** 跨平台桌面应用技术栈 · **混合方案**(Proposed)
  - macOS 保留 Swift(资产保护,Phase 1 投入不浪费)
  - Linux/Windows 用 Tauri + Svelte(快速多平台,包小)
  - 对比 Tauri / Electron / 保持原生 / 混合 4 方案,理由详述
  - 12 个月后评估 Tauri 能否在 macOS 大一统
- **ADR-0003** 自动更新策略 · GitHub Release 为源(Proposed)
  - 三平台统一用 GitHub Releases API 作更新源(零付费)
  - severity frontmatter 区分 critical/recommended/optional

## 新增 · 实施规划

- **docs/design/ui/swift-refactor-plan.md**
  - 22 个 Swift 文件改动清单 · P0/P1/P2 分级
  - 7 个新增文件 · 10 个重构文件 · 5 个小调整
  - S7.1-7.4 四轮 PR 推进路线
  - 跨文件依赖图(Mermaid)
  - 每 PR 测试策略

## 新增 · 构建基础设施

- **.github/workflows/macos-build.yml**
  - 签名/无签名双路径(检测 AC_TEAM_ID secret 是否配置)
  - 无签名: 用户右键打开绕 Gatekeeper(当前默认)
  - 有签名: codesign + notarytool 公证(secret 配好后自动启用)
  - 触发: push main app/ 下变动 / tag v*.*.* / 手动
  - tag 推送时自动创建 GitHub Release 附 .dmg
- **docs/adr/README.md** 索引由 generate-adr-index.js 自动生成

## 文档同步

- PLAN.md S7 状态: 规划/框架完成 · 代码 S7.1-7.4
- ROADMAP.md 近期变更加 S7 条目
- CHANGELOG 新增 [0.7.0-draft] Sprint 7 段
- CHANGELOG 原 [0.7.0-draft] Sprint 6 改为 [Sprint 6] 避免版本号冲突

## 不做

- 不实际修改 Swift 代码(留 S7.1-7.4 多轮,每轮需 Xcode 环境)
- 不配 Apple Developer 证书(用户暂无账号)

## 下一步

Sprint 7.1: 按 swift-refactor-plan.md P0 #1-5 在 Xcode 中改
主视图/侧栏/聊天/向导/设置 5 个文件,产出首个可下载的 Beta.dmg。
@JohnC-stack JohnC-stack merged commit 9787bcf into main Apr 20, 2026
10 checks passed
@JohnC-stack JohnC-stack deleted the feat/sprint-7-cross-platform-decision branch April 20, 2026 13:18
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