xintao-reading-paradigm 是 xintao-心读 的 GitHub-ready 精简仓库，聚焦“移动端原位智能注释”这一新范式本身，而不是整份比赛工程。
这个仓库适合用来对外展示三件事：
xintao-心读作为移动阅读新范式的核心思想- 形成该范式的关键代码摘录
- 对应的介绍材料、技术材料与开发文档 PDF
这不是一个把聊天能力塞进阅读器的项目副本，而是一套围绕移动深度阅读建立起来的“原位注释 / 无感注释”范式整理。
核心判断很简单：
- 手机阅读最怕的不是没有答案，而是理解动作被频繁带离正文
- 真正高频可用的 AI 阅读增强，不应要求用户切出去搜索或进入聊天
- 更理想的形态，是让解释像脚注、旁批、边读边注一样自然发生
因此，xintao-reading-paradigm 所展示的重点，是一种“新技术 + 经典显示”的交互路径：
- 新技术：上下文组织、流式生成、失败回退、状态隔离、PDF 文本治理
- 经典显示：解释停留在阅读页内，像旁批一样附着在正文旁，而不是把用户拽进对话窗口
这套范式的价值不只在“能解释”，还在“更容易被接受”。
- 在专业阅读中，它更像高效率术语注和句意注
- 在双语学习中，它更像贴句译注和阅读辅助层
- 在长辈读报等场景中，它更像更现代、但依然直观的电子旁批
相比对话式 AI，这种方式的学习成本更低、阅读打断更少，也更容易被内容平台、阅读器、教育产品理解和接入。
xintao-reading-paradigm/
├── README.md
├── .gitignore
├── KEY_CODE_INDEX.md
├── PUBLISH_TO_GITHUB.md
├── docs/
│ ├── xintao_overview.pdf
│ ├── xintao_technical_report.pdf
│ └── xintao_development_doc.pdf
└── key_code/
├── AiRepository.kt
├── ExplainPromptBuilder.kt
├── ExplainTextHeuristics.kt
├── FileStateStore.kt
└── PdfTextCleaner.kt
仓库只保留了最能说明范式和工程方法的关键代码：
AiRepository.kt解释主链路编排、流式优先、多级回退、输出清洗与单次修复ExplainPromptBuilder.kt术语 / 句子 / 文学 / 英文四类提示档与旁批化输出目标ExplainTextHeuristics.kt选区分类与解释风格判定FileStateStore.kt按文件状态隔离、旁批保存、术语记忆与恢复逻辑PdfTextCleaner.ktPDF 文本结构保留、重复页边清理、正文重排
完整说明见 KEY_CODE_INDEX.md。
仓库当前附带三份最适合对外介绍的 PDF：
这三份文件分别用于：
- 讲清楚“这是什么新范式”
- 讲清楚“它为什么在软件技术上成立”
- 讲清楚“它在工程与产品实现上如何落地组织”
建议你把这个仓库定位为：
A new in-place AI annotation paradigm for mobile deep reading.
或者中文：
面向移动深度阅读的原位智能注释新范式。
- 仓库中不包含真实 API Key 或其他敏感信息
- 这里展示的是关键代码摘录，而不是完整工程
- 若你要公开发布，建议再根据对外口径补一个更短的英文摘要
本地已整理成 GitHub-ready 目录。推送步骤见 PUBLISH_TO_GITHUB.md。