steven_li
4b0bf65ace
feat(engine): 优化智能体循环中的助手消息处理逻辑 - 在没有工具调用时才添加助手消息到上下文 - 确保工具调用响应正确添加到消息上下文中 - 修复了消息构建的条件逻辑 fix(cron): 改进定时任务调度的时间解析功能 - 添加正则表达式导入用于时间显示解析 - 实现从显示文本中提取毫秒间隔的功能 - 增强整数转换的安全性，避免类型错误 - 优化定时任务配置的解析逻辑 feat(outlook): 增强Outlook集成的功能和稳定性 - 将默认超时时间从10秒增加到180秒 - 为状态检查函数添加可选的验证参数 - 串行执行邮件概览获取操作而非并行 - 改进连接状态验证逻辑 feat(channel): 添加设备名称作为会话标识的选项 - 为终端WebSocket适配器添加新的配置选项 - 实现基于设备名称生成会话对等ID的功能 - 记录原始对等ID和设备名称的元数据 - 支持从设备名称创建会话对等ID feat(skills): 完善技能学习评估系统和进度跟踪 - 在应用启动时自动调度待评估的技能草稿 - 为技能评估工作创建独立的循环工厂 - 实现异步技能评估任务的取消和清理机制 - 添加技能评估进度报告和状态跟踪功能 - 扩展会话列表API以包含更多详细信息 - 防止对不存在的会话进行操作 - 优化技能草稿提交和评估的业务逻辑 perf(skills): 提升技能评估的并发性能 - 实现并行技能案例评估以提高效率 - 添加最大并行案例数的环境变量控制 - 实现实时评估进度更新和回调机制 - 优化评估过程中的资源管理和同步 refactor(services): 创建隔离的智能体循环实例 - 添加创建独立智能体循环的工厂方法 - 确保新循环继承运行时服务配置 - 支持技能评估等需要隔离环境的场景 ```
Beaver Project
Beaver Project 是一套单机 Docker 部署的多实例运行环境：
- 用户先进入独立的
auth-portal完成注册或登录。 - 注册会触发
authz-service调用deploy-control。 deploy-control在同一台机器上创建一个独立的app-instance容器。router-proxy按实例域名把流量转发到对应容器。
当前推荐的最小部署方式是一台 Linux / WSL2 Ubuntu 机器加 Docker。生产域名和 HTTPS 可以放在项目外层的 Nginx、Caddy、Traefik 或云负载均衡上。
组件
| 目录 | 职责 | 默认端口 |
|---|---|---|
auth-portal/ |
用户登录、注册、模型配置引导入口 | 3081 |
authz-service/ |
AuthZ 服务，负责账号和 backend 身份编排 | 19090 |
deploy-control/ |
部署控制面，调用 Docker 创建和管理实例 | 8090 |
router-proxy/ |
统一实例入口代理，按 Host 分发到实例容器 | 8088 |
app-instance/ |
单用户运行实例，容器内包含前端、后端和 Nginx | 容器内 8080 |
公网环境通常只暴露：
auth-portal:3081，或外层代理后的https://portal.example.comrouter-proxy:8088，或外层代理后的https://<slug>.apps.example.com
不要直接把 deploy-control:8090 和 authz-service:19090 暴露到公网。
请求链路
注册：
Browser
-> auth-portal
-> authz-service POST /portal/register
-> deploy-control POST /api/instances/register
-> app-instance/create-instance.sh
-> app-instance POST /api/auth/register
-> authz-service /oauth/register or /backends/register
-> auth-portal provider onboarding
-> deploy-control POST /api/instances/configure-provider
登录：
Browser
-> auth-portal
-> deploy-control POST /api/instances/resolve
-> app-instance POST /api/auth/login
-> app-instance frontend URL
快速开始
本机完整流程见：
域名、HTTPS、公网反向代理说明见：
最小配置变量：
export PROJECT_ROOT=/home/ivan/xuan/beaver_project
export BEAVER_NET=beaver-instance-edge
export BEAVER_PROXY_CONTAINER_NAME=beaver-router-proxy
export BEAVER_DEPLOY_TOKEN="$(openssl rand -hex 32)"
export BEAVER_AUTHZ_INTERNAL_TOKEN="$(openssl rand -hex 32)"
export BEAVER_BASE_DOMAIN=localhost
export BEAVER_AUTHZ_URL='http://beaver-authz-service:19090'
export BEAVER_DEPLOY_URL='http://beaver-deploy-control:8090'
export BEAVER_OUTLOOK_MCP_URL=''
export BEAVER_OUTLOOK_MCP_SERVER_ID='outlook_mcp'
启动顺序：
- 创建运行目录。
- 构建四个镜像。
- 创建共享 Docker network。
- 启动
router-proxy。 - 启动
authz-service。 - 启动
deploy-control。 - 启动
auth-portal。 - 打开
http://127.0.0.1:3081/register测试注册。
关键配置关系
DEPLOY_API_TOKEN 和 DEPLOY_CONTROL_API_TOKEN 必须相等：
auth-portal/authz-service用DEPLOY_API_TOKEN请求deploy-control。deploy-control用DEPLOY_CONTROL_API_TOKEN校验请求。
AUTHZ_ISSUER 在这套单机部署里要写容器网络地址：
http://beaver-authz-service:19090
不要写成 http://127.0.0.1:19090，因为新创建的 app-instance 容器里的 127.0.0.1 指向它自己，不是 AuthZ 容器。
DEPLOY_PUBLIC_* 决定新实例展示给用户的 URL：
DEPLOY_PUBLIC_SCHEME=http
DEPLOY_PUBLIC_BASE_DOMAIN=localhost
DEPLOY_PUBLIC_PORT=8088
本机测试时实例 URL 形如：
http://alice.localhost:8088
正式 HTTPS 域名通常改成：
DEPLOY_PUBLIC_SCHEME=https
DEPLOY_PUBLIC_BASE_DOMAIN=apps.example.com
DEPLOY_PUBLIC_PORT=443
实例 URL 形如：
https://alice.apps.example.com
前提是你已经在项目外层把 *.apps.example.com 的 80/443 流量转发到 router-proxy:8088。
模型配置方式
当前版本不会在注册创建实例时写入模型 provider、model 或 API key。
流程是：
- 注册先创建一个不含模型凭证的实例。
auth-portal进入模型配置引导页。- 用户确认后，Portal 调用
deploy-control /api/instances/configure-provider。 deploy-control写入该实例的config.json并重启对应容器。
如果用户跳过引导，实例仍会创建成功，但后续需要在实例内补齐 provider 配置后才能正常调用模型。
持久化目录
至少保留：
authz-service/runtime/data
app-instance/runtime/instances
app-instance/runtime/registry
router-proxy/runtime/conf.d
不要在需要保留账号、实例或配置时删除这些目录。
模板文件
可参考这些环境变量模板：
.env.exampleauth-portal/src/.env.exampleauthz-service/.env.exampledeploy-control/.env.examplerouter-proxy/.env.example
这些模板不会被脚本自动加载。你可以手动 export，也可以在 docker run 时使用 --env-file。