设备管理

· 客户电脑装好软件后会自动接入本服务器，无需任何操作。
· 设备丢失、换人或客户欠费时可点「吊销」，该电脑立即停止同步；误吊销可点「恢复」。
· 客户电脑无法自动接入（换服务器、网络受限等）时，点「＋ 添加设备码」，把设备码和接入码发给客户，在软件「设置 → 数据同步 → 高级选项 → 手动接入」里粘贴即可。

客户忘记登录密码时，在此点「重置密码」，把生成的临时密码发给客户（员工电脑会在一分钟内自动同步生效）。
也可以自行指定新密码。临时密码请提醒客户登录后尽快在「员工账号」里修改。

在这里填好、点保存就立刻生效，不需要重启服务，也不用去改服务器上的任何文件。
填完可以分别点「发送测试短信」和「测试企业微信连接」验证一下，两项都通过才算配好。

· 企业 ID：企业微信后台「我的企业 → 企业信息」；AgentId / Secret：企业微信后台「应用管理 → 自建应用」。
· 回调地址要填员工访问软件时用的那个域名（必须 https），并把这个域名填进企业微信该应用的「网页授权及JS-SDK → 可信域名」。
· 扫码后系统会回企业微信通讯录核对身份，只有本企业在职成员才能登录，其他人会被拒绝。

在这里配一次，所有客户电脑的小星就都能用了，不用挨个去客户电脑上设置。
API Key 只存在这台服务器上，不会下发给客户电脑；客户电脑的 AI 对话请求都由本服务器代为转发。

· 去哪拿 Key：打开 DeepSeek 开放平台（platform.deepseek.com）→ 注册并充值 → 左侧菜单「API keys」→「创建 API key」→ 复制那串 sk- 开头的字符，粘贴到上面的「API Key」框里（这串字符只显示一次，请及时保存）。
· 服务地址：用 DeepSeek 官方就填 https://api.deepseek.com/v1；如果用的是别的兼容服务（中转站、本地大模型等），填对方给的那个地址即可。
· 模型名：DeepSeek 常用 deepseek-chat（便宜、够用）或 deepseek-reasoner（更聪明但更贵）。
· API Key 留空 = 不修改，只有点「清空已存 Key」才会删除。填好后先点「保存配置」，再点「测试连接」验证能不能通。

每个激活码只能绑定一家机构，激活后作废。把激活码发给已购买增值功能的客户。

用打包工具生成新版安装包（.exe）后在此发布，已安装的客户开机会自动检测到并提示一键更新。版本号必须比之前高（如 1.0.1、1.0.2）。

· 点击按钮即可下载当前服务器上的全部学员数据（SQLite 单文件）。
· 照片存放在服务器 data/photos/ 目录，建议连同 data/ 整个目录一起定期备份。
· 云服务器可加一条定时任务每天自动拷贝：cp -r 数据目录 /备份目录/$(date +\%F)

开启后，访客在官网提交预约表单，会自动在本系统生成一条新线索（进公海、不自动指派），可选推送到企业微信群提醒。
只需把下面的「接口地址」和「表单密钥」填进官网服务器的 .env，保存即生效，不用重启服务。

· 接口地址：https://你的域名/api/public/lead（把「你的域名」换成这台服务器对外访问的域名）
· 请求方式：POST，请求头 Content-Type: application/json、X-Form-Key: 上面的表单密钥
· 请求体（JSON）：name 姓名、phone 手机号 必填；course 意向课程、identity 身份、source 来源（官网主站填「官网表单」，手机 H5 填「官网H5」）、channel 投流渠道、note 备注 选填。同一手机号 7 天内重复提交只追加备注、不新建线索。
· 限流：按手机号计（同一手机号每分钟 5 次、每天 50 次），另有整体防刷闸门（同一 IP 每分钟 60 次、每天 600 次）。官网属「服务器到服务器」提交，正常业务量不会触发。
· 企微群机器人 webhook 去哪拿：企业微信 → 打开要接收提醒的群 → 右上角「…」→ 群机器人 → 添加机器人 → 复制它的 webhook 地址（https://qyapi.weixin.qq.com/...）。
· 安全提示：表单密钥相当于密码，只放在官网服务器上，不要写进网页前端。