# COOL-AI

# 背景

目前比较流行的应用软件大多是移动端的如：APP、小程序、H5等，至于 PC 端大多是web应用。但是 web 应用大多需要后端部署服务提供支持，也无法调用 PC 底层的一些功能如：操作文件、读取串口等，还有一些其他底层的能力。因此到目前为止还有许多专门是用于 PC 端的应用软件如：开发工具、百度网盘等。还有一些专门为了提高工具效率的小工具如：各种批量处理工具、自动化工具、各种办公场景等等。

# 特性

丰富的底层 API：除了 electron、node 等 api，cool 官方还提供如：云数据库、即时通信、云推送、本地数据库等 pc 端应用常用的 api。
简洁的界面：页面简洁大方，易操作，提供开发者平台，让开发者发布和开发插件更加简单便捷。
提供应用开发脚手架：像保姆般地呵护开发者，让开发者快速上手应用开发。
调皮的小酷：你想让小酷做什么呢？

# 能力

COOL-AI 是一个基于 Electron 开发的跨端桌面应用程序，提供了多种底层 API 接口，方便开发者快速开发桌面应用程序。通过它你可以开发：

# 物联网类

刷脸支付
刷卡签到
监控系统
远程控制
......

# 应用类

聊天通讯
网盘存储
智能 AI
自动化工具
效率工具
......

# 其他

游戏
中控
......

当然除了这些，你可以大胆地开始你的想象还可以用它来做什么，比如你想做一个属于自己的工具平台。

# 框架

# 客户端

基于Electron (opens new window)跨端桌面应用程序解决方案
脚手架vue-cli-plugin-electron-builder (opens new window)基于 vue 的 Electron 脚手架
UI 框架Element-UI (opens new window)

# 后端

基于node.js (opens new window)用 js 写后端
基于cool-admin一个很酷的后台快速开发框架

admin

# 下载

# Mac

下载 (opens new window)

# Windows

下载 (opens new window)

# 开始

# 前提条件

为了更快地安装项目依赖，必须提前安装好cnpm (opens new window)

npm install -g cnpm --registry=https://registry.npm.taobao.org

# 创建应用

# 1、使用 COOL-AI 脚手架创建

 1、vue create project
 2、cd project
 3、vue add router //如果新建的时候已经选择这步可以忽略
 4、vue add vue-cli-plugin-cool-ai //添加COOL-AI的脚手架插件
 5、npm run serve

TIP

vue 的router是必须添加的，并且需要将 router 的mode设置为hash

# 2、项目目录结构

project
  ├── package.json
  ├── app.json (COOL-AI应用配置文件)
  ├── db.json (COOL-AI数据库配置文件)
  ├── public
  ├── src
  |   ├── assets(资源)
  │   ├── components(组件)
  │   ├── router(路由)
  │   ├── views(页面)
  |   |—— App.vue
  |   |—— main.js
  |   |—— preload.js(cool-ai预加载的js)

# 3、app.json 配置

{
    // 应用ID，用脚手架创建的时候自动生成
    "appId": "z-gK4vSCQ",
    // 应用名称
    "name": "这是个测试应用",
    // 版本号
    "version": "0.0.1",
    // 应用描述
    "description": "测试应用",
    // 入口文件默认为 index.html 一般不需要修改
    "main": "index.html",
    // 预加载js， 该js文件会在所有资源文件之前加载
    "preload": "preload.js",
    // 应用logo， 一般无需修改
    "logo": "logo.png",
    // 应用支持的平台
    "platform": [ "win32", "darwin" ],
    // 关键字
    "keyWords": [ "cool-ai", "cool" ],
    // 打开时时候隐藏小酷，如果隐藏了应用显示区域会更大
    "xiaoku": { "hide": false },
    // 开发时的配置
    "dev": {
        // 地址
        "main": "http://127.0.0.1:8081",
        // 预加载js
        "preload": "src/preload.js",
         // logo
        "logo": "src/assets/logo.png"
    },
    // preload.js 引用第三方包时需要在此添加
    "build": { "externals": [] },
    // 窗口大小 width为0 表示全屏(0.0.7版本后支持)
    "window": {
        "width": 375,
        "height": 600
    }
}

# 4、db.json 配置文件

{
    // 是否是云端数据库， false为本地数据库
    "isCloud": false,
    // 表结构
    "tables": [{
        "name": "user",
        "model": {
            "id:int": {
                "pk": true,
                "ai": true
            },
            "age:int": {
                "default": 13,
                "max": 110,
                "min": 13
            },
            "name:string": {
                "default": "none",
                "notNull": true
            }
        }
    }]
}

表结构详见nanosql (opens new window)

# 调试应用

# 1、打开开发者中心

打开或运行 COOL-AI->微信扫码登录->点击头像进入开发者中心

# 2、在开发者中心创建应用

将之前创建好的项目中的app.json文件拖入开发者中心，就会自动创建一个对应的项目

# 3、运行应用

点击运行按钮，就可以看到对应应用的运行窗口啦

# 4、上传应用

点击上传按钮，填写版本信息，点确定后应用会自动打包编译并上传

# 非脚手架

# 创建必要文件

在根目录手动创建preload.js、db.json、app.json、README.md文件，db.json和app.json的目录结构见上文，preload.js和README.md根据实际自由编写

文件说明

参数	说明
preload.js	预加载的 js，该 js 会优先于所有应用的 js 执行
db.json	数据库配置文件，结构见上文
app.json	应用配置文件，结构见上文
README.md	应用介绍文件，填写一些有关应用的介绍或教程

# 创建应用

同样，将app.json配置文件拖入 COOL-AI, 后续的操作如同脚手架开发

# 视频

创建应用 (opens new window)

# 源码

# 列表

cool-ai-client: Electron 客户端
cool-ai-serve: 服务端(新版COOL-ADMIN-PRO)
cool-ai-serve-vue: 服务端前端(新版COOL-ADMIN-PRO)

# 版本

版本	版本说明	价格
学习版	源码，会员群，不可用于商业用途，只能用于`学习`研究	399 元
专业版	源码，会员群，可以用于`商业`用途，不受项目限制	699 元
旗舰版	源码，会员群，`商业`用途，专人`指导开发`	999 元

WARNING

注意：学习版虽然也包含COOL-ADMIN-PRO，但是也是无法用于商业用途，其他版本无该限制

# 购买

购买地址 (opens new window)

# 微信客服

# 声明

不能用于非法用途；
不可倒卖源码，发现倒卖者可像 COOL 官方反馈，官方将给予奖励；
未购买授权禁止商业使用;
不得将代码随意发给他人使用;

为了保障其他人的利益，请大家自觉遵守，否则平台将不再提供任何服务，并追究其责任！

通知 →