Weight Management HTML

Weight Management HTML

将体重管理 MCP 的结构化结果渲染成产品要求的独立 HTML。MCP 是事实来源，客户端 Skill 负责呈现，不要复用系统已有体重管理智能体或自行改写安全边界。

MCP 服务端连接

调用工具前先检查 generate_weight_management_plan 是否已经可用：

• 已可用时直接调用，不重复安装或覆盖客户端配置。
• MCP 必须调用用户部署的服务端接口，不得运行本地脚本模拟工具、绕过 MCP 协议或直接复刻服务端生成逻辑。
• 服务端地址：https://ichoice.myweimai.com/weimai-gpt/mcp（用户提供的公网 Streamable HTTP endpoint）。若用户明确要求本地联调，再以启动日志/API_PORT 为准使用本地地址。
• 客户端尚未配置 MCP 地址时，配置为以 /mcp 结尾的 Streamable HTTP URL；公网地址只能使用用户提供的真实域名，不得猜测。
• 项目中的 mcp Python 依赖只属于服务端部署环境；即使本地存在依赖，也不能把本地脚本作为远程服务不可用时的降级实现。
• 配置后先做 MCP initialize、tools/list，确认只发现 generate_weight_management_plan；再用空的 user_input 做无模型 smoke test，确认返回 need_more_info。

在 WorkBuddy 中安装/配置 MCP 工具

当当前会话工具列表中看不到 generate_weight_management_plan 时，引导 WorkBuddy 安装 MCP 连接器（不要跳过；也不要用 curl 或本地脚本替代工具调用）：

1. 读取 ~/.workbuddy/mcp.json（注意是 mcp.json，不是 ~/.workbuddy/.mcp.json）。

2. 把以下条目合并进 mcpServers，保留已有服务器、不得覆盖其他配置：

   {
     "mcpServers": {
       "generate_weight_management_plan": {
         "type": "mcp",
         "transport": "streamable_http",
         "url": "https://ichoice.myweimai.com/weimai-gpt/mcp",
         "disabled": false
       }
     }
   }
   

   • 默认使用 https://ichoice.myweimai.com/weimai-gpt/mcp。
   • 公网地址只能使用用户提供的真实 HTTPS 域名，不得猜测或使用示例地址。

3. 写回后必须告知用户：新 MCP 不会自动激活，请用户在连接器管理页右上角「自定义连接器」入口对该服务器点击「信任」启用。

4. 用户确认信任后，重新检查 generate_weight_management_plan 是否出现在工具列表；可用后再按下方 Workflow 调用。

本地图片转在线 URL（图片床）

用户上传本地餐食图片时，必须先调用图片床上传接口把本地路径转成在线 URL，再把 URL 传给 MCP 的 image_urls：

1. 上传命令（<本地图片路径> 替换为用户提供的本地图片绝对路径）：

   curl --request POST \
     --url https://caregpt-api.myweimai.info/image_bed/upload \
     --header 'Content-Type: multipart/form-data' \
     --header 'x-weimai-business-type: hongfangzi' \
     --header 'x-weimai-origin: Weimai-H5' \
     --form 'file=@<本地图片路径>'
   

2. 校验返回 JSON：仅当 code == 0 视为上传成功，取 data.image_url 作为该图片的在线地址（HTTPS）。

3. 失败处理：code 非 0、网络错误或超时时，向用户原样展示 msg/错误信息，可在不改动输入的前提下重试一次；不得把本地路径、相对路径或猜测的 URL 传给 MCP。

4. 只上传用户明确作为餐食照片提供的本地图片文件，不要上传其他文件或批量扫描目录。

5. 上传得到的 image_url 仅用于本次 MCP 调用，不要持久化保存或复用到其他会话。

Workflow

1. 调用已配置的 Streamable HTTP MCP Server 的 generate_weight_management_plan 工具。
   • 必传 user_input：保留用户原始请求；用户补充资料时，把原始请求和补充内容一起发送。
   • 可选 image_urls：只传 HTTPS 餐食照片 URL 列表。用户提供在线 URL 时直接使用；提供本地图片时，必须先按「本地图片转在线 URL」上传，使用返回的 data.image_url，不要把本地路径直接传给 MCP。不要下载后持久化，也不要把照片当作非餐食内容猜测。
