## Why 学习时(PDF / 音视频)需要向 AI 圈选提问,但当前 StudyDeck 无模型配置与密钥通道。家长应在 PC 配置厂商/模型/密钥/提示词,经安全局域网同步到 iPad;并预留日后服务端订阅配置,降低非专业家长自备 Key 的门槛。 ## What Changes - **PC AI 设置**:配置 vendor / model / `baseUrl` / API Key / 功能提示词与 feature 开关;安全落盘;`updatedAt` 版本;测试连接。 - **AI 配置分享(LAN)**:与课件 Publish **分离**;配对(QR/码)+ ECDH + AES-GCM 下发配置;session token 可撤销;**不把 Key 打进课件 zip**。 - **iPad 同步规则**:用 AI 前拉 PC;在线比 `updatedAt` 取新;PC 离线则用 Keychain 缓存;无缓存则提示不可用。 - **客户端直连**:按配置 `baseUrl` 调模型(可为厂商或日后统一代理)。 - **学习侧 AI UI(Phase B)**:PDF 矩形提问;音视频 in/out 段落提问;预留波形/涂鸦增强。 - **服务端订阅预留(Phase C)**:schema/`source` 支持 `server`;合并钩子与双模式(自备 Key vs 订阅);本期不实现完整云账户。 ## Capabilities ### New Capabilities - `studydeck-ai-config`: `AiRuntimeConfig` schema、PC 设置与安全存储、测试连接。 - `studydeck-ai-sync`: 配对、加密 LAN 同步、版本比较、iPad 缓存与离线文案;预留 Server 三方合并。 - `studydeck-ai-study`: 学习舞台内 AI 聊天/圈选提问(PDF 矩形、音视频 clip)。 ### Modified Capabilities - (无强制修改)课件 `studydeck-pc-publish` 保持无鉴权;AI 走独立 path/鉴权,不改变课件 API 契约。 ## Impact - **`studydeck/`**:AI 设置页、Tauri AI config store、LAN `/ai/*` 端点、可选 Study AI 面板。 - **`studydeck-ios/`**:Keychain 配置仓、配对/同步客户端、Study AI 面板。 - **安全**:禁止明文传 Key、禁止日志打印 Key;Keychain / OS credential store。 - **依赖**:Rust crypto(ECDH/AES-GCM)、iOS CryptoKit/Keychain;不改牛津树 `frontend/`/`backend/`。