pi-remote-feishu 源码教程
从零读懂 Pi Agent × 飞书 扩展包的完整实现： 多会话隔离架构、双入口设计、流式渲染、远程权限确认、文件回传。 跟着项目源码一步步拆解。
3 大部分
24 章
~2800 行源码
20 主线问答
第一部分
架构设计
先建立全局认知：这个项目解决什么问题、系统如何分层、核心概念是什么、一条消息如何走完全程、以及最重要的设计取舍。
- 00教程导读
- 01项目概览
- 02总体架构
- 03核心概念
- 04消息处理全链路
- 05关键设计决策
源码解读
按模块精读源码实现：从配置系统到飞书通道、从会话管理到流式渲染，每个文件讲清楚「写什么、为什么这么写」。
- 01源码地图
- 02配置系统
- 03通道层 feishu/
- 04路由与归一化
- 05会话管理
- 06运行时封装
- 07流式渲染
- 08UI 桥接与权限确认
- 09卡片系统
- 10附件处理
- 11文件回传工具
- 12存储
- 13入口与扩展
- 14测试与二次开发
面试准备
从源码细节收束到系统设计表达：主线问答、架构亮点、可演示改造题和面试速查卡。
- 01面试主线问答
- 02架构亮点与设计模式
- 03面试可演示改造题
- 04面试速查卡
📖 如何使用本教程
- 克隆项目后，先用 第一部分 建立整体认知（不读代码也能懂）。
- 读第二部分时，一边看讲解、一边在编辑器里打开对应源码文件，效果最好。
- 如果你想面试或深入掌握，第三部分 帮你把源码细节整理成架构表达、设计取舍和可演示改造题。
- 每章末尾有「小结」和「练习」，练习答案都可以在源码里找到。
- 右上角侧边栏可随时跳转章节；页面底部有「上一章 / 下一章」。