知乎热搜

获取知乎每日热搜榜单，支持搜索、统计、范围分析。数据从 2021-01-08 至今。

Security Scan

该技能的代码、说明和所需权限在功能上是一致的：它只是从指定的 GitHub 仓库拉取并解析知乎热搜的归档/实时 Markdown 数据并缓存到用户主目录下。

Purpose & Capability

名称/描述与实际行为一致：脚本访问并解析来自 https://github.com/SnailDev/zhihu-hot-hub 的原始 Markdown 归档并生成输出/报告。没有请求与功能不相关的权限或凭据。

Instruction Scope

SKILL.md 的运行说明仅演示如何运行脚本、导出、搜索、定时任务与示例集成（subprocess 调用、cron、管道到推送工具）。脚本只读取/写入其自有缓存目录 (~/.cache/zhihu-hot) 并对 GitHub API/Raw URL 发起请求，没有读取系统敏感文件或发送数据到未声明的第三方。

Install Mechanism

无安装规范（指令型）；代码为纯 Python 脚本且没有通过下载不明二进制或第三方包管理器安装可疑组件，风险较低。

Credentials

不要求环境变量或外部凭据。唯一的本地影响是创建/使用 ~/.cache/zhihu-hot 目录用于缓存，这与脚本功能相符。

Persistence & Privilege

flags 中没有 always:true，技能不会强制常驻或修改其他技能。唯一的持久化是写入用户主目录下的缓存文件（可通过 --clear-cache 或手动删除清理）。

Assessment

总体来看这是一个自洽的、低权限的脚本工具，但在安装/运行前请注意： - 源自“unknown”，请核实并信任 GitHub 仓库 https://github.com/SnailDev/zhihu-hot-hub（仓库被篡改会改变数据来源）。 - 脚本会在 ~/.cache/zhihu-hot 下写入缓存文件；如在共享或受限环境中运行，注意清理或更改缓存路径。 - 脚本通过网络访问 api.github.com 和 raw.githubusercontent.com，会产生外发流量；在严格出站策略下可能需要批准。 - 如果计划把脚本加入定时任务或自动化流程（cron、管道到推送工具），请不要以 root 身份运行，且确认任何用于推送的外部工具（send-to-telegram、mail 等）是可信的。 - 若担心安全，可在隔离环境（容器或受限用户）中先运行，或逐行审查脚本（已包含在清单中）。

从 zhihu-hot-hub 获取知乎热搜数据。

数据覆盖: 2021-01-08 至今（1900+ 天完整归档，每小时更新）

快速使用

# 今日热搜
./zhihu-hot.py

# 前 10 条
./zhihu-hot.py -n 10

# 紧凑格式
./zhihu-hot.py -c

# 单行格式（适合推送）
./zhihu-hot.py -o

# 搜索热搜
./zhihu-hot.py -s AI

命令参数

参数	简写	说明
DATE		日期 (YYYY-MM-DD)，默认今天
--limit	-n	限制显示条数
--compact	-c	紧凑格式输出
--oneline	-o	单行格式（适合推送）
--json	-j	JSON 格式输出
--url	-u	显示完整 URL
--search	-s	搜索关键词
--range	-r	日期范围分析
--archives		显示归档信息
--export	-e	导出到文件
--clear-cache		清理缓存
--stats		缓存统计
--no-cache		不使用缓存
--version	-v	显示版本

输出格式

默认表格格式

📊 知乎热搜 - 2026-03-27

⏰ 更新：2026-03-27 08:17:05 +0800

🔥 热门搜索
┌────┬──────────────────────────────────────────┐
│  1 │ 你在低谷期学会了什么                     │
│  2 │ 郑钦文不敌萨巴伦卡                       │
│  3 │ C919 还能成批生产吗                       │
└────┴──────────────────────────────────────────┘

紧凑格式

📊 知乎热搜 2026-03-27 | ⏰ 08:17:05 +0800

 1. 你在低谷期学会了什么
 2. 郑钦文不敌萨巴伦卡
 3. C919 还能成批生产吗

单行格式（推送用）

📊 知乎热搜 2026-03-27: 你在低谷期学会了什么 | 郑钦文不敌萨巴伦卡 | C919 还能成批生产吗

JSON 格式

{
  "date": "2026-03-27",
  "update_time": "08:17:05 +0800",
  "hot_search": [
    {"title": "你在低谷期学会了什么", "url": "...", "decoded_url": "..."}
  ]
}

高级功能

🔍 搜索功能

# 搜索今日热搜
./zhihu-hot.py -s AI

# 搜索并显示 URL
./zhihu-hot.py -s 周杰伦 -u

📊 日期范围分析

# 分析本月
./zhihu-hot.py -r 2026-03-01 2026-03-26

# 分析指定周期
./zhihu-hot.py -r 2026-03-01 2026-03-15 --export report.md

📚 归档信息

./zhihu-hot.py --archives

输出：

📚 归档信息
   最早：2021-01-08
   最新：2026-03-27
   总计：1904 天

📁 导出功能

# 导出今日热搜
./zhihu-hot.py -e today.md

# 导出 JSON
./zhihu-hot.py -j -n 50 -e hot50.json

# 导出分析报告
./zhihu-hot.py -r 2026-03-01 2026-03-26 -e march-report.md

💾 缓存管理

# 查看缓存统计
./zhihu-hot.py --stats

# 清理缓存
./zhihu-hot.py --clear-cache

# 强制刷新
./zhihu-hot.py --no-cache 2026-03-20

📅 历史热搜

./zhihu-hot.py 2026-03-20
./zhihu-hot.py 2026-03-20 -n 10
./zhihu-hot.py 2021-01-08  # 最早数据

数据来源

• GitHub: https://github.com/SnailDev/zhihu-hot-hub
• 更新频率: 每小时更新
• 历史数据: 2021-01-08 至今（1900+ 天）
• 实时数据: README.md（当前）

缓存配置

类型	目录	有效期
日数据缓存	~/.cache/zhihu-hot/	1 小时
归档列表	~/.cache/zhihu-hot/	2 小时

集成示例

Python 调用

import subprocess
import json

# 获取 JSON 数据
result = subprocess.run(
    ["./zhihu-hot.py", "--json", "-n", "10"],
    capture_output=True, text=True
)
data = json.loads(result.stdout)
print(data["hot_search"])

# 范围分析
result = subprocess.run(
    ["./zhihu-hot.py", "-r", "2026-03-01", "2026-03-26"],
    capture_output=True, text=True
)
print(result.stdout)

Shell 脚本

#!/bin/bash
# 每日推送
./zhihu-hot.py -o -n 5 | send-to-telegram

# 周报生成
./zhihu-hot.py -r $(date -d '7 days ago' +%Y-%m-%d) $(date +%Y-%m-%d) -e weekly-report.md

Cron 定时任务

# 每日 9 点推送
0 9 * * * /path/to/zhihu-hot.py -o -n 10 --no-cache | mail -s "知乎热搜" [e-mail]

# 每周一生成周报
0 10 * * 1 /path/to/zhihu-hot.py -r $(date -d '7 days ago' +%Y-%m-%d) $(date +%Y-%m-%d) -e /reports/weekly-$(date +%%Y%%m%%d).md

版本历史

• v3.0 - 新增日期范围分析、归档信息查询、改进缓存管理
• v2.1 - 新增导出功能、缓存统计、彩色输出
• v2.0 - 新增搜索功能、URL 解码、多种输出格式
• v1.0 - 基础功能：获取今日/历史热搜