对信系统是一款开源的PHP建站系统,是“多圈”建站系统。专业为产品打造多圈社区,可搭建社区,问答,商城,有pc端,h5,微信小程序,百度小程序。基于商业开源,100%开源,可以商用。
组织介绍

<<<<<<< HEAD

对信 AI 建站主站(duixin_ai_admin)

一个「AI 原生」的建站系统主站:桌面端负责生成与部署。
(PHP + MySQLi/SQLite3),业务层由对信自研插件构成,整体以 Apache-2.0 协议开源。
官网 https://duixin.cc


目录

  1. 项目定位
  2. 开源协议
  3. 能力全景
  4. 系统架构
  5. 目录结构
  6. 插件体系
  7. 模板体系
  8. 自定义模型与字段系统
  9. 接口体系与 API 文档
  10. AI 建站网关
  11. 会员、登录与积分
  12. 支付体系
  13. 安全设计
  14. 安装教程
  15. 使用说明
  16. 二次开发指南
  17. 与 AI 软件协同的开发模式
  18. 性能与运维
  19. 常见问题 FAQ
  20. 版本与路线
  21. 参与贡献

一、项目定位

对信 AI 建站不是一个「单机 CMS」,而是一套三端协同的建站生产系统:

角色 仓库 职责
主站 duixin_ai_admin(本仓库) 会员体系、微信扫码登录、AI 请求网关、积分计费、支付、副站代理支付、对外开放接口
桌面端 duixin_ai_pc 本地项目管理、文件树/编辑器/终端/预览、AI 对话、补丁确认、SFTP/宝塔部署

一句话概括:桌面端把「想法 → 代码 → 上线」压缩成一次对话,主站把「身份 → 额度 → 支付 → 转发」收口成一套服务。

它解决什么问题

  • 建站门槛:用户不需要懂 PHP、模板语法、服务器配置,AI 直接产出可运行的插件、模板与数据表。
  • 模型成本:多厂商模型统一到一套 OpenAI 兼容协议,按 token 计费、按积分结算,支持用户自带 Key。
  • 多站复用:副站不必自建支付与 AI 通道,通过授权密钥由主站代付、代转发。
  • 可维护性:插件目录即应用,模板即文件,没有构建步骤,AI 与人类都能直接读写。

适用场景

企业官网、行业门户、活动落地页、工具型站点、私域会员站、需要「AI 生成 + 人工确认」可控交付的建站服务。


二、开源协议

本项目整体采用 Apache License 2.0 开源:

  • 允许商业使用、修改、分发、私有化部署;
  • 分发时需保留版权声明、许可证文本与 NOTICE 文件;
  • 修改过的文件需标注变更说明;
  • 不提供任何明示或暗示的担保,作者不承担因使用本软件产生的连带责任。

需要说明的边界:

  1. duixin/Fcms/、duixin/System/ 为框架内核,文件头保留「对信权版」声明,二次开发请通过继承与插件扩展,不要直接改动内核文件。
  2. public/api/pay/ 内的微信/支付宝第三方 SDK 遵循其各自协议,不适用本项目的 Apache-2.0。
  3. 站点实际运营产生的数据、素材、商标归运营方所有。

若你基于本项目提供 SaaS 服务,请自行完成备案、等保与内容合规义务;开源协议不豁免运营责任。


三、能力全景

维度 能力
建站 插件化业务、模板主题、内容模型、自定义字段、伪静态、多端模板
AI 多厂商流式对话、平台额度/自带 Key、会话云端同步、内容审核、前缀缓存
账号 注册登录、微信扫码、验证码、找回密码、用户组与级别、会员资料
计费 Token 计量、预扣 + 结算、积分流水、失败回滚
支付 积分充值、微信支付、主站代理副站支付、回调验签
接口 前台/后台/会员接口、Openapi 通用数据网关、Httpapi 授权接口、自动 API 文档
安全 上传黑名单、随机后台入口、字段过滤、表存在性判断、Token 鉴权、CORS 白名单
运维 文件缓存、模板缓存、安装锁、日志表、备份与灰度部署

四、系统架构

4.1 分层视图

┌──────────────────────────────────────────────────────────────┐
│  客户端层                                                     │
│  桌面端 duixin_ai_pc(Electron + Vue3)                        │
│  浏览器(PC 主题 / 移动主题)    副站 / 第三方系统              │
└───────────────────────────┬──────────────────────────────────┘
                            │ HTTP / SSE / Token
