docs: 文档命令修正

This commit is contained in:
sansan 2025-12-09 19:44:42 +08:00
parent e4d609b389
commit 3707095c6b
2 changed files with 65 additions and 65 deletions

View File

@ -397,7 +397,7 @@ Transform from "algorithm recommendation captivity" to "actively getting the inf
**🔧 Upgrade Instructions**: **🔧 Upgrade Instructions**:
- **GitHub Fork Users**: Update `main.py`, `config/config.yaml` (Added multi-account push support, existing single-account configuration unaffected) - **GitHub Fork Users**: Update `main.py`, `config/config.yaml` (Added multi-account push support, existing single-account configuration unaffected)
- **Docker Users**: Update `.env`, `docker-compose.yml` or set environment variables `REVERSE_CONTENT_ORDER`, `MAX_ACCOUNTS_PER_CHANNEL` - **Docker Users**: Update `.env`, `docker compose.yml` or set environment variables `REVERSE_CONTENT_ORDER`, `MAX_ACCOUNTS_PER_CHANNEL`
- **Multi-Account Push**: New feature, disabled by default, existing single-account configuration unaffected - **Multi-Account Push**: New feature, disabled by default, existing single-account configuration unaffected
@ -520,7 +520,7 @@ Transform from "algorithm recommendation captivity" to "actively getting the inf
- **Added Personal WeChat Push Support**: WeWork application can push to personal WeChat without installing WeWork APP - **Added Personal WeChat Push Support**: WeWork application can push to personal WeChat without installing WeWork APP
- Supports two message formats: `markdown` (WeWork group bot) and `text` (personal WeChat app) - Supports two message formats: `markdown` (WeWork group bot) and `text` (personal WeChat app)
- Added `WEWORK_MSG_TYPE` environment variable configuration, supporting GitHub Actions, Docker, docker-compose and other deployment methods - Added `WEWORK_MSG_TYPE` environment variable configuration, supporting GitHub Actions, Docker, docker compose and other deployment methods
- `text` mode automatically strips Markdown syntax for clean plain text push - `text` mode automatically strips Markdown syntax for clean plain text push
- See "Personal WeChat Push" configuration in Quick Start - See "Personal WeChat Push" configuration in Quick Start
@ -2018,7 +2018,7 @@ TrendRadar provides two independent Docker images, deploy according to your need
--- ---
#### Method 1: Using docker-compose (Recommended) #### Method 1: Using docker compose (Recommended)
1. **Create Project Directory and Config**: 1. **Create Project Directory and Config**:
@ -2039,9 +2039,9 @@ TrendRadar provides two independent Docker images, deploy according to your need
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/config.yaml -P config/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/config.yaml -P config/
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/frequency_words.txt -P config/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/frequency_words.txt -P config/
# Download docker-compose config # Download docker compose config
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/.env -P docker/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/.env -P docker/
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker-compose.yml -P docker/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker compose.yml -P docker/
``` ```
> 💡 **Note**: Key directory structure required for Docker deployment: > 💡 **Note**: Key directory structure required for Docker deployment:
@ -2052,7 +2052,7 @@ current directory/
│ └── frequency_words.txt │ └── frequency_words.txt
└── docker/ └── docker/
├── .env ├── .env
└── docker-compose.yml └── docker compose.yml
``` ```
2. **Config File Description**: 2. **Config File Description**:
@ -2082,7 +2082,7 @@ current directory/
**Usage Method**: **Usage Method**:
- Modify `.env` file, uncomment and fill in needed configs - Modify `.env` file, uncomment and fill in needed configs
- Or add directly in NAS/Synology Docker management interface's "Environment Variables" - Or add directly in NAS/Synology Docker management interface's "Environment Variables"
- Restart container to take effect: `docker-compose up -d` - Restart container to take effect: `docker compose up -d`
3. **Start Service**: 3. **Start Service**:
@ -2090,24 +2090,24 @@ current directory/
**Option A: Start All Services (Push + AI Analysis)** **Option A: Start All Services (Push + AI Analysis)**
```bash ```bash
# Pull latest images # Pull latest images
docker-compose pull docker compose pull
# Start all services (trend-radar + trend-radar-mcp) # Start all services (trend-radar + trend-radar-mcp)
docker-compose up -d docker compose up -d
``` ```
**Option B: Start News Push Service Only** **Option B: Start News Push Service Only**
```bash ```bash
# Start trend-radar only (scheduled crawling and push) # Start trend-radar only (scheduled crawling and push)
docker-compose pull trend-radar docker compose pull trend-radar
docker-compose up -d trend-radar docker compose up -d trend-radar
``` ```
**Option C: Start MCP AI Analysis Service Only** **Option C: Start MCP AI Analysis Service Only**
```bash ```bash
# Start trend-radar-mcp only (AI analysis interface) # Start trend-radar-mcp only (AI analysis interface)
docker-compose pull trend-radar-mcp docker compose pull trend-radar-mcp
docker-compose up -d trend-radar-mcp docker compose up -d trend-radar-mcp
``` ```
> 💡 **Tips**: > 💡 **Tips**:
@ -2127,8 +2127,8 @@ current directory/
docker ps | grep trend-radar docker ps | grep trend-radar
# Stop specific service # Stop specific service
docker-compose stop trend-radar # Stop push service docker compose stop trend-radar # Stop push service
docker-compose stop trend-radar-mcp # Stop MCP service docker compose stop trend-radar-mcp # Stop MCP service
``` ```
#### Method 2: Local Build (Developer Option) #### Method 2: Local Build (Developer Option)
@ -2144,25 +2144,25 @@ cd TrendRadar
vim config/config.yaml vim config/config.yaml
vim config/frequency_words.txt vim config/frequency_words.txt
# Use build version docker-compose # Use build version docker compose
cd docker cd docker
cp docker-compose-build.yml docker-compose.yml cp docker compose-build.yml docker compose.yml
``` ```
**Build and Start Services**: **Build and Start Services**:
```bash ```bash
# Option A: Build and start all services # Option A: Build and start all services
docker-compose build docker compose build
docker-compose up -d docker compose up -d
# Option B: Build and start news push service only # Option B: Build and start news push service only
docker-compose build trend-radar docker compose build trend-radar
docker-compose up -d trend-radar docker compose up -d trend-radar
# Option C: Build and start MCP AI analysis service only # Option C: Build and start MCP AI analysis service only
docker-compose build trend-radar-mcp docker compose build trend-radar-mcp
docker-compose up -d trend-radar-mcp docker compose up -d trend-radar-mcp
``` ```
> 💡 **Architecture Parameter Notes**: > 💡 **Architecture Parameter Notes**:
@ -2170,7 +2170,7 @@ docker-compose up -d trend-radar-mcp
> - To build `arm64` architecture (Apple Silicon, Raspberry Pi, etc.), set environment variable: > - To build `arm64` architecture (Apple Silicon, Raspberry Pi, etc.), set environment variable:
> ```bash > ```bash
> export DOCKER_ARCH=arm64 > export DOCKER_ARCH=arm64
> docker-compose build > docker compose build
> ``` > ```
#### Image Update #### Image Update
@ -2179,12 +2179,12 @@ docker-compose up -d trend-radar-mcp
# Method 1: Manual update (Crawler + MCP images) # Method 1: Manual update (Crawler + MCP images)
docker pull wantcat/trendradar:latest docker pull wantcat/trendradar:latest
docker pull wantcat/trendradar-mcp:latest docker pull wantcat/trendradar-mcp:latest
docker-compose down docker compose down
docker-compose up -d docker compose up -d
# Method 2: Using docker-compose update # Method 2: Using docker compose update
docker-compose pull docker compose pull
docker-compose up -d docker compose up -d
``` ```
**Available Images**: **Available Images**:
@ -2321,14 +2321,14 @@ flowchart TB
**Quick Start**: **Quick Start**:
Use docker-compose to start both news push and MCP services: Use docker compose to start both news push and MCP services:
```bash ```bash
# Download latest docker-compose.yml (includes MCP service config) # Download latest docker compose.yml (includes MCP service config)
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker-compose.yml wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker compose.yml
# Start all services # Start all services
docker-compose up -d docker compose up -d
# Check running status # Check running status
docker ps | grep trend-radar docker ps | grep trend-radar

