项目目录

以下为 Web 端和后台开发最常接触的目录；SDK 目录不在本页列出。

99kf-master/
├── app/
│   ├── visitor/          # 访客 Web 页面与 /visitor/* 接口
│   ├── agent/            # 客服工作台与 /agent/* 接口
│   ├── admin/            # 平台管理端
│   ├── controller/       # 安装、在线回调等全局控制器
│   ├── middleware/       # 访客、客服、后台访问控制与 CORS
│   ├── service/          # 消息、推送、Token、会话等可复用业务服务
│   ├── database/         # 数据库类型与方言适配
│   └── util/             # 上传、语言、URL 等工具类
├── config/               # Webman、路由、进程、Session、ORM 配置
├── process/
│   ├── Socket.php        # WebSocket 服务进程
│   ├── Task.php          # 定时任务进程
│   └── Monitor.php       # 文件和内存监控
├── public/
│   └── static/js/        # visitor.js、agent.js、socket.js 等浏览器脚本
├── support/              # Request / Response 及应用引导
├── runtime/              # 日志、缓存、Session、临时运行数据
├── 99kf-install.sql      # MySQL 安装结构
├── 99kf-install.pgsql.sql# PostgreSQL 安装结构
├── start.php             # Webman 启动入口
└── composer.json         # PHP 依赖与运行要求

常用修改入口

需求	优先查看
新增访客页面能力	app/visitor/controller/、public/static/js/visitor.js
新增客服工作台能力	app/agent/controller/、public/static/js/agent.js
消息落库或自动回复	app/service/、两端 MessageController
实时事件	app/service/Push.php、process/Socket.php、public/static/js/socket.js
鉴权与跨域	app/middleware/VisitorAccessControl.php、AgentAccessControl.php
表结构调整	两份 99kf-install*.sql 与 app/database/

改表时必须同时维护 MySQL 和 PostgreSQL 安装脚本；方言差异应放入数据库适配层，不要散落在 Controller 中。