作者Alun

自律星球:Flutter 与 DeepSeek API 应用原型

从计划生成、每日记录到原型能力边界

AI应用智能体平台健身应用DeepSeekFlutter开发
自律星球:Flutter 与 DeepSeek API 应用原型
题图

自律星球尝试解决一个很日常的问题:想开始锻炼,却常常卡在“今天练什么”,或者有了计划,过几天又忘了记录完成情况。这个原型把计划生成和每日记录放进同一个 Flutter 应用里,希望让“看完建议”和“实际做完”之间少一些切换。

它的流程并不复杂:填写基础资料,请 AI 生成计划,自己确认后逐项执行,再留下完成状态和体重记录。本文按公开代码与原有截图介绍这条流程,也讨论从一个能演示的原型走到可靠应用,还需要补哪些工程细节。

1. 实现依据与范围

公开仓库说明应用使用 DeepSeek Chat API,客户端以 Flutter 构建,数据通过 SharedPreferences 在本地持久化。原文称“基于 KwaiKat 平台运行”,缺少对应运行链路证据,不能用来解释当前公开代码。

已有功能包括计划生成、训练项目勾选、体重记录与 AI 分析。本文不再把即时自动调整强度、食谱、强化学习训练曲线等设想写成已经验证的能力。用户反馈进入下一次提示词,也不等于重新训练模型或强化学习。

AI 负责建议,应用负责记录

这两部分应该分开理解。生成计划是一轮联网请求,结果可能每次不同;勾选完成项目和保存体重,则是应用自身维护的数据。如果把二者混在一起,用户重新生成一次计划,就可能发现已经完成的记录不见了。

更容易理解的产品关系是:AI 给出候选内容,用户决定采用哪一份,应用再围绕已采用的计划记录执行情况。当前原型展示了这些环节的入口;正式使用时,还需要明确计划替换、历史保留和分析数据范围。

2. 使用流程

  1. 在设置页录入身高、体重、出生年份、性别,并配置接口凭据。
  2. 联网生成当日计划,查看输出后再决定是否采用。
  3. 勾选完成项目、记录体重,保留每日记录。
  4. 需要时请求 AI 分析;已经保存的本地记录与需要联网生成的新内容应区分。

出生年份只能得到粗略年龄。四项资料也不足以判断真实体能、伤病与动作适应性,生成文字的合理性仍需评估,不能凭“个性化”名称承诺安全或效果。

从用户角度看,这条流程应当能回答三个问题:今天要做什么、已经做了什么、哪些记录以后还能找回来。生成文本只是开始,后面两件事才决定这个工具能不能持续使用。

举个例子,用户已经完成两项训练,晚上再次打开应用。这时更有用的是恢复原来的勾选状态,而不是重新生成一份看起来更丰富的计划。到了分析页面,也应区分用户自己录入的记录和 AI 对记录的解释,避免把一次生成的建议显示成已经发生的事实。

3. 原型界面

下面用原型的四张界面截图,顺着设置、查看计划、生成内容和回顾分析的过程看一遍。截图保留的是当时的界面,安装时以对应发布版本为准。

设置页

设置页集中填写基础资料与接口配置。把这些字段放在一处,能减少每次生成前重复输入的负担,但也要考虑修改资料以后会影响什么。例如更新体重后,新的请求可以使用新数据,历史记录仍应保留当时的值,才方便回头理解变化。

自律星球设置页,包含基础资料与已隐藏的接口凭据

每日计划

每日页把计划内容与完成状态放在一起,用户不必在一长段聊天里寻找训练项目。这里最值得打磨的是动作后的反馈:点完有没有保存、重新进入是否还在、误点后能否改回来。它们看起来比生成能力普通,却直接决定记录是否可信。

自律星球每日计划与完成状态界面

计划生成

生成页承接一次有等待时间的操作。点击后应让用户知道请求还在进行,失败时也要保留已输入的资料,避免为了重试再填一遍。生成成功后,最好允许先阅读再确认采用,而不是立即把已有计划替换掉。

自律星球计划生成结果界面

分析界面

分析的价值在于把分散记录组织成容易回顾的说明。它需要有清楚的输入范围:分析的是今天、最近几天,还是所有记录?缺少这个范围,一段语气肯定的文字也很难判断是否有根据。截图展示了分析入口与输出,具体结论仍要回到用户真实记录核对。

自律星球 AI 分析结果界面

4. 原型之外还需补齐什么

生成式接口可能超时、返回不完整数据或不符合预期的计划。下一步应检查结构化输出的字段和数值范围,提供加载、错误与重试状态,防止同一天重复请求覆盖用户已勾选的记录。

本地持久化不等于加密存储。接口凭据、请求中携带的身体资料、备份与清除机制,应在正式发布前明确设计;调试日志不应包含凭据。平台目录存在也不等于已完成各设备的发布测试。

先把一天的记录做好

如果继续推进这个项目,我会先把“一天”作为最小闭环来检查:新的一天怎样开始,昨天的计划在哪里,同一训练项目勾选两次会怎样,生成失败后本地数据是否仍然完整。每个问题都能落到明确的界面行为,比同时增加很多生成入口更容易验证。

数据结构也应围绕这个闭环设计。日期、计划内容、完成状态和体重各有自己的含义,不适合全挤在一段生成文本中。将确定的数据字段保存下来,把 AI 说明作为附属内容,后面做趋势图或导出时才有稳定依据。这是后续设计建议,不表示当前版本已经完成这套改造。

5. 后续方向

食谱、趋势图、语音输入等作为待验证方向保留,先完成数据与错误处理,再评估新的功能。本文记录原型组织方式与工程限制;安装要求和具体能力以对应发布版本为准。

评论