zhihu-clippings-vp

name

zhihu-clippings-vp

description

Clip Zhihu content into Obsidian Web Clipper-style Markdown bundles. Use when the user provides a Zhihu person name or people URL, article URL/title, question URL, answer URL, screenshot/OCR text, copied snippet, or mixed clues and wants official-first identity/search verification, TikHub-final fulltext retrieval, answer clipping, grouped Markdown output, or raw Zhihu clippings saved to a local inbox/vault folder.

Zhihu Clippings

When To Use

Use this skill for Zhihu clipping tasks where the user needs saved Markdown source material, including:

• locating a Zhihu author or article from a person name, people URL, article URL, title, screenshot/OCR, copied snippet, or mixed clues
• clipping zhuanlan articles into grouped Obsidian-style Markdown files
• clipping a known Zhihu answer from a question/answer URL or explicit --question-id plus --answer-id
• using screenshot/OCR or copied text as search clues, while avoiding screenshot-only final clippings

Do not use this skill for browser scraping, captcha/cookie workflows, or downstream wiki rewriting/classification.

Core Contract

Run official-first, TikHub-final:

1. Use Zhihu Developer Platform zhihu_search first for coarse positioning, author/content identity, article ID/source checks, and metadata cross-checks.
2. Use TikHub only as the final fulltext provider when official search returns summaries or when article/answer body fidelity matters.
3. Mark TikHub direct fetches as third-party content. --article-id and --answer-id can fetch through TikHub directly, but those paths are not official verification by themselves. Prefer official search verification before or after the direct fetch when possible; otherwise record/report that official verification was not completed.
4. Never create a final clipping from screenshot/OCR text, copied snippets, or official ContentText when the user expects a full article/answer body. Use those inputs as search/disambiguation clues only.
5. Stop and report clearly when neither official search can identify the target nor TikHub can return a complete untruncated body.

Generated Markdown should land in 01.raw/01.Inbox by default as unprocessed source material. Do not summarize, rewrite, classify, or move it into 02.wiki unless the user explicitly asks for that downstream step.

For detailed Markdown QA rules, heading normalization, code fence cleanup, and provider notes, read references/zhihu-notes.md when preparing or reviewing final output.

Key Commands

Default official-first search and grouped output:

python scripts\clip_zhihu_official.py "https://www.zhihu.com/people/he-yufeng Kimi AI Agent 工程实践" --author "何宇峰" --count 10 --ranges "1-5,6-10"

Force TikHub fulltext for a known people URL token:

python scripts\clip_zhihu_official.py "https://www.zhihu.com/people/he-yufeng Kimi AI Agent 工程实践" --author "何宇峰" --count 10 --group-size 5 --content-provider tikhub --user-url-token he-yufeng

Fetch a known long article through TikHub article detail:

python scripts\clip_zhihu_official.py "LeetCode Hot 100 刷题笔记" --author "若尘797" --article-id 2014501815438291918 --count 1 --ranges "1" --filename-template "知乎_{author}_LeetCode Hot 100 刷题笔记_{date}.md"

Fetch a known answer:

python scripts\clip_zhihu_official.py "https://www.zhihu.com/question/123456789/answer/987654321" --content-provider tikhub --ranges "1"

Use screenshot OCR, copied page text, or saved HTML as title/search clues:

python scripts\clip_zhihu_official.py "何宇峰 Kimi Agent" --author "何宇峰" --title-source ".\examples\profile-page.txt" --content-provider tikhub --user-url-token he-yufeng

Add extra search probes:

python scripts\clip_zhihu_official.py "何宇峰" --extra-query "何宇峰 Kimi Agent" --extra-query "何宇峰 月之暗面"

Custom output directory:

python scripts\clip_zhihu_official.py "何宇峰 月之暗面 Kimi AI Agent 工程实践" --count 10 --group-size 5 --output-dir ".\clippings\zhihu"

Default output directory:

E:\LLM_wiki\LLM_wiki\01.raw\01.Inbox

Default filename template:

知乎_{author}_{summary}_知乎文章搜索剪藏_{date}_{range}.md

{summary} should be concise, filename-safe, human-readable, and free of provider/debug labels. Older templates without {summary} remain valid.

Zhihu Archive Rules

Default clipping output remains 01.raw/01.Inbox as staging. When the user asks to archive or reorganize Zhihu source material under 01.raw/06.Zhihu, use root-level author/account folders directly under 06.Zhihu:

01.raw/06.Zhihu/
  何宇峰/
    知乎_何宇峰_知乎文章搜索剪藏_2026-05-26_1-5.md
  VoidOc/
    知乎_VoidOc_AI Agent 入门指南（一）：综述_2026-05-26_1.md
  苏三说技术/
  ._Zhihu_metadata/
  其他零散知乎md.md

• Same author/account with 3 or more files, or an author the user explicitly names as a durable folder: move files under 01.raw/06.Zhihu/<author-or-account>/.
• Fewer than 3 files, uncertain author, mixed source, or temporary collection: leave the Markdown files loose in 01.raw/06.Zhihu.
• Use the same direct author/account organization for both articles and answers unless the user later asks for separate Articles/ and Answers/ trees.
• ._Zhihu_metadata/ is a special metadata area for future indexes, aliases, logs, or cache manifests. Do not create placeholder metadata files unless there is real metadata to store.

Answer Fast Path

For known answer URLs, use TikHub fetch_question_answers after official search verification when possible. Match by exact answer_id first, then author/title/body snippets. Accept the result only when content_need_truncated is false and HTML body is present. Never regenerate final output from screenshot text or official summaries.

Official API Boundary

zhihu_search is a search API, not a complete user timeline API. Do not claim official-only output is every article from a Zhihu profile unless an official endpoint explicitly returns that complete set. TikHub can supply recent article lists, article detail HTML, and answer HTML, but it is a third-party provider; review frontmatter content_provider and verification before describing output as verified. Load references/zhihu-notes.md for detailed answer matching, query expansion, Markdown QA, and provider troubleshooting.

Authentication

Set the user environment variable before use:

[Environment]::SetEnvironmentVariable("ZHIHU_ACCESS_SECRET", "<access_secret>", "User")

If the current process cannot read it yet, restart the terminal/Codex or pass it explicitly:

python scripts\clip_zhihu_official.py "query" --access-secret "<access_secret>"

Never print the secret in normal output.

Optional TikHub fulltext key:

[Environment]::SetEnvironmentVariable("TIKHUB_API_KEY", "<tikhub_api_key_without_API_prefix>", "User")

Safety Boundaries

Do not use Playwright, cookies, captcha handling, profile-page scraping, or undocumented Zhihu web APIs in this skill. If a requested object type is unsupported and no verified TikHub fulltext endpoint is available, stop and report that the current toolchain cannot produce a complete clipping.

Sync Rule

????? skill ???????????? VectorPeak/vectorpeak-agent-skills?????????????