【Agent进阶专题】装配 CLI 产品
本篇通过 main.ts 和 Product 定义完成最终装配,将 Workspace、DeepSeek、Agent 与 CLI 串成一个可以运行的产品。
Product 定义
Extension 只关心各自的能力,Product 决定一个产品需要安装哪些 Extension。
src/products/product.ts 中的 Product 结构只有产品标识和专属 Extension 工厂:
1 | export type ProductId = "cli" | "web" | "desktop"; |
Workspace、DeepSeek 和 Agent 是多个产品都能复用的公共能力,统一放在 src/products/shared.ts 的 sharedExtensions:
1 | export const sharedExtensions: ExtensionFactory[] = [ |
src/products/cli.ts 只补充 CLI 自己的终端交互:
1 | export const cliProduct: ProductDefinition = { |
这样,公共能力不会重复写进每个 Product,CLI 也不需要了解它们怎样实现。
选择产品
main.ts 从命令行参数读取 Product ID。没有参数时默认启动 CLI:
1 | const productIds = process.argv.slice(2); |
getProduct() 只接受 cli、web 和 desktop,未知名称会直接抛错。
项目脚本最终执行的是同一个入口,只是传入的 Product 不同。
组装与启动
确定 Product 后,main.ts 先放入公共 Extension,再追加各 Product 的专属 Extension:
1 | const factories = [ |
启动前,入口会读取项目根目录下的 .env:
1 | if (existsSync(".env")) { |
随后启动 Kernel,并等待 Runtime 停止请求:
1 | const stopped = new Promise<void>((resolve) => { |
实际效果
聊天效果如图:
数据目录如图:
聊天记录如图:
绑定关系如图:
到此,P1 的本地可交互基座才算真正完成:能力由 Extension 实现,产品负责选择,main.ts 负责组装和运行。下一阶段开始给 Agent 增加操作项目的能力。