┌───────────────────────────▼──────────────────────────────────┐
│  接入层  public/index.php  public/admin*.php  install.php      │
│  路由:?s=应用&c=控制器&m=方法 + config/rewrite.php 伪静态      │
└───────────────────────────┬──────────────────────────────────┘
┌───────────────────────────▼──────────────────────────────────┐
│  框架层  duixin/Fcms(Core / Model / Library / Field / View)   │
│          duixin/System(数据库 / 缓存 / 配置 / 路由 / 事件)    │
└───────────────────────────┬──────────────────────────────────┘
┌───────────────────────────▼──────────────────────────────────┐
│  业务层  duixin/App/*( Openapi / Httpapi / Member /   │
│          Weixin / Payjifen / Proxypay / Wxshare)               │
└───────────────────────────┬──────────────────────────────────┘
┌───────────────────────────▼──────────────────────────────────┐
│  数据层  MySQLi / SQLite3   +   cache/(文件缓存、模板编译)    │
└──────────────────────────────────────────────────────────────┘

4.2 一次请求的完整链路

  1. Web 服务器把请求交给 public/index.php;
  2. 入口定义 ROOTPATH、FCPATH、WRITEPATH、CONFIGPATH;
  3. 若 cache/install.lock 不存在,自动进入 install.php 安装流程;
  4. 加载 duixin/Fcms/Init.php,初始化配置、数据库、缓存、会话、路由;
  5. 路由按 s(应用)、c(控制器)、m(方法)定位到插件控制器;
  6. 控制器通过 Service::M() / Service::L() 调模型与类库,返回 _json() 或渲染模板;
  7. 框架按需写缓存(配置、模板编译、会员缓存),响应输出。

4.3 关键架构决策

决策 说明 收益
不使用 Composer 自动加载 根目录 composer.json 仅供 IDE 跳转,运行期不参与 上传即用,无 vendor 依赖,虚拟主机可跑
插件即目录 duixin/App/应用名/ 就是应用,目录名即 s 参数 新增业务只需建目录,AI 易生成
统一 Service::L('类名','应用名') 类库按应用隔离加载 避免命名空间硬引用导致的类找不到
模板无构建 .html + {...} 指令,运行时编译进 cache/template/ 改完即生效,适合 AI 直接编辑
双数据库驱动 MySQLi 为主,SQLite3 兼容 本地预览与轻量部署更灵活
前后端同源 桌面端只调 HTTP/SSE,不嵌入 PHP 主站可独立升级、独立扩容

五、目录结构

duixin_ai_admin/
├── duixin/
│   ├── App/                       业务插件(日常改动主战场)
│   │   ├── Openapi/               通用数据接口
│   │   ├── Httpapi/               站点/数据库/附件授权接口
│   │   ├── Member/                会员注册登录与资料
│   │   ├── Weixin/                微信公众号与扫码登录
│   │   ├── Payjifen/              积分购买
│   │   ├── Proxypay/              主站代理副站支付
│   │   └── Wxshare/               微信二维码共享
│   ├── Fcms/                      框架内核(Core / Model / Library / Field / View)
│   ├── System/                    底层能力(数据库、缓存、配置、路由、事件)
│   └── My/                        站点级配置与视图扩展
├── config/                        站点配置、字段样式、伪静态、通知模板
├── template/                      站点模板(pc/default、404、msg)
├── public/                        Web 根目录、入口、安装程序、后台入口
├── cache/                         运行时缓存与模板编译产物
├── uploadfile/                    上传附件目录
├── AGENTS.md                      给 AI 的项目说明(手写维护)
├── PROJECT_MAP.md                 自动生成的结构索引(勿手改)
└── README.md                      本文档

各目录职责速查

目录 职责 是否常改
duixin/App/ 业务插件 是
template/pc/default/ 主题模板 是
config/ 伪静态、字段样式、通知模板 偶尔
duixin/Fcms/、duixin/System/ 框架内核 禁止
cache/ 缓存与编译产物 禁止手改
public/api/pay/ 第三方支付 SDK 禁止

六、插件体系

6.1 插件清单

应用 key 名称 核心职责
openapi Openapi 接口 通用表数据网关(list/detail/create/update/delete),表白名单 + 密钥 + 只读开关
httpapi API 接口 桌面端站点/数据库/附件接口,按 AppID 配置操作与表白名单
member 会员 注册、登录、验证码、资料、头像、用户组、级别
weixin 微信 公众号接入、扫码登录、消息处理
payjifen 积分购买 套餐、下单、支付、回调加积分
proxypay 代理支付 副站用主站二维码收款,主站回调副站
wxshare 微信二维码共享 多站二维码共享展示

6.2 插件的固定结构

duixin/App/Shop/
├── Config/
│   ├── App.php          # 应用元信息:type/name/author/icon/uri
│   ├── Menu.php         # 后台菜单
│   ├── Routes.php       # 自定义路由
│   ├── Install.php      # 安装逻辑(建表、种子数据)
│   └── Version.php      # 版本与兼容性
├── Controllers/
│   ├── Goods.php        # 前台接口
│   ├── Admin/Goods.php  # 后台接口
│   └── Member/Order.php # 会员接口
├── Models/
│   └── Goods.php        # 数据模型
├── Libraries/
│   └── Helper.php       # 业务类库
└── Views/
    └── index.html       # 后台视图(可选)

Config/App.php 最小示例:

<?php

return [
    'type'   => 'app',
    'name'   => '商城',
    'author' => 'Duixin',
    'icon'   => 'fa fa-shopping-cart',
    'uri'    => 'shop/home/index',
];

6.3 加载机制

  • 控制器命名空间统一为 Phpcmf\Controllers,继承 \Phpcmf\App;
  • 模型命名空间为 Phpcmf\Model\应用名,继承 \Phpcmf\Model;
  • 类库通过 \Phpcmf\Service::L('类名', '应用名') 获取,禁止完整命名空间静态引用;
  • 模型通过 \Phpcmf\Service::M('模型名', '应用名') 获取;
  • 配置通过 \Phpcmf\Service::C() 读取缓存配置。
$model  = \Phpcmf\Service::M('goods', 'shop');
$helper = \Phpcmf\Service::L('helper', 'shop');

6.4 安装与升级生命周期

  1. 后台安装插件时执行 Config/Install.php;
  2. 建表推荐统一走 \Phpcmf\Service::M('table')->install_schema(),自动处理前缀、索引与注释;
  3. 安装成功后写入版本记录,Config/Version.php 用于升级判断;
  4. 插件表可能因安装中断而缺失,读写前先判断表是否存在;
  5. 卸载只删配置与菜单,不自动删业务表,避免误删数据。

6.5 新增一个插件的最小步骤

  1. 建目录 duixin/App/Demo/;
  2. 写 Config/App.php(名称、图标)、Config/Install.php(建表);
  3. 写 Controllers/Home.php,提供 index、show、save、del;
  4. 写 Config/Menu.php 注册后台菜单;
  5. 后台「应用」里安装,清缓存;
  6. 在桌面端「项目设置 → API 接口文档」重新扫描,确认接口已识别。

七、模板体系

7.1 模板位置

路径 用途
template/pc/default/ PC 默认主题
template/pc/default/member/ 会员中心主题
template/404.html 404 页
template/msg.html 通用提示页
config/page/pc/、config/page/mobile/ 单页配置
`config/notice/email mobile

模板文件是标准 .html,由框架运行时编译到 cache/template/,没有 npm、没有打包、改完刷新即生效。

7.2 常用指令

指令 作用 示例
{template "header.html"} 引入片段 {template "mheader.html"}
{$var} 输出变量 {$member.username}
{if 条件}...{else}...{/if} 条件判断 {if dr_is_app('scorelog')}
{loop $list $k $v}...{/loop} 循环 {loop $ci->member_cache['group'] $gid $t}
{php}...{/php} 内嵌 PHP 复杂逻辑兜底
{dr_xxx(...)} 调用框架函数 {dr_member_url('account/avatar')}
{number_format($v,2)} 调用 PHP 函数 金额格式化

会员中心片段示例:

{template "mheader.html"}

<div class="profile-usertitle-name">{$member.username}</div>

{if dr_is_app('scorelog')}
<div class="user-balance">{$member.score}</div>
{/if}

{loop $ci->member_cache['group'] $gid $t}
    {if $member['groupid'][$gid]}
        <span>{$t.name}</span>
    {/if}
{/loop}

7.3 主题与多端

  • 主题目录结构固定:template/pc/主题名/,切换主题只改配置,不动代码;
  • 移动端主题按 template/mobole/(副站)或对应目录扩展;
  • 页面级模板通过插件 Views/ 或主题文件覆盖;
  • 颜色、字号等建议统一走 CSS 变量,便于 AI 批量改版。

7.4 模板开发约定

  1. 不要把业务查询写进模板,模板只做展示,数据由控制器准备;
  2. 公共头尾抽成 header.html / footer.html,减少重复;
  3. 表单提交地址用 dr_now_url(),不要硬编码路由;
  4. 输出用户内容时注意转义,富文本才允许原样输出;
  5. 模板里的条件尽量简单,复杂判断放控制器。

八、自定义模型与字段系统

对信系统的「模型」不是 ORM 概念,而是可配置的内容结构,分为三类:

类型 说明 典型用途
内容模型(module) 栏目 + 主表 + 附加表,支持列表/详情/搜索 新闻、产品、案例、房源
表单模型(form / mform) 独立表单,可前台提交、后台审核 报名、留言、询价、投稿
会员模型(member) 会员主表 + 附加字段 资料扩展、实名信息

8.1 字段类型(30 种)

框架内置字段控件位于 duixin/Fcms/Field/:

类别 字段
文本 Text 单行文本、Textarea 多行文本、Editor 富文本、Textbtn 带按钮文本、Textselect 文本下拉
选择 Select 单选下拉、Selects 多选下拉、Radio 单选、Checkbox 多选
文件 Image 单图、File 单文件、Files 多文件
时间 Date 日期、Time 时间
关联 Linkage 联动单选、Linkages 联动多选、Join 关联表、Group 分组、Merge 合并、Members 会员关联
交易 Pay 单金额、Pays 多金额、Paystext 金额文本、Score 积分
其它 Color 颜色、Uid 用户 ID、Property 属性、Ftable 副表、Diy 自定义、Touchspin 步进器

8.2 字段的三套渲染样式

config/field.php 定义字段在后台、会员中心、前台的 HTML 包装:

return [
    'admin'  => '<div class="form-group" id="dr_row_{name}">
                    <label class="control-label col-md-2">{text}</label>
                    <div class="col-md-10">{value}</div>
                 </div>',
    'member' => '...',
    'home'   => '...',
];

因此同一份字段配置可以自动适配三种界面,不需要为每个端重复写表单。

8.3 自定义字段扩展

在 config/myfield/ 下新增文件即可扩展字段行为,例如 test.php。配合 myfield_tablename_* 之类的约定函数,可以让字段落到自定义数据表。

开发步骤:

  1. 在 config/myfield/ 建 xxx.php;
  2. 按约定返回字段配置与表名解析函数;
  3. 后台「自定义字段」里选择该字段类型;
  4. 清缓存后生效。

8.4 数据表规范

  • 表名统一带 {dbprefix} 前缀;
  • 建表语句放在插件 Config/Install.sql 或 Config/Install.php;
  • 表和字段必须写 COMMENT,否则桌面端接口文档里没有说明;
  • 唯一索引字段写入前先查重;
  • 写库前按实际表结构过滤字段,避免多站表结构差异导致 SQL 报错。
CREATE TABLE IF NOT EXISTS `{dbprefix}shop_goods` (
  `id`    int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
  `title` varchar(100) NOT NULL DEFAULT '' COMMENT '商品标题',
  `price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '售价',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品表';

8.5 自定义模型与 AI 的关系

AI 生成内容模型时遵循固定套路:

  1. 先定字段(名称、类型、是否必填、默认值);
  2. 生成建表 SQL 与 Install.php;
  3. 生成后台表单配置;
  4. 生成列表/详情模板;
  5. 生成前台接口(index / show / save / del)。

因为字段类型、目录结构、注释格式都是稳定的,AI 才能在一次对话里产出可运行的一整套代码。


九、接口体系与 API 文档

9.1 URL 规则

前台:  index.php?s=应用&c=控制器&m=方法
后台:  admin****.php?s=应用&c=控制器&m=方法
会员:  index.php?s=member&app=应用&c=控制器&m=方法

应用目录名即 s 参数,全部小写。例如 duixin/App/Shop/ 对应 s=shop。

9.2 接口分组

桌面端扫描 duixin/App/*/Controllers、Models、Config/Install*.sql,按位置自动分组:

