Skip to content

itcuihao/chunzen

Repository files navigation

春蝉 ChunZen Logo

春蝉 ChunZen

在 VSCode 中沉浸式阅读学术 PDF,支持划词/划句翻译、期刊信息查询、术语表管理,让文献阅读更高效。

Version VSCode

春蝉预览

功能特性

实时翻译

  • 划词/划句翻译 — 在 PDF 中划选任意单词或句子,右侧翻译面板将自动展示翻译结果
  • 整页翻译 — 一键翻译当前页面所有段落,支持原文/译文/双语对照三种视图
  • 多引擎自动切换 — 按优先级依次尝试,首个成功即返回:
    • 百度翻译
    • DeepL(免费/专业版)
    • AI 翻译(OpenAI 兼容接口,支持 DeepSeek、SiliconFlow、Gemini 等)
    • 自定义 HTTP 接口
  • 拖拽排序引擎优先级 — 在设置面板中拖拽调整引擎顺序
  • 翻译缓存 — LRU 内存缓存 + 磁盘持久化,避免重复请求
  • 翻译历史 — 自动记录最近 100 条翻译,支持导出为 Markdown

期刊信息查询

  • 自动提取 DOI/ISSN — 从 PDF 首页文本中正则匹配
  • 双数据源 — 科研通 (AbleSci) / LetPub,自动故障转移
  • 期刊指标 — 影响因子、中科院分区、JCR 分区、预警状态
  • 深度信息 — 自引率、审稿周期、录用率、出版社、投稿链接
  • 论文元数据 — 发表年份、第一作者、通讯作者、所属机构

术语表

  • 60+ 预置学术术语 — 覆盖 AI/CS、生物医学、化学、物理、通用学术 5 大类
  • 自定义添加 — 手动添加术语对照,支持分类管理
  • 文件导入 — 支持 CSV/TSV/TXT/JSON 格式批量导入
  • 翻译时自动匹配 — LLM 引擎注入系统提示词,非 LLM 引擎后处理替换

PDF 阅读体验

  • 自定义 PDF 渲染器 — 基于 PDF.js 的 Canvas 渲染 + 文字层叠加
  • 智能段落解析 — 多栏检测、标题识别、参考文献/表格/图注结构化识别
  • 水平分隔线检测 — 从 PDF 矢量路径中提取,作为段落边界
  • 噪声过滤 — 自动跳过页眉页脚、水印、作者机构信息
  • 跨页重复文本检测 — 识别并隐藏跨页重复的边缘文本
  • 段落悬停双向高亮 — 鼠标悬停在 PDF 段落或右侧对照面板上,双向同步高亮,方便中英文逐段/逐句对比阅读
  • 表格图片回退 — 检测表格区域并截图为图片,避免乱码翻译
  • 图片区域截图 — 工具栏 📷 按钮,手动截图当前页面的图注区域

侧边栏面板

  • 翻译标签页 — 原文、译文、双语对照,支持整页翻译和自动翻页翻译
  • 期刊标签页 — 期刊基本信息、深度指标、论文元数据,可折叠展示
  • 术语标签页 — 术语列表、搜索过滤、分类标签、添加/编辑/删除
  • 设置标签页 — 引擎配置(拖拽排序)、期刊数据源、版面解析、缓存管理

主题支持

  • 暖色深色主题 — 深褐暖色调,长时间阅读更舒适
  • 暖色浅色主题 — 奶油纸张色调,自然光环境下友好
  • 自适应切换 — 跟随 VSCode 深色/浅色主题自动切换

快速开始

  1. 在项目的 Releases 页面下载最新打包的 chunzen-*.vsix 插件文件。

  2. 打开 VS Code,进入扩展视图(Cmd+Shift+XCtrl+Shift+X),点击右上角的 ... 更多操作菜单,选择 从 VSIX 安装... (Install from VSIX...),导入下载好的 .vsix 文件完成安装。

    从 VSIX 安装插件

  3. 用 VS Code 打开任意 .pdf 文件,春蝉会自动接管渲染。

  4. 在侧边栏 设置 中配置翻译引擎的 API Key。在 PDF 中划选任意英文句子,或在右侧面板点击 翻译整页,即可看到对应的翻译结果。

翻译引擎配置

AI 翻译(OpenAI 兼容接口)

支持任何 OpenAI 兼容的 API,包括 MiniMax、Gemini、本地模型等:

设置项 说明 默认值
API Key 对应平台的密钥
Base URL API 端点地址 https://api.openai.com/v1
模型名称 使用的模型 gpt-4o-mini
系统提示词 翻译风格指令 学术翻译专家提示词

MiniMax 示例配置:

  • Base URL: https://api.minimaxi.com/v1
  • Model: MiniMax-M2.7
  • API Key: 在 MiniMax 开放平台 获取

百度翻译

需要在 百度翻译开放平台 注册获取 App ID 和密钥。

DeepL

DeepL 获取 API Key,支持免费版和专业版。

命令面板

命令 说明
春蝉: 截取当前图注区域 手动截图当前页面的图片区域,保存为 PNG

键盘快捷键与阅读手势

按键 / 动作 功能
PageDown / Space (触底) / (触底) 翻至下一页
PageUp / Shift+Space (触顶) / (触顶) 翻至上一页
(触右边缘) 翻至下一页
(触左边缘) 翻至上一页
滚轮向下滚动 (触底) 翻至下一页(带 800ms 防连刷冷却机制)
滚轮向上滚动 (触顶) 翻至上一页(带 800ms 防连刷冷却机制)
+ / = 放大页面
- 缩小页面

技术栈

  • Preact + @preact/signals — 侧边栏 UI(~5KB)
  • PDF.js 3.11 — PDF 渲染引擎(CDN 加载)
  • Zustand — 侧边栏状态管理
  • Tailwind CSS — 样式系统
  • Webpack — 多目标构建(extension / panel / pdfViewer)

支持作者

如果春蝉对您的科研工作有帮助,欢迎请作者喝杯咖啡 ☕

支付宝      微信

支付宝                      微信

反馈与贡献

  • 问题反馈:GitHub Issues
  • 功能建议:欢迎提交 Issue 讨论

许可证

MIT License

About

春蝉 (Chunzen) — 沉浸式学术论文 PDF 阅读与 AI 双语翻译 VS Code 插件 | An immersive academic PDF reader and AI bilingual translation extension for VS Code.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors