主题
M10 管理者月度运营报告（Demo 场景 PRD）
| 项 | 内容 |
|---|---|
| 文档定位 | 08_移动端AI场景设计.md §10 管理者模块中反引号标记的 demo 模块的场景 PRD。写法依据见 公共规范.md §8 |
| 通用 demo 规范 | 前端形态、常驻会话、系统提示词边界、定时任务方式、数据与输出规范见 公共规范.md；本文只写 M10 场景本身 |
| 能力来源 | 01 能源（能耗/碳排）、02 空间（客流/利用率，M8 口径）、05 巡检统计（巡检/工单）、08 §7（管理者场景） |
| 版本 | v0.2 |
1. 场景定义
1.1 一句话
每月 1 日早上 08:30，Agent 以当前管理者身份自动生成上月运营月报；管理者也可以随时主动查询某个月的月报。报告内容为「客流与空间 / 能源与碳 / 巡检执行 / 工单与服务 / 异常与缺口」五节汇总。
1.2 用户与价值
| 项 | 内容 |
|---|---|
| 用户 | 管理者（demo 固定账号 M1001，数据范围 = 全院） |
| 价值 | 不需要分别打开能耗、空间、巡检、工单四个看板；月初一次拿到上月全貌、环比、缺口和建议 |
| 频次 | 每月 1 次主动推送 + 按需查询 |
| 层级 | L6 生成与洞察；主动推送 + 被动查询 |
1.3 触发方式
- 两种入口：每月 1 日 08:30 定时主动推送；用户也可随时主动查询。
- 典型 query：「出一份 10 月运营月报」「看下上个月运营情况」「9 月月报在哪？」
- 主动查询未指定月份时默认上一个自然月；指定历史月份时，优先返回已生成的月报快照，不重新跑数。
- 定时任务执行 M10 skill，带上当前管理者 ID。
- 上月完全无数据时不推送，只记录日志；主动查询时说明「该月暂无数据」。
- 未生成月份是否允许按需生成、生成后是否持久化，见 §9.3。
1.4 与专题模块的边界
M10 是汇总，不是分析。五节各自引用对应专题的结论，不重复展开归因。
| 模块 | 定位 | 在 M10 中的角色 |
|---|---|---|
| M3 用能画像 | 被动问答，看单空间/同类的能耗结构 | M10 第二节只给总量/环比/分项，画像不回放 |
| M4 异常能耗侦探 | 被动问答，做异常归因与转工单 | M10 第二节只给异常条数与超出电量，归因一句带过 |
| M5 双碳与能源月报 | 被动问答，出碳排与能源专题月报 | M10 直接引用其碳段结论，不重复核算 |
| M7 空间洞察 | 被动问答，做排名与调改建议 | M10 第一节只给利用率区间与低效空间数量 |
| M8 人流密度/热力 | 被动问答，看实时人数/密度/超容 | M10 第一节只引用人数口径与月度峰值，不展开热力与实时预警 |
| M9 服务质量 | 被动问答，做指标卡 | M10 第三、四节只给完成率/闭环率与异常数量 |
| M10 月度报告 | 主动推送 + 被动查询，汇总 | 给「这个月整体怎么样 + 哪里有问题 + 下月看什么」 |
1.5 边界（不做）
| 不做 | 原因 |
|---|---|
| 不做归因分析 | 归因是 M4 等专题的职责；月报只做汇总，避免重复与口径冲突 |
| 不做数据修数 | 指标由指标引擎出，LLM 只解读，不改数值 |
| 不生成 PPT / 文件 | 聊天区以 Markdown 为主；报告是否落库、是否给固定链接见 §9.3；PPT/PDF 导出走小程序壳或报告引擎 |
| 不重复动态生成 | 已生成的月报返回快照；重跑与版本规则待定，见 §9.3 |
| 不做实时数据 | 月报以月为单位，最后一次跑批后的数据为准 |
| 不推送周报/季报 | 周报由 M1/M2 承担；季度报告不在 demo 范围 |
| 不做快捷选项 | Demo 阶段单对话，追问直接打字 |
2. Demo 形态
通用形态见 公共规范.md（小程序悬浮球打开 DeerFlow 聊天区、单会话、Markdown + Mermaid）。
本场景只约定：
- 1 日 08:30 定时任务生成月报，不弹系统通知；管理者打开小程序、点悬浮球后或点「本周 AI 运行洞察」卡片，在聊天区看到月报内容。
- 主动查询：在聊天区输入「看下上个月运营情况」「出一份 10 月运营月报」，返回同一份月报；已生成月份优先返回快照，不重新跑数。
- 月报写入该管理者的常驻会话，不新建会话；之后追问（「能耗为什么涨了」「3 楼利用率怎么算的」）Agent 能把这月报当作上下文继续回答。
- 同一份月报的摘要写入首页「本周 AI 运行洞察」卡片，卡片保留 7 天。月报本身跨月生命周期长于 7 天，超过 7 天后只有聊天区保留完整内容。
注（演示方式）：在 DeerFlow「定时任务」里手动触发一次，或直接在聊天区输入「看下上个月运营情况」；也可以等 1 日 08:30 自动执行后再查看。
3. Agent 输出设计
3.1 输出元素
| 元素 | 用途 |
|---|---|
| Markdown 标题 + 统计周期 | 让人一眼知道看的是哪个月 |
| Markdown 表格 | 五节的数据表 |
Mermaid xychart-beta(line) | 日均指标趋势（在楼人次 / 能耗） |
Mermaid xychart-beta(bar) | 低效空间排名 或 分系统能耗结构（二选一） |
| 文字结论 | 每节 2–4 行 |
注（移动端展示待定）：当前模板为五节全文，手机上可能过长。备选「摘要 + 报告链接」或「摘要 + 折叠五节」，见 §9.3。
3.2 月报结构
月报固定五节：开篇一句话 + 核心指标表 → 客流与空间 → 能源与碳 → 巡检执行 → 工单与服务 → 异常与缺口 → 建议，每节 2–4 行结论。完整样例见 §3.3，组装模板见 §3.7。
3.3 完整示例
Agent（01 日 08:30 定时推送）
2026 年 10 月运营月报
统计周期：2026-10-01 至 2026-10-31
整体平稳：在楼人次环比下降 4%，能耗环比上升 5.2%，空调分项 +14%；巡检与工单闭环率均在目标线以上。
指标 本月 环比 在楼人次 41,280 −4.0% 总能耗 386,400 kWh +5.2% 碳排 186,400 kgCO₂e +3.2% 巡检完成率 96.4% +1.8 pp 工单闭环率 92.1% −0.9 pp 一、客流与空间
全月在楼 41,280 人次，周内峰值出现在周二（1,820 人/日），周末降至 1,200 人以下，与 MBA 周末集中授课的课表一致；教室类空间平均利用率 61%，讨论室 48%，公共交流区 33%；利用率低于 30% 的空间 7 处，共 1,240 ㎡，主要集中在 B 楼 4–5 层。
二、能源与碳
全月总能耗 386,400 kWh，环比 +5.2%；其中空调分项 +14%，照明 −3%，动力基本持平。单位面积能耗 6.4 kWh/㎡，单位人次能耗 9.4 kWh/人，后者环比上升 10%，说明人数下降而能耗上升，能源效率变差。碳排 186,400 kgCO₂e，环比 +3.2%；因子版本 v2026-A。
三、巡检执行
全月计划巡检 1,860 项，完成 1,793 项，完成率 96.4%；按时完成 1,742 项，按时率 93.6%。视觉巡检异常 74 项，误报 9 项，误报率 12.2%，高于 10% 目标线，主要来自 B 楼公共区域抓拍遮挡。人工巡检补充 96 项，全部闭环。
四、工单与服务
全月新建工单 412 张，闭环 379 张，闭环率 92.1%，环比下降 0.9 pp。平均响应 1.6 小时、平均闭环 19.4 小时；超时未闭环 33 张，其中 19 张集中在暖通专业。报修来源中教师/学生自助建单占 58%，较上月提升 6 pp。
五、异常与缺口
异常集中在两处：空调分项能耗环比 +14%，与 10 月 14 日起的提前开机相关；暖通工单超时 19 张，需关注维保排班。数据缺口：B 楼 5 层人流点位 10 月 8–11 日离线，该区间人数为估算值；3 处讨论室未接入预约系统，利用率按门禁推算，仅供参考。
建议
- B 楼 4–5 层 7 处低效空间（1,240 ㎡）建议在下学期排课中优先释放或改为共享自习区。
- 空调提前开机策略建议按室外温度设阈值，避免 10 月这类「降温即全开」的能耗跃升。
- 视觉巡检误报 12.2% 超过目标线，建议复核 B 楼公共区域抓拍点位与 ROI。
数据来源与口径：客流取闸机+摄像头去重；能耗取分项计量表，含公共照明与动力；碳排因子采用学院 2026 年度核定值（版本 v2026-A）；巡检完成率 = 完成项/计划项，按时率 = 按时完成项/计划项。
3.4 参数化要点
| 项 | 约定 |
|---|---|
| 图表数量 | 全文最多 2 张：图 1 固定为日均趋势 line；图 2 在「低效空间排名」和「分系统能耗结构」中二选一，取本月更值得说的一侧 |
| 表格 | 每节最多 1 张；无数据支撑时不画表，只写文字 |
| 五节顺序 | 固定，不因数据好坏重排 |
| 建议条数 | ≤ 3 条；每条必须带数字或具体对象，不写「加强管理」这类空话 |
| 结论口径 | 允许说「环比上升/下降」，不允许在月报里做因果归因（那是 M4 等专题的事） |
| 缺口表述 | 写「哪一项、哪段时间、如何影响结论」，不隐藏、不估算后不声明 |
3.5 洞察卡片摘要
单独输出一段，≤ 80 字，模板见 §3.7。
Agent（洞察卡片摘要）
10 月运营月报：在楼 4.1 万人次（−4%），能耗 38.6 万 kWh（+5.2%），巡检完成率 96.4%，工单闭环率 92.1%；空调能耗环比 +14%，建议复核开机策略。
注：摘要超 80 字时优先删「巡检/工单」两个指标，保留「人次、能耗、最需关注的事」。
3.6 异常与降级
| 情况 | 输出 |
|---|---|
| 上月完全无数据 | 不输出、不推送，只记录日志 |
| 某一组数据 MCP 失败 | 对应那一节写「本节数据暂缺（{原因}）」，其余四节正常输出 |
| 多组数据同时失败 | 报告降级为「仅摘要 + 缺口清单」，不输出建议 |
数据完整度低（某组 data_quality 标缺失天数 > 20%） | 该节正文标注「样本不足，结论仅供参考」 |
| 环比基准月缺失 | 环比列写「—」，正文注明「上月无可比数据」 |
| 碳排因子未配置 | 第二节只写能耗，碳排写「因子未配置」 |
全部 data_quality 为正常但数值异常（如为 0） | 按「暂无」处理，不按 0 输出 |
3.7 输出模板（开发参考）
本节给 Skill 组装输出用，业务评审可跳过。
完整月报：
# 2026 年 10 月运营月报
统计周期：2026-10-01 至 2026-10-31
> 一句话：{本月整体评价，1 句}
| 指标 | 本月 | 环比 |
|---|---|---|
| 在楼人次 | {n} | {±x%} |
| 总能耗 | {n} kWh | {±x%} |
| 碳排 | {n} kgCO₂e | {±x%} |
| 巡检完成率 | {x}% | {±x pp} |
| 工单闭环率 | {x}% | {±x pp} |
（Mermaid 图 1：日均在楼人次与能耗趋势）
## 一、客流与空间
{2–4 行结论}
{可选表格：楼层/空间类型利用率}
## 二、能源与碳
{2–4 行结论}
{可选表格：分系统能耗}
## 三、巡检执行
{2–4 行结论}
{表格：规则 / 视觉 / 人工 三类完成率}
## 四、工单与服务
{2–4 行结论}
{可选表格：按专业维度工单数、平均响应、平均闭环}
## 五、异常与缺口
{2–4 行结论 + 数据缺口清单}
（Mermaid 图 2：低效空间排名 或 分系统能耗结构）
## 建议
1. {建议一}
2. {建议二}
3. {建议三}
> 数据来源与口径：{一句话}洞察卡片摘要（≤ 80 字）：
{月}月运营月报：在楼{人次}人次（{环比}），能耗{能耗}kWh（{环比}），巡检完成率{率}，工单闭环率{率}；{最需要关注的一件事}。4. MCP 设计
M10 只用读工具，全部返回结构化数据，计算（汇总/环比/比率）在 MCP 侧完成，不让模型做算术。
4.1 query_operations_daily_metrics
| 项 | 内容 |
|---|---|
| 作用 | 取区间内逐日的运营基线指标 |
| 入参 | start_date（YYYY-MM-DD）、end_date（YYYY-MM-DD）、metrics（数组：people_in_building、energy_kwh、carbon_kg、alarms、workorders、inspection_completion_rate） |
| 返回 | series、summary、data_quality |
返回字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| series | array | 每项 {date, people_in_building, energy_kwh, carbon_kg, alarms, workorders, inspection_completion_rate}，未取值的指标为 null |
| summary | object | 每个指标一个键：{avg, max, max_date, mom_change_pct, unit} |
| data_quality | object | {days_expected, days_missing, missing_dates[], note} |
注：这是月报摘要块和趋势图的唯一数据源；其余四个工具只提供分维度细节。
4.2 query_energy_metrics
| 项 | 内容 |
|---|---|
| 作用 | 取能源用量、分项结构与环比 |
| 入参 | start_date、end_date、granularity（month）、dimension（system / space / time）、scope（campus / 楼栋编码）、systems（可选，如 ["AC","lighting","power"]） |
| 返回 | series、total、compare、data_quality |
返回字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| series | array | 按 dimension 拆分的 {key, value, unit, share_pct}，或按日的 {date, value} |
| total | object | {value, unit} |
| compare | object | {prev_value, mom_change_pct, prev_period} |
| data_quality | object | 同上，标明缺失表计与天数 |
注：碳排由 MCP 按配置的排放因子算好放在 total 里；因子未配置时 total.carbon 为 null，由 skill 降级处理。
4.3 query_space_utilization
| 项 | 内容 |
|---|---|
| 作用 | 取空间的预约/占用与利用率；字段、口径与 prd/M7-空间洞察.md §4.1 完全一致 |
| 入参 | start_date、end_date、space_type、sort（asc / desc）、limit |
| 返回 | spaces（字段同 M7 §4.1，含 available_hours、unit_area_utilization、metric_source）、summary |
summary 额外返回：按 space_type 汇总的 {space_type, area_m2, avg_utilization_rate}、low_util_count、low_util_area_m2。低效阈值由 MCP 按配置给出（默认 30%），skill 不再自行判断。
4.4 query_inspection_stats
| 项 | 内容 |
|---|---|
| 作用 | 按巡检类别取完成与异常统计 |
| 入参 | start_date、end_date、category（rule / visual / manual / all）、granularity（month） |
| 返回 | 按类别的统计数组、series、data_quality |
返回字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| by_category | array | category、planned、completed、on_time、missed、abnormal、completion_rate、on_time_rate、false_positive_rate（仅视觉类有值） |
| series | array | 按日的 {date, planned, completed}，用于趋势 |
| data_quality | object | 同上 |
4.5 query_workorder_stats
| 项 | 内容 |
|---|---|
| 作用 | 取工单量与时效 |
| 入参 | start_date、end_date、dimension（specialty / source / status）、status（可选，如 ["open","closed","overdue"]） |
| 返回 | by_dimension、total、overdue_count |
返回：by_dimension（{key, count, avg_response_hours, avg_close_hours}）、total（{created, closed, close_rate}）、overdue_count。
注：月报需要两个维度：specialty（暖通/电气/给排水…）和 source（自助报修/巡检转单/告警转单）。skill 调两次。
4.6 报告快照（待定）
月报生成后应写入报告库/对象存储，返回 report_id + report_url；后续查询优先读快照，不重新跑数。建议接口：
get_operation_report(month)：返回status、report_id、report_url、generated_at、summary、sections[]、data_version、analysis_version。generate_operation_report(month, force=false)：生成并持久化；force=false时若已存在直接返回。
注：是否复用公司报告引擎、模板报告与 LLM 解读如何组合，见 §9.3。
5. Skill 设计
5.1 职责
Skill 把「定月份 → 查快照 → 取五组数据 → 组装 → 标缺口 → 输出」这套固定流程写死，保证定时推送和主动查询的结构、口径一致。已生成月份直接返回快照，不重新取数；未生成月份按 §9.3 的规则处理。
5.2 流程
5.3 统计周期规则
| 触发日 | 统计周期 |
|---|---|
| 每月 1 日 | 上一个自然月的 1 日 00:00 至月末 23:59 |
| 用户主动查询 | 用户指定月份；未指定时默认上一个自然月 |
| 1 月 1 日 | 上一年 12 月 1 日至 12 月 31 日（跨年） |
| 手工补跑（demo 手动触发） | 指令中显式给出 start_date / end_date 时以指令为准 |
注：周期由 skill 自己算，不依赖定时任务传参；跨年、大小月由 skill 处理。
5.4 Skill 提示词草稿
你是上海交通大学新院区 IBMS 的管理者助手。你会在每月 1 日定时生成上月运营月报，也会被用户主动查询某个月的月报。
输入：
- 管理者 ID：从任务指令或对话上下文取（demo 固定 M1001）
- 数据范围：全院（demo）
- 月份：定时任务默认上一个自然月；主动查询按用户指定月份，未指定也默认上一个自然月
- 统计周期：该月 1 日 00:00 至月末 23:59；如果任务指令中显式给了 start_date/end_date，以指令为准
步骤：
1. 确定月份；若该月月报已生成并持久化，直接返回快照摘要 + 报告链接，不重新取数。
2. 计算统计周期，并算出上一个月（环比基准月）的起止日期。
3. 并行调用以下五个工具，不要串行：
- query_operations_daily_metrics(start_date, end_date, metrics=[people_in_building, energy_kwh, carbon_kg, alarms, workorders, inspection_completion_rate])
- query_energy_metrics(start_date, end_date, granularity=month, dimension=system, scope=campus)
- query_space_utilization(start_date, end_date, space_type=all, sort=utilization_asc, limit=10)
- query_inspection_stats(start_date, end_date, category=all, granularity=month)
- query_workorder_stats(start_date, end_date, dimension=specialty) 和 query_workorder_stats(start_date, end_date, dimension=source)
4. 任意一个工具失败或返回空，不要中断，把对应那一节标记为「本节数据暂缺（原因）」，继续组装其他节。
5. 如果五组全部失败，直接结束，不输出任何内容。
6. 按输出模板组装五节 + 摘要 + 建议；生成后应持久化为该月快照（见 §9.3）。
7. 额外输出一段不超过 80 字、供首页洞察卡片使用的摘要。
输出要求：
- 只用 Markdown 和 Mermaid，不输出 JSON、不用 HTML。
- 标题 + 统计周期 + 5 个数字摘要 + 五节 + ≤3 条建议 + 数据来源与口径。
- 全文最多 2 张图：图 1 固定为日均在楼人次趋势（xychart-beta line）；图 2 在「低效空间排名」与「分系统能耗结构」中二选一。
- 每节最多 1 张表，无数据不画表。
- 不做因果归因：只陈述「环比上升/下降 + 数值」，原因留给 M4 等专题回答。可以使用「与……时间重合」这类客观表述，不写「因为……所以……」。
- 不修改任何数值，不补算缺失数据；MCP 返回 null 就写「暂无」或标缺口，不当作 0。
- 数据缺口必须显式列出：哪一项、哪段时间、如何影响结论。
- 建议不超过 3 条，每条必须带数字或具体对象；不写「加强管理」「持续关注」这类空话。
- 卡片摘要 ≤ 80 字，模板见 §3.5。
- Few-shot：配置时把本文 §3.3 的完整示例原文作为一条示例放入 skill。5.5 工具调用顺序与失败策略
| 步骤 | 调用 | 失败时影响的章节 |
|---|---|---|
| 1 | query_operations_daily_metrics | 摘要块 + 图 1 + 第一/二节结论；其余节仍可出 |
| 2 | query_energy_metrics | 第二节 + 图 2（若选能耗结构）；摘要里的能耗/碳排写「暂无」 |
| 3 | query_space_utilization | 第一节表格 + 图 2（若选低效空间）；第一节只写结论不画表 |
| 4 | query_inspection_stats | 第三节；摘要巡检完成率写「暂无」 |
| 5 | query_workorder_stats（×2） | 第四节；摘要工单闭环率写「暂无」 |
注：五组互不依赖，必须并行调用；任一组失败只影响对应章节。全部失败才整体不出。
6. 定时任务配置
在 DeerFlow「定时任务 → 新建任务」里按实际表单配置：
| 表单字段 | 值 |
|---|---|
| 标题 | M10 管理者月度运营报告 |
| 任务指令 | 执行「M10 月度运营报告」skill。当前用户 ID：M1001。 |
| 运行时间 | 重复 · 每月 · 1 日 · 08:30 · Etc/GMT-8（北京时间） |
| 每次运行的目标（可选） | 生成上月运营月报：客流与空间、能源与碳、巡检执行、工单与服务、异常与缺口 |
| 保险上限：运行次数 | 留空（demo 不限制） |
| 保险上限：结束时间 | 留空 |
| 高级选项 | 不配置 |
- Demo 固定用演示管理者账号
M1001，数据范围 = 全院。 - 任务指令已带「执行哪个 skill + 用户 ID」，skill 内部再并行调五个 MCP。
- 任务结果写入该管理者的常驻会话（AI 联系人），不新建会话；首页洞察卡片取同一条结果的摘要。
- 上月完全无数据时不推送，任务只写日志；避免新院区首月出一条空报告。
- 定时任务只是入口之一：同一 Skill 也支持用户主动查询，月份参数化；已生成月份返回快照，不重复跑数。
- 定时任务只在这个页面配置，不允许通过对话创建（见
公共规范.md§4）。 - 用户 ID 来源沿用 T1 §6.1 的 A/B/C 三方案，demo 用 A（写死在任务指令里）。
6.1 用户 ID 与多用户调度
- 用户 ID 来源沿用 T1 §6.1（demo 用 A，写死
M1001）；管理者人数少，生产上按人建任务，人数增长后按 T1 §6.2 批处理。
7. 权限与数据范围
- 只返回授权范围内的数据；demo 固定为全院，不对单个楼栋/楼层做裁剪。
- 报告链接（若有）需带访问校验，只对授权管理者开放，不长期公开。
- 管理者助手不挂载业务写工具：不能改指标、不能建工单、不能改能耗参数；报告快照的生成与存档由报告服务负责，不算业务写操作。
- 不返回个人级数据：工单按专业/来源维度聚合，不出现报修人姓名、手机号；巡检结果不出现学生/教师人脸。
- 若后续接入分公司/分院分权，数据裁剪在 MCP 层按
scope入参实现，不依赖 prompt 约束。 - Demo 用一个固定账号，不做权限管理界面。
8. 验收要点
| # | 验收项 | 标准 |
|---|---|---|
| 1 | 触发 | 每月 1 日 08:30 主动推送；用户主动查询同一 Skill，月份参数化 |
| 2 | 统计周期 | 覆盖上一个自然月 1 日至月末，跨年/大小月正确 |
| 3 | 结构 | 标题 + 周期 + 5 个数字摘要 + 五节 + ≤3 条建议 + 口径说明，顺序固定 |
| 4 | 图表 | 全文 ≤2 张；图 1 为日均趋势 line，图 2 二选一 |
| 5 | 缺口 | 单组数据失败时，该节写「暂缺（原因）」，其余节照常输出；五组全失败则不推送 |
| 6 | 无归因 | 正文不出现「因为…所以…」式因果结论，只陈述环比数值与时间重合 |
| 7 | 无数据 | 上月完全无数据时不推送；空值不显示为 0 |
| 8 | 卡片 | 摘要 ≤80 字，含人次、能耗、最需关注的一件事 |
| 9 | 数据范围 | 只出现全院聚合数据，无个人姓名/手机号/人脸 |
| 10 | 主动查询 | 指定月份返回该月月报；已生成月份返回快照，重复查询数值一致 |
9. 已确认与待确认
9.1 已确认
| # | 事项 | 结论 |
|---|---|---|
| 1 | 触发方式 | 每月 1 日 08:30 主动推送；同时支持用户主动查询某月 |
| 2 | 统计周期 | 上一个自然月 |
| 3 | 展示位置 | 常驻会话（完整）+ 首页「本周 AI 运行洞察」卡片（摘要），不弹通知、不走微信/企微 |
| 4 | 报告结构 | 5 个数字 + 五节 + ≤3 条建议 + 口径说明 |
| 5 | 图表上限 | 全文最多 2 张 |
| 6 | 与专题模块分工 | M10 只汇总，不做归因 |
| 7 | 数据缺口 | 显式列出，不补算、不隐藏 |
| 8 | 主动查询 | 与定时任务共用 Skill，月份参数化；已生成月份返回快照 |
9.2 待确认
- 报告是否需要导出/分享：本期只做聊天区展示；若需要 PDF/图片导出，走小程序壳的导出能力（不在 Agent 范围）。
- 指标口径冻结时点：月报跑批时点（1 日 08:30）晚于月末，若业务系统在 1 日当天补录数据，是否重跑？建议「1 日 08:30 跑一次为准，不自动重跑」。
- 首月无历史数据：新院区第一个完整运营月没有环比基准，报告只出绝对值、环比列写「—」；是否需要在首月改成「首月运营概览」口径，待定。
- 洞察卡片摘要长度：≤80 字为初稿，最终长度与是否配图待 UI 定。
- 碳排因子：采用哪一版因子（学院核定 / 电网平均 / 其他）待甲方确认；未配置时第二节只出能耗。
- 低效空间阈值：默认 30%，是否需要按空间类型分别设阈值（如讨论室 25%、教室 40%）待定。
- 月报是否含预算对比：预算数据不在本期指标范围内，若甲方要求，需要新增预算 MCP。
9.3 待决策：主动查询、移动端展示与持久化
| # | 问题 | 备选 / 建议 |
|---|---|---|
| 1 | 主动查询范围 | 支持按月份查询；未生成月份是否允许按需生成、谁能触发、是否限频，待定 |
| 2 | 手机聊天区展示 | 五节全文可能过长。A 摘要 + 5 个数字 + 2 张图 + 报告链接；B 摘要 + 折叠五节（需前端支持）；C 保持全文。建议 A 或 B |
| 3 | 报告是否动态生成 | 不应每次动态生成。生成一次后落库/对象存储，固定 report_id + URL；查询返回快照。需定重跑与版本规则 |
| 4 | 是否复用公司报告引擎 | 优点：模板稳定、可持久化、有 URL、权限可控；缺点：模板报告，无 LLM 分析。建议混合：报告引擎出结构化报告 + 持久化 URL，LLM 生成「解读/建议」段落一并存档；需确认引擎 API、模板定制、移动端展示、URL 权限 |
补充：
- 若采用混合模式，M10 的「结构、数字、图表」来自报告引擎或指标快照，「解读/建议」来自 LLM；两者必须一起持久化，避免下次查询时分析口径变化。
- 若不用报告引擎，LLM 全文生成后需转 HTML/PDF 并持久化，排版与版本成本更高。
- 报告快照应记录
month、report_id、generated_at、data_version、analysis_version、factor_version、threshold_version，便于追溯。
10. 关联文档
| 文档 | 关联内容 |
|---|---|
01_能源类AI能力-现状与自有发挥.md | 能耗分项、碳核算口径、环比基准 |
02_人流密度与空间洞察.md | 利用率定义、低效空间判定、空间主数据 |
prd/M7-空间洞察.md | 低效空间判定与利用率口径 |
prd/M8-人流密度.md | 客流人数口径与峰值 |
05_巡检任务完成情况统计.md | 巡检三类的完成率/按时率/误报率口径 |
prd/M9-服务质量.md | 巡检完成率、投诉闭环率等指标口径 |
08_移动端AI场景设计.md §7、§10 | 管理者场景原定义、M10 模块行 |
公共规范.md | 前端形态、常驻会话、定时任务、输出规范、场景 PRD 模板 |
注：上述文档与本文保持一致。如有差异，以本文为准，回写更新对应文档。