控制器位置 分组 权限
Controllers/*.php 前台 公开或 Token
Controllers/Admin/*.php 后台 需后台登录
Controllers/Member/*.php 会员 需会员登录
Models/*.php 等 其他 模型方法

只扫描 public function;__construct、private、protected 不会出现在文档里。

9.3 方法名决定动作类型

动作 方法名(不区分大小写)
新增 add create insert save publish submit post
修改 edit update modify change set status audit pass unpass
删除 del delete remove drop clear cancel
详情 show detail view info content read
列表 index list lists liebiao getlist index_list
查询 search sou sousuo query find filter

HTTP 方法判定顺序:

  1. 新增 / 修改 / 删除 → 一律 POST;
  2. 否则方法体出现 $_POST、$_REQUEST、IS_POST、dr_post → POST;
  3. 其余 → GET。

9.4 GET 接口写法

<?php namespace Phpcmf\Controllers;

/**
 * 商品列表
 * @param int catid 栏目 id 必填
 * @param string keyword 关键词 选填
 * @param int page 页码 选填
 */
class Goods extends \Phpcmf\App
{
    public function index()
    {
        $catid   = (int)\Phpcmf\Service::L('input')->get('catid');
        $keyword = (string)\Phpcmf\Service::L('input')->get('keyword');
        $page    = (int)\Phpcmf\Service::L('input')->get('page') ?: 1;

        $this->_json(1, 'ok', ['list' => [], 'total' => 0]);
    }
}

