mirror of
https://github.com/xinnan-tech/xiaozhi-esp32-server.git
synced 2026-07-24 16:13:54 +08:00
107 lines
2.6 KiB
Markdown
107 lines
2.6 KiB
Markdown
# get_news_from_newsnow 插件新闻源配置指南
|
||
|
||
## 概述
|
||
|
||
`get_news_from_newsnow` 插件现在支持通过Web管理界面动态配置新闻源，不再需要修改代码。用户可以在智控台中为每个智能体配置不同的新闻源。
|
||
|
||
## 配置方式
|
||
|
||
### 1. 通过Web管理界面配置（推荐）
|
||
|
||
1. 登录智控台
|
||
2. 进入"角色配置"页面
|
||
3. 选择要配置的智能体
|
||
4. 点击"编辑功能"按钮
|
||
5. 在右侧参数配置区域找到"newsnow新闻聚合"插件
|
||
6. 在"新闻源配置"字段中输入JSON格式的新闻源配置
|
||
|
||
### 2. 配置文件方式
|
||
|
||
在 `config.yaml` 中配置：
|
||
|
||
```yaml
|
||
plugins:
|
||
get_news_from_newsnow:
|
||
url: "https://newsnow.busiyi.world/api/s?id="
|
||
news_sources:
|
||
thepaper: "澎湃新闻"
|
||
baidu: "百度热搜"
|
||
cls-depth: "财联社"
|
||
# 可以添加更多新闻源
|
||
sina: "新浪新闻"
|
||
sohu: "搜狐新闻"
|
||
```
|
||
|
||
## 新闻源配置格式
|
||
|
||
新闻源配置使用JSON格式，格式为：
|
||
|
||
```json
|
||
{
|
||
"source_id": "显示名称",
|
||
"source_id2": "显示名称2"
|
||
}
|
||
```
|
||
|
||
### 配置示例
|
||
|
||
```json
|
||
{
|
||
"thepaper": "澎湃新闻",
|
||
"baidu": "百度热搜",
|
||
"cls-depth": "财联社",
|
||
"sina": "新浪新闻",
|
||
"sohu": "搜狐新闻"
|
||
}
|
||
```
|
||
|
||
## 默认配置
|
||
|
||
如果未配置新闻源，插件将使用以下默认配置：
|
||
|
||
```json
|
||
{
|
||
"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和字典格式的配置
|
||
- 配置验证和错误处理机制
|
||
- 向后兼容，未配置时使用默认值 |