VIO v4 管理后台 - 用户指南

欢迎使用 VIO v4 管理后台。本指南涵盖租户管理、用户、代币、礼券等全部管理端功能。

---

目录

1. 登录
2. 忘记密码
3. 仪表盘
4. 用户
5. 代币
6. 代币持有者
7. 代币分析
8. 礼券
9. 活动
10. 空投
11. 交易
12. 结算
13. 子公司
14. 品牌
15. 角色
16. 员工
17. 门店管理
18. 通知
19. 新闻
20. PIN 访问
21. API 文档
22. 设置

---

1. 登录

租户管理员与子公司管理员使用的登录页。可使用已注册的邮箱或手机号，配合密码登录。

如何使用：

1. 在浏览器中打开带租户 slug 的管理后台地址
2. 在表单顶部用标签页选择 Email 或 Phone
3. 邮箱：输入管理员邮箱。手机：选择国家区号，再输入手机号（仅数字）
4. 输入密码
5. 可选：勾选 “Remember me” 保持登录；需要重置密码时点击 “Forgot password?”
6. 点击 “Sign In” 进入仪表盘

Email 标签页

Phone 标签页（先选国家/地区代码，再填手机号）

---

2. 忘记密码

忘记管理员密码时在此重置。流程同时支持邮箱与手机：先请求一次性验证码，再输入 6 位 OTP，最后设置新密码（至少 6 个字符）。

如何使用：

1. 在登录页点击 “Forgot password?”（或直接打开对应租户的忘记密码 URL）
2. 选择 Email 或 Phone，输入已注册的邮箱或手机号（手机需含区号）
3. 点击 “Send verification code”，在邮箱或短信中查收 6 位验证码
4. 在六个输入框中输入 OTP（可粘贴完整验证码）
5. 输入并确认新密码后提交，完成重置
6. 在成功页使用 “Back to Sign In”，再用新密码登录

请求验证码（选择 Email 或 Phone，填写标识后发送）

输入验证码（6 位 OTP；可粘贴或逐位输入）

设置新密码（长度以界面提示为准；确认须一致）

---

3. 仪表盘

首页总览：KPI 统计卡片、所选日期范围内的分析图表、近期代币活动、可选的小程序快捷入口，以及跳转到用户、代币、礼券与品牌等页面的快捷操作。

如何使用：

1. 使用右上角日期范围选择器切换统计区间；图表与数字会随区间刷新
2. 点击四张统计卡之一 — Total Users、Active Tokens、Vouchers、Transactions — 进入对应模块
3. 查看 User Growth 图（总用户 vs 新用户）与 Transaction Volume 柱状图（mint、transfer、burn）
4. 查看 Token Distribution 饼图与 Recent Activity 列表；可用 View all 打开完整交易页
5. 若租户配置了带管理端地址的小程序，可从 Mini Apps 网格进入
6. 使用 Quick Actions：Manage Users、Create Token、Create Voucher、Customize Brand 直达对应页面

---

4. 用户

管理租户会员账号：浏览、搜索、筛选、创建用户（Role 说明见下）、导出 CSV，以及行内操作。

如何使用：

1. 使用筛选栏右上角的搜索框 — 可匹配显示名、邮箱、手机号、钱包地址（与应用内提示范围一致：user、wallet、email 等）
2. 用 Role、Status 下拉缩小列表；用日期范围按账号创建时间筛选；点击 Clear 重置筛选
3. 在允许时点击右上 Create user（在导出旁）。填写邮箱或手机、密码、显示名。
4. Role（必填）：Member — 标准会员端用户；若租户使用分支机构可指定可选 sub-company。Sub-company admin — 管理一个分支；必须选择 sub-company（该角色必填）。Tenant admin — 可管理整个租户；仅租户级管理员在创建用户时可分配此角色（子公司管理员不能创建另一名租户管理员）。
5. 点击 Export User List 选择导出模式：User Summary (CSV) 或 Token Expiry Detail (CSV)（含代币与周期选项）— 再点 Export 下载
6. 每行最右侧 ⋮：View 打开详情（联系方式、钱包、余额、礼券），Edit 修改资料与角色，Deactivate / Activate 控制账号状态
7. 可选：若侧栏或书签暴露，可用 Subscribed users 或 Active members（/users/subscribed、/users/active-members）进入预筛选列表

