zhihu-cli-go

name	zhihu-cli-go
description	知乎 CLI (Go 版)：搜索、热榜、问题/回答/评论、推荐 Feed、用户资料、发想法/提问/文章/回答、删除自己的内容、点赞关注、收藏与通知。单二进制，无需 Python/Node，支持 --json 输出供 AI Agent 解析，Cookie 仅存本地。
author	Rpeng
version	0.1.0
tags	["zhihu","cli","知乎","agent","go"]

zhihu-cli-go 技能

前提

• 已安装：zhihu 在 PATH 中。
  • 从源码：git clone https://github.com/rpeng666/zhihu-cli-go && cd zhihu-cli-go && make install
  • 或下载 Release 二进制，解压后加入 PATH。
• 路径：
  • Linux/macOS：~/.zhihu-cli/（cookies.json、login_qrcode.png）
  • Windows：%USERPROFILE%\.zhihu-cli\
  • 可用 ZHIHU_CONFIG_DIR 环境变量覆盖。
• 登录方式：扫码 zhihu login / 粘贴 Cookie zhihu login --cookie "..." / 环境变量 ZHIHU_COOKIE=...。
• 不得将 Cookie 内容上传、转发或写入对话/日志。

---

Instruction Scope

本技能仅限：在用户本机调用已安装的 zhihu 命令，执行搜索、热榜、问题/回答/评论、推荐 Feed、用户资料、发布与删除内容、点赞关注、收藏与通知等操作。不包含：代用户上传 Cookie、访问非知乎域名、或超出上述命令范围的操作。

---

Credentials

• 知乎登录态：存于 ~/.zhihu-cli/cookies.json（权限 0600），或由 ZHIHU_COOKIE 环境变量提供。Agent 仅通过执行 zhihu 命令间接使用，不得将 Cookie 内容写入对话或日志。

---

安装

# 从源码编译安装到 $GOPATH/bin
git clone https://github.com/your-username/zhihu-cli-go
cd zhihu-cli-go
make install

# 仅编译当前平台
make build          # 输出 zhihu 或 zhihu.exe

# 交叉编译
make cross          # dist/ 下生成 Linux/macOS/Windows 三平台二进制

---

Agent 规则

1. 诉求 → 命令：按下表映射。
2. 数据查询必须带 --json：凡执行查询类命令（search、hot、question、answers、answer、user、user-answers、user-articles、followers、following、feed、topic、collections、collection-items、notifications、whoami），必须加 --json，获取完整结构化数据。例外：feeds 不支持 --json；answer --comments 时评论不在 JSON 中，需用纯文本输出。
3. 需登录时：先 zhihu status；未登录则引导扫码或粘贴 Cookie。
4. 扫码登录：zhihu login 会在终端打印二维码字符画，并将图片保存到 ~/.zhihu-cli/login_qrcode.png（Windows：%USERPROFILE%\.zhihu-cli\login_qrcode.png）。若需发给用户，直接 Read 该图片路径展示给用户。
5. 安全：优先扫码；如用户提供 Cookie 字符串，执行 zhihu login --cookie "..." 写入本地后立即丢弃，不保留在对话中；可提醒 zhihu logout 清空。
6. 正文格式：ask -d、pin -c、article 正文、answer-write 均支持 HTML 富文本，也接受纯文本；较长内容推荐 --file answer.html 传入。

---

诉求 → 命令 速查

