杂盒子 - 一站式知识管理平台

产品定位

杂盒子（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 重写。

安装流程

1

访问安装文件 install.php 进入安装向导

2

系统环境检测，确认 PHP 版本与扩展满足要求

3

配置数据库连接与站点基础信息

4

安装完成，生成 install.lock 锁文件并进入后台

部署方式

推荐宝塔面板部署，上传源码后设置 storage、upload 等目录写入权限，并配置 Nginx 伪静态规则将请求转发至入口文件。

后台访问

访问域名/admin/login 进入管理后台，默认管理员账号 admin，初始密码 admin123，首次登录后请立即修改。

核心配置

在后台可配置积分获取规则、功能模块开关与站点外观设置，灵活适配不同业务场景。