$ show YaoZeyuan/zhihuhelp

[account ↗] [repo ↗] APPLICATION ★ 973 178 ● stale (last update 3 months ago)

── AI DEEP ANALYSIS ──

reviewed by: nvidia/nemotron-3-super-120b-a12b

ZhihuHelper is a desktop application built with Electron, React, and Node.js designed to scrape content from Zhihu (a Chinese Q&A platform) and export it to EPUB/HTML formats for offline reading. The application features a GUI for task configuration and logging, alongside a CLI interface powered by AdonisJS Ace. Core functionality includes fetching various Zhihu content types (answers, articles, pins, collections, etc.) via the platform's API, storing data in a local SQLite database, and generating formatted e-books with options for sorting, image quality selection, and automatic volume splitting. The architecture separates concerns into distinct layers: Electron main process for window management and IPC, React renderer for the UI, API wrappers for Zhihu endpoints, Knex-based ORM models for data persistence, and a custom EPUB generation library. While the tool effectively accomplishes its stated purpose, it exhibits signs of technical drift due to outdated dependencies and reliance on Zhihu's undocumented API, which necessitates frequent maintenance to remain functional.

── METRICS ──

RATING6.1/10

QUALITY6.5/10

MAINTENANCEstale

DRIFTmedium

CONTRIBUTORS8

VELOCITY0.43

OPEN ISSUES68

CLOSED ISSUES44

LAST COMMIT3 months ago

── TAGS ──

#zhihu-scraper #epub-generator #electron-app #cli-tool #knowledge-management #typescript #react #sqlite

── DEPENDENCY GRAPH ──

@adonisjs/ace (npm) ^11.3.1

@adonisjs/core (npm) ^5.8.4

@types/tiny-async-pool (npm) ^2.0.0

adm-zip (npm) ^0.5.10

axios (npm) ^0.27.2

core-js (npm) 3

dayjs (npm) ^1.11.7

json5 (npm) ^2.2.1

knex (npm) ^2.1.0

lodash (npm) ^4.17.21

lru-cache (npm) ^8.0.4

md5 (npm) ^2.2.1

module-alias (npm) ^2.2.2

moment (npm) ^2.24.0

query-string (npm) ^6.4.2

rc-field-form (npm) ^1.28.0

react (npm) ^18.2.0

react-dom (npm) ^18.2.0

semver (npm) ^7.3.7

sharp (npm) ^0.30.7

shelljs (npm) ^0.8.1

sqlite3 (npm) ^5.1.2

tiny-async-pool (npm) ^2.1.0

@adonisjs/application (npm) ^5.2.5

@babel/cli (npm) ^7.18.6

@babel/core (npm) ^7.18.6

@babel/plugin-proposal-decorators (npm) ^7.21.0

@babel/plugin-syntax-flow (npm) ^7.18.6

@babel/plugin-transform-react-jsx (npm) ^7.19.0

@babel/preset-env (npm) ^7.18.6

@babel/preset-react (npm) ^7.18.6

@babel/preset-typescript (npm) ^7.18.6

@electron/osx-sign (npm)

@electron/rebuild (npm) ^3.2.10

@types/adm-zip (npm) ^0.5.0

@types/archiver (npm) ^5.3.1

@types/body-parser (npm) ^1.19.2

@types/express (npm) ^4.17.14

@types/json5 (npm) 0.0.30

@types/knex (npm) ^0.15.1

@types/lodash (npm) ^4.14.91

@types/md5 (npm) ^2.1.33

@types/node (npm) ^9.4.6

@types/react (npm) ^16.8.1

@types/react-dom (npm) ^16.0.11

@types/semver (npm) ^7.3.10

@types/sharp (npm) ^0.25.0

@types/shelljs (npm) ^0.7.8

babel-plugin-root-import (npm) ^6.6.0

electron (npm) 23.2.0

electron-builder (npm) 23.6.0

eslint (npm) ^8.13.0

eslint-config-prettier (npm) ^8.5.0

eslint-config-react-app (npm) ^7.0.1

eslint-plugin-prettier (npm) ^4.0.0

node-gyp (npm) ^8.4.0

nodemon (npm) ^2.0.20

prettier (npm) ^2.7.1

typescript (npm) ^4.7.4

── FILE BREAKDOWN ──

Files by Type (count)

TypeScript

184

Markdown

TSX

JSON

Other (.cjs)

Other (no ext)

Other (.less)

Other (.png)

YAML

CSS

JavaScript

Other (.mts)

Files by Type (size)

Other (.png)

3MB

TypeScript

994KB

YAML

356KB

Markdown

300KB

TSX

161KB

Other (.cjs)

98KB

Other (.ico)

87KB

JavaScript

35KB

CSS

33KB

JSON

28KB

Other (.0-or-later)

17KB

Other (.less)

13KB

── KEY FINDINGS: REUSABLE CODE ──

The LLM identified 2 files worth highlighting for reuse:

Self-contained EPUB generation library that processes structured content metadata and HTML strings to produce valid EPUB files, including OPF/TOC generation, image embedding, and automatic volume splitting. Demonstrates expertise in EPUB specification implementation and binary asset packaging without external dependencies beyond Node.js built-ins and two lightweight packages (adm-zip, uuid).

file: src/library/epub/index.ts ↗ | tags: #epub-generation #ebook-processing

Generic asynchronous task manager with concurrency control, rate limiting (via delay between tasks), and retry mechanisms. Isolated from Zhihu-specific logic, making it reusable for any project requiring controlled execution of async operations (e.g., API calls). Demonstrates skill in designing a flexible, dependency-free utility for managing task queues.

file: src/library/util/common.ts ↗ | tags: #task-management #rate-limiting #async-utility

── HISTORY ──

Last analyzed: 2026-07-27 22:52:30.040050

Next check: 2026-10-25 22:52:29.965000