按理说，

本篇文章是《从零开发一个Coding Agent》系列第二篇。主要介绍如何使用 npm 搭建一个 monorepo 项目，还有如何管理多个子项目。如果你对 Agent 开发也感兴趣，欢迎点赞收藏+关注。从专栏来看，从零开发一个Coding Agent - 东方小月的专栏 - 掘金

什么是 monorepo 项目

使用者痛点：在传统多仓库模式下跨项目引用往往需要手动维护版本号、频繁发布、甚至出现“依赖地狱”。monorepo 通过本地软链接解决了这些问题，让子包像普通 npm 包一样直接导入。

举例这方面，@di-code/agent 需要引用 @di-code/ai。

{
"workspaces":
}

packages/ai/package.json：

{
至于"name"，"@di-code/ai","version": "0.1.0"
}

{
从"name"来看，"@di-code/agent","version": "0.1.0"。"dependencies": {
"@di-code/ai": "*"
}
}

根目录执行 npm install 后npm 会创建本地链接，例如：

node_modules/@di-code/ai -> D:\projects\di-code\packages\ai

此后在 @di-code/agent 中可以这样导入：

import type { Message } from "@di-code/ai";

注意：不要使用跨目录相对导入（如 ../../ai/src/types.js)，这会破坏 workspace 的依赖解析。话说回来，

环境和目录准备

使用者痛点：很多新人在搭建项目时忽略 Node 版本或根目录配置不当。导致后续建立、测试全线报错。确保 Node>= 18 并在根目录初始化正确的 package.json 是关键第一步先。

创建项目根目录并初始化如下 package.json：

{
说到"name"，"di-code","version": "0.1.0","private": true,"type": "module","workspaces":,"scripts": {
"build": "npm run build --workspace @di-code/tui && npm run build --workspace @di-code/ai && npm run build --workspace @di-code/agent && npm run build --workspace @di-code/coding-agent"。"check": "biome check . && tsc --noEmit -p tsconfig.json","test": "npm run test --workspaces --if-present"
},"devDependencies": {
"@biomejs/biome": "^1.9.0","@types/node": "^20.14.0","typescript": "^5.4.5","vitest": "^1.6.0"
},"engines": {
从"node"来看，">=18"
}
}

• private: true — 防止误发布聚合包。
• type: module — 确保全局采用 ESM。老实说，
• workspaces — 明确只匹配四个直接子包。避免误把示例或临时目录纳入 workspace。
• build 脚本顺序 — 与包间依赖方向保持一致，防止编译顺序错误。
• check 脚本顺序 — Biome 检查通过后才执行 TypeScript 编译，提高效率。
• No caret /tilde  — 使用精确版本锁定所有 devDependency，确保 CI 环境一致性。怎么说呢，

随后创建 packages 文件夹。并在其中建立四个子目录：ai、agent、coding-agent、tui. 每个子目录内部再建 src

TypeScript 基础配置

{
"compilerOptions": {
"target": "ES2022",“lib”:,“module”: “NodeNext”,“moduleResolution”: “NodeNext”,“strict”: true,“erasableSyntaxOnly”: true,“verbatimModuleSyntax”: true,“noEmitOnError”: true,“declaration”: true,“declarationMap”: true。“sourceMap”: true,“inlineSources”: true,“esModuleInterop”: true,“forceConsistentCasingInFileNames”: true,“skipLibCheck”: true,“resolveJsonModule”: true,“types”:
}
}

<