LocalPulse Edge

收到评论分析目标时，把 LocalPulse 当成一个可调用 Tool，而不是要求宿主 Agent 自己重新实现舆情算法。

决策原则

1. 先调用 runtime_status 确认实际设备、隐私状态和 default_dataset。用户未指定文件且 default_dataset.available=true 时，直接调用无 input_path 的 analyze_dataset；用户明确给出文件时使用其路径。
2. 用户同时给帖子/视频 URL 和本地授权导出时，调用 analyze_from_source。
3. 用户只给 URL 时，只调用 resolve_source；该工具不访问平台、不解析短链、不登录、不使用 Cookies、不抓取评论。然后请求用户提供已授权的本地评论导出。
4. 只有需要检查字段、清洗或去重时才单独调用 ingest_dataset。
5. 完整分析返回后，只依据返回 facts、runtime、risk、top_comments、decision 和 provenance 给结论，不补造缺失指标。
6. 报告中必须区分真实模型执行与 fallback；不要把规则降级描述成 OpenVINO/NPU/GPU 模型结果。

统一工具入口

所有 Tool 都通过：

POST /api/tools/call

请求格式：

{"tool_name":"analyze_dataset","arguments":{"input_path":"demo/demo_comments.csv","generate_report":true}}

机器可读契约：

• GET /api/skill/manifest
• GET /openapi.json

推荐工具

analyze_dataset

用途：对本地 CSV/JSON/XLSX 评论执行完整闭环。input_path 可选；宿主配置了 LOCALPULSE_DEFAULT_DATASET 时，无参数调用会使用该默认数据集。

结果链：

CPU 清洗/统一字段
→ Intel NPU StructBERT 全量初筛
→ Intel GPU Qwen 高风险候选复核
→ CPU RandomForest 相对传播潜力
→ 风险排序
→ Intel GPU Qwen 话题级决策
→ JSON + HTML 战报

实际设备和 backend 以运行结果为准。NPU 文本模型不可用时可以退化到本地轻量 scorer/规则；GPU Qwen 不可用时可以退化到规则，但必须保留 fallback_reason。

analyze_from_source

用途：来源 URL 作为 provenance 证明，同时分析用户提供的本地授权评论导出。系统先脱敏、去重、生成 provenance，再进入完整分析。

resolve_source

只识别 Bilibili/Xiaohongshu/Weibo HTTPS URL 的平台与内容 ID；绝不自动抓取评论。

ingest_dataset

只执行加载、字段映射、清洗与去重，不执行完整推理。

输出要求

给用户的最终答案优先包含：

• 数据规模与完整性限制；
• 总体风险与核心话题；
• Top Comments / 高传播风险评论；
• 至少两条有事实证据的行动建议；
• NPU/GPU/RF/LLM 实际 runtime 与 fallback；
• HTML/JSON 战报路径；
• 数据缺失与隐私边界。

RF 只代表相对传播潜力，不宣称预测真实未来点赞数。不得把模型推断负面率描述为人工准确率。