【Agent进阶专题】装配 CLI 产品

本篇通过 main.ts 和 Product 定义完成最终装配,将 Workspace、DeepSeek、Agent 与 CLI 串成一个可以运行的产品。

Product 定义

Extension 只关心各自的能力,Product 决定一个产品需要安装哪些 Extension。

src/products/product.ts 中的 Product 结构只有产品标识和专属 Extension 工厂:

1
2
3
4
5
6
export type ProductId = "cli" | "web" | "desktop";

export interface ProductDefinition {
id: ProductId;
extensions: ExtensionFactory[];
}

Workspace、DeepSeek 和 Agent 是多个产品都能复用的公共能力,统一放在 src/products/shared.ts 的 sharedExtensions:

1
2
3
4
5
export const sharedExtensions: ExtensionFactory[] = [
createWorkspaceExtension,
createDeepSeekExtension,
createAgentExtension,
];

src/products/cli.ts 只补充 CLI 自己的终端交互:

1
2
3
4
export const cliProduct: ProductDefinition = {
id: "cli",
extensions: [createCliExtension],
};

这样,公共能力不会重复写进每个 Product,CLI 也不需要了解它们怎样实现。

选择产品

main.ts 从命令行参数读取 Product ID。没有参数时默认启动 CLI:

1
2
const productIds = process.argv.slice(2);
const products = (productIds.length > 0 ? productIds : ["cli"]).map(getProduct);

getProduct() 只接受 cli、web 和 desktop,未知名称会直接抛错。

项目脚本最终执行的是同一个入口,只是传入的 Product 不同。

组装与启动

确定 Product 后,main.ts 先放入公共 Extension,再追加各 Product 的专属 Extension:

1
2
3
4
5
const factories = [
...sharedExtensions,
...products.flatMap((product) => product.extensions),
];
const kernel = new Kernel().use(...factories.map((factory) => factory()));

启动前,入口会读取项目根目录下的 .env:

1
2
3
if (existsSync(".env")) {
loadEnvFile();
}

随后启动 Kernel,并等待 Runtime 停止请求:

1
2
3
4
5
6
7
8
9
10
11
12
const stopped = new Promise<void>((resolve) => {
kernel.on(Event.RuntimeStopRequested, resolve);
process.once("SIGINT", resolve);
process.once("SIGTERM", resolve);
});

try {
await kernel.start();
await stopped;
} finally {
await kernel.stop();
}

实际效果

聊天效果如图:
image

数据目录如图:
image

聊天记录如图:
image

绑定关系如图:
image

到此,P1 的本地可交互基座才算真正完成:能力由 Extension 实现,产品负责选择,main.ts 负责组装和运行。下一阶段开始给 Agent 增加操作项目的能力。