TypeScript 与 Node 地基:专栏目录

专栏:TypeScript 与 Node 地基 · 第 1 / 13 篇
TypeScriptNode学习路径

这是本站的前置课程DeepSeek Harness 专栏逐行解读了一个生产级 TypeScript 系统,Agent 工程专栏教你构建 agent——但两者都假设你已经具备 TS/Node 的工程能力。这个专栏补的就是这块地基:只教”读源码和写 agent 需要的那部分”,每章都配 dsh 真实例子的对照。

为什么是 TypeScript

  • dsh 全部由 TypeScript 编写(约 2500 个源码文件),读懂它是本站进阶内容的钥匙;
  • agent 生态的主流工具链(SDK、框架、插件)TS/JS 占据半壁江山;
  • TypeScript 的类型系统恰好能解释 dsh 的两个核心技巧:声明合并(ctx 键)与泛型约束(工具参数推导)。

前置要求:会用任意一门语言写基本程序(变量、函数、循环、条件)。不需要前端经验——本专栏是 Node 侧工程课,不碰 CSS 和 DOM。

目录

图表(ts-learning-path.md)

阶段一 · 语言地基(第 1~2 章)

篇章对应解锁
1TS 类型系统速成:为读源码而学读懂 dsh 的接口定义与类型收窄
2模块、导入导出与 npm 生态读懂 monorepo 的 import 图与 pnpm workspace

阶段二 · 异步核心(第 3~4 章)

篇章对应解锁
3Promise 与 async/await 心智模型读懂流式处理与并发编排
4事件循环与 EventEmitter读懂 Cordis 的事件分发

阶段三 · 工程模式(第 5~7 章)

篇章对应解锁
5接口、泛型与声明合并读懂 ctx.tools 的类型魔法
6Schema 校验与 defineTool 模式理解工具参数的自动校验
7插件化架构:写一个 mini 插件宿主亲手实现”Cordis 的最小版”

阶段四 · 服务端(第 8~9 章)

篇章对应解锁
8Node HTTP 服务与 SSE 流式读懂网关与流式转发的原理
9进程、信号与优雅关机读懂 dsh 的 SIGTERM/SIGINT 处理

阶段五 · 实战收尾(第 10~12 章)

篇章对应解锁
10用 TypeScript 重写 mini-agent打通与 Agent 专栏第 4 篇的双语对照
11读真实开源项目的方法论一套可复用的源码阅读流程
12综合实战:插件宿主 + 工具注册 + SSE 服务毕业,直接进入 dsh 专栏

每章的固定结构

学习目标 → 可运行代码 → 检查点(预期输出)→ 与 dsh 的对照 → 常见踩坑 → 随堂练习(带验收标准)。每章 45~90 分钟,全程约 12 小时。

工具准备:Node.js 22+(node -v 验证)、任意编辑器(VS Code 推荐——TS 语言服务是最好的老师)。运行 TS 无需编译:npx tsx 文件名.ts

← 返回文章列表