# 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