项目结构
一个显式配置的 KsADK 项目通常包含：
agentengine.yaml
.env
requirements.txt
__init__.py
agent.py
兼容模式下也会检测 ksadk.yaml 和 ksadk.yml。
文件说明
| 文件 | 用途 |
|---|---|
agentengine.yaml | 框架、入口文件和导出变量 |
.env | 本地模型和可选平台配置，不提交真实值 |
requirements.txt | 业务依赖 |
agent.py | 导出 root_agent 或配置中的变量名 |
不应提交
不要提交真实 .env、.agentengine/ui/sessions.sqlite、构建产物/缓存/日志，以及 token、kubeconfig、私有 registry 凭证。公开示例可以提供 .env.example，但只能包含占位值。