9.5 POST 接口写法

/**
 * 保存商品
 * @param int id 商品 id,0 表示新增 选填
 * @param string title 商品标题 必填
 * @param float price 售价 必填
 * @param array images 图片地址数组 选填
 * @response data array 保存后的商品数据
 */
public function save()
{
    $id     = (int)$_POST['id'];
    $title  = (string)$_POST['title'];
    $price  = (float)$_POST['price'];
    $images = json_decode((string)$_POST['images'], true);

    $this->_json(1, '保存成功', ['id' => $id, 'title' => $title]);
}

9.6 可被识别的取参写法

$_GET['catid']        $_POST['title']       $_REQUEST['type']
\Phpcmf\Service::L('input')->get('catid')
\Phpcmf\Service::L('input')->post('title')
\Phpcmf\Service::L('input')->get_post('type')
$this->input->get('catid')   $this->input->post('title')
dr_input('catid')  dr_get('catid')  dr_post('title')

以下情况扫不到,需要写 @param 兜底:

  • 参数在 __construct、私有方法、父类或 trait 里取;
  • 参数封装在自定义函数里;
  • 键名是变量拼接($_GET[$name])。

9.7 注释规范

/**
 * 商品详情
 * @param int id 商品 id 必填
 * @param string type 类型 选填
 * @response data array 商品数据
 * @responseExample
 * {
 *   "code": 1,
 *   "msg": "ok",
 *   "data": { "id": 1, "title": "测试商品" }
 * }
 */
public function show() { ... }
  • 注释必须紧贴 public function 上方;
  • @param 类型 名称 说明 必填,结尾写「必填 / 选填」;
  • @response 为自动识别的字段补说明;
  • @responseExample 整段覆盖自动生成的示例。

9.8 统一响应

$this->_json($code, $msg, $data);
  • code:1 成功,0 失败;
  • msg:提示文案;
  • data:业务数据,列表放 data.list。

面板从 _json() 第三个参数或 json_encode([...]) 的字面量推断响应字段。

9.9 现有接口速览

Openapi(s=openapi&c=api)

方法 类型 说明
index GET 网关信息与表白名单
list GET 分页列表,字段可过滤
detail GET 单条详情
create POST 新增
update POST 修改
delete POST 删除

鉴权参数 token,表必须在 Config/Openapi.php 白名单内;支持 readonly 只读模式。

Httpapi(s=httpapi&c=home)

方法 说明
index 调用后台接口
insert / update / delete 数据写入与删除
delete_file 删除本人上传的附件
member / site / category 会员、站点、栏目信息

按 appid 读取授权配置,校验 action(操作)与 table(表白名单)双重权限。

9.10 API 文档自动生成

桌面端「项目设置 → API 接口文档」会:

  1. 扫描控制器、模型、安装 SQL;
  2. 识别分组、动作类型、HTTP 方法、参数、响应字段;
  3. 生成参数表与示例;
  4. 支持「添加到对话」,把接口说明作为上下文交给 AI。

看不到参数时按顺序排查:取参写法 → 是否在方法体内 → 方法名是否符合 GET/POST 预期 → 注释是否紧贴方法。


十、AI 建站网关

Aibuild 是整个系统的核心,负责把桌面端的 AI 请求安全、可计量地转发给大模型。

10.1 支持的服务商

