JoeZhang-0x000/wenqu

项目介绍

Wenqu 是一个运行在本地的论文智能助手。它维护个人论文库，支持选中段落提问并给出页码引用，还能把论文改写成双人播客，脚本可逐行编辑，播放时同步显示文稿。适合论文越攒越多、但缺少整块时间精读，希望通勤或做家务时听完一篇论文的研究者和工程师。

功能大致分为三块：论文库由审批卡片式流程管理，负责查找、整理和添加标签；阅读页支持选中内容提问，回答会标注页码，也可对照论文代码核查；音频部分则根据脚本调用豆包语音合成。问答与写作由外部 Agent CLI 后端完成，语音合成依赖豆包 API。

快速使用

准备 Node.js 20 或更高版本、一个受支持的 Agent CLI（Claude Code、Codex、pi 或 DeepSeek Harness），以及需要生成音频时使用的豆包语音 API Key。

git clone https://github.com/JoeZhang-0x000/wenqu.git
cd wenqu
npm install
npm run build
npm start

浏览器会自动打开。在 Settings → Agent backend 选择后端并点击 Test；在 Settings → Voice API 填入豆包 Key 并测试连接。通过 Add paper 选择 PDF、粘贴 arXiv 链接，或直接把 PDF 拖进页面。若想在任何目录使用 wenqu 命令，再执行 npm link。集合、标签、配置和文件存放位置等细节见使用指南。

使用约束

项目处于早期阶段，目前仅在 macOS 上开发和测试。没有文字层的扫描版 PDF 暂不支持，代码阅读只适用于 GitHub 仓库。播客声音来自豆包，默认是中文音色，也支持合成英文和日文。AI 生成内容可能出错，发布前应对照原文核查。

论文内容只会发送给所选 Agent 服务，合成音频时发送给豆包。服务仅监听 127.0.0.1，Agent 在权限受限的空临时目录中运行，助手提出的修改需要用户批准后才会执行。论文、对话和播客以普通文件保存在 vault 中，API Key 存放在 vault 之外。完整的安全说明和限制列表见指南。

HotRepo 点评

Wenqu 于 2026-11-11 进入 HotRepo 新项目榜时收录为 103 Star；对应的增长窗口只记录到约 90 分钟、新增 3 Star，这更像早期关注，而非持续热度。该仓库尚无 GitHub 全语言日榜名次。技术上值得留意的是职责拆分：通用 Agent CLI 负责阅读和提问，应用层则用本地监听、受限临时目录和逐项审批来约束执行。对 macOS 上的论文工作流来说，这是适合早期试用的方向，跨平台支持和扫描版 PDF 处理仍有待明确。