ELEMENTAL / ENGINEERING NOTES

原生记录,
与能使用这些记录的 Agent。

记录有来源,操作有边界,对话能够接续。Elemental 把这些要求放在同一套本机系统里。

THE REQUEST / 01—04
  1. 01你提出问题
  2. 02模型选择工具
  3. 03查询或受控写入
  4. 04核对结果与来源
架构图:iPhone App 与墨提斯共用 ElementalCore 规则;记录与回执保存在本机 SQLite,原件保存在 App 私有文件存储;只有墨提斯会在单独的资料外发许可后访问服务商。
界面与 Agent 共用同一套本机存储与正式命令。只有墨提斯会跨过网络边界, 而且必须先经过单独的资料外发决定。
01 / 设计原则

界面与工具,共用同一套记录

SwiftUI 负责录入、校对、浏览与对话。ElementalCore 保存平台中立的规则;App Group 内的一个 GRDB/SQLite 数据库保存记录、来源关系与对话,原件则放在 App 私有的文件存储里,由稳定标识引用。没有 Elemental 账号、开发者服务器,也没有分析 SDK。界面和可选的墨提斯助手使用同一套仓储与正式命令,因此计划不会变成实际服用,跳过不写服用事实、不扣减库存,报告对照也保留原始值,只描述记录,不解释数值为什么变化。Apple 健康是独立的只读投影;缺少读数不会被当作 0,清除本机缓存不会撤销系统授权,也不会回写数据。

对话与当前整理检查点也保存在这套本机系统里;有新信息时可以重新打开继续,较长的模型上下文可能压缩,应用进入后台后运行停止,可用的来源引用只在当前轮有效。导出会生成一个可携带的资料包,包含受支持的记录与可读取的原件,缺失文件逐项列明;完整对话、Apple 健康缓存与凭据不在包内,它也不是可导回恢复的数据库备份。Elemental 不运营云端同步服务。

产品标签与检验报告在本机识别:Vision OCR 与规则解析,支持的设备可选使用 Foundation Models 增强。原件先归档再读取,核对屏会标出低置信度、未披露含量、不支持的单位和非法数值;未披露含量永远不会存成 0。只有墨提斯会把记录或附件发给服务商,而且必须先获得单独的发送许可:聊天中的照片与 PDF 页面处理为遮盖后的图片(遮盖可能遗漏信息),TXT 与 Markdown 脱敏,CSV 与 JSON 不被接受;在本机保留原件是可选项且默认关闭,原件本身从不发送。删除本机数据,也抹不掉服务商已经收到的副本。

02 / 设计原则

模型选择步骤,写入经过检查

用户配置的模型可以多轮调用工具,读取执行结果,再决定下一步。读取工具可以打开记录、读取检验结果、对照报告;时间与计算工具也能服务普通问题。「逐次批准」会在每次工具调用前询问,读取也不例外;「完全访问」让受支持的工具直接运行。发送许可始终是另一个决定,被拒绝的调用不能换一个工具绕过。针对 DeepSeek 模型服务的可选联网搜索默认关闭,只调用一个固定搜索端点,返回的网页按不可信的公开数据处理;搜索词可能包含对话内容。

1.7 把写入扩展到修改与整理:墨提斯可以修改产品资料、生活背景、身体指标、服用记录、检验结果和报告资料;永久删除五类记录——一条生活背景、一项身体指标、一条服用记录、一条检验结果或一整份报告;归档或恢复产品;以及设置未来的服用计划(每日、指定星期、每 N 天、按需),只影响生效日之后的安排。删除批准会显示被删记录,并说明删除永久生效、没有回收站;归档则保留产品历史。每次写入都是类型化命令。提交前会核对当前权限与并发 token,事实与回执在同一个事务里提交;同一操作、同一内容重试返回既有回执,不会写两次;过期的编辑令牌会被拒绝;重放不能复活已删除的记录。

墨提斯的记忆是记录体系中可见、可编辑的一部分,不是隐藏画像。记忆在设置中可见,随导出包含,提问时按确定且有上限的规则选取。删除一条记忆后,它不会再进入后续提问;它所指的记录不会被一并删除。

03 / 验证

验证

一次服用记录会影响库存、记录历史以及之后的报告,所以测试针对的正是这些关联:同一份数据经不同功能读取,同一次写入被重试或中断。

  • Core 领域规则 —— 492 项:记录、库存与报告规则、 Agent 循环、安全边界与写入契约。
  • App 单元/集成 —— 2,110 项:GRDB 持久化、服务层、 Agent 工具与审批、附件、导出、通知、Widget、HealthKit 只读与 OCR 复核。
  • UI 自动化 —— 150 项:Today、Library、Metis、 设置与无障碍流程。

2,752 项测试全部通过。

Elemental 1.7 已在 App Store 上架:基础记录不需要账号,墨提斯是可选功能,使用你自己准备的兼容服务商、API 密钥和模型。

走进 Elemental