这是本站的前置课程。DeepSeek Harness 专栏逐行解读了一个生产级 TypeScript 系统,Agent 工程专栏教你构建 agent——但两者都假设你已经具备 TS/Node 的工程能力。这个专栏补的就是这块地基:只教”读源码和写 agent 需要的那部分”,每章都配 dsh 真实例子的对照。
为什么是 TypeScript
- dsh 全部由 TypeScript 编写(约 2500 个源码文件),读懂它是本站进阶内容的钥匙;
- agent 生态的主流工具链(SDK、框架、插件)TS/JS 占据半壁江山;
- TypeScript 的类型系统恰好能解释 dsh 的两个核心技巧:声明合并(ctx 键)与泛型约束(工具参数推导)。
前置要求:会用任意一门语言写基本程序(变量、函数、循环、条件)。不需要前端经验——本专栏是 Node 侧工程课,不碰 CSS 和 DOM。
目录
阶段一 · 语言地基(第 1~2 章)
阶段二 · 异步核心(第 3~4 章)
阶段三 · 工程模式(第 5~7 章)
阶段四 · 服务端(第 8~9 章)
阶段五 · 实战收尾(第 10~12 章)
每章的固定结构
学习目标 → 可运行代码 → 检查点(预期输出)→ 与 dsh 的对照 → 常见踩坑 → 随堂练习(带验收标准)。每章 45~90 分钟,全程约 12 小时。
工具准备:Node.js 22+(node -v 验证)、任意编辑器(VS Code 推荐——TS 语言服务是最好的老师)。运行 TS 无需编译:npx tsx 文件名.ts。