专栏
TypeScript 与 Node 地基
智能体开发的前置课——为读懂 dsh 与写出生产级 agent 而设计的 TS/Node 工程课:类型系统、异步、插件模式、HTTP 流式。
共 13 篇 · 按阅读顺序排列
- 1 TypeScript 与 Node 地基:专栏目录 为「读懂 DeepSeek Harness 源码」和「写出生产级 agent」设计的前置课——只教需要的部分:类型系统、异步、插件模式、HTTP 流式。
- 2 TS 类型系统速成:为读源码而学 只教读 dsh 源码需要的类型知识——基础类型、联合与收窄、接口、只读、类型断言,每个概念配真实源码影子。
- 3 模块、导入导出与 npm 生态 ESM 的 import/export、package.json 的关键字段、pnpm workspace 与 monorepo——读懂 dsh 的 import 图。
- 4 Promise 与 async/await 心智模型 异步的正确心智模型——Promise 是"稍后兑现的值",async 函数是"看起来同步的异步代码",附 agent 场景的全部用法。
- 5 事件循环与 EventEmitter 单线程为什么不卡——事件循环的工作方式、微任务与宏任务、EventEmitter 模式,以及 Cordis 事件系统的雏形。
- 6 接口、泛型与声明合并 dsh 最"魔法"的三个类型技巧——接口声明合并(ctx 键)、泛型约束(工具参数推导)、条件类型,全部拆开讲。
- 7 Schema 校验与 defineTool 模式 用 zod 实现运行时校验与类型推导的双赢——亲手写一个迷你版 defineTool,理解"schema 是唯一事实源"。
- 8 插件化架构:写一个 mini 插件宿主 亲手实现 Cordis 的最小版——插件注册、依赖注入、事件总线与可逆副作用,60 行代码读懂"一切皆插件"。
- 9 Node HTTP 服务与 SSE 流式 不用框架从零写 HTTP 服务、实现 SSE 流式端点——AI 回复"打字机效果"的全部原理,一次写明白。
- 10 进程、信号与优雅关机 SIGTERM 和 SIGINT 是什么、退出码的语义、如何把"正在进行的任务做完再走"——dsh 优雅关机机制的原理与最小实现。
- 11 用 TypeScript 重写 mini-agent 把 Agent 专栏第 4 篇的 100 行 Python agent 用 TypeScript 重写——同一份逻辑、两种语言,检验地基学得扎不扎实。
- 12 读真实开源项目的方法论 以 dsh 为例演示一套可复用的源码阅读流程——从 README 到主干道,四步读懂任何大型项目,附 dsh 的完整走读记录。
- 13 综合实战:插件宿主 + 工具注册 + SSE 服务 毕业项目——把 12 篇的技能组装成一个可运行的微型 agent 服务:插件化工具注册、SSE 流式输出、优雅关机,一次写完。