asf-scaffold 0.1.1

ASF (AI Service Framework) 开发脚手架 —— 一键创建/校验 SU 模块（开箱即用，无需本地构建）

ASF Scaffold

ASF (AI Service Framework) 开发脚手架 —— 一键创建、列表、校验 SU (Service Unit) 模块。

开箱即用，无需克隆仓库或本地构建，pip 安装即可使用，模板文件已打包在 wheel 中。

安装

pip install asf-scaffold

依赖

• Python >= 3.8
• click >= 8.0
• jinja2 >= 3.0

命令一览

命令	说明	示例
asf create <category> <name>	创建新 SU 模块	asf create ai my_service
asf list [category]	列出所有 SU（扫描文件系统）	asf list / asf list ai
asf validate <category> <name>	校验 SU 结构	asf validate ai sample

使用流程

1. 创建新 SU 模块

# 创建
asf create ai my_service

# 强制覆盖已存在的模块
asf create ai my_service --force

CLI 不会修改 modules.conf，需手动注册。

创建后自动生成以下文件结构：

server/app/ai/my_service/
├── __init__.py           # APIRouter 聚合
├── api.py                # API 端点
├── README.md             # 模块文档
├── requirements.txt      # Python 依赖
├── Dockerfile            # 容器构建
├── docker-compose.yml    # 容器编排
├── logger.yaml           # 日志配置
├── errors/
│   ├── __init__.py
│   └── error_codes.py    # 错误码定义
└── nginx/
    └── default.conf      # Nginx 反向代理

2. 查看已有模块

# 列出所有（扫描 server/app/ 文件系统）
asf list

# 按分类过滤
asf list ai

# 详细信息（含关键文件校验）
asf list --detail

3. 校验模块结构

asf validate ai my_service

# 自动补全缺失文件
asf validate ai my_service --repair

模板变量

模板使用 Jinja2 语法渲染，可用变量：

变量	示例值 (ai/my_service)
{{category}}	ai
{{name}}	my_service
{{class_name}}	AiMyService
{{error_prefix}}	AI_MY_SERVICE
{{category_title}}	Ai
{{name_title}}	MyService
{{log_path}}	logs/ai/my_service/my_service.log
{{image_tag}}	registry.inspures.com/ai_su/my_service:latest

许可证

MIT License