First
用探索收获新知
这里是 code 栏目——一组技术探索笔记。记录对开源库、框架、协议的理解与落地：不追求面面俱到的文档复述，而是把"这个东西是什么、怎么用、坑在哪"用自己能看懂的笔记形式沉淀下来。
这个栏目记什么
- 库 / 框架解读：qiankun、react-virtuoso、nanostores、async-validator、scroll-lock、vgpu 等，写清用法、原理与最佳实践；
- 协议与方案：MCP、微前端、虚拟列表、WebRTC 101 系列、部署方案等横向主题；
- 场景化示例：每个项目尽量配"实战场景"，把笔记变成可复用的速查。
子项目导航
| 项目 | 一句话简介 | 首篇 |
|---|---|---|
| qiankun | 微前端框架：主/子应用接入、沙箱、Nginx 统一托管部署 | 入门 |
| react-virtuoso | 虚拟列表库：动态高度、表格/网格/分组/聊天场景 | 入门 |
| MCP | Model Context Protocol：AI 应用连接工具的开放协议 | 入门 |
| nanostores | 轻量状态管理器（原子存储） | guide |
| async-validator | 异步校验库（schema 校验） | guide |
| zod | TypeScript 优先的 schema 库（v4，5 篇）：入门 / MCP 与 Zod / 类型推导剖析（v3 vs v4 类型性能实测）/ 源码剖析（_zod 内部与 parse 管线）/ Mini·Standard Schema·JSON Schema·zod/compile | 入门 |
| scroll-lock | 页面滚动锁定库 | README |
| antd-mobile | 移动端组件库通用设计规范 | 通用 |
| gods-pen | 在线代码编辑器探索 | 文档仓库 |
| Perry 的 101 | 跨端框架对比（Electron / Flutter / Tauri / RN / Qt 等）选型速查 | 入门 |
| hooks | React Hooks 用法合集（useActionState 等） | useActionState |
| InkOS | 故事创作 AI Agent 4 篇：入门/深度体验（CLI 全命令与流水线拆解）/架构拆解（agent 分类、状态机、FTS5 检索、37 维审计、原子提交）/为什么不用 LangGraph（零依赖事实 + 四件套对照：reducer·图·checkpointer·interrupt 各拿什么替的）；pi-agent harness + 输入治理 | 入门 |
| pi | TS agent 运行时（Mario Zechner）：pi-ai 统一几十家 LLM 接入 + pi-agent-core 的 Agent harness（工具循环/事件流/会话），InkOS 的底层 | 入门 |
| frontend-agent | 用前端技术栈写 Agent（纯 Node/TS，真实模型实测 3 篇）：循环/运行时 → 简单工具调用 Agent → 复杂多步 Agent（文件落盘、以结果为准） | 入门 |
| langchain-langgraph | LangChain.js + LangGraph.js 入门 5 篇（真实模型实测）：消息/提示/LCEL/结构化输出 → 状态图·条件边·记忆 → ReAct Agent 实战 → LangGraph 图解（mermaid + 逐步执行轨迹） | 入门 |
| deepagents | LangChain Deep Agents 入门（1.13.4 实测）：一行创建「会规划/读写文件/派子任务」的 Agent——中间件与后端体系、真实工具调用时间线、产物落盘验证与坑 | 入门 |
| cmux | 终端复用器 + 面向 Agent 的「资源客户端」（Rust/libghostty，npm 分发）：会话/工作区/面板/终端/浏览器/agent 资源 + --json 编排 | 入门 |
| llm-format | 剖析 OpenAI / Anthropic 两家 chat 协议：请求/返回骨架逐字段拆解 + 一张表对照 + TS 类型与 zod 运行时校验 + 一发一收完整脚本（同 key 两端真实实测） | OpenAI 与 Anthropic 消息格式 |
| vgpu | WebGPU 库（Vercel Labs）：一套 API 跑浏览器/Node/mock；agent-first 工具链——随包 CLI 文档、官方 Skill、MCP、sha256 可信示例 | 入门 |
| WebRTC | 实时通信协议栈 101 系列：采集 → 信令/SDP → ICE/NAT 穿透 → SRTP 媒体平面 → DataChannel → 生产选型 | 入门 |
| spring | Spring & Spring Boot 入门系列：家族名份 + 用 Boot 4 写出第一个 REST 服务（分层/配置/打包/Actuator），Boot 藏起来的 Spring 内核待后续拆 | 入门 |
| nestjs | NestJS 入门指南（v12 实测）：Node 界的 Spring——Module/Controller/Provider 三件套 + 依赖注入 + 第一个 REST 接口 | 入门 |
| maven | Java 构建工具 Maven 入门（3.9.16 实测）：坐标/仓库/生命周期/pom.xml + thin vs fat jar；看得懂 Spring Boot 的 pom 与 mvnw | 入门 |
| gradle | Java 构建工具 Gradle 入门（8.14.5 实测）：任务图/增量 UP-TO-DATE/Wrapper/Kotlin DSL；与 Maven 对照、Spring Boot 也能用 | 入门 |
| mysql | MySQL 8.4 入门到精通 8 篇（本机实测）：连接/CRUD/查询进阶/索引与 EXPLAIN/事务隔离/表设计/视图过程触发器/生产调优 | 入门 |
| sqlite | 高性能 SQLite 2 篇（Node 24 本机实测）：理论入门（写瓶颈=提交次数×fsync、实测 280 倍差距、WAL/synchronous/页缓存与索引）+ 驱动写法横向对比（node:sqlite / better-sqlite3 / @libsql/client / sql.js 同一任务四种写法、大整数静默丢精度等五个坑） | 入门 |
| Vue3 | Vue2→Vue3 系列（3.5.42，面向熟练 Vue2 开发）：快车道/Composition/迁移深水区 + 响应式原理、模板编译优化两篇深拆（实验实测）+ 组合式进阶×TS×工程化 | 入门 |
| Pinia | Vue 3 状态管理入门到精通 6 篇（pinia 4.0.3 实测）：入门/state·getters·actions/组合式与多 store/解构·订阅·插件/进阶工程/原理 | 入门 |
阅读约定
- 每个子项目的首篇顶部标注了 创建日期 / 最近更新，一眼看到新鲜程度；
- 目录用数字前缀排序（
0.入门 →1.→ …），从0开始读即可； - 侧边栏 URL 会自动剥离文件名数字前缀（如
0.入门→/入门、0.guide→/guide）。
维护约定
- 新增子项目：在
docs/code/下建目录，0.开头写入门/介绍，其余按学习路径编号； - 每个子项目首篇标注创建与更新日期；
- 内容偏"探索笔记"：结论要可验证（有代码/场景支撑），引用他人成果注明来源。
慢慢加，不追求多，只求每篇都值得回看。