Skip to content

canyuda/ciff

Repository files navigation

Ciff-DEMO

Code It For Future

简化版 Dify,面向小团队的 AI Agent 开发与运行平台。

V1 功能范围

功能 说明
Agent 智能助手 工具调用 + 多轮对话,核心形态
Chatbot 对话应用 基础对话,最高频入口
Workflow 工作流 JSON 配置,线性步骤 + 条件分支,不做可视化拖拽
模型供应商适配 统一接口,OpenAI / Claude / 本地模型
知识库 RAG TXT 文档,固定长度分块,PGVector
自定义工具 / API Agent 可调用外部接口
Web + API 发布 对话界面 + REST API
日志追踪 完整调用链,用于调试排错

技术栈

后端 — JDK 17 / Spring Boot 3.3 / MyBatis-Plus / MySQL / Redis (Redisson) / Spring AI / Resilience4j

前端 — Vue 3 / TypeScript / Element Plus / Vite / SSE

基础设施 — Nginx + Docker Compose

项目结构

ciff/
├── ciff-common/      # 公共模块(工具类、异常、DTO、配置)
├── ciff-provider/    # 模型供应商管理
├── ciff-mcp/         # MCP 工具管理与调用
├── ciff-knowledge/   # 知识库与 RAG
├── ciff-agent/       # Agent 管理与编排
├── ciff-workflow/    # 工作流编排与执行
├── ciff-chat/        # 对话引擎(顶层编排)
├── ciff-app/         # Spring Boot 启动模块
└── rules/            # 编码规范与设计文档

产品展示

页面一览

供应商管理 模型管理
供应商管理 模型管理
工具管理 Agent 管理
工具管理 Agent 管理
知识库管理 文档管理
知识库管理 文档管理
召回测试 对话页面
召回测试 对话页面
对话示例 — SSE 流式 + Markdown 渲染
对话示例

弹窗/表单

新增供应商 新增工具
新增供应商 新增工具
创建知识库 创建 Agent
创建知识库 创建 Agent
选择 Agent(对话) 编辑工作流(JSON)
选择 Agent 编辑工作流 JSON
编辑工作流(流程图) 执行工作流 — 任务已提交
编辑工作流 流程图 执行工作流
任务详情 — 步骤执行 任务详情 — 最终结果
任务详情 步骤执行 任务详情 最终结果
任务详情 — 执行失败 历史任务列表
执行失败 历史任务

开发进度

Phase 1: 基础框架搭建 (2026-04-13 ~ 2026-04-15)

  • Maven 多模块工程骨架(8 子模块,分层依赖)
  • 统一响应 Result<T> / 分页 PageResult<T>
  • 统一异常处理 BizException + ErrorCode + GlobalExceptionHandler
  • MyBatis-Plus 配置(分页插件、自动填充 createTime/updateTime、逻辑删除)
  • Redis 配置(Redisson + JSON 序列化 + RedisUtil)
  • Spring Boot 启动类 + application.yml
  • 项目规范文档(模块结构、数据库、接口、编码、测试)
  • 健康检查接口 GET /api/v1/health
  • Flyway 数据库迁移管理
  • 请求日志拦截 + LLM 日志脱敏

Phase 2: Provider 模型供应商 (2026-04-15 ~ 2026-04-17)

  • 供应商 CRUD(支持 OpenAI / Claude / 本地模型)
  • 模型管理 CRUD + 默认参数配置
  • LLM HTTP 客户端(WebClient + Reactor Netty,同步 + SSE 流式)
  • Claude 客户端适配 + LLM 客户端工厂抽象
  • 供应商健康检查定时任务
  • Resilience4j 熔断保护
  • LLM 调用超时配置(四级超时策略)
  • API Key 加密存储

Phase 3: Agent / MCP / Knowledge 模块 (2026-04-17 ~ 2026-04-19)

  • MCP 工具管理 CRUD + Facade 层
  • Agent 管理 CRUD + Agent-Tool 绑定关系
  • Agent 聚合控制器(模型校验、统一入口)
  • 知识库 CRUD + PGVector 双数据源配置
  • 文档管理(上传、分块、向量化、定时处理调度)
  • 本地文件存储 + TXT 固定长度分块
  • 缓存层支持(Provider / Agent 详情缓存)

Phase 4: 前端界面 (2026-04-17 ~ 2026-04-21)

  • 前端工程初始化(Vue 3 + TypeScript + Element Plus + Vite)
  • 设计系统与公共组件库(CiffTable / CiffFormDialog / PageHeader / TopBar)
  • 供应商管理页面
  • 模型管理页面
  • 工具管理页面
  • Agent 管理页面
  • Chat 对话页面(会话列表 + SSE 流式 + 消息历史 + RAG 模式切换)

待开发

Phase 5: Workflow 工作流 (2026-04-22 ~ 2026-04-23)

  • Workflow CRUD + JSON 定义校验(步骤类型 / ID 唯一 / nextStepId 引用 / DFS 循环检测)
  • 工作流执行引擎(llm / tool / condition / knowledge_retrieval 四种步骤类型)
  • 变量插值 ${stepId.output.xxx} / ${inputs.xxx} + WorkflowContext
  • 工具参数校验(param_schema required + 类型强转)
  • 工作流管理前端页面(列表 + JSON 编辑器 + 执行弹窗 + 动态输入参数)
  • 9 个后端测试 + 1 个前端测试全部通过

Phase 6: 认证 + API 发布 + 部署 (2026-04-25)

  • Sa-Token + JWT 认证(登录 / 注册 / 登出 / Token Redis 持久化)
  • GitHub OAuth 2.0 自动注册登录
  • API Key 管理(生成 / 列表 / 撤销 / SHA256 哈希存储)
  • 外部对话接口(API Key 认证,/api/v1/external/chat
  • 前端登录页 + 路由守卫 + Token 管理
  • API Key 管理页面
  • Docker Compose 部署(ciff-app + Nginx 反向代理 + SSE 透传)
  • 全局 UI 打磨(空状态、错误提示、响应式侧边栏)

About

Ciff -DEMO - AI Agent Development Platform

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors