Skip to content

docs(library): V0.8 文章库 spec + 实现计划#45

Merged
bob798 merged 3 commits into
mainfrom
feat/library-spec
May 21, 2026
Merged

docs(library): V0.8 文章库 spec + 实现计划#45
bob798 merged 3 commits into
mainfrom
feat/library-spec

Conversation

@bob798
Copy link
Copy Markdown
Owner

@bob798 bob798 commented May 19, 2026

Summary

新增 V0.8「文章库」(/library) 的设计 spec + 实现计划,与现有 BBC /articles 改名 spec 并行 ship。

  • 新模块/library — 用户自带英文技术文档(GitHub Markdown / 任意 URL / 粘贴正文)的导入、阅读、点词翻译、自动沉淀回看
  • MVP 范围:URL/粘贴 → 列表 → 阅读 → 点词/选区翻译 → 自动入生词本
  • 下一版:高亮 / 评论 / 阅读进度
  • OSS 选型:trafilatura(任意 URL → Markdown)+ marked + DOMPurify;复用 explain_service / vocab_service
  • 数据表:新增 library_articlesvocabulary 仅扩 source_type='library',无 schema 改动
  • 端优先级:PC 优先(与 /translate 一致),手机能用即可
  • 共依赖vocab_service.update_explanation 已存在;ExplanationCard 由 Library 这边先抽取,BBC /vocabulary 页后续复用

Files

  • docs/superpowers/specs/2026-05-19-library-tech-doc-reader-design.md — 设计 spec
  • docs/superpowers/plans/2026-05-19-library-tech-doc-reader.md — 16 Task 实现计划,每 Task 一 PR

Test plan

  • Spec 自审通过(无 placeholder / 内部一致 / 范围清晰)
  • Plan 自审通过(每 Task 有可执行步骤 + 真实代码 + 验收命令)
  • 合并后开 tracking issue「V0.8 文章库 · 技术文档阅读器」
  • 后续每个 Step PR 在 body 中 Refs #<tracking-issue>

关联

  • 并行 spec:docs/superpowers/specs/2026-05-19-articles-vocab-tag-design.md(BBC /articles 改名)
  • 评估过但不采用的方案:Omnivore(已归档)、Wallabag(栈不匹配)、Read Frog(浏览器扩展形态)— 详见 spec § 2

🤖 Generated with Claude Code

新增模块 /library — 用户自带英文技术文档的导入、阅读、点词翻译与生词本自动沉淀。
与 BBC /articles 改名 spec 在 V0.8 并行 ship。

- spec: docs/superpowers/specs/2026-05-19-library-tech-doc-reader-design.md
- plan: docs/superpowers/plans/2026-05-19-library-tech-doc-reader.md (16 Task)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
bob798 and others added 2 commits May 19, 2026 11:36
把 plan 16 Task 压缩为 4 PR:
- PR1: 后端基础 (Task 1-4)
- PR2: 后端 explain + 自动入库 (Task 5-8)
- PR3: 前端阅读闭环 (Task 9-13)
- PR4: 移动端 + 文档 + QA (Task 14-16)

启动指令:「启动 TODO-003 PR1」

Refs #46

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@bob798 bob798 merged commit 070d5d4 into main May 21, 2026
@bob798 bob798 deleted the feat/library-spec branch May 21, 2026 14:34
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.

1 participant