2026年山东大学软件学院创新项目实训博客-项目博客（一）
一、工作进展
本阶段为项目启动后的首周，团队在产品形态、端侧与智能层、工程协作方式上同时开工，目标是把「一站式 AI 健身助理」从概念落到可演进的代码骨架，而不是在任意单点堆满功能。
产品侧：明确 MetalCat 面向健身新手的定位，采用「左侧展示区、右侧统一对话区」的并列结构；展示区内按四块能力组织信息（身体数据、训练、营养、发现），用户以自然语言为主入口，减少「功能藏在哪里的」学习成本。
前端开发模块：在单页应用内完成与上述信息架构一致的主导航、总览与四模块入口，将全局对话挂在布局层；桌面与窄屏共用同一路由，在约定断点处分叉为双布局，避免对话入口在小屏上被边缘化。认证与网络请求以最小形态跑通流程，为后续协议稳定后再实装预留空间。
后端开发模块：完成服务端分层骨架与工程约定，确定异步 Web 框架、关系型数据库与无状态鉴权的大方向，并只落地与账号强相关的首表设计，业务表随需求澄清再增，避免启动期过度建模。
Prompt 工程相关：在 Python 侧引入可组合的模型调用与编排基础，用「单条链路先跑通、输出可被程序消费」约束替代一上来就做复杂多智能体；按场景拆分提示职责，统一输出形态，为后续与调度、业务服务对接留出接口。
Agent 架构与协作流：建设文档驱动的协作范式——项目级说明、需求与架构文档矩阵、可重复的需求拆解到实现流程；将面向测试的质量要求适配为可执行的验收描述，并沉淀可复用的开发技能，使多人并行与工具辅助有共同语言。
二、详细内容
1. 产品形态与分工界面
产品刻意选择「需要被引导的新手」而非仅服务资深训练者：后者偏工具，前者更需要对话式建议与可执行的下一步。四块展示能力对应数据可见性与模块边界，而对话区作为统一操作面，让「说一句话完成记录或查询」成为主路径；拟人化形象与稳定语气被视作降低心理成本、提高粘性的产品策略，与冷冰冰表单形成对比。
多模块之间存在数据依赖（例如营养与身体指标、训练强度与体成分），但首周不展开跨模块实装细节。共识是：调度、工具与业务服务的边界由专门模块演进，本阶段只保证端、后端、智能层在文档与目录职责上不打架。
2. 前端：信息架构落实为可运行壳
技术选型在开发体验与一期复杂度之间折中：现代前端构建、类型化脚本、成熟组件库与工具类样式分工；路由与应用壳负责「去哪」，页面以拼装为主，跨页能力放入功能模块，远程调用集中在服务层，全局状态保持轻量。一期不急于引入重型的服务端状态缓存库，待接口与缓存键策略稳定再评估，避免与尚未锁定的协议强耦合。
响应式上采用同一路由、双套壳，并在脚本侧与断点规则上与对话区表现对齐，比单棵复杂 DOM 上硬拗样式更易维护。登录态与请求头、环境相关的基址配置先行固定形状，把「怎么证明身份、失败如何重试」留到契约定稿后实现，与「协议未稳不做深度绑定」原则一致。
3. 后端：框架、数据与账号基础
框架：在同步全家桶、轻量微框架与异步 Web 框架之间，优先匹配 IO 密集、等待模型与外部服务占比高的特征；在自带校验与可观测接口的前提下，用可控的抽象换吞吐与可维护性。
数据库：选用对半结构化与聚合查询友好、并能为后续检索增强与向量能力提供一体化路径的方案，减少「业务库一套、检索再一套」的运维面。
鉴权：在无共享会话存储与可水平扩展之间选择令牌方案，并认知其不可服务端单方面吊销的代价，用短周期与可演进字段策略控制风险；与首周只实现账号表、不把业务与权限绑死的节奏一致。
分层与规范：网络入口、业务模块、基础设施分层单向依赖，降低替换成本与协作冲突。工程约定抓要点而非细到难以执行，例如提交信息约定、公共接口的类型与文档、响应形态一致，减少口头对齐。
表设计策略：只建设当前确定必需的账号表，不提前画全 ER；业务表随模块范围清晰再落地，与敏捷、探索型产品相匹配。
4. 智能与 Prompt：先链路，后协同
多智能体是目标形态，但启动期若先拼调度，会假设各域接口与数据结构已稳，易返工。首周更合理的重点是一条最小可用的「理解—编排—结构化—准备分发」链：自然语言先归一化为意图与槽位，不同场景用不同提示约束，输出优先保证机器可解析、界面可映射，人读的自然语言置后。
场景拆分能隔离故障面：某域提示迭代不影响其他域。对缺失信息要求追问而非臆造字段，在链路层面降低脏数据进入业务层的概率。编排层与「调度中心、业务服务」的边界明确：本部分偏理解与规范化，不代替后续路由与执行。
在「手写裸调用、重型智能体框架、中等抽象的中间层」之间，选用抽象适中、可逐步加解析与工具扩展的一方，使问题定位沿链路分段进行，避免逻辑散落在脚本中无法复盘。
5. Agent 架构与工程化协作
传统「先建目录再写码」在多人、多智能体、需求变更频繁时沟通成本高。本阶段建立的是文档即上下文：项目说明面向人与辅助工具，产品现状与接口约定集中维护，需求以可审阅的记述与可验证的期望行为成对出现，设计再拆为可执行的任务。由此形成可重复的「捕获—拆解—设计—实现—归档」节奏。
质量上延续测试思维，但把「红」阶段先落在可读的行为描述与验收标准上，再进入生成与实现，在约束明确的前提下用工具链落地，最后在保护下重构而非一次性追求完美生成物。
可复用技能将上述步骤封装为可组合动作，并考虑多类开发辅助工具共用，减少「每人一套咒语」的治理成本。整体取向是通用流程与可替换工具 rather than 绑定在某一厂商专用智能体框架上，以保持演进空间。
6. 各模块的衔接方式（首周视角）
- 展示与对话的衔接由前端统一布局与全局对话装配件完成，业务数据与卡片映射后续由结构化结果驱动。
- 自然语言到结构化结果由 Prompt 侧先行规范，后端在首周不强行假设已有多域完整接口。
- Agent 架构文档与流程为后续父级调度、子域执行与工具体系提供约束面，与后端分层、前端的壳层边界并行生长，避免某一侧偷偷承担全部业务判断。
三、总结
首周工作的共同主线，是在不稳定的协议与需要稳定的协作规则之间做平衡：产品方向与信息架构要足够清晰以支撑多线并行，实现上则刻意克制，把深度绑定推迟到需求与接口收敛之后。
可归纳的几点共识：
- 产品：新手导向、展示与对话双区、四域能力分块展示，多模块数据依赖在架构上留口、实现上分阶段。
- 端与服：同构路由、响应式分壳、轻状态与先占位后实装的请求与鉴权；服务端异步栈、可演进数据与无状态鉴权、分层与渐进式建表。
- 智能与协作：先跑通可解释的结构化链路再谈复杂多智能体；文档驱动、可验证需求与可重复流程，把质量与维护性前移到协作方式里。
后续阶段将在此骨架上补全各域业务、联调、调度与工具体系。