企业官网建设流程全解析

把 iPad mini 当成论文阅读器这件事，我从去年用到现在，期间一直在折腾 GitHub 上的开源工具、脚本和同步方案，目前已经形成了一套能稳定跑通的工作流。网上聊平板看论文的帖子不少，但多数停留在“该买哪支笔”“哪个 App 好看”的层面，真正能把硬件选型、软件搭配、文件同步、PDF 整理和自动获取文献这些环节串起来的完整讲解并不多。这篇文章想补上这个缺口：从为什么我最终选了 iPad mini 而不是其他尺寸，到 GitHub 上哪些仓库值得关注，再到可复现的 Zotero + WebDAV 同步、PDF 批量重命名、GitHub Actions 自动抓取最新论文的完整流程，都会基于我自己的实际配置展开。

如果你手里已经有 iPad mini，或者正在犹豫要不要拿它来读论文，这篇文章可以直接当操作手册用。不需要把桌面端的文献管理思维原样搬到平板上，而是要把 iPad 当成一个“阅读终端 + 批注终端 + 索引终端”来设计工作流。下面从硬件逻辑开始聊。

1. 为什么是 iPad mini：论文阅读的硬件逻辑

1.1 尺寸：单页 PDF 的黄金显示区

iPad mini 6 的屏幕是 8.3 英寸，分辨率为 2266x1488，像素密度约 326 PPI。这个尺寸单独看参数没什么特别的，但竖起来读 A4 版式的论文时效果非常接近“原生态”。A4 纸的长宽比大约是 1:1.414，而 iPad mini 竖屏的显示比例大概在 3:2 左右，配合 PDF 阅读器的“适应宽度”模式，页面可以纵向铺满屏幕，上下留白很少。

相比之下，10.9 英寸甚至 12.9 英寸的大屏确实能显示更多内容，但代价是重量和握持体积。iPad mini 6 无线版约 293 克，一只手可以轻松拿住，长时间举着看手臂不会酸；iPhone 则反过来，6.7 英寸的大屏手机横着看 PDF 字太小，竖着看只能显示半页，动不动就要缩放拖动，阅读节奏会被频繁打断。所以 8.3 英寸这个尺寸，恰好卡在“字够大”和“拿得住”之间的平衡点。

我实际测量过，iPad mini 竖屏在 PDF Expert 里默认缩放比例下，一个 A4 页面基本能在屏幕上完整显示正文区，标题和页眉也能看清楚。对于双栏排版的双栏论文（比如 IEEE 模板），稍微放大一档，当前栏文字就能很舒服地阅读，需要跳到第二栏时左右滑动一下即可。

1.2 续航与握持：坐姿和躺姿都能打

论文阅读的场景通常不是坐在书桌前整块时间读，更多是通勤时看几页、午休时看一段、晚上窝在沙发里精读。这就对设备的续航和握持感提出了很高要求。

iPad mini 6 的官方标称续航是视频播放约 10 小时，实际阅读 PDF 的场景下（屏幕亮度 40% 左右，Wi-Fi 开启，主要做翻页和批注）能跑到 12 小时以上。我连续 3 小时读带大图表的视觉类论文，电量从 100% 掉到 72% 左右，整体表现属于“出门一天不用带充电器”的水平。

握持方面，iPad mini 因为窄边框和轻重量，横屏时两个拇指可以自然搭在屏幕上沿，竖屏时单手托住下半部分也不会觉得吃力。这个体验对大屏设备来说很难实现。另外还有一个容易被忽略的点：迷你机身的发热也低，长时间看 PDF 时背面只是微温，不会像某些全金属机身平板那样明显发烫。

1.3 为什么不选更大的屏幕

如果你主要在家里固定位置读论文，那 iPad Pro 11 英寸甚至 12.9 英寸都是更好的选择——屏幕大，分屏看论文和笔记更从容，配合妙控键盘还能兼顾文字输入。但它的重量和体积决定了你很难真的“手持”阅读超过半小时。我身边不少人买了大尺寸 iPad 之后，最终都变成“桌上型设备”，真正回到沙发上读论文时又掏出了手机。

相比之下，iPad mini 的定位是随时能拿起来、随时能放下的阅读器。它的分屏能力虽然不如大屏，但配合“快速笔记”手势，屏幕边缘一滑就能调出备忘录，并不影响批注和摘录。我现在的习惯是：通勤和碎片时间用 iPad mini 读题录、扫摘要、标重点；需要系统精读或写综述时，再到桌面端把 Zotero 里的标注和笔记导出，做进一步整理。

2. GitHub 上的论文阅读工具箱：从文献管理到笔记闭环

2.1 文献管理主心骨：Zotero 的 iOS 端与 WebDAV 同步

Zotero 是目前最值得选择的开源文献管理工具，它的桌面端和 iOS 端在 GitHub 上都有官方仓库，插件生态也集中在 GitHub Releases 中发布。选择 Zotero 而不是 EndNote 或 Mendeley，核心原因有两点：一是本地存储和同步方案完全可控，二是插件体系能通过 GitHub 持续获得更新。

Zotero 的同步机制分两层：题录数据走 Zotero 官方云，PDF 附件可以走官方存储（免费容量有限）或 WebDAV 协议。我推荐用 WebDAV，因为可以搭配坚果云、自建 Navidrome 或者 NAS 上的 WebDAV 服务。坚果云的免费版每月有上传流量和下载流量限制，但论文 PDF 单个体积通常只有几 MB，加载量不大，除非你一天往库里塞几百篇，否则完全够用。

iOS 端的 Zotero（App Store 直接搜索 Zotero）会自动连接你在桌面端配置好的同步账号。只要在桌面端把附件存储切换到 WebDAV，在 iPad 上就能直接阅读和批注 PDF，批注内容会回传到桌面端。这个流程的关键点是：Zotero 在 iOS 端对 PDF 的内置阅读器支持高亮、下划线和文本笔记，样式与桌面端几乎一致，因此不需要额外导出来回导。

2.2 PDF 标注：PDF Expert 与 MarginNote 的取舍

虽然 Zotero 自带 PDF 阅读器，但日常使用中我更推荐在 iPad 上装一个 PDF Expert 作为“临时阅读”的补充工具。PDF Expert 支持直接打开 WebDAV 或网盘文件夹里的 PDF，延迟低，渲染流畅，它最大的好处是“不绑定文献库”——当你从 arXiv 下载了一篇没入库的临时 PDF 时，可以直接在 PDF Expert 里读。

如果你需要精读和建立知识结构，可以试试 MarginNote 3。它能从 PDF 里摘录文字和图片生成脑图，还能把笔记导出成 Markdown，配合后续 Obsidian 使用非常方便。不过 MarginNote 的学习曲线比较陡，我建议有两种用法：轻度精读只读不改的论文用 PDF Expert；需要反复阅读、做知识关联的经典论文用 MarginNote。

Zotero 内置阅读器的定位其实也在逐步增强，尤其是它支持与桌面端标注同步，适合作为“文献库内的标准阅读环境”。我的组合策略是：入库文献优先在 Zotero 里阅读批注，临时散件在 PDF Expert 里快速浏览，重要综述类文章用 MarginNote 做结构笔记。

2.3 笔记库打通：Better Notes 与 Obsidian 的 GitHub 方案

文献读完之后，笔记才是沉淀下来的核心资产。这里我强烈推荐两个 GitHub 开源项目组合：一个是 Zotero 插件windingwind/zotero-better-notes，它能把 Zotero 中的文献笔记转化为 Markdown 格式的双向链接；另一个是 Obsidian，配合obsidianmd/obsidian-releases官方仓库获取发布包，在 iPad 上做本地笔记库。

Better Notes 解决了 Zotero 自带笔记功能单薄的问题：你可以在每条文献下建立独立的笔记页面，插入文献条目、引用标注、图片，并支持在笔记里反向链接其他文献。这样当你对一篇新论文做笔记时，能快速关联到之前读过的相似文献，形成真正的知识网络。

而 Obsidian 则负责最终的知识沉淀。所有笔记以 Markdown 文件形式存在本地文件夹里，这个文件夹如果放在一个 Git 仓库内，就可以用 GitHub 私有仓库作为同步中枢。iPad 上使用 Working Copy 这个 Git 客户端，把笔记仓库 clone 到本地，修改后 commit 并 push；桌面端同样 clone 这个仓库，在 Zotero 和 Obsidian 之间共享同一份笔记。整个工作流不需要依赖任何收费的笔记同步服务。

3. 实操：搭建一套完整的论文阅读工作流

3.1 第一步：Zotero + WebDAV 同步配置（坚果云为例）

先讲最关键的一步：让桌面端 Zotero 和 iPad 端 Zotero 共享同一份文献库和 PDF 附件。步骤如下：

1. 注册坚果云账号，登录后在网页端进入“账户信息”，找到 WebDAV 服务地址，一般是https://dav.jianguoyun.com/dav/。
2. 在坚果云安全设置里生成一个“应用专用密码”，注意这不是你的登录密码，而是专门给第三方应用使用的授权密码。
3. 在桌面端 Zotero 点“编辑 -> 设置 -> 同步”，Zotero 同步服务器保持默认（用官方账号登录），在“文件同步”区域选择“WebDAV”。
4. 填写 WebDAV 地址：https://dav.jianguoyun.com/dav/zotero，用户名填坚果云手机号或邮箱，密码填刚才生成的应用专用密码。
5. 点击“验证服务器”，成功后先执行一次全量同步，确保原有 PDF 都传到了坚果云。
6. iPad 上安装 Zotero，登录同一个 Zotero 官方账号，进入设置开启附件同步。

