#建立服务与访问入口
管理员负责部署 Next.js 服务与 PostgreSQL,为公司配置独立数据库和部署环境。服务端开发要求 Node.js 22.12+、PostgreSQL 17+;生产部署、迁移和证书细节以服务端部署说明为准。
客户端接口与管理控制台是独立入口。默认客户端接口使用 8080,管理进程绑定本机 8081;远程管理应使用部署规范中的受限入口或 SSH 隧道,不将管理端口作为员工公开地址。
#配置模型
在“模型管理”登记服务地址、凭据、类型和启用状态,设置各类型的统一默认模型。至少确认 LLM 默认项;若需图片分析或生成,再分别确认多模态与图片默认项。
连接测试通过不代表所有供应商功能和工具调用协议都已验证。发放前使用代表性非敏感任务检查对话、文件处理、视觉输入和生成链路。供应商密钥由后台保存,员工不需要接触明文。
#管理技能与用户
在“技能库”新增、编辑或导入 Markdown/文本,设置分类与启用状态。技能应写清适用场景、输入要求和交付方式,避免夹带凭据或不必要的内部信息。
普通用户通过客户端注册。管理员可查询用户、启停账号或重置密码;停用与重置会撤销已有登录会话。其他管理员由超级管理员添加,没有后台自助注册入口。
#发放前检查
- 确认员工网络可以访问客户端服务,证书与域名配置正确。
- 确认管理员入口和普通用户权限隔离。
- 提供匹配系统与架构的客户端、版本说明及真实服务地址。
- 验证登录、默认模型、技能与至少一个代表性任务。
- 明确本地任务不跨电脑自动同步,以及当前版本支持范围。
#用量与备份
后台可按用户、模型和日期查看调用及用量,区分网关记录与客户端上报。模型未返回 usage 时,不能把相关零值当作实际零消耗,也不能直接以运营统计替代完整账单。
数据库与服务端 MODEL_ENCRYPTION_KEY 必须一同保留;丢失加密密钥会导致已有模型凭据无法解密。员工本地任务数据、工作文件与公司数据库需要分别规划备份。