Skip to content

xinetzone/SpecWeave / .agents/skills/zhihu

使用知乎开放平台搜索知乎和全网内容、获取热榜、调用知乎直答,读取当前用户自己的知乎创作、关注与收藏,列出、检索和上传知识库,或查询开放 API 剩余额度。用户提到知乎搜索、社区观点、真实经验、热点、热榜、知乎直答、我的知乎内容、我的关注、我的收藏、知识库、RAG、API 额度、剩余额度、用量、开放平台、API、MCP、Access Secret,或要求查看、安装和配置知乎 Skill 时使用。深度研究优先返回搜索原始来源;本人数据和知识库只读取完成任务所需的最小范围。

知乎开放平台

当前 Skill 版本:0.5.0

通过知乎官方 CLI 使用公共知识与当前用户自己的知乎 Context。日常任务优先调用 CLI;只有开发接入场景才读取原始 HTTP API、OAuth 或 MCP 文档。

首次检查与初始化

每个 Session 第一次激活这个 Skill 时,先定位本文件所在的 Skill 根目录,再运行一次无副作用的状态检查。同一 Session 后续调用不要重复检查,也不要先调用 PATH 中来源不明的 zhihu-cli。

Skill 的安装、升级、备份与回滚由宿主管理。若宿主创建备份,应备份完整的 Skill 目录,并存放在非自动发现区域;不得在任何 Skill 自动发现目录中创建同名、带后缀或其他仍可被识别为 Skill 的备份目录,避免宿主同时发现多个 zhihu Skill。

# macOS / Linux
bash <skill-dir>/scripts/run.sh status

# Windows PowerShell
powershell -ExecutionPolicy Bypass -File <skill-dir>/scripts/run.ps1 status

根据返回 JSON 处理:

  1. installed=false:说明 CLI 将安装到用户目录,不需要管理员权限,也不修改 PATH;询问用户是否现在安装。未得到明确同意时停止。
  2. update_check.status=unavailable:只表示本次无法确认远端版本,不得声称已是最新版;本地 CLI 可用时继续用户任务。
  3. compatible=false:当前 CLI 低于 Skill 最低要求,先请求用户授权升级,升级完成前不调用业务命令。
  4. CLI 或 Skill 存在可选更新:先完成当前任务,再简短提醒用户;只有用户同意后才更新。
  5. 用户已经明确要求“安装并初始化”,或提供了明确要求完成初始化的开放平台安装 prompt:视为同时授权安装 CLI、在线验证 Access Secret,并最小读取一条本人内容作为验收;后两项会调用开放平台接口,可能消耗接口额度,无需逐项重复询问。若用户只授权安装,不执行第 9 步。
  6. 获得授权后,运行对应平台的 scripts/setup.sh 或 scripts/setup.ps1,保存 stdout JSON 中的绝对 binary_path,再运行一次 status。
  7. auth.configured=false:引导用户打开 https://developer.zhihu.com/profile,登录并手动生成 Access Secret,然后等待用户在对话中发送。
  8. 收到 Access Secret 后,不在回复中复述完整内容。启动以下命令,并通过进程标准输入传入 Secret:
<binary_path> auth set --secret-stdin
  1. 配置成功且已有第 5 条初始化授权,或另行得到用户明确同意后,执行:
<binary_path> auth status --verify
<binary_path> me contents --type all --limit 1

auth status --verify 会发起一次本人内容相关请求验证凭证,me contents --type all --limit 1 会再发起一次最小业务请求验收实际命令;两次调用都可能消耗接口额度。两条命令都成功后才报告初始化完成;内容列表为空也算成功。已经安装并完成授权时,不重复初始化,直接处理当前任务。

本次任务的所有调用都使用状态检查或 setup 返回的 binary_path。下文 <CLI> 均代表这个绝对路径,不是要求 PATH 中存在裸命令。

Skill 包不携带 CLI 二进制。setup 获得用户授权后,从发布时注入的官方 HTTPS manifest 只下载当前平台版本,校验 host、文件大小、SHA-256、归档结构和二进制自报版本后安装到用户目录;不使用 sudo,也不修改 PATH。Linux 默认遵循 XDG 用户数据目录;桌面凭据使用 Secret Service,headless 使用进程级 ZHIHU_ACCESS_SECRET。安装协议和故障处理见 CLI 使用文档。

选择能力

用户目标命令边界
找知乎回答、文章、经验或观点search zhihu返回知乎社区原始内容和链接,适合阅读、研究和保留证据
找新闻、官网或外部权威来源search global返回知乎之外的全网来源
同时需要社区观点和外部证据两种搜索分别调用分开检索后综合,不把两类来源混成一个黑盒
了解当前关注热点hot只代表当前热度;需要解释或核实时继续搜索
快速获得综合答案answer先检索再生成答案,不替代原始资料研究
查看我的创作、关注和收藏me ...只查询当前 Access Secret 所属账号的公开范围数据
查看或检索知识库knowledge bases/items/search只读取完成任务所需的知识库和分页结果
上传文件到知识库knowledge upload只上传用户明确指定的单个文件,固定使用 --progress
查看开放 API 额度quota查询当前账号的当日统一额度;只在用户需要余额或调用判断时查询

