dsh-zhihu-dashboard

dsh-zhihu-dashboard

English | 中文

A Zhihu (知乎) dashboard plugin for DeepSeek Harness: hot list, follow feed, post tracking, and app-idea distillation — usable from the DSH UI and directly in agent conversations as native tools.

Built on the official zhihu-cli (知乎开放平台). Requires a free Zhihu Open Platform Access Secret.

Features

Panel (UI)

• 热榜 (Hot list) — today's trending questions/articles, with trend arrows (新上榜 / ↑ / ↓) computed by diffing successive snapshots
• 关注动态 (Feed) — your recent favorites, your own creations (sort by latest or most-liked), and the people you follow
• 帖子追踪 (Post tracking) — watch a question (all its answers), a keyword (similar new content), or a person (their new posts, author-filtered). New content is flagged NEW and surfaced inline under the tracked item immediately, so you do not need to hunt for it; optional auto-brief distills newly found posts into app-idea briefs via Zhihu Zhida; optional system notifications + a sidebar unread badge — the background checker runs in the DSH top window, so you get alerted while using DSH, without opening the panel
• 收藏夹 (Favorites) — browse collections with each collection's content shown inline immediately, with local search, favorite-specific sorting, NEW markers for newly seen collection items, and research-pack export
• 未读 (Unread) — an aggregated feed of everything newly found across your tracks (source track / author / time / summary); the sidebar badge jumps straight to it, with one-click mark-all-read
• Smart brief — auto-route candidates to templates by followed object/source (person views, question progress, topic trends, development opportunities, research projects, favorites review), generate with the current DSH provider/model, keep recent brief history, and surface a global reminder that opens the panel
• Opportunity report — aggregate candidates from hot/feed caches, tracked NEW items, unread items, the workspace, and research projects; score them locally and use the current DSH provider/model to generate a development-opportunity report, with prompt copy as fallback
• Data sources — Access Secret remains the Open Platform path; Settings supports Zhihu QR login, the host persists the read-only session locally with one-click clearing, and browser Cookie/profile reading has been removed from the user-facing UI
• Content workspace — send any card to a local workspace as Later / Analyze / Done, review grouped queues in a dedicated tab, create research projects, and copy project-level Agent analysis prompts
• Reading mode — open any card inside the panel as a clean reader view with source metadata, original-link access, and one-click Markdown copy
• Tracking search controls — configure per-track result count, content type, and recency window; recent tracking queries are suggested back in the tracker input
• Local sorting / scoring — choose platform order, newest-first, likes-first, time-first, or a local score weighted by your preferred keywords
• Export / research packs — copy the current hot/feed/favorites/unread/tracked-new list as Markdown or CSV, ready to paste into an agent conversation for analysis
• Local content filters — browser-local keyword, author, and regex block rules apply across hot list, feed, favorites, unread, and tracked-post checks; cards include quick block buttons, and settings keep a recent block history with one-click undo
• Access Secret and limits are configured in the panel's own Settings dialog (stored in browser localStorage only)

Agent tools (conversation)

Tool	What it does
zhihu_search	Search Zhihu content (titles/authors/summaries/links)
zhihu_hot	Current hot list
zhihu_answer	Zhihu Zhida (retrieval-augmented answer / app-idea distillation)
zhihu_global_search	Whole-web search with a recency window (sinceHours) and realtime index
zhihu_followees	List the users your account follows
zhihu_my_contents	Your own creations (sortable by likes to find your best content)
zhihu_favorites	Favorite collections / one collection's items

Install

dsh plugin --profile web add dsh-zhihu-dashboard

Or add it to your profile's cordis.patch.yml bundle layer. Restart dsh web.

Prerequisites

1. Install the zhihu-cli skill (dsh skill install zhihu or your harness's skill flow) so the CLI binary is on PATH / standard install location — the plugin auto-detects it (cliPath config → ZHIHU_CLI_HOME → PATH → platform default)
2. Get an Access Secret at developer.zhihu.com/profile
3. Provide the secret to the CLI: printf '%s' 'zh-…' | zhihu-cli auth set --secret-stdin, or set ZHIHU_ACCESS_SECRET env for agent tools, or enter it in the panel (browser-local)

💡 First launch: with no secret configured, the panel shows a three-step onboarding card (open the platform → create an Access Secret → paste & verify); it loads data automatically once verification passes.

How it works

• Host half (lib/): serves /zhihu-dashboard routes behind the same Host/Origin trust fence as the DSH API gateway, drives the zhihu-cli binary, and registers the seven agent tools via ctx.tools.register
• Client half (src/client/, bundled to client/client.js): a 知乎面板 button in the official sidebar foot (sidebar.footer.action) opens a right-hand drawer (shell.overlay) embedding the panel — global, shared across sessions, no third-party sidebar dependency; it also mounts the background track checker (track-checker.ts, running with the DSH top window) which checks tracked items on a schedule and raises system notifications / the sidebar unread badge when something new appears

Configuration

Option	Default	Meaning
cliPath	auto-detect	Path to the zhihu-cli binary
hotLimit	10	Hot list item count (1-30)
feedLimit	10	Feed item count (1-50)
refreshSeconds	0	Auto-refresh for hot/feed (0 = off)

Panel-only options (browser localStorage): Access Secret, track-check interval, auto-brief toggle, system-notification toggle, and local block rules for keywords, authors, and regex patterns.

Today's hot/Zhida quota is shown at the top of the panel so you don't silently run out.

Quotas

Zhihu Open Platform trial quotas (shared across all your secrets): hot list 100/day, Zhida 100/day, search 5,000/day. Auto-brief and question-title resolution each cost one Zhida call; tracking checks use search.

Security

• Access Secret never leaves the browser's localStorage except as a same-origin request header to the host; it is injected into the CLI via ZHIHU_ACCESS_SECRET (never in argv, never written to the keychain by the plugin)
• Routes enforce the same trusted-Host/Origin fence as DSH's /api gateway
• No telemetry, no external calls beyond the Zhihu Open Platform API

Development

pnpm install
npx tsdown --config tsdown.config.ts   # build client/client.js
npx tsc -p tsconfig.client.json        # typecheck client sources

License

MIT