目标用户
通过 Telegram 使用移动服务、愿意阅读海外漫画，但可能不掌握作品原始语言的用户。
HEN-5 · Single Source of Truth
HCOMIC 完整产品方案
面向 Telegram 小程序的移动端多语言漫画发现与阅读产品。第三方内容在访问时实时获取并缓存；原文抓取成功即可阅读，用户请求目标语言后异步生成逐页覆盖方案，由前端在同一远端原图上实时呈现译文。
16 种界面与目标翻译语言
2 条原文即时阅读 / 目标语言译文
3 个首页、收藏、我的一级入口
产品定义与目标
产品解决跨语言用户从发现作品、判断内容版本、发起翻译到连续阅读的闭环。首版不预爬全量内容，也不假设第三方存在任何译文。
核心价值
原文永不被翻译等待阻塞；译文需求真实发生时才投入资源，进度对所有请求者透明且结果可共享。
上线策略
列表和详情首次访问由后端实时从第三方获取并写入自身数据库，后续读取优先命中缓存。
体验目标
用户在任何作品上都能回答三件事：当前看到的是什么版本、现在能否阅读、译文还要经过什么阶段。
核心产品原则
原文即时保底
只要源漫画抓取成功，详情、收藏、分享和原文阅读立即可用，翻译任务不进入原文关键路径。
译文按需共享
按作品、源版本和目标语言创建或复用任务；离开页面不取消，其他用户共享进度与覆盖方案。
语言概念分离
界面语言、原文语言、目标语言和当前阅读版本分别记录，选择原文或译文不会隐式修改全局界面。
阅读连续优先
版本切换保持逻辑页码；任务完成只提示不打断；历史恢复用户上次明确选择的内容版本。
数据库只存业务元数据
只保存远端原图链接、原图宽高、OCR/译文，以及遮盖多边形、填充色、排版区域与字号等元数据；不保存任何图片二进制或本地图片路径。
前端实时覆盖
原文模式只显示远端原图，不创建覆盖层；译文模式仍显示同一原图，由前端遮盖原文字并排版可访问译文。服务端不保存或提供清理图、遮罩图和最终译图。
语言与内容模型
全局语言用于界面和默认目标语言，不再表示漫画正文已经存在对应译文。作品卡、详情和阅读器必须明确内容版本。
| 对象 | 定义 | 产品行为 |
|---|---|---|
| interface_language | 用户全局界面语言，支持 English、简繁中文、日/韩/印尼/泰/越、法/德、印地/孟加拉/旁遮普/泰米尔/泰卢固/马拉雅拉姆。 | 决定导航、按钮和系统反馈，同时作为默认 target_language。 |
| source_language | 第三方内容原始语言，由抓取结果确定。 | 作品卡和详情标注“原文 · 日本語”，原文阅读永远使用这一版本。 |
| target_language | 用户希望阅读的译文语言，默认取界面语言，可针对本作品临时修改。 | 切换目标语言只读取或创建另一份覆盖方案任务，不改变界面语言。 |
| content_mode | 当前阅读内容为 source 或 translation。 | 阅读器、历史和继续阅读均显示并保存该模式。 |
| translation_key | source_content_id + source_revision + target_language。 | 同键任务单例复用；源修订后旧覆盖方案可只读使用并标为旧版，新源版本创建独立任务。 |
信息架构与导航
一级导航固定为首页、收藏、我的；搜索、详情、观看历史、语言层、阅读版本层和阅读器作为完整阅读路径的二级页面。
首页
- 搜索与全局语言
- 最近观看与完整历史
- 最新更新、近期热门
- 标签快捷入口
收藏
- 作品级收藏列表
- 原文语言与译文状态
- 进入详情或继续阅读
- 空状态返回浏览
我的
- 全局界面语言
- 观看历史入口
- 阅读数据概览
- 恢复位置与工具栏偏好
页面需求
| 页面 | 信息与行为 |
|---|---|
| 首页 | 顶部品牌、搜索和全局语言；最近观看用单行封面、标题、上次版本、页码和进度展示；最新与热门作品卡标明原文语言及目标译文状态。 |
| 搜索 | 跨译名、原名和标签搜索；筛选为全部、目标译文已可读、未读，不再用“当前语言可用”混淆任务状态。 |
| 作品详情 | 展示当前界面语言标题、原名、简介、标签、原文语言、目标语言和译文状态；主按钮始终打开阅读版本层，不直接猜测版本。 |
| 阅读版本层 | 并列展示原文与目标译文。原文标记立即可读；译文展示未请求、排队、阶段/百分比、可读、失败或旧版，并提供相应操作。 |
| 阅读器 | 竖向连续阅读；顶部固定显示“原文 · 日本語”或“译文 · 简体中文”；原文模式只挂载远端原图，译文模式在同一原图之上增加前端遮盖层和可访问译文层；底部显示页码、版本入口以及进行中的覆盖方案进度。 |
| 收藏 | 收藏只对应作品，不按语言或版本复制条目；卡片可展示该用户目标语言的任务状态。 |
| 观看历史 | 按最近时间倒序，同作品保留最新位置；每行显示原文/译文模式和内容语言；清空历史不影响收藏和共享翻译任务。 |
| 全局语言层 | 搜索并选择 16 种界面语言；阅读中修改只更新界面和默认目标语言，不自动切换当前漫画内容。 |
按需翻译与阅读分流
开始 / 继续阅读→读取上次模式与任务→原文 · 立即可读或目标译文 · 发起 / 等待→译文可读
| 状态 | 阅读版本层 | 其他页面 |
|---|---|---|
| not_requested | 不显示 0% 进度条；操作为“开始翻译”。 | 作品卡/详情显示“译文未请求”。 |
| queued | 显示“排队中”和不确定进度；保留“先看原文”。 | 任务持续执行，离开页面不取消。 |
| processing | 显示阶段、完成页数 / 总页数和百分比。 | 原文阅读器底部非遮挡展示进度并可打开版本层。 |
| ready | “查看译文”为推荐操作，原文入口继续存在。 | 原文阅读中只提示一次，不自动刷新或切换。 |
| failed / partial | 说明失败阶段和保留页数，操作为“重试翻译”。 | 部分结果不混入完整译文；原文继续可读。 |
| stale | 旧覆盖方案仍可读并标注基于旧版原文，同时允许为新源版本发起更新。 | 历史可恢复旧版本，不覆盖用户正在阅读的覆盖方案。 |
可信进度：详情文本提取与术语准备映射到 0–5%；5–95% 只按“逐页覆盖方案通过校验”的页数单调映射；整本可读性校验映射到 95–99%；只有所有远端原图和对应覆盖方案均可供整本阅读时才为 100%。
阅读、版本切换与历史连续性
原文阅读
- 进入零等待，不触发翻译
- 只显示远端原图，不挂载遮盖或译文层
- 若覆盖方案处理中，底部展示实时快照
- 任务完成后轻量提示，由用户主动切换
译文阅读
- 只在任务 ready 后开放完整入口
- 继续显示与原文模式相同的远端原图
- 前端按原图坐标遮盖原文字，并以 DOM 排版译文
- 随时可回原文，保持逻辑页码且不重新加载原图
| 场景 | 连续性规则 |
|---|---|
| 原文 ↔ 译文 | 保持逻辑页码 N；映射异常时定位最近可映射页并明确提示。 |
| 继续阅读 | 上次 source 直接恢复原文；上次 translation 且版本仍 ready 时恢复译文；不可用时打开版本层解释原因。 |
| 历史存储 | 保存 work_id、logical_page、content_mode、content_language、translation_revision、progress 和 viewed_at。 |
| 全局语言变化 | 当前阅读模式和内容语言保持不变；新界面语言只成为下一次译文请求的默认目标。 |
| 任务完成 | 不抢焦点、不滚动、不重新加载原图、不自动切换；只更新底部状态并发送一次完成提示。 |
系统状态与异常
列表或详情首次访问展示骨架；若缓存存在，展示缓存并在后台更新。
没有源内容时显示重试和返回，不能宣称原文可读，也不能创建翻译任务。
保留最近服务端快照并标记正在重连；恢复后立即同步，不从零估算。
同 translation_key 返回相同 task_id，按钮变为查看进度，不重复排队。
保留服务端已完成覆盖方案供续跑；用户重试从中断处继续，原文阅读不受影响。
当前页不创建任何覆盖层，明确提示失败来源；用户可重试远端原图，也可返回原文版本并保持当前逻辑页码。
同一原图继续可见，但停止该页遮盖和译文排版；用户可单独重试覆盖方案或立即返回原文。
冻结旧任务与旧覆盖方案为独立 revision；旧版只读可用并明确标记 stale，新源版本按需创建独立任务。
范围、埋点与成功指标
本期包含
- Telegram 小程序入口
- 16 种界面与目标语言
- 首页、搜索、详情、收藏、我的、历史、阅读器
- 原文/译文分流与共享任务进度
- 收藏、页码、模式和语言连续性
本期不包含
- 评论、评分、社区和投稿
- 会员、支付、广告和优先队列
- 翻译人工编辑与质量投票
- 逐页提前开放和离线下载
- 用户取消共享任务或完成时间承诺
| 事件 / 指标 | 用途 |
|---|---|
| reader_route_view / select | 记录入口、原文语言、目标语言、任务状态以及 source / translation 选择。 |
| translation_request | 记录目标语言、源版本和是否复用任务，衡量真实翻译需求与复用率。 |
| translation_progress_view | 记录阶段、百分比和所在页面，验证用户何时关注任务。 |
| reader_version_switch | 记录 from / to、逻辑页码和任务完成后等待时长，验证无损切换。 |
| 核心指标 | 原文即时开读率、译文请求率、请求后原文开读率、完成后译文进入率、任务复用率、失败重试成功率和再次续读率。 |
验收标准
| 验收项 | 通过标准 | 级别 |
|---|---|---|
| 单一方案 | 产品首页只有本 PRD 和一个完整原型入口；仓库不再提供历史 PRD 或历史原型作为可访问交付物。 | 必须通过 |
| 完整导航 | 原型可操作首页、搜索、详情、收藏、我的、历史、语言层、版本层和阅读器，无局部演示与全站原型分歧。 | 必须通过 |
| 阅读分流 | 详情与需确认版本的继续阅读均明确提供原文和目标译文；原文不等待翻译。 | 必须通过 |
| 任务单例 | 同作品、同源版本、同目标语言请求复用服务端任务，页面显示相同且不倒退的快照。 | 必须通过 |
| 等待可退出 | 翻译中可关闭版本层、浏览全站或先看原文；任务持续执行，完成不打断阅读。 | 必须通过 |
| 原图与覆盖 | 译文仍显示同一远端原图，由前端遮盖原文字并以可访问 DOM 排版译文；原文模式不创建覆盖层。 | 必须通过 |
| 数据边界 | 数据库只保存远端原图链接、宽高、OCR/译文和遮盖/排版元数据；服务端不保存或提供任何处理后图片。 | 必须通过 |
| 版本连续 | 原文/译文切换保持逻辑页码；历史显示并恢复上次内容模式和语言。 | 必须通过 |
| 语言分离 | 修改界面语言不自动修改当前漫画版本；选择目标语言不修改全局界面语言。 | 必须通过 |
| 异常保底 | 抓取失败、排队、处理中、翻译失败、网络中断、原图失败、覆盖方案失败和 stale 均有明确可恢复反馈；两类单页失败都可重试并返回原文。 | 必须通过 |
| 移动体验 | 320px 至桌面视口无文字、按钮或状态重叠；键盘和读屏可操作；返回顺序保持阅读器 → 详情 → 来源列表。 | 必须通过 |
本文件与 `/prototypes/hen-5-translation-flow` 是当前唯一产品交付，后续需求必须直接更新这两个入口。