Skip to content

支持博客与网页文章导入、阅读批注和自动封面 - #162

Closed
wyifei26 wants to merge 2 commits into
Edwardxlai:mainfrom
wyifei26:codex/web-articles
Closed

wyifei26 wants to merge 2 commits into
Edwardxlai:mainfrom
wyifei26:codex/web-articles

Conversation

@wyifei26

Copy link
Copy Markdown
Contributor

普通博客链接目前无法作为网页文章导入文献库。本 PR 增加网页文章导入,并复用现有阅读器、笔记和 AI 对话功能。

  • 导入框和 CLI 支持博客链接,保留原网页的正文、样式、图片和链接。普通网页可自动回退到网页导入,也可以手动选择网页类型。
  • 保存静态网页快照,在隔离的 iframe 中阅读。原文、译文、双语以及 EasyRead 排版共用段落 ID,支持跨段划线、笔记、提问、引用到 AI、搜索、译文编辑和阅读位置恢复。
  • 博客自动生成文献库封面,优先使用 Open Graph / Twitter 图片,其次使用正文图片,缺图时生成标题封面。已有博客从本地快照补齐封面。
  • 网页译文和手工修改独立保存,支持离线 HTML 导出。资源归档沿用请求数与体积限制,动态正文使用本机 Chrome / Edge 的临时浏览器目录。

使用方式和存储说明见 docs/web-articles.md。

验证结果

  • 前端与桌面测试 303 项通过。
  • 博客导入、翻译和封面的 9 项 Python 回归测试通过,覆盖去重、数据保留、图片回退和并发补齐。
  • 完整 Python 测试共 667 项,665 项通过、1 项跳过、1 项失败。失败来自现有的 Claude 续译测试 test_resume_seam_owner_still_peeks_next_page,其网络预检读取了本机 Claude Code 的中转配置并连接失败。
  • Playwright 已验证网页排版切换、跨行内节点及跨段划线、原文和译文批注、笔记保存、AI 引用传递、代码批注、手工译文保存、搜索、刷新、离线导出与窄屏布局,未发现页面运行错误。
  • 文献库列表和详情封面、封面图片路由及刷新已通过浏览器验证。macOS arm64 打包、冻结后端 PDF 冒烟和 DMG 校验通过。
  • python scripts/i18n_check.py 报告缺英文 0、未套翻译的中文 0。

文献库封面截图

博客封面与详情

@Edwardxlai

Copy link
Copy Markdown
Owner

@wyifei26 感谢把网页导入接到了现有阅读器。看到了离线 HTML 的测试,也看到了文档里对未归档资源的说明。能否再覆盖一个场景:导入时有图片或样式归档失败,保存一条批注,然后断网重开导出的 HTML,确认正文仍可读、批注还能定位到原句?

@Edwardxlai

Copy link
Copy Markdown
Owner

谢谢补上资源归档失败后断网重开的测试。网页和博客导入计划随 v1.5 发布,我已经在本地整合了这版改动,也把旧文章补封面移出了打开文献库的流程。接下来我会用浏览器断网重开导出的 HTML,确认批注还能定位到原句。

@Edwardxlai Edwardxlai closed this Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants