zhizhi/modules/orders/README.md

zhiqiu-tools · 之秋工具箱

人格系统相关的小工具和小项目合集。

AI 接单系统

智能技术开发接单管理工具，支持 AI 辅助需求录入、订单编号追踪、双向沟通同步。

在线试用： guanghuice.com/orders/submit

功能

功能	说明
🤖 AI 辅助录入	提交需求时 AI 自动分析并结构化，推荐分类和预估工时
🛡️ 垃圾过滤	蜜罐检测 + IP 频率限制 + 内容模式识别，自动标记可疑订单
📋 编号系统	ZT-YYYYMMDD-NNN 格式，子任务分层 -XX，精准追踪
🔧 管理面板	订单列表、状态流转、子任务拆分、可疑审核、客户沟通
🔍 客户追踪	根据订单号查询进度、查看沟通记录、留言
💬 双向同步	客户和开发者通过评论双向沟通，时间线记录所有操作
🐳 Docker 支持	一键部署，环境变量配置

快速部署

方式一：Docker（推荐）

# 1. 克隆
git clone https://gitea.com/zhizhideqiuqiu/zhiqiu-tools.git
cd zhiqiu-tools

# 2. 配置环境变量
export DEEPSEEK_API_KEY=sk-your-key-here
export ZQ_SITE_NAME="我的接单系统"

# 3. 启动
docker compose up -d

# 4. 访问 http://localhost:3920

方式二：直接运行

# 需要 Node.js 18+
git clone https://gitea.com/zhizhideqiuqiu/zhiqiu-tools.git
cd zhiqiu-tools

# 配置 API Key（AI 功能需要）
export DEEPSEEK_API_KEY=sk-your-key-here

# 启动
node server.js

环境变量

变量	默认值	说明
DEEPSEEK_API_KEY	-	DeepSeek API Key（AI 功能必需）
ZQ_PORT	3920	服务端口
ZQ_SITE_NAME	之秋 · 技术开发接单	站点名称
ZQ_ADMIN_TOKEN	``	管理面板简单鉴权（可选）
ZQ_RATE_LIMIT	3	每 IP 每小时最多提交次数

垃圾过滤机制

系统使用三重防护对抗垃圾提交：

1. 蜜罐检测 — 表单中隐藏字段，正常用户不可见，机器人会自动填写
2. 频率限制 — 同一 IP 每小时最多提交 3 次
3. 内容分析 — 检测无意义字符、重复内容等异常模式

被标记的订单会在管理面板显示 ⚠️ 标识，管理员可以审核后解除标记或删除。

访问路径

页面	路径	说明
📝 客户提交	/submit	公开，任何人可提交需求
🔧 管理面板	/admin	管理员管理订单
🔍 订单追踪	/track	客户凭编号查询进度
💊 健康检查	/api/health	服务状态

技术栈

• 后端：Node.js（原生 http，无框架依赖）
• 前端：原生 HTML/CSS/JS
• 存储：JSON 文件（无需数据库，开箱即用）
• AI：DeepSeek API
• 部署：Docker / 直接运行

许可证

MIT