key 名称 默认模型 说明
deepseek DeepSeek deepseek-v4-flash 官方接口,前缀缓存友好
qwen 阿里百炼(通义千问) qwen-plus 兼容模式
tokenhub 腾讯 TokenHub deepseek-v4-pro 多模型聚合
baidu 百度千帆 ernie-5.1 文心与第三方模型
ark 火山方舟 doubao-seed-2-1-pro 豆包与 DeepSeek
openai OpenAI gpt-4o-mini 标准协议
mock 模拟 — 本地调试,不产生费用

所有服务商统一走 OpenAI 兼容协议,分别配置 base_url、api_key、model,可单独覆盖默认值。

10.2 两种额度模式

模式 判定 计费
平台额度 请求未带用户 Key,且服务端已配置 Key 扣会员积分
自带 Key 桌面端传入 api_key,且 allow_user_key 开启 不占平台额度
禁止自带 会员组无权限 回退平台额度或拒绝

keyperm 接口返回当前会员对各服务商的自带 Key 权限,桌面端据此决定是否展示输入框。

10.3 鉴权与令牌

  1. 桌面端登录后调用 token,用 api_auth_uid + api_auth_code 换取 Token;
  2. 服务端校验 md5(password + salt);
  3. 无可用 Token 时自动创建,写入 aibuild_token;
  4. 后续请求带 token,服务端校验状态、过期时间、最后使用 IP;
  5. Token 可停用、可删除、可设过期时间。

10.4 流式对话

  • 请求 m=chat,服务端以 SSE 逐段回传;
  • 支持 tools / tool_choice / temperature / max_tokens;
  • 默认超时 300 秒,最大输出 8192 token;
  • 桌面端收到片段后增量渲染,不等整段返回。

10.5 计费模型

预扣 + 结算:

  1. 请求进入时按输入字符与模型单价预估,先校验余额;
  2. 流式过程中累计用量;
  3. 结束后按实际 prompt_tokens / completion_tokens 结算;
  4. 失败或中断按规则回滚,避免多扣;
  5. 每次调用写 aibuild_log,每次会话写 aibuild_chat。

数据表:

表 用途 关键字段
aibuild_token 调用令牌 uid、token、status、expired、lastip
aibuild_log 单次用量与积分 model、total_tokens、score、balance、status
aibuild_chat 会话与凭证 sid、rounds、cache_hit_tokens、messages

aibuild_chat 对 (uid, sid) 建唯一索引,保证同一会话只留一条主记录,消息与每轮用量以 JSON 存放。

10.6 会话云端同步

桌面端本地会话可上传到云端:

  • chats 拉列表(不含正文);
  • chat_detail 拉单条(含消息与每轮用量);
  • chat_save 保存或覆盖;
  • chat_remove 删除。

这样换设备、重装客户端都能恢复历史,同时云端记录也是计费凭证。

10.7 内容审核

Libraries/Moderation.php 在请求前后做敏感内容检查,按配置决定:

  • 命中即拒绝,返回统一错误;
  • 仅记录不拦截(灰度期);
  • 对输出做二次检查,防止模型生成违规内容。

10.8 前缀缓存优化(重要)

DeepSeek 等厂商按前缀命中缓存,命中部分价格更低。因此系统约定:

  • 系统提示词必须保持纯静态;
  • 当前文件、文件清单等动态内容只能追加在最后一条用户消息末尾;
  • 不要调整消息顺序,不要在中途插入动态片段;
  • 命中量记录在 cache_hit_tokens,可用于评估优化效果。

这条约定同时影响成本与响应速度,改动提示词结构前务必确认。


十一、会员、登录与积分

11.1 登录方式

方式 说明
账号密码 传统登录,支持错误次数限制
微信扫码 PC 端扫码,公众号内静默授权
手机验证码 短信登录/注册
邮箱验证码 邮件登录/找回
第三方 OAuth 可扩展

11.2 会员中心

  • 资料修改、头像上传(返回前归一化域名、升级 https、去引号);
  • 密码、手机、邮箱绑定与换绑;
  • 用户组与级别展示、有效期;
  • 积分与余额、收入/消费记录;
  • 登录日志、解绑第三方账号。

11.3 用户组与权限

权限按「组 → 级别 → 应用/模块/栏目/表单」逐层判断,Member_auth 提供:

member_auth / app_auth / home_auth / module_auth / category_auth / mform_auth / form_auth

后台可配置每个组可访问的应用、模块、栏目与表单,未授权直接拦截。

11.4 积分体系

  • 积分是 AI 计费的结算单位;
  • 充值走 payjifen;
  • 消费写 aibuild_log,可追溯到模型、Token、IP;
  • 余额不足时网关直接拒绝,不发起上游请求。

十二、支付体系

12.1 积分购买(Payjifen)

流程:

  1. 后台配置套餐(积分数量、价格、赠送);
  2. 用户选择套餐下单,生成订单;
  3. 拉起微信支付二维码;
  4. 支付回调验签,幂等加积分;
  5. 写积分流水,通知用户。

要点:

  • 回调必须验签、必须幂等;
  • 订单状态机:待支付 → 已支付 → 已关闭;
  • 金额以分为单位,避免浮点误差;
  • 支付 SDK 位于 public/api/pay/,不要改动。

12.2 主站代理副站支付(Proxypay)

适用场景:副站没有独立支付资质,借用主站商户号收款。

副站下单 → 带授权密钥请求主站 → 主站生成微信二维码
        → 用户支付 → 微信回调主站 → 主站验签
        → 主站回调副站 → 副站加积分/开通服务

