# aifei-dev

**Repository Path**: jfinal/aifei-dev

## Basic Information

- **Project Name**: aifei-dev
- **Description**: aifei 开发 skills
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-05-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# aifei-dev

Claude Code 专用的 Aifei 框架开发技能包。为 AI 编程助手提供 Aifei 框架的完整开发知识，确保生成的代码符合框架规范。

## 关于 Aifei

Aifei 是全球首个 **AI Coding 框架**，基于 Java 构建，与 Spring 完全无关。核心设计理念：

- **Just Service 范式** — 消除 Controller / Render / Dao / Mapper / Repository 层，只保留 Service 类
- **HIO 架构** — Handler + Input + Output 模型，无 Servlet 依赖
- **内置 Enjoy 模板引擎** — 同时用于视图渲染和 SQL 模板
- **Db + Row / Model ORM** — 直接数据库操作，无需传统 ORM 层

官网：https://aifei.cn

## 安装

将本仓库克隆到 Claude Code 的 skills 目录：

```bash
git clone https://cnb.cool/goldsyear/aifei/aifei-dev.git ~/.claude/skills/aifei-dev
```

或创建符号链接：

```bash
git clone https://cnb.cool/goldsyear/aifei/aifei-dev.git /path/to/aifei-dev
ln -sfn /path/to/aifei-dev ~/.claude/skills/aifei-dev
```

安装后，在 Claude Code 中即可自动获得 Aifei 框架的开发指导能力。

## 参考文档

| 文件 | 内容 |
|---|---|
| `project_structure.md` | Maven / Gradle 构建配置、模块说明、标准目录结构 |
| `core_concepts.md` | AifeiConfig、Settings、Routes、Plugins、启动流程 |
| `annotations.md` | @Path、@Before、@Clear、@Inject、@Para、@Singleton |
| `service_patterns.md` | Service CRUD、分页、排序、导出模式 |
| `database.md` | Db + Row / Model ORM、事务、批量操作、代码生成 |
| `hio_architecture.md` | In / Out / IoHandler、文件上传下载、SSE、模板渲染 |
| `vip_arch.md` | OutCode 状态码、Return 断言、ServiceException、Argument 定制 |
| `aop_interceptor.md` | Interceptor、Invocation、拦截器层级、依赖注入 |
| `enjoy_template.md` | Engine 配置、模板语法、内置指令、共享函数、SQL 模板、自定义指令 |
| `example_vip.md` | 完整 aifei-vip 项目示例（带数据库、认证、字典） |
| `example_cn.md` | 最简 aifei-cn 项目示例（无数据库、纯模板渲染） |

## 快速开始

### 1. 最简应用

```java
// AppConfig.java
public class AppConfig implements AifeiConfig<In, Out> {
    public void config(Settings<In, Out> settings) {
        Prop p = PropKit.use("app-config.txt");
        settings.setServer(new UndertowServer(), new IoDispatcher())
                .addHandler(new IoHandler(p.getBoolean("printAction")));
        Engine.use("VIP").setDevMode(p.getBoolean("enjoyDevMode"));
    }

    public void config(Routes routes) {
        routes.scan("com.your.app");
    }

    public void config(Plugins plugins) {}
}
```

```java
// IndexService.java
@Path("/")
public class IndexService {
    public String index() {
        return "index/index.html";
    }
}
```

### 2. 带数据库的 CRUD

```java
@Path("/user")
public class UserService {
    public Out list() {
        return Out.of(User.sql("select * from user order by id desc").find());
    }

    public Out save(User user) {
        user.save();
        return Out.ok();
    }
}
```

## 技术栈

| 组件 | 说明 |
|---|---|
| Web 服务器 | Undertow |
| JSON | fastjson2 |
| 日志 | SLF4J + Log4j2 |
| 数据库连接池 | Druid / HikariCP |
| AOP 代理 | cglib / javassist |
| JDK | Java 8+ |

## License

Apache 2.0