T-Agent CLI

T-Agent 应用脚手架工具，支持命令行和 Web 界面两种配置方式。

功能特性

• 🚀 快速创建 T-Agent 应用
• 📝 支持命令行交互式配置
• 🌐 提供 Web 配置界面
• 🎨 自定义主题色配置
• 📱 支持多种应用类型 (FORMA, DATA_WISE, GLOSSA)
• 📦 支持多种包管理器 (pnpm, npm, yarn)

安装

# 全局安装
npm install -g @t-agent/cli

# 或者使用 pnpm
pnpm add -g @t-agent/cli

# 或者使用 yarn
yarn global add @t-agent/cli

使用方法

命令行模式

# 创建新应用
t-agent create my-app

# 跳过确认步骤
t-agent create my-app --yes

# 指定模板类型
t-agent create my-app --template glossa

Web 界面模式

# 启动 Web 配置界面
t-agent ui

# 指定端口
t-agent ui --port 3001

配置选项

应用名称 (APP_NAME)

• 用于路由映射：aipower.yingdao.com/${appName}
• 只能包含小写字母、数字和连字符
• 必须以字母开头
• 示例：forma, datawise, glossa

应用类型 (PRODUCT_TYPE)

• 与服务端协商的应用类型标识
• 预定义类型：FORMA, DATA_WISE, GLOSSA
• 支持自定义类型

主题色配置

• 主色调 (primaryColor): 应用的主要颜色
• 辅助色 (secondaryColor): 应用的辅助颜色
• 支持十六进制颜色代码格式

生成的文件结构

my-app/
├── src/
│   ├── api/
│   │   └── config.ts          # 包含 PRODUCT_TYPE 配置
│   ├── routes/
│   │   ├── index.tsx          # 重定向到 /${appName}
│   │   └── ${appName}/        # 应用路由文件夹
│   │       ├── index.tsx      # 主页面
│   │       ├── app.$id.tsx    # 应用详情页
│   │       └── process.$id.tsx # 流程详情页
│   ├── main.tsx               # 包含主题色配置
│   └── index.css              # 包含主题色 CSS 变量
├── package.json               # 更新应用名称和描述
└── ...其他配置文件

模板变量替换

CLI 会自动替换以下模板变量：

• {{PRODUCT_TYPE}} → 应用类型
• {{APP_NAME}} → 应用名称
• {{primaryColor}} → 主色调
• {{secondaryColor}} → 辅助色

开发

# 安装依赖
pnpm install

# 构建
pnpm build

# 开发模式
pnpm dev

# 类型检查
pnpm type-check

# 测试
pnpm test

许可证

MIT