配置要点:

  • 副站必须填写主站生成的授权密钥,否则返回「副站未授权」;
  • 回调地址必须是公网可达的 HTTPS;
  • 主站与副站都要做幂等,防止重复加积分;
  • 建议记录完整链路日志(副站订单号、主站订单号、微信交易号)。

12.3 退款与对账

  • 退款走原路退回,需记录操作人与原因;
  • 每日对账:微信账单 vs 本地订单 vs 积分流水;
  • 差异单进入人工复核队列,不自动补单。

十三、安全设计

层面 措施
入口 后台入口文件名随机(public/admin*.php),不写进文档、不提交到公开仓库
安装 cache/install.lock 控制安装态,上线后删除 install.php
上传 config/fileext.php 黑名单拦截 php/asp/jsp/exe/sh 等,允许远程下载的仅图片与压缩包
SQL 写库前按表结构过滤字段,唯一索引先查重,表缺失先判断存在
接口 Token 鉴权、AppID 授权、表白名单、操作白名单、只读开关
跨域 仅对桌面端接口开放必要 Header 与 Method,OPTIONS 预检单独处理
密钥 服务商 Key 存配置,不写日志、不回传前端;用户 Key 仅透传
内容 请求与响应双向审核,命中策略可配置
密码 加盐哈希,登录失败计数与锁定
权限 用户组/级别/应用/模块/栏目多层校验

特别提醒

  • 不要为了「方便」把后台入口改回 admin.php;
  • 不要把 config/database.php 提交到公开仓库;
  • 不要在模板里直接输出未过滤的用户输入;
  • 不要在日志里打印完整 Token 或 API Key;
  • 生产环境关闭 IS_DEV 与 IS_EDIT_TPL。

十四、安装教程

14.1 环境要求

项目 要求
PHP 8.1.0 及以上(安装程序会校验)
数据库 MySQL 5.7+ / 8.0,或 SQLite3
Web 服务器 Nginx / Apache / IIS
扩展 mysqli、pdo、curl、gd、mbstring、json、openssl、fileinfo
目录 必须安装在域名根目录,路径不能含空格、[、]
磁盘 建议预留 2GB 以上(缓存、上传、日志)

14.2 安装步骤

  1. 上传源码:把仓库内容上传到站点根目录,确保 public/index.php 可通过域名访问(若面板要求,将运行目录指向 public/,或按主机商规则把 public/ 内容放到根目录)。
  2. 创建数据库:记录主机、端口、库名、用户名、密码。
  3. 配置目录权限:确保以下目录可写:
    • cache/
    • cache/data/
    • cache/template/
    • cache/file/
    • cache/session/
    • config/
    • uploadfile/
  4. 访问域名:首次访问会自动跳转安装程序;若未跳转,手动访问 /install.php。
  5. 填写信息:数据库连接、管理员账号密码、站点名称。
  6. 完成安装:程序写入 cache/install.lock,生成后台入口文件。
  7. 删除安装文件:删除 public/install.php(或根目录下的 install.php)。
  8. 配置伪静态:按下方规则配置,否则列表/详情页 404。
  9. 登录后台:使用随机后台入口登录,完成站点、微信、支付、AI 配置。

14.3 Nginx 伪静态

location / {
    if (-f $request_filename) {
        break;
    }
    if ($request_filename ~* "\.(js|ico|gif|jpe?g|bmp|png|css)$") {
        break;
    }
    if (!-e $request_filename) {
        rewrite ^ /index.php last;
    }
}

14.4 Apache 伪静态

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule !.(js|ico|gif|jpe?g|bmp|png|css)$ /index.php [NC,L]

14.5 安装后检查清单

  • 首页、列表页、详情页、404 页均正常;
  • 后台可登录,菜单完整;
  • cache/ 有写入权限,清缓存不报错;
  • 上传图片成功,附件可访问;
  • 微信扫码登录可用(需公众号配置);
  • AI 网关 m=index 返回正常;
  • 会员注册、积分充值链路可跑通;
  • install.php 已删除;
  • 已配置 HTTPS 与每日备份。

14.6 常见安装错误

现象 原因 处理
「本程序必须在域名根目录中安装」 装在子目录 移到域名根目录,或按主机商规则调整
「目录不可写」 权限不足 给 cache/、config/、uploadfile/ 写权限
安装后 404 伪静态未配置 按 14.3 / 14.4 配置
后台入口打不开 文件名被改或删除 从备份恢复,或在 public/ 下查找 admin*.php
页面空白 PHP 版本过低或扩展缺失 升级到 8.1+,安装缺失扩展
数据库连接失败 端口/账号错误 检查 config/database.php 与数据库白名单

十五、使用说明

15.1 后台初始化顺序

  1. 站点设置:名称、域名、Logo、备案号、SEO;
  2. 会员设置:注册方式、验证码、用户组、级别;
  3. 微信设置:AppID、AppSecret、扫码登录回调;
  4. 支付设置:商户号、证书、回调地址;
  5. AI 设置:选择默认服务商、填 Key、设默认模型、开关注入审核;
  6. 插件安装:按需安装业务插件;
  7. 清缓存:配置类改动后清一次。

15.2 桌面端配对

  1. 在桌面端登录主站账号;
  2. 客户端调用 token 换取访问 Token;
  3. 在「设置 → 模型」里选择服务商与模型;
  4. 若开启自带 Key,可填自己的 Key,不消耗平台积分;
  5. 新建项目时自动写入站点根目录 AGENTS.md(已存在不覆盖)。

15.3 AI 建站工作流

新建/导入项目
   ↓
读取 AGENTS.md + PROJECT_MAP.md + API 文档
   ↓
