立项原因：企业想用 AI Agent，但卡在三件事——数据不敢放公有云、多个业务要不同人格的 AI、交付靠人工一台台装。本项目要解决的就是：让一套 AI Agent 平台能按客户批量交付、数据留在客户内网、且一个客户可同时跑多个独立 AI 角色。
行业场景 / 业务背景：企业 SaaS 与私有化部署领域，面向需要 AI 能力但要求数据不出内网的客户（政企、制造业、有合规要求的行业）。核心模式是一客户一套独立实例，支持交付到客户服务器由客户自持，或集中托管按租户开通。典型场景包括企业 AI 秘书、智能客服、销售助手等多角色并存的业务。
一、多租户隔离：一客户一容器一实例，数据、内存、会话、记忆、凭据在租户间完全隔离；单租户内可跑多个 profile（独立 AI 角色，如主秘书、客服、销售），profile 之间状态互不干扰。
二、租户生命周期管理：命令行一键开通租户（自动分配端口、生成随机密码、建默认 profile、写入注册表）；支持加删 profile、启停、配置修改；支持备份与整包迁移恢复。
三、Web 管理后台：邀请制登录鉴权（JWT 加角色，首次登录强制改密）；租户列表与容器运行状态实时探测；账号与租户绑定关系隔离（管理员看全部、普通账号看绑定）；试用申请到开通账号闭环；操作审计记录；云员工（AI 角色）详情页含概况、会话列表、人格与密钥配置、文件在线编辑；技能库按四类分组并支持在线预览。
四、商业化能力：套餐与价格后台可配，官网与下单读同一份配置；官网在线下单与在线支付（易支付）；订阅期与座席数管理；结算规则支持续费顺延、加座席折算、减座席到期生效、幂等台账；订单中心按角色隔离可见范围。
五、可插拔能力：图像生成、搜索、错误上报等插件在租户根共享，一次同步即可批量更新所有租户；对话模型与图像模型可指向不同中转站，客户可自带平台。
我负责：整体架构设计与技术选型；租户编排与生命周期命令行工具开发；多 profile 隔离方案与配置合并逻辑；Web 管理后台前后端架构与核心编码；计费结算规则实现；生产环境部署、迁移与线上故障排查。
技术栈：容器用 Docker Compose 编排，s6 进程管理自动恢复运行中的 profile；管理端用 Go（Gin 加 GORM 加 goose 迁移）配合 React、Vite、Tailwind；数据库 MySQL；租户脚本用 Bash，带 fail-fast 布局自检；AI 运行时为 Hermes Agent，接入飞书作为交互入口。
亮点难点：一、profile 级凭据优先级问题——飞书凭据在根配置与 profile 环境变量两处不一致时会导致连接失败，需建立同源更新与权限管控（配置文件 640、环境变量 600）；二、容器运行状态实时探测，让后台能显示租户是否真在跑，而非只看数据库记录；三、计费结算的幂等台账，续费顺延与加减座席折算不能重复入账；四、跨机器迁移时 registry 用相对路径，整包恢复自动重算数据卷路径。
评论