Use when the adult weight-management MCP needs to be installed/set up in WorkBuddy (connector) or its result must be rendered as a standalone Chinese HTML plan.
Scanned 9/12/2026
Install to Claude Code
Skills Directorynpx -y skills add ahang1598/doubao-workbuddy-qwenwork-skills --skill skills --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of weight-management-html?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/ahang1598-weight-management-html)More formats (shields.io, HTML) on the badges page.
---
name: weight-management-html
display_name: 体重管理报告生成
category: writing
version: 1.0.1
author: 微脉技术有限公司
description: "Use when the adult weight-management MCP needs to be installed/set up in WorkBuddy (connector) or its result must be rendered as a standalone Chinese HTML plan."
---
# 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`，保留已有服务器、不得覆盖其他配置：
```json
{
"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. 上传命令（`<本地图片路径>` 替换为用户提供的本地图片绝对路径）：
```bash
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](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](assets/template.html)：产品 HTML/CSS/交互基线；只在渲染或视觉检查需要时读取。
- [scripts/render_plan.py](scripts/render_plan.py)：确定性 JSON→HTML 渲染和结构校验；优先运行脚本，不要手工重写模板。
- [references/mcp_setup.md](references/mcp_setup.md)：仅在服务端 MCP 未配置或需要联调时阅读。
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
