# AgenticCPS **Repository Path**: luke84/AgenticCPS ## Basic Information - **Project Name**: AgenticCPS - **Description**: No description available - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 4 - **Created**: 2026-05-16 - **Last Updated**: 2026-05-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
Vibe Coding + 低代码 + AI 自主编程 —— 让一个人拥有一支技术团队的战斗力
零代码启动、对话式开发、全自动运营的 CPS 联盟返利与导购平台
30 秒了解 • 为什么选择 • Vibe Coding • 核心功能 • 技术栈 • 快速开始
--- ## 30 秒了解 AgenticCPS **你是否属于以下人群?** - 想做电商返利副业,但不会写代码 - 一人公司(OPC)创业者,团队只有你自己 - 自由职业者 / 数字游民,想打造被动收入管道 - 个人开发者,想快速搭建一套完整的返利 SaaS - 小型工作室,3 人团队想干 30 人的活 **AgenticCPS 就是为你打造的。** 它是一套**开箱即用**的智能 CPS 联盟返利平台,深度融合 **Vibe Coding**、**低代码** 与 **AI 自主编程**三大核心理念: > **用自然语言告诉 AI 你想要什么,AI 自己写代码、自己测试、自己部署。** > > 一个人 = 产品经理 + 架构师 + 全栈开发 + 测试工程师 + 运维工程师。 --- ## 为什么选择 AgenticCPS? ### 传统模式 vs AgenticCPS | 维度 | 传统 CPS 系统开发 | AgenticCPS | |------|------------------|------------| | **团队规模** | 5~10 人技术团队 | **1 人即可** | | **开发周期** | 3~6 个月 | **开箱即用,AI 扩展按天计** | | **技术门槛** | 需要全栈工程师 | **自然语言描述需求,AI 自动实现** | | **平台对接** | 每个平台单独开发 | **淘宝/京东/拼多多/抖音已内置** | | **日常运维** | 专职运维团队 | **定时任务自动运行,异常自动告警** | | **功能迭代** | 排期 → 开发 → 测试 → 上线 | **Vibe Coding:说一句话就上线** | | **成本投入** | 人力 30~100 万/年 | **服务器 + 域名,年成本千元级** | ### 一人公司(OPC)最佳实践 ``` 你说:「帮我接入抖音联盟平台」 AI 自动完成: ✅ 分析抖音联盟 API 文档 ✅ 生成抖音平台适配器代码 ✅ 创建数据库配置表 ✅ 注册 MCP Tool 供 AI Agent 调用 ✅ 编写单元测试并验证通过 ✅ 生成 API 接口文档 用时:30 分钟。传统开发:2 周。 ``` --- ## Vibe Coding + AI 自主编程 ### 什么是 Vibe Coding? **Vibe Coding(氛围编程)** 是一种全新的软件开发范式: > **你不写代码,你描述 Vibe(氛围/意图/感觉),AI 把它变成可运行的软件。** 不同于传统的「写代码 → 编译 → 调试」循环,Vibe Coding 是: ``` 描述意图 → AI 理解 → AI 编码 → AI 测试 → AI 交付 你 你审核 你验收 ``` 在 AgenticCPS 中,这不是概念,而是**已经落地的工作方式**——项目的 CPS 核心模块(20,000+ 行代码)**100% 由 AI 自主编程完成**,从数据库设计到 API 接口,从业务逻辑到单元测试,从定时任务到 MCP AI 接口层,全部由 AI 自主编写。 ### Qoder AI 编码助手 平台集成 **Qoder AI 编码助手**,作为你的全栈 AI 程序员: | 你说什么 | AI 做什么 | |---------|----------| | 「加一个商品收藏功能」 | 自动生成 Controller → Service → Mapper → 数据库表 → 前端页面 | | 「接入唯品会联盟」 | 分析 API → 生成适配器 → 注册平台 → 编写测试 → 更新文档 | | 「返利规则加一个阶梯奖励」 | 设计方案 → 修改配置表 → 更新计算引擎 → 回归测试 | | 「给我看看昨天的运营数据」 | 调用 MCP Tool → 查询统计表 → 格式化输出运营报告 | | 「把搜索性能优化一下」 | 分析慢查询 → 添加缓存策略 → 优化索引 → 压测验证 | ### 基于 Specs / Plans 的规范化 AI 编程 不同于「让 AI 随便写」的粗放模式,AgenticCPS 引入了 **规范化 AI 编程工作流**: ``` .qoder/ ├── specs/ # 编码规范:技术标准、架构约束、代码风格 ├── plans/ # 实施计划:任务分解、验收标准、交付清单 ├── agents/ # AI 代理:角色定义、职责边界、协作流程 └── skills/ # 可复用技能:代码模板、最佳实践、经验沉淀 ``` **工作流程**: ``` 需求对齐 方案设计 自主编码 验收交付 ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌─────────┐ │ 读取 Specs │ → │ 设计方案 │ → │ AI 自主编码 │ → │ 自动测试 │ │ 解析 Plans │ │ 生成计划 │ │ 生成测试代码 │ │ 验收报告 │ │ 用户确认 │ │ 用户确认 │ │ 规范遵循 │ │ 文档输出 │ └─────────┘ └─────────┘ └──────────┘ └─────────┘ 你参与 你参与 AI 自动完成 你验收 ``` | 核心优势 | 说明 | |---------|------| | **需求精准对齐** | Specs/Plans 确保 AI 理解无偏差,告别「AI 乱写代码」 | | **方案先行** | 先设计 → 再确认 → 后编码,零返工 | | **纯 AI 自主编程** | 需求到代码全流程 AI 化,效率提升 10 倍以上 | | **质量可保障** | 自动测试 + 规范约束 + 验收标准,代码质量可控 | | **持续自进化** | 每次项目反馈自动优化 Specs/Plans,越用越聪明 | --- ## 低代码:不只是少写代码,而是不写代码 AgenticCPS 的低代码能力体现在系统的每个层面: ### 1. 代码生成器 —— 一键生成 CRUD 输入一张数据库表,**一键生成**完整的前后端代码: ``` 输入:数据库表结构 输出: ✅ Java Controller / Service / Mapper / DO / VO ✅ Vue3 前端页面(列表 + 表单 + 详情) ✅ SQL 建表脚本 ✅ Swagger API 文档 ✅ 单元测试代码 ``` 支持**单表、树表、主子表**三种模式,覆盖 80% 的管理后台开发场景。 ### 2. 可视化工作流 —— 拖拽设计业务流程 基于 Flowable 工作流引擎,在线拖拽设计审批流程: - 提现审核流程 - 返利结算审批 - 平台接入流程 - 任何自定义业务流程 ### 3. 报表 & 大屏 —— 拖拽生成数据可视化 | 能力 | 说明 | |------|------| | 数据报表设计器 | 拖拽字段生成数据报表,支持导出 Excel、PDF | | 图形报表设计器 | 柱状图、折线图、饼图等数十种图表组件 | | 大屏设计器 | 全屏数据大屏,内置几十种可视化组件 | | 打印设计器 | 拖拽设计打印模板,支持条形码、二维码 | ### 4. MCP 协议 —— AI Agent 零代码接入 通过 MCP(Model Context Protocol)协议,任何 AI Agent **无需写一行代码**即可接入 CPS 系统: ```json // AI Agent 直接调用,无需任何开发 { "method": "tools/call", "params": { "name": "cps_search_goods", "arguments": { "keyword": "iPhone 16 手机壳", "priceMax": 50 } } } ``` **5 个 AI Tools 开筱即用**: | Tool | 功能 | 一句话说明 | |------|------|-----------| | `cps_search_goods` | 商品搜索 | 帮用户在淘宝/京东/拼多多/抖音搜商品,支持平台筛选与价格区间 | | `cps_compare_prices` | 多平台比价 | 自动比较各平台价格,输出最便宜/返利最高/综合最优方案 | | `cps_generate_link` | 推广链接生成 | 生成带返利追踪的购买链接(短链/长链/口令/移动端) | | `cps_query_orders` | 订单查询 | 查看用户的返利订单列表与全链路状态 | | `cps_get_rebate_summary` | 返利汇总 | 查看余额、待结算、累计返利与最近记录 | --- ## 核心功能 ### CPS 联盟返利系统 一站式聚合淘宝、京东、拼多多等主流电商平台,实现从搜索到返利提现的完整闭环: | 功能模块 | 描述 | 一人公司价值 | |---------|------|------------| | 多平台 CPS 接入 | 淘宝/京东/拼多多/抖音联盟统一接入 | 一套系统管所有平台 | | 商品搜索与比价 | 关键词搜索、链接解析、跨平台比价 | 帮用户找到最省钱的方案 | | 会员返利体系 | 等级 + 平台 + 个人多维度返利配置 | 灵活设定利润空间 | | 订单全链路追踪 | 查询 → 转链 → 下单 → 结算 → 入账 | 每一分钱都追踪到位 | | 提现管理 | 支付宝/微信提现,自动/人工审核 | 自动化资金流转 | | MCP AI 接口 | 5 个 AI Tools,AI Agent 直接调用 | 接入 ChatGPT、Claude 等 AI 助手 | | 运营数据看板 | 订单/佣金/返利/利润实时统计 | 一个人掌控全局 | | 风控管理 | 异常行为检测、黑名单、退款率预警 | 自动守护资金安全 | ### 技术架构总览 ``` yudao-module-cps/ ├── yudao-module-cps-api/ # API 定义层 │ ├── enums/ # 枚举(平台编码、订单状态…) │ └── api/ # 远程服务接口 │ └── yudao-module-cps-biz/ # 业务实现层 ├── controller/admin/ # 管理后台接口(15 个) ├── controller/app/ # 会员端接口(13 个) ├── service/ # 业务服务(7 大服务模块) ├── client/ # 平台适配器(策略模式,可插拔扩展) │ ├── taobao/ # 淘宝联盟 │ ├── jingdong/ # 京东联盟 │ ├── pinduoduo/ # 拼多多联盟 │ └── douyin/ # 抖音联盟 ├── dal/ # 数据访问层(9 张核心业务表) ├── job/ # 定时任务(订单同步、状态更新) └── mcp/ # MCP AI 接口层 ``` ### 全模块能力矩阵 | 模块 | 核心能力 | 低代码支持 | |------|---------|-----------| | 系统管理 | 用户、角色、菜单、部门、字典、日志 | 代码生成器 + 拖拽配置 | | 会员中心 | 会员管理、等级体系、积分签到、标签分组 | 代码生成器 | | 支付系统 | 支付宝/微信支付、退款、钱包、转账 | 已集成,开箱即用 | | 工作流 | Flowable 流程引擎,在线设计审批流 | 可视化流程设计器 | | 数据报表 | 报表设计器、大屏设计器 | 纯拖拽,零代码 | | AI 大模型 | 聊天、图像生成、知识库、工作流 | MCP 协议对接 | | 微信公众号 | 粉丝管理、消息推送、自动回复 | 可视化配置 | | 商城系统 | 商品、促销、订单、售后 | 代码生成器 | | 基础设施 | 定时任务、文件服务、消息队列、监控 | 在线管理界面 | --- ## 技术栈 ### 项目模块 | 项目 | 说明 | |------|------| | `yudao-dependencies` | Maven 依赖版本管理 | | `yudao-framework` | Java 框架扩展(安全、缓存、权限、多租户…) | | `yudao-server` | 主服务端(所有模块的容器) | | `yudao-module-system` | 系统管理模块 | | `yudao-module-member` | 会员中心模块 | | `yudao-module-infra` | 基础设施模块 | | `yudao-module-pay` | 支付系统模块 | | `yudao-module-mall` | 商城系统模块 | | `yudao-module-ai` | AI 大模型模块 | | `yudao-module-mp` | 微信公众号模块 | | `yudao-module-report` | 报表与大屏模块 | | `yudao-module-cps` | **CPS 联盟返利系统模块** | ### 核心框架 | 框架 | 说明 | 版本 | |------|------|------| | [Spring Boot](https://spring.io/projects/spring-boot) | 应用开发框架 | 3.5.9 | | [Spring Security](https://spring.io/projects/spring-security) | 安全框架 | 6.5.2 | | [Spring AI](https://spring.io/projects/spring-ai) | AI 集成框架(MCP 支持) | 1.1.2 | | [MyBatis Plus](https://mp.baomidou.com/) | ORM 增强 | 3.5.15 | | [Redis](https://redis.io/) / [Redisson](https://github.com/redisson/redisson) | 缓存 & 分布式锁 | 7.0 / 3.35.0 | | [Flowable](https://www.flowable.com/) | 工作流引擎 | 7.2.0 | | [Vue 3](https://vuejs.org/) + Element Plus | 管理后台前端 | 3.5.12 / 2.11.1 | | [UniApp](https://uniapp.dcloud.net.cn/) | 移动端多端适配 | Latest | | [MySQL](https://www.mysql.com/) | 数据库(支持 Oracle/PG/SQLServer/达梦/人大金仓/GaussDB/openGauss) | 5.7 / 8.0+ | | [MapStruct](https://mapstruct.org/) | Bean 转换 | 1.6.3 | | [Quartz](https://www.quartz-scheduler.org/) | 任务调度 | 2.5.0 | | [SkyWalking](https://skywalking.apache.org/) | 链路追踪 & 日志中心 | 9.5.0 | --- ## 快速开始 ### 环境要求 | 组件 | 版本要求 | |------|---------| | JDK | 17 或 21(推荐 21) | | MySQL | 5.7 或 8.0+ | | Redis | 5.0+ | | Maven | 3.8+ | | Node.js | 16+(admin-vue3)/ 20+(admin-uniapp) | | pnpm | 8.6+(admin-vue3)/ 9+(admin-uniapp) | ### 三步启动 ```bash # 1. 克隆项目 git clone https://github.com/zhuangpengLI/AgenticCPS.git cd AgenticCPS/backend # 2. 初始化数据库 # 导入 sql/mysql/ruoyi-vue-pro.sql(主库表结构) # 按需导入各模块子 SQL(如 CPS 模块) # 配置 application-local.yaml 中的数据库连接信息 # 3. 启动后端 mvn clean compile # 运行 YudaoServerApplication 主类(端口:48080) ``` ### Docker 一键部署 ```bash cd backend/script/docker # 拉起所有服务(MySQL 8, Redis 6, 后端服务, 前端面板) docker-compose up -d # 查看服务日志 docker-compose logs -f server # 停止所有服务 docker-compose down ``` 端口映射:后端 48080 → 48080,MySQL 3306 → 3306,Redis 6379 → 6379,前端 80 → 8080 ### 前端启动 ```bash # 管理后台(admin-vue3) cd frontend/admin-vue3 pnpm install # 需要 pnpm >= 8.6, Node.js >= 16 pnpm dev # 管理后台(admin-uniapp) cd frontend/admin-uniapp pnpm install # 需要 pnpm >= 9, Node.js >= 20 pnpm dev:h5 # H5 端 # 生产打包 pnpm build:prod ``` ### 性能指标 | 指标 | 要求 | |------|------| | 单平台搜索 | < 2 秒(P99) | | 多平台比价 | < 5 秒(P99) | | 转链生成 | < 1 秒 | | 订单同步延迟 | < 30 分钟 | | 返利入账 | 平台结算后 24 小时内 | | MCP Tool 调用 | < 3 秒(搜索类)/ < 1 秒(查询类) | --- ## 谁在使用?典型场景 ### 场景 1:一人公司 CPS 创业 > **小张**,95 后自由职业者,一个人运营返利公众号。 > > 以前:用 Excel 手动记录订单、手动计算返利、手动转账给用户。 > 现在:AgenticCPS 自动同步订单、自动计算返利、用户自助提现。 > **每天多出 4 小时做推广,月收入翻 3 倍。** ### 场景 2:AI 导购助手 > **小李**,独立开发者,想做一个 AI 购物助手。 > > 以前:需要自己对接淘宝/京东/拼多多 API,写搜索、比价、转链逻辑。 > 现在:接入 AgenticCPS 的 MCP 接口,5 个 AI Tools 开箱即用。 > **1 天完成原来 2 个月的工作量。** ### 场景 3:Vibe Coding 快速扩展 > **小王**,返利平台运营者,想接入唯品会联盟。 > > 以前:找外包开发,报价 3 万,工期 3 周。 > 现在:对 AI 说「帮我接入唯品会联盟」,30 分钟搞定。 > **开发成本从 3 万降到 0。** --- ## 项目进展 - ✅ Phase 1:基础框架搭建(已完成) - ✅ Phase 2:核心功能开发(已完成) - ✅ Phase 3:订单与结算(已完成) - ✅ Phase 4:会员与提现(已完成) - ✅ Phase 5:数据统计(已完成) - ✅ Phase 6:MCP AI 接口(已完成) - ✅ Phase 7:文档与优化(已完成) --- ## 演示图 ### 系统功能 | 模块 | 截图 | 截图 | 截图 | |------|------|------|------| | 登录 & 首页 |  |  |  | | 用户 & 应用 |  |  |  | | 租户 & 套餐 |  |  | - | | 菜单 & 角色 |  |  | - | ### 基础设施 | 模块 | 截图 | 截图 | 截图 | |------|------|------|------| | 代码生成 |  |  | - | | 定时任务 |  |  | - | | 监控平台 |  |  |  | ### 报表 & 大屏 | 模块 | 截图 | 截图 | 截图 | |------|------|------|------| | 报表设计器 |  |  |  | | 大屏设计器 |  |  |  | --- ## 交流社区 欢迎加入 AgenticCPS 交流社区,与志同道合的开发者、创业者一起探索 Vibe Coding 与 CPS 赚钱的无限可能! | 渠道 | 二维码 | |:---------:|:-------------------------:| | 加入知识星球,获取深度教程、源码解析、运营经验分享|  | | 添加群主,备注:进技术交流群 |  | | 扫码加入微信群,获取最新动态、技术答疑、部署支持 |  | > **微信群**:技术交流、Bug 反馈、功能建议,欢迎扫码加入。 > > **知识星球**:付费精品社区,内含完整部署教程、Vibe Coding 实战案例、一人公司 CPS 创业经验分享,以及专属答疑服务。 --- ## 开源协议 本项目采用 **GNU Affero General Public License v3.0 (AGPL-3.0)** 开源协议。 | 使用场景 | 是否允许 | |---------|---------| | 个人学习、研究 | ✅ 允许 | | 内部企业使用 | ✅ 允许 | | 商业二次开发(需开源) | ✅ 允许 | | 对外提供 SaaS 服务 | ✅ 允许(需开源修改部分) | | 闭源商业化分发 | ❌ 禁止 | 详见 [LICENSE](./LICENSE) --- ## 💝 赞助与支持 开源项目的发展离不开社区的支持。如果您觉得本项目对您有帮助,欢迎赞助支持持续开发! ### 为什么需要赞助? | 用途 | 说明 | |------|------| | 🖥️ 服务器部署 | 测试环境、演示环境、CI/CD 服务器租赁费用 | | 🤖 AI Token 费用 | 大模型 API 调用费用(通义千问、DeepSeek、OpenAI 等) | | 🔧 持续开发 | 新平台对接开发、功能迭代、Bug 修复 | | 📚 文档完善 | 技术文档、API 文档、视频教程制作 | ### 赞助方式 #### 微信支付 / 支付宝
AgenticCPS —— 让每一个有想法的人,都能拥有自己的返利帝国。
一人公司 • Vibe Coding • AI 自主编程 • 低代码 • 开箱即用