喂养记录 · 健康陪伴 v1.62.1 ♥
用心记录每一餐，守护 TA 的每一天。猫档案、照片、体重、绝育状态、推荐摄入量和每日进度，都在这里。当前版本：1.62.1。
❤ 小贴士
定时定量喂食，记录体重与食欲变化，更容易发现异常。
今日喂食
🕘--:--
记录后自动更新
喂食量
0 g
目标未设置
今日按猫统计
多猫家庭不再显示“全家总推荐摄入量”，避免把不同猫的进食混在一起。请看右侧每只猫自己的今日进度。
今日已记录 0g
猫档案数 0只
当前猫档案概览
提示：点击下方猫咪档案卡片可切换当前猫；“更新档案”只是保存当前猫的信息。
切换猫咪
这里仅用于切换当前猫，不做编辑/删除。猫档案管理请到左侧“猫档案”页。
手机扫码访问
电脑和手机连接同一个 Wi-Fi 后，用手机扫下面二维码即可打开登录页面。
二维码会自动生成。若手机打不开，请确认手机和电脑在同一 Wi-Fi，并允许 Windows 防火墙专用网络访问。
异常提醒
猫档案管理
新增、编辑猫档案和推荐摄入量都在这里。点击下方档案卡片可切换当前猫，点击“更新”会把资料带回表单。
猫档案列表
体重历史
记录管理
新增、编辑和保存喂食记录都在这里；其他页面不再显示记录表单，避免挤占空间。
喂食记录
| 时间 | 猫名 | 数量 | 类型 | 状态 | 备注 | 操作 |
|---|
数据统计
按猫统计今日摄入
按自然日“今天”统计，适合判断今天是否接近日推荐量。
按猫统计24小时内摄入
按当前时间往前 24 小时滚动统计，适合看昨晚到现在是否突然少吃。
近7日饮食回看
范围为昨天起往前 7 天，不包括今天。用于快速查看每只猫每天吃了多少、热量是否接近日推荐值，避免只能看“今日”而不方便回看昨天。
| 日期 | 猫名 | 进食量 | 热量 | 日目标 | 完成度 | 次数 | 判断 |
|---|
自动喂食器
上传手机米家自动喂食器截图，AI 读取里面的时间和克数。识别出的只是“出粮/记录克数”，你需要根据对应时间查看监控，选择是哪只猫，再转成正式喂食记录。
截图识别
需要在 AI 页面填写“图片识别 AI”，并选择正确的接口类型，再使用支持图片输入的模型。识别结果建议人工校对。
系统会先在浏览器内压缩截图（最长边约 1200px，JPEG 质量约 0.72），再上传给本地服务和 AI，手机端多图会更快。
只校验并导入“宠物进食 Xg”。“计划出粮 X份 / 手动出粮 X份”不会保存进事件列表。若合计不同，说明截图识别可能漏读/误读，系统不会自动导入。
尚未识别截图
待确认事件
确认或转记录后会自动从默认列表隐藏；昨天及更早的已处理事件会自动清理，避免越堆越多。
AI 饮食分析
AI API、图片识别 API 和 Key 已移动到“设置”页统一管理。这里仅保留分析范围、分析对象和补充要求。AI 对话会保存在本地 cat_data/ai_sessions.json，重开程序后可以继续说明；也可以给每段对话单独命名，避免记混。
“最近24小时”用于看从昨晚到现在是否突然少吃；“昨日 / 最近3天 / 最近7天”按自然日统计，更适合和每日推荐热量对齐。
AI 未运行
分析结果会显示在这里。
继续和 AI 说明情况
先完成一次 AI 分析后，可以补充情况或继续追问。当前会话会保存在本地；新建独立对话后，旧对话不会被污染。
AI 交流内容会显示在这里。
设置
程序设置集中放在这里。你想长时间挂着程序时，建议关闭“自动退出”，并把心跳间隔设短一点，例如 60 秒。
程序运行与心跳
说明：如果你经常把程序挂着，建议关闭自动退出和页面关闭即退出。心跳间隔越短，后端越不容易误判前端断开。
AI API 设置
开启会多调用一次 AI 进行校对；关闭则更快、更省费用。
这段话会在每次 AI 分析和继续交流时自动发给 AI。填完后点击“保存 AI 设置”或“保存程序设置”都会保存。
API Key 会保存在本地 cat_data/ai_settings.json，仅供本机调用。可分别设置“数据分析 AI”和“图片识别 AI”，也可以勾选共用同一套设置。图片识别 AI 还可以选择“接口类型”，用于适配 OpenAI 兼容接口、OpenAI Responses 或火山方舟 Responses。AI 分析会进行二次校对，只用于记录辅助，不替代兽医诊断。
数据分析 AI
图片识别 AI
如果你用的是 OpenAI 官方或支持 image_url 的兼容接口，选第 1 个；如果是 Responses API，选第 2 个；如果是豆包/火山方舟图片模型，优先选第 3 个。
数据保存说明
数据会在你第一次保存记录时生成到本程序同目录的 cat_data 文件夹中，包括 cats.json、records.json、food_types.json、feeder_events.json 和 images / feeder_images 图片文件夹。运行与心跳设置可在设置页调整；建议长期挂着时关闭自动退出。
清理未使用照片仅依据猫档案照片字段判断；当前喂食记录不包含照片。食物记录会同时保存 foodTypeId 和食物名称；为兼容旧记录，显示时优先使用名称。导入备份会增量覆盖 ZIP 中存在的文件，ZIP 中缺少的文件会保持不动；图片会按 images 内相对路径合并；如果备份包含 users.json，会覆盖当前账号列表，请确认至少保留一个管理员账号。多次导入会产生 before_import 备份文件，确认数据正常后可点击“清理旧备份文件”。