Visitar URL original
GitHub - unarelax/page2reading_skill · GitHub
Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

page2reading

从浏览,到阅读

为什么会有

有很多不错的技术博客,我真的很想阅读,但是打开网页之后,我遇到了这些烦恼:

  • 有些文章网页的周围并没有很“整洁”,或者配色没有很“平静”
  • 有些文章真的太长了,再回来不知道网页在哪,上次读到什么位置了
  • 有些文章真是太棒了!我很怕它消失,我需要存档下来才安心
  • 网页诱惑太多,这个文章虽然很不错,但是我想去其他标签页“逛”一下
  • 使用翻译软件的结果过于机械生硬,有些文章本来就难读,翻译完了更是雪上加霜

我无法对着浏览器进行长时间和深度的阅读。一开始我是把文章链接发给我的 AI 助手,让它帮我提取并翻译的,但是它的结果并不是每次都很稳定,我需要像看“小孩”一样盯着它。我不断迭代这个产品,做出现在使用起来轻松简单、提示词风格也较为满意的版本,希望能帮到你。

快速安装使用

前提:电脑上需要装了 Node.js 18+(npx 命令和脚本都依赖它)。

当前项目安装

npx skills add unarelax/page2reading_skill -a claude-code codex cursor

全局安装

npx skills add unarelax/page2reading_skill -a claude-code codex cursor -g

更新

npx skills update

会询问更新全局还是当前项目;npx skills update -p / -g 分别只更新当前项目 / 全局。

使用

对着 AI 说就行,不用记命令。没说 PDF,就停在 Markdown。没说存哪,就在当前目录下按当天日期新建文件夹,例如 2026-09-28。重名自动加 (1)、(2),不覆盖。

  • page2reading 翻译下这个文件
  • page2reading 翻译下上传的文件
  • 帮我翻译这篇文章 https://…
  • 导出 https://… 的原文 markdown,放到桌面
  • 把 ~/Downloads/post.html 翻译一下
  • 把这篇翻译成中英对照,并存成 PDF

能处理链接、.html、.htm、.md、.markdown、.txt,以及装着这些文件的文件夹。.pdf、.docx、.epub 和其他格式会直接拒绝。文件夹里夹了不能处理的文件会跳过,并列出路径。

碰到登录墙、会员文、整页靠脚本渲染的页面,别反复试——把正文贴过来,或者把网页另存为 .html 再给它。

导出的产物

.md 导入微信读书或者导入 Obsidian 等知识管理软件。 .pdf 导入微信读书、或直接打开阅读、或者纸质打印。

生成 PDF 时中文用系统字体;如果系统里没有中文字体(比如部分 Linux),设一个环境变量 PAGE2READING_CJK_FONT 指向某个 .ttf / .otf 即可。

我是如何使用导出的文章

因为我更喜欢进行纸质阅读,纸质阅读的稀缺让我专注,边读边写让我快乐。现在的信息真是太多了,每一个都想读都怕错过。我现在一般使用工具一个月打印 1–2 次,然后每天取一小份文章带在身边“食用”,这样有明确的输入和结束,我会踏实许多。

如果你和我一样,也想打出来进行纸质阅读,可以让 skill 导出 PDF 版本。我做了两个细节:

  • 右下角设置了当前页和页码,万一打印机发生错误,方便检查
  • 原文链接做成了二维码,方便手机扫码打开原文,不用输入网址

花费

提取正文和生成 PDF 都是本机脚本,几乎不占模型额度。 主要花费在翻译,文章越长、篇数越多,花费越多。默认使用当前 Agent 翻译。 如果想要单独计算翻译的花销,可以把 config.example.json 复制为 ~/.page2reading/config.json,并配置你的 API Key。

更多玩法

  • 调整打印格式:想用 A5、B5 打印,可以用这个网址 https://markdowntoword.io/zh,把 Markdown 转成 Word 再排版。
  • 不想充值、不想用 API Key:可以只导出原文,再导入微信读书,使用微信读书自带的功能翻译。
  • 自定义提示词:目前这套提示词偏向技术文档翻译,你可以直接改 prompts/tech-translate.md,或者不用 skill、只单独用这套提示词。这篇 README 的英文版就是用这套提示词翻译的。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages