杂盒子
一站式知识管理平台 · 工具归集 · 文档沉淀 · 以文生答
产品定位
杂盒子（v2.5.8）是由呆尬猴网络科技工作室开发的一站式知识管理平台，定位为「工具归集、文档沉淀、以文生答」。
前端实现
技术栈
原生 HTML5 + CSS3 + JavaScript，Tailwind CSS（CDN），FontAwesome 6.4.0，Chart.js 图表库。
架构特点
模板化与组件化结合，templates 目录按模块组织，components 目录抽离通用组件，响应式三档断点（手机≤640px 单列、平板 641-1024px 双列、桌面≥1025px 三列），支持暗黑模式。
设计规范
主色 #165DFF，辅助色 #36CFC9，圆角 12px，扁平化视觉风格，统一间距与字号体系。
后端架构
技术栈
PHP 8.0+（兼容 7.4+），MySQL 5.7+ 或 MariaDB 10.3+，Nginx / Apache 服务器。
架构特点
分层清晰的 MVC 模式，入口文件 index.php 负责路由分发；核心类库含 Database（PDO 单例+预处理）、Auth（bcrypt+Token+锁定机制）、Points（事务+行锁）、Upload（白名单+MIME 双重检测）、Middleware（auth/admin/csrf/rateLimit）；RESTful 规范，统一 JSON 响应，Bearer Token 认证。
安全特性
密码 bcrypt 加密，API Token 7 天有效期；登录失败 5 次锁定 15 分钟，session_regenerate_id 防会话固定；PDO 预处理防 SQL 注入，htmlspecialchars 防 XSS，CSRF Token 验证；文件上传扩展名白名单 + MIME 双重检测；敏感目录保护，install.lock 防重复安装。
完整技术栈清单
| 分类 | 技术选型 |
|---|---|
| 前端 | HTML5、CSS3、原生 JavaScript、Tailwind CSS（CDN）、FontAwesome 6.4.0、Chart.js |
| 后端 | PHP 8.0+（兼容 7.4+）、MVC 分层架构、PDO 数据库抽象层、Composer 依赖管理 |
| 数据库 | MySQL 5.7+ 或 MariaDB 10.3+，utf8mb4 字符集 |
| 服务器 | Nginx / Apache，支持 URL 重写，宝塔面板部署 |
| 安全 | bcrypt 密码加密、Bearer Token 认证、CSRF 防护、XSS 防护、PDO 预处理、文件上传白名单 |
| 扩展 | 插件系统、中间件机制、RESTful API、JSON 统一响应 |
系统使用文档
环境要求
PHP 7.4+，需启用 pdo_mysql、mbstring、json、fileinfo、gd、openssl 扩展；MySQL 5.7+；Nginx 或 Apache 需支持 URL 重写。
安装流程
访问安装文件 install.php 进入安装向导
系统环境检测，确认 PHP 版本与扩展满足要求
配置数据库连接与站点基础信息
安装完成，生成 install.lock 锁文件并进入后台
部署方式
推荐宝塔面板部署，上传源码后设置 storage、upload 等目录写入权限，并配置 Nginx 伪静态规则将请求转发至入口文件。
后台访问
访问 域名/admin/login 进入管理后台，默认管理员账号 admin，初始密码 admin123，首次登录后请立即修改。
核心配置
在后台可配置积分获取规则、功能模块开关与站点外观设置，灵活适配不同业务场景。