xiaozhi-esp32-server/docs/newsnow_plugin_config.md

get_news_from_newsnow 插件新闻源配置指南

概述

get_news_from_newsnow 插件现在支持通过Web管理界面动态配置新闻源，不再需要修改代码。用户可以在智控台中为每个智能体配置不同的新闻源。

配置方式

1. 通过Web管理界面配置（推荐）

1. 登录智控台
2. 进入"角色配置"页面
3. 选择要配置的智能体
4. 点击"编辑功能"按钮
5. 在右侧参数配置区域找到"newsnow新闻聚合"插件
6. 在"新闻源配置"字段中输入JSON格式的新闻源配置

2. 配置文件方式

在 config.yaml 中配置：

plugins:
  get_news_from_newsnow:
    url: "https://newsnow.busiyi.world/api/s?id="
    news_sources:
      thepaper: "澎湃新闻"
      baidu: "百度热搜"
      cls-depth: "财联社"
      # 可以添加更多新闻源
      sina: "新浪新闻"
      sohu: "搜狐新闻"

新闻源配置格式

新闻源配置使用JSON格式，格式为：

{
  "source_id": "显示名称",
  "source_id2": "显示名称2"
}

配置示例

{
  "thepaper": "澎湃新闻",
  "baidu": "百度热搜", 
  "cls-depth": "财联社",
  "sina": "新浪新闻",
  "sohu": "搜狐新闻"
}

默认配置

如果未配置新闻源，插件将使用以下默认配置：

{
  "thepaper": "澎湃新闻",
  "baidu": "百度热搜",
  "cls-depth": "财联社"
}

使用说明

1. 配置新闻源：在Web界面或配置文件中设置新闻源
2. 调用插件：用户可以说"播报新闻"或"获取新闻"
3. 指定新闻源：用户可以说"播报澎湃新闻"或"获取百度热搜"
4. 获取详情：用户可以说"详细介绍这条新闻"

注意事项

1. 新闻源的 source_id 必须与API接口支持的ID一致
2. 配置更改后需要重启服务或重新加载配置
3. 如果配置的新闻源无效，插件会自动使用默认新闻源
4. JSON格式必须正确，否则会使用默认配置

故障排除

问题：配置的新闻源不生效

解决方案：

1. 检查JSON格式是否正确
2. 确认新闻源ID是否有效
3. 查看日志文件中的错误信息
4. 重启服务

问题：无法获取新闻

解决方案：

1. 检查网络连接
2. 确认API接口地址是否正确
3. 查看API接口是否可用
4. 检查日志文件中的错误信息

技术实现

• 插件会从 conn.config["plugins"]["get_news_from_newsnow"]["news_sources"] 读取配置
• 支持字符串格式的JSON和字典格式的配置
• 配置验证和错误处理机制
• 向后兼容，未配置时使用默认值