Appearance
Servify v0.1.0 Release Notes
Servify v0.1.0 是首个公开预览版。
本版本的目标是:
- 可安装
- 可部署
- 可演示
- 核心客服主链路可跑通
本版本不代表企业生产稳定版,也不等同于 v1.0。
已具备能力
- 核心客服主链路:工作台、会话详情、消息收发、人工接管、转接、关闭
- 工单闭环:创建、列表、详情、更新、指派、评论、关闭、统计、导出
- AI 基础能力:AI 查询、状态、指标、provider 控制面、fallback 已有实现,但真实 provider 主路径验收仍未完全闭环
- 知识链路基础能力:上传、同步、provider enable/disable、circuit breaker reset 已有接口与自动化覆盖,但当前仍不应视为“已完成发布验收”
- 认证与会话:登录、refresh 轮转、当前会话列表、退出当前会话、退出其它会话已有实现与自动化覆盖,真实发布证据仍需继续补齐
- 实时能力基础:WebSocket、WebRTC stats / connections、平台消息路由统计
- 后台基础运营面:客户、客服、审计、安全、配置治理、SLA 等已有基础入口,但完成度不一致,仍有多项仅达到“可运行/可测试”而未达到“已完成验收”
已验证入口
make buildmake release-check CONFIG=./config.ymlGET /healthGET /readyGET /metricsPOST /api/v1/auth/loginGET /api/omni/workspacePOST /api/v1/ai/query
补充说明:
- 默认根配置
config.yml下的make release-check现已使用临时 SQLite 库完成迁移、启动与健康检查烟测,便于在空白开发机上复现最小发布自检 - 这不改变正式部署前置依赖要求;生产与 staging 仍应使用目标环境的 PostgreSQL、Redis 和真实外部依赖完成验收
已知限制
- 默认 event bus 仍为进程内实现,不提供持久化消息队列语义
- voice runtime 仍保留 mock / provider 边界,不等同于生产级真实 voice provider 接入
- agent runtime 仍存在部分内存态与 legacy compatibility 残留
/api/v1/ws仍为公开 realtime 入口,但现在要求显式提供session_id;当前仍主要依赖限流与外围网络边界控制,不等同于完整鉴权接入- WebRTC
GET /api/v1/webrtc/stats现支持无参汇总;传session_id时返回单会话连接详情 - Public knowledge
/public/kb/docs现只暴露显式标记为公开的文档;管理端新建文档默认保持内部可见 - AI / Knowledge 当前仅能确认“基础实现已存在、fallback 可工作、控制面可访问”;真实 provider 主路径、同步语义与生产级环境验收仍未完全闭环
- 一部分管理面能力虽然已有 CRUD / 查询接口与自动化测试,但 handler 错误语义、异常路径和真实运行证据仍不均衡,不能等同于“后台运营面已全部完成”
- demo / mock / compatibility 资产仅用于开发、演示和验收辅助,不等同于正式生产能力
非目标
- 多实例高可用与跨实例一致性保证
- 持久化消息队列下的异步 durability 语义
- 完整 co-browsing 远程协助产品
- 企业级容量、压测、备份恢复基线
- 客户侧推荐问题 / 上下文联想问题
升级与部署说明
- 部署前先准备 PostgreSQL 与 Redis
- 生产环境应从
config.production.secure.example.yml或等价部署配置出发 - 敏感配置必须通过环境变量或密钥管理系统注入
- 发布前至少执行:
make security-check CONFIG=config.production.ymlmake observability-check CONFIG=config.production.ymlmake release-check CONFIG=config.production.yml
推荐发布表达
可以说:
- Servify 已具备继续打磨预览版的基础
- 核心客服主链路、工单闭环和实时基础能力已可演示
- AI 基础能力与后台运营面已有基础实现,但
0.1.0发布证据仍在补齐
不应说:
v0.1.0已准备好立即发布- AI / Knowledge 已完成发布验收
- 后台基础运营面已全部完成
- 已完成企业级生产稳定交付
- 已提供完整生产级远程协助产品