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

产品定位

杂盒子（v2.5.8）是由呆尬猴网络科技工作室开发的一站式知识管理平台，定位为「工具归集、文档沉淀、以文生答」。

核心功能模块

7 项

工具集合

便民查询、换算计算、过程计算、电气计算、生活查询、趣味测试等共 7 大类近 100 个小工具，含 NIST ITS-90 标准精度计算。

文档管理

支持 PDF、DOCX、XLSX、PPT、TXT 上传与预览，提供付费下载、三级分类与全文检索能力，沉淀团队知识资产。

社区问答

悬赏提问、最佳答案采纳、付费查看、评分机制与匿名功能，构建高质量付费问答社区。

积分系统

签到、登录、上传、被采纳等多维获取规则，配合 7 级用户等级体系，激励用户持续参与贡献。

用户中心

头像 SVG 生成、智能昵称分配、关注粉丝、消息通知与浏览历史，打造完整个人空间。

后台管理

仪表盘、用户/文档/问答管理、积分配置、功能开关、外观设置与操作日志，一站式运营管控。

插件系统

可扩展架构，支持排行榜、AI 问答等模块接入，便于按需扩展业务能力，打造开放生态。

前端实现

技术栈

原生 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，首次登录后请立即修改。

核心配置

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