【Agent进阶专题】项目目录介绍

本篇记录当前源码目录和运行数据的存放规则。只在真实代码出现时创建,不提前拆包,不预建占位层级。

源码目录

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
llm-to-agent/
├── src/
│ ├── kernel/ # Extension 生命周期、能力注册、事件机制
│ ├── extensions/
│ │ ├── shared/ # 三个产品共用的能力(workspace、agent、deepseek)
│ │ ├── cli/ # 终端输入和展示
│ │ ├── web/ # 计划中
│ │ └── desktop/ # 计划中
│ ├── products/
│ │ ├── cli.ts # CLI 产品:shared + cli Extension
│ │ ├── web.ts # Web 产品:仅 shared(待实现)
│ │ └── desktop.ts # Desktop 产品:仅 shared(待实现)
│ └── main.ts # 读取产品选择,组装启动 Kernel
├── docs/ # 架构、目录、路线图
├── tests/ # 跨 Extension / 跨进程测试
├── tooling/ # 构建和开发辅助
├── package.json
└── tsconfig.json

两条规则:

  • 业务进入 Extension,Kernel 只保留通用运行机制。
  • 真实需要出现后再拆分,不为未来提前增加层级。

运行数据不进入项目

源码和 Agent 数据分开保存,所有专属数据集中在 LLM_TO_AGENT_HOME。

绑定外部项目时只记录目录关系,不在项目中创建 .llm-to-agent/,删除绑定也不会删用户源码。

下一篇,我们将介绍一下 LLM_TO_AGENT_HOME 的目录结构和数据存放规则。