诉求	命令
扫码登录	zhihu login
Cookie 登录	zhihu login --cookie "z_c0=...; _xsrf=...; d_c0=..."
从文件登录	zhihu login --cookie-file cookie.txt
检查登录状态	zhihu status
查看当前用户	zhihu whoami [--json]
退出登录	zhihu logout
热榜	zhihu hot [--limit N] [--answers N] [--json]
推荐流（摘要）	zhihu feed [--limit N] [--json]
推荐流（全文+评论）	zhihu feeds [--limit N] [--comment-limit N]
搜索	zhihu search "关键词" [--type general|people|topic] [--limit N] [--json]
问题详情	zhihu question <id> [--json]
问题答案列表	zhihu answers <id> [--limit N] [--sort default|created] [--all] [--json]
答案详情	zhihu answer <id> [--comments] [--limit N] [--json]
话题	zhihu topic <id> [--json]
用户主页	zhihu user <url_token> [--json]
用户答案	zhihu user-answers <url_token> [--limit N] [--json]
用户文章	zhihu user-articles <url_token> [--limit N] [--json]
粉丝列表	zhihu followers <url_token> [--limit N] [--json]
关注列表	zhihu following <url_token> [--limit N] [--json]
点赞答案	zhihu vote <answer_id>
取消点赞	zhihu vote <answer_id> --neutral
关注问题	zhihu follow-question <id>
取关问题	zhihu follow-question <id> --unfollow
关注用户	zhihu follow-user <url_token>
取关用户	zhihu follow-user <url_token> --unfollow
提问	zhihu ask "标题" [-d "描述"] [-t 话题id] [-i 图片]
发想法	zhihu pin "标题" [-c "正文"] [-i 图片]
发文章	zhihu article "标题" "正文" [-t 话题id] [-i 图片] 或 --file body.html
回答问题	zhihu answer-write <question_id> "内容" 或 --file answer.html
删问题	zhihu delete-question <id> [-y]
删想法	zhihu delete-pin <id> [-y]
删文章	zhihu delete-article <id> [-y]
我的收藏夹	zhihu collections [--limit N] [--json]
收藏夹内容	zhihu collection-items <id> [--limit N] [--json]
通知列表	zhihu notifications [--limit N] [--json]

---

执行流程

用户诉求
  → 查上表得命令
  → 若该命令需登录：zhihu status
    → 未登录：zhihu login（扫码）或 zhihu login --cookie "..."
  → 执行 zhihu <子命令>
    → 数据查询类：必须带 --json
    → feeds / answer --comments：纯文本输出
  → 整理结果或报错提示

---

配置（.env）

在 zhihu-cli-go 目录或 ZHIHU_ENV_FILE 指定路径创建 .env，可覆盖所有默认值：

# 跳过登录流程，直接使用 Cookie 字符串
ZHIHU_COOKIE=z_c0=xxx; _xsrf=yyy; d_c0=zzz

# 自定义配置目录（默认 ~/.zhihu-cli）
ZHIHU_CONFIG_DIR=/path/to/dir

# 浏览器指纹
ZHIHU_CHROME_VERSION=145

# 扫码超时（秒）
ZHIHU_QR_TIMEOUT=120

完整变量列表见 .env.example。

---

常用示例

# 登录
zhihu login
zhihu login --cookie "z_c0=xxx; _xsrf=yyy; d_c0=zzz"

# 浏览
zhihu hot --limit 10 --json
zhihu search "Go 并发" --json
zhihu question 12345678 --json
zhihu answers 12345678 --limit 5 --json
zhihu answer 87654321 --comments

# 用户
zhihu whoami --json
zhihu user someone --json
zhihu user-answers someone --limit 10 --json

# 发布
zhihu pin "今天学了什么" -c "<p>Go 泛型真好用</p>"
zhihu ask "如何学习 Go？" -d "有没有推荐的书"
zhihu article "标题" --file body.html
zhihu answer-write 12345678 --file answer.html

# 删除
zhihu delete-pin 98765432 -y
zhihu delete-article 11111111 -y

# 退出
zhihu logout

---

登录方式详解

方式	命令	说明
扫码	zhihu login	终端打印二维码字符画；图片保存到 ~/.zhihu-cli/login_qrcode.png
Cookie 字符串	zhihu login --cookie "z_c0=...; _xsrf=...; d_c0=..."	从浏览器 F12 → Network → 请求头 Cookie 复制
Cookie 文件	zhihu login --cookie-file cookie.txt	文件内容为 cookie 字符串
环境变量	ZHIHU_COOKIE=z_c0=...	设置后无需执行 login，直接使用

---

错误处理

错误	处理
未登录 / 401	zhihu login 重新登录
403 反爬	扫码时若自动轮询被拦截，工具会切换为手动模式，提示用户在手机确认后按 Enter
Cookie 不完整	重新登录，确保包含 z_c0、_xsrf、d_c0 三个字段
超时 / 网络	检查网络，重试
ID 无效	检查问题/答案/用户 url_token 是否正确