96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# zhiqiu-tools · 之秋工具箱
|
||
|
||
> 人格系统相关的小工具和小项目合集。
|
||
|
||
## AI 接单系统
|
||
|
||
智能技术开发接单管理工具，支持 AI 辅助需求录入、订单编号追踪、双向沟通同步。
|
||
|
||
**在线试用：** [guanghuice.com/orders/submit](https://guanghuice.com/orders/submit)
|
||
|
||
### 功能
|
||
|
||
| 功能 | 说明 |
|
||
|------|------|
|
||
| 🤖 **AI 辅助录入** | 提交需求时 AI 自动分析并结构化，推荐分类和预估工时 |
|
||
| 🛡️ **垃圾过滤** | 蜜罐检测 + IP 频率限制 + 内容模式识别，自动标记可疑订单 |
|
||
| 📋 **编号系统** | `ZT-YYYYMMDD-NNN` 格式，子任务分层 `-XX`，精准追踪 |
|
||
| 🔧 **管理面板** | 订单列表、状态流转、子任务拆分、可疑审核、客户沟通 |
|
||
| 🔍 **客户追踪** | 根据订单号查询进度、查看沟通记录、留言 |
|
||
| 💬 **双向同步** | 客户和开发者通过评论双向沟通，时间线记录所有操作 |
|
||
| 🐳 **Docker 支持** | 一键部署，环境变量配置 |
|
||
|
||
### 快速部署
|
||
|
||
#### 方式一：Docker（推荐）
|
||
|
||
```bash
|
||
# 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
|
||
```
|
||
|
||
#### 方式二：直接运行
|
||
|
||
```bash
|
||
# 需要 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
|