# yaozeyuan/zhihuhelp

> zhihuhelp is a local desktop tool for saving Zhihu content to your computer. It fetches answers, articles, ideas, questions, collections, columns, topics and user content into a local SQLite database. It then produces fixed HTML, Markdown and EPUB output for offline reading and AI analysis. The project is written in TypeScript and runs on Node.js.

Source: https://github.com/yaozeyuan/zhihuhelp
Indexed: commit d041131 on 2026-09-16 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: TypeScript
- Stars: 985 at index time
- Code health: 6.6/10, Fair
- Last commit: 2026-08-09
- Contributors: 8

## Install

From the README: https://github.com/yaozeyuan/zhihuhelp

Clone the zhihuhelp repository.
    git clone https://github.com/yaozeyuan/zhihuhelp.git

Move into the zhihuhelp folder.
    cd zhihuhelp

Install pnpm globally with npm.
    npm install --global pnpm@11.5.0

Install the project dependencies.
    pnpm install

Build the project.
    pnpm build

Start the desktop GUI.
    pnpm startgui

## How it works

The user interface lives in client/src, and client/src/main.tsx and client/src/app.tsx are its entry points. Pages such as client/src/page/home/component/log/index.tsx show run status, and client/src/page/home/component/db_explorer/index.tsx lets you browse the saved data. The core logic is in src, the largest module, and src/index.ts is its central file. src/application/workflow/generate/customer.ts is a hotspot in the generation workflow that turns fetched content into output files. Fetched content is stored in a local SQLite database, and the output is written as HTML, Markdown and EPUB. Build and automation scripts are in client/script and scripts, and tests are in the tests directory.

- client/script/build.js: entry point
- client/script/start.js: entry point
- client/src/app.tsx: entry point
- client/src/main.tsx: entry point
- scripts/docs/copy-static-api.cjs: entry point
Modules: src, tests, client, scripts, doc, root. 287 files, 29,350 lines, 1,555 symbols.

## Code health

- Score: 6.6/10 (Fair)
- Rank: #179 of 4,000+ indexed repos
- Hotspots: src/index.ts, src/application/workflow/generate/customer.ts, client/src/page/home/component/customer_task/index.tsx, client/src/page/home/component/db_explorer/index.tsx, client/src/page/home/component/log/index.tsx
- Lowest file: src/index.ts
- Dead code: 62 findings

## Maintenance

- Last commit 2026-08-09, first commit 2019-02-04, 941 commits
- 8 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/yaozeyuan/zhihuhelp/security

## More

- Page: https://repowise.dev/repo/yaozeyuan/zhihuhelp
- Ask this codebase: https://repowise.dev/repo/yaozeyuan/zhihuhelp/chat
- Docs: https://repowise.dev/repo/yaozeyuan/zhihuhelp/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/yaozeyuan/zhihuhelp
