#理解现有项目

#梳理项目结构

接手现有项目时，宜先了解目录、运行方式和主要业务流程，再提出修改要求。仅提供项目名称，通常不足以判断实际采用的技术、依赖及部署方式；应让 Claude Code 结合当前文件进行说明，并区分已经读取的内容与尚未确认的信息。

可先进入规划模式，再要求阅读说明文档、依赖配置及主要入口。预期结果仅用于说明交付形式，不代表已经完成实际测试。

请帮助我理解当前目录中的{“听溪书单”阅读记录项目}。

阅读顺序：
1. 先查看目录结构、README、依赖配置和现有项目规则；
2. 确认项目使用的语言、框架、启动入口与测试方式；
3. 再阅读与{书籍列表、阅读状态和搜索功能}直接相关的文件。

输出要求：
- 用适合初学者理解的语言说明各主要目录的作用；
- 梳理“用户输入关键词—程序处理—页面展示”的流程；
- 为关键说明列出对应文件位置；
- 列出本地运行前需要准备的工具和配置。

本轮只开展阅读与分析，不修改项目。
没有实际读取或无法确认的内容，请明确说明。

预期结果应包括主要目录说明、功能执行路径、环境准备事项及待确认问题。若项目文件与 README 的说明不一致，应分别列出实际实现和文档记载，避免直接沿用已经过时的启动方法。

#定位具体逻辑

需要理解某一功能时，宜提供用户可见的行为作为定位起点。例如，“点击收藏后列表如何更新”比“解释整个前端”更容易形成范围清晰的分析。

请继续解释{用户将一本书标记为“已读”}时发生的处理过程。

从页面事件开始，依次说明：
1. 哪个函数接收用户操作；
2. 是否发送网络请求，调用哪个接口；
3. 数据在哪里保存；
4. 操作成功或失败时如何更新界面。

请先作通俗说明，再列出涉及的文件与函数。
不要仅根据函数名称推断行为，应阅读相关实现。

对于没有编程基础的读者，可进一步要求解释“组件”“接口”“数据库”等术语。已经具备其他语言经验的读者，则可指定比较对象，例如对比 Java 与 Go 在错误处理、项目结构或接口实现方面的区别。