# 🪙 TokenHub 购买与使用说明

## 一、注册

1. 打开 **https://token.zosoft.cn**
2. 点击「注册」，输入用户名、密码、手机号
3. 注册成功 → 自动获得：
   - **1,000 D-Token**（新用户赠送）
   - **One API 密钥**（自动生成，用于调用 DeepSeek）

## 二、购买 D-Token

1. 登录后在仪表盘点击「买入」
2. 输入数量、单价（当前市场挂单自动匹配）
3. 成交后余额即时到账

> 也可以在「挂单」页面看到当前所有买/卖订单，选择价格合适的直接成交

## 三、获取 API 密钥

1. 登录后在**仪表盘**页面
2. 找到「API 密钥」区域
3. 密钥会自动显示，点击「复制」按钮使用

## 四、配置调用

拿到密钥后，在任意支持 OpenAI 兼容接口的客户端中配置：

```
接口地址：https://api.zosoft.cn/v1
API Key： 你复制到的密钥
模型名：   deepseek-v4-flash（或其他支持的模型）
```

**示例（Python）：**

```python
from openai import OpenAI

client = OpenAI(
    api_key="你的密钥",
    base_url="https://api.zosoft.cn/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
```

## 五、扣费机制

- 每5分钟同步一次 One API 用量
- 根据实际消耗的 token 数量从 D-Token 余额扣除
- 可以在仪表盘「消费记录」查看明细
- 余额不足时 API 调用会失败（需要补充 D-Token）

## 六、计费配置（管理员）

在管理后台 → 系统设置可调整：

| 配置项 | 含义 | 默认值 |
|--------|------|--------|
| `commission_rate` | 交易佣金比例 | 0.02（2%） |
| `register_bonus_dtoken` | 注册赠送 D-Token | 1000 |
| `dtoken_per_usd` | 1美元兑换 D-Token 数量 | 100 |
| `oneapi_base_url` | One API 地址 | api.zosoft.cn |