View File

@ -567,7 +567,7 @@ GitHub 一键 Fork 即可使用,无需编程基础。
- **新增个人微信推送支持**:企业微信应用可推送到个人微信,无需安装企业微信 APP - **新增个人微信推送支持**:企业微信应用可推送到个人微信,无需安装企业微信 APP
- 支持两种消息格式:`markdown`(企业微信群机器人)和 `text`(个人微信应用) - 支持两种消息格式:`markdown`(企业微信群机器人)和 `text`(个人微信应用)
- 新增 `WEWORK_MSG_TYPE` 环境变量配置,支持 GitHub Actions、Docker、docker-compose 等多种部署方式 - 新增 `WEWORK_MSG_TYPE` 环境变量配置,支持 GitHub Actions、Docker、docker compose 等多种部署方式
- `text` 模式自动清除 Markdown 语法,提供纯文本推送效果 - `text` 模式自动清除 Markdown 语法,提供纯文本推送效果
- 详见快速开始中的「个人微信推送」配置说明 - 详见快速开始中的「个人微信推送」配置说明
@ -2046,7 +2046,7 @@ TrendRadar 提供两个独立的 Docker 镜像,可根据需求选择部署:
--- ---
#### 方式一:使用 docker-compose推荐 #### 方式一:使用 docker compose推荐
1. **创建项目目录和配置**: 1. **创建项目目录和配置**:
@ -2067,9 +2067,9 @@ TrendRadar 提供两个独立的 Docker 镜像,可根据需求选择部署:
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/config.yaml -P config/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/config.yaml -P config/
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/frequency_words.txt -P config/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/frequency_words.txt -P config/
# 下载 docker-compose 配置 # 下载 docker compose 配置
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/.env -P docker/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/.env -P docker/
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker-compose.yml -P docker/ wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker compose.yml -P docker/
``` ```
> 💡 **说明**Docker 部署需要的关键目录结构如下: > 💡 **说明**Docker 部署需要的关键目录结构如下:
@ -2080,7 +2080,7 @@ TrendRadar 提供两个独立的 Docker 镜像,可根据需求选择部署:
│ └── frequency_words.txt │ └── frequency_words.txt
└── docker/ └── docker/
├── .env ├── .env
└── docker-compose.yml └── docker compose.yml
``` ```
2. **配置文件说明**: 2. **配置文件说明**:
@ -2110,7 +2110,7 @@ TrendRadar 提供两个独立的 Docker 镜像,可根据需求选择部署:
**使用方法** **使用方法**
- 修改 `.env` 文件,取消注释并填写需要的配置 - 修改 `.env` 文件,取消注释并填写需要的配置
- 或在 NAS/群晖 Docker 管理界面的"环境变量"中直接添加 - 或在 NAS/群晖 Docker 管理界面的"环境变量"中直接添加
- 重启容器后生效:`docker-compose up -d` - 重启容器后生效:`docker compose up -d`
3. **启动服务**: 3. **启动服务**:
@ -2118,24 +2118,24 @@ TrendRadar 提供两个独立的 Docker 镜像,可根据需求选择部署:
**选项 A启动所有服务推送 + AI 分析)** **选项 A启动所有服务推送 + AI 分析)**
```bash ```bash
# 拉取最新镜像 # 拉取最新镜像
docker-compose pull docker compose pull
# 启动所有服务trend-radar + trend-radar-mcp # 启动所有服务trend-radar + trend-radar-mcp
docker-compose up -d docker compose up -d
``` ```
**选项 B仅启动新闻推送服务** **选项 B仅启动新闻推送服务**
```bash ```bash
# 只启动 trend-radar定时抓取和推送 # 只启动 trend-radar定时抓取和推送
docker-compose pull trend-radar docker compose pull trend-radar
docker-compose up -d trend-radar docker compose up -d trend-radar
``` ```
**选项 C仅启动 MCP AI 分析服务** **选项 C仅启动 MCP AI 分析服务**
```bash ```bash
# 只启动 trend-radar-mcp提供 AI 分析接口) # 只启动 trend-radar-mcp提供 AI 分析接口)
docker-compose pull trend-radar-mcp docker compose pull trend-radar-mcp
docker-compose up -d trend-radar-mcp docker compose up -d trend-radar-mcp
``` ```
> 💡 **提示** > 💡 **提示**
@ -2155,8 +2155,8 @@ TrendRadar 提供两个独立的 Docker 镜像,可根据需求选择部署:
docker ps | grep trend-radar docker ps | grep trend-radar
# 停止特定服务 # 停止特定服务
docker-compose stop trend-radar # 停止推送服务 docker compose stop trend-radar # 停止推送服务
docker-compose stop trend-radar-mcp # 停止 MCP 服务 docker compose stop trend-radar-mcp # 停止 MCP 服务
``` ```
#### 方式二:本地构建(开发者选项) #### 方式二:本地构建(开发者选项)
@ -2172,25 +2172,25 @@ cd TrendRadar
vim config/config.yaml vim config/config.yaml
vim config/frequency_words.txt vim config/frequency_words.txt
# 使用构建版本的 docker-compose # 使用构建版本的 docker compose
cd docker cd docker
cp docker-compose-build.yml docker-compose.yml cp docker compose-build.yml docker compose.yml
``` ```
**构建并启动服务** **构建并启动服务**
```bash ```bash
# 选项 A构建并启动所有服务 # 选项 A构建并启动所有服务
docker-compose build docker compose build
docker-compose up -d docker compose up -d
# 选项 B仅构建并启动新闻推送服务 # 选项 B仅构建并启动新闻推送服务
docker-compose build trend-radar docker compose build trend-radar
docker-compose up -d trend-radar docker compose up -d trend-radar
# 选项 C仅构建并启动 MCP AI 分析服务 # 选项 C仅构建并启动 MCP AI 分析服务
docker-compose build trend-radar-mcp docker compose build trend-radar-mcp
docker-compose up -d trend-radar-mcp docker compose up -d trend-radar-mcp
``` ```
> 💡 **架构参数说明** > 💡 **架构参数说明**
@ -2198,7 +2198,7 @@ docker-compose up -d trend-radar-mcp
> - 如需构建 `arm64` 架构Apple Silicon、树莓派等设置环境变量 > - 如需构建 `arm64` 架构Apple Silicon、树莓派等设置环境变量
> ```bash > ```bash
> export DOCKER_ARCH=arm64 > export DOCKER_ARCH=arm64
> docker-compose build > docker compose build
> ``` > ```
#### 镜像更新 #### 镜像更新
@ -2207,12 +2207,12 @@ docker-compose up -d trend-radar-mcp
# 方式一:手动更新(爬虫 + MCP 镜像) # 方式一:手动更新(爬虫 + MCP 镜像)
docker pull wantcat/trendradar:latest docker pull wantcat/trendradar:latest
docker pull wantcat/trendradar-mcp:latest docker pull wantcat/trendradar-mcp:latest
docker-compose down docker compose down
docker-compose up -d docker compose up -d
# 方式二:使用 docker-compose 更新 # 方式二:使用 docker compose 更新
docker-compose pull docker compose pull
docker-compose up -d docker compose up -d
``` ```
**可用镜像** **可用镜像**
@ -2349,14 +2349,14 @@ flowchart TB
**快速启动** **快速启动**
使用 docker-compose 同时启动新闻推送和 MCP 服务: 使用 docker compose 同时启动新闻推送和 MCP 服务:
```bash ```bash
# 下载最新的 docker-compose.yml已包含 MCP 服务配置) # 下载最新的 docker compose.yml已包含 MCP 服务配置)
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker-compose.yml wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/docker/docker compose.yml
# 启动所有服务 # 启动所有服务
docker-compose up -d docker compose up -d
# 查看运行状态 # 查看运行状态
docker ps | grep trend-radar docker ps | grep trend-radar