facemini热点雷达 · 用户使用教程

版本：v1.1.0 ｜ 开发者：facemini 公司（自主研发） 产品定位：全网热榜追踪器，一键聚合微博 / 知乎 / 抖音 / B站 / 小红书五大平台热搜榜单

---

一、产品简介

facemini热点雷达是一款由 facemini 公司自主研发 的全网热点信息追踪工具。它能帮你在几分钟内掌握全网正在发生什么、什么话题正在"起飞"，以及哪些热点值得跟进，适合：

• 营销 / 运营人员：追热点做内容、蹭热度营销
• 自媒体 / 博主：选题找灵感、跟拍热门话题
• 企业市场部：竞品与行业舆情监测
• 关注热点的普通用户：快速了解全网要闻

二、功能一览

功能	说明
实时热榜获取	并行采集微博/知乎/抖音/B站/小红书五大平台热榜
跨平台热点	发现同时在多个平台发酵的热门话题
趋势分析	对比昨日榜单，识别新上榜 / 热度上升 / 落榜话题
话题监控	设置关键词，上榜自动提醒
每日报告	自动生成 Markdown 热点日报
HTML 可视化报告	带图表（柱状图 / 条形图）的交互式报告，适合分享展示

三、安装步骤

方式一：手动安装（推荐给 AI 助手环境）

1. 将压缩包解压，得到 facemini热点雷达 文件夹
2. 将整个文件夹放入 AI 助手的技能目录（例如 ~/.workbuddy/skills/）
3. 在 AI 助手中输入"查看全网热榜"等指令即可使用

方式二：命令行独立使用（无需 AI 助手）

1. 安装 Node.js（要求 14.0 及以上版本）
2. 解压后进入 facemini热点雷达 目录
3. 按下方"四、快速上手"执行命令

提示：本技能不依赖任何外部 Node 包，无需 npm install，开箱即用。

四、快速上手（命令行）

# 1. 初始化目录结构（首次使用必做）
node scripts/index.js init

# 2. 一键采集 + 生成报告（最常用）
node scripts/index.js quick

# 3. 单独采集数据
node scripts/index.js fetch

# 4. 生成 Markdown 报告
node scripts/index.js report

# 5. 生成 HTML 可视化报告（带图表）
node scripts/index.js html

# 6. 查看全部命令帮助
node scripts/index.js help

首次使用建议：依次运行 init → quick，即可获得今日全网热点日报。

五、话题监控（关键词订阅）

# 添加监控关键词（例如监控"AI"）
node scripts/monitor.js add "AI"

# 移除监控关键词
node scripts/monitor.js remove "AI"

# 列出所有监控关键词
node scripts/monitor.js list

# 查看监控状态
node scripts/monitor.js status

• 监控配置保存在 config/monitor.json
• 关键词出现在任意平台热榜时，报告会生成"话题监控提醒"板块

六、趋势分析

node scripts/index.js trend

说明：趋势分析需要至少两天的历史数据。每天运行 fetch 或 quick 会自动保存当日数据到 data/history/，积累几天后即可看到趋势变化（新上榜↑ / 上升↑ / 下降↓ / 落榜↓OUT）。

七、报告输出说明

• Markdown 报告：data/reports/YYYY-MM-DD.md，包含各平台热榜表格、跨平台热点、趋势变化、监控提醒
• HTML 报告：data/reports/YYYY-MM-DD.html，深色主题 + Chart.js 图表，浏览器打开即可查看，适合分享
• 历史数据：data/history/{平台}/YYYY-MM-DD.json，每日一份，自动累积

八、定时报告（可选）

可使用 AI 助手的定时任务功能配置每日自动推送：

1. 创建定时任务
2. 触发时间设为每天 9:00（早报）或 21:00（晚报）
3. 任务命令：node scripts/index.js quick

九、常见问题（FAQ）

Q1：某个平台显示"数据获取失败"？ 答：单个平台接口临时不可用时会自动跳过，不影响其他平台。稍后重试即可。

Q2：需要安装依赖吗？ 答：不需要。本技能全部使用 Node.js 内置模块，无需 npm install。

Q3：数据会占用多大空间？ 答：每天约几十 KB 的历史数据，可放心长期运行。不需要历史数据时可直接删除 data/history/ 目录。

Q4：可以自定义监控关键词数量吗？ 答：可以，支持多个关键词同时监控，逗号分隔添加即可。

Q5：报告能推到微信群吗？ 答：生成的 Markdown / HTML 报告可复制内容或文件，手动转发到任何群聊；也可结合定时任务自动输出。