只调用完成用户目标所需的最小组合。深度研究、事实核查、观点比较和原文阅读使用搜索,不用直答替代原始资料。

调用

不确定参数、输出或边界时,先运行 <CLI> <command> --help。CLI help 是当前版本的运行时事实源;<CLI> capabilities 提供机器可解析的能力清单。

搜索知乎

<CLI> search zhihu --query "用户问题" --count 10

优先使用返回的 Title、AuthorName、ContentText 和 Url。搜索摘要不是完整原文。

搜索全网

<CLI> search global --query "用户问题" --count 10

需要站点、时间、索引库等高级筛选时,先运行 <CLI> search global --help。

获取知乎热榜

<CLI> hot --limit 20

热榜适合发现议题,不等于事实核查或完整事件解释。

调用知乎直答

<CLI> answer --query "用户问题"

需要切换快速、深度思考或智能检索模型,以及使用流式输出时,先运行 <CLI> answer --help。

查看我的创作和关注

<CLI> me contents --type all --sort ts --order desc --offset 0 --limit 20
<CLI> me followees --offset 0 --limit 20

创作接口只返回标题与摘要,不把 Summary 当作完整正文。分页响应的 Paging.IsEnd=false 时,只有用户需要更多结果才使用 NextOffset 请求下一页。

查看我的收藏

<CLI> me favorites recent --limit 20
<CLI> me favorites lists --limit 20
<CLI> me favorites items --url-token 123456789 --offset 0 --limit 20
  • recent 只表示近期收藏,没有分页,不等于完整历史。
  • 读取指定收藏夹时,先从 favorites lists 获取 URL Token,再调用 favorites items。
  • 收藏夹列表当前没有 Paging,服务端忽略 Offset;CLI 因此只提供 --limit,不承诺遍历全部收藏夹。

本人命令不得添加 OAuth Token、用户 ID 或其他代查参数。未经用户明确要求,不把完整关注或收藏写入文件或长期记忆。

使用知识库

<CLI> knowledge bases --scope all
<CLI> knowledge items --base-id 7526139256098382426 --limit 20
<CLI> knowledge search --query "用户问题" --scope personal --limit 10
<CLI> knowledge upload --file "/absolute/path/to/file.pdf" --progress
  • items 的 Cursor 是服务端返回的不透明值;只有 HasMore=true 且用户确实需要更多结果时才继续。
  • search 至少重复传入一个 --base-id 或 --scope,不要使用逗号拼接多个值。
  • 遇到空结果或限流时不要循环调用。
  • 只有用户明确指定文件并授权上传时才调用 upload;不扫描目录、不批量上传,固定携带 --progress。
  • 上传默认客户端等待上限为 200s;慢网络可显式调高 --timeout。超时或断线后先用 knowledge items 核对,不能无条件重传。

查询额度

<CLI> quota
<CLI> quota --api-id knowledge
<CLI> quota --api-id knowledge --api-id tools
  • 用户询问“还剩多少额度”时调用 quota;不定时轮询,也不为每次普通请求预先查询。
  • 默认返回全网搜、知乎搜索、热榜、知乎用户数据、直答、知识库和小工具 7 个统一额度项。
  • 用户只关心部分能力时重复传入 --api-id;合法值为 global_search、zhihu_search、hot_list、user_data、zhida_openai、knowledge、tools。
  • 知识库和小工具分别使用 knowledge、tools 统一额度。
  • 用 TotalQuota、TotalUsed、RemainingQuota 回答当前自然日状态;查询本身不消耗这些业务额度。

呈现搜索结果

根据用户问题组织结论,并把支撑判断的来源放在附近:

结论或资料说明

- 标题 — 作者
  最相关的原始摘要
  原文链接

优先保留真正支撑回答的结果,不机械罗列全部返回项。来源冲突时直接呈现差异,不强行合并。

按需读取参考资料

日常调用不要自行重写 CLI 已封装的 HTTP 鉴权、时间戳、重试和错误处理。根据对应命令返回的 Code、Message、Data 或 Chat Completions 字段处理结果。

错误处理

  • AUTH_REQUIRED:展示 action_url,引导用户申请 Access Secret。
  • Access Secret 无效:引导用户重新生成或配置,不回显原值。
  • ENV_SHADOWS_KEYCHAIN:说明环境变量正在覆盖系统凭证库配置。
  • 配额或频率限制:停止重复调用,说明受影响能力和服务端错误。
  • 搜索无结果:缩短或改写查询;不要把鉴权失败误报为无结果。
  • 服务端错误或超时:遵循 CLI 返回,不额外重试直答 POST。
  • 知识库上传超时或断线:结果可能未知,先列出目标知识库内容确认,不直接重传。
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 466kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 466kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 466kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 193kUpdated Claude CodeCodexVerifiedInstall