对信AI建站后台管理系统
<<<<<<< HEAD
一个「AI 原生」的建站系统主站:桌面端负责生成与部署。
(PHP + MySQLi/SQLite3),业务层由对信自研插件构成,整体以 Apache-2.0 协议开源。
官网 https://duixin.cc
对信 AI 建站不是一个「单机 CMS」,而是一套三端协同的建站生产系统:
| 角色 | 仓库 | 职责 |
|---|---|---|
| 主站 |
duixin_ai_admin(本仓库) |
会员体系、微信扫码登录、AI 请求网关、积分计费、支付、副站代理支付、对外开放接口 |
| 桌面端 | duixin_ai_pc |
本地项目管理、文件树/编辑器/终端/预览、AI 对话、补丁确认、SFTP/宝塔部署 |
一句话概括:桌面端把「想法 → 代码 → 上线」压缩成一次对话,主站把「身份 → 额度 → 支付 → 转发」收口成一套服务。
企业官网、行业门户、活动落地页、工具型站点、私域会员站、需要「AI 生成 + 人工确认」可控交付的建站服务。
本项目整体采用 Apache License 2.0 开源:
需要说明的边界:
duixin/Fcms/、duixin/System/ 为框架内核,文件头保留「对信权版」声明,二次开发请通过继承与插件扩展,不要直接改动内核文件。public/api/pay/ 内的微信/支付宝第三方 SDK 遵循其各自协议,不适用本项目的 Apache-2.0。若你基于本项目提供 SaaS 服务,请自行完成备案、等保与内容合规义务;开源协议不豁免运营责任。
| 维度 | 能力 |
|---|---|
| 建站 | 插件化业务、模板主题、内容模型、自定义字段、伪静态、多端模板 |
| AI | 多厂商流式对话、平台额度/自带 Key、会话云端同步、内容审核、前缀缓存 |
| 账号 | 注册登录、微信扫码、验证码、找回密码、用户组与级别、会员资料 |
| 计费 | Token 计量、预扣 + 结算、积分流水、失败回滚 |
| 支付 | 积分充值、微信支付、主站代理副站支付、回调验签 |
| 接口 | 前台/后台/会员接口、Openapi 通用数据网关、Httpapi 授权接口、自动 API 文档 |
| 安全 | 上传黑名单、随机后台入口、字段过滤、表存在性判断、Token 鉴权、CORS 白名单 |
| 运维 | 文件缓存、模板缓存、安装锁、日志表、备份与灰度部署 |
┌──────────────────────────────────────────────────────────────┐
│ 客户端层 │
│ 桌面端 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/(文件缓存、模板编译) │
└──────────────────────────────────────────────────────────────┘
public/index.php;ROOTPATH、FCPATH、WRITEPATH、CONFIGPATH;cache/install.lock 不存在,自动进入 install.php 安装流程;duixin/Fcms/Init.php,初始化配置、数据库、缓存、会话、路由;s(应用)、c(控制器)、m(方法)定位到插件控制器;Service::M() / Service::L() 调模型与类库,返回 _json() 或渲染模板;| 决策 | 说明 | 收益 |
|---|---|---|
| 不使用 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 | 禁止 |
| 应用 key | 名称 | 核心职责 |
|---|---|---|
openapi |
Openapi 接口 | 通用表数据网关(list/detail/create/update/delete),表白名单 + 密钥 + 只读开关 |
httpapi |
API 接口 | 桌面端站点/数据库/附件接口,按 AppID 配置操作与表白名单 |
member |
会员 | 注册、登录、验证码、资料、头像、用户组、级别 |
weixin |
微信 | 公众号接入、扫码登录、消息处理 |
payjifen |
积分购买 | 套餐、下单、支付、回调加积分 |
proxypay |
代理支付 | 副站用主站二维码收款,主站回调副站 |
wxshare |
微信二维码共享 | 多站二维码共享展示 |
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',
];
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');
Config/Install.php;\Phpcmf\Service::M('table')->install_schema(),自动处理前缀、索引与注释;Config/Version.php 用于升级判断;duixin/App/Demo/;Config/App.php(名称、图标)、Config/Install.php(建表);Controllers/Home.php,提供 index、show、save、del;Config/Menu.php 注册后台菜单;| 路径 | 用途 |
|---|---|
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、没有打包、改完刷新即生效。
| 指令 | 作用 | 示例 |
|---|---|---|
{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}
template/pc/主题名/,切换主题只改配置,不动代码;template/mobole/(副站)或对应目录扩展;Views/ 或主题文件覆盖;header.html / footer.html,减少重复;dr_now_url(),不要硬编码路由;对信系统的「模型」不是 ORM 概念,而是可配置的内容结构,分为三类:
| 类型 | 说明 | 典型用途 |
|---|---|---|
| 内容模型(module) | 栏目 + 主表 + 附加表,支持列表/详情/搜索 | 新闻、产品、案例、房源 |
| 表单模型(form / mform) | 独立表单,可前台提交、后台审核 | 报名、留言、询价、投稿 |
| 会员模型(member) | 会员主表 + 附加字段 | 资料扩展、实名信息 |
框架内置字段控件位于 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 步进器 |
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' => '...',
];
因此同一份字段配置可以自动适配三种界面,不需要为每个端重复写表单。
在 config/myfield/ 下新增文件即可扩展字段行为,例如 test.php。配合 myfield_tablename_* 之类的约定函数,可以让字段落到自定义数据表。
开发步骤:
config/myfield/ 建 xxx.php;{dbprefix} 前缀;Config/Install.sql 或 Config/Install.php;COMMENT,否则桌面端接口文档里没有说明;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='商品表';
AI 生成内容模型时遵循固定套路:
Install.php;index / show / save / del)。因为字段类型、目录结构、注释格式都是稳定的,AI 才能在一次对话里产出可运行的一整套代码。
前台: index.php?s=应用&c=控制器&m=方法
后台: admin****.php?s=应用&c=控制器&m=方法
会员: index.php?s=member&app=应用&c=控制器&m=方法
应用目录名即 s 参数,全部小写。例如 duixin/App/Shop/ 对应 s=shop。
桌面端扫描 duixin/App/*/Controllers、Models、Config/Install*.sql,按位置自动分组:
| 控制器位置 | 分组 | 权限 |
|---|---|---|
Controllers/*.php |
前台 | 公开或 Token |
Controllers/Admin/*.php |
后台 | 需后台登录 |
Controllers/Member/*.php |
会员 | 需会员登录 |
Models/*.php 等 |
其他 | 模型方法 |
只扫描 public function;__construct、private、protected 不会出现在文档里。
| 动作 | 方法名(不区分大小写) |
|---|---|
| 新增 |
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 方法判定顺序:
POST;$_POST、$_REQUEST、IS_POST、dr_post → POST;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]);
}
}
/**
* 保存商品
* @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]);
}
$_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])。/**
* 商品详情
* @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 整段覆盖自动生成的示例。$this->_json($code, $msg, $data);
code:1 成功,0 失败;msg:提示文案;data:业务数据,列表放 data.list。面板从 _json() 第三个参数或 json_encode([...]) 的字面量推断响应字段。
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(表白名单)双重权限。
桌面端「项目设置 → API 接口文档」会:
看不到参数时按顺序排查:取参写法 → 是否在方法体内 → 方法名是否符合 GET/POST 预期 → 注释是否紧贴方法。
Aibuild 是整个系统的核心,负责把桌面端的 AI 请求安全、可计量地转发给大模型。
| 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,可单独覆盖默认值。
| 模式 | 判定 | 计费 |
|---|---|---|
| 平台额度 | 请求未带用户 Key,且服务端已配置 Key | 扣会员积分 |
| 自带 Key | 桌面端传入 api_key,且 allow_user_key 开启 |
不占平台额度 |
| 禁止自带 | 会员组无权限 | 回退平台额度或拒绝 |
keyperm 接口返回当前会员对各服务商的自带 Key 权限,桌面端据此决定是否展示输入框。
token,用 api_auth_uid + api_auth_code 换取 Token;md5(password + salt);aibuild_token;token,服务端校验状态、过期时间、最后使用 IP;m=chat,服务端以 SSE 逐段回传;tools / tool_choice / temperature / max_tokens;预扣 + 结算:
prompt_tokens / completion_tokens 结算;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 存放。
桌面端本地会话可上传到云端:
chats 拉列表(不含正文);chat_detail 拉单条(含消息与每轮用量);chat_save 保存或覆盖;chat_remove 删除。这样换设备、重装客户端都能恢复历史,同时云端记录也是计费凭证。
Libraries/Moderation.php 在请求前后做敏感内容检查,按配置决定:
DeepSeek 等厂商按前缀命中缓存,命中部分价格更低。因此系统约定:
cache_hit_tokens,可用于评估优化效果。这条约定同时影响成本与响应速度,改动提示词结构前务必确认。
| 方式 | 说明 |
|---|---|
| 账号密码 | 传统登录,支持错误次数限制 |
| 微信扫码 | PC 端扫码,公众号内静默授权 |
| 手机验证码 | 短信登录/注册 |
| 邮箱验证码 | 邮件登录/找回 |
| 第三方 OAuth | 可扩展 |
权限按「组 → 级别 → 应用/模块/栏目/表单」逐层判断,Member_auth 提供:
member_auth / app_auth / home_auth / module_auth / category_auth / mform_auth / form_auth
后台可配置每个组可访问的应用、模块、栏目与表单,未授权直接拦截。
payjifen;aibuild_log,可追溯到模型、Token、IP;流程:
要点:
public/api/pay/,不要改动。适用场景:副站没有独立支付资质,借用主站商户号收款。
副站下单 → 带授权密钥请求主站 → 主站生成微信二维码
→ 用户支付 → 微信回调主站 → 主站验签
→ 主站回调副站 → 副站加积分/开通服务
配置要点:
| 层面 | 措施 |
|---|---|
| 入口 | 后台入口文件名随机(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 提交到公开仓库;IS_DEV 与 IS_EDIT_TPL。| 项目 | 要求 |
|---|---|
| PHP | 8.1.0 及以上(安装程序会校验) |
| 数据库 | MySQL 5.7+ / 8.0,或 SQLite3 |
| Web 服务器 | Nginx / Apache / IIS |
| 扩展 | mysqli、pdo、curl、gd、mbstring、json、openssl、fileinfo |
| 目录 | 必须安装在域名根目录,路径不能含空格、[、]
|
| 磁盘 | 建议预留 2GB 以上(缓存、上传、日志) |
public/index.php 可通过域名访问(若面板要求,将运行目录指向 public/,或按主机商规则把 public/ 内容放到根目录)。cache/cache/data/cache/template/cache/file/cache/session/config/uploadfile//install.php。cache/install.lock,生成后台入口文件。public/install.php(或根目录下的 install.php)。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;
}
}
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule !.(js|ico|gif|jpe?g|bmp|png|css)$ /index.php [NC,L]
cache/ 有写入权限,清缓存不报错;m=index 返回正常;install.php 已删除;| 现象 | 原因 | 处理 |
|---|---|---|
| 「本程序必须在域名根目录中安装」 | 装在子目录 | 移到域名根目录,或按主机商规则调整 |
| 「目录不可写」 | 权限不足 | 给 cache/、config/、uploadfile/ 写权限 |
| 安装后 404 | 伪静态未配置 | 按 14.3 / 14.4 配置 |
| 后台入口打不开 | 文件名被改或删除 | 从备份恢复,或在 public/ 下查找 admin*.php
|
| 页面空白 | PHP 版本过低或扩展缺失 | 升级到 8.1+,安装缺失扩展 |
| 数据库连接失败 | 端口/账号错误 | 检查 config/database.php 与数据库白名单 |
token 换取访问 Token;AGENTS.md(已存在不覆盖)。新建/导入项目
↓
读取 AGENTS.md + PROJECT_MAP.md + API 文档
↓
对话描述需求
↓
AI 返回代码补丁(不直接写盘)
↓
编辑器待确认态:逐段接受 / 拒绝
↓
本地预览(宝塔 PHP + MySQL)
↓
部署(SFTP / 宝塔),默认排除 AGENTS.md 与缓存
↓
主站记录用量与积分
| 约定 | 说明 |
|---|---|
| 类加载 | 统一 Service::L('类名','应用名'),禁止命名空间静态引用 |
| 后台跳转 | 用后台入口常量拼接,禁止硬编码 index.php
|
| 表单提交 | 用 dr_now_url(),不要写死路由 |
| 保存逻辑 | 在 index() 内判断 POST,遵循框架惯例 |
| 数据库 | 按表结构过滤字段,唯一索引先查重,表缺失先判断 |
| 内核 | 不改 Fcms/、System/,通过继承与钩子扩展 |
| 敏感文件 | 不动 config/database.php、public/api/pay/、cache/
|
public function;input->get / $_GET,POST 用 $_POST / input->post;@param、@response;_json(code, msg, data) 返回;<?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);
template/pc/default/ 建目录与 .html;{template} 复用头尾;\Phpcmf\Service::V()->assign() 传入;cache/template/ 或后台清缓存。IS_DEV = 1,上线改回 0;IS_EDIT_TPL;cache/ 下的日志定位问题;这是本系统与传统 CMS 最大的差异:代码主要由 AI 生成,人类负责确认与部署。
| 文件 | 作用 | 维护方式 |
|---|---|---|
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
aipatch.ts 解析成补丁块;[静态系统提示词]
├─ 角色与规则
├─ 目录职责
├─ 代码规范
└─ 输出格式
[对话历史]
[最后一条用户消息]
├─ 用户需求
├─ 当前文件内容
└─ 相关文件清单
动态内容永远在最后,系统提示词永远不变,才能最大化前缀缓存命中率。
一次典型需求会产出:
| 层 | 位置 | 内容 |
|---|---|---|
| 配置缓存 | cache/data/ |
站点、应用、字段、权限 |
| 模板缓存 | cache/template/ |
编译后的模板 |
| 数据缓存 | cache/ |
栏目、会员组、联动菜单 |
| 会话 | cache/session/ |
登录态 |
| 上游缓存 | 模型厂商 | 前缀缓存,命中计费更低 |
aibuild_log、aibuild_chat 的 uid、inputtime 建索引。| 对象 | 频率 | 方式 |
|---|---|---|
| 数据库 | 每日 | 逻辑备份 + 异地存储 |
uploadfile/ |
每日增量 | 对象存储同步 |
config/ |
变更时 | 版本库 |
| 代码 | 每次发布 | Git 标签 |
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 |
feat/xxx、fix/xxx;feat(aibuild): 新增 xx 服务商支持
fix(member): 修复头像地址未归一化
docs(readme): 补充安装与伪静态说明
| 用途 | 地址 |
|---|---|
| 前台首页 | / |
| 前台接口 | /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 |
| 术语 | 含义 |
|---|---|
| 应用 / 插件 |
duixin/App/ 下的一个业务目录 |
| 模块 | 内容模型,含栏目、主表、附加表 |
| 字段 | 内容结构中的一列,对应一种表单控件 |
| 联动菜单 | 省市区等多级选择数据 |
| Token | 桌面端调用主站的访问凭证 |
| 预扣 | 请求开始前冻结的积分 |
| 结算 | 请求结束后按实际用量扣减 |
| 前缀缓存 | 模型厂商对相同前缀内容的缓存计费优化 |
| 补丁 | AI 生成、待人工确认的代码变更 |
对信 AI 建站 —— 让建站从「写代码」变成「确认结果」。
文档随版本迭代,若与代码不一致,以代码与AGENTS.md为准。