YuJiWatch/README.md

语记手表版 YuJiWatch — Apple Watch 伴生 App

抬腕点一下就录，录完自动传到 iPhone：手机端系统语音识别转写，再 AI 整理成 Markdown。 手表只负责录和传，整理、存储、分享都在 iPhone 端复用语记现有能力。

能做什么

• ⌚ 手表主页一键录音（72pt 红色话筒钮），录音中显示计时，停止即发送
• 📲 WatchConnectivity 传文件到 iPhone，iPhone 端自动转写并生成笔记
• 🧩 表盘复杂功能：圆形 / 长条形 / 行内形三种，显示今日速记数，点一下打开手表 App 开始录音
• 📋 手表端最近录音列表（时间、时长、是否已传到 iPhone）

目录结构

YuJiWatch/
├── YuJiWatchApp/            # → Watch App target
│   ├── YuJiWatchApp.swift   # 入口
│   ├── ContentView.swift    # 主页：录音 / 今日数 / 最近录音
│   ├── WatchRecorder.swift  # AVAudioRecorder 录 AAC .m4a
│   ├── WatchSessionManager.swift  # WCSession 传文件 + 今日数 + 刷新复杂功能
│   └── WatchStore.swift     # 手表本地最近录音记录
├── YuJiWatchWidget/         # → Widget Extension target
│   └── Complication.swift   # 三种复杂功能
└── Phone/                   # → 拖进 YuJi iPhone 工程
    └── WatchSyncService.swift  # iPhone 端收文件、转写、建笔记

注意：WatchSessionManager.swift 要同时放进 Watch App 和 Widget Extension 两个 target， 因为复杂功能读今日数走它里面的 loadTodayCount()。两个 target 各有一个 @main，不要把 Complication.swift 放进 Watch App target，否则 @main 冲突。

在 Mac 上接进 YuJi 工程

1. 用 Xcode 16+ 打开 YuJi 工程 → File → New → Target → Watch App，部署目标选 watchOS 10 （watchOS 10 对应 Series 4 及以后、SE、Ultra 都能用；不需要 Ultra 专属功能）
2. 把 YuJiWatchApp/ 里的文件加进 Watch App target；新建 Widget Extension target， 把 YuJiWatchWidget/Complication.swift 和 WatchSessionManager.swift 加进去
3. 把 Phone/WatchSyncService.swift 拖进 YuJi iPhone target，在 YuJiApp 启动时调一次： WatchSyncService.shared.activate(modelContext:)（modelContext 就是 SwiftData 那个）
4. 真机联调：手表和 iPhone 配对后，手表录一段 → iPhone 端应该自动多出一条“手表速记”笔记

可选：App Group

现在今日数存在手表本地 UserDefaults，只给复杂功能用。如果想让 iPhone 端也读到今日数， 在 Xcode 里给 Watch App、Widget Extension、iPhone App 三个 target 开同一个 App Group， 把 UserDefaults.standard 换成 UserDefaults(suiteName: "group.com.你的域名.yuji") 即可。

注意

• 这份代码在 Linux 环境下写的，没在 Xcode 里实际编译过。第一次打开如果有个别编译报错， 把报错发给 Muse，一轮就能修好。
• 手表录音是短录音场景：抬腕说完就停，不要设计成长时间连续录（续航和后台限制）。
• 手表自己能录音，但转写和 AI 整理必须连上 iPhone 才回来；蜂窝版也一样，只是传输时机不同。