Files
iotlcm/docs/manual/mini-program/home.md
T
Dai0814 19455e1cbc docs: sync reviewed public manuals
Sync manuals, navigation and screenshots from open-source c8fa783 while preserving public README, LICENSE and history.
2026-10-26 16:10:40 +08:00

87 lines
4.8 KiB
Markdown

# 首页查卡
首页是当前版本的主要使用入口。查询不要求登录,支持手动输入、微信小程序扫码和图片识别三种录入方式。
## 登录入口
首页和登录页都保留“未登录也可查卡”入口。需要查看账号名下设备时,可使用密码或手机号短信验证码登录。同一凭据关联多个身份时,按提示选择本次要进入的身份。
## 手动查询
1. 在“卡片查询”输入框输入完整的 `ICCID`、`MSISDN`、`IMSI` 或 `IMEI`。
2. 点击“查询”,等待查询完成。
![点击查询并等待查询完成](/images/manual/mini-program/query-complete-v102.png)
3. 查询成功后,结果区域显示卡号、卡状态、已用流量和在线状态;卡号可以点击或长按复制。
4. 点击结果中的“查看详情”查看公开卡片详情;点击查询框下方的“卡片排查”会带入卡号查看状态摘要。公开查询未找到卡片时,页面也可能直接转入排查页继续核对。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 12px; align-items: start;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/query-actions-updated-v102.png" alt="查询结果中的详情和卡片排查入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">详情与卡片排查入口</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/public-card-details-updated-v102.png" alt="卡片详情页展示的公开字段" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">卡片详情</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/card-diagnosis-updated-v102.png" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">卡片排查</figcaption>
</figure>
</div>
输入内容请去除前后空格并核对末位字符。查询失败时先检查输入值,再重新提交。
## 扫码查询
1. 点击“扫码”。
![首页扫码入口](/images/manual/mini-program/scan-entry-highlight.png)
2. 将卡片条码或二维码放入扫描区域。
3. 扫描成功后,识别出的内容会自动填入输入框并立即发起查询。
光线不足、反光或距离不合适时可能扫描失败;此时请调整卡片位置,或改用手动输入。
## 拍照识别 ICCID
1. 点击“拍照”。
![首页拍照入口](/images/manual/mini-program/photo-entry-v102.png)
2. 从相机或相册选择一张卡片图片。
3. 确保图片中只有一张卡片,并且 ICCID 完整、清晰、无反光。
4. 识别成功后,系统会将 ICCID 填入输入框并继续查询。
常见提示及处理方式:
| 提示 | 处理方式 |
| --- | --- |
| 图片中存在多个可能的 ICCID | 重新拍摄单张卡片 |
| 未能识别清晰的 ICCID | 保持卡片平整、对焦清楚后重拍 |
| 图片识别超时或请求过于频繁 | 等待后重试,或使用扫码、手动输入 |
## 登录后的设备概览
登录后首页还会显示设备概览,最多预览三张卡,并优先展示即将到期的卡;有卡片数据时显示卡片总数。点击卡片查看详情,点击“管理”进入“全部设备”,可搜索 ICCID、MSISDN、IMSI 或 IMEI,按卡片状态筛选、刷新并加载更多。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start; width: 100%; max-width: 440px; margin: 24px auto;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/home-device-overview-v102.png" alt="登录后首页展示最多三张卡片的设备概览与管理入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">首页设备概览</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/all-devices-v102.png" alt="全部设备页面的卡片搜索、状态筛选和列表" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">全部设备</figcaption>
</figure>
</div>
设备数据按当前账号权限范围返回。未登录时不显示账号设备概览;列表为空时请确认账号已分配卡片或具备相应权限。
## 首页结果
首页公开查询显示“使用流量”(已用流量),不展示账号套餐的剩余流量。在线状态可能为在线、离线、未知或未查询到会话。结果区域的查询和排查说明均提示:内容仅供参考,以业务系统结果为准。
![首页公开查询结果中的卡号、使用流量和在线状态](/images/manual/mini-program/public-query-result-v102.png)