用户列表

创建用户（弹窗 — 凭据、显示名、Role、可选子公司）

---

5. 代币

管理代币类型、供应量、公司余额、铸造与共享。可切换网格/列表视图、搜索代币、创建代币，并在每行 ⋮ 中使用 View details、Edit（已创建代币）、View analytics、View holders、Set as default、Burn tokens。

如何使用：

1. 在网格与列表布局间切换，用搜索框按名称或符号查找代币
2. 在允许时打开 Create token。除名称、符号、供应量、图片与法币汇率外，设置 Access：Private — 仅本组织；Public — 所有人（广可见）；Shared — 选择指定对等租户与/或子公司（选 Shared 后出现组织选择器）。然后部署。
3. 对你发行的代币，按界面流程使用 mint / 批量等工具向用户分配供应（含 CSV 或粘贴列表等可用方式）
4. 点击行上 ⋮ — View details 查看完整信息；对已创建代币可使用 Edit、View analytics、View holders
5. Set as Default（星标）将租户默认会员代币设为当前行；在另一代币成为默认前，当前默认行不可再次被选为默认
6. Burn tokens 打开弹窗：选择持有者、数量、可选备注并确认 — 或按权限使用其他行操作

代币列表

创建代币（弹窗 — 名称、符号、供应量、图片、法币汇率、Access）

---

6. 代币持有者

针对某一代币：页头显示名称/符号、Total holders 与 Total supply，以及 View analytics 按钮。表格列出每位持有者及其 Balance (sendable)（与账本总额）、Nearest expiry、% of supply、Last activity，以及 Lots 与 Adjust 操作。支持搜索、Export CSV、Back to Tokens。

如何使用：

1. 从 Tokens → ⋮ → View holders 进入，或直接访问 /tokens/{tokenId}/holders。用 Back to Tokens 返回列表
2. 阅读摘要：Total holders 与 Total supply；点击右上角 View analytics 打开该代币分析
3. 使用 Search holders… 筛选表格；数据多时用底部分页
4. 查看列：Holder（姓名与邮箱）、Balance (sendable)（可发送量与账本总额）、Nearest expiry（日期时间或 “No expiry”）、带进度条的 % of supply、Last activity
5. 每行：点击 Lots 打开批次明细（有效期等）；在角色允许时点击 Adjust 调整余额
6. 点击 Export CSV 下载持有者报表

持有者表

Lots（弹窗 — 每位持有者的批次分解、生效/过期标签、余额对账）

Adjust balance（弹窗 — Send 或 Recall、数量、原因）

---

7. 代币分析

单代币分析：Back to Tokens、date range（如 Last 30 days）、View holders、摘要卡片（Total supply、Total holders、区间内 Transactions 与 Volume）、Transaction volume 折线图、Transaction types 环形图、Top holders 与 Recent transactions（各含 View all）、以及 Company token lots（Non-expired / Expired 标签与批次表）。

如何使用：

1. 从 Tokens → ⋮ → View analytics 进入，或访问 /tokens/{tokenId}/analytics。用 Back to Tokens 返回列表
2. 设置 date range — 摘要与图表随区间刷新。点击 View holders 打开该代币持有者页
3. 阅读四张摘要：Total supply、Total holders、区间内 Transactions（笔数）、Volume（该区间总量）
4. 查看 Transaction volume（折线）与 Transaction types（环形：mint、transfer 等）。使用 Top holders 与 Recent transactions；有 View all 时可展开完整列表
5. 在 Company token lots 查看批次总数及 View expired transactions（如有）。切换 Non-expired lots 与 Expired lots；表格含 lot ID、数量、剩余、创建时间、到期与状态
6. 阅读标签下方说明：non-expired 仍包含未到过期时间但已耗尽的批次

---

8. 礼券

礼券全生命周期：顶层四个区域（目录、核销、分析、品牌标签）、状态筛选、网格/列表、搜索、对自有礼券的批量操作、页眉 Redeem by Code、Analytics 图表，以及多步创建/编辑向导。

英文界面在页面顶部有四个 主标签：

• Vouchers — 租户目录。分为 My Vouchers（你创建的礼券）与 Voucher Network（见下）。其下 Online、Offline、Expired 按上架/下架与是否已过结束日筛选。可按分类、品牌标签、访问类型（public / private / shared）筛选，按礼券名搜索，切换 grid / list。在 list 视图中选中多行可出现批量条 Activate / Deactivate（视角色权限）。
• Claims & Redemptions — 领取与核销相关列表（界面提供处可搜索与导出）。
• Analytics — 礼券表现摘要与图表。
• Brand Tag — 管理 My Brand Tag（从平台加入、用于礼券的品牌）与 Platform Brand Tag（浏览平台池并加入你的选择）。

在主要礼券流程页右上角，Redeem by Code 以弹窗打开店员按码核销 — 不在 礼券行 ⋮ 菜单内。在角色允许时 Create Voucher 打开创建向导。

Voucher Network（在 Vouchers 标签下 My Vouchers 下方）

Voucher Network 不是独立路由 — 它是同一目录标签上 My Vouchers 下方的第二块区域。英文界面下 Voucher Network 标题下的说明与产品文案一致：“Public and shared vouchers from partners.” 该池展示来自其他租户或平台目录的礼券，供会员在配置允许时发现与领取。你不能在这里创建这些礼券，主要查看。网络礼券行 ⋮ 仅 View Details — 无 Edit Voucher、Duplicate、Set Offline / Set Online（这些仅适用于 My Vouchers）。

如何使用：

1. 用顶部四个 主标签 在目录（Vouchers）、Claims & Redemptions、Analytics、Brand Tag（最后一项含 My Brand Tag / Platform Brand Tag）间切换。
2. 在 Vouchers 中在 My Vouchers 与 Voucher Network 间工作，再用 Online / Offline / Expired 及分类、品牌、访问类型、搜索筛选；切换网格/列表，在列表多选且角色允许时使用批量上架/下架。
3. 在允许时点击 Create Voucher 打开向导 — 名称、类型、数值、日期、可见性、门店、核销方式、图片、条款、共享选项 — 保存或发布。
4. 行 ⋮： 对 My Vouchers，菜单为 View Details、Edit Voucher、Duplicate，然后是当前在线时的 Set Offline 或离线时的 Set Online — 标签与英文 UI 一致。Voucher Network 行 ⋮ 仅 View Details。码核销使用页眉 Redeem by Code，不要期待在 ⋮ 里。
5. Claims & Redemptions 查看领取与使用表；Analytics 看仪表盘；Brand Tag 维护创建礼券可用的品牌。

消费类型：供应商码池（QR Code 与 Coupon Code）

当 消费类型 为 QR Code 或 Coupon Code 时，礼券通过上传 CSV 维护一批由供应商提供的码，而不是全员共用一张静态二维码图。系统每条码存一条记录，每次核销从池中分配唯一一条码给该会员（会员端表现为点击 Get Code 等操作后展示供应商码）。

上传券码（创建向导）

• 出现 Upload Voucher 区域：拖拽 或点击 Upload CSV；支持 CSV / TXT，单文件最大 5 MB（见界面提示）。
• Download Template — 下载示例：每行一个码，可无表头（若首行为 code / codes / voucher / id 会被当作表头跳过）。
• 选中文件后显示文件名、大小，可用 X 移除。
• 礼券数量（Voucher quantity） 会根据文件内去重后的有效行数自动填充。
• 保存新建礼券后，码会导入码池。若使用固定上限，请与 CSV 行数对齐。

编辑礼券

• QR Code / Coupon Code 同样提供 Upload Voucher；新文件会追加入库（重复码跳过）。
• 界面展示码池 总数 / 可用 / 已分配。若 领取上限 大于已上传的总码数，保存会被 API 拒绝 — 请补充 CSV 或降低上限。
• **兼容说明：**历史 QR Code 数据可能仍仅有单张图片路径；新流程在管理端以 CSV 为准。

VIO Code、URL、Manual、直充 等类型不依赖该 CSV 码池。

截图（主标签 — 英文界面）

Vouchers — 目录标签（上方 My Vouchers，向下滚动可见 Voucher Network；Online / Offline / Expired 与筛选作用于目录列表）

Claims & Redemptions

Analytics

Brand Tag（子标签 My Brand Tag / Platform Brand Tag 在此屏）

创建礼券（向导 — 详情、类型、数值、日期、可见性、门店、核销、条款）

---

9. 活动

单一 Campaigns 屏上的活动构建器：活动列表或网格、筛选（状态、代币、公开/私有）、搜索、Create Campaign、单行操作。创建/编辑使用弹窗：排期、关联代币、横幅图，以及两个开关：Active 与 Public Marketing Page (accessible without login)（创建时英文完整文案；编辑时同款设置用较短标签 Public Marketing Page）。

状态徽章 vs Active 开关： Active 复选框控制活动是否整体启用。卡片/行上彩色 status 药丸（Active、Scheduled、Ended、Inactive）为计算得出：若 Active 关闭 → Inactive；若开启 → 开始前为 Scheduled，结束后为 Ended，否则 Active。因此表单里的 “Active” 与仅靠日期显示的 “Active” 状态芯片不一定是同一含义。

公开营销页： 开启 Public Marketing Page (accessible without login) 时，该活动在会员端的营销 URL 可不登录访问（参见弹窗中 Campaign QR Code 说明）。关闭时视为不通过该公开页分享。

活动上的礼券： 当前 UI 无独立顶层 Campaign Vouchers 标签 — 通过列表视图的 Manage 或网格 ⋮ 的 Manage Vouchers 按活动挂载/编辑礼券。会打开大弹窗，标题 Vouchers in "…"，步骤 1 Manage Vouchers（数量、代币价格/类型、增删）与 2 Confirmation 后保存。

二维码与链接： 行/卡上 QR 图标与 ⋮ 中 View QR Code 打开 Campaign QR Code 弹窗（下载 PNG、Marketing URL、复制、新标签打开）。⋮ 还提供 Copy Marketing URL、Open Marketing Page、Edit Campaign、允许时的 Delete。

如何使用：

1. 浏览 Campaigns 列表或网格；按 status（与计算药丸一致：Active / Scheduled / Ended / Inactive）、token、公开/私有筛选；按名称搜索；如有则切换网格/列表。
2. Create Campaign（允许时）：名称、描述、Token for Redemption、横幅图（限额见应用内）、开始/结束 date and time。启用 Active 以使活动在日期约束下可运行。需要可分享的免登录会员链接时启用 Public Marketing Page (accessible without login)。保存。
3. 从 ⋮ Edit Campaign 修改同字段。用 Manage / Manage Vouchers 增删礼券并设置数量与代币定价；UI 要求在第二步确认时完成确认。
4. 用 QR 图标或 View QR Code 打开 Campaign QR Code；按需从 ⋮ 使用 Copy Marketing URL 或 Open Marketing Page。
5. 允许时 ⋮ 出现 Delete；会移除活动及其礼券关联（确认界面警告）。

截图

Campaigns（列表/网格 — 实际数据因租户而异）

Create Campaign（弹窗 — 代币、排期、Active、Public Marketing Page (accessible without login)）

Campaign QR Code（弹窗 — QR、Download QR Code、Marketing URL、How to use）

Manage Vouchers（弹窗 — 标题 Vouchers in "…"，步骤 Manage Vouchers → Confirmation）

---

10. 空投

列出历史与进行中的空投（代币或礼券派发）。可按类型/状态搜索筛选、打开详情、删除草稿，并从大型向导弹窗创建新批次 — 无单独 /airdrop/create；创建自此页进入。

如何使用：

1. 用搜索与筛选浏览表格（如空投类型、状态：draft、sending、sent、failed）
2. 允许时点击 Create Airdrop Activity 打开向导 — 选择代币或礼券模式、接收人（CSV 上传与/或选人）、金额与文案
3. 确认摘要并排入发送；允许时草稿可从 ⋮ 删除
4. 点击行或 View 打开详情弹窗查看进度、接收人拆分与失败信息
5. 对符合条件行使用 Delete 或其他 ⋮ 操作清理失败或草稿活动

空投列表

创建空投（向导 — 代币或礼券、接收人、金额）

---

11. 交易

租户级代币交易台账：全文搜索、代币/类型/状态筛选、日期范围、CSV 导出，以及内容丰富的 Message 列（可含备注、错误、引用标签、代币 lot 变动与 Expiry 提示）。

Message 列（英文界面标签：Message） — 从上到下可显示：可选 memo；failed 时红色 error；可选 reference chip（关联对象类型）；API 返回 relatedLots 时的 Lots 块（见下）。无内容时单元格为 -。

Lots — 代币余额按 lots（批次）跟踪。在 Message 内，mint、transfer、reward 等类型可出现 lot 行（UI 仅对这些流完整渲染借记/贷记）。你可能看到：

• Debited — 发送方 lot 扣减（代币单位）。若 API 嵌入完整 lot 数据，其下会有紧凑 Expiry；否则可能仅短 lot id chip。
• Credited 或 Lots — 新开或接收方 lot 及金额。
• Split across N lots · total — 单笔交易触碰多个 lot 时的汇总行与 total；各 lot 下列出并左侧缩进以示拆分。

点击 lot chip（包裹图标与 lot id 尾段）打开浮层：Lot ID（可复制）、remaining / original 余额、状态（Active、Expired 或 Depleted）、与行内提示一致的到期日。

Expiry — 每行 lot 下小字 Expiry（英文 UI）后跟日历日期（yyyy-MM-dd）或 No expiry。lot 已过期（状态或日期）时日期可显示为红色。这是 lot 自身到期，不是交易时间戳（账变时间看 Date 列）。

Message 列（截图） — 表格横向滚动使 Message 可见；自动截图最多 10 行数据以保持图片紧凑（见 capture-transactions-message.js）。你租户上可能显示备注、-、lot 行或礼券文案。

如何使用：

1. 用搜索匹配用户、哈希或表格暴露的其他字段
2. 按代币、交易类型（mint、transfer、burn、reward、redeem、expire）、状态缩小范围；用日期选择器设区间
3. 使用 Export 或 Download 将当前结果导出 CSV（导出可在可用处附加紧凑 debited/credited lot id 与 exp: 到期片段）
4. 阅读 Message 中的备注、失败、引用与 Lots / Expiry；点击 lot chip 查看详情并复制 id
5. 其他页面深链可能带 tokenId、type 或 status — 筛选从 URL 初始化

---

12. 结算

财务结算与跨租户礼券计费：顶部摘要卡，其后四个 主标签（英文 UI）— Platform Fees、Receivable Details、Payable Details、Invoices — 摘要数据上可选日期范围筛选。

如何使用：

1. 选择日期范围（如有）以刷新结算摘要、费用与跨租户礼券明细
2. 在 Platform Fees 查看平台费、维护费与按需计费
3. 打开 Receivable Details 或 Payable Details 查看你方用户在其他租户消费礼券（或反向）的金额
4. 切换到 Invoices 列账单并按方案下载 PDF 或查看条目
5. 使用各分区顶部币种标签与合计与财务记录对账

截图（主标签 — 英文 UI）

Platform Fees — 维护费、按代币计费、核销/消费费等（取决于计费模型）。

费率类型

平台支持以下可变服务费费率类型：

费率类型	标签显示	计算方式
Per Unit	$X.XX /token 或 /redemption	每笔固定金额
Percentage	X%（发行价值） 或 X%（结算价）	交易结算金额的百分比
Token Value Percentage	X%（代币价值）	代币价格 × 代币法币汇率的百分比，若代币锚定法币与计费币种不一致则自动换算；无代币价格时退回最低收费

Receivable Details — 其他租户用户使用你方礼券时的应收金额（有行时可导出 CSV）。

Payable Details — 你方用户使用其他租户礼券时的应付金额。

Invoices — 已开具发票（可下载 PDF 时可用）。

---

13. 子公司

分支机构层级：在树形与网格视图间切换，创建子公司、上传 logo、校验 slug、可选开通子管理员账号，并按分支管理用户。

如何使用：

1. 切换 Tree / Grid 浏览组织图或卡片布局
2. 点击 Add 或 Create sub-company 打开表单 — 名称、slug、联系人、地址、logo、可选专属管理员凭据
3. 在行 ⋮ 中查看、编辑、启用/停用、删除，或打开该分支的会员列表弹窗
4. 在父级下创建时，保存前在界面确认父子关系
5. 复制或记录各子公司 slug — 其会出现在该分支会员端与管理后台 URL 中

Sub-companies（树或网格）

Create sub-company（表单 — 名称、slug、联系人、logo、可选分支管理员）

---

14. 品牌

上传标准与浅色主题 logo，调整 primary/secondary/accent/background/text 色，选择字体族，编辑租户显示名并保存 — 当前会话可立即看到主题刷新。

如何使用：

1. 进入页面预览当前颜色与 logo
2. 用选择器上传新 logo（含深色背景用的浅色变体）
3. 按品牌规范调整十六进制颜色与字体
4. 若法定/营销名称变更，更新租户 Name 字段
5. 点击 Save 等待确认；门户主题可能立即应用新色

---

15. 角色

自定义员工角色：搜索筛选目录，从模块化权限网格创建或编辑权限集，将用户指派到角色，并停用不再需要的角色。

如何使用：

1. 按角色名搜索并按启用/停用筛选；分页浏览
2. 点击 Create role 命名角色并勾选细粒度权限（资源与操作）
3. 使用 ⋮ → View 查看、Edit 改权限、Manage users 挂载员工，或允许时 Delete
4. 通过打开现有角色的 Edit 并只改差异来复用模板
5. 保存后若员工菜单未立即更新，可请其重新登录

Roles list

Create role（弹窗 — 角色名与权限网格）

---

16. 员工

租户管理用户：可搜索表格、角色筛选、每页条数、CSV 导出，以及用于新增、编辑、移除员工并分配自定义角色的弹窗。

如何使用：

1. 按姓名或邮箱搜索；按分配角色筛选；大团队可调每页行数
2. 点击 Add staff（或等价入口）邀请人员 — 填写身份信息并挂载一个或多个自定义角色
3. 用行操作编辑员工角色或按策略停用/删除
4. 需要离线名册审计时导出列表
5. 若组织要求，在门户外汇总密码重置或 MFA

Staff list

Add staff（弹窗 — 身份与自定义角色）

---

17. 门店管理

与侧栏 Store Management（/stores）一致。门店登记：仪表盘统计、搜索、状态筛选、分页、CSV 导出，以及创建/编辑每家门店的弹窗。

如何使用：

1. 查看摘要块中的总数、活跃/非活跃与注册数
2. 按状态搜索筛选；长列表分页浏览
3. 创建或编辑门店以在表单中填写名称、地址、地理/图钉、营业时间等元数据
4. 在门店行点击 QR 图标（提示 View URL & QR Code）打开 Store URL & QR Code — 复制注册 URL、新标签打开，或打印二维码用于店内物料
5. 导出目录给运营，或关停已关闭门店

Store list

Create New Store（向导弹窗 — 详情、地图、确认）

Store URL & QR Code（对话框 — 注册 URL、QR、复制）

---

18. 通知

与侧栏 Notifications 一致。向会员端用户发送推送通知、查看订阅统计并广播消息。

如何使用：

1. 查看推送通知订阅统计
2. 查看订阅用户数与订阅率
3. 撰写广播通知的标题与正文
4. 选择通知分类（News 或 Promotions）
5. 可选填写点击通知后打开的链接 URL
6. 向所有订阅用户发送广播

Push Notifications（订阅统计、广播表单 — 标题、富文本、分类、可选链接 — 及发送结果）

---

19. 新闻

为会员创建与管理新闻文章、公告与更新。支持富媒体、分类、标签、草稿/发布工作流、定时发布、列表筛选以及在会员端 置顶。

如何使用：

