这里说明如何查阅技术文章、核对版本、阅读源码和使用下载资料。路线、答题与进度记录是可选辅助工具。需要交流时，可以直接按 交流说明说说基础、目标和一个问题。
第一次来，从哪里开始？
| 想阅读的内容 | 建议入口 | 内容说明 |
|---|---|---|
| Java 基础与面试知识 | 知识总目录 → Java 面试资料 | 查阅文章、检查表、复盘样例与线程池实验 |
| Java 与 AI 应用 | 知识库服务说明 → 验收手册 | 阅读实现范围、源码使用说明与验收条件 |
| 项目经历与技术表达 | 项目表达资料 → 填写样例 | 对照职责、实现边界和证据理解项目条目 |
需要系统查文章时，使用 知识总目录或顶部搜索。搜索结果需要短暂加载；长句难定位时，可以先搜“线程池”“缓存”“文档更新”等核心词。
阅读文章时怎样核对版本与源码？
先看文章注明的 JDK、框架或项目版本，再结合示例的输入条件理解结论。涉及源码分支时，对照对应版本的类、方法和调用路径；不同版本的行为不要直接混用。文章没有说明的条件，可在交流时附上具体段落与自己的环境。
源码包先读 README，区分启动要求、实现功能与尚未验证的范围。本站样例、stdout 与回放 JSON 是对应材料的记录；复用到自己的环境时，应保留自己的版本、命令和实际结果。
PDF、CSV 和 Markdown 怎么用？
- PDF 手册适合离线查阅、打印与对照执行。可先看 17 页目录预览或 在线正文，确认适用范围和用例标记，再填自己的实际结果。
- CSV 记录表可以用 Excel 或其他表格工具打开。中文显示异常时，用“从文本/CSV 导入”，编码选择 UTF-8；用例编号、证据 ID 等列按文本读取，避免自动转成日期。
- Markdown 模板可以用任意文本编辑器打开。复制一份再填写，保留“环境、步骤、预期、实际、证据、下一步”，不用追求排版复杂。
- ZIP 源码包先完整解压，再阅读根目录 README。不要直接在压缩包里运行脚本。
下载入口统一在 资料页，无需先关注公众号或加微信。文件名或版本有变化，以对应资料页的说明为准。
项目介绍、教学实验和代码项目有什么区别？
| 类型 | 在哪里 | 能取得什么 |
|---|---|---|
| 行业项目介绍 | Java + AI 项目库 | 业务背景、流程与架构拆解，具体交付看介绍 |
| 单文件教学实验 | 检索边界实验 | 无外部依赖的 Java 源码与合成数据回放 |
| 可运行代码项目 | 知识库检索服务 | 源码、依赖、启动说明、接口与测试记录 |
本地检索、向量检索和模型生成承担不同工作。阅读项目说明中的模式与测试范围，避免把一组演示通过数当成完整 RAG 的线上准确率。
Java 项目启动失败怎么办？
先运行：
java --version
javac --version本轮实验以 JDK 21 验证。源码项目还需按各自 README 安装或使用构建工具。终端中的 Java 与编辑器使用的 JDK 可能不同，应分别检查。
按下面顺序缩小问题：
- 确认完整解压，并在 README 指定的目录执行命令。
- 保存第一条错误以及它之前的上下文。依赖下载失败、端口占用、认证失败与业务断言失败分别处理。
- 检查端口是否已有服务，优先更改本项目端口，不随意结束不认识的进程。
- 需要数据库、容器或模型配置的模式，分别核对依赖。没有配置模型时，不用把模型请求失败误判为文档版本校验错误。
路线、练习和项目怎么接起来？
- 想系统阅读时，可在 学习路线选择 Java 面试、Java 转 AI 或项目到简历，按主题打开文章，不必先勾选进度。
- 想巩固概念时，可到 练习工作台答题、读解析与版本条件，或查看 现有样例。
- 想动手验证时，可选择 线程池小实验、检索边界实验、知识库服务说明或 7 天知识库练习，按各自说明使用源码与材料。
- 需要记录时再使用路线标记、工作台或自己的文档，保存完整代码与日志；遇到问题随时可以交流。
路线标记和答题记录会保存什么？
| 工具 | 实际记录的内容 | 怎样理解 |
|---|---|---|
| 学习路线的进度标记（LearningPath） | 自己勾选已练习的步骤，保存在当前浏览器；可下载路线练习单自行记录 | 是本地自标，不能据此认定掌握程度或项目已验收 |
| 自测与错题工作台（StudyWorkbench） | 固定题库的作答、曾答错的题目与选填实践记录，保存在当前浏览器；可导出 Markdown 复习单 | 答后看解析与下一步，统计只描述这组题的作答情况 |
两种记录分别保存，不会因路线勾选而自动答对题目，也不会因答对题目而自动认定项目完成。它们都不是能力测评，不推断岗位水平、面试通过率或求职结果。
换设备、清理站点数据或使用无痕窗口后，原记录可能不可用。工作台可导出复习单；完整代码、日志与项目材料请另行保存。浏览器禁止存储时，仍可阅读路线和完成当次答题，保存能力以页面提示为准。
清理记录时，分别使用对应工具的重置操作：路线工具重置所选路线的标记，工作台重置自身的答题与实践记录。本站记录方式见 隐私说明。
初次提问，怎么说就可以？
先说明下面三点即可，不需要先写完整复现报告：
当前基础：学过什么，或能独立完成什么
当前目标：想准备的岗位，或想完成的功能
一个问题：现在最想弄清楚的地方例如：“我会写简单接口，想运行知识库服务，还不清楚该先选哪种模式。”可以先按 交流说明沟通，再逐步缩小问题。
深入排错时，再补哪些信息？
当问题涉及启动失败、结果不符或内容纠错时，可以用 问题复现模板整理相关信息。下面是排错清单，按当前问题逐步补充，不是添加微信或开始交流的条件：
文章或项目地址：
使用版本：JDK / 项目版本 / 操作系统
运行模式与启动命令：
最小输入与复现步骤：
预期结果：
实际结果与完整错误：
已经尝试的方法：
可以公开的日志或最小代码：日志移除密钥、客户数据与公司内部资料。技术纠错可以提交到公开仓库 Issues，也可以按交流说明提供具体问题。发送前先检查内容是否适合公开。
读完资料后，怎样继续？
可以沿相关文章和路线继续阅读，或按需选择实验与练习；运行过的内容保存实际结果和仍不理解的问题。需要交流时，基础、目标和一个问题即可；需要项目、简历或面试辅导时，可以阅读服务与匹配说明，再由双方确认适用方向、交付范围与费用。