{"id":13906515,"url":"https://github.com/hewenguang/circle","last_synced_at":"2025-07-18T04:31:35.912Z","repository":{"id":53754211,"uuid":"343131877","full_name":"hewenguang/circle","owner":"hewenguang","description":"让网页赏心悦目、让阅读回归初心。Circle 阅读模式提供更隐私、更轻松、更舒适的网页阅读体验","archived":false,"fork":false,"pushed_at":"2023-02-06T12:23:25.000Z","size":570,"stargazers_count":460,"open_issues_count":17,"forks_count":56,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-08-07T23:48:12.672Z","etag":null,"topics":["chrome","chrome-reader","chrome-reader-mode","distraction-free-reader","extensions","reader-mode"],"latest_commit_sha":null,"homepage":"http://circlereader.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hewenguang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-02-28T14:59:47.000Z","updated_at":"2024-08-02T03:31:46.000Z","dependencies_parsed_at":"2024-04-16T06:37:56.102Z","dependency_job_id":"c9493e10-efe3-4d0b-ac94-232a84e56067","html_url":"https://github.com/hewenguang/circle","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hewenguang%2Fcircle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hewenguang%2Fcircle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hewenguang%2Fcircle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hewenguang%2Fcircle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hewenguang","download_url":"https://codeload.github.com/hewenguang/circle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226344671,"owners_count":17610183,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chrome","chrome-reader","chrome-reader-mode","distraction-free-reader","extensions","reader-mode"],"created_at":"2024-08-06T23:01:37.391Z","updated_at":"2024-11-25T14:31:41.716Z","avatar_url":"https://github.com/hewenguang.png","language":"TypeScript","readme":"# 让网页赏心悦目，让阅读回归初心 - Circle 提供更舒适的阅读体验\n\n由染河**全职**开发的产品。v2.5.0 即将发布。认可我的工作，请我喝杯[咖啡](https://circlereader.com/donate) ☕️\n\n为了不饿死自己，v2.0.0 版加入高级功能。由于集成了用户体系，决定 v2.0 之后的版本部分开源更新。如果有同学对识别算法感兴趣，可以[看这里](https://ranhe.xyz/wang-ye-zheng-wen-ti-qu-suan-fa-yan-jiu-xue-xi/)\n\n`2022-10-10 采用 ts 重构，加入了插件体系，集成了 mainfest v3 版本热更新。`\n\n## 广而告之\n\n如果满意 Circle 阅读助手的识别能力，你的公司或者业务也刚好需要相关的功能，我们提供有私有化部署的方案，请联系我[商务合作](https://circlereader.com/contact)\n\n## 组成\n\n当前仓库包含 Circle 阅读助手的整体架构 - 插件体系和勾子机制。不包含：帐户体系、高级功能和识别算法。\n\n## 开发和构建\n\n- 执行 yarn 安装依赖\n- 执行 yarn start 后生成的 dev 文件夹下是用来调试的代码\n- 执行 yarn prod 生成的 zip 文件夹下就是可运行的扩展代码\n\n## 介绍\n\n简约、优雅、轻量，Circle 阅读助手可以是一个简单的阅读辅助工具，可以是一个小说阅读神器、可以是一个故事机，也可以是一个资料整理助手。\n\n比 Safari 阅读模式更强大的阅读助手浏览器扩展 Circle ，是浏览器自带阅读模式的扩充和完善；是电脑阅读网页、看小说、看新闻的不二神器；具有快捷键支持、自定义样式、自定义字体、自定义主题、自动滚动、自动加载下一页、大声朗读、文章大纲（outline）、返回顶部、分栏目阅读、打印阅读模式格式化之后的网页、支持浏览器自带的翻译等阅读辅助类功能。\n\n自研的解析引擎，解析更快速、解析能力更智能。自研的排版引擎，自动屏蔽 html 上的广告和噪音，和格式跑掉说拜拜。纯 js 开发的 Circle 阅读助手浏览器扩展，已经上线 Google Chrome 浏览器、火狐浏览器、Edge 浏览器、360 浏览器、Opera 浏览器。[免费下载安装 Circle](https://circlereader.com/download)\n\n## 关于 Circle 阅读助手\n\n广告太多分散注意力、配色太丑不忍直视、字体太小看不清、排版太乱找不到正文，阅读真的需要这么困难吗？\n\n有没有产品可以把网页中的内容提取出来重新整理，渲染成更方便阅读的排版界面呢？\n\n能够做到这些的产品很多，这类产品最大的问题就是识别正文效果太差，识别失败、识别成非正文、漏掉正文、漏掉主图、图片裂开等都是常事。在我看来目前做的比较好的是苹果系统的 Safari 浏览器。即使是 Safari 浏览器也或多或少的存在此类问题，除此之外 Safari 的设置界面太简单，定制型不够灵活\n\n为了解决上面普遍存在的问题，Circle 诞生了。Circle 是一款不太一样的浏览器扩展程序，我们采用自研的正文解析引擎，识别成功率大大提高，甚至于比 Safari 还要智能。只需要单击一下（或许不需要），Circle 还你最纯粹的阅读体验，为你更好的阅读保驾护航。如果你正在寻找一款极度轻量化的阅读辅助产品，Circle 也许可以打动你\n\n![Circle 识别效果](https://ranhe.xyz/post-images/parser.png)\n\n上图就是 Cirlce 的默认界面。舒适美观的界面、极易上手的操作、灵活丰富的配置、强大智能的识别算法共同成就了 Circle\n\n## 舒适美观的界面\n\n为了打造更舒适的阅读体验， Circle 内置了 5 款绚丽主题。如图所示：\n\n![Circle 舒适美观的界面](https://ranhe.xyz/post-images/color-theme.png)\n\n### 自定义主题\n\n正如莎士比亚所说 “ 一千个观众眼中有一千个哈姆雷特 ” 不同的人有不同的阅读喜好，内置的主题做不到让所有人都喜欢，所以我们支持灵活的自定义配置。如下图所示：\n\n![Circle 灵活的自定义配置](https://ranhe.xyz/post-images/theme.png)\n\n不仅仅是文字颜色、背景颜色。Circle 还支持自定义滚动条、自定义背景渐变和图片（图片暂未上线）等等\n\n### 跟随系统\n\n针对白天和夜晚的光线不同，阅读的时候为了更舒服，Circle 提供跟随系统自动切换主题功能。且支持自定义不同时间的主题\n\n![Circle 跟随系统](https://ranhe.xyz/post-images/1628575159368.png)\n\n## 独创的网页多栏阅读\n\n大屏幕用户的福利。两栏、三栏、四栏？你说了算！不浪费屏幕上的每一寸空间。\n\n![Circle 独创的网页多栏阅读](https://ranhe.xyz/post-images/column.png)\n\n## 用了会上瘾的多页解析\n\n当前页浏览其他页面内容，小说党的最爱。滚动到页面底部，秒开其他页面的内容\n\n![Circle 用了会上瘾的多页解析](https://ranhe.xyz/post-images/nextpage.png)\n\n大声朗读、自动滚动、跟随系统切换主题、查找关键字、删除内容块、现场编辑等等，只为你更好的阅读\n\n## 极易上手的操作\n\n为了让用户快速上手，Circle 整个操作流程都是经过设计的。如下列举部分逻辑：\n\n“选项页面” 默认是浏览器单独的页面，考虑到用户在浏览文章的时候想修改配置又不想离开当前页面，为此 Circle 支持当前页面直接访问选项配置页面\n\n![Circle 支持直接打开选项页面](https://ranhe.xyz/post-images/1625040265590.jpg)\n\n为了方便用户沉浸式阅读，Circle 支持多页加载（需要满足存在下页链接的条件）\n\n为了让用户零等待，程序会后台解析页面。正常浏览多页文章时，完全感觉不到加载的动作\n\n为了方便用户多页浏览退出时找不到最后在什么页面，退出 Circle 会自动跳转到最后一页\n\n为了急速展示页面，Circle 取消了 loading 页面，先展示正文，后格式化。实现秒开格式化页面\n\n为了方便用户退出当前页面还需要关闭网页，Circle 提供 “退出关闭” 选项，开启之后退出 Circle 当前页面也会同时关闭\n\n更多细节欢迎自己体验\n\n## 灵活丰富的配置\n\n借助于 Circle ，你可以调整字体，字体大小，字体间距、字体行高，字体粗细、段落间距，页面宽度等等。如下图所示：\n\n![Circle 灵活丰富的配置](https://ranhe.xyz/post-images/style.png)\n\n## 强大智能的识别算法\n\n借助于自研解析引擎的能力，Circle 更智能更强大\n\n### 正文识别效果对比\n\n你可以分别使用 Circle 和其他相关产品访问如下网址对比识别效果\n\nhttp://www.shb.cas.cn/kjjz2016/201607/t20160712_4639424.html\n\n原始网页效果\n\n![Circle 阅读模式三方原始网页](https://ranhe.xyz/post-images/1615281013027.jpg)\n\n识别效果对比\n\n![Circle 阅读模式效果对比图](https://ranhe.xyz/post-images/1615281038997.jpg)\n\n上面的网址内容结构不够规范，对于大部分产品都是从中间部分开始展示，漏掉了大段的前半部分正文（ Safari 也不例外），除此之外，请大家注意识别之后的**文章标题**！！！！\n\n### 主图识别效果对比\n\n不仅可以完美识别标题和正文，Circle 还可以智能识别主图。业界大部分产品仅仅识别正文，正文主图对于理解正文有时候也是至关重要的。 如下图对比：\n\ninfoQ 一篇文章： https://www.infoq.cn/article/m30vgkxw9alvzo9czoay\n\n![Circle 对比 infoQ](https://ranhe.xyz/post-images/1625041363522.jpg)\n\nCircle 识别的效果\n\n![Circle 识别 infoQ](https://ranhe.xyz/post-images/1625041376759.jpg)\n\nSafari 正文都识别不出来，其他产品大多**识别失败**\n\n### 多页解析识别\n\n对于当前文章页面含有下一页链接时，Circle 可以自动加载其他页面追加到当前页面\n\n![Circle 阅读模式多页加载](https://ranhe.xyz/post-images/1617696858472.gif)\n\n## 其他功能介绍\n\n### 打印文章\n\n借助于 Circle 阅读模式你可以打印任何文章。以 “如何看待市场监管总局对阿里巴巴垄断行为作出 182.28 亿行政处罚？会带来哪些影响？”为例展示如何使用 Circle 阅读模式打印知乎文章\n\n原网页如下：\n\n![Circle 阅读模式如何打印知乎文章](https://ranhe.xyz/post-images/1618068826994.png)\n\n直接右键打印效果如下：\n\n![Circle 阅读模式如何打印知乎文章](https://ranhe.xyz/post-images/1618068835801.png)\n\n安装启用 Circle 之后如下：\n\n![Circle 阅读模式解析知乎文章](https://ranhe.xyz/post-images/1618068847977.png)\n\n右键打印如下：\n\n![Circle 阅读模式打印知乎文章](https://ranhe.xyz/post-images/1618068855510.png)\n\n### 直接选择文章（聚焦模式已下线）\n\nCircle 不存在任何预先写好的模版，全部使用算法识别正文。所以对于 Circle 而言，不存在所谓的小众网站，只要是正文，就可以识别并展示。所以 Circle 做到了秒开，只要页面加载完成，立即就可以展示格式化之后的效果\n\n但是算法无法做到 100% 完美效果，为此对于无法识别的正文，你可以使用直接选取正文，噪音信息就可以消失\n\n使用入口（快捷键 f 和右键菜单）\n\n### 大纲展示\n\n当文章中含有子级目录时会统一展示在页面左侧，不含子目录的文章页面不会显示。默认是折叠的，你可以固定和隐藏\n\n![Circle 大纲展示](https://ranhe.xyz/post-images/1628562719721.png)\n\n### 返回顶部\n\n通过“返回顶部”可以快速返回页面最顶部，滚动鼠标离开顶部才会显示滚动到顶部按钮\n\n### 白/黑名单\n\n当前文章网址加入白/黑名单后，访问相关页面匹配到会自动开启。需要匹配整站可以修改网址只保留域名提交即可\n\n同时你可以搜索和翻页查看已存在的白/黑名单\n\n![Circle 白/黑名单](https://ranhe.xyz/post-images/1628575560619.png)\n\n### 快捷键\n\n通过快捷键模块，你可以自定义快捷键，且支持开关快捷键和全局开关快捷键系统\n\n![Circle 快捷键系统](https://ranhe.xyz/post-images/1628562873553.png)\n\n### 右键菜单\n\n通过右键菜单模块，你可以开关右键菜单和全局开关右键菜单系统\n\n![Circle 右键菜单系统](https://ranhe.xyz/post-images/1628575703231.png)\n\n### 配置中心\n\n通过配置中心，你可以导入导出你的设置信息。借助于高级帐户体系，你可以开启自动同步配置，方便不同设备的同步\n\n![Circle 配置中心](https://ranhe.xyz/post-images/1625043160924.jpg)\n\n### 自定义样式\n\n尽管我们的设置页面已经足够灵活，但是仍然存在无法实现的效果，对于专业人员，你可以通过自定义样式实现你自己的任何想法 💡\n\n### 本地文件支持\n\n你可以在浏览器使用本地文件，如 markdown 文件和纯文本文件，Circle 也可以识别。\n\n## 真实用户评价\n\n文海\\*：非常棒！简洁，功能也简单，**解析特别快**，用起来舒适！千万不要做复杂化了！！找了 N 久，是真的，几年了，每隔段时间就找阅读插件，只有这款最符合我的需求~\n\nAndong Wang： Awesome！Apple 上习惯了 Safari 的阅读模式，这个插件一使用我就知道是我想要的感觉了，**简洁**、**美观**。\n\nYanyan su： 值得五星推荐，比简悦简约不要太多！希望作者做一下导出功能。\n\nchuanliang zang：Reader View、简悦... 还有好几款阅读模式都在用，现在只保留了前面两个，简悦因为交了钱也退不了，功能繁杂不太想用。平常 Reader View 用的多一些，刚才试用了一下 Circle，一下子就喜欢上了。最喜欢的就是能方便的调节页面宽度、行距、段距(!!)，非常的推荐。\n\naione：之前用过一个差不多的插件，外国的，十分顺心。这个和我之前用的那个差不多。\n我不是来推荐之前那个插件的，我的意思是，可以遇见这么好同类的插件，也是十分不易的\n\nAeon Khronos：小众软件推荐过来的，确实好用！**赞**！！！\n\nLI Yi：很快很简洁，感谢开发者！非常期待黑白名单~\n\n曾小\\*：小巧，漂亮，高效！\n\n## 问题反馈\n\n意见建议、产品缺陷和其他任何问题都可以在 https://support.qq.com/products/317910 反馈\n\n## 支持我\n\n如果觉得 Circle 还不错，欢迎升级为高级帐户支持 Circle 更好的发展。你也可以在[这个页面](https://circlereader.com/donate)捐赠支持我\n","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhewenguang%2Fcircle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhewenguang%2Fcircle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhewenguang%2Fcircle/lists"}