1. 在表格中查看全部文章：标题、分类、关联活动（如有）、状态、发布日、点赞与操作
2. Search： 用搜索框匹配列表关键词；停止输入后不久刷新并回到第 1 页
3. Filters： 用 Status（All Status、Draft、Published、Unpublished）与/或 Category（All Categories、Announcement、Event、Promotion、Update、Other）筛选；每次变更重载并回到第 1 页。有筛选时点击 Clear 重置两个下拉与第 1 页
4. Pin： 在 Actions 列用图钉图标 — 提示 Pin 或 Unpin — 置顶或取消（置顶行标题旁显示小图钉）。需要 news → edit 权限
5. 新建文章：标题、摘要、富文本正文、图片、视频、分类与标签
6. 存草稿或立即发布；设置发布日/时间与可选到期日/时间以定时与自动隐藏
7. 在操作列中按权限发布、取消发布、编辑、预览或删除

News list

Create News（弹窗 — 内容、媒体、排期）

---

20. PIN 访问

管理核销 PIN 码（前缀、权限如礼券核销或代币领取、状态）。筛选、分页、创建、编辑、删除，并在允许时显示掩码 PIN（眼睛图标）。

如何使用：

1. 查看页顶租户 PIN 前缀（若 API 返回）以便员工了解码格式
2. 按状态与权限类型筛选表格；用分页切换页
3. 点击 Create（或 Add PIN）打开弹窗 — 按表单设置标签、权限范围、使用限额与有效期
4. 用行操作编辑、删除或在审计时切换 PIN 明文显示（眼睛图标）
5. 及时停用或移除已泄露 PIN；新活动应使用新生成的码

PIN list

Create PIN（弹窗 — 标签、权限、限额）

---

21. API 文档

与侧栏 API Docs（/api-docs）一致。门户内 External API（/external/v1）参考：顶部 Base URL 横幅，其次 第二列标签（页内侧栏）按区域切换 — Authentication、Vouchers、Users、Campaigns、Tokens、Analytics。各分区含说明（如有）、端点卡片、参数、示例 JSON 与示例 curl。API 密钥在 Settings → API keys 创建，不在此页。

如何使用：

1. 需要从蓝色横幅复制确切 external 前缀时使用 Base URL
2. 点击 页内左侧列（主应用侧栏下方）的标签打开该资源文档 — 顺序：Authentication → Vouchers → Users → Campaigns → Tokens → Analytics
3. 在 Authentication 下阅读如何发送 X-API-Key、限流与响应包结构
4. 在其他标签展开或滚动端点卡片 — 查看路径、查询/正文字段与示例响应
5. 在代码块上使用 Copy 粘贴到终端或 Postman
6. 需要创建或轮转密钥时在大屏左下使用 Go to Settings 进入 API key 管理

Authentication

Vouchers

Users

Campaigns

Tokens

Analytics

---

22. 设置

只读租户资料、功能开关与你登录可见的计费摘要；以及自助 API 密钥管理（创建、权限范围、一次性复制、撤销）、界面语言、可选数据导出。数据导出可能显示 “coming soon”。

如何使用：

1. 查看 Account 信息（你的资料）与 Tenant 信息（名称、slug、状态、联系人）
2. 浏览 Feature flags — 开关多为说明性质；实际启停由平台运营控制
3. 阅读 Billing：维护费、生效计费模型与合同展示费率（per unit、percentage 或 token value percentage）。Token value percentage 类型的费用会自动按代币锚定法币与计费币种之间的汇率换算
4. 在 Language（地球图标）下选择 English、繁體中文 或 简体中文 — 管理后台界面立即切换；当前语言显示勾选。选择保存在本浏览器（i18n）
5. 在 API keys 下点击 Create key，输入标签，选择 scopes（vouchers、users、campaigns、tokens、analytics），一次性复制密钥，轮转时 revoke 旧密钥
6. 可选：在 Danger zone 使用 Export（若租户暴露数据导出）— 应用可能显示进度或 “coming soon”

Settings

Create API key（弹窗 — 标签、scopes、一次性密钥复制）

---

需要帮助？

若你在使用管理功能时遇到问题或有疑问，请联系系统管理员或超级管理员。

---

本指南于 2026-04-13 由脚本自动生成。