# zreaderPy

**Repository Path**: Dinomorphia/zreader-py

## Basic Information

- **Project Name**: zreaderPy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-28
- **Last Updated**: 2026-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZReader

基于 **PySide6 + QtWebEngine** 的知乎离线收藏阅读器。在知乎页面中注入「收藏到 ZReader」按钮，一键把回答/文章保存到本地 SQLite，支持全文检索与 Markdown / HTML / PDF 导出。

详细设计见 [TECH_DESIGN.md](./TECH_DESIGN.md)。

## 环境（uv）

```powershell
uv sync                 # 创建 .venv 并安装依赖
uv run zreader          # 启动应用
uv run pytest -q        # 运行测试
```

数据目录：`%LOCALAPPDATA%\ZReader`（可用环境变量 `ZREADER_DATA_DIR` 覆盖）。

## 使用

1. 左侧为资料库，右侧为浏览器；首次启动加载知乎首页，可正常登录（登录态持久化在 `profile/`）。
2. 打开任意回答或文章，交互栏会出现「☆ 收藏到 ZReader」，点击即入库；已收藏显示「★ 已收藏」。
3. 双击左侧条目在本地阅读器中打开，工具栏可导出 Markdown / 单文件 HTML / PDF。

## 调试

```powershell
$env:QTWEBENGINE_REMOTE_DEBUGGING=9222; uv run zreader   # Chrome DevTools: http://127.0.0.1:9222
```