这里有两个容易踩的坑。第一个是 WebDAV 地址的格式：坚果云网页登录地址是https://www.jianguoyun.com，很多人会不小心填错，Zotero 里必须填dav.jianguoyun.com开头的 WebDAV 专用地址。第二个坑是路径：建议在根目录下单独建一个zotero文件夹，避免和坚果云里的其他文件混在一起，也方便以后清理。

同步完成的标准是：桌面端每个 PDF 附件的图标变成绿色圆点，iPad 端能看到文献题录并能下载附件。如果附件图标一直是蓝色云朵，说明还没同步成功，去 WebDAV 配置里重新验证即可。

3.2 第二步：iPad mini 上的软件安装与账号登录

在 iPad mini 上实现完整工作流，需要安装以下几类 App，全都是 App Store 里能直接下载的：

• Zotero：免费，负责文献库浏览、阅读、批注、同步。
• PDF Expert：付费，负责临时的 PDF 阅读和轻量标注。
• MarginNote 3：付费，负责精读和脑图整理。
• Obsidian：免费，负责 Markdown 笔记库管理。
• Working Copy：支持免费试用，负责 Git 仓库的 clone 和 push。

安装完成后先做账号登录：Zotero 登录官方账号，PDF Expert 登录坚果云 WebDAV 账号，Working Copy 登录 GitHub 账号并授权私有仓库权限。注意 Working Copy 在首次 clone 时需要生成 SSH 密钥或者在设置里登录 GitHub，我推荐直接用 SSH 方式，稳定性比 HTTPS 密码方式高。

接着在 Safari 上做一件事：把 Zotero Connector 的 iPad 扩展打开。这样当你在 arXiv 或者期刊主页看到一篇论文时，可以点 Safari 的“分享”按钮，选择“保存到 Zotero”，题录和 PDF 就能直接进库。这是 iPad 上获取文献最快捷的方式，比手动下载 PDF 再导入高效得多。

3.3 第三步：用 Python 脚本批量整理 PDF 文件

读文献到一定数量后，PDF 文件命名混乱的问题会非常突出。尤其在 GitHub 上写论文整理脚本时，常见做法是用 Python 加 arXiv API 或 CrossRef API 获取元数据，按“第一作者_年份_标题”的格式重命名文件。这里给一个简化可用的脚本思路：

import re from pathlib import Path import requests # 从文件名提取 arXiv ID 的常见正则 ARXIV_ID_PATTERN = r"(\d{4}\.\d{4,5})" def get_arxiv_metadata(arxiv_id): url = f"https://export.arxiv.org/api/query?id_list={arxiv_id}" resp = requests.get(url) # 这里解析 XML 获取 title/author/year # 简单做法：用正则匹配 <title> 和 <author><name> title = re.search(r"<title>(.*?)</title>", resp.text, re.S).group(1).strip() author = re.search(r"<name>(.*?)</name>", resp.text).group(1).strip() year_match = re.search(r"<published>(\d{4})", resp.text) year = year_match.group(1) return author, year, title def rename_pdf(path): stem = path.stem m = re.search(ARXIV_ID_PATTERN, stem) if not m: return author, year, title = get_arxiv_metadata(m.group(1)) safe_title = re.sub(r"[^\w\s-]", "", title).strip() safe_title = re.sub(r"\s+", "_", safe_title) new_name = f"{author}_{year}_{safe_title[:80]}{path.suffix}" path.rename(path.with_name(new_name)) for pdf in Path("papers").glob("*.pdf"): rename_pdf(pdf)

实际使用时有两个建议。第一，先运行 dry-run 模式，只打印将改成的名字，不要直接重命名。因为 arXiv 作者名里可能有逗号、空格等特殊字符，直接改容易出问题。第二，重命名之前一定要在 Zotero 里确认题录已经抓全，因为脚本只处理文件名层面，不会改 Zotero 的元数据。如果你只是想批量整理电脑里的临时 PDF 文件夹，这个脚本完全够用。

3.4 第四步：用 GitHub Actions 自动化获取最新论文

每天刷 arXiv 其实很浪费时间，我通常会写一个 GitHub Actions 工作流，每天自动拉取某个方向的论文摘要，生成 Markdown 索引，直接推进 GitHub 仓库。这样早上在 iPad 上用 Obsidian 打开仓库，就能看到当天更新的论文列表。

在仓库里新建.github/workflows/daily-papers.yml：

name: Daily Papers on: schedule: - cron: "0 1 * * *" # UTC 1:00，北京时间 9:00 workflow_dispatch: # 手动触发 jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 with: python-version: "3.12" - run: pip install requests feedparser - run: python scripts/fetch_papers.py - uses: stefanzweifel/git-auto-commit-action@v5 with: commit_message: "update daily papers" file_pattern: "papers/*.md"

fetch_papers.py里调用 arXiv API，按关键词搜索当日发布的新论文，把标题、作者、摘要、链接整理成一个papers/2025-XX-XX.md文件。GitHub Actions 的免费额度对个人项目非常充足，每天跑一次不会产生任何费用。这个方案的真正价值在于：你不用守在浏览器前刷新，早上醒来打开 iPad 上的笔记仓库，今日论文就已经躺在那里了。

需要提醒的是，GitHub Actions 里如果仓库是私有的，生成的 Markdown 文件默认只在仓库里可见。如果你希望别人也能看到你的每日论文汇总，可以把仓库设置为公开；如果只是自己用，保持私有也可以，Working Copy 在 iPad 上拉取完全不受影响。

4. 常见问题与排查技巧实录

4.1 附件同步显示“未同步”或冲突文件

这是 Zotero + WebDAV 方案里最常见的坑。现象是 iPad 上明明能看到 PDF，但打开附件时提示尚未下载，或者桌面端出现xxx-1.pdf之类的重复文件。原因一般有两个：一是你在 iPad 上添加了批注但 APP 提前退出了，回传没有完成；二是两台设备同时修改了同一个 PDF 的批注，Zotero 会生成冲突副本。

解决方法是：每次在 iPad 上批注完，打开 Zotero 设置手动触发一次同步，等云端状态全部变成绿色对勾后再关闭 APP；桌面端定期检查“未匹配”文件夹，把冲突文件手动处理掉。我的经验是，尽量保证一个设备为批注主力，另一个设备只做查阅，能极大减少冲突发生的概率。

4.2 扫描版 PDF 无法复制与搜索

很多老论文是扫描版，没有文字层，iPad 上无法高亮复制。解决办法是在桌面端先用开源工具 OCR 补层，其中jbarlow83/ocrmypdf是我在 GitHub 上用得最多的工具。装好之后在终端运行：

ocrmypdf -l chi_sim+eng input.pdf output.pdf

这个命令会生成一个带 OCR 文字层的新 PDF，再把它替换 Zotero 里的附件。注意-l chi_sim需要提前安装 Tesseract 的中文语言包，如果你处理的论文是纯英文，只需要-l eng即可。处理扫描版时纸质质量很重要，300 DPI 以上的扫描件识别准确率高很多，低分辨率的扫描件 OCR 后容易大量乱码。

4.3 大文件打开卡顿

iPad mini 6 的运行内存是 4GB，处理超过 200MB 的带超高分辨率图片的论文时会明显卡顿。我的解决办法分两层：第一层是尽量把附件控制在合理体积，用 PDF Expert 的“压缩文件”功能把 200MB 的 PDF 压缩到 30MB 左右，视觉差异不大；第二层是遇到特别大的文件时，不用 PDF Expert，而是用 Zotero 内置阅读器打开，它的分页渲染机制在处理大文件时反而比第三方阅读器更流畅。

还有一个容易被忽略的问题：如果你从 GitHub 上下载一个包含很多 PDF 的资源仓库，千万不要一次性全部导入 Zotero，先清点体积，分批导入，否则 iPad 上首次同步会非常吃力。

4.4 插件安装在 Zotero 7 上失效

Zotero 6 和 Zotero 7 的插件不通用，很多人在 GitHub 上下载了新的.xpi文件但装不上，原因是版本不匹配。判断标准很简单：看插件的 Releases 页面是否标注了兼容版本。Better BibTeX 这类老牌插件通常同时提供 6.x 和 7.x 两个版本，下载时认准对应版本。安装时在 Zotero 里选“工具 -> 插件 -> 齿轮图标 -> Install Plugin From File”，从本地点选.xpi即可，不需要把文件拖进插件目录。

4.5 问题与解决速查表

这套组合用下来，最大的体会是“工具越少越好”。iPad mini 作为阅读终端，核心任务就是读和标，真正复杂的管理、整理和自动化都交给桌面端和 GitHub 后端。每次看到一篇新论文，我只需要在 Safari 里点一下分享到 Zotero，剩下的事情基本不用管。如果你也经常被大量 PDF 文献淹没，不妨照这个思路搭一套自己的闭环。