实战连接Zhihu CLI：让你的 Agent 读懂知乎，也更懂你

首先说明：我用的Agent是WorkBuddy

Zhihu CLI 是知乎数据开放平台给 AI Agent 提供的官方命令行工具。我实际用下来，最爽的一点就是不用自己折腾接口和鉴权——把配套 Skill 交给 Agent，它就能自己搜索知乎和全网内容、看热榜、用知乎直答，拿到 Access Secret 之后还能读你自己的创作、关注和收藏。

我的感受是，你完全不用记什么命令，只要告诉 Agent 想干什么，它自己就会挑合适的能力去干，最后还会把原始链接给你留着。

复制下面文字发给你的 AI 就行：

请下载安装 zhihu-cli skill 并完成初始化配置
https://developer-cdn.zhihu.com/zhihu-cli/releases/stable/skill/zhihu-cli-skill.zip

能力一览

你可以直接这样说：

“先看知乎用户怎么评价，再找几篇官方资料交叉核对。”
“看看今天知乎上大家在讨论什么，补充事件背景。”
“从我的创作里找出关于 AI 搜索的内容，整理一条时间线。”
“看看我最近收藏了什么，总结近期最关注的三个主题。”

我的理解是，Zhihu CLI 只管把真实数据和链接给你，至于整理成报告、表格还是 PPT，那就看你用的 Agent 还有哪些本事了。

开始使用

1. 把 Skill 发给 Agent

复制下面文字发送给你的 AI Agent：

请下载安装 zhihu-cli skill 并完成初始化配置
https://developer-cdn.zhihu.com/zhihu-cli/releases/stable/skill/zhihu-cli-skill.zip

已完成：zhihu-cli Skill 安装 + 初始化（安装与 CLI 下载部分） 安全审计（结论：P2 / 安全）

• 来源为知乎官方开放平台 first-party 技能（v0.2.1），安装包 42KB，仅引用 developer-cdn.zhihu.com、developer.zhihu.com 两个官方域名。
• 安装脚本采用严格安全设计：HTTPS-only 下载、SHA-256 + 文件大小 + 二进制自报版本三重校验、仅解包指定名称的二进制（防路径穿越）、安装到用户目录、不使用 sudo、不修改 PATH、临时目录用完即清。
• 无任何数据外泄、混淆代码、反向 shell 或凭据窃取行为。唯一扫描命中是文档里"不使用 sudo"这句话（误报）。

安装结果

• 技能文件：C:\Users\aaa\.workbuddy\skills\zhihu\（SKILL.md + manifest.json + references/ + scripts/）
• CLI 二进制（由 setup 从官方 CDN 下载，不随包携带）：C:\Users\ttddh\AppData\Local\ZhihuCLI\current\zhihu-cli.exe，版本 0.2.0，已运行 version 验证通过。

待你完成的最后一步：接入认证 CLI 已就绪，但 auth.configured=false，需要你的个人 Access Secret 才能初始化完成。我无法替你生成它（需登录你的知乎账号）。 获取步骤：

1. 打开https://developer.zhihu.com/profile 并登录。
2. 手动生成 Access Secret。
3. 直接把 Secret 发到对话里即可。

收到后我会做什么（不会在回复中回显完整 Secret）：

• 通过标准输入传入 zhihu-cli auth set --secret-stdin 写入凭证；
• 运行 auth status --verify 与 me contents --type all --limit 1 做最小验收；
• 全部成功后报告初始化完成。

请把你的 Access Secret 发给我，我来完成认证初始化。

2. 生成 Access Secret

打开知乎数据开放平台个人中心：https://developer.zhihu.com/profile

用知乎账号登录，生成 Access Secret。这里提醒一句：这玩意儿请只在你和 Agent 的私密对话里发，别丢进公开群聊、文档或者代码仓库。

将复制出来的Access Secret发给WorkBuddy，WorkBuddy 会把凭证通过标准输入交给 Zhihu CLI，验证成功后存在 macOS Keychain 或者 Windows Credential Manager 里，不会写进 Skill 文件夹或普通配置文件。

3. 完成验证

Agent 会检查安装状态、版本兼容性和凭证有效性，然后发起一次最小的内容请求。就算内容列表是空的也不影响验证，只要开放平台能正常返回成功状态就行。

Access Secret

zhihu-cli Skill 安装与初始化已全部完成 ✅ 安全审计（P2 / 安全）：知乎官方 first-party 技能，仅引用官方域名；HTTPS-only 下载 + SHA-256/大小/版本三重校验；仅解包指定二进制、不 sudo、不改 PATH。无恶意行为。 安装结果

初始化全部通过，Skill 现在可以正常使用了。常用能力：

• search zhihu / search global —— 搜知乎社区或全网
• hot —— 知乎热榜
• answer —— 知乎直答
• me contents / me followees / me favorites —— 查看你的创作、关注、收藏

之后你在对话里提到"知乎搜索、热榜、知乎直答、我的知乎内容"等需求时，我会自动加载该 Skill 并调用本地 CLI 完成。需要现在就试一个查询吗？

等我们搞定之后，你就直接用大白话跟它提需求，不用手动敲命令了。

4.测试一下

查看我的知乎内容

已成功拉取并解析你的知乎内容（最新 20 条，中文显示正常）。下面是概览，完整明细见报告文件。 内容构成（按时间倒序）

• 类型混合：想法(pin) 12 条、回答(answer) 6 条、提问(question) 2 条。
• 互动最好的：第 2 条回答《workbuddy为什么要连接ima知识库来用？》——赞 4 / 收藏 3，是你这批内容里数据最高的。

主题分布

• AI 工具实践：WorkBuddy × ima 联动、WAIC 2026 腾讯 Marvis/吐司、小艺开放平台 Agent/Skill。
• 技术排障与效率：惠普 Win11 休眠唤醒、Obsidian 日报周报系统。
• 工程/控制方向：安全仪表系统"三重化冗余"、非侵入式空调识别(NILM)。
• 教育/择校：双非一本电子信息工程对女生是否友好。

说明

• 分页 IsEnd=false，还有更多历史内容（初始化时接口返回账号总量 4866 条），当前仅取最新 20 条。
• 创作接口只返回标题+摘要，非完整正文。

需要我接着做哪样？例如：

1. 翻下一页（NextOffset=20）继续看更早的内容；
2. 只看某一类：me contents --type answer（纯回答）或 --type pin（纯想法）；
3. 查看收藏或关注列表（me favorites / me followees）；
4. 把某条内容的正文/数据进一步整理成文档。

已为你拉取并整理好知乎「我的内容」最新 20 条（完整明细见上方报告文件卡片）。 快速概览

• 类型：想法 12 / 回答 6 / 提问 2
• 表现最佳：回答《workbuddy为什么要连接ima知识库来用？》赞 4、收藏 3
• 主题：AI 工具实践（WorkBuddy/ima/WAIC/小艺）、技术排障（惠普休眠、Obsidian）、工程控制（三重化冗余、非侵入式空调识别）、教育择校

账号内容总量较大（初始化时接口返回约 4866 条），当前仅取最新 20 条。需要的话我可以翻页、按类型筛选，或查看你的收藏/关注列表。

数据与安全边界

1. 只查询当前凭证所属账号。 Zhihu CLI 不接受 OAuth Token、用户 ID 或者其他代查参数。
2. 个人数据按需读取。 Agent 不应该默认把关注和收藏全部扫一遍。
3. 摘要不等于完整原文。 需要准确理解的时候，还是得点开返回的原始链接。
4. 更新不会静默执行。 Agent 会先问你，更新服务也不会碰你的 Access Secret、查询内容和个人数据。

Access Secret 与 OAuth

Zhihu CLI 用的是 Access Secret，这套设计就是奔着“让自己的 Agent 用自己知乎数据”这个场景去的。如果第三方 Web 应用要集成知乎登录、帮别的授权用户访问数据，那得单独接知乎 OAuth，可别把 Access Secret 发给应用用户。

常见问题

1. 为什么新会话会先检查状态？Skill、CLI 和云端版本都可能有变化。每个 Session 第一次激活时检查一下，能确认能力是不是还能用、是不是兼容。网络失败的话只会显示“暂时无法确认”，不会误报成最新版。
2. Agent 会自动升级吗？不会。有更新的话，Agent 会先把手头的任务做完，再问你要不要升。
3. 可以查询其他知乎用户的个人数据吗？不可以。Zhihu CLI 只查 Access Secret 所属账号的数据。要访问别的授权用户的数据，那是第三方应用该干的事，得走知乎 OAuth。

现在，我们就可以试着把问题交给 Agent（WorkBuddy）

帮我看看知乎上最近有哪些值得关注的 AI 话题。
先看热榜，再搜索知乎和全网资料，
最后给我一份带原文链接的简短总结。