实施清单与质量门控

一、开发前准备清单

环境配置

• Xcode 最新版安装并配置
• Apple Developer 账号就绪
• Node.js + npm 环境就绪
• Anthropic API Key 获取
• 阿里云 ECS 服务器准备（部署用）
• Git 仓库初始化

项目初始化

• Xcode 项目创建（SwiftUI + Core Data）
• App Group 配置 (group.com.cozlabs.kept)
• Bundle ID 设置
• Info.plist 权限配置（麦克风、位置、通知）
• kept-api 目录初始化 (npm init)
• .gitignore 配置（排除 .env、API keys、build products）
• TestFlight 配置准备（App Store Connect 中创建 App，D7 分发用）

二、D1 — 搭骨架（语音录入）

任务清单

• Xcode 创建项目，配置 SwiftUI + Core Data
• 实现 SpeechService：请求麦克风权限、实时语音转文字
• 创建 RecordButton 组件：长按开始录音，松开结束
• HomeView 展示录音结果文字
• 配置 App Intents，让 Action Button 可以触发录音

质量门控

• 验收标准：长按屏幕按钮（或 Action Button）说话，松开后文字出现在屏幕上
• 测试要点：
  • 中文识别准确率
  • 中英混杂识别效果
  • 长按/松开的交互反馈（动画、震动、Haptic feedback）
  • 按下缩放 + 录音中脉冲动画是否流畅
  • 无麦克风权限时的错误处理

三、D2 — AI 大脑（云端 API）

任务清单

• 创建 Express 项目 + 安装 @anthropic-ai/sdk
• 实现 POST /process 端点
• 导入 System Prompt（从 prompts.js）
• 响应验证：确保 JSON 有 memories 数组
• JSON 解析失败时重试一次
• 多条记忆拆分验证（一句话含多件事 → memories 数组 > 1）
• 畸形 JSON 兜底：LLM 返回非法 JSON 时的 fallback 处理
• 添加 GET /health 健康检查
• 本地测试通过

质量门控

• 验收标准：curl 发送"洗面奶没了"，返回 JSON 含 type: ACTION, triggers: [LOCATION: drugstore]
• 测试用例：
  • "洗面奶没了" → ACTION + 地点触发
  • "护照在第二个抽屉" → KNOWLEDGE + 无触发
  • "盐没了 还有酱油也快没了" → 两条 ACTION
  • "想试那家日料" → INTENT
  • "该理发了" → RECURRING

四、D3 — 贯通（端云串联）

任务清单

• 实现 APIService：调用云端 /process 端点
• JSON 响应解码为 Swift 结构体
• 创建 MemoryStore：Core Data CRUD 操作
• HomeView 显示记忆列表
• 完整流程串联：说话 → 转文字 → 调 API → 存储 → 显示

质量门控

• 验收标准：说"下次见老张问合同的事" → 列表出现一条记忆，类型 ACTION，关联人物"老张"
• 测试要点：
  • 网络请求失败时的错误处理
  • JSON 解码失败时的 fallback
  • Core Data 存取正确性
  • 列表刷新即时性

五、D4 — 提醒（通知 + 地理围栏）

任务清单

• 实现 NotificationService：本地通知调度
• 时间触发：解析 time trigger → UNNotification
• 实现 LocationService + PlaceResolver
• 地点触发：解析 location trigger → CLCircularRegion
• PlaceResolver MapKit 升级：MKLocalSearch 动态 POI + 用户标记家/办公室 + 缓存
• 围栏进入 → 触发本地通知
• 围栏预算管理（20 个上限）

质量门控

• 验收标准：说"买盐" → 到超市附近 → 手机推送通知"盐 🛒"。说"明天给妈打电话" → 明天上午收到通知
• 测试要点：
  • 模拟器中模拟位置变化
  • 真机实际地理围栏测试
  • 位置权限被拒的 fallback
  • 通知权限处理

六、D5 — Widget（锁屏显示）

任务清单

• 创建 Widget Extension (KeptWidget)
• 配置 App Group 共享 Core Data
• Lock Screen widget：显示最新活跃记忆
• Home Screen widget：显示最多 3 条活跃记忆
• 通知上的"完成"按钮 → 标记记忆为 done
• 列表左滑完成手势（与通知"完成"按钮共用同一逻辑）
• Widget 数据刷新（15 分钟间隔）
• 空状态显示"放心，没有需要记的事"

质量门控

• 验收标准：锁屏上能看到"盐🛒"，通知上点"完成"后消失，Widget 自动更新
• 测试要点：
  • Widget 数据是否正确读取 App Group 数据
  • 完成操作后 Widget 是否及时更新
  • 多条记忆的排序和显示
  • 深链接跳转到主 App

七、D6 — 打磨（UI + 边界处理）

任务清单

• 统一色调：copper (#D4956A) + warm cream + sage green
• 录音按钮动画（按下缩放、松开反弹、录音中脉冲）
• 列表切换动画（spring animation）
• 离线容错：无网络时暂存 transcript，恢复后自动上传
• 错误提示 UI（toast 风格，不 alert）
• 空列表引导文案
• App Icon 设计

质量门控

• 验收标准：整体视觉统一，核心流程流畅无明显卡顿
• 测试要点：
  • 所有页面视觉一致性
  • 动画流畅度（60fps）
  • 离线 → 恢复网络的完整流程
  • 各种错误情况的 UI 表现

八、D7 — 试跑（真实使用）

任务清单

• 安装到自己和 Amy 的手机上
• 真实使用一整天，记录所有问题
• 修复最关键的 bug
• 准备种子分发（TestFlight 或直接安装）
• 撰写简短使用指南

质量门控

• 验收标准：你和 Amy 都在用，至少出现过 1 次 aha moment
• 观察清单：
  • 语音录入的成功率
  • AI 分类的准确率
  • 提醒时机的合理性
  • 整体使用流畅度
  • 电池消耗情况（位置服务）

九、通用质量原则

每次代码变更后

1. 编译通过（无 warning 最好，有 warning 可暂时接受）
2. 在模拟器或真机上运行测试受影响的功能
3. 确认不影响已有功能（回归检查）
4. 向用户展示变更结果

安全检查

• 无硬编码的 API Key（使用环境变量）
• 无硬编码的 macOS 路径
• 用户数据只存在本地（Core Data）
• 云端 API 不存储任何用户数据
• HTTPS 用于所有网络通信（部署时配置 SSL 证书，可用 Let's Encrypt）

代码提交前

• 代码编译通过
• 核心功能测试通过
• 无敏感信息泄露
• 提交信息清晰描述变更内容

十、Phase 2 · 完整体验 — 人格 + 生态（3-4 个月）

核心目标：让用户感受到"这个 App 懂我"。记忆人格系统是实现这个目标的关键。

P2.1 — 种子用户反馈 + Bug 修复（2 周）

• 收集并分类用户反馈（功能缺陷、分类错误、时机不对）
• LLM 分类准确率优化（积累错误 case，迭代 prompt）
• Prompt 版本管理（每次变更记录版本号 + 变更原因）
• 性能优化（App 启动速度、API 响应时间）
• 电池消耗评估（位置服务优化）

P2.2 — 记忆人格系统 v1（3-4 周）⭐ 核心差异化

每个人的「别忘了」都不一样——它通过使用自然养成，不是用户手动设置。

设计铁律：

• ⚠️ 人格对用户完全隐形 — 没有风格标签、设置页面、问卷。用户只感受到"它越来越懂我"，说不清为什么
• ⚠️ 主动关怀纯事件驱动 — 绝不设固定频率推送。每条通知必须由具体事件触发（地理围栏、时间到期、周期触发、高置信度语境关联），不允许 heartbeat 式 check-in

三大支柱：

① 个人提醒风格

• Persona Profile 数据模型（端侧 Core Data 存储）
  • 语气向量：warmth / verbosity / humor / emojiFreq（各 0.0-1.0）
  • 行为模式：高频记忆类型、活跃时段、平均输入长度、完成率
  • 版本号：每次更新递增
• 同一条记忆 → 不同用户看到不同风格的提醒文案
  • 例：买菜 → "家里缺几样东西了" vs "路过超市顺便看看~" vs "盐和酱油该补了"

② 自然养成

• 用户输入风格分析服务（每 N 条记忆后台分析一次）
• 分析维度：输入文本风格、记忆类型分布、时段偏好、完成行为
• 渐进更新 Persona Profile（无感知，用户某天突然觉得"它懂我"）

③ Dynamic Prompt 系统

• System Prompt 从固定模板 → 动态模板 + Persona Context
• 理解模式（transcript → JSON）：不受人格影响，保持客观
• 表达模式（structured memory → personalized text）：受人格影响
• Persona context 注入 API 请求

④ 语境关联（事件驱动主动关怀）

• 新记忆录入时，后台扫描已有记忆做语义关联
  • 例："明天去日本" → 关联到"护照在第二个抽屉" → 出发前自动提醒
• 关联触发需高置信度（≥ 0.8），宁可漏掉也不误触
• 不设固定频率 — 有事件才触发，无事件则安静

质量门控：

• 验收标准：连续使用 2 周后，用户能明确感受到提醒文案"像我"
• A/B 测试：模板文案 vs 人格文案的用户偏好对比
• 隐形检验：用户无法在 App 内找到任何关于"人格"或"风格"的设置入口

P2.3 — Apple Watch 支持（2-3 周）✅

• watchOS App 创建 + WatchConnectivity
• 手表端语音录入（Haptic 确认）
• 手表端提醒显示（极简卡片）
• Complication 表盘组件（显示活跃记忆数）

P2.3b — 记忆检索层（1-2 周）

KNOWLEDGE 类型记忆没有触发条件，用户需要时必须能找到。检索不是对话 — 是回忆。

• 主页搜索框（关键词过滤 displayText + rawText + content）
• Core Spotlight 索引（CSSearchableItem，记忆保存时自动索引到系统搜索）
• 系统搜索结果点击跳转到 Kept 对应记忆
• 记忆更新/删除时同步更新 Spotlight 索引

P2.4 — 视觉主题系统（2 周，Amy 提议）

核心洞察：每天会打开的 App，视觉期待感很重要。主题不是花哨，是让"陪伴感"有更多表达方式。

设计原则：

• 所有主题必须通过九条价值观检验
• 换皮肤只改视觉层（色彩、字体、卡片样式、动画风格），不改交互逻辑
• 默认主题始终可用，新主题作为 Pro 订阅权益

候选主题：

1. 默认 · 温暖铜调 — MVP 主题，copper + cream + sage
2. 二次元 · 柔和手绘 — 淡彩插画风，手绘线条边框，柔和粉蓝配色
3. 小动物 · 自然陪伴 — 每种记忆类型对应一个小动物图标，森林/草地色调
4. 简约科技 · 深色极简 — 深色背景，细线条，微光效果，信息密度更高
5. 复古华丽 · 莫兰迪色 — 莫兰迪配色，衬线字体加重，纸张纹理质感

任务清单：

• Theme protocol 定义（颜色、字体、圆角、动画参数）
• 5 套主题实现
• 主题预览 + 切换动画
• Widget 跟随主题变化

P2.5 — 记忆生命周期（2 周）

• 记忆衰减算法（活跃度 = 创建时间 + 交互频率 + 类型权重）
• 自动归档（30 天无触发 → dormant → archived）
• 记忆回顾（每周/每月摘要推送）
• 人物图谱基础版（高频实体自动关联）
• 记忆聚合（"买盐"+"买酱油"+"买醋" → 购物清单）

P2.6 — 用户系统 + 数据备份（2-3 周）

• Sign in with Apple（轻量级，为 Phase 3 做准备）
• CloudKit 同步（Core Data + CloudKit 容器）
• Persona Profile 跨设备合并（取最新版本）
• 数据导出功能（用户数据主权）

---

十一、Phase 3 · 增长 — 共享 + 市场（6+ 个月）

核心目标：从个人工具变成家庭陪伴层，从种子用户走向全球市场。

P3.1 — 家庭共享 + 跨人格呈现（4 周）⭐

最妙的部分：共享不是"看到对方的列表"，而是"以对方的风格感受到对方的记忆"。

• SharedMemory 协议（memory + fromPersona + status）
• 跨人格文案呈现：Amy 分享的记忆 → 以 Amy 的风格呈现在你手机上
• 视觉区分：不同颜色/头像标识"我的记忆"vs"TA的记忆"
• 家庭成员邀请流程（iCloud Family Sharing 或邀请码）
• 共享权限管理（可选择分享哪些类型的记忆）

质量门控：

• 验收标准：你看到 Amy 分享的提醒时，能感受到"这是她的语气"
• 关键体验：「别忘了」成为家庭成员之间传递记忆的温暖中间人

P3.2 — App Store 全球上架（2 周）

• App Store 审核准备（隐私政策、使用条款）
• 多语言本地化（英/中/日）
• App Store 截图 + 描述优化
• App Store Connect 配置

P3.3 — 订阅付费系统（2 周）

• StoreKit 2 集成
• 订阅方案：Free（基础功能）/ Pro（主题 + 家庭共享 + 高级人格）
• 付费墙 + 7 天试用期
• Receipt validation + 服务端验证

P3.4 — 高级 AI 功能

• Siri 语音查询（App Intents: "护照放哪了？" → 返回匹配记忆，不需要对话界面）
• AirPods 语音提醒（AVSpeechSynthesizer，用 Persona 风格朗读）
• 灵动岛 / Live Activities（实时提醒浮现）
• 记忆关联（向量检索，Pinecone / pgvector）
• 智能时机优化（学习用户对提醒的响应模式）
• 记忆回顾报告（月度/年度摘要，生活足迹可视化）

---

十二、关键里程碑

里程碑	时间点	验收标准
MVP 完成	D7 ✅	核心流程跑通，真机可用
种子验证	MVP + 2 周	10+ 用户持续使用，每人 1+ aha moment
人格 v1 上线	MVP + 6 周	用户能感受到个性化提醒风格
Apple Watch	MVP + 9 周	手表录入+提醒完整闭环
主题系统	MVP + 11 周	5 套主题可切换，Pro 付费就绪
家庭共享	MVP + 5 个月	跨人格记忆呈现体验完整
App Store	MVP + 6 个月	全球上架，英/中/日三语

---

十三、技术债务与风险

已知技术债务（MVP 阶段）

• 地点映射硬编码 → 已升级为 MKLocalSearch (P2.2)
• 无用户系统 → Phase 2.6 解决
• API 无 HTTPS → 部署时配置 SSL 证书
• 无 rate limiting → 上线前添加
• Core Data triggers/entities 存 JSON String → 后期拆关系表

风险预判

• 人格系统冷启动：新用户前 10 条记忆期间无个性化体验 → 用默认温暖风格过渡
• 家庭共享隐私：用户可能不想分享所有记忆 → 细粒度权限控制
• LLM 成本增长：人格文案生成增加 API 调用 → 端侧缓存 + 批量处理
• Apple Watch 电池：频繁通信耗电 → 智能同步策略

---

十四、战略定位

"前端使用极轻，后端构思极巧。这是友商不容易完全 copy 的方式。"

护城河不在 UI（任何人都能做一个漂亮的记忆列表），而在三层不可见的后端智能：

1. LLM 隐含推理 — "洗面奶没了" → 需要买 → 触发地点：超市/药妆店。用户说的和用户需要的之间有一层推理，这层推理是产品灵魂
2. 人格演化算法 — 从使用模式中涌现个性化表达，无需用户配置。用户完全无感知，只觉得"它越来越懂我"
3. 触发时机精准度 — 在对的瞬间出现，而不是打扰。纯事件驱动，零固定频率推送

竞争对手能抄界面，但抄不走 prompt engineering + 用户行为建模 + 人格演化的组合。