这个品类的数据长什么样
小家电收益率与行情数据主要来源于智能小家电的内置能耗采集模块、家庭智能电表的同步数据，以及对应品类的能效备案公开信息。数据更新节奏为每日凌晨完成前一日全量数据汇总，生成单设备单日的收益报告。单份数据文档包含设备唯一标识、设备型号、当日累计运行时长、当日节能收益金额、当日用电成本节约额、所属能效档位共6个核心字段。字段单位中，运行时长以小时为单位，收益金额以人民币元为单位，能效档位以大写英文字母标识。
这些特征在「分享与嵌入」这一环带来什么约束
小家电收益率数据的每日更新节奏，要求嵌入组件需配置每日凌晨的数据源同步任务，确保展示内容与官方汇总数据保持一致，避免出现数据滞后。单份数据包含多字段且单位差异明显，嵌入时需针对金额、时长等字段分别配置格式转换规则，确保展示可读性。设备唯一标识作为数据匹配的核心参数，嵌入调用时需传递正确的设备ID，否则无法加载对应设备的收益数据。能效档位的文本标识需提前完成映射转换，嵌入展示时不得直接输出原始编码内容。另外，单设备单日数据的文档体量较小，嵌入组件无需配置大缓存机制，但需限制单请求返回的文档数量，避免加载冗余内容。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
iframe_custom_css | body { font-size: 14px; padding: 12px; border-radius: 8px; } | 适配小家电收益数据的短文本展示需求，避免默认样式导致的排版溢出 |
data_cache_ttl | 86400 秒 | 匹配小家电数据每日更新的节奏，确保缓存与官方数据同步周期一致 |
api_request_timeout | 30 秒 | 适配多设备数据拉取的响应时长，避免因数据来源分散导致请求超时 |
share_expire_days | 7 天 | 满足理财场景下的短期数据分享需求，平衡安全性与复用性 |
share_show_original | 关闭 | 小家电收益数据多为内部运维或家庭使用场景，无需展示原始文档入口 |
pass_user_id_param | user_id | 支持透传调用用户标识，适配MCP Server的身份获取需求 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：嵌入的iframe组件样式无法按照预期修改，页面出现溢出或排版混乱。原因：未正确配置
iframe_custom_css参数，或自定义CSS代码存在语法错误，未覆盖默认样式。 - 现象：免登录分享链接访问应用时，即使关闭了
share_show_original设置，仍显示查看原文按钮。原因：FastGPT版本低于4.9.6，该版本修复了免登录场景下的配置同步问题，旧版本配置未生效。 - 现象：MCP Server无法获取到调用用户的userid标识。原因：未配置
pass_user_id_param参数，或传递的参数名与FastGPT设置不匹配，导致用户身份信息未正确透传。
怎么确认配好了
- 打开嵌入组件的预览页面，检查样式是否符合预期的字体、边距和圆角配置，确认自定义CSS生效。
- 等待一个完整的数据更新周期后，查看嵌入组件展示的收益数据是否与官方汇总数据一致，确认缓存配置正确。
- 尝试传递不同的设备ID参数，检查组件是否能正确加载对应设备的收益数据，确认设备ID匹配逻辑正常。
- 调用关联的MCP Server接口，检查是否能获取到当前调用用户的userid标识，确认用户身份传递配置生效。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。