1后台是干什么的
先分清两件事，很多人会懵：
| 客户端（EXE，装在使用者电脑） | 管理后台（服务端，装在你的服务器） |
|---|
| 存什么 | 全部业务数据：案件、回款、跟进、费用、附件 | 只存账号 / 机构 / 授权 / 调用统计 |
| 管什么 | 追偿案件的日常业务操作 | 发账号、给授权、配 AI 模型 |
| 谁能进 | 业务人员 | 只有你（管理员） |
💡 一句话：业务数据永远在使用者本机；后台只管"谁有权用、能用什么 AI"。这就是"数据留本地，握手取鉴权"的设计。
2登录
1
浏览器打开管理后台地址（部署时提供，默认 https://li.yicun.fun/admin）。
2
输入管理员账号（admin）和密码。密码在服务器 /opt/projects/bxzcpt/data/config.json 的 admin_password 字段。
3
登录后进入主面板，从上到下五块：模型网关 / 机构管理 / 客户端账号 / 调用统计。
🔴 首次部署后立即修改 admin 密码（改 config.json 后 systemctl restart bxzcpt-server），并妥善保管，不要进代码库或聊天记录。
3模型网关配置（AI 能力源头）
客户端的 AI 文书、单据识别都从这里转发。Key 只存在服务端，客户端永远拿不到。
| 配置项 | 填什么 | 示例 |
|---|
| OpenAI 兼容 Base URL | 模型服务商的接口地址 | https://api.deepseek.com/v1 |
| 模型名称 | 服务商的模型 ID | deepseek-flash（多模态，能看图） |
| API Key | 服务商密钥；保存后不回显，留空则不修改 | sk-…… |
| 授权有效期（天） | 客户端登录授权的 token 有效天数 | 30 |
2
验证：客户端「AI 助手」生成一段文字，能出结果即通。
⚠️ 换模型注意能力差异：做"单据识别（看图）"必须选输入含 image 的多模态模型（如 deepseek-flash）；纯文本模型看不了图。
4机构管理（多租户）
机构＝租户。每家使用单位（分公司/团队）建一个机构，账号挂在机构下，数据互相隔离。
- 机构编码：唯一，建议英文缩写，如 PAIC-GZ（建后不可与他家重复）。
- 机构名称：显示用，如"平安产险广东分公司"。
- 联系人 / 电话：备查。
1
「机构管理」卡片填编码＋名称＋联系人 → 点「新增机构」。
2
创建成功后列表即时出现，后续给该机构发客户端账号。
5客户端账号（License 发放）
客户端账号就是"使用授权"。登录即握手发 token，可设到期日和设备数上限。
| 字段 | 说明 |
|---|
| 用户名 / 密码 | 发给使用方登录客户端；密码 ≥8 位 |
| 所属机构 | 决定他能看到哪一家的数据（必须选） |
| 授权到期 | YYYY-MM-DD，留空＝长期；到期后客户端握手被拒 |
| 设备数上限 | 该账号最多几台电脑登录（默认 3，防共享滥用） |
| 功能位 | 默认含 ai（模型能力）；不开则客户端 AI 置灰 |
日常操作
- 停用/启用：人员离职点停用，其客户端立即失效。
- 改密：忘记密码时重置。
- 删除：彻底移除账号（其登录设备随之作废）。
- 「最近登录」列可核对使用情况。
💡 一个机构可以发多个账号（如主管+经办人），各自登录互不干扰。
6调用统计
显示 AI 调用次数（按类型/模型分组），用于核对用量、发现异常消耗。每次客户端 AI 生成都会记账。
7标准发号流程（照抄即可）
2
「客户端账号」新增账号：选该机构、设密码、按需设到期日/设备数 → 创建。
3
把 服务器地址 + 用户名 + 密码 交给使用方。
4
使用方在客户端「系统管理 → 服务器 · 模型授权」填地址、登录 → 顶栏显示「已授权」，AI 解锁。
5
（可选）在「模型网关」确认模型配置正确，即可提供单据识别等多模态能力。
8运维与安全
- 服务状态：systemctl status bxzcpt-server；重启：systemctl restart bxzcpt-server；日志：journalctl -u bxzcpt-server -f
- 探活：curl http://127.0.0.1:18080/api/v1/ping
- 数据备份：定期打包 /opt/projects/bxzcpt/data/（含账号库与 config）。
- 改密码/换 Key：改 data/config.json → 重启服务（模型 Key 可直接在管理后台改，即时生效）。
- 多项目防冲突：服务器根目录 /PROJECTS.md 登记了全部端口与目录，新项目部署前必读。
🔴 安全底线：①admin 强密码并定期换 ②HTTPS 反代（如有域名）③config.json 含密钥严禁外传 ④定期备份 data 目录。