2. 若客户端支持 MCP progress notification，实时展示消息中的逐段方案正文；最终以工具返回的完整 structuredContent 为准。
3. 按状态处理：
   • ready：把 data 保存为临时 JSON，运行 scripts/render_plan.py --input <json> --output <html>。
   • need_more_info / clarify：原样呈现 questions，向用户补问；不补默认值，不生成完成版 HTML。收到补充后重新调用 MCP。
   • refused：原样呈现 safe_message 和 next_step；不得绕过拒绝或自行提供减重方案。
   • error：呈现稳定错误文案；必要时在不改变输入的前提下重试一次。
4. 渲染成功后检查 HTML 无 {{...}} 未替换占位符、包含 <!doctype html>、<style>、<script> 和 13 个产品章节，并确认体重记录器区域含 id="historyBody" 历史表格与「清空全部记录」按钮、各章节「本次个性化建议」中的表格已渲染为 <table>；完成后用 present_files 打开绝对路径预览。

Rendering rules

• 必须使用 assets/template.html 作为视觉基线：保留响应式 CSS、指标卡片、三阶段内容、每周清单、体重记录器、本地 localStorage 和安全边界。
• scripts/render_plan.py 只把 ready.data 的 profile、metrics、timeline、phases、sections、checklist、weekly_review、safety_boundary 和可选 meal_analysis 注入模板；模型正文按章节作为“本次个性化建议”追加，不能覆盖程序计算的 BMI、BMR、热量区间和周期。
• 数值占位符强制校验（防 script 注入与除零）：render_plan.py 对所有数值占位符（体重、BMI、BMR、热量区间等）执行严格数值校验，非数值/非有限数直接抛 RenderError 拒绝渲染，不做 HTML 转义降级（HTML 转义对 <script> 上下文无效）；planned_loss_kg、current_weight_kg 必须为大于 0 的有限数值（进度条 JS 计算依赖），{{CURRENT}}/{{LOSS}} 以无千分位纯数值字面量注入，模板侧对 plannedLoss <= 0 另有兜底。渲染报错时原样向用户展示错误并按 MCP 状态处理规则重试或重新调用，不要手工改写 HTML 绕过校验。
• 体重记录器（weight_tracker）是模板内置的交互式组件，不注入模型示例表格：render_plan.py 对 key == "weight_tracker" 的章节跳过“本次个性化建议”注入；该区域自带日期/体重输入、「保存本次记录」按钮（保存后立即刷新历史列表）、进度条、历史记录表格（日期/体重/较上一条/删除）、最近 5 条平均统计和「清空全部记录」按钮，数据只存浏览器 localStorage。
• 模型正文的 Markdown 渲染器（_render_markdown_fragment）支持：| 开头的表格（含 |---| 对齐行，渲染为 <table>，自动包 .table-wrap 以支持横向滚动）、- 列表、###/##/# 标题、**加粗** 与 `行内代码`；正文必须按安全 HTML 转义后再放入页面，不要直接执行或插入模型生成的 HTML/JavaScript。
• 有餐食照片时保留热量范围、不确定的油/酱汁/糖/坚果/乳制品/分餐因素和低摩擦调整；不要写补偿性断食或惩罚性运动。
• 页面明确标注这是健康教育建议，不是诊断、处方或医疗承诺；急症、诊断、用药变化和需要医生监督的情况交给合格专业人员。
• 页面中的打卡和体重记录只使用浏览器本地 localStorage，不要上传或写回 MCP Server。

Supporting resources

• assets/template.html：产品 HTML/CSS/交互基线；只在渲染或视觉检查需要时读取。
• scripts/render_plan.py：确定性 JSON→HTML 渲染和结构校验；优先运行脚本，不要手工重写模板。
• references/mcp_setup.md：仅在服务端 MCP 未配置或需要联调时阅读。