| name | zhihu-cli |
| description | 知乎 CLI (pyzhihu-cli)：搜索、热榜、问题/回答、发想法/提问/文章、删自己的内容、点赞关注、通知。Agent 代执行 zhihu 命令，Cookie 仅存本地。 |
| author | BAIGUANGMEI |
| version | 0.2.5 |
| tags | ["zhihu","cli","知乎","agent"] |
zhihu-cli 技能
前提
- 已安装：
zhihu 在 PATH 中（uv tool install pyzhihu-cli / pipx install pyzhihu-cli / pip install pyzhihu-cli）。
- 路径：配置与二维码路径 — Linux/macOS：
~/.zhihu-cli/（如 ~/.zhihu-cli/cookies.json、~/.zhihu-cli/login_qrcode.png）；Windows：%USERPROFILE%\.zhihu-cli\（如 %USERPROFILE%\.zhihu-cli\cookies.json、%USERPROFILE%\.zhihu-cli\login_qrcode.png）。
- 配置：登录态存于上述
cookies.json；不得将 Cookie 上传或写入对话/日志。
- 登录方式：仅两种 — 扫码
zhihu login --qrcode、粘贴 Cookie zhihu login --cookie "z_c0=...; _xsrf=...; d_c0=..."。
- 扫码时：二维码会生成到上述路径的
login_qrcode.png。若用 OpenClaw 发给用户，须先复制到 OpenClaw 工作目录的 media 文件夹再 openclaw message send --media <media 路径>。
Instruction Scope
本技能仅限：在用户本机调用已安装的 zhihu 命令，执行搜索、热榜、问题/回答、发想法/提问/文章、删除自己的内容、点赞关注、收藏与通知等操作；在用户请求扫码登录且已配置 OpenClaw 时，可将二维码图片经 OpenClaw 发送至用户指定渠道。不包含：代用户将 Cookie 上传至任何第三方、访问非知乎域名、或超出上述命令范围的操作。
Credentials
- 知乎登录态：仅存于用户本机（Linux/macOS：
~/.zhihu-cli/cookies.json；Windows：%USERPROFILE%\.zhihu-cli\cookies.json，权限 0600）。Agent 仅通过执行 zhihu 命令间接使用，不得将 Cookie 内容上传、转发或写入对话/日志。
- OpenClaw：若使用
openclaw message send 发送二维码，需用户自行配置 OpenClaw 及渠道凭证；本技能不声明、不持有该部分凭证。
安装与更新
- 安装（任选其一）：
uv tool install pyzhihu-clipipx install pyzhihu-clipip install pyzhihu-cli
- 更新：按安装方式执行
uv tool upgrade pyzhihu-cli、pipx upgrade pyzhihu-cli 或 pip install -U pyzhihu-cli。用户问「升级/更新 zhihu」时提示其执行对应命令；不确定安装方式时可三种都给出。
- 版本：
zhihu --version 查看当前版本。
Agent 规则
- 诉求 → 命令：按下表映射。
- 数据查询必须用 --json：凡执行数据查询类指令（如
search、hot、question、answers、answer、user、user-answers、user-articles、feed、topic、collections、notifications、whoami 等），必须带 --json，以获取 API 返回的完整数据，便于解析、汇总或向用户展示；不得仅依赖终端表格等非结构化输出。
- 需登录时：先
zhihu status；未登录则 zhihu login --qrcode 或引导用户 zhihu login --cookie "..."。
- 扫码登录：执行
zhihu login --qrcode 后，若本轮未发过二维码且用户已配置 OpenClaw → 先将二维码复制到 OpenClaw 工作目录的 media 文件夹，再 openclaw message send --channel <渠道> --target <目标> --media <media 路径>/login_qrcode.png --message "请用知乎 App 扫码并确认登录"；保持登录进程不中断直到成功/失败/超时；用户说「重新登录/换号」则中断当前进程再重新执行登录。复制步骤：Linux/macOS：mkdir -p ~/.openclaw/workspace/media && cp ~/.zhihu-cli/login_qrcode.png ~/.openclaw/workspace/media/；Windows：mkdir "%USERPROFILE%\.openclaw\workspace\media" 2>nul & copy "%USERPROFILE%\.zhihu-cli\login_qrcode.png" "%USERPROFILE%\.openclaw\workspace\media\login_qrcode.png"（若 OpenClaw 工作目录不同则替换为实际路径）。
- 安全：Cookie 仅本地；优先扫码，避免在不可信处粘贴 Cookie；可提醒
zhihu logout 清空。
- 升级：
uv tool upgrade pyzhihu-cli / pipx upgrade pyzhihu-cli / pip install -U pyzhihu-cli。
诉求 → 命令 速查
| 诉求 | 命令 |
|---|
| 登录 / 扫码登录 | zhihu login --qrcode |
| Cookie 登录 | zhihu login --cookie "z_c0=...; _xsrf=...; d_c0=..." |
| 重新登录 / 换号 | 中断当前进程 → zhihu login --qrcode |
| 检查登录 | zhihu status；看资料 zhihu whoami [--json] |
| 搜索 | zhihu search "关键词" [--type general/topic/people] [--limit N] [--json] |
| 热榜 | zhihu hot [--limit N] [--json] |
| 问题 | zhihu question <id>；回答列表 zhihu answers <id> [--limit N] |
| 回答详情 | zhihu answer <id> [--json] |
| 用户 | zhihu user <url_token>；user-answers / user-articles / followers / following |
| 推荐 / 话题 | zhihu feed；zhihu topic <id> |
| 赞同 | zhihu vote <answer_id>；取消 zhihu vote --neutral <id> |
| 关注问题 | zhihu follow-question <id>；取消 --unfollow |
| 发提问 | zhihu ask "标题" [-d "描述"] [-t 话题id ...] [-i 图 ...] |
| 发想法 | zhihu pin "标题" [-c "正文"] [-i 图 ...] |
| 发文章 | zhihu article "标题" "正文" [-t 话题id ...] [-i 图 ...] |
| 删提问/想法/文章 | zhihu delete-question <id> / delete-pin <id> / delete-article <id> [-y] |
| 收藏 / 通知 | zhihu collections；zhihu notifications [-l N] [--offset M] |
| 退出 | zhihu logout |
| 版本 / 升级 | zhihu --version；升级见上规则 6 |
执行流程
用户诉求
→ 若「重新登录/换号」：中断当前 → zhihu login --qrcode → [发二维码] → 等完成
→ 否则：查上表得命令
→ 若该命令需登录：zhihu status → 未登录则 zhihu login --qrcode 或 --cookie
→ 若扫码且未发过图：复制到 media → openclaw message send --media ... → 保持进程
→ 执行 zhihu <子命令>（数据查询类必须带 --json）
→ 整理结果或报错提示
登录方式
| 方式 | 命令 |
|---|
| 扫码 | zhihu login --qrcode：终端显示二维码并保存到本地（Linux/macOS：~/.zhihu-cli/login_qrcode.png；Windows：%USERPROFILE%\.zhihu-cli\login_qrcode.png）；可经 OpenClaw 发图给用户。 |
| 手动 Cookie | zhihu login --cookie "z_c0=...; _xsrf=...; d_c0=..."（浏览器 F12 → Network → 请求头 Cookie 复制）。 |
常用示例
zhihu login --qrcode
zhihu status
zhihu search "Python" --json
zhihu hot --limit 10
zhihu question 12345678
zhihu user someone
zhihu vote 87654321
zhihu pin "标题" -c "<p>正文</p>"
zhihu delete-pin 98765432 -y
zhihu notifications -l 10
zhihu logout
正文支持 HTML 富文本（ask 的 -d、pin 的 -c、article 的正文）。
OpenClaw 发二维码（仅扫码时）
- 确保二维码已生成（Linux/macOS：
~/.zhihu-cli/login_qrcode.png；Windows：%USERPROFILE%\.zhihu-cli\login_qrcode.png）。
- 复制到 OpenClaw 工作目录的
media 文件夹：
- Linux/macOS：
mkdir -p ~/.openclaw/workspace/media && cp ~/.zhihu-cli/login_qrcode.png ~/.openclaw/workspace/media/
- Windows（cmd）：
mkdir "%USERPROFILE%\.openclaw\workspace\media" 2>nul & copy "%USERPROFILE%\.zhihu-cli\login_qrcode.png" "%USERPROFILE%\.openclaw\workspace\media\login_qrcode.png"
- Windows（PowerShell）：
New-Item -ItemType Directory -Force "$env:USERPROFILE\.openclaw\workspace\media" | Out-Null; Copy-Item "$env:USERPROFILE\.zhihu-cli\login_qrcode.png" "$env:USERPROFILE\.openclaw\workspace\media\login_qrcode.png"
（若 OpenClaw 工作目录不是默认的 ~/.openclaw/workspace 或 %USERPROFILE%\.openclaw\workspace，则替换为实际路径。）
- 发送：
openclaw message send --channel <渠道> --target <目标> --media <工作目录>/media/login_qrcode.png --message "请用知乎 App 扫码并确认登录"（Linux/macOS 用 ~/.openclaw/workspace/media/login_qrcode.png，Windows 用 %USERPROFILE%\.openclaw\workspace\media\login_qrcode.png 或 PowerShell 中 $env:USERPROFILE\.openclaw\workspace\media\login_qrcode.png）。
- 不中断
zhihu login --qrcode 进程，等待用户完成。
错误处理
- 未登录 / 401 / 403：先登录（
zhihu login --qrcode 或 --cookie），再执行原命令。
- 超时 / 网络：提示重试或检查网络。
- 其他：根据 CLI 报错给简短原因与建议（如检查 ID、url_token）。