对话描述需求
   ↓
AI 返回代码补丁(不直接写盘)
   ↓
编辑器待确认态:逐段接受 / 拒绝
   ↓
本地预览(宝塔 PHP + MySQL)
   ↓
部署(SFTP / 宝塔),默认排除 AGENTS.md 与缓存
   ↓
主站记录用量与积分

15.4 副站接入主站支付

  1. 主站后台生成副站授权密钥;
  2. 副站配置主站地址与密钥;
  3. 副站下单时携带订单号、金额、回调地址;
  4. 支付成功后主站回调副站,副站幂等加积分;
  5. 对账时按副站订单号关联主站订单号。

15.5 接口文档使用

  1. 桌面端进入「项目设置 → API 接口文档」;
  2. 点击重新扫描;
  3. 确认分组、动作、参数、响应;
  4. 选中接口「添加到对话」,AI 即可按真实参数生成调用代码;
  5. 新增接口后重复以上步骤。

十六、二次开发指南

16.1 必须遵守的约定

约定 说明
类加载 统一 Service::L('类名','应用名'),禁止命名空间静态引用
后台跳转 用后台入口常量拼接,禁止硬编码 index.php
表单提交 用 dr_now_url(),不要写死路由
保存逻辑 在 index() 内判断 POST,遵循框架惯例
数据库 按表结构过滤字段,唯一索引先查重,表缺失先判断
内核 不改 Fcms/、System/,通过继承与钩子扩展
敏感文件 不动 config/database.php、public/api/pay/、cache/

16.2 新增接口

  1. 在对应控制器写 public function;
  2. GET 用 input->get / $_GET,POST 用 $_POST / input->post;
  3. 写 @param、@response;
  4. 统一 _json(code, msg, data) 返回;
  5. 桌面端重新扫描验证。

16.3 新增模型

<?php namespace Phpcmf\Model\Shop;

class Goods extends \Phpcmf\Model
{
    public function get_list($where = [], $page = 1, $size = 20)
    {
        $builder = $this->db->table('shop_goods');
        if ($where) {
            $builder->where($where);
        }
        $total = (int)$builder->countAllResults();

        $builder = $this->db->table('shop_goods');
        if ($where) {
            $builder->where($where);
        }
        $rows = $builder->orderBy('id', 'desc')
            ->limit($size, ($page - 1) * $size)
            ->get()->getResultArray();

        return ['rows' => $rows, 'total' => $total];
    }
}

调用:

$data = \Phpcmf\Service::M('goods', 'shop')->get_list(['status' => 1], 1, 20);

16.4 新增模板

  1. 在 template/pc/default/ 建目录与 .html;
  2. 用 {template} 复用头尾;
  3. 数据由控制器 \Phpcmf\Service::V()->assign() 传入;
  4. 清 cache/template/ 或后台清缓存。

16.5 调试建议

  • 开发期可临时开 IS_DEV = 1,上线改回 0;
  • 不要长期开 IS_EDIT_TPL;
  • 用 cache/ 下的日志定位问题;
  • 改配置后先清缓存再判断是否生效;
  • 涉及计费与消息顺序的改动,必须回归测试。

十七、与 AI 软件协同的开发模式

这是本系统与传统 CMS 最大的差异:代码主要由 AI 生成,人类负责确认与部署。

17.1 上下文供给

文件 作用 维护方式
AGENTS.md 项目规则、目录职责、禁止事项、踩坑记录 手写维护
PROJECT_MAP.md 文件树、关键类、方法、行号索引 工具扫描生成,勿手改
duixin/App/插件接口开发规范.md 接口写法与注释规范 手写维护
API 文档 接口参数与响应 桌面端扫描生成

生成或更新索引:

node "D:\wwwroot\duixin_ai_pc\tools\repomap\cli.js" --root "D:\wwwroot\duixin_ai_admin"

node "D:\wwwroot\duixin_ai_pc\tools\repomap\cli.js" --root "D:\wwwroot\duixin_ai_admin" --verify AGENTS.md

17.2 补丁确认机制

  • AI 回复中的代码不会直接落盘;
  • 由 aipatch.ts 解析成补丁块;
  • 编辑器进入待确认态,逐段接受或拒绝;
  • 接受后才写入文件;
  • 这样避免 AI 误改核心文件或覆盖用户代码。

17.3 缓存友好的提示词结构

[静态系统提示词]
  ├─ 角色与规则
  ├─ 目录职责
  ├─ 代码规范
  └─ 输出格式
[对话历史]
[最后一条用户消息]
  ├─ 用户需求
  ├─ 当前文件内容
  └─ 相关文件清单

动态内容永远在最后,系统提示词永远不变,才能最大化前缀缓存命中率。

17.4 AI 适合做什么

  • 新增插件、控制器、模型、模板;
  • 按规范补接口注释与 API 文档;
  • 批量改样式、适配主题变量;
  • 生成建表 SQL 与安装脚本;
  • 排查报错并给出最小修复。

17.5 AI 不适合做什么

  • 未经确认改框架内核;
  • 直接操作生产数据库;
  • 处理支付密钥、证书等敏感信息;
  • 大范围重构已稳定运行的计费链路;
  • 替代人工做上线前的安全与合规审查。

17.6 协作产出物

一次典型需求会产出:

  1. 变更文件清单;
  2. 代码补丁;
  3. 建表 SQL;
  4. 接口文档增量;
  5. 验证步骤;
  6. 回滚方法。

十八、性能与运维

18.1 缓存分层

