CASE / 02SwiftUI · LLM 集成 · 多平台产品
WordScene / 译笺
让一次翻译沉淀为可复用的个人语言资料库。
01 / 项目概览
职责独立 iOS / macOS 工程师
重点产品架构 / LLM 集成 / 同步
技术栈Swift 6, SwiftUI, DeepSeek API, Core Data, CloudKit
项目语境采用 GPL-3.0-only 的开源语言产品
02 / 产品证据
来自真实产品构建的界面证据。
这些截图来自 WordScene 仓库随附的 1.0.4 发布素材，不是为作品集重新绘制的概念稿。
03 / 问题背景
多数翻译结果是一次性的：解决眼前句子后，就从学习与使用流程中消失。WordScene 将翻译、检索与复用放进同一套原生工作区，而不是把它们拆成彼此割裂的工具。
关键约束
01用户自备 API 凭据的安全存储02结构化流式输出03iOS 与 macOS 共享代码库04可选云同步0518 种目标语言04 / 系统方案
用清晰边界组织模型访问、数据持久化与系统分享能力。
01SwiftUI 工作区自适应界面
02DeepSeek ProviderSSE + JSON
03Core Data / CloudKit持久化
04Share Extension系统入口
01
Provider、Keychain 凭据、本地持久化、可选 CloudKit 同步与分享交接分别封装，使每类故障都能被独立定位。
05 / 技术挑战
01
可预测的模型输出
在接收 SSE 流式响应的同时增量提取严格 JSON 翻译结果，并将 Provider 错误转化为可操作提示。
02
凭据边界
将用户 Token 存入 Keychain，并限制扩展访问范围，避免在应用中硬编码秘密。
03
可持续的语言记忆
以 Core Data 统一收藏与近期历史，同时处理迁移、搜索、导入导出及可选 CloudKit 同步。
04
系统级入口
通过 iOS Share Extension 翻译外部分享文本，并复用主应用工作流处理剪贴板提示。
06 / 项目结果
只陈述有证据支持的结果。
能力描述均已对照 1.0.4 公开 main 分支核验，并以 GPL-3.0-only 发布；不虚构用户量、准确率或商业指标。
01支持 18 种翻译目标语言仓库已核验
02原生 iOS 与 macOS 双端目标仓库已核验
03Share Extension 与剪贴板入口仓库已核验
04192 项 iOS 单元测试通过仓库已核验