层 位置 内容
配置缓存 cache/data/ 站点、应用、字段、权限
模板缓存 cache/template/ 编译后的模板
数据缓存 cache/ 栏目、会员组、联动菜单
会话 cache/session/ 登录态
上游缓存 模型厂商 前缀缓存,命中计费更低

18.2 性能建议

  • 生产环境关闭开发模式;
  • 静态资源走 CDN;
  • 图片上传后生成缩略图,不直接输出原图;
  • 列表接口强制分页,单页不超过 100 条;
  • 会话表按时间归档,日志表定期清理;
  • 高并发场景给 aibuild_log、aibuild_chat 的 uid、inputtime 建索引。

18.3 备份策略

对象 频率 方式
数据库 每日 逻辑备份 + 异地存储
uploadfile/ 每日增量 对象存储同步
config/ 变更时 版本库
代码 每次发布 Git 标签

18.4 升级流程

  1. 备份数据库与代码;
  2. 在预发环境部署新版本;
  3. 跑通登录、AI 对话、充值、部署四条主链路;
  4. 灰度切换;
  5. 观察错误日志与计费差异;
  6. 全量发布,保留回滚包。

18.5 监控指标

  • 接口成功率与 P95 耗时;
  • AI 首字延迟与总耗时;
  • 缓存命中 token 占比;
  • 积分扣减与余额异常;
  • 支付回调失败率;
  • 上传失败率与磁盘占用。

十九、常见问题 FAQ

Q1:为什么必须装在域名根目录?
安装程序会校验 SCRIPT_NAME,子目录会导致路由与静态资源路径错乱。若主机限制,请把域名直接绑定到站点目录。

Q2:后台入口忘了怎么办?
在 public/ 下查找 admin 开头的 PHP 文件(文件名含随机串),或从备份恢复。不要新建 admin.php 代替。

Q3:接口文档里没有参数?
按顺序检查:取参写法是否在支持列表 → 是否写在动作方法体内 → 方法名是否符合 GET/POST 预期 → @param 是否紧贴方法。

Q4:AI 对话报「服务端未配置 Key」?
后台 AI 设置里填对应服务商的 Key,或开启「允许用户自带 Key」让用户在桌面端填自己的 Key。

Q5:积分扣多了/扣少了?
检查 aibuild_log 的 prompt_tokens、completion_tokens、score、balance,确认是否发生中断回滚;再核对模型单价配置。

Q6:副站支付提示「副站未授权」?
副站配置里的授权密钥与主站生成的不一致,或主站未启用该副站。

Q7:改了模板不生效?
清 cache/template/ 或后台清缓存;确认改的是当前启用主题目录。

Q8:新增插件后台看不到?
检查 Config/App.php 的 type 是否为 app、目录名是否小写、是否已安装、缓存是否清理。

Q9:上传图片失败?
检查 uploadfile/ 权限、PHP upload_max_filesize、post_max_size,以及扩展名是否被 config/fileext.php 拦截。

Q10:可以改框架内核吗?
不建议。内核改动会导致升级困难;优先用插件、继承、钩子实现。

Q11:支持 SQLite 吗?
支持,但生产环境建议 MySQL;SQLite 更适合本地预览与轻量站点。

Q12:如何做多站点?
主站负责账号、支付、AI 网关;业务站点作为副站接入,通过授权密钥复用能力。


二十、版本与路线

项目 当前值
内核兼容 对信 CMS 4.7.5
主站版本 4.7.5
AI 网关版本 1.0.0
更新时间 2026-11
开源协议 Apache-2.0

近期方向

  • AI 网关:更多服务商、按会员组配置模型权限、用量看板;
  • 建站:模板市场、组件化区块、可视化微调;
  • 接口:OpenAPI 描述文件导出、SDK 生成;
  • 运维:一键备份恢复、灰度发布、审计日志;
  • 安全:更细粒度的接口限流与风险识别。

二十一、参与贡献

  1. Fork 本仓库;
  2. 新建分支:feat/xxx、fix/xxx;
  3. 遵循 插件接口开发规范 与 AGENTS.md;
  4. 提交前自测:登录、接口、模板、计费四条链路;
  5. 提交 PR,说明变更点、影响范围、验证方式;
  6. 涉及数据库变更的,附建表/升级 SQL 与回滚方案。

提交信息建议

feat(aibuild): 新增 xx 服务商支持
fix(member): 修复头像地址未归一化
docs(readme): 补充安装与伪静态说明

附录 A:常用地址速查

用途 地址
前台首页 /
前台接口 /index.php?s=应用&c=控制器&m=方法
会员中心 /index.php?s=member
后台 /admin****.php(随机入口)
安装 /install.php(安装后删除)
AI 网关 /index.php?s=aibuild&c=api
Openapi /index.php?s=openapi&c=api

附录 B:术语表

术语 含义
应用 / 插件 duixin/App/ 下的一个业务目录
模块 内容模型,含栏目、主表、附加表
字段 内容结构中的一列,对应一种表单控件
联动菜单 省市区等多级选择数据
Token 桌面端调用主站的访问凭证
预扣 请求开始前冻结的积分
结算 请求结束后按实际用量扣减
前缀缓存 模型厂商对相同前缀内容的缓存计费优化
补丁 AI 生成、待人工确认的代码变更

对信 AI 建站 —— 让建站从「写代码」变成「确认结果」。
文档随版本迭代,若与代码不一致,以代码与 AGENTS.md 为准。

成就
83
Star
34
Fork
成员(2)
774184 kujue 1681567532
对信
1172721 naruto2018 1727149214
窗边的小豆豆

搜索帮助